Administración de conjuntos de reglas para repositorios de la organización

Puede editar, supervisar y eliminar conjuntos de reglas existentes para modificar la manera en que las personas pueden interactuar con los repositorios de su organización.

¿Quién puede utilizar esta característica?

Organization owners and users with the "Manage organization ref update rules and rulesets" permission can manage rulesets at the organization level.

En este artículo

Acerca de la administración de conjuntos de reglas para una organización

Después de crear un conjunto de reglas en el nivel de organización, puede realizar cambios en el conjunto de reglas para modificar la manera en que las personas pueden interactuar con los repositorios de destino. Por ejemplo, puede agregar reglas para proteger mejor las ramas o etiquetas de esos repositorios, o bien cambiar el conjunto de reglas del modo "Evaluar" a "Activo" después de probar sus efectos en la experiencia de colaborador de los repositorios. Los conjuntos de reglas de la organización que se aplican a la "rama predeterminada" de un repositorio ya no permitirán al administrador del repositorio realizar actualizaciones en la rama predeterminada del repositorio de destino.

Puede usar la API de REST y Graph API para administrar conjuntos de reglas. Para obtener más información, consulte "Puntos de conexión de la API de REST para reglas" y "Mutaciones".

Nota: Cualquier persona con acceso de lectura a un repositorio puede ver los conjuntos de reglas operativos en ese repositorio.

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 la esquina superior derecha de GitHub.com, selecciona la foto de perfil y luego haz clic en Sus organizaciones.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro.

  2. Junto a la organización, haga clic en Settings.

  3. En la barra lateral izquierda, en la sección "Código, planeamiento y automatización", haz clic en Repositorio y, luego, haz clic en Conjuntos de reglas.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Conjuntos de reglas" con 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 la esquina superior derecha de GitHub.com, selecciona la foto de perfil y luego haz clic en Sus organizaciones.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro.

  2. Junto a la organización, haga clic en Settings.

  3. En la barra lateral izquierda, en la sección "Código, planeamiento y automatización", haz clic en Repositorio y, luego, haz clic en Conjuntos de reglas.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Conjuntos de reglas" con 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.

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.

  1. En la esquina superior derecha de GitHub.com, selecciona la foto de perfil y luego haz clic en Sus organizaciones.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro.

  2. Junto a la organización, haga clic en Settings.

  3. En la barra lateral izquierda, en la sección "Código, planeamiento y automatización", haz clic en Repositorio y, luego, haz clic en Conjuntos de reglas.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Conjuntos de reglas" con un contorno naranja.

  4. 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.

    Captura de pantalla de la página de conjuntos de reglas del repositorio. Debajo de un botón etiquetado con tres puntos, una opción con la etiqueta «Historial» está resaltada en naranja.

  5. A la derecha de la iteración específica, selecciona y, a continuación, haz clic en Comparar cambios, Restaurar o Descargar.

    Captura de pantalla de la página del historial de los conjuntos de reglas del repositorio. Un menú desplegable etiquetado con tres puntos se amplía y se destaca con un contorno naranja.

Importación de un conjunto de reglas

Puede importar un conjunto de reglas desde otro repositorio u organización mediante el archivo JSON exportado de la sección anterior. Esto puede ser útil si deseas aplicar el mismo conjunto de reglas a varios repositorios u organizaciones.

  1. En la esquina superior derecha de GitHub.com, selecciona la foto de perfil y luego haz clic en Sus organizaciones.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro.

  2. Junto a la organización, haga clic en Settings.

  3. En la barra lateral izquierda, en la sección "Código, planeamiento y automatización", haz clic en Repositorio y, luego, haz clic en Conjuntos de reglas.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Conjuntos de reglas" con un contorno naranja.

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

    Captura de pantalla de la página de conjuntos de reglas del repositorio. Se expande un menú desplegable con la etiqueta «Nuevo conjunto de reglas» y la opción «Importar un conjunto de reglas» está resaltada con un contorno naranja.

  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 consultar información sobre los conjuntos de reglas para ver cómo afectan los conjuntos de reglas a los repositorios de su organización. 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.

Captura de pantalla "Información sobre la regla". Se muestran tres acciones: una marcada como "aprobada", una marcada como "omitida" y otra marcada como "error" con una etiqueta "evaluar".

  1. En la esquina superior derecha de GitHub.com, selecciona la foto de perfil y luego haz clic en Sus organizaciones.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro.

  2. Junto a la organización, haga clic en Settings.

  3. En la barra lateral izquierda, en la sección "Código, planificación y automatización", haga clic en Repositorio y, a continuación, en Información sobre reglas.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Información sobre reglas" con un contorno naranja.

  4. En la página "Información sobre reglas", utilice los menús desplegables en la parte superior de la página para filtrar las acciones por conjunto de reglas, repositorio, 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.

    Captura de pantalla "Información sobre la regla". A la derecha de un evento con la etiqueta "octocat created not-allowed", aparece un icono de tres puntos horizontal con un contorno naranja.