Skip to main content

Combinación de una solicitud de incorporación de cambios con una cola de fusión mediante combinación

Si la configuración de protección de rama requiere una cola de fusión mediante combinación para la rama, puedes agregar las solicitudes de incorporación de cambios a una cola de fusión mediante combinación y GitHub combinará las solicitudes de incorporación de cambios una vez que se hayan pasado todas las comprobaciones necesarias.

¿Quién puede utilizar esta característica?

Las colas de combinación de solicitudes de incorporación de cambios están disponibles en cualquier repositorio público propiedad de una organización, o bien en repositorios privados propiedad de organizaciones que usan GitHub Enterprise Cloud. Para más información, consulta "Planes de GitHub".

Tool navigation

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

Una cola de combinación ayuda a aumentar la velocidad mediante la automatización de las combinaciones de solicitudes de incorporación de cambios en una rama ocupada y asegurarse de que la rama nunca se interrumpe por cambios incompatibles.

La cola de combinación proporciona las mismas ventajas que requerir que las ramas estén actualizadas antes de combinar la protección de la rama, pero no requiere que un autor de la solicitud de incorporación de cambios actualice su rama de solicitud de incorporación de cambios y espere a que finalicen las comprobaciones de estado antes de intentar combinar.

El uso de una cola de combinación es especialmente útil en las ramas que tienen un número relativamente alto de solicitudes de incorporación de cambios que se combinan cada día de muchos usuarios diferentes.

Cuando una solicitud de incorporación de cambios ha superado todas las comprobaciones de protección de rama necesarias, el usuario con acceso de escritura al repositorio puede agregar la solicitud de incorporación de cambios a la cola. La cola de combinación garantizará que los cambios de la solicitud de incorporación de cambios pasen todas las comprobaciones de estado necesarias cuando se aplican a la versión más reciente de la rama de destino y a las solicitudes de incorporación de cambios que ya estén en la cola.

Una cola de combinación puede usar las GitHub Actions o tu propio proveedor de CI para ejecutar comprobaciones necesarias en las solicitudes de incorporación de cambios en una cola de combinación. Para obtener más información, vea «Documentación de GitHub Actions». Para más información sobre los métodos de fusión, consulta "Administración de una cola de fusión mediante combinación".

Adición de una solicitud de incorporación de cambios a una cola de fusión mediante combinación

Sugerencia: Puedes usar la GitHub CLI para agregar una solicitud de incorporación de cambios a una cola de combinación. Para obtener más información, haz clic en la pestaña "GitHub CLI" que se encuentra en la parte superior de este artículo.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Solicitudes de incorporación de cambios", se destaca en naranja oscuro.

  3. En la lista de "Solicitudes de incorporación de cambios", haz clic en aquella que te gustaría agregar a una cola de fusión mediante combinación.

  4. Haz clic en Combinar cuando esté listo para agregar la solicitud de incorporación de cambios a la cola de fusión mediante combinación. Como alternativa, si eres administrador, puedes hacer lo siguiente:

    • Combine directamente la solicitud de incorporación de cambios comprobando Combinar sin esperar a que se cumplan los requisitos (omitir las protecciones de rama), si la configuración de protección de rama lo permite, y seguir el flujo estándar.

    Captura de pantalla de las opciones de cola de combinación para una solicitud de incorporación de cambios.

    Sugerencia: Puedes hacer clic en Combinar cuando esté listo cada vez que estés listo para combinar los cambios propuestos. GitHub agregará automáticamente la solicitud de incorporación de cambios a la cola de fusión mediante combinación una vez que se cumplan las condiciones de las comprobaciones de aprobación y estado requeridas.

  5. Confirma que quieres agregar la solicitud de incorporación de cambios a la cola de fusión mediante combinación haciendo clic en Confirmar combinación cuando esté listo.

Con la GitHub CLI, puedes usar el comando gh pr merge para agregar una solicitud de incorporación de cambios a una cola de combinación. Si el destino es una rama que requiere una cola de combinación, este comando agrega automáticamente la solicitud de incorporación de cambios a la cola si se han superado las comprobaciones necesarias. Si no se han superado las comprobaciones necesarias, este comando habilita la combinación automática para la solicitud de incorporación de cambios. Para obtener más información, consulta gh pr merge en el manual de la GitHub CLI.

Eliminación de una solicitud de incorporación de cambios de una cola de fusión mediante combinación

Para quitar una solicitud de incorporación de cambios de una cola de combinación, tendrás que ir a la página del repositorio en GitHub.com. No puedes usar la GitHub CLI para quitar una solicitud de incorporación de cambios de una cola de combinación.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Solicitudes de incorporación de cambios", se destaca en naranja oscuro.

  3. En la lista de "Solicitudes de incorporación de cambios", haz clic en aquella que te gustaría quitar de una cola de fusión mediante combinación.

  4. Para quitar la solicitud de incorporación de cambios de la cola, haz clic en Quitar de la cola.

    Captura de pantalla del mensaje de cola de combinación en la parte inferior de una solicitud de incorporación de cambios. El botón "Quitar de la cola" está resaltado en naranja oscuro.

Como alternativa, puedes ir a la página Cola de fusión mediante combinación de la rama base, hacer clic en ... junto a la solicitud de incorporación de cambios que quieres quitar y seleccionar Quitar de la cola. Para obtener información sobre cómo obtener la página Cola de fusión mediante combinación de la rama base, consulta la sección siguiente.

Visualización de colas de fusión mediante combinación

Puedes ver la cola de fusión mediante combinación de una rama base en varios lugares de GitHub. No puedes usar la GitHub CLI para ver una cola de combinación.

Puedes ver la cola de fusión mediante combinación de una rama base en varios lugares de GitHub.

  • En la página Ramas del repositorio. Te recomendamos que utilices esta ruta si no tienes o no sabes si una solicitud de incorporación de cambios ya está en una cola y si quieres ver lo que hay en dicha cola. Para obtener más información, vea «Ver las ramas en tu repositorio».

    Captura de pantalla de la página "Ramas" de un repositorio. Un vínculo, con la etiqueta "33 solicitudes de incorporación de cambios en cola para combinar", está resaltado en naranja oscuro.

  • En la página de la solicitud de incorporación de cambios, cuando se requiera la cola de fusión mediante combinación para la combinación, desplázate hasta la parte inferior de la escala de tiempo y haz clic en el vínculo de cola de fusión mediante combinación.

    Captura de pantalla del mensaje de cola de combinación en la parte inferior de una solicitud de incorporación de cambios. El vínculo "cola de combinación" está resaltado en naranja oscuro.

  • La vista de cola de fusión muestra las solicitudes de cambios que están actualmente en cola, con tus solicitudes de cambios marcadas claramente.

    Captura de pantalla de la cola de combinación.

Información de los motivos por los que se quitó la solicitud de incorporación de cambios de la cola de combinación

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, la solicitud de incorporación de cambios de la cola se eliminará. 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.

Hay varias razones por las que se puede quitar una solicitud de incorporación de cambios de una cola de combinación:

  • El servicio de CI configurado ha notificado errores de prueba para un grupo de combinación
  • Se ha agotado el tiempo de espera de un resultado de CI correcto según la configuración de tiempo de espera configurada.
  • Usuario que solicita una eliminación mediante la API o la interfaz de la cola de combinación
  • Error de protección de rama que no se ha podido resolver automáticamente