Conecte o Azure Boards ao GitHub (cloud)

Azure DevOps Serviços

Use GitHub.com repositórios para o seu desenvolvimento de software e para o seu projeto Azure Boards para planear e acompanhar o seu trabalho. Liga o teu projeto e repositório para que os teus commits e pull requests do GitHub fiquem ligados aos teus itens de trabalho no Azure Boards.

Note

Os Azure Boards e Azure DevOps Services suportam integração com repositórios GitHub.com e GitHub Enterprise Server. Se quiser ligar-se a partir de um Azure DevOps Server local, veja Conecte Azure DevOps Server ao GitHub Enterprise Server.

Prerequisites

Category	Requirements
Permissões	- Membro do grupo Project Collection Administrators Se você criou o projeto, você tem permissões. - Administrador ou proprietário do repositório GitHub a que se pode ligar. Podes ligar-te a vários repositórios do GitHub desde que sejas administrador desses repositórios.
Adesão ao projeto	Membro do projeto.

Opções de autenticação

As seguintes opções de autenticação são suportadas com base na plataforma GitHub à qual pretende ligar-se.

GitHub.com

GitHub Enterprise Server

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

• OAuth (preferencial, registo obrigatório)
• PAT
• GitHub credenciais

Note

Se optar por ligar o GitHub com um PAT, configure o single log-on (SSO) para o PAT na sua conta GitHub. Essa configuração é necessária para recuperar uma lista de repositórios de uma organização com a autenticação SSO SAML (Security Assertion Markup Language) habilitada.

Ligue o Azure Boards a um repositório do GitHub

1. Inicie sessão no seu projeto ().

2. Selecione definições do projeto>GitHub ligações.

   

3. Se for a primeira vez que ligas a partir do projeto, seleciona Liga a tua conta GitHub para usares as credenciais da tua conta GitHub.

   

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

   Quando te ligares à tua conta GitHub, usa as tuas credenciais GitHub para autenticares. Para usar um PAT, veja Adicionar uma ligação GitHub usando PAT. Para se ligar a um GitHub Enterprise Server, veja Register Azure DevOps in GitHub as an OAuth App.

Adicionar uma ligação ao GitHub com credenciais do GitHub

Pode ligar até 1.000 repositórios GitHub a um projeto Azure Boards.

1. Se for a tua primeira vez a ligar-te ao GitHub a partir do Azure Boards, inicia sessão usando as tuas credenciais do GitHub. Escolha uma conta para a qual você seja administrador de repositório.

2. Selecione a conta ou organização do GitHub que quer ligar. Somente as organizações que você possui ou é administrador são listadas.

   Se todos os repositórios de uma organização já estiverem ligados ao Azure Boards, a seguinte mensagem mostra:

   Captura de ecrã da mensagem onde não existem mais repositórios para ligar.

3. Introduza as suas credenciais no GitHub. Se tiver a autenticação de dois fatores ativada, introduza o código de autenticação enviado por GitHub e selecione Verify. Se não, o sistema reconhece automaticamente a sua organização GitHub, pois a sua conta GitHub está associada à sua conta Azure DevOps Services.

Adicionar repositórios do GitHub

Uma vez autenticado, você pode selecionar os repositórios que deseja conectar.

1. O diálogo Add GitHub Repositories exibe e seleciona automaticamente todos os repositórios do GitHub.com nos quais você é administrador dentro da organização selecionada. Desmarque todos os repositórios que você não deseja incluir na integração.

   

   Tip

   Para evitar a ligação inesperada de menções AB#, recomendamos ligar um repositório GitHub a projetos dentro de uma mesma organização Azure DevOps. Ligar o mesmo repositório GitHub a projetos em várias organizações Azure DevOps pode causar problemas. Para mais informações, consulte Resolução de problemas na integração do GitHub e Azure Boards.

   Se todos os repositórios já estiverem conectados à organização atual ou a outra organização, a seguinte mensagem será exibida:

   Captura de ecrã da mensagem onde não existem mais repositórios para ligar.

2. Depois de fazer suas seleções, selecione Salvar.

Confirme a ligação

1. Revise a página de GitHub que aparece e depois escolha Aprovar, Instalar & Autorizar.

   

2. Forneça as suas credenciais do GitHub para confirmar.

