Saltar al contenido

¿Qué es una cola de fusión en GitHub?

Última actualización

Una cola de fusión es una función de GitHub que ordena las pull requests aprobadas y prueba cada una de ellas contra la última rama base más los cambios que están delante en la cola, y solo las fusiona cuando esas comprobaciones pasan. Evita que dos pull requests que individualmente están en verde rompan juntas la rama principal.

Cómo funciona

Sin una cola, una pull request se prueba contra la rama base tal como estaba cuando se subió el último commit. Si otra pull request se fusiona antes, su resultado en verde ya no está actualizado. Con una cola, al hacer clic en "Merge when ready", GitHub crea una rama temporal (un grupo de fusión) que contiene la rama base, las PR que están delante de la suya y la suya propia. Ejecuta las comprobaciones obligatorias sobre ese estado combinado. Si pasan, la PR se fusiona. Si fallan, se elimina de la cola y las siguientes entradas se reconstruyen sin ella.

La cola puede agrupar varias pull requests en un único grupo de fusión para ahorrar tiempo de CI. Usted define el método de fusión, el tamaño del grupo y el tiempo mínimo de espera en la configuración de protección de ramas o de reglas.

Ejemplo

Las comprobaciones de estado obligatorias deben ejecutarse para el evento merge_group, o nunca se informarán y la cola se bloqueará:

on:
  pull_request:
  merge_group:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

La configuración completa, incluidas las reglas, está en Cola de fusión de GitHub explicada.

Errores comunes

  • Falta el disparador merge_group. La causa más habitual de una PR bloqueada en "waiting for status". Añádalo a cada workflow que proporcione una comprobación obligatoria.
  • CI lento. Cada PR en cola espera a sus comprobaciones, así que un pipeline de 20 minutos genera una cola larga. Aquí la velocidad importa aún más; consulte CI lento.
  • Filtros de ruta en comprobaciones obligatorias. Si un filtro omite un job obligatorio, nunca se informará en el grupo de fusión. Use un job final de "gate".
  • Suponer que funciona en todos los planes. La disponibilidad depende del plan y del tipo de repositorio. Consulte la documentación actual de GitHub.
  • Ejecutar suites costosas dos veces. Las pruebas se ejecutan en la pull request y de nuevo en la cola. Mueva las pruebas end-to-end pesadas solo a la cola.

Como las ejecuciones en cola se acumulan, un grupo de concurrencia no debería cancelar las ejecuciones de merge_group. Cancele las ejecuciones de PR sustituidas, nunca las de la cola.

Preguntas frecuentes

¿Una cola de fusión es lo mismo que la fusión automática?

No. La fusión automática fusiona cuando las comprobaciones pasan en el propio commit de la PR. Una cola de fusión prueba el resultado combinado antes de fusionar.

¿Las pruebas inestables importan más con una cola?

Sí. Un fallo intermitente expulsa una pull request y reinicia las entradas que van detrás. Consulte pruebas inestables.

¿Puedo saltarme la cola para correcciones urgentes?

Los administradores pueden omitir las protecciones de rama si la regla lo permite. Úselo con moderación.