Configurar a proteção de ramificação

Nesta página, explicamos como configurar a proteção de ramificação para repositórios do Secure Source Manager.

Com a proteção de ramificação, os administradores de repositório podem definir regras para controlar quem pode fazer mudanças nas ramificações, quem precisa aprovar ou revisar as mudanças e quais condições precisam ser atendidas antes que uma mudança aprovada possa ser mesclada em uma ramificação.

Para mais informações sobre regras de proteção de ramificação, consulte a Visão geral da proteção de ramificação.

Antes de começar

  1. Crie uma instância do Secure Source Manager.
  2. Crie um repositório do Secure Source Manager.

Funções exigidas

Para receber as permissões necessárias para configurar regras de proteção de ramificação em um repositório do Secure Source Manager, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para informações sobre como conceder papéis do Secure Source Manager, consulte Controle de acesso com o IAM e Conceder acesso à instância aos usuários.

Criar uma regra de proteção de ramificação

Para criar uma regra de proteção de branch, faça o seguinte:

  1. Na interface da Web do Secure Source Manager, selecione o repositório que você quer proteger com uma regra de proteção de ramificação.
  2. Na página do repositório, clique em Configurações.
  3. Clique na guia Regra de ramificação.
  4. Clique em Adicionar regra de ramificação.

  5. No campo ID da regra de ramificação, insira um nome para a regra.

    Os IDs das regras de ramificação são restritos a letras minúsculas, números e hífens. O primeiro caractere precisa ser uma letra, e o último precisa ser uma letra ou um número. Os IDs de regra de ramificação têm um limite de 63 caracteres.

  6. No campo Filtro de ramificação, insira o nome da ramificação a que você quer aplicar a regra. Se quiser que ela seja aplicada a todas as ramificações, insira .*. Não há suporte para correspondência completa de expressões regulares.

    Os filtros de regra de ramificação ativados precisam ser exclusivos do repositório. Os usuários podem ter vários filtros de regra de ramificação desativados. Por exemplo, não é possível ter duas regras de ramificação ativadas em um único repositório com o filtro de ramificação main.

    Quando várias regras são aplicáveis a uma ramificação, a regra com um nome específico como filtro substitui a regra de caractere curinga. Por exemplo, uma regra de ramificação com o filtro main vai substituir uma regra com o filtro .*. As regras não são combinadas.

  7. Na seção Detalhes da regra de proteção de ramificação, especifique os requisitos da regra de ramificação nas seguintes opções:

    • Exigir uma solicitação de envio antes de mesclar: se ativada, os commits diretos para a ramificação serão bloqueados. Uma solicitação de envio precisa ser aberta antes da mesclagem na ramificação protegida.

    • Número obrigatório de revisores: especifique o número de revisores necessários para aprovar e mesclar a solicitação de envio.

    • Número necessário de aprovadores: especifique o número de aprovadores necessários para aprovar e mesclar a solicitação de envio.

      Os revisores e aprovadores são usuários com papéis específicos do IAM. Para saber quais papéis são necessários para revisores e aprovadores, consulte Visão geral da proteção de ramificações.

    • Bloquear a fusão em revisões e aprovações desatualizadas: se ativada, uma revisão ou aprovação será removida se novos commits forem enviados para a solicitação de envio após a concessão da revisão ou aprovação.

    • Exigir resolução da conversa antes de mesclar: se ativada, todos os comentários de código e as revisões de solicitação de mudança precisam ser resolvidos antes da mesclagem.

    • Exigir histórico linear: se ativada, as solicitações de pull que criariam um histórico do Git não linear não poderão ser mescladas.

    • Exigir verificações de status: se ativada, as verificações de status de build selecionadas precisam ser bem-sucedidas antes que uma solicitação de envio possa ser mesclada. Você precisa configurar acionadores no arquivo de acionadores antes de selecioná-los como verificações de status para proteção de ramificação.

  8. Para salvar a regra de ramificação, clique em Enviar.

A guia "Regras de ramificação" é exibida com a nova regra de ramificação listada.

Modificar uma regra de proteção de ramificação

Para modificar uma regra de proteção de ramificação, faça o seguinte:

  1. Na interface da Web do Secure Source Manager, selecione o repositório com a regra de proteção de ramificação que você quer modificar.
  2. Na página do repositório, clique em Configurações.
  3. Clique na guia Regras de ramificação.
  4. Clique no nome da regra de ramificação que você quer modificar.
  5. Edite a regra de proteção de ramificação.
  6. Clique em Atualizar.

A regra de proteção de ramificação é atualizada.

Excluir uma regra de proteção de ramificação

Para excluir uma regra de proteção de ramificação, faça o seguinte:

  1. Na interface da Web do Secure Source Manager, selecione o repositório de que você quer remover a regra de ramificação.
  2. Na página do repositório, clique em Configurações.
  3. Clique na guia Regra de ramificação.
  4. Na linha da regra que você quer excluir, clique no ícone Excluir excluir.
  5. Na tela de confirmação Remover regra de ramificação, clique em Sim.

A regra de proteção de ramificação é excluída.

A seguir