Administración de conjuntos de reglas de un repositorio

Después de crear un conjunto de reglas, puedes realizar cambios en él. Por ejemplo, puede agregar reglas para proteger mejor las ramas o etiquetas, o bien deshabilitar temporalmente un conjunto de reglas para solucionar los efectos no deseados en la experiencia de colaborador del repositorio.

Puede usar las API de REST y GraphQL para gestionar rulesets. Para más información, consulta Puntos de conexión de la API de REST para reglas y Mutaciones.

Visualización de conjuntos de reglas de un repositorio

En la página "Conjuntos de reglas", cualquier persona con acceso de lectura al repositorio puede ver los conjuntos de reglas activos destinados a una determinada rama, etiqueta o restricción de inserción de.

En el caso de los conjuntos de reglas de envío para repositorios bifurcados, la página «Conjuntos de reglas» indicará que el conjunto de reglas es gestionado por el repositorio de origen donde se aplican las reglas.

1. En GitHub, navegue hasta 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 View all branches. También puedes encontrar el menú desplegable de ramas en la parte superior del editor de archivos integrado.

   

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

   Sugerencia

   Solo las ramas que tienen un conjunto de reglas tienen un icono adyacente a su nombre.

4. Opcionalmente, para filtrar los resultados, haga clic en las pestañas o use la barra de búsqueda «Buscar sucursales».

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

También puede ver los conjuntos de reglas activos:

• Al agregar el slug /rules a la dirección URL del repositorio. Por ejemplo, para ver las reglas del repositorio de documentación de open source en GitHub, vaya a https://github.com/github/docs/rules.

• En el cuadro de combinación, si existen reglas que bloquean la combinación de una solicitud de incorporación de cambios.

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, navegue hasta la página principal del repositorio.

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

   

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.

   

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

1. En GitHub, navegue hasta la página principal del repositorio.

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

   

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.

   

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 Delete ruleset.

   

Importación de un conjunto de reglas

Puedes importar un conjunto de reglas existente mediante un archivo JSON. Esto puede ser útil si deseas aplicar el mismo conjunto de reglas a varios repositorios u organizaciones.

1. En GitHub, navegue hasta la página principal del repositorio.

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

   

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.

   

4. Selecciona la lista desplegable Nuevo conjunto de reglas y haz clic en Importar un conjunto de reglas.

   

5. Abre el archivo JSON exportado.

6. Revisa el conjunto de reglas importado y haz clic en Crear.

Visualización de información para conjuntos de reglas

Puede ver información sobre los conjuntos de reglas para ver cómo afectan los conjuntos de reglas a un repositorio. En la página "Información sobre la regla", verás una escala de tiempo de las siguientes acciones de usuario. Puedes usar filtros para encontrar lo que buscas.

• Acciones que se han comprobado con uno o varios conjuntos de reglas y que se han aprobado.
• Acciones que se han comprobado con uno o varios conjuntos de reglas y que han generado un error.
• Acciones en las que alguien ha omitido uno o varios conjuntos de reglas.

Si un conjunto de reglas se ejecuta en modo "Evaluar", puedes ver las acciones que se habrían aprobado o generado un error si el conjunto de reglas hubiera estado activo.

Además, estas conclusiones están disponibles a través de la API REST de conjuntos de reglas.

1. En GitHub, navegue hasta la página principal del repositorio.

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

   

3. En la barra lateral izquierda, en "Código y automatización", haga clic en Reglas y, a continuación, en Información.

   

4. En la página "Información sobre la regla", use los menús desplegables de la parte superior de la página para filtrar las acciones por conjunto de reglas, rama, actor y período de tiempo.

5. Para ver qué reglas específicas han producido un error o requieren una omisión, haz clic en y expande el nombre del conjunto de reglas.