O Que É um Pull Request?
Um pull request é uma proposta de fazer merge de uma branch em outra, empacotada com uma discussão, revisão e checks automatizados.
Um pull request, ou PR, é a unidade de colaboração na maioria das equipes. Ele reúne uma branch de alterações com uma descrição, um diff, uma conversa e os resultados de checks automatizados. Revisores comentam, o CI roda e, uma vez que tudo esteja satisfeito, o PR faz merge. É onde código, revisão e CI/CD se encontram.
O que um pull request contém
Um PR aponta para uma branch de origem e uma branch de destino, mostra o diff entre elas e fornece um lugar para discutir a alteração. Ele acumula revisões, comentários e o status de cada check automatizado, dando uma visão única de se a alteração está pronta.
Abrindo um pull request
Após fazer push de uma branch, você abre um PR pela CLI ou pela interface web para iniciar a revisão e disparar os checks.
git push -u origin feature/search
gh pr create --base main --title "Add search" --body "Adds full-text search"Revisão e checks
Os colegas revisam o diff e solicitam alterações ou aprovam. Em paralelo, o CI executa os workflows de build e teste contra o merge proposto e reporta cada um como um status check no PR. Um PR geralmente só pode fazer merge quando as revisões estão aprovadas e os checks obrigatórios estão verdes.
Pull requests como o portão de CI/CD
O pull request é o gargalo onde a qualidade é imposta antes que o código chegue à main. Regras de branch protection podem exigir checks aprovados, aprovações e uma branch atualizada. Fazer merge do PR é o que dispara os pipelines de deploy downstream, tornando o PR o limite entre proposto e entregue.
Hábitos saudáveis de pull request
- Mantenha PRs pequenos para que a revisão seja rápida e completa.
- Escreva uma descrição clara do que mudou e por quê.
- Exija checks de CI verdes antes de fazer merge.
- Responda ao feedback da revisão prontamente para evitar branches obsoletas.
Principais conclusões
- Um pull request propõe fazer merge de uma branch em outra com revisão e checks.
- O CI reporta status checks no PR que definem se ele pode fazer merge.
- Fazer merge de um PR é o limite que dispara os pipelines de deploy.