Integrar GitHub em Velocidade de mudança para DevOps — Clássico

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Conecte sua instância GitHub para descobrir, configurar e importar repositórios, planos e pipelines.

    Antes de Iniciar

    Função necessária: sn_devops.admin ou sn_devops.tool_owner

    Conclua as etapas especificadas na seção Introdução antes de se conectar a uma ferramenta.

    Por Que e Quando Desempenhar Esta Tarefa

    • Conecte-se a GitHub e obtenha a URL do webhook ao enviar um registro da ferramenta DevOps.
    • Descobrir repositórios e planos.
    • Configure o webhook no repositório GitHub.
    • Importar registros de ramificação e confirmação.

    Procedimento

    1. Insira os detalhes da instância GitHub para se conectar ao DevOps Change Velocity navegando até Tudo > DevOps > Ferramentas > Criar novo (legado).
    2. Insira um valor no campo Nome da ferramenta e preencha os detalhes da ferramenta.
      Tabela 1. Formulário Criar ferramenta de DevOps
      Campo Descrição
      Integração da ferramenta

      Ferramenta a ser integrada. Nesse caso, selecione GitHub.
      URL da Ferramenta

      URL da instância GitHub existente a ser integrada. Por exemplo, https://api.github.com
      GitHub tipo de credencial
      • Autoriz. básica
        • Nome do usuário GitHub
        • Token de acesso pessoal (clássico)

        Somente um token de acesso pessoal (clássico) é compatível com a autenticação básica. Ao gerar um token de acesso pessoal (clássico) para GitHub, você deve especificar os escopos a serem autorizados se não estiver concedendo acesso completo. Os escopos mínimos que você deve selecionar para autorização são repo, admin:repo_hook e user:email.

      • OAuth

        GitHub Credencial da ferramenta. Consulte Configuração de GitHub credenciais do OAuth 2.0 para Velocidade de mudança para DevOps.

      Para obter uma lista de todas as permissões necessárias nas credenciais para se conectar a GitHub, consulte GitHub permissões em Permissões necessárias para DevOps ferramentas.

    3. Opcional: Selecione MID Server para uma ferramenta no local que está anexada a um MID Server.

      A aplicação é definida automaticamente como DevOps e a capacidade é definida como REST.

      Nota:
      O tipo de concessão do código de autorização OAuth é compatível com o GitHub e o GitHub Enterprise com MID Server.
    4. Selecione Enviar.
    Após a criação bem-sucedida da ferramenta, você será direcionado para a página de registro da ferramenta.
    1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por na guia Acesso.
      As tarefas que os usuários nos grupos podem executar dependem das funções atribuídas 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 do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
      • DevOps Função de administrador: pode editar todas as ferramentas.
      • Outras funções DevOps : pode exibir a ferramenta.
      Nota:
      Somente grupos que contêm usuários com funções DevOps estão disponíveis para seleção no campo Mantido por.

      A opção Todos os proprietários de app podem exibir e associar objetos de ferramenta a aplicações se torna disponível para seleção se você optar por restringir o acesso à ferramenta. Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.

    2. Selecione Descobrir para descobrir repositórios, planos ou pipelines existentes para a ferramenta.
      Registros de repositório são adicionados à lista relacionada de Repositórios.
    3. Configure automaticamente a URL do webhook em um repositório GitHub para enviar notificações à ferramenta DevOps selecionando Configurar.
      Como alternativa, você pode habilitar a pesquisa noturna para buscar o sistema de dados para qualquer repositório ou pipeline rastreado, definindo a propriedade Habilitar pesquisa como Sim.
      Nota:
      Se você não tiver privilégios de administrador para a ferramenta GitHub (para permitir a configuração automática da URL do webhook), talvez precise que o usuário administrador da ferramenta a configure para você (crie e configure a URL do webhook manualmente na instância da ferramenta). Depois que o webhook estiver configurado na ferramenta, entre no modo de configuração manual para se conectar à ferramenta manualmente e saia.
    4. Clique em Importar para importar dados históricos do repositório.
      Registros de ramificação importados e registros de confirmação do repositório são adicionados às listas relacionadas correspondentes.
    5. No campo Aplicação, clique na lista de pesquisa e selecione um registro de aplicação para associar ao repositório ou clique em Novo para criar um.