Compartilhar via

Instalar o aplicativo Azure Boards para GitHub

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Nesta introdução, instala-se o aplicativo Azure Boards para o GitHub, conectando o Azure Boards aos seus repositórios no GitHub. Ao conectar Azure Boards projetos com repositórios de GitHub.com, você dá suporte à vinculação entre confirmações de GitHub e solicitações de pull para itens de trabalho. Você pode usar GitHub para desenvolvimento de software ao usar Azure Boards para planejar e acompanhar seu trabalho. Depois de instalar o aplicativo Azure Boards para GitHub na sua conta ou organização do GitHub, escolha quais repositórios do GitHub você deseja conectar ao projeto.

Para obter uma visão geral da integração que o aplicativo Azure Boards para GitHub dá suporte, consulte Azure Boards-GitHub integration.

Prerequisites

Category Requirements
Permissões - Membro do grupo Administradores de Coleção de Projetos. Se você criou o projeto, tem permissões.
- Administrator ou owner da organização GitHub para instalar o aplicativo Azure Boards.
permissões - Read para o repositório GitHub.
Associação ao projeto Membro do projeto.

Important

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

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

Instalar e configurar o aplicativo Azure Boards

Sua sequência de instalação pode variar devido à configuração da sua conta. Se necessário, siga os prompts na tela entre as etapas a seguir.

  1. Acesse o aplicativo Azure Boards no GitHub Marketplace.

  2. Em Planos e preços, em Gratuito, selecione Instalar.

  3. Em Instalar & Autorize Azure Boards, escolha os repositórios aos quais deseja se conectar Azure Boards e selecione Instalar & Authorize.

    Este exemplo usa todos os repositórios:

    A captura de tela mostra a página Instalar e Autorizar com todos os repositórios selecionados.

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

    Screenshot mostra a página Configurar seu projeto Azure Boards em que você seleciona uma organização e um project.

    Você pode conectar 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.

Conceder acesso à organização Azure Boards

Se necessário, para conceder acesso GitHub à sua organização Azure DevOps, siga as etapas a seguir.

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

    A captura de tela mostra a opção Configurações em seu perfil.

  2. Selecione Aplicativos em Integrações.

  3. Selecione Authorized GitHub Apps>Azure Boards.

    Captura de tela mostra aplicativos do GitHub autorizados com o Azure Boards destacado.

  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.

    A captura de tela mostra acesso à organização, destacando organizações sem acesso.

Verifique sua política de acesso a aplicativos de terceiros

Verifique se sua organização GitHub permite acesso a aplicativos de terceiros para o aplicativo Azure Boards. Se o acesso de terceiros for restrito, a adição de repositórios de Azure DevOps poderá mostrar uma lista vazia ou produzir um erro.

Para habilitar o acesso:

  1. Em GitHub, abra sua organização e vá para Configurações > Política de Aplicativo OAuth.

  2. Aprove o aplicativo Azure Boards especificamente (recomendado) ou remova as restrições para todos os aplicativos de terceiros.

    A captura de tela mostra a política de acesso de aplicativos de terceiros.

Observação

Você deve ser um proprietário ou administrador da organização para alterar essa configuração.

Usar a conexão

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

  1. Em seu quadro, selecione O novo item de trabalho para inserir um novo item de trabalho chamado "Adicionar selo ao README"— Problema (Básico), História do Usuário (Agile) ou Item de Backlog do Produto (Scrum)— dependendo do modelo de processo usado pelo projeto 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. No tipo Link, selecione GitHub Solicitação de Pull.

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

  5. Selecione Adicionar link.

    A captura de tela mostra a ação de adicionar link na user story, exibindo a seleção do repositório e caixas vazias para a entrada do ID da solicitação de pull e comentário opcional.

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

    • Adiciona um selo ao arquivo README do primeiro repositório na lista de repositórios de GitHub conectados.
    • Cria uma confirmação GitHub para a atualização feita adicionando o selo ao arquivo README.
    • Cria uma solicitação de pull GitHub para mesclar as alterações feitas no arquivo README.
    • Vincula a solicitação de confirmação e pull 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.

    Screenshot mostra o formulário de problema para solicitação de pull aberta em GitHub.

    Um pull request do GitHub é aberto em uma nova guia do navegador.

  7. Selecione Mesclar solicitação de pull.

    Screenshot mostra o exemplo de solicitação de pull em GitHub.

  8. Vá ao arquivo README do seu repositório e veja o emblema que foi adicionado.

    Screenshot mostra o repositório GitHub com selo adicionado.

    Para obter mais informações, consulte Adicionar insígnias de status ao seu repositório GitHub.

Configurar outros projetos ou repositórios

Você pode configurar outros projetos Azure Boards/Azure DevOps, GitHub.com repositórios ou alterar a configuração atual da página do aplicativo Azure Boards. ** Para obter mais informações, consulte Adicionar ou remover repositórios, ou remova uma conexão dos Azure Boards.

Adicionar ou remover repositórios ou remover uma conexão de 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 projeto em Azure DevOps, vá para Project settings>GitHub connections.

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

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

  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 mostra a remoção da confirmação da conexão do GitHub.

Alterar o acesso ao repositório

  1. Na página do GitHub, abra Configurações no menu de perfil.

  2. SelecioneIntegrações>Aplicativos. Em Aplicativos GitHub Instalados, selecione Configurar.

    Screenshot mostra os Aplicativos GitHub Instalados com Azure Boards e a opção 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 Somente repositórios selecionados.

    Se você escolher Selecionar apenas repositórios, selecione os repositórios que deseja integrar com o Azure Boards.

    A captura de tela mostra o acesso ao Repositório, onde você pode escolher repositórios selecionados.

  5. Clique em Salvar.

Suspender ou desinstalar a integração de Azure Boards

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

    A captura de tela mostra a seção Zona perigo, com opções para suspender e desinstalar.

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

    A captura de tela mostra a caixa de diálogo de confirmação de suspensão.

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

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

    A captura de tela mostra a caixa de diálogo de confirmação de desinstalação.

Atualizar conexões entre o Azure Boards e o GitHub

Se você alterar os repositórios aos quais o aplicativo Azure Boards para GitHub dá suporte, você poderá ser redirecionado para Azure Boards GitHub conexões. Uma boa prática é remover os repositórios em Azure Boards que não podem mais se conectar a GitHub. Para obter mais informações, consulte Adicionar ou remover repositórios do GitHub.

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

Screenshot mostra um aplicativo do GitHub do Azure Boards desinstalado.

Próximas etapas

Link GitHub confirmações, solicitações de pull e branches para itens de trabalho

Conteúdo relacionado

  • Last updated on