Conexão Azure Boards para GitHub (Nuvem)

Artigo
09/27/2022
7 minutos para o fim da leitura

Azure DevOps Services

Para dar suporte à vinculação de GitHub solicitações de confirmação e pull para Azure Boards itens de trabalho, conecte seu projeto Azure Boards a repositórios GitHub.com. Em seguida, use GitHub para desenvolvimento de software ao usar Azure Boards para planejar e acompanhar seu trabalho. Para obter uma visão geral do aplicativo Azure Boards para GitHub, consulte a integração Boards-GitHub do Azure.

Quando você faz a conexão de Azure Boards, a lista de repositórios GitHub corresponde aos que você permite que Azure Boards acessem. Você pode limitar quais repositórios Azure Boards acessos em geral e limitar o que um projeto específico acessa ou dividir o gerenciamento de trabalho em diferentes projetos Azure Boards.

Observação

Azure Boards e Azure DevOps Services dão suporte à integração com repositórios GitHub.com e GitHub Enterprise Server. Se você quiser se conectar de um Azure DevOps Server local, consulte Conexão Azure DevOps Server para GitHub Enterprise Server.

Pré-requisitos

Conexão a um projeto de Azure Boards ou Azure DevOps. Se você ainda não tiver um projeto, crie um.
Você deve ser membro do grupo administradores de coleção Project e do grupo Colaboradores do projeto. Se você criou o projeto, tem permissões.
Você deve ser um administrador ou proprietário do repositório GitHub ao qual se conectará. Você pode se conectar a vários repositórios GitHub desde que seja um administrador para esses repositórios.

Opções de autenticação

As opções de autenticação a seguir têm suporte com base na plataforma GitHub à qual você deseja se conectar.

GitHub.com

GitHub Enterprise Server

conta de usuário do GitHub.com (Recomendado)
PAT (token de acesso pessoal)

OAuth (preferencial, registro necessário)
PAT
Nome de usuário mais senha

Observação

Se você optar por conectar o Github ao PAT, configure o SSO (logon único) para o PAT em sua conta GitHub. Isso é necessário para obter uma lista de repositórios de uma organização com a autenticação SSO saml (Security Assertion Markup Language) configurada.

Abra conexões Project Configurações> GitHub.

Entre Azure Boards para o projeto ao qual você deseja se conectar GitHub repositórios.
Escolha (1) Project Configurações> (2) GitHub conexões.
Se for a primeira vez que faz uma conexão com o projeto, escolha Conexão sua conta GitHub para usar suas credenciais de conta GitHub.

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

Ao se conectar usando sua conta GitHub, use suas credenciais de conta GitHub para autenticar. Se estiver se conectando usando PAT, consulte Adicionar uma conexão GitHub usando PAT. Se estiver se conectando a um servidor GitHub Enterprise, consulte Registrar Azure DevOps em GitHub como um aplicativo OAuth.

Adicionar uma conexão GitHub com credenciais GitHub

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

Se for a primeira vez que se conecta ao GitHub de Azure Boards, você será solicitado a entrar usando suas credenciais de GitHub. Escolha uma conta para a qual você é administrador dos repositórios aos quais deseja se conectar.
Se você pertencer a mais de um GitHub conta ou organização, escolha aquele cujos repositórios você deseja conectar. Somente as organizações para as quais você possui ou é administrador estão listadas.

Se todos os repositórios de uma organização já estiverem conectados ao Azure Boards, você verá a mensagem a seguir.
Quando solicitado, insira suas credenciais de GitHub.

Se você tiver habilitado a autenticação de dois fatores, insira o código de autenticação que GitHub enviado e escolha Verificar.

Caso contrário, o sistema reconhecerá automaticamente sua organização GitHub, pois sua conta GitHub foi associada anteriormente à sua conta Azure DevOps Services.

Escolher os repositórios

Depois de autenticado, você pode selecionar os repositórios que deseja conectar.

A caixa de diálogo Adicionar GitHub Repositórios é exibida automaticamente e seleciona todos os repositórios GitHub.com para os quais você é administrador da organização selecionada. Desmarque todos os repositórios que você não deseja participar da integração.

Dica

Recomendamos que você conecte apenas um repositório GitHub a projetos definidos em uma única organização Azure DevOps. Conectar o mesmo repositório GitHub a projetos definidos em duas ou mais organizações Azure DevOps pode levar a uma vinculação inesperada de menção AB#. Para obter detalhes, consulte Solucionar problemas GitHub & integração Azure Boards.

Se todos os repositórios já estiverem conectados à organização atual ou outra, a mensagem a seguir será exibida.
Quando terminar, escolha Salvar.

Confirmar a conexão

