--- 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 --- # Integrado GitHubpara Velocidade de mudança para DevOps- Espaço # Integrado GitHubpara Velocidade de mudança para DevOps- Espaço {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 min. de leitura Conecte-se ao GitHubInstância que usa o playbook Espaço de mudança de DevOps para descobrir, configurar e importar repositórios, planos e pipelines. ## Antes de Iniciar Conclua as tarefas especificadas em [Comece com Velocidade de mudança para DevOps](https://servicenow-prod.fluidtopics.net/H6cJoJUn50UIz0Rgh1lSiw "Saiba mais sobre o processo de configuração para Velocidade de mudança para DevOpsisso é necessário antes de configurar integrações com sua cadeia de ferramentas.")tópico. Função necessária: sn_devops.admin ou sn_devops.tool_owner ## Procedimento 1. Navegar até EspaçosEspaço de mudança de DevOps E use uma das seguintes opções para abrir o playbook para integrar GitHub. | Opção | Etapas | | Página inicial | 1. Selecione Conecte uma ferramenta . 2. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada (Orquestração, Código, Plano ou Qualidade do software). Por exemplo, se você quiser se conectar a. GitHubcomo ferramenta de codificação, você selecionaria Ferramentas de codificação categoria. {#playbook-enter-github-instance-details__ol_e5j_4y1_fwb} | | Módulo de aplicações | 1. Selecione Aplicações ( ![Ícone de aplicações.]()) da navegação primária. 2. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte app-create-workspace.html. 3. No  painel Ações recomendadas, selecione  Conecte uma ferramenta  cartão. 4. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada. Por exemplo, se você quiser se conectar a. GitHubcomo ferramenta de codificação, selecione GitHubem Código categoria. {#playbook-enter-github-instance-details__ol_u24_mz1_fwb} | | Módulo de ferramentas | 1. Selecione Ferramentas ( ![Ícone de ferramentas.]()) da navegação primária. 2. Na lista Capacidade, selecione a categoria apropriada. Por exemplo, se você quiser se conectar a. GitHubcomo ferramenta de codificação, você selecionaria Codificação categoria. 3. Selecione Conecte uma ferramenta . 4. No  modal Conectar a uma ferramenta, selecione GitHub. {#playbook-enter-github-instance-details__ol_fjs_k1b_fwb} | |-|-| {#playbook-enter-github-instance-details__choicetable_m3t_ky1_fwb} Importante: Se você quiser descobrir e rastrear objetos de ferramenta, como pipelines, planos ou repositórios, ao se conectar à ferramenta, conecte sua ferramenta a partir do módulo da aplicação. 2. Em Nome da ferramenta insira um nome para a ferramenta. 3. Selecione Avançar. . DevOpso playbook é aberto para ajudar você a concluir as tarefas de integração. 4. Conclua a conexão e a configuração usando o playbook. 1. Em Tipo de credencial selecione um dos seguintes tipos de credencial. * Autoriz. básica {#playbook-enter-github-instance-details__ul_uvd_2dg_fwb} 2. Insira as credenciais. {#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__1}{#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__3}{#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__5} | Autoriz. básica | Insira o nome de usuário e a senha/token de acesso do GitHubinstância. | | OAuth 2.0 com Código de autorização | Selecione um registro de credencial OAuth 2,0 com código de autorização existente ou crie um registro de credencial OAuth 2,0 com código de autorização. Para obter mais informações, consulte [Crie um registro de credencial para GitHubProvedor de app (código de autorização)](https://servicenow-prod.fluidtopics.net/noI76~lZtKLLCIO2qWS0jw#dev-ops-create-cred-github-auth "Crie um registro de credencial para GitHubProvedor de app criado anteriormente para autorizar ações."). Nota: Se você estiver se conetando usando um app GitHub e estiver enfrentando problemas com a verificação de permissões, certifique-se de que o prefixo de ID do cliente do app GitHub esteja disponível na propriedade DevOps: Especificador de ID do cliente para o app GitHub . Para obter mais informações, consulte [Adicione o ID do cliente à propriedade DevOps](https://servicenow-prod.fluidtopics.net/noI76~lZtKLLCIO2qWS0jw#github-app-property "Depois de configurar seu app GitHub, você deve garantir que o prefixo do ID do cliente (primeiros 3 ou mais caracteres do ID) seja adicionado à propriedade DevOps: Especificador de ID do cliente para o app GitHub ."). | | OAuth 2.0 com token Web JSON (JWT) | Para se conectar usando o OAuth 2,0 com um JWT, você deve primeiro executar o seguinte: * [Crie e configure um app GitHub](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#dev-ops-config-github-acct-jwt "Crie um personalizado GitHubApp do seu GitHubConta para habilitar a autenticação OAuth 2,0 com seu ServiceNowinstância.") * [Gere o certificado de armazenamento de chaves Java para GitHub](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#dev-ops-generate-jks-cert-github "Gere um certificado Java Keystore (JKS) para a autenticação JWT.") * [Anexe o. GitHubJava keystore para sua instância](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#dev-ops-attach-jks-cert-github "Ative a autenticação de token de concessão do portador do JWT anexando o certificado válido do GitHub Java Keystore (JKS) à sua instância da ServiceNow.") {#playbook-enter-github-instance-details__ul_irn_hlk_ybc} Após concluir os pré-requisitos, você pode continuar com Velocidade de mudança para DevOpsConectar atividade do playbook: 1. Selecione Use um registro de credencial JWT existente Se você quiser usar um registro de credencial JWT já existente. Se esta opção não estiver selecionada, os campos para criar um novo registro de credencial JWT serão exibidos. Passe para a próxima etapa. 2. Em JKS certificado Selecione um certificado JKS existente. Este é o nome que você inseriu para identificar exclusivamente o provedor de JWT. Os certificados JKS são criados usando comandos de shell para criar um registro sys_certificate. Para obter mais informações, consulte [Crie uma chave de assinatura JWT para GitHubJKS certificado](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#dev-ops-create-jwt-key-github "Crie uma chave de assinatura de token da web JSON (JWT) para atribuir ao seu GitHubJava keystore."). 3. Em Chave de assinatura Insira a chave de assinatura a ser atribuída ao seu certificado JKS. Esta é a senha de exportação inserida durante [Gerando o certificado JKS](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#dev-ops-generate-jks-cert-github "Gere um certificado Java Keystore (JKS) para a autenticação JWT."). 4. Em ID do app GitHub Selecione o ID da aplicação da sua aplicação GitHub (disponível na secção Sobre da configuração da aplicação GitHub no GitHub). A imagem a seguir exibe um exemplo da seção Sobre de uma configuração do app GitHub de onde você pode acessar o ID do app GitHub, o ID do cliente e o segredo do cliente. 5. Em ID do cliente Selecione o ID do cliente do seu app GitHub (disponível na seção Sobre da configuração do app GitHub no GitHub). 6. Em Segredo do cliente Selecione o segredo do cliente do seu app GitHub (disponível na seção Sobre da configuração do app GitHub no GitHub). 7. Em URL do token selecione o local do endpoint de token que a instância usa para recuperar e atualizar tokens. Para a versão em nuvem, insira: https://api.github.com/app/installations/<installation_id>/access_tokens . Para a versão empresarial, insira: https://<HOST_URL>/api/v3/app/instalations/<installation_id>/access_tokens . Para obter o ID de instalação, acesse a seção Instalar app na configuração do app GitHub no GitHub e selecione o ícone de engrenagem para configurar seu app. O ID de instalação estará no URL da página da web. Por exemplo, https://github.com/settings/installations/\. {#playbook-enter-github-instance-details__ol_fpn_kkt_vyb} Se a credencial OAuth for criada usando GitHub Apps - JWT, o. Configure com o app GitHub a opção estará disponível na página de registro da ferramenta. Nota: Se você estiver se conetando usando um app GitHub e estiver enfrentando problemas com a verificação de permissões, certifique-se de que o prefixo de ID do cliente do app GitHub esteja disponível na propriedade DevOps: Especificador de ID do cliente para o app GitHub . Para obter mais informações, consulte [Adicione o ID do cliente à propriedade DevOps](https://servicenow-prod.fluidtopics.net/4B6eHoLCfdLSdAc723CpKQ#github-app-property-jwt "Depois de configurar seu app GitHub, você deve garantir que o prefixo do ID do cliente (primeiros 3 ou mais caracteres do ID) seja adicionado à propriedade DevOps: Especificador de ID do cliente para o app GitHub ."). | |-|-| [ ] {#playbook-enter-github-instance-details__table_uxp_shk_ybc} Para obter mais informações sobre credenciais do OAuth2.0, consulte [Configurando GitHubCredenciais do OAuth 2,0 para Velocidade de mudança para DevOps](https://servicenow-prod.fluidtopics.net/sIFP_3Q~EXeyDhQW0vPo4Q "Crie credenciais do OAuth 2,0 para GitHubOu apps OAuth e use-os para conectar seu GitHubinstância."). 3. **Opcional:** . GitHuba instância está anexada a um MID Server, selecione MID Server e insira seus detalhes. Para obter mais informações sobre o MID Server, consulte [Seleção do MID Server](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Nota: O tipo de concessão Código de autorização OAuth é compatível com GitHub e GitHub Enterprise com MID Server. 4. Selecione Conectar . 5. As verificações de permissão são executadas nas credenciais inseridas. As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Reinsira as credenciais . Para obter informações detalhadas sobre todas as permissões necessárias, consulte GitHubpermissões em [Permissões necessárias para DevOpsferramentas](https://servicenow-prod.fluidtopics.net/_xG76fCCvCKNtBn3VaTdSw "Permissões necessárias na ferramenta de terceiros para se conectar Velocidade de mudança para DevOps."). Para OAuth 2,0, se você não inseriu o. GitHubnome do slug da aplicação, a ferramenta está conectada sem verificar os requisitos de permissão. 6. Selecione Avançar. {#playbook-enter-github-instance-details__substeps_wdp_x1b_fwb} 5. Especifique o acesso para a ferramenta. 1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem receber acesso à ferramenta no Mantido por campo. As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles. * DevOps Função de proprietário da ferramenta: Pode exibir e editar a ferramenta. * DevOps Função de proprietário da aplicação: Pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas de pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines). * DevOps Função de administrador: Pode editar todas as ferramentas. * Outro DevOpsFunções: Pode exibir a ferramenta. {#playbook-enter-github-instance-details__ul_csp_h5c_xwb} Nota: Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com DevOpsA função de Proprietário da ferramenta poderá editar a ferramenta. 2. Se você optar por controlar o acesso à ferramenta, o. Todos os proprietários de aplicações podem exibir e associar objetos de ferramenta a aplicações a opção fica disponível para seleção. Esta opção habilita todos os usuários que têm o. DevOpsFunção de proprietário da aplicação para acessar a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas de pipeline (se aplicável) dos objetos da ferramenta. 3. Selecione Atribuir. {#playbook-enter-github-instance-details__ol_slg_2tz_cxb} 6. Configure webhooks automaticamente em seu GitHubinstância para a qual enviar dados Velocidade de mudança para DevOps. Esta ação configura os seguintes webhooks: * push: Para coletar confirmações, ramificações e marcadores do repositório * workflow_job: Para coletar dados de pipeline * issues: Para coletar dados de ocorrências (item de trabalho) {#playbook-enter-github-instance-details__ul_k4d_sbb_fwb} Nota: A conclusão da configuração como parte desta tarefa é recomendada, pois as notificações em tempo real são ideais para manter as informações atuais, especialmente para automatizar solicitações de mudança. Caso contrário, você pode configurar o webhook configurando-o manualmente mais tarde, habilitando a pesquisa noturna para buscar o sistema de dados para todos os repositórios ou pipelines rastreados, definindo o. Enable Pollingpropriedade para Sim . Selecione os repositórios para os quais você deseja configurar webhooks e selecione Configurar . Importante: * Se você estiver se conectando a partir da página inicial ou do módulo Ferramentas, a conexão estará concluída e você será direcionado para a página Resumo. * Se você estiver se conectando a partir do módulo Aplicações, os repositórios e pipelines disponíveis serão descobertos. Você pode rastrear e importar dados históricos deles. {#playbook-enter-github-instance-details__ul_yfy_zz1_bzb} 7. Selecione os planos a serem rastreados. 1. Selecione os planos para os quais você deseja rastrear atualizações e associar à aplicação. Após a conclusão da integração da ferramenta, os itens de trabalho somente para esses planos selecionados serão importados automaticamente. 2. Selecione Avançar. {#playbook-enter-github-instance-details__ol_zlk_1jc_bzb} 8. Selecione os repositórios a serem rastreados. 1. Selecione os repositórios para os quais você deseja rastrear atualizações e associar à aplicação. 2. Selecione Avançar. 3. Se você quiser importar dados do repositório, selecione o intervalo de datas e selecione Enviar . Você pode importar até 90 dias de dados. Os fluxos de trabalho associados aos repositórios também serão importados. {#playbook-enter-github-instance-details__ol_r1g_3jc_bzb} 9. Selecione os pipelines a serem rastreados. 1. Selecione os pipelines para os quais você deseja rastrear atualizações e associar à aplicação. 2. Selecione Avançar. 3. Para cada pipeline selecionado, todas as etapas ou fases são importadas para a última execução bem-sucedida. Na atividade Atribuir serviços às etapas do pipeline, você pode selecionar o seguinte para cada etapa do pipeline: 1. Tipo de etapa de pipeline : Selecione um tipo de etapa para o qual você deseja atribuir um serviço. Dica: Especifique pelo menos Prod deploytipo de etapa para etapas que representa a implantação de produção a ser habilitada DevOpspara identificar execuções de pipeline bem-sucedidas como implantações de produção. 2. Serviço : Selecione CMDBserviço de aplicações para o qual a etapa do pipeline é mapeada. O serviço de aplicações mapeia aproximadamente para o ambiente. Se você usar a mesma etapa de pipeline para implantar em ambientes diferentes, deixe o campo em branco. As informações de serviço habilitam DevOpspara identificar e relatar métricas operacionais, como incidentes, indisponibilidades e assim por diante. {#playbook-enter-github-instance-details__ol_aty_ftk_zxb} 4. Selecione Avançar. {#playbook-enter-github-instance-details__ol_sgy_rjc_bzb} 10. Em Resumo , selecione Exibir registro da ferramenta para revisar os detalhes do conectado GitHubferramenta. Para GitHub Actionspipelines, você deve executar algumas etapas adicionais, como criar segredos, definir a configuração do fluxo de trabalho em GitHube assim por diante. Para obter mais informações, consulte [GitHub Actions configurações](https://servicenow-prod.fluidtopics.net/TuIpZkaTMxMiuBTyUvkwyw#github-actions-integration-with-devops "Informações de configuração em GitHub Actions, como segredos, fluxos de trabalho e limitações."). ## Resultado Você integrou com sucesso seu GitHubferramenta para Velocidade de mudança para DevOps. ## O que Fazer Depois Você também pode descobrir planos manualmente depois que sua ferramenta GitHub estiver integrada. Como não há entidade de plano no GitHub, os repositórios serão considerados para descobrir registros de plano correspondentes na ServiceNow. 1. Na página de registro da ferramenta, selecione Descobrir para descobrir planos. 2. Selecione Configurar. Os planos são rastreados e um webhook é chamado issuesé criado para enviar notificações em tempo real para itens de trabalho. {#playbook-enter-github-instance-details__ol_vkw_znt_qzb} As informações a seguir são atualizadas para um item de trabalho no ServiceNow quando o problema correspondente é atualizado no GitHub. * Mudança no título da ocorrência * Atualização dos designados * Problema de transferência Nota: Quando uma ocorrência é transferida, a mesma será marcada como transferida no repositório do qual está sendo transferida e aberta no repositório para o qual está sendo transferida. * Excluir ocorrência Nota: Quando um problema é excluído no GitHub, o item de trabalho correspondente não é excluído na ServiceNow, mas o estado do item de trabalho será marcado como excluído. {#playbook-enter-github-instance-details__ul_zcb_ptt_qzb} Se você for um cliente de upgrade, os planos serão descobertos para seus repositórios por meio do trabalho agendado para serem descobertos periodicamente ou por meio da descoberta manual. Depois que seus planos forem descobertos, você poderá habilitar o. sn_devops.track.github.issuespropriedade para reconfigurar todos os repositórios configurados anteriormente de uma só vez para que todos os planos sejam rastreados e o webhook de ocorrências seja criado para itens de trabalho. Nota: A importação histórica de planos não é compatível. **Tarefas relacionadas** * [Configure webhooks a partir do registro da ferramenta](https://servicenow-prod.fluidtopics.net/tAcDeXVbYRRz8h6f75iQlQ "Configure webhooks a partir do registro da ferramenta para enviar dados Velocidade de mudança para DevOpsdepois que sua ferramenta estiver conectada.")