Administración de conjuntos de reglas para repositorios en su 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.

Para obtener información sobre cómo afectan los conjuntos de reglas de la organización al cambio de nombre de rama, consulte Permitir que los administradores del repositorio cambien el nombre de las ramas con conjuntos de reglas de la organización.

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.

Nota:

Cualquier persona con acceso de lectura a un repositorio puede ver los conjuntos de reglas activos 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, haz clic en la foto del perfil y luego en Your organizations.

  2. Seleccione una organización haciendo clic en ella.

  3. Debajo del nombre de la organización, 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.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  4. En la barra lateral de la izquierda, en la sección "Code, planning, and automation", haz clic en Repository y luego en Rulesets.

    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.

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

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

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

Eliminación de un conjunto de reglas

Sugerencia

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

  1. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

  2. Seleccione una organización haciendo clic en ella.

  3. Debajo del nombre de la organización, 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.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  4. En la barra lateral de la izquierda, en la sección "Code, planning, and automation", haz clic en Repository y luego en Rulesets.

    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.

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

  6. A la derecha del nombre del conjunto de reglas, selecciona y, a continuación, haz clic en Delete ruleset.

    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.

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, haz clic en la foto del perfil y luego en Your organizations.

  2. Seleccione una organización haciendo clic en ella.

  3. Debajo del nombre de la organización, 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.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  4. En la barra lateral de la izquierda, en la sección "Code, planning, and automation", haz clic en Repository y luego en Rulesets.

    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.

  5. 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. El menú desplegable "Nuevo conjunto de reglas" se expande y la opción "Importar un conjunto de reglas" está resaltada en naranja.

  6. Abre el archivo JSON exportado.

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