Skip to main content

Atualmente o GitHub AE está em versão limitada.

Vinculando uma pull request a um problema

Você pode vincular uma solicitação de pull a um problema para mostrar que uma correção está em andamento e fechar automaticamente o problema quando a solicitação de pull for mesclada.

Observação: as palavras-chave especiais em uma descrição de solicitação de pull são interpretadas quando a solicitação de pull tem como destino o branch padrão do repositório. No entanto, se a base da PR for qualquer outro branch, essas palavras-chave serão ignoradas, nenhum vínculo será criado e a mesclagem da PR não terá nenhum efeito sobre os problemas. Caso você deseje vincular uma solicitação de pull a um problema usando uma palavra-chave, a PR precisa estar no branch padrão.

Sobre problemas e pull requests vinculados

Você pode vincular um problema a uma solicitação de pull manualmente ou usando uma palavra-chave com suporte na descrição da solicitação de pull.

Quando você vincula uma pull request ao problema que a pull request tem de lidar, os colaboradores poderão ver que alguém está trabalhando no problema.

Quando você mescla uma pull request vinculada no branch padrão de um repositório, o problema vinculado será fechado automaticamente. Para obter mais informações sobre o branch padrão, confira "Alterar o branch-padrão".

Vinculando uma pull request a um problema usando uma palavra-chave

Você pode vincular uma solicitação de pull a um problema usando uma palavra-chave com suporte na descrição da solicitação de pull ou em uma mensagem de commit. A solicitação de pull deve estar no branch padrão.

  • close
  • closes
  • closed
  • fix
  • fixes
  • fixed
  • resolve
  • resolves
  • resolved

Se você usar uma palavra-chave para fazer referência a um comentário de um pull request em outr pull request, os pull requests serão vinculados. O merge da solicitação de pull de referência também fechará a solicitação de pull referenciada.

A sintaxe para fechar palavras-chave depende se o problema está no mesmo repositório que a pull request.

Problemas vinculadoSintaxeExemplo
Problema no mesmo repositórioPALAVRA-CHAVE #NÚMERO-PROBLEMACloses #10
Problema em um repositório diferentePROPRIETÁRIO DA PALAVRA-CHAVE/REPOSITÓRIO#NÚMERO-PROBLEMAFixes octo-org/octo-repo#100
Múltiplos problemasUsar sintaxe completa para cada problemaResolves #10, resolves #123, resolves octo-org/octo-repo#100

Somente as solicitações de pull vinculadas manualmente podem ser desvinculadas manualmente. Para desvincular um problema que você vinculou usando uma palavra-chave, você deve editar a descrição da solicitação de pull para remover a palavra-chave.

Você também pode usar palavras-chave de fechamento em uma mensagem de commit. O problema será encerrado quando você mesclar o commit no branch padrão, mas o pull request que contém o commit não será listado como um pull request vinculado.

Como vincular manualmente uma solicitação de pull a um problema usando a barra lateral de solicitação de pull

Qualquer pessoa com permissões de gravação em um repositório pode vincular manualmente uma solicitação de pull a um problema usando a barra lateral de solicitação de pull.

Você pode vincular manualmente até dez problemas para cada pull request. O problema e a pull request devem estar no mesmo repositório.

  1. No sua empresa, navegue até a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Solicitações de pull.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  3. Na lista de pull requests, clique na pull request que você gostaria de vincular a um problema.

  4. Na barra lateral direita, clique em Desenvolvimento.

    Captura de tela da barra lateral do problema. "Desenvolvimento" tem o contorno em laranja escuro.

  5. Clique no problema que você deseja associar à pull request.

Leitura adicional