Skip to main content

Administración de una cola de fusión mediante combinación

Puedes aumentar la velocidad de desarrollo con una cola de fusión mediante combinación para las solicitudes de incorporación de cambios en el repositorio.

Who can use this feature

People with admin permissions can manage merge queues for pull requests targeting selected branches of a repository.

Nota: La característica de cola de fusión mediante combinación de solicitudes de incorporación de cambios se encuentra actualmente en versión beta pública y está sujeta a cambios.

Acerca de las colas de fusión mediante combinación

Una cola de combinación puede aumentar la velocidad a la que se combinan las solicitudes de incorporación de cambios en una rama de destino muy activa, a la vez que garantiza que se superen todas las comprobaciones de protección de rama necesarias.

Una vez que una solicitud de incorporación de cambios ha superado todas las comprobaciones de protección de rama necesarias, un usuario con acceso de escritura al repositorio puede agregar esa solicitud de incorporación de cambios a una cola de combinación.

Un cola de combinación puede usar GitHub Actions. Para más información, vea "GitHub Actions".

La cola de fusión mediante combinación crea ramas temporales con un prefijo especial para validar los cambios de la solicitud de incorporación de cambios. Los cambios en la solicitud de incorporación de cambios se agrupan en un merge_group con la versión más reciente de base_branch, así como los cambios anteriores en la cola. GitHub combinará todos estos cambios en base_branch una vez que se superen las comprobaciones necesarias para las protecciones de rama de base_branch.

Para obtener información sobre los métodos de combinación, vea "Acerca de las combinaciones de solicitudes de incorporación de cambios".

Nota:

  • No se puede habilitar una cola de fusión mediante combinación con reglas de protección de rama en las que se usan caracteres comodín (*) en el patrón de nombre de rama.

Después de agrupar una solicitud de incorporación de cambios con la versión más reciente de la rama de destino y los cambios anteriores en la cola, si hay comprobaciones de estado necesarias con errores o conflictos con la rama base, GitHub quitará la solicitud de incorporación de cambios de la cola. La línea de tiempo de la solicitud de incorporación de cambios mostrará el motivo por el que esa solicitud se ha eliminado de la cola.

Desencadenamiento de comprobaciones del grupo de fusión mediante combinación con GitHub Actions

Puedes usar el evento merge_group para desencadenar tu flujo de trabajo de GitHub Actions cuando se agrega una solicitud de incorporación de cambios a una cola de fusión. Ten en cuenta que se trata de un evento diferente a los eventos pull_request y push.

Un flujo de trabajo que informa de una comprobación requerida por las protecciones de la rama de destino tendría este aspecto:

on:
  pull_request:
  merge_group:

Para más información, consulta "Eventos que desencadenan flujos de trabajo".

Desencadenamiento de comprobaciones del grupo de fusión mediante combinación con otros proveedores de CI

Con otros proveedores de CI, es posible que tengas que actualizar tu configuración de CI para que se ejecute cuando se crea una rama que comience con el prefijo especial gh-readonly-queue/{base_branch}.

Administración de una cola de fusión mediante combinación

Los administradores del repositorio pueden exigir una combinación si habilitan el valor de protección de rama "Require merge queue" en las reglas de protección de la rama base.

Para obtener información sobre cómo habilitar la configuración de protección de colas de fusión mediante combinación, vea "Administración de una regla de protección de rama".

Información adicional