Skip to main content

Conversión de protecciones de rama en conjuntos de reglas

Use conjuntos de reglas para obtener una mayor visibilidad y control sobre las protecciones del repositorio, a la vez que se conserva su comportamiento existente.

¿Quién puede utilizar esta característica?

People with admin access to a repository, or a custom role with the "edit repository rules" permission, can create, edit, and delete rulesets for a repository.

Los conjuntos de reglas están disponibles en repositorios públicos con GitHub Free y GitHub Free para organizaciones, y en repositorios públicos y privados con GitHub Pro, GitHub Teamy GitHub Enterprise Cloud. Consulte planes de GitHub.

Los conjuntos de reglas de envío están disponibles para el plan GitHub Team en los repositorios internos y privados, y en las bifurcaciones de repositorios que tienen habilitados conjuntos de reglas de envío.

Acerca de la conversión de protecciones de rama en conjuntos de reglas

Los conjuntos de reglas proporcionan visibilidad y control más claros sobre cómo se aplican las protecciones a un repositorio. A diferencia de las reglas de protección de rama, se pueden aplicar varios conjuntos de reglas a la misma rama al mismo tiempo, y las personas con acceso de lectura pueden ver los conjuntos de reglas activos. Esto ayuda a los desarrolladores a comprender las reglas que les afectan y permite a los auditores revisar las protecciones del repositorio sin acceso de administrador.

Para mover las protecciones existentes a este modelo, convierta una regla de protección de rama a la vez en un flujo guiado. GitHub genera uno o varios conjuntos de reglas que conservan el comportamiento de la regla original. Puede obtener una vista previa de los conjuntos cada uno y comprobar el resultado antes de quitar la regla de protección de rama original.

Para obtener más información sobre los conjuntos de reglas, consulte Acerca de los conjuntos de reglas.

Conversión de una regla de protección de rama en 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.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección de "Code and automation" de la barra lateral, haz clic en Branches.

  4. En "Reglas de protección de rama", busque la regla que desea convertir y, a continuación, haga clic en Convertir en conjunto de reglas.

  5. Establezca el nombre del conjunto de reglas para cada conjunto de reglas que se creará en esta conversión.

  6. Revise la sección "Nuevo comportamiento" para comprender qué cambiará al crear el conjunto de reglas o los conjuntos de reglas.

  7. Opcionalmente, para quitar la regla de protección de rama original como parte de la conversión, seleccione Eliminar regla de protección de rama una vez finalizada la migración.

  8. Haga clic en Crear conjunto de reglas. Si la conversión genera más de un conjunto de reglas, el botón incluye el número de conjuntos de reglas, por ejemplo, Crear 2 conjuntos de reglas.

Si mantiene la regla de protección de rama original, sigue protegiendo las ramas coincidentes. Se aplica un conjunto de reglas activo junto a él, por lo que los cambios deben satisfacer ambos.

Nota:

La conversión cubre todos los tipos de protección de rama con la excepción de la opción "Requerir resolución de conversación antes de combinar". En las protecciones de rama, esta configuración existe por sí sola. En los conjuntos de reglas, la resolución de conversación forma parte de la regla de solicitud de incorporación de cambios y solo se aplica cuando esa regla está habilitada. Como resultado, esta configuración no asigna una a una durante la conversión. Consulte Reglas disponibles para conjuntos de reglas.

El nuevo conjunto de reglas tiene un estado Activo , lo que significa que se aplica en cuanto se crea.

Eliminación de la regla de protección de rama original

Después de convertir una regla, vuelva a la página Configuración de ramas . Si no optó por eliminar la regla de protección de rama durante el proceso de conversión y el nuevo conjunto de reglas lo cubre completamente, la regla enumerada muestra el mensaje "Esta regla está totalmente cubierta por los conjuntos de reglas y se puede eliminar de forma segura", y aparece un botón Eliminar en lugar del botón Convertir en conjunto de reglas .

Antes de eliminar la regla original, se recomienda confirmar que el nuevo conjunto de reglas se comporta según lo previstoEvaluar. Cuando esté listo, haga clic en Eliminar para quitar la regla de protección de rama.

Lectura adicional