Skip to main content

Administrar una cola de fusión

Puedes aumentar la velocidad de desarrollo con una cola de fusión para las solicitudes de cambio de tu repositorio.

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 para las solicitudes de cambios se encuentra actualmente en un beta público limitado y está sujeta a cambios.

Acerca de las colas de fusión

Una cola de fusión puede aumentar la tasa en la que se fusionan las solicitudes de cambios en una rama destino mientras se asegura de que pasen todas las verificaciones de protección de rama requeridas.

Una vez que una solicitud de cambios pasa el resto de las verificaciones de protección de rama requeridas, un usuario con acceso de escritura al repositorio puede agregar dicha solicitud de cambios a una cola de fusión.

Una cola de fusión podría utilizar GitHub Actions. Para obtener más información, consulta la sección "GitHub Actions".

La cola de fusión crea ramas temporales con un prefijo especial para validad cambios de las solicitudes de cambios. The changes in the pull request are then grouped into a merge_group with the latest version of the base_branch as well as changes ahead of it in the queue. GitHub fusionará todos estos cambios en la base_branch una vez que pasen las verificaciones que requieren las protecciones de rama de la base_branch.

Para obtener más información acerca de los métodos de fusión, consulta "Acerca de la fusión de solicitudes de extracción."

Nota:

  • Una cola de fusión no puede habilitarse con reglas de protección de rama que utilicen caracteres de comodín (*) en el patrón de nombre de rama.

Después de agrupar una solicitud de cambios con la última versión de la rama destino y los cambios frente a ella en la cola, si es que existen verificaciones de estado requeridas fallidas o conflictos con la rama base, GitHub eliminará la solicitud de cambios de la cola. La línea de tiempo de la solicitud de cambios mostrará la razón por la cuál se eliminó esta de la cola.

Triggering merge group checks with GitHub Actions

You can use the merge_group event to trigger your GitHub Actions workflow when a pull request is added to a merge queue. Note that this is a different event from the pull_request and push events.

A workflow that reports a check which is required by the target branch's protections would look like this:

on:
  pull_request:
  merge_group:

For more information see "Events that trigger workflows"

Triggering merge group checks with other CI providers

Con otros proveedores de IC, podrías necesitar actualizar tu configuración de IC para que se ejecute cuando se cree una rama que comienza con el prefijo especial gh-readonly-queue/{base_branch}.

Administrar una cola de fusión

Los administradores de repositorio pueden requerir una fusión habilitando el ajuste de protección de rama "Requerir cola de fusión" en las reglas de protección para la rama base.

Para obtener más información de cómo habilitar el ajuste de protección de cola de fusión, consulta la sección "Administrar una regla de protección de rama".

Leer más