Skip to main content

Managing a merge queue

You can increase development velocity with a merge queue for pull requests in your repository.

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. Los propietarios de las organizaciones pueden solicitar acceso temprano al beta si se unen a la Lista de espera.

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".

The merge queue creates temporary branches with a special prefix to validate pull request changes. The changes in the pull request are then grouped with the latest version of the base_branch as well as changes ahead of it in the queue. GitHub will merge all these changes into base_branch once the checks required by the branch protections of base_branch pass.

You may need to update your Continuous Integration (CI) configuration to trigger builds on branch names that begin with the special prefix gh-readonly-queue/{base_branch} after the group is created.

For example, with GitHub Actions, a workflow with the following trigger will run each time a pull request that targets the base branch main is queued to merge.

on:
  push:
    branches:
    - gh-readonly-queue/main/**

GitHub fusiona la solicitud de cambios de acuerdo con la estrategia de fusión configurada en la protección de rama una vez que todas las verificaciones de IC hayan pasado.

Método de fusión de cola de fusión

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:

  • A merge queue cannot be enabled with branch protection rules that use wildcard characters (*) in the branch name pattern.

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.

Administrar una cola de fusión

Repository administrators can require a merge by enabling the branch protection setting "Require merge queue" in the protection rules for the base branch.

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