Partilhar via

Instalar a aplicação Azure Boards para GitHub

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Instale o aplicativo Azure Boards for GitHub para conectar o Azure Boards aos seus repositórios do GitHub. Ao conectar projetos do Azure Boards com repositórios GitHub.com, você 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.

Para obter uma visão geral da integração suportada pelo aplicativo Azure Boards for GitHub, consulte Integração Azure Boards-GitHub. Depois de instalar o aplicativo Azure Boards para GitHub em sua conta ou organização do GitHub, escolha a quais repositórios do GitHub você deseja se conectar a partir do seu projeto.

Pré-requisitos

Permissões:

  • Você deve ser um administrador ou proprietário da organização do GitHub para instalar o aplicativo Azure Boards.
  • Você deve ter permissões de leitura para o repositório GitHub.
  • Você deve ser membro do grupo Administradores de Coleção de Projetos. Se você criou o projeto, já tem essas permissões.

Importante

Se o repositório já estiver conectado por meio de outro tipo de autenticação, como OAuth, você deverá remover esse repositório da conexão existente antes de reconectá-lo por meio do aplicativo GitHub. Siga as etapas fornecidas em Adicionar ou remover repositórios do GitHub mais adiante neste artigo antes de configurar o aplicativo GitHub.

Você pode conectar uma organização do Azure DevOps a vários repositórios do GitHub se for um administrador desses repositórios. No entanto, você não deve conectar um repositório GitHub a mais de uma organização do Azure DevOps.

Conceder acesso à organização dos Painéis do Azure

Para conceder acesso ao GitHub à sua organização do Azure DevOps, execute as etapas a seguir.

  1. No portal da Web do GitHub, abra Configurações no menu do seu perfil.

    Captura de tela do perfil aberto, escolha Configurações.

  2. Selecione Aplicativos em Integrações.

  3. Selecione Aplicativos>GitHub Autorizados Azure Boards.

    Captura de ecrã do separador Aplicações OAuth Autorizadas, selecione Azure Boards.

  4. 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 tela do acesso da organização com organizações sem acesso.

Instalar e configurar o aplicativo Azure Boards

  1. Vá para o aplicativo Azure Boards no GitHub Marketplace.

  2. Selecione Configurar um plano.

    Captura de tela do GitHub Marketplace, Configurar um botão de plano.

  3. Escolha a organização do GitHub que você deseja conectar aos Painéis do Azure.

    Captura de ecrã a mostrar a caixa de diálogo Instalar Painéis do Azure.

  4. Escolha os repositórios que você deseja conectar aos Painéis do Azure.

    No exemplo a seguir, optamos por nos conectar a todos os repositórios.

    Captura de ecrã a mostrar todos os repositórios selecionados.

  5. Escolha a organização do Azure DevOps e o projeto do Azure Boards ao qual você deseja se conectar GitHub.com.

    Captura de ecrã da caixa de diálogo de configuração da ligação.

    Você só pode conectar um projeto de cada vez. Se você tiver outros projetos que deseja conectar, poderá fazê-lo posteriormente, conforme descrito em Configurar outros projetos ou repositórios , mais adiante neste artigo.

  6. Para se conectar ao GitHub.com, autorize sua organização do Azure Boards.

    Captura de ecrã da caixa de diálogo de autorização do Azure Boards.

  7. Confirme os GitHub.com repositórios que você deseja conectar. Selecione cada repositório ao qual você deseja se conectar. Desmarque todos os repositórios que você não deseja participar da integração.

    Captura de tela da caixa de diálogo Confirmar seus repositórios do GitHub.

Use a conexão

Neste ponto, sua integração do Azure Boards-GitHub está concluída. Você pode pular as próximas etapas ou passar por elas para entender os recursos suportados com a conexão.

  1. No seu quadro, selecione Novo item de trabalho para inserir um novo item de trabalho chamado "Adicionar selo ao LEIA-ME" — Problema (Básico), História de Usuário (Agile) ou Item de Lista de Pendências do Produto (Scrum) — dependendo do modelo de processo usado pelo seu projeto do Azure Boards.

    Um item de trabalho intitulado Adicionar selo ao LEIA-ME aparece no seu quadro.

  2. Abra seu item de trabalho, vá para a seção Desenvolvimento e selecione Adicionar link.

  3. Selecione GitHub Pull Request no menu suspenso Tipo de link.

  4. Selecione o repositório e insira o ID de solicitação pull e um comentário opcional.

  5. Selecione Adicionar link.

    Captura de tela da ação Adicionar link na história do usuário, mostrando a seleção do repositório e caixas vazias para entrada de ID de solicitação pull e comentário opcional.

    As seguintes ações ocorrem em segundo plano, automaticamente:

    • Adiciona um selo ao arquivo LEIA-ME do primeiro repositório na lista de repositórios do GitHub conectados.
    • Cria uma confirmação do GitHub para a atualização feita adicionando o selo ao arquivo LEIA-ME.
    • Cria uma solicitação pull do GitHub para mesclar as alterações feitas no arquivo LEIA-ME.
    • Vincula a solicitação commit e pull do GitHub ao item de trabalho criado na etapa 1.

  6. Selecione o primeiro link de solicitação pull do seu item de trabalho.

    Captura de tela do formulário de problema para solicitação pull aberto no GitHub.

    A solicitação pull do GitHub é aberta em uma nova guia do navegador.

  7. Selecione Mesclar solicitação pull.

    Captura de tela de exemplo de solicitação pull no GitHub.

  8. Vá para o arquivo README do repositório e visualize o selo que foi adicionado.

    Captura de tela do repositório GitHub com emblema adicionado.

    Para obter mais informações, consulte Configurar selos de status para adicionar aos arquivos LEIA-ME do GitHub.

