Skip to main content

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

Você pode editar, monitorar e excluir conjuntos de regras existentes para alterar o modo como as pessoas podem interagir com repositórios em sua organização.

Quem pode usar esse recurso?

Organization owners and users with the "Manage organization ref update rules and rulesets" permission can manage rulesets at the organization level.

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 os branches ou tags nesses repositórios.

Para obter informações sobre como os conjuntos de regras organizacionais afetam a renomeação de branch, consulte Permitindo que administradores de repositório renomeiem branches com conjuntos de regras da organização.

Você pode usar 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.

Observação

Qualquer pessoa com acesso de leitura em um repositório pode ver os conjuntos de regras ativos que operam nesse repositório.

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. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

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

    Captura de tela da página de configurações de uma organização. Na barra lateral, um link rotulado "Conjuntos de regras" está realçado em laranja.

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

  6. 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.

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

Como excluir um conjunto de regras

Dica

Caso deseje desabilitar um conjunto de regras temporariamente, mas não excluí-lo, defina o status do conjunto de regras como "Disabled". Para obter mais informações, confira Como editar um conjunto de regras.

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

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

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

    Captura de tela da página de configurações de uma organização. Na barra lateral, um link rotulado "Conjuntos de regras" está realçado em laranja.

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

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

    Captura de tela da página usada para editar um conjunto de regras. Abaixo de um botão rotulado com três pontos, uma opção rotulada "Excluir conjunto de regras" está realçada em laranja.

Importar um conjunto de regras

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. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

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

    Captura de tela da página de configurações de uma organização. Na barra lateral, um link rotulado "Conjuntos de regras" está realçado em laranja.

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

    Captura de tela da página de conjuntos de regras do repositório. O menu suspenso "New ruleset" está expandido e a opção "Import a ruleset" está contornada em laranja.

  6. Abra o arquivo JSON exportado.

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