Sobre a conversão de proteções de ramificação em conjuntos de regras
Os conjuntos de regras oferecem visibilidade e controle mais claros sobre como as proteções se aplicam a um repositório. Ao contrário das regras de proteção de branch, vários conjuntos de regras podem ser aplicados ao mesmo branch ao mesmo tempo e pessoas com acesso de leitura podem exibir os conjuntos de regras ativos. Isso ajuda os desenvolvedores a entender as regras que os afetam e permite que os auditores examinem as proteções do repositório sem acesso de administrador.
Você pode importar regras de proteção de branch qualificadas de acordo com as configurações do conjunto de regras do repositório ou converter uma regra de cada vez.
GitHub propõe um ou mais conjuntos de regras para cada regra de proteção de branch. Antes de criar os conjuntos de regras, você pode examinar seus nomes e quaisquer avisos sobre alterações no comportamento. Uma regra de proteção de branch pode produzir vários conjuntos de regras quando suas proteções não podem ser representadas em um único conjunto de regras.
Para obter mais informações sobre os conjuntos de regras, confira Sobre os conjuntos de regras.
Convertendo regras de proteção de ramificação de um repositório
Você pode converter várias regras de proteção de branch elegíveis. Antes de criar os conjuntos de regras, você pode examinar e configurar quais proteções serão importadas e como os novos conjuntos de regras serão aplicados.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na barra lateral esquerda, em "Código, planejamento e automação""Código e automação", clique em Conjuntos de Regras, depois clique em Conjuntos de Regras.
-
Na parte superior da página "Conjuntos de regras", clique em Importar regras de proteção de ramificação.
-
Na caixa de diálogo "Revisar importação", examine os conjuntos de regras propostos:
- Se uma proteção for rotulada já coberta por um conjunto de regras existente, a importação não criará outro conjunto de regras para ele.
- Examine os avisos sobre o novo comportamento. Uma regra de proteção de branch pode resultar em vários conjuntos de regras propostos.
-
Na lista suspensa de status de aplicação, escolha um status para os novos conjuntos de regras.
- Ativo: impõe os conjuntos de regras assim que eles são criados.
- Avaliar: registra como os conjuntos de regras se comportariam sem impô-los.
- Desabilitado: cria os conjuntos de regras sem avaliá-los ou aplicá-los.
-
Marque a caixa de seleção de cada conjunto de regras proposto que você deseja criar.
-
Clique em Criar conjuntos de regras.
-
Na caixa de diálogo "Criar conjunto de regras" a seguir, escolha o que fazer com as regras de proteção de branch originais.
- Para manter as proteções originais, clique em Manter regra. As regras originais continuam a proteger ramificações correspondentes. Um conjunto de regras ativo é aplicado junto com eles, portanto, as alterações devem atender a ambos.
- Para remover as proteções originais, clique em Excluir regra de proteção de branch. Exclua apenas as regras originais se os novos conjuntos de regras estiverem ativos e você tiver confirmado que eles abrangem os branches pretendidos e se comportem conforme o esperado. Evaluate e conjuntos de regras Desabilitados não fornecem proteção ativa.
Convertendo uma única regra de proteção de branch em um conjunto de regras
Use o fluxo de regra única quando quiser examinar e configurar a conversão para uma regra de proteção de branch por vez.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na seção "Código, planejamento e automação" da barra lateral, clique em Branches.
-
Em "Regras de proteção de ramificação", localize a regra que você deseja converter e clique em Converter para conjunto de regras.
-
Defina o nome do conjunto de regras para cada conjunto de regras que será criado nesta conversão.
-
Examine a seção "Novo comportamento" para entender o que mudará quando você criar o conjunto de regras ou conjuntos de regras.
-
Em "Status de aplicação", escolha como o novo conjunto de regras é aplicado. Para obter mais informações, consulte Escolhendo um status de aplicação.
-
Se você escolher Ativo, opcionalmente poderá remover a regra de proteção de branch original como parte da conversão selecionando Excluir regra de proteção de branch depois que a migração for feita.
-
Clique em Criar conjunto de regras. Se a conversão produzir mais de um conjunto de regras, o botão incluirá o número de conjuntos de regras, por exemplo, Criar dois conjuntos de regras.
Se você mantiver a regra de proteção de branch original, ela continuará a proteger branches correspondentes. Um conjunto de regras ativo é imposto junto com ele, portanto, as alterações devem atender a ambos. Um conjunto de regras Evaluate registra como ele se comportaria sem impor suas regras.
Escolhendo um status de aplicação
Ao converter uma regra de proteção de branch, você escolhe um status de imposição para o novo conjunto de regras.
- Ativo: o conjunto de regras é aplicado assim que é criado.
- Avalie: o conjunto de regras é executado sem aplicar suas regras, para que você possa examinar como ele se comportaria antes que ele entre em vigor.
Embora Active esteja selecionado por padrão, considere qual status se ajusta à sua situação:
- Se você já criou ou migrou regras semelhantes antes e está confiante no resultado, pode usar o Active.
- Se essa for sua primeira migração, considere começar no modo Avaliar . Você pode confirmar se o novo conjunto de regras se comporta conforme o esperado e, em seguida, excluir a regra de proteção de branch original depois de concluir o teste.
Excluindo a regra original de proteção de ramificação
Depois de converter uma regra, retorne à página de configurações de Branches. Se você não optou por excluir a regra de proteção de branch durante o processo de conversão e o novo conjunto de regras a abrange totalmente, a regra listada exibirá a mensagem "Essa regra é totalmente coberta por conjuntos de regras e pode ser excluída com segurança", e um botão Excluir aparece no lugar do botão Converter em conjunto de regras .
Antes de excluir a regra original, recomendamos confirmar se o novo conjunto de regras se comporta conforme o esperado, especialmente se você a criou no modo Evaluate. Quando estiver pronto, clique em Excluir para remover a regra de proteção de branch.