Configure a proteção de ramificações

Esta página explica como configurar a proteção de ramificações para repositórios do Secure Source Manager.

A proteção de ramos permite que os administradores do repositório definam regras para controlar quem pode fazer alterações aos ramos, quem tem de aprovar ou rever as alterações e que condições têm de ser cumpridas antes de uma alteração aprovada poder ser unida num ramo.

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

Antes de começar

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

Funções necessárias

Para receber as autorizações de que precisa para configurar regras de proteção de ramificações para um repositório do Secure Source Manager, peça ao seu administrador que lhe conceda as seguintes funções de IAM:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para obter informações sobre a concessão de funções do Secure Source Manager, consulte os artigos Controlo de acesso com o IAM e Conceda aos utilizadores acesso à instância.

Crie uma regra de proteção de ramificações

Para criar uma nova regra de proteção de ramificações, faça o seguinte:

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

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

    Os IDs das regras de ramificação estão restritos a letras minúsculas, números e hífens. O primeiro caráter tem de ser uma letra e o último caráter tem de ser uma letra ou um número. Os IDs de regras de ramificação têm um máximo de 63 carateres.

  6. No campo Filtro de ramificações, introduza o nome da ramificação à qual quer que a regra se aplique ou, se quiser que a regra se aplique a todas as ramificações, introduza .*. A correspondência de expressões regulares completa não é suportada.

    Os filtros de regras de ramificação ativados têm de ser exclusivos do respetivo repositório. Os utilizadores podem ter vários filtros de regras de ramificação desativados. Por exemplo, não pode ter duas regras de ramificação ativadas num único repositório com o filtro de ramificação main.

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

  7. Na secção Detalhes da regra de proteção de ramificações, especifique os requisitos para a regra de ramificação a partir das seguintes opções:

    • Exigir um pedido de envio antes da união: se esta opção estiver ativada, os commits diretos para o ramo são bloqueados. Tem de abrir um pedido de envio antes de fazer a união no ramo protegido.

    • Número necessário de revisores: especifique o número de revisores necessários para aprovar o pedido de envio para união.

    • Número necessário de aprovadores: especifique o número de aprovadores necessários para aprovar a fim de unir o pedido de envio.

      Os revisores e os aprovadores são utilizadores com funções específicas do IAM. Para saber que funções são necessárias para os revisores e os aprovadores, consulte a Vista geral da proteção de ramificações.

    • Bloquear a união em revisões e aprovações desatualizadas: se esta opção estiver ativada, uma revisão ou uma aprovação é removida se forem enviados novos commits para o pedido de envio após a concessão da revisão ou da aprovação.

    • Exigir a resolução da conversa antes da união: se estiver ativada, todos os comentários de código e revisões de pedidos de alteração têm de ser resolvidos antes da união.

    • Exigir histórico linear: se estiver ativado, não é possível unir pedidos de obtenção que criariam um histórico do Git não linear.

    • Exigir verificações de estado: se estiver ativada, as verificações de estado de compilação selecionadas têm de ser bem-sucedidas antes de um pedido de obtenção poder ser unido. Tem de configurar acionadores no ficheiro de acionadores antes de os poder selecionar como verificações de estado para a proteção de ramificações.

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

É apresentado o separador Regras de ramificação com a nova regra de ramificação.

Modifique uma regra de proteção de ramificações

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

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

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

Elimine uma regra de proteção de ramificações

Para eliminar uma regra de proteção de ramificações, faça o seguinte:

  1. Na interface Web do Gestor de origens seguras, selecione o repositório do qual quer remover a regra de ramificação.
  2. Na página do repositório, clique em Definições.
  3. Clique no separador Regra de ramificação.
  4. Na linha da regra que quer eliminar, clique no ícone Eliminar eliminar.
  5. No ecrã de confirmação Remover regra de ramificação, clique em Sim.

A regra de proteção de ramificações é eliminada.

O que se segue?