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.
Observação
A vinculação a problemas do GitHub requer o Azure DevOps Server 2019 Atualização 1 ou versão posterior.
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:
Em seu quadro, localize o item de trabalho a partir do qual você deseja criar um branch do GitHub.
Selecione
Ações do item de trabalho>Novo branch GitHub.
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.
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
Observação
A vinculação a um problema do GitHub requer o Azure DevOps Server 2019 Atualização 1 ou versão posterior.
Abra o item de trabalho e vá para a guia Links.
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á.
Observação
Há um atraso ao concluir os links AB# se você estiver usando o Azure DevOps Server e o GitHub Enterprise Server. Temos um design "push-and-pull" para extrair dos eventos do GitHub a cada hora sobre as alterações incrementais em Commit, PR e Problema.
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.
