Como mesclar uma pull request com uma fila de mesclagem

Use filas de mesclagem em GitHub para agilizar a mesclagem de pull requests, garantir que as verificações necessárias sejam aprovadas e gerenciar as operações da fila de forma eficaz.

Quem pode usar esse recurso?

As filas de mesclagem de solicitação de pull estão disponíveis em qualquer repositório público pertencente a uma organização ou em repositórios privados pertencentes a organizações que usam GitHub Enterprise Cloud. Consulte Planos do GitHub.

Tool navigation

Neste artigo

Sobre as filas de mesclagem

Uma fila de mesclagem ajuda a mesclar pull requests em uma ramificação protegida ocupada após a aprovação das verificações necessárias. Consulte Como gerenciar uma fila de mesclagem.

Como adicionar uma solicitação de pull a uma fila de mesclagem

Observação

Você pode usar GitHub CLI para adicionar um pull request a uma fila de mesclagem. Para obter mais informações, clique na guia "GitHub CLI" na parte superior deste artigo.

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Pull requests.

    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 "Solicitações de Pull", clique na pull request que você deseja adicionar a uma fila de mesclagem.

  4. Clique em Mesclar quando estiver pronto para adicionar a solicitação de pull à fila de mesclagem. Como alternativa, se você for um administrador, poderá:

    • Mescle diretamente a solicitação de pull marcando Mesclar sem esperar que os requisitos sejam atendidos (evitar proteções de branch), se for permitido pelas configurações de proteção de branch, e siga o fluxo padrão.

    Captura de tela das opções de fila de mesclagem para uma pull request.

    Observação

    Você pode clicar em Mesclar quando estiver pronto antes que todos os requisitos sejam atendidos. GitHub adiciona a pull request à fila quando os requisitos são atendidos.

  5. Confirme se deseja adicionar a solicitação de pull à fila de mesclagem clicando em Confirmar mesclagem quando estiver pronto.

Com GitHub CLI, use o comando gh pr merge para adicionar uma pull request a uma fila de mesclagem. Se você estiver direcionando um branch que requer uma fila de mesclagem, esse comando adicionará automaticamente a pull request à fila se as verificações necessárias tiverem passado. Se as verificações necessárias não tiverem passado, esse comando habilitará a mesclagem automática para a solicitação de pull. Confira gh pr merge no manual GitHub CLI.

Como remover uma solicitação de pull de uma fila de mesclagem

Para remover uma pull request de uma fila de mesclagem, você deve navegar até a página do repositório em GitHub.com. Você não pode usar GitHub CLI para remover uma pull request de uma fila de mesclagem.

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Pull requests.

    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 "Solicitações de Pull", clique na pull request que você deseja remover de uma fila de mesclagem.

  4. Para remover a solicitação de pull da fila, clique em Remover da fila.

    Captura de tela da mensagem de fila de mesclagem no final de uma pull request. O botão "Remover da fila" está bordado no tom de laranja escuro.

Como alternativa, navegue até a página da fila de mesclagem do branch base, clique em … ao lado da solicitação de pull que deseja remover e selecione Remover da fila. Para obter informações sobre como acessar a página da fila de mesclagem da ramificação base, consulte a seção abaixo.

Como ver as filas de mesclagem

Você pode visualizar a fila de mesclagem de uma ramificação base em vários locais em GitHub. Você não pode usar GitHub CLI para exibir uma fila de mesclagem.

Você pode visualizar a fila de mesclagem de uma ramificação base em vários locais em GitHub.

  • Na página Branches do repositório. Recomendamos esse caminho se você não tiver ou não souber da existência de um pull request que já esteja em uma fila e quiser ver o que há nessa fila. Consulte Exibir ramificações (branches) no seu repositório.

    Captura de tela da página "Branches" para um repositório. Um link, rotulado "33 pull requests colocadas na fila para mesclagem", está contornado em laranja escuro.

  • Na página da pull request, quando uma fila de mesclagem for necessária para a mesclagem, role até o final da linha do tempo e clique no link fila de mesclagem.

    Captura de tela da mensagem de fila de mesclagem no final de uma pull request. O link "Fila de mesclagem" está contornado em laranja escuro.

  • A exibição da fila de merge mostra os pull requests que estão atualmente na fila, com seus pull requests claramente marcados.

    Captura de tela da fila de merge de um repositório.

Entender por que o pull request foi removido da fila de integração

Uma solicitação de pull poderá ser removida da fila de mesclagem se ela não atender mais aos requisitos de mesclagem ou se uma verificação de fila falhar.

Há vários motivos pelos quais uma solicitação de pull pode ser removida de uma fila de mesclagem:

  • O serviço de CI configurado está relatando falhas de teste de um grupo de mesclagem
  • Tempo limite atingido aguardando um resultado de CI bem-sucedido com base na configuração de tempo limite definida
  • Usuário solicitando uma remoção por meio da API ou interface da fila de mesclagem
  • Falha de proteção de branch que não pôde ser resolvida automaticamente