3. Quando terminar, você verá a nova conexão com os repositórios selecionados listados.

Captura de ecrã da lista de repositórios ligados.

Para alterar a configuração ou gerir a aplicação Azure Boards para GitHub, consulte Alterar o acesso ao repositório para Azure Boards.

Adicionar uma ligação ao GitHub usando PAT

Important

Considere usar tokens mais seguros Microsoft Entra em vez de tokens de acesso pessoal de maior risco. Para mais informações, consulte Reduzir o uso do PAT. Consulte as orientações de autenticação para escolher o mecanismo de autenticação adequado às suas necessidades.

Recomendamos que uses as credenciais da tua conta no GitHub para te ligares ao teu repositório GitHub.

Tip

Ao criar o seu GitHub PAT, certifique-se de incluir estas permissões: repo, read:user, user:email, admin:repo_hook.

1. Escolha Token de acesso pessoal.

   

   Para criar um GitHub PAT, vá para Configurações de Desenvolvedor no GitHub > Tokens de acesso pessoal.

2. Introduza a PAT e selecione Ligar.

   Captura de tela mostrando o PAT inserido.

3. Selecione os repositórios que deseja conectar ao projeto seguindo os procedimentos descritos em Escolha os repositórios anteriormente neste artigo.

4. Se for a primeira vez que se liga a uma conta ou organização GitHub a partir do Azure Boards, instale a aplicação Azure Boards para o GitHub. Confirme a conexão anteriormente neste artigo.

Registe o Azure DevOps no GitHub como uma Aplicação OAuth

Para usar o OAuth para ligar o Azure DevOps ao seu GitHub Enterprise Server, primeiro registe a aplicação como uma aplicação OAuth. Para obter mais informações, consulte Criar uma aplicação OAuth.

Register Azure DevOps Services

1. Inicie sessão no portal web do seu servidor GitHub Enterprise.

   

2. Abra ConfiguraçõesConfigurações do desenvolvedorAplicações OAuthNova Aplicação OAuth.

   Captura de ecrã a mostrar a sequência para uma nova aplicação OAuth.

3. Insira as informações de registro.

   Para o URL da página inicial, especifique o URL da sua organização.
   Para a URL de retorno de chamada de autorização, use o padrão a seguir para construir a URL.

   {Azure DevOps Services Organization URL}/_admin/oauth2/callback

   Por exemplo:

   https://dev.azure.com/fabrikam/_admin/oauth2/callback

   Captura de ecrã a mostrar a inscrição na aplicação.

4. Selecione Registrar aplicativo.

5. A ID do Cliente e o Segredo do Cliente do seu aplicativo OAuth registrado são exibidos.

   Captura de ecrã do ID do Cliente e do Segredo do Cliente para a aplicação OAuth registada.

Registe a sua configuração OAuth nos Serviços Azure DevOps

1. Inicie sessão no portal web para Azure DevOps Services.

2. Adicione a configuração do GitHub Enterprise Oauth à sua organização.

3. Em Configurações da organização, selecione Configurações do OauthAdicionar configuração do Oauth.

   Captura de ecrã das Definições da Organização Abertas, Configurações OAuth.

4. Introduza as suas informações e, em seguida, selecione Criar.

   Caixa de diálogo Configurações do OAuth.

Connect Azure DevOps Services to GitHub Enterprise Server

Important

Para ligar os Serviços Azure DevOps ao seu GitHub Enterprise Server, certifique-se de que o seu GitHub Enterprise Server está acessível a partir da Internet. Verifique se o DNS do Azure consegue resolver o nome do seu GitHub Enterprise Server e se o seu firewall permite o acesso a partir dos endereços IP do Azure Data Center. Para determinar o intervalo de endereços IP, consulte Microsoft Azure Data Center IP Ranges. Uma mensagem de erro comum para problemas de conectividade é:

O nome remoto não pôde ser resolvido: 'github-enterprise-server.contoso.com'

Se você encontrar esse erro, verifique a acessibilidade do servidor. Para mais informações, consulte DNS do Azure FAQ.

1. Selecione definições do projeto>GitHub ligações>GitHub Enterprise Server para uma ligação pela primeira vez.

   

   Ou, a partir do diálogo New GitHub connection, selecione GitHub Enterprise Server.

   

