Como mesclar uma solicitação de pull com uma fila de mesclagem

Observação: atualmente, o recurso de fila de mesclagem da solicitação de pull está em versão beta pública e sujeito a alterações.

Sobre as filas de mesclagem

Uma fila de mesclagem pode aumentar a velocidade na qual as solicitações de pull são mescladas em um branch de destino ocupado, garantindo que todas as verificações de proteção de branch obrigatórias sejam aprovadas.

Depois que uma solicitação de pull tiver sido aprovada por todas as verificações de proteção de branch obrigatórias, um usuário com acesso de gravação no repositório poderá adicionar essa solicitação de pull a uma fila de mesclagem.

Uma fila de mesclagem poderá usar o GitHub Actions. Para obter mais informações, confira "Documentação do GitHub Actions". Para obter informações sobre a fila de mesclagem, confira "Como gerenciar uma fila de mesclagem".

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

Dica: você pode usar GitHub CLI para adicionar uma solicitação de pull a uma fila de mesclagem. Para obter mais informações, clique na guia "GitHub CLI" na parte superior deste artigo.

No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Solicitações de pull.
Na lista "Solicitações de Pull", clique na solicitação de pull que deseja adicionar a uma fila de mesclagem.
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 (ignorar proteções de branch) , se permitido pelas configurações de proteção de branch, e siga o fluxo padrão.
Dica: clique em Mesclar quando estiver pronto sempre que estiver pronto para mesclar as alterações propostas. O GitHub adicionará automaticamente a solicitação de pull à fila de mesclagem depois que as condições de aprovação e verificação de status necessárias forem atendidas.
Confirme se deseja adicionar a solicitação de pull à fila de mesclagem clicando em Confirmar mesclagem quando estiver pronto.

Com GitHub CLI, você pode usar o comando gh pr merge para adicionar uma solicitação de pull a uma fila de mesclagem. Se você estiver direcionando um branch que requer uma fila de mesclagem, esse comando adicionará automaticamente a solicitação de pull à 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. Para obter mais informações, confira gh pr merge no manual da GitHub CLI.

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

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

No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Solicitações de pull.
Na lista "Solicitações de Pull", clique na solicitação de pull que deseja remover de uma fila de mesclagem.
Para remover a solicitação de pull da fila, clique em Remover da fila.

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 selecionar Remover da fila. Para obter informações sobre como acessar a página de fila de mesclagem do branch base, confira a seção abaixo.

Como ver as filas de mesclagem

Você pode ver a fila de mesclagem de um branch base em vários locais no GitHub. Você não pode usar GitHub CLI para exibir uma fila de mesclagem.

Você pode ver a fila de mesclagem de um branch base em vários locais no GitHub.

Na página Branches do repositório. Recomendamos que você use essa rota se não tiver ou não souber que uma solicitação de pull já está em uma fila e quiser ver o que está nessa fila. Para obter mais informações, confira "Exibir branches no repositório".
Na página de solicitação de pull quando a fila de mesclagem for necessária para mesclagem, role a página até a parte inferior da linha do tempo e clique no link da fila de mesclagem.
A exibição da fila de merge mostra os pull requests que estão atualmente na fila, com seus pull requests claramente marcados.

Manipulação de pull requests removidos da fila de merge

Após o agrupamento de uma solicitação de pull com a última versão do branch de destino e as alterações à frente dela na fila, se houver verificações de status obrigatórias com falha ou conflitos com o branch base, o GitHub removerá a solicitação de pull da fila. A linha do tempo da solicitação de pull exibirá o motivo pelo qual ela foi removida da fila.