Gerencie as ações permitidas para uma ramificação com regras de ramificação - Amazon CodeCatalyst

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerencie as ações permitidas para uma ramificação com regras de ramificação

Quando você cria uma ramificação, determinadas ações são permitidas para essa ramificação com base nas permissões dessa função. Você pode alterar quais ações são permitidas para uma ramificação específica configurando regras de ramificação. As regras de ramificação são baseadas na função que um usuário tem em seu projeto. Você pode optar por limitar algumas ações predefinidas, como enviar confirmações para uma ramificação, para usuários com uma função específica em um projeto. Isso pode ajudá-lo a proteger ramificações específicas em um projeto, limitando quais funções podem realizar determinadas ações. Por exemplo, se você configurar uma regra de ramificação para permitir que somente usuários com a função de administrador do projeto se mesclem ou enviem para essa ramificação, os usuários com outras funções no projeto não poderão fazer alterações no código dessa ramificação.

Você deve considerar cuidadosamente todas as implicações da criação de uma regra para uma ramificação. Por exemplo, se você optar por limitar os envios para uma ramificação aos usuários com a função de administrador do projeto, os usuários com a função de Colaborador não poderão criar ou editar fluxos de trabalho nessa ramificação, porque o fluxo de trabalho YAML está armazenado nessa ramificação e esses usuários não podem confirmar e enviar alterações para o. YAML Como prática recomendada, teste todas as regras de ramificação depois de criá-las para garantir que elas não tenham nenhum impacto que você não pretendia. Você também pode usar regras de ramificação em conjunto com regras de aprovação para pull requests. Para ter mais informações, consulte Gerenciando requisitos para mesclar uma pull request com regras de aprovação.

nota

Você deve ter a função de administrador do projeto para gerenciar regras de ramificação para repositórios de origem em CodeCatalyst projetos. Você não pode criar regras de ramificação para repositórios vinculados.

Você só pode criar regras de ramificação que sejam mais restritivas do que as permissões padrão para a função. Você não pode criar regras de ramificação que sejam mais permissivas do que o permitido pela função de um usuário no projeto. Por exemplo, você não pode criar uma regra de ramificação que permita que usuários com a função de revisor acessem a ramificação.

As regras de ramificação aplicadas à ramificação padrão do seu repositório de origem se comportarão de maneira um pouco diferente das regras de ramificação aplicadas a outras ramificações. Qualquer regra aplicada à ramificação padrão será aplicada automaticamente a qualquer ramificação que você especificar como ramificação padrão. A ramificação anteriormente definida como a ramificação padrão ainda manterá as regras aplicadas a ela, exceto que ela não terá mais proteção contra exclusão. Essa proteção é aplicada somente à ramificação padrão atual.

As regras de ramificação têm dois estados, Padrão e Personalizado. O padrão indica que as ações permitidas em uma ramificação são aquelas que correspondem às permissões da função que o usuário tem CodeCatalyst para as ações da ramificação. Para saber mais sobre quais funções têm quais permissões, consulteConcedendo acesso com funções de usuário. Personalizado indica que uma ou mais ações de ramificação têm ações que têm uma lista específica de funções permitidas para realizar essa ação, diferente das permissões padrão concedidas pela função de um usuário no projeto.

nota

Se você criar uma regra de ramificação para restringir uma ou mais ações para uma ramificação, a ação Excluir a ramificação será automaticamente definida para permitir que somente usuários com a função de administrador do projeto excluam essa ramificação.

A tabela a seguir lista as ações e as configurações padrão das funções autorizadas a realizar essas ações em uma ramificação.

Ações e funções da ramificação
Ação da filial

Funções autorizadas a realizar essa ação quando nenhuma regra de ramificação é aplicada

Mesclar com a ramificação (isso inclui mesclar uma pull request com a ramificação)

Administrador do projeto, Colaborador

Empurre até o galho

Administrador do projeto, Colaborador

Excluir a ramificação

Administrador do projeto, Colaborador

Excluir a ramificação (ramificação padrão)

Não permitido

Você não pode excluir regras de ramificação, mas pode atualizá-las para permitir ações de todas as funções que teriam permissão para realizar essa ação em uma ramificação, o que efetivamente remove a regra.

nota

Você deve ter a função de administrador do projeto para configurar regras de ramificação para repositórios de origem em CodeCatalyst projetos. Isso não se aplica aos repositórios vinculados. Os repositórios vinculados não oferecem suporte às regras de ramificação em CodeCatalyst.

Para visualizar e editar regras de ramificação para um repositório
  1. Navegue até o projeto em que seu repositório reside.

  2. Escolha o nome do repositório na lista de repositórios de origem do projeto. Como alternativa, no painel de navegação, escolha Código e, em seguida, escolha Repositórios de origem.

    Escolha o repositório em que você deseja visualizar as regras de ramificação.

  3. Na página de visão geral do repositório, escolha Branches.

  4. Na coluna Regras de ramificação, visualize o status das regras para cada ramificação do repositório. O padrão indica que as regras para a ação da ramificação são as padrão para qualquer ramificação criada em um repositório de origem e correspondem às permissões concedidas a essas funções em um projeto. Personalizado indica que uma ou mais ações de ramificação têm regras que restringem uma ou mais ações permitidas para essa ramificação a um conjunto diferente de funções.

    Para ver as especificações das regras de ramificação de uma ramificação, escolha a palavra Padrão ou Personalizada ao lado da ramificação que você deseja revisar.

  5. Para criar ou alterar uma regra de ramificação, escolha Gerenciar configurações. Na página de configurações do repositório de origem, em Regras de ramificação, escolha Editar.

  6. Em Ramificação, escolha o nome da ramificação para a qual você deseja configurar uma regra na lista suspensa. Para cada um dos tipos de ação permitidos, escolha as funções que você deseja permitir que executem essa ação na lista suspensa e escolha Salvar.