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

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 las ramas de un repositorio ya no permiten al administrador del repositorio cambiar el nombre de las ramas del repositorio de destino ni cambiar la rama predeterminada por otra. Los administradores del repositorio pueden crear y eliminar ramas siempre que tengan los permisos adecuados.

La omisión delegada para los conjuntos de reglas de inserción le permite controlar quién puede omitir la protección de inserción y qué inserciones bloqueadas deben permitirse.

Con la omisión delegada, los colaboradores a un repositorio deben solicitar “privilegios de omisión” al insertar confirmaciones que contienen contenido restringido. La solicitud se envía a un grupo designado de revisores, que aprueba o deniega la solicitud para omitir las reglas de inserción.

Si se aprueba la solicitud para omitir las reglas de inserción, el colaborador puede insertar la confirmación con contenido restringido. Si se deniega la solicitud, el colaborador debe eliminar el contenido de la confirmación (o las confirmaciones) que contiene el contenido restringido antes de volver a insertarlo.

Para configurar la omisión delegada, los propietarios de la organización o los administradores del repositorio crean primero una "lista de omisión". La lista de omisión incluye roles y equipos específicos, como los administradores del equipo o del repositorio, que supervisan las solicitudes para omitir la protección de inserción. Para obtener más información, vea «Administración de conjuntos de reglas para repositorios de la organización» y «Acerca de los conjuntos de reglas».

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

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, seleccione la foto del perfil y haga clic en Sus organizaciones.

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.

   

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 la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

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.

   

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.

   

Uso del historial del conjunto de reglas

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, seleccione la foto del perfil y haga clic en Sus organizaciones.

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.

   

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.

   

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

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, seleccione la foto del perfil y haga clic en Sus organizaciones.

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.

   

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

1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

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.

   

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.

   

Administración de solicitudes para omitir las reglas de inserción

Puede ver y administrar todas las solicitudes de privilegios de omisión en la página “Solicitudes de omisión”, ubicada en la pestaña Configuración de reglas del repositorio.

1. En GitHub, navegue hasta 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.

   

3. Haga clic en Solicitudes de omisión.

Puede filtrar las solicitudes por aprobador (miembro de la lista de omisión), solicitante (colaborador que realiza la solicitud), período de tiempo y estado. Se asignan los siguientes estados a una solicitud:

Estado	Descripción
Cancelled	El colaborador ha cancelado la solicitud.
Completed	La solicitud se ha aprobado y las confirmaciones se han insertado en el repositorio.
Denied	Se ha revisado y denegado la solicitud.
Expired	La solicitud ha expirado. Las solicitudes son válidas durante 7 días.
Open	La solicitud aún no se ha revisado o se ha aprobado, pero las confirmaciones no se han insertado en el repositorio.

Cuando un colaborador solicita privilegios de omisión para insertar una confirmación con contenido restringido, todos los miembros de la lista de omisión reciben una notificación por correo electrónico que contiene un vínculo a la solicitud. Los miembros de la lista de omisión tienen 7 días para revisar y aprobar o denegar la solicitud antes de que esta expire.

El colaborador recibe una notificación de la decisión por correo electrónico y debe realizar la acción necesaria. Si se aprueba la solicitud, el colaborador puede insertar la confirmación que con contenido restringido en el repositorio. Si se deniega la solicitud, el colaborador debe eliminar el contenido restringido de la confirmación para insertar correctamente la confirmación en el repositorio.