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á.
Gerenciar 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 desse perfil. É possível 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 no perfil que um usuário tem no projeto. Você pode optar por limitar algumas ações predefinidas, como enviar confirmações para uma ramificação, para usuários com um perfil específico em um projeto. Isso pode ajudar você a proteger ramificações específicas em um projeto, limitando quais perfis podem realizar determinadas ações. Por exemplo, se você configurar uma regra de ramificação para permitir que somente usuários com o perfil Administrador do projeto se mesclem ou façam envios a essa ramificação, os usuários com outros perfis no projeto não poderão fazer alterações no código dessa ramificação.
Você deve pensar cuidadosamente em todas as implicações da criação de uma regra para uma ramificação. Por exemplo, se você optar por limitar os envios a uma ramificação aos usuários com o perfil Administrador do projeto, os usuários com o perfil Colaborador não poderão criar nem editar fluxos de trabalho nessa ramificação porque o YAML do fluxo de trabalho está armazenado nessa ramificação e esses usuários não podem confirmar e enviar alterações ao 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 não pretendido. Você também pode usar regras de ramificação com regras de aprovação para solicitações pull. Para obter mais informações, consulte Gerenciamento de requisitos para mesclar uma solicitação pull 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. Não é possível criar regras de ramificação para repositórios vinculados.
Só é possível criar regras de ramificação mais restritivas do que as permissões padrão para o perfil. Não é possível criar regras de ramificação mais permissivas do que o autorizado pelo perfil de um usuário no projeto. Por exemplo, não é possível criar uma regra de ramificação que permita que usuários com o perfil 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 perfis têm quais permissões, consulte Concessão de acesso com perfis de usuário. Personalizado indica que uma ou mais ações de ramificação têm ações que apresentam uma lista específica de perfis permitidos para realizar essa ação, diferente das permissões padrão concedidas pelo perfil 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 o perfil de administrador do projeto excluam essa ramificação.
A tabela a seguir lista as ações e as configurações padrão dos perfis autorizados a realizar essas ações em uma ramificação.
| Ação da ramificação |
Perfis autorizados a realizar essa ação quando nenhuma regra de ramificação é aplicada |
|---|---|
|
Unificação com a ramificação (isso inclui unificar uma solicitação pull com a ramificação) |
Administrador do projeto, Colaborador |
|
Envio para a ramificação |
Administrador do projeto, Colaborador |
|
Exclusão da ramificação |
Administrador do projeto, Colaborador |
|
Exclusão da 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 todos os perfis que poderiam 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.
Como visualizar e editar regras de ramificação para um repositório
-
Acesse o projeto no qual reside seu repositório.
-
Selecione o nome do repositório na lista de repositórios de origem do projeto. No painel de navegação, também é possível selecionar Código e escolher Repositórios de origem.
Selecione o repositório onde você deseja visualizar regras de ramificação.
-
Na página de visão geral do repositório, selecione Ramificações.
-
Na coluna Regras de ramificação, visualize o status das regras para cada ramificação do repositório. 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 esses perfis 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 perfis.
Para ver as especificações das regras de ramificação de uma ramificação, selecione a palavra Padrão ou Personalizado ao lado da ramificação que você deseja revisar.
-
Para criar ou alterar uma regra de ramificação, selecione Gerenciar configurações. Na página de configurações do repositório de origem, em Regras de ramificação, selecione Editar.
-
Em Ramificação, selecione o nome da ramificação para a qual você deseja configurar um perfil na lista suspensa. Em relação a cada um dos tipos de ação permitidos, selecione os perfis que você deseja permitir que executem essa ação na lista suspensa e escolha Salvar.
