Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise foi descontinuada em 2020-11-12. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Sobre revisões obrigatórias para pull requests

As revisões obrigatórias garantem que as pull requests tenham um número específico de revisões de aprovação antes que os colaboradores possam fazer alterações em um branch protegido.

Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

Se você aplicou proteções de branch no repositório, será possível configurar as revisões obrigatórias. Para obter mais informações sobre como aplicar proteções de branch, consulte "Configurar branches protegidos". Para obter mais informações sobre como configurar revisões obrigatórias, consulte "Habilitar revisões obrigatórias para pull requests".

Os administradores do repositório podem exigir que todos os pull requests recebam um número específico de revisões de aprovações de pessoas com permissões de gravação ou administrador no repositório ou de um proprietário do código designado, antes de serem mesclados em um branch protegido. Para obter mais informações, consulte "Sobre branches protegidos".

Quando as revisões necessárias estão ativadas, qualquer pessoa com acesso ao repositório poderá aprovar alterações em um pull request. No entanto você não conseguirá fazer merge do seu pull request até que o número necessário de revisores com permissões de gravação ou admin no repositório aprove as alterações do seu pull request na sua revisão. Para obter mais informações sobre os níveis de permissão do repositório, consulte "Níveis de permissão do repositório para uma organização". Se a revisão for necessária de um proprietário do código designado e o pull request afetar o código que tem um proprietário designado, a aprovação deste proprietário será obrigatória.

Se uma pessoa com permissões de administrador escolher a opção Request changes (Solicitar alterações) em uma revisão, essa pessoa deverá aprovar a pull request antes que ela possa sofrer merge. Se um revisor que solicita alterações em uma pull request não estiver disponível, qualquer pessoa com permissão de administrador ou de gravação para o repositório poderá ignorar a revisão de bloqueio. Para obter mais informações, consulte "Ignorar uma revisão de pull request".

Observação: os administradores de repositório podem restringir a capacidade de ignorar revisões de pull request para pessoas ou equipes específicas. Para obter mais informações, consulte "Habilitar revisões obrigatórias para pull requests".

Se você fizer push de um commit que modifica o código no branch de uma pull request aprovada, a aprovação poderá ser ignorada se os administradores de repositório tiverem configurado dispensas de revisão obsoleta. Para obter mais informações, consulte "Habilitar revisões obrigatórias para pull requests". Isso não se aplica se você fizer push dos commits non-code-modifying, como mesclar o branch base no branch de sua pull request. Para obter mais informações sobre branch base, consulte "Sobre pull requests".

A menos que as revisões obrigatórias tenham sido configuradas para incluir administradores do repositório, as pessoas com permissões de administrador podem fazer merge de uma pull request independentemente das revisões de outros administradores.

Depois que todos os revisores necessários tiverem aprovado um pull request, você não conseguirá fazer o merge se houver outros pull requests abertos com revisões pendentes ou rejeitadas e esses pull requests tiverem um branch principal apontando para o mesmo commit. Alguém com as permissões de gravação ou admin deverá aprovar ou ignorar a revisão de bloqueio nos outros pull requests antes que você possa fazer o merge.

Não é possível fazer merge de uma pull request em um branch protegido até que alguém com permissões de gravação ou administrador a aprove. Se houver revisões pendentes ou rejeitadas, você receberá uma mensagem de erro:

remote: error: GH006: Protected branch update failed for refs/heads/main.
remote: error: Changes have been requested.