Como gerenciar conjuntos de regras para repositórios na sua organização

Sobre o gerenciamento de conjuntos de regras para uma organização

Depois de criar um conjunto de regras no nível da organização, você pode fazer alterações nesse conjunto de regras para alterar o modo como as pessoas podem interagir com os repositórios direcionados. Por exemplo, você pode adicionar regras para proteger melhor as ramificações ou os rótulos nesses repositórios. Os conjuntos de regras organizacionais que se aplicam a ramificações de um repositório não permitirão mais que o administrador do repositório renomeie as ramificações do repositório de destino ou altere o branch padrão para outra ramificação. Os administradores de repositório podem criar e excluir ramificações, desde que tenham as permissões apropriadas.

Use as APIs REST e GraphQL para gerenciar conjuntos de regras. Para saber mais, confira Pontos de extremidade da API REST para regras e Mutações.

Como editar um conjunto de regras

Você pode editar um conjunto de regras para alterar partes do conjunto de regras, como o nome, ignorar permissões ou regras. Você também pode editar um conjunto de regras para alterar o status dele, por exemplo, se desejar habilitar ou desabilitar temporariamente um conjunto de regras.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Ao lado da organização, clique em Configurações.

3. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Rulesets.

   

4. Na página "Conjuntos de regras", clique no nome do conjunto de regras que deseja editar.

5. Altere o conjunto de regras conforme necessário. Para obter informações sobre as regras disponíveis, confira Regras disponíveis para conjuntos de regras.

6. Na parte inferior da página, clique em Salvar alterações.

Como excluir um conjunto de regras

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Ao lado da organização, clique em Configurações.

3. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Rulesets.

   

4. Clique no nome do conjunto de regras que deseja excluir.

5. À direita do nome do conjunto de regras, selecione e clique em Delete ruleset.

   

Como usar o histórico de conjuntos de regras

O histórico do conjunto de regras lista eventos disparados por alterações que afetam seus conjuntos de regras nos últimos 180 dias.

Você pode visualizar todas as alterações a um conjunto de regras e reverter para uma iteração específica. Você também pode baixar um arquivo JSON contendo a configuração do conjunto de regras em uma iteração específica. A lista de bypass de um conjunto de regras é excluída do arquivo JSON exportado.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Ao lado da organização, clique em Configurações.

3. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Rulesets.

   

4. Para exibir o histórico de alterações ao conjunto de regras, selecione à direita do nome do conjunto de regras e clique em History.

   

5. À direita da iteração específica, selecione e clique em Comparar alterações, Restaurar ou Baixar.

   

Como importar um conjunto de dados

Você pode importar um conjunto de regras de outro repositório ou organização usando o arquivo JSON exportado da seção anterior. Isso pode ser útil se você quiser aplicar o mesmo conjunto de regras a vários repositórios ou organizações.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Ao lado da organização, clique em Configurações.

3. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Rulesets.

   

4. Selecione a lista suspensa Novo conjunto de regras e clique em Importar um conjunto de regras.

   

5. Abra o arquivo JSON exportado.

6. Revise o conjunto de regras importado e clique em Criar.