GitHub integração com Velocidade de mudança para DevOps

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • Conecte-se à sua instância GitHub para descobrir repositórios, planos, definições de pipeline e configurar notificações ou pesquisas em tempo real para habilitar a rastreabilidade e a automação de mudanças.

    Visão geral da integração do GitHub

    Velocidade de mudança para DevOps oferece suporte aos recursos Planejar (Planos), Código (Repositório) e Orquestração (Ações) para a ferramenta GitHub.

    GitHub e GitHub Enterprise são compatíveis.

    As seguintes operações são realizadas como parte da integração GitHub:
    • Conectar: descubra repositórios, planos e definições de pipeline conectando suas instâncias [ GitHub a Velocidade de mudança para DevOps.
    • Configurar: habilite o envio de notificações em tempo real para confirmações, itens de trabalho e pipelines criando automaticamente um Webhook (push, Issues e workflow_job) no GitHub para que esses dados possam ser usados para criar políticas de mudança.
    Os repositórios em uma organização também podem ser descobertos e configurados se você tiver as seguintes permissões básicas para a organização (privilégios de membro):
    • Descobrir: permissão base de Leitura.
    • Configurar: permissão base de administrador.
    Se as Permissões base forem especificadas como Sem permissão para uma organização, os repositórios nessa organização não poderão ser descobertos, mesmo que sejam públicos. O proprietário de uma organização pode selecionar todos os repositórios ou repositórios específicos para uma organização e somente os repositórios selecionados serão descobertos. Mesmo que um repositório seja público, ele não poderá ser descoberto, a menos que o proprietário o selecione para uma organização.

    Para repositórios em uma organização, você não deve ter o mesmo repositório configurado em mais de uma ferramenta em uma instância. Se o mesmo repositório estiver configurado para várias ferramentas, os dados serão associados a uma ferramenta aleatória como parte dos eventos de notificações. Se você quiser configurar o mesmo repositório em uma ferramenta diferente, deverá excluir os webhooks criados a partir da primeira ferramenta, cancelar o rastreamento do repositório nessa ferramenta e configurar o mesmo repositório na ferramenta diferente.

    Métodos de autenticação

    Você pode se conectar ao GitHub usando um dos seguintes métodos de autenticação:
    • Autenticação básica

      Se você conectar sua instância do GitHub à autenticação básica, poderá usar as ações personalizadas do mercado do GitHub. Os ambientes do GitHub não são compatíveis com a conexão de autenticação básica.

    • Credenciais OAuth 2.0
      • Se você conectar sua instância do GitHub com credenciais OAuth 2.0 para código de autorização, poderá usar as ações personalizadas do mercado do GitHub e criar segredos para usar em fluxos de trabalho. Para obter mais informações, consulte Credenciais OAuth 2.0 para aplicações GitHub - Código de autorização.
      • Se você conectar sua instância do GitHub com credenciais OAuth 2.0 para GitHub Apps - JWT, poderá usar as ações personalizadas do mercado do GitHub, criar segredos para usar em fluxos de trabalho e ambientes do GitHub para implantar em um ambiente. Para obter mais informações, consulte Credenciais OAuth 2.0 para aplicações GitHub - JWT. Para repositórios do GitHub em uma organização, somente uma organização pode ser instalada por ferramenta (ou seja, o app One GitHub pode ser instalado com a organização One GitHub e com a ferramenta One GitHub). Se você quiser adicionar mais organizações, poderá criar ferramentas e aplicativos separados.

    Ações personalizadas por ServiceNow estão disponíveis no GitHub Marketplace para a capacidade de orquestração, para enviar informações de Ações (fluxos de trabalho) e para pausar ou retomar fluxos de trabalho de Velocidade de mudança para DevOps. Para obter mais informações sobre ações personalizadas, consulte Ações personalizadas do ServiceNow DevOps do mercado do GitHub.

    Para capturar os dados de fluxo de trabalho em Velocidade de mudança para DevOps, você deve configurar os segredos na ferramenta GitHub. Para obter mais informações, consulte GitHub Actions configurações.

    Existem algumas limitações para o suporte a GitHub Actions, consulte GitHub Actions configurações.

    Iniciar

    Use uma das seguintes opções para integrar GitHub. Para uma experiência guiada, use o espaço para integrar uma ferramenta. Como alternativa, você pode usar o Catálogo de serviços ou a experiência clássica.