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 cambiar el conjunto de reglas del modo "Evaluar" a "Activo" después de probar sus efectos 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».
Consejo: Si eres el propietario de una organización, puedes crear conjuntos de reglas en el nivel de organización. Puedes aplicar estos conjuntos de reglas a repositorios específicos de tu organización y a ramas específicas de esos repositorios. Para obtener más información, vea «Creación de conjuntos de reglas para repositorios de la organización».
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. También verás los conjuntos de reglas que se ejecutan en modo "Evaluar", que no se aplican.
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
A la izquierda de la rama, haz clic en .
-
Opcionalmente, para ver los conjuntos de reglas de otra rama o etiqueta, usa el menú desplegable del selector de ramas.
-
Haz clic en el nombre del conjunto de reglas que quieres ver.
Edición de un conjunto de reglas
Nota: Si se creó un conjunto de reglas en el nivel de organización, no puedes editar el conjunto de reglas en la configuración del repositorio. Si tienes permiso para editar el conjunto de reglas, puedes hacerlo en la configuración de la organización. Para obtener más información, vea «Administración de conjuntos de reglas para repositorios de la organización».
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.
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
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.
-
En la página "Conjuntos de reglas", haz clic en el nombre del conjunto de reglas que deseas editar.
-
Cambie el conjunto de reglas según sea necesario. Para obtener información sobre las reglas disponibles, consulta "Reglas disponibles para conjuntos de reglas".
-
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".
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
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.
-
Haz clic en el nombre del conjunto de reglas que quieres eliminar.
-
A la derecha del nombre del conjunto de reglas, selecciona y, a continuación, haz clic en Eliminar conjunto de reglas.
Uso del historial del conjunto de reglas
Notas:
- El historial de conjuntos de reglas se encuentra en versión beta pública y está sujeto a cambios.
- Solo se incluyen en el historial del conjunto de reglas los cambios realizados en un conjunto de reglas después de la versión beta pública, el 11 de octubre de 2023.
Puedes ver todos los cambios en un conjunto de reglas y volver a una iteración específica. También puedes descargar un archivo JSON que contenga la configuración del conjunto de reglas en una iteración específica. La lista de omisión de un conjunto de reglas se excluye del archivo JSON exportado.
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
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.
-
Para ver el historial de cambios del conjunto de reglas, a la derecha del nombre del conjunto de reglas, selecciona y, a continuación, haz clic en Historial.
-
A la derecha de la iteración específica, selecciona y, a continuación, haz clic en Comparar cambios, Restaurar o Descargar.
Importación de un conjunto de reglas
Puedes importar un conjunto de reglas desde otro repositorio u organización mediante un archivo JSON. Esto puede ser útil si deseas aplicar el mismo conjunto de reglas a varios repositorios u organizaciones.
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
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.
-
Selecciona la lista desplegable Nuevo conjunto de reglas y haz clic en Importar un conjunto de reglas.
-
Abre el archivo JSON exportado.
-
Revisa el conjunto de reglas importado y haz clic en Crear.
Visualización de información para conjuntos de reglas
Puedes 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.
-
En GitHub.com, navega a la página principal del repositorio.
-
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.
-
En la barra lateral izquierda, en "Código y automatización", haz clic en Reglas y, a continuación, haz clic en Información.
-
En la página "Información sobre la regla", usa 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.
-
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.
