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.
-
En GitHub, navegue hasta la página principal del repositorio.
-
En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.
-
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.
-
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.
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.
-
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.
-
En GitHub, navegue hasta la página principal del repositorio.
-
En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.
-
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.
-
Para quitar la solicitud de incorporación de cambios de la cola, haz clic en Quitar de la cola.
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».
-
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.
-
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.
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