Mesclando uma pull request

Depois que seu código for revisado e todos os revisores necessários o aprovarem, você poderá mesclar uma pull request no CodeCatalyst console usando uma estratégia de mesclagem compatível, como o fast-forward. Nem todas as estratégias de mesclagem suportadas no CodeCatalyst console estão disponíveis como opções para todas as pull requests. CodeCatalyst avalia a mesclagem e só permite que você escolha entre as estratégias de mesclagem que estão disponíveis no console e são capazes de mesclar a ramificação de origem com a ramificação de destino. Você também pode mesclar uma pull request com sua escolha de estratégias de mesclagem do Git executando git merge o comando em seu computador local ou em um ambiente de desenvolvimento para mesclar a ramificação de origem com a ramificação de destino. Em seguida, você pode enviar essas alterações na ramificação de destino para o repositório de origem em CodeCatalyst.

nota

Mesclar a ramificação e enviar as alterações no Git não fecha automaticamente a pull request.

Se você tiver a função de administrador do projeto, também poderá optar por mesclar uma pull request que ainda não atendeu a todos os requisitos de aprovações e regras de aprovação.

Mesclando uma pull request (console)

Você pode mesclar uma pull request no CodeCatalyst console se não houver conflitos de mesclagem entre as ramificações de origem e de destino e se todos os revisores necessários tiverem aprovado a pull request. Se houver conflitos ou se a mesclagem não puder ser concluída, o botão de mesclagem ficará inativo e um rótulo Não mesclável será exibido. Nesse caso, você deve obter a aprovação de todos os aprovadores necessários, resolver conflitos localmente, se necessário, e enviar essas alterações antes de poder mesclar. A mesclagem de uma pull request enviará automaticamente um e-mail para o criador da pull request, bem como para quaisquer revisores obrigatórios ou opcionais. Ele não fechará nem alterará automaticamente o status de nenhum problema vinculado à pull request.

dica

Você pode configurar sobre quais eventos de pull request você receberá e-mails como parte do seu perfil. Para ter mais informações, consulte Enviando notificações do Slack e por e-mail de CodeCatalyst.

Para mesclar uma pull request

1. Navegue até o projeto em que você deseja mesclar uma pull request.

2. Na página do projeto, em Abrir pull requests, escolha a pull request que você deseja mesclar. Se você não vê a pull request, escolha Exibir todas as pull requests e, em seguida, escolha-a na lista. Como alternativa, no painel de navegação, escolha Código, escolha Pull requests e, em seguida, escolha a pull request que você deseja mesclar. Escolha Merge (Mesclar).

3. Escolha entre as estratégias de mesclagem disponíveis para o pull request. Opcionalmente, selecione ou desmarque a opção de excluir a ramificação de origem após mesclar a pull request e, em seguida, escolha Mesclar.

   nota

   Se o botão Mesclar estiver inativo ou você ver o rótulo Não mesclável, os revisores obrigatórios ainda não aprovaram a pull request ou a pull request não pode ser mesclada no console. CodeCatalyst Um revisor que não aprovou uma pull request é indicado por um ícone de relógio na área de detalhes da pull request em Visão geral. Se todos os revisores obrigatórios aprovaram o pull request, mas o botão Mesclar ainda estiver inativo, você pode ter um conflito de mesclagem. Escolha o rótulo sublinhado Não mesclável para ver mais detalhes sobre por que a pull request não pode ser mesclada. Você pode resolver conflitos de mesclagem para a ramificação de destino em um ambiente de desenvolvimento ou no CodeCatalyst console e, em seguida, mesclar a pull request, ou pode resolver conflitos e mesclar localmente e, em seguida, enviar a confirmação que contém a mesclagem para a ramificação de origem em. CodeCatalyst Para obter mais informações, consulte Mesclando uma pull request (Git) e sua documentação do Git.

Substituir requisitos de mesclagem

Se você tiver a função de administrador do projeto, poderá optar por mesclar uma pull request que ainda não atendeu a todos os requisitos das aprovações e regras de aprovação necessárias. Isso é chamado de substituir os requisitos de uma pull request. Você pode optar por fazer isso se um revisor obrigatório não estiver disponível ou se surgir uma necessidade urgente de mesclar um pull request específico em uma ramificação que tenha regras de aprovação que não possam ser atendidas rapidamente.

Para mesclar uma pull request

1. No pull request em que você deseja substituir os requisitos e mesclar, escolha a seta suspensa ao lado do botão Mesclar. Escolha Substituir requisitos de aprovação.

2. Em Substituir motivo, forneça detalhes do motivo pelo qual você está mesclando essa pull request sem que ela atenda às regras de aprovação e aos requisitos obrigatórios do revisor. Embora isso seja opcional, isso é altamente recomendado.

3. Opcionalmente, escolha uma estratégia de mesclagem ou aceite o padrão. Você também pode optar por atualizar a mensagem de confirmação gerada automaticamente com mais detalhes.

4. Selecione ou desmarque a opção para excluir a ramificação de origem na mesclagem. Recomendamos que você mantenha a ramificação de origem ao ignorar os requisitos para mesclar uma pull request até ter a chance de revisar a decisão com outros membros da equipe.

5. Escolha Merge (Mesclar).

Mesclando uma pull request (Git)

O Git suporta muitas opções para mesclar e gerenciar ramificações. Os comandos a seguir são algumas das opções que você pode usar. Para obter mais informações, consulte a documentação disponível no site do Git. Depois de mesclar e enviar suas alterações, feche manualmente a pull request. Para ter mais informações, consulte Fechando uma pull request.

Mescla as alterações da ramificação de origem no repositório local com a ramificação de destino no repositório local.	git checkout destination-branch-name git merge source-branch-name
Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem rápida. Isso mescla as ramificações e move o ponteiro da ramificação de destino até a ponta da ramificação de origem.	git checkout destination-branch-name git merge --ff-only source-branch-name
Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem de squash. Isso combina todas as confirmações da ramificação de origem em uma única confirmação de mesclagem na ramificação de destino.	git checkout destination-branch-name git merge --squash source-branch-name
Mescla a ramificação de origem com a ramificação de destino, especificando uma mesclagem de três vias. Isso cria uma confirmação de mesclagem e adiciona as confirmações individuais da ramificação de origem à ramificação de destino.	git checkout destination-branch-name git merge --no-ff source-branch-name
Exclui a ramificação de origem no repositório local. Isso é útil para limpar seu repositório local depois de mesclar com a ramificação de destino e enviar as alterações para o repositório de origem.	git branch -d source-branch-name
Exclui a ramificação de origem no repositório remoto (o repositório de origem em CodeCatalyst) usando o apelido especificado do repositório local para o repositório remoto. (Observe o uso de dois pontos (:).) Como alternativa, especifique --delete como parte do comando.	git push remote-name :source-branch-name git push remote-name --delete source-branch-name