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.
Puede importar reglas de protección de rama aptas juntas desde la configuración del conjunto de reglas del repositorio o convertir una regla a la vez.
GitHub propone uno o varios conjuntos de reglas para cada regla de protección de rama. Antes de crear los conjuntos de reglas, puede revisar sus nombres y cualquier advertencia sobre los cambios en el comportamiento. Una regla de protección de rama puede generar varios conjuntos de reglas cuando sus protecciones no se pueden representar en un único conjunto de reglas.
Para obtener más información sobre los conjuntos de reglas, consulte Acerca de los conjuntos de reglas.
Conversión de reglas de protección de rama para un repositorio
Puede convertir varias reglas de protección de ramas compatibles. Antes de crear los conjuntos de reglas, puede revisar y configurar qué protecciones se importarán y cómo se aplicarán los nuevos conjuntos de reglas.
-
En GitHub, navegue hasta la página principal del repositorio.
-
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.
-
En la barra lateral izquierda, en "Código, planificación y automatización", haga clic en Conjuntos de reglas y, a continuación, haga clic en Conjuntos de reglas.
-
En la parte superior de la página "Conjuntos de reglas", haga clic en Importar reglas de protección de rama.
-
En el cuadro de diálogo "Revisar importación", revise los conjuntos de reglas propuestos:
- Si una protección está etiquetada Ya está cubierta por un conjunto de reglas existente, la importación no creará otro conjunto de reglas para él.
- Revise las advertencias sobre el nuevo comportamiento. Una regla de protección de rama puede dar lugar a varios conjuntos de reglas propuestos.
-
En la lista desplegable Estado de aplicación, elija un estado para los nuevos conjuntos de reglas.
- Activo: aplica los conjuntos de reglas en cuanto se crean.
- Evaluar: registra cómo se comportarían los conjuntos de reglas sin hacerlos cumplir.
- Deshabilitado: crea los conjuntos de reglas sin evaluarlos ni hacerlos cumplir.
-
Seleccione la casilla de verificación para cada conjunto de reglas propuesto que quiera crear.
-
Haga clic en Crear conjuntos de reglas.
-
En el cuadro de diálogo "Crear conjunto de reglas" siguiente, elija qué hacer con las reglas de protección de ramas originales.
- Para conservar las protecciones originales, haga clic en Mantener regla. Las reglas originales siguen protegiendo las ramas coincidentes. Se aplica un conjunto de reglas activo junto a estas, por lo que los cambios deben satisfacer ambos.
- Para quitar las protecciones originales, haga clic en Eliminar regla de protección de rama. Elimine solo las reglas originales si los nuevos conjuntos de reglas son Activos y ha confirmado que cubren las ramas deseadas y se comportan según lo previsto. Los conjuntos de reglas Evaluación y Deshabilitado no proporcionan protección activa.
Conversión de una sola regla de protección de rama en un conjunto de reglas
Utilice el flujo de regla única cuando quiera revisar y configurar la conversión de una regla de protección de rama a la vez.
-
En GitHub, navegue hasta la página principal del repositorio.
-
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.
-
En la sección "Código, planeación y automatización" de la barra lateral, haga clic en Ramas.
-
En "Reglas de protección de rama", busque la regla que desea convertir y, a continuación, haga clic en Convertir a ruleset.
-
Establezca el nombre del conjunto de reglas para cada conjunto de reglas que se creará en esta conversión.
-
Revise la sección "Nuevo comportamiento" para comprender qué cambiará al crear el conjunto de reglas o los conjuntos de reglas.
-
En "Estado de cumplimiento", elija cómo se aplica el nuevo conjunto de reglas. Para obtener más información, consulte Elección de un estado de cumplimiento.
-
Si eligió Activo, puede quitar opcionalmente la regla de protección de rama original como parte de la conversión seleccionando Eliminar regla de protección de rama una vez finalizada la migración.
-
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. Un Evaluate ruleset registra cómo se comportaría sin aplicar sus reglas.
Elección de un estado de aplicación
Al convertir una regla de protección de rama, elija un estado de cumplimiento para el nuevo conjunto de reglas.
- Activo: el conjunto de reglas se aplica en cuanto se crea.
- Evaluar: el conjunto de reglas se ejecuta sin hacer cumplir sus reglas, por lo que puede revisar cómo se comportaría antes de que surta efecto.
Aunque Activo está seleccionado de forma predeterminada, tenga en cuenta qué estado se ajusta a su situación:
- Si ha creado o migrado reglas similares antes y confía en el resultado, puede usar Activo.
- Si se trata de la primera migración, considere la posibilidad de iniciar en el modo Evaluar . Puede confirmar que el nuevo conjunto de reglas se comporta según lo previsto y, a continuación, eliminar la regla de protección de rama original una vez finalizada la prueba.
Eliminar la regla de protección de rama original
Después de convertir una regla, vuelva a la página de 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 previsto, especialmente si lo creó en modo Evaluate. Cuando esté listo, haga clic en Eliminar para quitar la regla de protección de rama.