Instalar o aplicativo Azure Boards para GitHub

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Instale o aplicativo Azure Boards para GitHub para conectar o Azure Boards a seus repositórios do GitHub. Ao conectar projetos do Azure Boards com repositórios GitHub.com, você dá suporte à conexã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 o Azure Boards para planejar e acompanhar seu trabalho.

Para obter uma visão geral da integração compatível com o aplicativo Azure Boards para GitHub, confira Integração entre o Azure Boards e o GitHub. Depois de instalar o aplicativo Azure Boards para GitHub na sua conta ou organização do GitHub, escolha a quais repositórios do GitHub você quer conectar a partir do seu projeto.

Pré-requisitos

Permissões:

  • Você deve ser um administrador ou um proprietário da organização 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, você 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 ao aplicativo GitHub. Siga as instruções em Adicionar ou remover repositórios do GitHub, mais adiante neste artigo, antes de configurar o aplicativo GitHub.

Se for administrador desses repositórios, você pode conectar uma organização do Azure DevOps a diversos repositórios do GitHub. Mas você não deve conectar um repositório do GitHub a mais de uma organização do Azure DevOps.

Conceder acesso à organização Azure Boards

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 tela da guia Aplicativos OAuth Autorizados, escolha Azure Boards.

  4. Em Acesso à organização, resolva possíveis problemas que possam aparecer. Selecione Conceder para conceder acesso a todas as organizações que aparecem com uma solicitação de Acesso pendente.

    Captura de tela Acesso à 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, botão Configurar um plano.

  3. Escolha a organização do GitHub à qual você deseja conectar o Azure Boards.

    Captura de tela mostrando a caixa de diálogo Instalar Azure Boards.

  4. Escolha os repositórios que você quer conectar aos Azure Boards.

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

    Captura de tela mostrando todos os repositórios selecionados.

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

    Captura de tela da caixa de diálogo de configuração de conexão.

    Você pode exportar somente um projeto por vez. Se você quiser conectar outros projetos, poderá fazer isso depois, como descrito em Configurar outros projetos ou repositórios posteriormente neste artigo.

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

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

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

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

Usar a conexão

Neste ponto, sua integração do Azure Boards com o GitHub do Azure está concluída. Você pode ignorar os próximos passos ou segui-los para entender os recursos compatíveis com a conexão.

  1. No seu quadro, selecione Novo item de trabalho para inserir um novo item de trabalho chamado "Adicionar notificação ao LEIAME", Problema (Básico), Histórico do Usuário (Agile) ou Item de Backlog do Produto (Scrum), dependendo do modelo de processo usado pelo seu projeto do Azure Boards.

    Um item de trabalho intitulado Adicionar notificação ao LEIAME aparece no 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 da solicitação de 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 do ID da solicitação de pull e comentário opcional.

    As seguintes ações ocorrem no segundo plano automaticamente:

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

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

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

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

  7. Selecione Mesclar solicitação de pull.

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

  8. Vá ao arquivo LEIAME do repositório e veja a notificação que foi adicionada.

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

    Para obter mais informações, consulte Configurar notificações de status para adicionar a arquivos LEIAME do GitHub.

Configurar outros projetos ou repositórios

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

Adicionar ou remover repositórios ou remover conexão do Azure Boards

Se houver um problema com uma conexão, recomendamos remover a conexão e recomeçar com uma nova conexão.

  1. No seu projeto do Azure DevOps, vá até 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 a partir do 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.

    Captura de tela da remoção de confirmação da conexão do 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 da conexão do GitHub.

Alterar o acesso ao repositório

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

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

  2. Acesse Aplicativos GitHub instalados>Azure Boards>Configurar.
    Captura de tela da conta da Organização aberta, aplicativos GitHub instalados, Azure Boards, Configurar.

    A página de configurações 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 Somente repositórios selecionados.

    Se você escolher Somente repositórios selecionados, selecione os repositórios que você deseja que participem da integração com o Azure Boards.

    Captura de tela de Acesso ao repositório, escolha Somente repositórios selecionados.

  5. Selecione Salvar.

Suspender ou desinstalar a integração com o Azure Boards

  1. Começando na etapa 2 do procedimento anterior, role para baixo até a seção Zona de perigo.

    Captura de tela das configurações do Azure Boards, seção Zona de perigo.

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

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

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

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

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

Atualizar as conexões do GitHub com Azure Boards

Se modificar os repositórios compatíveis com o aplicativo Azure Boards para GitHub, você poderá ser redirecionado a conexões GitHub do Azure Boards. Uma boa prática é remover os repositórios no Azure Boards que não podem mais ser conectados 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 aparecerá no Azure Boards, Configurações do projeto> Conexões GitHub. Selecione Remover conexão para remover todas as conexões do GitHub feitas anteriormente. Para obter mais informações, consulte Adicionar/Remover repositórios do GitHub.

Captura de tela do aplicativo GitHub do Azure Boards desinstalado.

Próximas etapas

Vincular solicitações de pull e commit do GitHub para itens de trabalho