2. Selecione o método de autenticação.

   Captura de tela mostrando a caixa de diálogo do método de autenticação.

   Conecte-se com OAuth

   Escolhe a configuração que configuraste em Passo 4 de Registar a tua configuração OAuth em Azure DevOps Services, e depois escolhe Conectar.

   

   Conecte-se com um token de acesso pessoal

   Introduza o URL do seu servidor GitHub Enterprise e as credenciais do token de acesso pessoal reconhecidas por esse servidor. E, em seguida, escolha Conectar.

   

   Conectar com as credenciais do GitHub

   Introduza o URL do seu servidor GitHub Enterprise e as credenciais da conta de administrador reconhecidas por esse servidor, e depois selecione Conectar.

   

3. O diálogo lista todos os repositórios para os quais 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. Quando terminar, selecione Guardar.

   Captura de ecrã dos repositórios listados.

   Tip

   Só pode fazer uma ligação a repositórios definidos sob uma organização do GitHub. Para ligar um projeto a outros repositórios definidos noutra organização do GitHub, deve adicionar outra ligação.

4. Se for a sua primeira vez a ligar-se a uma conta ou organização GitHub a partir do Azure Boards, também instala a aplicação Azure Boards para o GitHub. Confirme a conexão anteriormente neste artigo.

Resolver problemas de ligação

A integração Azure Boards-GitHub utiliza vários protocolos de autenticação para manter a ligação. Alterações ao âmbito de permissões ou credenciais de autenticação de um utilizador podem revogar os repositórios do GitHub ligados ao Azure Boards.

Para uma visão geral da integração suportada pela aplicação Azure Boards para GitHub, veja Azure Boards-GitHub integração.

Opções de autenticação suportadas

As seguintes opções de autenticação suportadas dependem da plataforma GitHub à qual se está a ligar:

Platform

GitHub.com

GitHub Enterprise Server

Azure DevOps Serviços

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

• OAuth
• PAT
• Credenciais do GitHub

Azure DevOps Server 2020

Não aplicável

• PAT
• Credenciais do GitHub

Note

GitHub suporte de integração:

• Azure DevOps Services: Integra-se tanto com repositórios GitHub.com como GitHub Enterprise Server através da aplicação Azure Boards para GitHub.
• Azure DevOps Server 2020 e posteriores: Suporta integração apenas com repositórios GitHub Enterprise Server.
• Outros repositórios Git: A integração não é suportada.

Conceder acesso à organização do Azure Boards

Se a integração entre Azure Boards e GitHub não estiver a funcionar como esperado, verifica se concedeste acesso à organização.

1. A partir do portal web do GitHub, abra Configurações no menu do seu perfil.
   Captura de tela do perfil aberto, escolha Configurações.

2. Selecione Aplicações em Integrações>Apps OAuth Autorizadas>Azure Boards.

3. Em Acesso à organização, resolva quaisquer problemas que possam aparecer. Selecione Conceder para conceder acesso a todas as organizações que mostram ter uma solicitação de acesso pendente.

   Captura de ecrã do acesso à organização, mostrando organizações sem acesso.

Resolver problemas de acesso

Quando a ligação do Azure Boards ao GitHub perde o acesso, aparece um estado de alerta com um vermelho-X na interface do utilizador. Passe o cursor sobre o alerta para ver se as credenciais não são mais válidas. Para corrigir o problema, remova a conexão e crie uma nova.

Captura de ecrã da ligação falhada.

Para resolver esse problema, considere os seguintes itens:

• Se a conexão estiver usando OAuth:

  • A aplicação Azure Boards teve o acesso negado a 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

    Apaga e recria a ligação ao repositório do GitHub. Esta ligação recriada faz com que o GitHub solicite a reautorização do Azure Boards.

• Se a conexão estiver usando um PAT:

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

  • O utilizador pode não ter permissões de administrador no repositório do GitHub.

    Recrie a PAT e verifique se o escopo do token inclui as permissões necessárias: . Para obter mais informações, consulte Práticas recomendadas para usar PATs.

Resolver ligação falhada ao GitHub Enterprise Server

Se migrou do Azure DevOps Server para o Azure DevOps Services com uma ligação GitHub Enterprise Server existente, a sua ligação pode não funcionar como esperado. Menções a itens de trabalho no GitHub podem estar atrasadas ou nunca aparecer no Azure DevOps Services porque o URL de callback associado ao GitHub já não é válido. Considere as seguintes resoluções:

