Agregar reglas de aprobación de solicitudes de extracción

Escrito para la antigua interfaz de usuario

Este artículo fue escrito para la antigua interfaz de usuario. Las instrucciones todavía se pueden usar, pero las capturas de pantalla están desactualizadas. En algunos casos, los elementos mencionados en las instrucciones se han movido o cambiado. Si no puede encontrar un elemento, consulte el ¿Dónde quedó? artículo.

Resumen

Este artículo explica cómo funciona una regla de aprobación de Pull Request y cómo agregar una. De forma predeterminada, un Pull Request no requiere revisiones antes de poder fusionarse. Con una regla de aprobación de Pull Request, los administradores pueden exigir un número mínimo de aprobaciones antes de que un Pull Request pueda fusionarse. Cada regla define a qué ramas se aplica y cuántas aprobaciones se requieren. La rama de destino de un Pull Request determina cuántas aprobaciones necesita.

La regla se puede configurar con distintos ámbitos:

• Todas las ramas: La regla se aplica a cualquier rama no cubierta por una regla más específica.
• Selecciona: La regla se dirige a una o más ramas seleccionadas explícitamente.
• Patrón: La regla utiliza sintaxis comodín para coincidir con ramas por convención de nombres (p. ej., feature/*, release/v*, hotfix-*).

Anular la regla de aprobación del Pull Request

Una regla de aprobación de Pull Request no se puede anular. Cuando la regla se aplica a la rama de destino, el Pull Request no puede fusionarse hasta que el número requerido de revisores lo apruebe. Esta aplicación es intencional. Sin embargo, hay dos formas aprobadas de eludir una regla de aprobación de Pull Request:

• Realiza un Fusión inteligente, que no requiere revisión.
• Cambiar la regla de aprobación del Pull Request.

Ejemplo de Pull Request

La siguiente captura de pantalla muestra un Pull Request con una regla de aprobación aplicada.

Jerarquía de reglas

Cuando las ramas seleccionadas por una regla se solapan con otra regla, la precedencia determina qué regla se aplica a la rama solapada. El orden de precedencia, de mayor a menor, es:

• Selecciona > Patrón > Todas las ramas

La siguiente captura de pantalla muestra dos reglas: una se aplica a Todas las ramas, y la otra se aplica solo a la main rama. Debido a que la Selecciona regla tiene precedencia sobre la Todas las ramas regla, cualquier Pull Request que tenga como destino la main rama requiere 3 aprobaciones en lugar de la 1 aprobación requerida para otras ramas.

Casos especiales

La Selecciona La opción no le permite asignar la misma rama a más de una regla. Esto evita conflictos, como que una regla requiera tres aprobaciones para la rama X mientras que otra requiere solo una.

La Patrón La opción no le permite guardar varias reglas con patrones superpuestos. Por ejemplo, no puede guardar tanto feature/* y feature/new*, porque el feature/* patrón ya contiene el feature/new* patrón.

Agregar reglas de aprobación

1

Habilitar reglas de aprobación

1. Haz clic en Configuración en el menú de la barra lateral izquierda.
2. Haz clic en el General pestaña.
3. Haz clic en Solicitudes de extracción.

   
4. Si está deshabilitado, haga clic en el habilitar interruptor para habilitar las reglas de aprobación.

   

2

Seleccionar ramas

Hay tres métodos para seleccionar a qué ramas se aplicará la Regla de aprobación.

Todas las ramas

Esta selección aplica la regla a cada rama de su tenant de DevOps.

1. Seleccione el todas las ramas opción.

Selecciona

Esta selección aplica la regla solo a las ramas que selecciona de la lista.

1. Seleccione el Selecciona opción.
2. Haz clic en el Seleccionar ramas menú desplegable.
3. Seleccione cada una de las ramas a las que aplicar esta regla.

   

Cada rama seleccionada muestra una marca de verificación a la derecha. El menú desplegable también muestra el número de ramas seleccionadas y disponibles. Si tiene muchas ramas, use el cuadro de búsqueda para encontrarlas.

Patrón

Esta selección aplica la regla a cualquier rama que coincida con el patrón que introduzca. Puede agregar el carácter comodín al final de un patrón (*) para coincidir con ramas que comiencen con su patrón y terminen con cualquier otro carácter. Por ejemplo, si usa el patrón feature/*, la siguiente tabla muestra cómo afecta esta regla a sus ramas.

Ramas	Regla aplicada
main
feature/addAccount
feature/removeAccount
release/v1.2.3

1. Seleccione el Patrón opción.
2. Introduzca el patrón que se usará para esta regla en el cuadro de texto.

   

3

Establecer recuento de aprobaciones

La Recuento de aprobaciones es el número de revisores que deben aprobar un Pull Request antes de que pueda fusionarse. El recuento debe ser al menos 1.

1. Introduzca el número de aprobaciones requeridas para esta regla en el recuento de aprobaciones cuadro de texto.

   

4

Agregar reglas

Puede agregar varias reglas de aprobación a la configuración de Pull Requests. Para saber qué regla se aplica a una rama seleccionada por varias reglas, consulte la Jerarquía de reglas sección anterior.

1. Haz clic en Agregar regla.

   
2. Configure la selección de ramas de la regla y el recuento de aprobaciones siguiendo las instrucciones anteriores.

   

5

Guardar reglas

Una vez que haya terminado de definir sus reglas de aprobación de Pull Request, debe guardarlas antes de que se apliquen a cualquier Pull Request nueva o activa.

1. Haz clic en Guardar.