Skip to main content

Administración de conjuntos de reglas de un repositorio

Puedes editar, supervisar y eliminar conjuntos de reglas existentes en un repositorio para modificar cómo las personas pueden interactuar con ramas y etiquetas específicas.

Quién puede usar esta característica

Cualquier persona con acceso de lectura a un repositorio puede ver los conjuntos de reglas del repositorio. Las personas con acceso de administrador a un repositorio o un rol personalizado con el permiso "editar reglas de repositorio", pueden crear, editar y eliminar conjuntos de reglas para un repositorio.

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

Después de crear un conjunto de reglas, puedes realizar cambios en el conjunto de reglas para modificar la manera en que las personas pueden interactuar con las ramas o etiquetas de destino. Por ejemplo, puedes agregar reglas para proteger mejor las ramas o etiquetas, o bien puedes deshabilitar temporalmente un conjunto de reglas para solucionar los efectos no deseados en la experiencia de colaborador del repositorio.

Puedes usar la API REST y Graph API para administrar conjuntos de reglas. Para obtener más información, vea «Reglas» y «Mutaciones».

Visualización de conjuntos de reglas de un repositorio

Cualquier persona con acceso de lectura a un repositorio puede ver los conjuntos de reglas destinados al repositorio. Esto puede ser útil si deseas saber por qué no puedes confirmar en una rama. En la página "Conjuntos de reglas", puedes ver los conjuntos de reglas activos destinados a una determinada rama o etiqueta.

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

  2. En la vista de árbol de archivos de la izquierda, selecciona el menú desplegable de ramas de y, a continuación, haz clic en Ver todas las ramas. También puedes encontrar el menú desplegable de ramas en la parte superior del editor de archivos integrado.

    Captura de pantalla de la vista de árbol de archivos de un repositorio. Un menú desplegable para cambiar de rama se expande y se destaca en naranja oscuro.

  3. A la izquierda de la rama, haz clic en .

    Captura de pantalla de una lista de ramas de un repositorio. Junto a la rama "principal", se resalta un icono de un escudo con una cerradura con un contorno naranja.

  4. Opcionalmente, para ver los conjuntos de reglas de otra rama o etiqueta, usa el menú desplegable del selector de ramas.

    Captura de pantalla de la página "Conjuntos de reglas". Encima de un conjunto de reglas, hay un menú desplegable, etiquetado con un icono de rama y "team-test", que está resaltado con un contorno naranja.

  5. Haz clic en el nombre del conjunto de reglas que quieres ver.

Edición de un conjunto de reglas

Puedes editar un conjunto de reglas para cambiar partes del conjunto de reglas, como el nombre, permisos de omisión o reglas. También puedes editar un conjunto de reglas para cambiar su estado; por ejemplo, si deseas habilitar o deshabilitar temporalmente un conjunto de reglas.

  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 barra lateral izquierda, en "Código y automatización", haz clic en Reglas y, a continuación, haz clic en Conjuntos de reglas.

    Captura de pantalla de la barra lateral de la página "Configuración" de un repositorio. El submenú "Reglas" se expande y la opción "Conjuntos de reglas" tiene un contorno naranja.

  4. En la página "Conjuntos de reglas", haz clic en el nombre del conjunto de reglas que deseas editar.

  5. Cambie el conjunto de reglas según sea necesario. Para obtener información sobre las reglas disponibles, consulta "Reglas disponibles para conjuntos de reglas".

  6. En la parte inferior de la página, haga clic en Save changes.

Eliminación de un conjunto de reglas

Consejo: Si deseas deshabilitar temporalmente un conjunto de reglas, pero no deseas eliminarlo, puedes establecer el estado del conjunto de reglas en "Deshabilitado". Para obtener más información, consulta "Edición de un conjunto de reglas".

  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 barra lateral izquierda, en "Código y automatización", haz clic en Reglas y, a continuación, haz clic en Conjuntos de reglas.

    Captura de pantalla de la barra lateral de la página "Configuración" de un repositorio. El submenú "Reglas" se expande y la opción "Conjuntos de reglas" tiene un contorno naranja.

  4. Haz clic en el nombre del conjunto de reglas que quieres eliminar.

  5. A la derecha del nombre del conjunto de reglas, selecciona y, a continuación, haz clic en Eliminar conjunto de reglas.

    Captura de pantalla de la página para editar un conjunto de reglas. Debajo de un botón etiquetado con tres puntos, una opción con la etiqueta "Eliminar conjunto de reglas" se resalta en naranja.