Partilhar via

Conectar o Azure DevOps Server ao GitHub (local)

Azure DevOps Server | Azure DevOps Server 2022

Quando você conecta seu projeto do Servidor de DevOps do Azure aos repositórios do GitHub, dá suporte à vinculação entre confirmações do GitHub e solicitações pull para itens de trabalho. Você pode usar o GitHub para desenvolvimento de software enquanto usa os Painéis do Azure para planejar e acompanhar seu trabalho.

Note

O Azure DevOps Server dá suporte à integração com repositórios GitHub.com e GitHub Enterprise Server. Para se conectar a partir dos Serviços de DevOps do Azure, consulte Conectar painéis do Azure ao GitHub.

Prerequisites

Category Requirements
Permissions - Membro do grupo Administradores da Coleção do Projeto e do grupo Contribuidores do Projeto. Se você criou o projeto, então você tem permissões.
- Administrador do GitHub Enterprise Server ao qual se conecta.
Participação no projeto Membro do projeto.
Integração com GitHub - Azure DevOps Server 2020.1.1 Patch 2. Sem esse patch, você só pode se conectar aos repositórios do GitHub Enterprise Server.
- aplicação Azure Boards para GitHub instalada nas organizações ou na conta do GitHub.

Opções de autenticação

As seguintes opções de autenticação são suportadas:

Note

O OAuth não tem suporte para o Azure DevOps Server 2020.

Conectar o Azure DevOps Server ao GitHub Enterprise Server

Você pode conectar até 250 repositórios do GitHub a um projeto do Azure Boards.

  1. Abra o portal da Web para seu Servidor de DevOps do Azure.

  2. Selecione o logotipo do Azure DevOps para abrir Projetos e, em seguida, escolha o projeto do Azure Boards que você deseja configurar para se conectar aos repositórios do GitHub Enterprise.

  3. Selecione Configurações do projeto>Conexões do GitHub.

    Captura de tela de Configurações de projeto abertas, conexões do GitHub.

  4. Se for a primeira vez que você faz uma conexão do projeto, escolha o método de autenticação que deseja usar para fazer a conexão:

    Captura de tela da primeira conexão com as credenciais do GitHub.

    Caso contrário, selecione Nova conexão e selecione seu método de autenticação na caixa de diálogo Nova conexão .

Conectar o Servidor de DevOps do Azure com um token de acesso pessoal do GitHub

  1. Para criar um PAT do GitHub, consulte Criar um PAT do GitHub.

    Tip

    Ao criar seu PAT do GitHub, certifique-se de incluir estes escopos: repo, admin:repo_hook, read:user, user:email.

  2. Insira a URL do seu servidor GitHub Enterprise e as suas credenciais de token de acesso pessoal reconhecidas por esse servidor. E, em seguida, selecione Conectar.

    Captura de tela do login com o PAT do GitHub.

Conectar o Servidor de DevOps do Azure com credenciais do GitHub

  1. Insira a URL do seu servidor GitHub Enterprise e as credenciais da conta de administrador reconhecidas por esse servidor. E, em seguida, escolha Conectar.

    Captura de tela do login com credenciais do GitHub.

  2. A caixa de diálogo lista todos os repositórios para os quais você tem direitos de administração do GitHub. Você pode alternar entre Meu e Todos para determinar se outros aparecem e, em seguida, verificar os que você deseja adicionar. Escolha Salvar quando terminar.

    Captura de ecrã dos repositórios a selecionar para adicionar.

  3. Para se conectar a uma conta ou organização do GitHub a partir dos Painéis do Azure pela primeira vez, você também instala o aplicativo Painéis do Azure para GitHub. Conclua a integração seguindo os procedimentos descritos em Confirmar a conexão.

Resolver problemas de ligação

A integração Azure Boards-GitHub depende de vários protocolos de autenticação para dar suporte à conexão. Alterações no escopo de permissão ou credenciais de autenticação de um usuário podem causar a revogação dos repositórios do GitHub conectados aos Painéis do Azure.

Para obter uma visão geral da integração suportada pelo aplicativo Azure Boards for GitHub, consulte Integração Azure Boards-GitHub.

Quando a conexão do Azure Boards com o GitHub não tem mais acesso, ela mostra um status de alerta na interface do usuário com um X vermelho. Passe o cursor sobre o alerta e ele indica que as credenciais não são mais válidas. Para corrigir o problema, remova a conexão e recrie uma nova conexão.

Captura de ecrã da ligação falhada.

Considere as seguintes resoluções:

  • Se a conexão estiver usando OAuth:

    • O aplicativo Azure Boards teve acesso negado para um dos repositórios.

    • O GitHub pode estar indisponível/inacessível. Essa indisponibilidade pode ser devido a uma interrupção no serviço ou a um problema de infraestrutura/rede no local. Você pode verificar o status do serviço nos seguintes links:

      Exclua e recrie a conexão com o repositório GitHub. Essa conexão recriada faz com que o GitHub solicite a reautorização do Azure Boards.

  • Se a conexão estiver usando um PAT do GitHub:

    • A PAT do GitHub foi revogada ou os escopos de permissão necessários foram alterados e são insuficientes.

    • O usuário talvez tenha perdido permissões administrativas no repositório GitHub.

      Recrie a PAT do GitHub e verifique se o escopo do token inclui as permissões necessárias: repo, read:user, user:email, admin:repo_hook.

Atualizar definições XML para tipos de item de trabalho selecionados

Se sua organização personaliza o controle de trabalho usando o XML hospedado ou o modelo de processo XML local e deseja integrar os tipos de link do GitHub na seção Desenvolvimento dos formulários de item de trabalho, você deve atualizar as definições XML para os tipos de item de trabalho correspondentes.

Por exemplo, para vincular histórias de usuários e bugs a confirmações do GitHub e solicitações pull dentro da seção Desenvolvimento de formulários de item de trabalho, você deve atualizar as definições XML para esses tipos de item de trabalho.

Para modificar as definições XML, execute as etapas descritas em Modelo de processo XML hospedado. Para cada tipo de item de trabalho:

  1. Localize a secção Group Label="Development".
  2. Para suportar os tipos de link externo, GitHub Commit e GitHub Pull Request, adicione as seguintes linhas de código:

Essa integração permite o acompanhamento contínuo das atividades do GitHub diretamente de seus itens de trabalho nos Painéis do Azure.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />

Quando for atualizado, a seção deve aparecer da seguinte maneira.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>

Próximos passos

Vincular commits e pull requests do GitHub a itens de trabalho

Conteúdo relacionado

  • Last updated on