Visão geral da proteção de ramificações

Esta página descreve a proteção de ramificação no Secure Source Manager para administradores.

Para saber como configurar a proteção de ramificação, siga as instruções em Configurar a proteção de ramificação.

A proteção de ramificação impede que os usuários enviem código incorreto acidentalmente ou de forma maliciosa para uma ramificação importante. Os administradores do repositório podem configurar a proteção de ramificação para bloquear o envio de código a ramificações específicas com base nos critérios a seguir.

Exigir uma solicitação de envio antes da mesclagem

Quando ativada, uma solicitação de envio precisa ser criada e aprovada por um número configurável de revisores e aprovadores para ser mesclada em ramificações protegidas.

Os revisores e aprovadores são configurados usando papéis do IAM.

Revisores
É necessário ter pelo menos o papel de Gravador do repositório do Secure Source Manager (roles/securesourcemanager.repoWriter) no repositório protegido.
Aprovadores
É necessário ter o papel de Administrador do repositório (roles/securesourcemanager.repoAdmin) ou os papéis de Gravador do repositório (roles/securesourcemanager.repoWriter) e Aprovador de solicitação de envio do repositório (roles/securesourcemanager.repoPullRequestApprover) no repositório protegido.

Os usuários com o papel de Administrador do repositório ou de Gravador do repositório que também têm o papel de Aprovador de solicitação de pull do repositório são considerados aprovadores e revisores quando aprovam uma solicitação de envio.

Exigir revisão do proprietário do código

É possível exigir a aprovação da solicitação de envio de usuários específicos com base nos arquivos alterados em uma solicitação de envio. Para fazer isso, ative a opção Exigir revisão do proprietário do código em solicitações de envio nas regras de proteção de ramificação. Usando um ou mais arquivos CODEOWNERS no repositório, é possível definir proprietários diferentes para arquivos e diretórios diferentes, garantindo que as pessoas mais relevantes revisem as mudanças em partes específicas da base de código. Esse requisito é adicional ao número mínimo de aprovadores exigido por outras configurações de regra de ramificação.

Para mais informações, consulte Gerenciar aprovações de solicitação de envio com CODEOWNERS.

Bloquear a mesclagem em revisões desatualizadas

Quando ativados, os commits adicionados a uma solicitação de envio após a concessão de uma revisão ou aprovação bloqueiam a mesclagem. Novas revisões e aprovações precisam ser concedidas antes que a solicitação de envio possa ser mesclada na ramificação protegida.

Ativado por padrão em todas as regras de proteção de ramificação.

Exigir que os comentários da revisão sejam resolvidos antes da mesclagem

Quando ativados, todos os comentários e solicitações de mudanças na solicitação de envio precisam ser resolvidos antes que ela possa ser mesclada na ramificação protegida.

Exigir histórico linear

Quando ativadas, as solicitações de envio que introduziriam commits de mesclagem são bloqueadas.

Manter um histórico linear do Git tem muitos benefícios, incluindo simplificar a compreensão do que cada commit faz.

Exigir verificações de status

Quando ativada, é possível exigir um status de build bem-sucedido para acionadores definidos no arquivo de acionadores antes que uma solicitação de envio possa ser mesclada em uma ramificação protegida.

A seguir