Vincular confirmações do GitHub, solicitações de pull e problemas a itens de trabalho no Azure Boards

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

Neste artigo, saiba como vincular itens de trabalho a commits e solicitações de pull do GitHub depois de conectar seu projeto do Azure Boards a um repositório do GitHub. Você pode usar a sintaxe #mention ou adicionar um link de confirmação ou solicitação de pull do GitHub diretamente do item de trabalho do Azure Boards.

Observação

Com o aplicativo Azure Boards para GitHub, o Azure Boards e o Azure DevOps Services se integram aos repositórios do GitHub.com e do GitHub Enterprise Server. Azure DevOps Server 2019 e versões posteriores dão suporte à integração somente com repositórios GitHub Enterprise Server. Não há suporte para a integração com outros repositórios Git.

Pré-requisitos

• Conexões de projeto:

  • Certifique-se de que seu projeto do Azure Boards esteja conectado ao repositório do GitHub onde existem os commits e solicitações de pull que você deseja vincular para/de. Para obter mais informações, consulte integração Azure Boards-GitHub.

• Permissões:

  • Seja um colaborador do projeto Azure Boards e do repositório GitHub.

Observação

Os projetos que usam o modelo de processo XML hospedado exigem atualizações dos tipos de item de trabalho para exibir a seção Desenvolvimento e os tipos de link do GitHub. Para obter mais informações, consulte Atualizar definições XML para selecionar tipos de item de trabalho.

Usar AB# para vincular do GitHub aos itens de trabalho do Azure Boards

Em uma confirmação do GitHub, solicitação de pull ou problema, use a sintaxe a seguir para criar um link para o item de trabalho do Azure Boards. Insira o AB#ID dentro do texto de uma mensagem de confirmação. Ou, para uma solicitação de pull ou problema, insira o AB#ID no título ou na descrição. Usar AB#ID em um comentário não criará um link no item de trabalho.

AB#{ID}

Por exemplo, AB#125 links para a ID 125 do item de trabalho.

Você também pode inserir uma mensagem de confirmação ou solicitação de pull para fazer a transição do item de trabalho. O sistema reconhece fix, fixes, e fixed, e o aplica ao item de #-mention que segue. Os itens de trabalho mencionados fazem a transição para o primeiro Estado associado ao estado da categoria de fluxo de trabalho Resolvido. Se não houver um Estado que seja associado a Resolvido, o item de trabalho passa para o Estado associado ao estado da categoria de fluxo de trabalho Concluído. Para obter mais informações, consulte Como os estados de categoria de fluxo de trabalho são usados ​​em backlogs e painéis do Azure Boards.

Revise a tabela de exemplos a seguir:

Mensagem de solicitação de pull ou confirmação	Ação
Fixed AB#123	Vincula e faz a transição do item de trabalho para a categoria de estado do fluxo de trabalho Resolvido ou, se nenhum for definido, a categoria de estado do fluxo de trabalho Concluído.
Adds a new feature, fixes AB#123.	Vincula e faz a transição do item de trabalho para a categoria de estado do fluxo de trabalho Resolvido ou, se nenhum for definido, a categoria de estado do fluxo de trabalho Concluído.
Fixes AB#123, AB#124, and AB#126	Vincula aos itens de trabalho 123, 124 e 126 do Azure Boards. Faz a transição apenas do primeiro item, 123, para a categoria de estado do fluxo de trabalho Resolvido ou, se nenhum for definido, para a categoria de estado do fluxo de trabalho Concluído.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Vincula aos itens de trabalho 123, 124 e 126 do Azure Boards. Faz a transição de todos os itens para a categoria de estado do fluxo de trabalho Resolvido ou, se nenhum for definido, para a categoria de estado do fluxo de trabalho Concluído.
Fixing multiple bugs: issue #123 and user story AB#234	Vincula ao problema 123 do GitHub e ao item de trabalho 234 do Azure Boards. Nenhuma transição é feita.

Observação

Se você conectou o mesmo repositório GitHub a projetos definidos em duas ou mais organizações do Azure DevOps, poderá ver vinculação inesperada de menção AB#. Para obter mais informações, consulte Resolver problemas de conexão. Por esse motivo, recomendamos que você conecte apenas um repositório GitHub a projetos definidos em uma única organização do Azure DevOps.

Criar um branch do GitHub a partir do item de trabalho

Para criar um branch do GitHub diretamente de um item de trabalho, siga estas etapas:

1. Em seu quadro, localize o item de trabalho a partir do qual você deseja criar um branch do GitHub.

2. Selecione Ações do item de trabalho>Novo branch GitHub.

   

3. Na caixa de diálogo Criar um branch do GitHub, insira o nome do branch e selecione o repositório do GitHub e o branch base.

4. Selecione Criar.

   

   O Azure Boards cria o branch no repositório GitHub especificado e o vincula ao item de trabalho. Para obter mais informações, consulte integração Azure Boards-GitHub.

Adicionar link de item de trabalho ao branch, commit ou solicitação de pull do GitHub

1. Abra o item de trabalho e vá para a guia Links.

   

2. Na caixa de diálogo Adicionar link , selecione um dos tipos de link do GitHub, selecione um repositório do GitHub, insira a URL para o branch do GitHub, a confirmação ou a solicitação de pull e selecione Adicionar link.

   No exemplo a seguir, adicionamos um link para uma solicitação de pull do GitHub.

   

   O Azure Boards conclui uma verificação para garantir que você inseriu um link válido. O repositório do GitHub vinculado deve estar conectado ao projeto do Azure Boards ou a validação falhará.

Exibir ou abrir links da seção Desenvolvimento

A seção Desenvolvimento no formulário de item de trabalho lista os links criados para solicitações de pull e confirmações do GitHub com o ícone do GitHub .

Escolha o link fornecido para abrir a solicitação de pull ou confirmação no GitHub.

Exibir objetos de GitHub em um painel

Com as anotações do GitHub habilitadas no quadro, você pode abrir rapidamente commits, solicitações de pull ou problemas do GitHub vinculados para obter mais detalhes. Para obter mais informações, confira Personalizar cartões.

Próximas etapas

Configurar selos de status

Artigos relacionados

• Integrar o Azure Boards com o GitHub
• Entenda como os estados da categoria de fluxo de trabalho são usados nas listas de pendências e quadros do Azure Boards
• Vincular itens de trabalho a objetos
• Solucionar problemas de integração do GitHub e do Azure Boards