Nesta etapa, você instalará o aplicativo Azure Boards para GitHub na conta GitHub ou organização associada aos repositórios aos quais você escolheu se conectar.

Examine a página GitHub que é exibida e escolha Aprovar, Instalar, & Autorizar.
Forneça sua senha GitHub para confirmar.
Quando terminar, você deverá ver a nova conexão com os repositórios selecionados listados.

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

Adicionar uma conexão GitHub usando PAT

Recomendamos que você use suas credenciais de conta GitHub para se conectar ao repositório GitHub. No entanto, se você precisar usar um PAT, faça isso seguindo esses procedimentos.

Dica

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

Para escolher um PAT ao conectar um repositório GitHub, escolha o Token de Acesso Pessoal ao fazer uma conexão pela primeira vez.

Ou, na caixa de diálogo Nova GitHub conexão.

Para criar um PAT GitHub, acesse GitHub tokens de acesso Configurações> Personal do Desenvolvedor.
Insira o PAT e escolha Conexão.
Escolha os repositórios que você deseja conectar ao projeto seguindo os procedimentos descritos em Escolher os repositórios anteriormente neste artigo.
Se for a primeira vez que se conectar a uma conta ou organização GitHub de Azure Boards, você também instalará o aplicativo Azure Boards para GitHub. Conclua a integração seguindo os procedimentos descritos em Confirmar a conexão anteriormente neste artigo.

Registrar Azure DevOps em GitHub como um aplicativo OAuth

Se você planeja usar o OAuth para conectar Azure DevOps Services ou Azure DevOps Server com o servidor GitHub Enterprise, primeiro você precisa registrar o aplicativo como um Aplicativo OAuth. Para obter detalhes, consulte Como criar um aplicativo OAuth.

Registrar Azure DevOps Services

Entre no portal da Web para seu servidor GitHub Enterprise.
Abra Configurações> Developer settingsOauth> Apps e escolha Novo Aplicativo OAuth.
Preencha o formulário para registrar seu aplicativo Azure DevOps Server.

Para a URL da Página Inicial, especifique a URL da organização 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
Escolha Registrar aplicativo.
Após o sucesso, você verá uma página que fornece a ID do Cliente e o Segredo do Cliente para seu aplicativo OAuth registrado.

Registrar sua configuração do OAuth no Azure DevOps Services

Entre no portal da Web para Azure DevOps Services.
Adicione a GitHub Enterprise configuração de Oauth à sua organização.
Abra as configurações> de configurações do OrganizationOauth e, em seguida, escolha Adicionar configuração de Oauth.
Preencha o formulário exibido e, em seguida, escolha Criar.

Conexão Azure DevOps Services para GitHub Enterprise Server

Importante

Para se conectar Azure DevOps Services ao servidor GitHub Enterprise, seu servidor GitHub Enterprise deve estar suficientemente acessível pela Internet. Verifique se o DNS do Azure pode resolver o nome do servidor GitHub Enterprise e se o firewall permite o acesso de endereços IP do Data Center do Azure. Para determinar o intervalo de endereços IP, consulte Microsoft Azure Intervalos de IP do Datacenter. Uma mensagem de erro comum encontrada quando há problemas de conectividade é:

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

Se você encontrar esse erro, verifique se o servidor está acessível. Para obter mais informações, consulte perguntas frequentes sobre o DNS do Azure.

Na página de conexões Project Configurações> GitHub escolha GitHub Enterprise Servidor, escolha GitHub Enterprise Servidor ao fazer uma conexão de primeiro tempo.

Ou, na caixa de diálogo Nova GitHub conexão, escolha GitHub Enterprise Servidor.
Selecione o método de autenticação.

Conexão usando OAuth

Escolha a configuração que você configurou na Etapa 4 de Registrar sua configuração do OAuth no Azure DevOps Services e escolha Conexão.

Conexão usando um token de acesso pessoal

Insira a URL do servidor GitHub Enterprise e as credenciais de token de acesso pessoal reconhecidas por esse servidor. E escolha Conexão.

Conexão usando um nome de usuário e senha

Insira a URL do servidor GitHub Enterprise e as credenciais da conta de administrador reconhecidas por esse servidor. E escolha Conexão.

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

Dica

Você só pode fazer uma conexão com repositórios definidos em um GitHub organização. Para conectar um projeto a outros repositórios definidos em outro GitHub organização, você deve adicionar outra conexão.
Se for a primeira vez que se conectar a uma conta ou organização GitHub de Azure Boards, você também instalará o aplicativo Azure Boards para GitHub. Conclua a integração seguindo os procedimentos descritos em Confirmar a conexão anteriormente neste artigo.