Skip to main content

Configuración de reglas de protección de etiquetas

Puedes configurar reglas de protección de etiquetas para el repositorio para evitar que los colaboradores creen o eliminen etiquetas.

¿Quién puede utilizar esta característica?

Las reglas de protección de etiquetas están disponibles en repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server. Para más información, consulta "Planes de GitHub".

Nota: Las reglas de protección de etiquetas se encuentran actualmente en versión beta y están sujetas a cambios.

Acerca de las reglas de protección de etiquetas

Al agregar una regla de protección de etiquetas, se protegerán todas las etiquetas que coincidan con el patrón proporcionado. Solo los usuarios con permisos de administrador o mantenimiento o los roles personalizados con el permiso "Editar reglas de repositorio" en el repositorio podrán crear etiquetas protegidas, y solo los usuarios con permisos de administrador o los roles personalizados con el permiso "Editar reglas de repositorio" en el repositorio podrán eliminar etiquetas protegidas. Para obtener más información, vea «Roles de repositorio para una organización». GitHub Apps necesitan el permiso Repository administration: write para modificar una etiqueta protegida.

Además, puedes crear roles de repositorio personalizados para permitir que otros grupos de usuarios creen o eliminen etiquetas que coincidan con las reglas de protección de etiquetas. Para más información, consulta "Administrar roles de repositorio personalizados en una organización".

Acerca de la importación de reglas de protección de etiquetas en conjuntos de reglas de repositorio

Puedes importar reglas de protección de etiquetas existentes en conjuntos de reglas de repositorio. Esto implementará las mismas protecciones de etiquetas que tienes actualmente para el repositorio. Para obtener más información, consulta «Importación de reglas de protección de etiquetas a conjuntos de reglas de repositorio».

Los conjuntos de reglas tienen las siguientes ventajas sobre las reglas de protección de etiquetas.

  • A diferencia de las reglas de protección, se pueden aplicar varios conjuntos de reglas al mismo tiempo, por lo que puedes estar seguro de que todas las reglas destinadas a una etiqueta del repositorio se evaluarán cuando alguien interactúe con esa etiqueta. Para obtener más información, vea «Acerca de los conjuntos de reglas».
  • Los conjuntos de reglas tienen estados, por lo que puedes administrar fácilmente qué conjuntos de reglas están activos en un repositorio sin necesidad de eliminar conjuntos de reglas.
  • Cualquier persona con acceso de lectura a un repositorio puede ver los conjuntos de reglas activos del repositorio. Esto significa que un desarrollador puede comprender por qué utiliza una regla, o un auditor puede comprobar las restricciones de seguridad del repositorio, sin requerir el acceso del administrador al repositorio.
  • Con los conjuntos de reglas, puede restringir los nombres de etiqueta en toda la organización.

Agregar reglas de protección de etiqueta

  1. En GitHub.com, navega a la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Código y automatización" de la barra lateral, haz clic en Etiquetas.

  4. Haga clic en Nueva regla.

  5. En "Patrón de nombre de etiqueta", escriba el patrón de las etiquetas que quiera proteger. Las reglas de protección de etiquetas usan sintaxis fnmatch. Para obtener información sobre las opciones de sintaxis, consulta la documentación de fnmatch. En este ejemplo, al escribir "*" se protegen todas las etiquetas.

    Captura de pantalla de la página "Etiquetas protegidas/Nueva regla". El patrón de ejemplo '*' se muestra con el botón "Agregar regla".

  6. Haga clic en Agregar regla.

Importación de reglas de protección de etiquetas a conjuntos de reglas de repositorio

  1. En GitHub.com, navega a la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Código y automatización" de la barra lateral, haz clic en Etiquetas.

  4. Haz clic en Importar a conjuntos de reglas en la esquina superior derecha.

  5. Selecciona Crear conjuntos de reglas independientes para crear y eliminar etiquetas protegidas o Crear un conjunto de reglas para todas las operaciones de etiquetas protegidas. Una vez creados, los conjuntos de reglas se pueden editar para ajustar con mayor precisión su comportamiento.

  6. Haga clic en Import.