Visão geral das solicitações de pull
Escrito para a interface antiga
Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o Para onde foi artigo.
Visão geral
Pull Requests são uma parte fundamental do fluxo de trabalho de DevOps na nuvem, permitindo atualizações de uma branch de origem para uma branch de destino. Eles foram projetados para oferecer suporte à colaboração por meio de revisões de código que devem ser aprovadas antes da mesclagem.
Benefícios dos Pull Requests:
Revisão de código: Permite uma análise minuciosa das alterações antes da mesclagem.
Detecção de conflitos: Identifica e trata conflitos logo no início do processo.
Histórico de release limpo: Mantém um histórico do projeto organizado e claro.
Smart Merge vs Pull Request
Smart Merge e Pull Request mesclam alterações de um branch de origem para um branch de destino, mas cada um é mais adequado a um fluxo de trabalho diferente.
Smart Merge é um processo simplificado, em uma única etapa, que mescla alterações diretamente entre branches sem exigir uma Pull Request ou aprovação da equipe. Ele funciona bem em situações sensíveis ao tempo, como correções urgentes ou mudanças críticas que precisam ser lançadas rapidamente.
Uma Pull Request, por outro lado, é um processo estruturado, em várias etapas, criado para a colaboração da equipe. Ele permite que vários revisores inspecionem as alterações, solicitem revisões e as aprovem formalmente antes da mesclagem.
Como regra geral, use uma Pull Request quando as alterações precisarem de supervisão ou aprovação de outros membros da equipe, e escolha o Smart Merge quando precisar integrar mudanças rapidamente.
Para saber mais sobre Smart Merge, veja o artigo a seguir.
Página de visão geral do Pull Request
A página de visão geral do Pull Request fornece um panorama abrangente de todas as solicitações ativas. Servindo como hub central, ela facilita o acompanhamento do progresso e a prontidão para a mesclagem. Cada Pull Request exibe os seguintes detalhes.
Pull Requests ativos
A página de visão geral do Pull Request lista apenas Pull Requests ativos. Assim que um Pull Request for Mesclado ou Fechado, ele é removido da lista de Pull Requests ativos.
Título e ID
O título e o número de ID do Pull Request. Cada Pull Request recebe um número de ID sequencial exclusivo.
Status
O status do Pull Request pode ser um dos seguintes: Criado, Revisão solicitada, Alterações solicitadas e Aprovado.
Autor
O usuário Flosum que criou o Pull Request.
Atividade mais recente
O tempo decorrido desde a atividade mais recente do Pull Request.
Destino e origem
As branches de destino e de origem são listadas com uma seta apontando da origem para o destino. Clicar em uma branch leva você à página principal da branch.
Revisores
Os usuários Flosum que estão atribuídos como revisores do Pull Request.
Clicar em um Pull Request leva você à página de visão geral da solicitação, onde você pode executar ações sobre ela.
O Três pontos verticais menu no final de um Pull Request oferece as seguintes opções:
Editar: Leva você à página de edição do Pull Request para alterar: branch de destino, branch de origem, Nome, e Descrição.
Fechar: Encerra o Pull Request sem mesclá-lo. Depois de fechado, o Pull Request não é mais exibido na lista de Pull Requests e nenhuma outra ação pode ser executada.
Pesquisa, ordenação e filtragem
A página de Pull Requests pode ser pesquisada, filtrada e ordenada usando as seguintes ferramentas.
Pesquisar – pesquise pelo nome ou ID do Pull Request.
Autores – filtrar pelo criador do PR.
Status – filtrar por estado (Criado, Revisão solicitada, Alterações solicitadas, Aprovado).
Revisores – filtrar por revisores atribuídos.
Atividade mais recente – ordenar Pull Requests por:
Ordenar por nome A–Z – ordem alfabética.
Ordenar por nome Z–A – ordem alfabética inversa.
Atividade mais recente – atualizações mais recentes primeiro.
Atividade mais antiga – atualizações mais antigas primeiro.
Intervalo de datas – filtrar por período de criação ou atualização. Use o widget de data para informar um intervalo.
Status do Pull Request
Criado
Pull Request aberto, mas não revisado.
Revisão solicitada
Revisores atribuídos, mas aguardando o feedback deles.
Alterações solicitadas
Os revisores solicitaram revisões antes da aprovação.
Aprovado
O Pull Request foi aprovado pelos revisores e está pronto para ser mesclado.
Processo de Pull Request
Pull Requests envolvem três etapas principais: criação, revisão e mesclagem. Se surgirem conflitos durante a criação, eles devem ser resolvidos antes da mesclagem. Orientações detalhadas para cada etapa são fornecidas nos artigos a seguir.
Melhores práticas
Sempre revise um Pull Request antes de mesclar branches de recurso ou correção de bugs.
Escreva títulos e descrições claros para os revisores.
Atribua pelo menos um revisor para fins de responsabilidade.
Resolva os conflitos do Pull Request antes de mesclar.
Feche Pull Requests obsoletos para manter a lista limpa.
Atualizado
Isto foi útil?