Skip to main content

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.

Quem pode usar esse recurso?

Regras de proteção de tag estão disponíveis em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para mais informações, confira "Planos do GitHub".

Observação: no momento, as regras de proteção de tag estão em versão beta e sujeitas a alterações.

Sobre regras de proteção para tags

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 marcas protegidas, e somente usuários com permissões de administrador ou funções personalizadas com a permissão "editar regras de repositório" no repositório poderão excluir marcas 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. No GitHub.com, navegue até 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 "Código e automação" da barra lateral, clique em Marcas.

  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. No GitHub.com, navegue até 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 "Código e automação" da barra lateral, clique em Marcas.

  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.