---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# GitHub Actions configurações

# GitHub Actions configurações {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Informações de configuração em GitHub Actions, como segredos, fluxos de trabalho e limitações.

## Segredos em GitHub Actions {#github-actions-integration-with-devops__section_acb_rsz_gwb}

Crie segredos (credenciais) em GitHubrepositório ou GitHuborganização. Os segredos são variáveis de ambiente (criptografadas) que você cria em uma organização ou repositório. Esses segredos estão disponíveis para uso em GitHub Actionsfluxos de trabalho. Para obter mais informações, consulte [Segredos criptografados](https://docs.github.com/en/actions/security-guides/encrypted-secrets).
{#github-actions-integration-with-devops__table_i1t_zt5_h5b__entry__2}

| Segredo | Descrição |
|-|-|
| SN_INSTANCE_URL | ServiceNow URL da instância. Por exemplo, https://\<instance_name\>.service-now.com. |
| SN_ORCHESTRATION_TOOL_ID | Sys_id para GitHubferramenta criada em ServiceNowinstância. |
| SN_DEVOPS_INTEGRATION_TOKEN | Token secreto para GitHubferramenta criada em DevOps( <kbd class="ph userinput">devops-integration-token </kbd>parâmetro). Para acessar seu token secreto, navegue até GitHubregistro da ferramenta em ServiceNow( Tudo \> Ferramentas \> Ferramentas de Orquestração ) e selecione Token de cópia Na IU clássica. |
[ ]

{#github-actions-integration-with-devops__table_i1t_zt5_h5b}

## Fluxos de trabalho no GitHubrepositório {#github-actions-integration-with-devops__section_hj5_5rk_xwb}

Crie um arquivo YAML para definir a configuração do fluxo de trabalho no GitHubrepositório.  
Os seguintes pontos devem ser considerados ao definir o fluxo de trabalho:

* Todos os fluxos de trabalho do seu repositório devem ter uma extensão de arquivo .yml ou .yaml. Todos os fluxos de trabalho devem estar em `.github/fluxos de trabalho `e siga a sintaxe definida no [Sintaxe de fluxo de trabalho para ações do GitHub](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions).

* O nome do fluxo de trabalho deve corresponder ao nome do arquivo de fluxo de trabalho.

* Os nomes dos fluxos de trabalho em Todos os fluxos de trabalho em Ações a guia deve corresponder aos fluxos de trabalho salvos em `.github/fluxos de trabalho `diretório do seu repositório.

  ![Posicionamento de arquivos de fluxo de trabalho na guia Ações]()
* Um nome de exibição deve ser fornecido para cada trabalho e deve ser exclusivo para cada trabalho no fluxo de trabalho. O nome do trabalho deve corresponder ao nome da fase na ação personalizada.

* Use o. `workflow_dispatch `evento para acionar um fluxo de trabalho manualmente.

{#github-actions-integration-with-devops__ul_mxh_zrk_xwb}

## GitHub Actions detalhes da execução do fluxo de trabalho em DevOps {#github-actions-integration-with-devops__section_q23_ftk_xwb}

Depois de configurar os webhooks, as notificações de GitHub Actionssão enviados para ServiceNow DevOpssempre que um fluxo de trabalho é executado ou acionado.  
Os detalhes a seguir são enviados para ServiceNowinstância em que um fluxo de trabalho é executado manualmente ou acionado automaticamente em um GitHubrepositório.

* O webhook workflow_job notifica o. ServiceNowinstância com status do trabalho (enfileirado, em andamento, concluído) quando o fluxo de trabalho é executado manualmente ou acionado automaticamente em um GitHubRepositório.
* Os eventos de entrada são criados no ServiceNowa instância do status do trabalho (enfileirado, in_progress e concluído) e os eventos in_progress são ignorados.
* Os eventos de entrada em fila e concluídos são processados e. ServiceNow DevOpsAs etapas do pipeline e as tarefas de Orquestração são criadas para trabalhos configurados no fluxo de trabalho.
* A execução de pipeline é criada para cada execução de fluxo de trabalho com registros de execuções de tarefa e execuções de etapa criados para cada trabalho executado na execução de fluxo de trabalho.
* Você pode usar a IU de pipeline para visualizar interações e resultados em uma execução de pipeline.
{#github-actions-integration-with-devops__ul_n1m_q3v_h5b}

## GitHub novas execuções {#github-actions-integration-with-devops__section_exc_5pz_xbc}

Solicitações de mudança criadas para GitHubos trabalhos serão reutilizados se as solicitações de mudança estiverem nas fases de implementação e pós-implementação. Por exemplo, para uma execução de pipeline:

* Se um trabalho falhar antes que a solicitação de mudança esteja na fase Implementar, a solicitação de mudança criada não será reutilizada quando os trabalhos com falha forem executados novamente.
* Se os trabalhos com falha ou todos os trabalhos forem executados novamente, uma nova solicitação de mudança será criada.
* Agora, se um trabalho falhar quando a solicitação de mudança estiver nas fases de implementação ou pós-implementação, a solicitação de mudança será reutilizada quando os trabalhos com falha ou todos os trabalhos forem executados novamente.  
  Nota:  
  Se a solicitação de mudança já estiver implementada em uma etapa anterior antes da falha do trabalho, durante as novas execuções, a execução do pipeline não será interrompida. A solicitação de mudança é considerada como já aprovada e implementada.
{#github-actions-integration-with-devops__ul_ytm_mrz_xbc}

Fluxos de trabalho compostos

Para fluxos de trabalho compostos em que um fluxo de trabalho chama outro fluxo de trabalho e a etapa de mudança está no fluxo de trabalho secundário, o. job-nameo parâmetro da etapa de mudança deve estar no formato `nome-do trabalho: '<parent-workflow-name>/<child-workflow-name>' `. Aqui, o espaço antes e depois da barra (/) é obrigatório.  
Figura 1. Exemplo de um parâmetro de nome de trabalho no fluxo de trabalho secundário

## GitHub Actionslimitações para Velocidade de mudança para DevOpsintegração {#github-actions-integration-with-devops__section_dbt_x2g_hwb}

* GitHub Actionse. GitHubOs ambientes são compatíveis com GitHub EnterpriseServidor a partir da versão 3,3.
  * Para obter informações detalhadas sobre GitHubambientes, consulte [Usando ambientes para implantação](https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment).
  * GitHubos ambientes estão disponíveis para repositórios privados somente em GitHub EnterpriseNuvem.
  {#github-actions-integration-with-devops__ul_bdm_htb_3bc}
* Para GitHubOrganizações, usam uma conta específica (com acesso às organizações necessárias) com token de acesso pessoal para integração com ServiceNow DevOpsou você também pode usar GitHubApps por meio do código de autorização 2,0 ou JWT.

  Para criação de ferramenta usando GitHubApps - JWT, você deve criar uma ferramenta separada para uma organização separada.
* Apenas o mais recente GitHub Actionsos resultados da verificação podem ser extraídos de uma instância para uma execução de fluxo de trabalho.
* ServiceNow DevOps A automação de mudanças usando ação ou ambiente personalizado não é compatível com trabalhos paralelos. Para trabalhos paralelos, a carga de notificação do webhook não contém informações sobre os trabalhos executados em paralelo com um número de sequência. Devido a essa limitação, a sequência de trabalhos depende da ordem de execução retornada pela resposta da API (/repos/"owner"/"repo"/actions/runs/"run_id"/jobs).
* URL de retorno de chamada para pausar e retomar a execução do fluxo de trabalho do ServiceNowa instância é compatível somente com GitHub ActionsRecurso de Portas de implantação. No entanto, a criação de mudanças é possível por meio dos portões de implantação e da Ação personalizada do GitHub.
* Usuário que cria GitHubferramenta no ServiceNowa instância deve ser um revisor para aprovar o fluxo de trabalho GitHubAmbientes.
{#github-actions-integration-with-devops__ul_th5_dgc_35b}
**Tópicos relacionados**   

*