Configurar outros projetos ou repositórios

Você pode configurar outros Azure Boards/Azure DevOps Projects, GitHub.com repositórios ou alterar a configuração atual na página do aplicativo Azure Boards. Para obter mais informações, consulte Alterar o acesso ao repositório GitHub ou suspender ou desinstalar a integração.

Adicionar ou remover repositórios ou remover uma conexão dos Painéis do Azure

Se você encontrar um problema com uma conexão, recomendamos que você remova a conexão e comece de novo com uma nova conexão.

  1. No seu projeto no Azure DevOps, vá para Configurações>do projeto Conexões do GitHub.

  2. Para adicionar ou remover repositórios, selecione as reticências Mais opções para a conexão e escolha Adicionar repositórios ou Remover repositórios no menu.

    Captura de tela do menu de conexão do GitHub de Mais opções.

  3. Para remover todos os repositórios e a conexão, escolha a opção Remover conexão . Em seguida, escolha Remover para confirmar.

    Screenshot da remoção de confirmação da conexão GitHub.

  1. Para adicionar ou remover repositórios, abra o ícone de ações da conexão e escolha Adicionar repositórios ou Remover repositórios no menu.

    Captura de tela de adicionar ou remover repositórios do GitHub.

  2. Para remover todos os repositórios e a conexão, escolha a opção Remover conexão . Em seguida, escolha Remover para confirmar.

    Captura de tela da caixa de diálogo de confirmação de remoção de conexão do GitHub.

Alterar o acesso ao repositório

  1. Entre no GitHub e abra as configurações de perfil da sua organização.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Vá para Aplicativos>GitHub instalados Azure Boards>Configure.
    Captura de ecrã da conta de Organização aberta, Aplicações GitHub instaladas, Painéis do Azure, Configurar.

    A página de configuração do Azure Boards é aberta.

  3. Role para baixo até a seção Acesso ao repositório .

  4. Escolha a opção desejada, Todos os repositórios ou Selecione apenas repositórios.

    Se você escolher Selecionar apenas repositórios, selecione os repositórios dos quais deseja participar da integração com os Painéis do Azure.

    Captura de tela do acesso ao repositório, escolha Somente selecionar repositórios.

  5. Selecione Guardar.

Suspender ou desinstalar a integração do Azure Boards

  1. A partir da etapa 2 do procedimento anterior, role para baixo até a seção Zona de perigo.

    Captura de ecrã da configuração dos Painéis do Azure, secção Zona de perigo.

  2. Para suspender a integração, escolha Suspender. Na janela pop-up de confirmação, escolha OK para confirmar a suspensão.

    Captura de ecrã da confirmação da suspensão.

    Para cancelar a suspensão da integração, escolha Cancelar suspensão.

  3. Para desinstalar o aplicativo Azure Boards, escolha Desinstalar e, em seguida, escolha OK na janela de confirmação pop-up.

    Captura de ecrã da confirmação de desinstalação.

Atualizar conexões do Azure Boards-GitHub

Se você alterar os repositórios suportados pelo aplicativo Azure Boards for GitHub, poderá ser redirecionado para conexões GitHub do Azure Boards. Uma boa prática é remover os repositórios nos Painéis do Azure que não podem mais se conectar ao GitHub. Para obter mais informações, consulte Adicionar ou remover repositórios do GitHub.

Se você desinstalar o aplicativo Azure Boards para GitHub, a seguinte mensagem será exibida em Azure Boards, Project settings>GitHub connections. Escolha Remover conexão para remover todas as conexões do GitHub feitas anteriormente. Para obter mais informações, consulte Adicionar ou remover repositórios do GitHub.

Captura de ecrã da aplicação GitHub do Azure Boards desinstalada.

Próximos passos

Vincular o GitHub confirma e extrai solicitações para itens de trabalho