Mesclar solicitações de pull empilhadas

Mesclar uma pilha de baixo para cima, individualmente ou em grupos contíguos.

Neste artigo

Observação

Esse recurso está em versão prévia pública e está sujeito a alterações.

Solicitações de pull empilhadas mesclam da parte inferior (mais próxima do tronco) para cima.

  • Você pode mesclar qualquer número de solicitações de pull de uma só vez, desde que elas formem um grupo contíguo a partir da solicitação de pull não mesclada mais baixa.
  • Você não pode mesclar uma solicitação de pull de pilha intermediária isoladamente, as solicitações de pull abaixo dela sempre serão mescladas com ela.

Requisitos de mesclagem

A caixa de mesclagem de uma solicitação de pull empilhada mostra o status de toda a pilha, não apenas a solicitação de pull atual. Antes que uma solicitação de pull na pilha possa ser mesclada, o seguinte deve ser verdadeiro:

  • Todas as solicitações de pull abaixo dela são aprovadas e têm verificações de passagem.
  • A pilha tem um histórico linear.
  • A solicitação de pull atual atende a todos os requisitos de proteção de branch para a base de pilha, como main.

Se a pilha não for linear, por exemplo, depois que as alterações forem enviadas por push para um branch inferior ou depois que o tronco for movido para frente, um botão de pilha rebase aparecerá na caixa de mesclagem e você precisará rebasear a pilha antes de mesclar.

Observação

  • Se você mesclar por meio da API e quiser usar solicitações de pull empilhadas, precisará atualizar seu código para usar a nova API de mesclagem para pilhas. Consulte Solicitações de pull empilhadas nas APIs REST e GraphQL.
  • Não há suporte para mesclagem automática para solicitações de pull empilhadas.

Mesclar usando uma fila de mesclagem

As pilhas dão suporte total a filas de mesclagem. Todas as solicitações de pull na pilha são adicionadas à fila na ordem correta. Se uma solicitação de pull for removida ou ejetada da fila, todas as solicitações de pull acima dela na pilha também serão removidas.

Observação

Para manter uma pilha unida, a fila de mesclagem permite que o grupo de mesclagem exceda seu tamanho máximo configurado em até 50%. Se a pilha for muito grande para caber dentro desse buffer, ela será dividida automaticamente entre grupos de mesclagem consecutivos.

Mesclando de baixo para cima

  1. Navegue até a solicitação de pull não mesclada mais baixa na pilha ou para uma solicitação de pull mais alta se você quiser mesclar um grupo contíguo até esse ponto.

  2. Confirme se a solicitação de pull e todas as solicitações de pull abaixo dela atendem aos requisitos de mesclagem.

  3. Mescle a pull request. A solicitação de pull selecionada e todas as solicitações de pull não mescladas abaixo dela chegam ao branch base juntas como uma única operação, ordenada de baixo para cima no histórico resultante.

Após a mesclagem, a próxima solicitação de pull não mesclada é rebased automaticamente para direcionar a base de pilha diretamente, para que ela se mova para a parte inferior e esteja pronta para revisão e mesclagem.

Depois que cada solicitação de pull em uma pilha for mesclada, a pilha será concluída e não poderá ser estendida. Se você adicionar novos branches na parte superior e executar gh stack submit, GitHub CLI iniciará automaticamente uma nova pilha com raiz no tronco desses branches.