• Remover e recriar a ligação: Remover e recriar a ligação ao repositório GitHub Enterprise Server. Siga a sequência de passos fornecida na documentação Conectar do Azure Boards.

• Corrigir o URL do webhook: Vá à página de configurações do repositório do GitHub e edite o URL do webhook, apontando para o URL da organização Azure DevOps migrada: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Conectar-se a várias organizações Azure DevOps

Ligar o seu repositório GitHub a projetos em várias organizações Azure DevOps, como dev.azure.com/Contoso e dev.azure.com/Fabrikam, pode potencialmente causar resultados inesperados com menções a AB#. Os IDs de itens de trabalho não são únicos entre as organizações do Azure DevOps, por isso AB#12 pode referir-se a um item de trabalho em Contoso ou na Fabrikam. Quando um item de trabalho é mencionado em uma mensagem de commit ou pull request, ambas as organizações podem tentar vincular a um item de trabalho com o ID correspondente, causando confusão.

Para evitar este problema, ligue um único repositório GitHub a apenas uma organização Azure DevOps.

Note

Quando se liga usando a aplicação Azure Boards para o GitHub, a aplicação impede ligações a várias organizações. Se um repositório GitHub estiver ligado à organização Azure DevOps errada, contacte o proprietário dessa organização para remover a ligação antes de adicionar o repositório à organização Azure DevOps correta.

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

Atualize as definições XML para os tipos de itens de trabalho se a sua organização usar o modelo de processo XML Hospedado ou XML local para personalizar a experiência de acompanhamento do trabalho e ligar e visualizar os tipos de ligação do GitHub da secção de Desenvolvimento nos formulários de itens de trabalho.

Por exemplo, para ligar histórias de utilizador e erros a commits e pull requests no GitHub a partir da secção Development, atualize as definições XML para as histórias de utilizador e erros.

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, encontre a secção Group Label="Development" e adicione as seguintes duas linhas na sintaxe do código para suportar os tipos de links externos: GitHub Commit e GitHub Pull Request.

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

Após a atualização, 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>  

FAQs

P: Alguns dos meus utilizadores no Azure DevOps têm identidades no GitHub. Preciso de os adicionar como novos utilizadores do GitHub à minha organização?

R: Não. Peça aos seus utilizadores para desconectarem e depois voltarem a iniciar sessão na organização com as suas credenciais do GitHub a partir de uma sessão de navegador nova. Esta ação estabelece as suas identidades no GitHub.

P: Sou administrador de organização e ativei a política para convidar utilizadores do GitHub. Porque é que não posso convidar novos utilizadores do GitHub?

R: Depois de alterar a definição, saia da Azure DevOps e depois volte a iniciar sessão na organização (dev.azure.com/{organizationName} ou organizationName.visualstudio.com) com as suas credenciais de GitHub a partir de uma sessão de navegador nova.

P: Iniciei sessão com as minhas credenciais do GitHub, mas porque é que não posso convidar os utilizadores do GitHub?

R: Somente os administradores da organização ou do projeto podem convidar novos usuários para ingressar na organização. Talvez você não tenha as permissões necessárias para adicionar novos usuários. Trabalhe com o administrador para obter as permissões necessárias ou peça-lhe para adicionar o usuário para você.

P: Os utilizadores do GitHub Enterprise têm acesso gratuito ao Azure DevOps?

R: Para mais informações, consulte >.

Próximos passos

Associar commits, pull requests e branches do GitHub a itens de trabalho

Conteúdo relacionado

• Instala e configura a aplicação Azure Boards para GitHub
• Configurar emblemas de status para adicionar aos ficheiros README do GitHub
• Solução de problemas de integração do GitHub e Azure Boards
• Compilar repositórios do GitHub
• Alterar acesso ao repositório do GitHub

O que pode fazer com a integração do GitHub

Uma vez ligado, pode:

• Usa GitHub Copilot: Usa GitHub Copilot com itens de trabalho para geração automatizada de código
• Associar itens de trabalho: Associar automaticamente commits, branches e pull requests a itens de trabalho
• Acompanhar o desenvolvimento: Monitorizar o progresso diretamente a partir de Azure Boards