Skip to main content

Enterprise Server 3.15 está disponível no momento como versão release candidate.

Configurar regras de proteção para tags

Você pode configurar regras de proteção de tags para o repositório para impedir que os colaboradores criem ou excluam tags.

Note

As regras de proteção de tag são descontinuado no GitHub Enterprise Server versão 3.16 e posterior. Em vez disso, use conjuntos de regras. Todas as regras de proteção de tags ainda em uso serão migradas automaticamente. Leia mais sobre isso no the GitHub Blog.

Quando você adiciona uma regra de proteção de tags, todas as tags que correspondem ao padrão fornecido serão protegidas. Somente usuários com permissões de administrador ou de manutenção, ou funções personalizadas com a permissão “editar regras do repositório” no repositório poderão criar tags protegidas, e somente usuários com permissões de administrador ou funções personalizadas com a permissão “editar regras do repositório” no repositório poderão excluir tags protegidas. Para obter mais informações, confira "Funções de repositório para uma organização". Os GitHub Apps exigem a permissão Repository administration: write para modificar uma tag protegida.

Adicionalmente, você pode criar funções personalizadas de repositórios para permitir que outros grupos de usuários criem ou excluam marcações que correspondam às regras de proteção de marcas. Para obter mais informações, confira "Gerenciando as funções de repositórios personalizados para uma organização".

Sobre a importação de regras de proteção de tags para conjuntos de regras do repositório

Você pode importar regras de proteção de tags existentes para conjuntos de regras do repositório. Isso implementará as mesmas proteções de tag que você tem atualmente em vigor para seu repositório. Para obter mais informações, consulte "Importar regras de proteção de tags para conjuntos de regras do repositório".

Os conjuntos de regras têm as vantagens a seguir em relação às regras de proteção de tag.

  • Ao contrário das regras de proteção, vários conjuntos de regras podem ser aplicados ao mesmo tempo, para que você tenha certeza de que todas as regras direcionadas a uma tag no repositório sejam avaliadas quando alguém não identificado interagir com essa tag. Para obter mais informações, confira "Sobre os conjuntos de regras".
  • Os conjuntos de regras têm status, ou seja, você pode gerenciar com facilidade os conjuntos de regras que estão ativos em um repositório sem a necessidade de excluir conjuntos de regras.
  • Qualquer pessoa com acesso de leitura em um repositório pode visualizar os conjuntos de regras ativos do repositório. Isso significa que um desenvolvedor pode entender por que atingiu uma regra ou um auditor pode verificar as restrições de segurança do repositório, sem exigir acesso de administrador no repositório.
  • Com os conjuntos de regras, você pode restringir nomes de tags em toda a organização.

Adicionar regras de proteção de tag

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na seção “Code and automation” da barra lateral, selecione Tags.

  4. Clique em Nova regra.

  5. Em "Padrão do nome da tag", digite o padrão das tags que você deseja proteger. As regras de proteção de tags usam a sintaxe fnmatch. Para obter mais informações sobre as opções de sintaxe, veja a documentação de fnmatch. Neste exemplo, se você digitar "*", isso protegerá todas as tags.

    Captura de tela da página "Marcas protegidas/Nova regra". O padrão de exemplo "*" é mostrado com o botão "Adicionar regra".

  6. Clique em Adicionar regra.

Importar regras de proteção de tags para conjuntos de regras do repositório

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na seção “Code and automation” da barra lateral, selecione Tags.

  4. Clique em Importar para conjuntos de regras no canto superior direito.

  5. Selecione Criar conjuntos de regras separados para criar e excluir tags protegidas ou Criar um conjunto de regras para todas as operações de tags protegidas. Uma vez criados, os conjuntos de regras podem ser editados para refinar ainda mais seu comportamento.

  6. Clique em Importar.