Conectar o Azure DevOps Server ao GitHub (local)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Pré-requisitos

• Conecte-se a repositórios GitHub.com instalando o Azure DevOps Server 2020.1.1 Patch 2. Sem esse patch, você só pode se conectar aos repositórios do GitHub Enterprise Server.
• Instale o aplicativo Azure Boards para GitHub nas organizações ou conta do GitHub.
• Conecte-se a um projeto do Azure Boards ou do Azure DevOps. Se você ainda não tem um projeto, crie um.
• Você deve ser membro do grupo Administradores de Coleção de Projetos e do grupo de Colaboradores do projeto. Se você criou o projeto, então você tem permissões.
• Você deve ser um administrador do GitHub Enterprise Server ao qual você se conecta.

Opções de autenticação

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

Conectar o Azure DevOps Server ao GitHub Enterprise Server

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.

Conecte-se com um token de acesso pessoal

1. Para criar um PAT, consulte Criando um token de acesso pessoal.

   Gorjeta

   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 credenciais do token de acesso pessoal reconhecidas por esse servidor. E, em seguida, selecione Conectar.

Conecte-se com um nome de usuário e senha

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.

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.

   

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.

Opções de autenticação suportadas

As seguintes opções de autenticação são suportadas com base na plataforma GitHub à qual você deseja se conectar.

Plataforma

GitHub.com

Servidor GitHub Enterprise

Serviços de DevOps do Azure

• GitHub.com conta de utilizador
• Token de acesso pessoal (PAT)

• OAuth
• PAT
• Nome de utilizador mais palavra-passe

Azure DevOps Server 2020

Não aplicável

• PAT
• Nome de utilizador mais palavra-passe

Azure DevOps Server 2019

Não aplicável

• OAuth
• PAT
• Nome de utilizador mais palavra-passe

Nota

Com a aplicação Azure Boards para GitHub, os Azure Boards e os Azure DevOps Services suportam a integração com os repositórios GitHub.com e GitHub Enterprise Server. Os Servidores de DevOps do Azure 2019 e versões posteriores suportam apenas a integração com repositórios do GitHub Enterprise Server. A integração com outros repositórios Git não é suportada.

Resolver problemas de acesso

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.

Considere as seguintes resoluções:

• Se a conexão estiver usando OAuth:

  • O aplicativo Azure Boards teve seu 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:

    • GitHub
    • Azure DevOps

    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:

  • A PAT pode ter sido revogada ou os escopos de permissão necessários alterados e são insuficientes.

  • O usuário pode ter perdido permissões de administrador no repositório GitHub.

    Recrie a PAT 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 usa o XML hospedado ou o modelo de processo XML local para personalizar a experiência de acompanhamento de trabalho e você deseja vincular e exibir os tipos de link do GitHub na seção Desenvolvimento nos formulários de item de trabalho, você deve atualizar as definições XML para os tipos de item de trabalho.

Por exemplo, se você quiser vincular histórias de usuários e bugs a confirmações do GitHub e solicitações pull da seção Desenvolvimento , será necessário atualizar as definições XML para histórias de usuários e bugs.

Siga a sequência de tarefas fornecida no modelo de processo XML hospedado para atualizar as definições XML. Para cada tipo de item de trabalho, localize a seção e adicione as duas linhas a Group Label="Development" seguir na sintaxe de código a seguir para dar suporte aos tipos de links externos: GitHub Commit e GitHub Pull Request.

             <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 o GitHub confirma e extrai solicitações para itens de trabalho

Artigos relacionados

• O que é o Azure Boards?
• Solucionar problemas de integração do GitHub & Azure Boards
• Criar repositórios do GitHub Enterprise Server