¿Qué es un grupo de concurrencia en GitHub Actions?
Última actualización
Un grupo de concurrencia es una clave con nombre en un workflow o job de GitHub Actions que permite que solo se ejecute una ejecución con esa clave a la vez. Las ejecuciones más recientes esperan o, con cancel-in-progress: true, cancelan la ejecución anterior que todavía está en curso.
Cómo funciona
Se añade un bloque concurrency con una cadena group. GitHub evalúa la cadena para cada ejecución. Si otra ejecución con el mismo grupo está en curso, la nueva queda en espera como pendiente. Cuando cancel-in-progress es true, se cancela la anterior y la nueva empieza de inmediato.
Solo puede haber una ejecución pendiente por grupo. Si llega una tercera ejecución mientras una se ejecuta y otra espera, se descarta la que esperaba en favor de la más reciente, salvo que se cancele en curso.
La cadena del grupo suele combinar el nombre del workflow y una ref, de modo que cada rama o pull request tiene su propio carril. Cancelar las ejecuciones superadas en un pull request muy activo es una de las formas más sencillas de reducir los minutos de CI desperdiciados.
Ejemplo
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
Aquí, cada pull request tiene su propio grupo y las ejecuciones anteriores se cancelan con un nuevo push. Los pushes a main tienen un grupo por ref y se ponen en cola en lugar de cancelarse, así que se prueba cada commit de main.
También funciona a nivel de job, por ejemplo para serializar despliegues:
jobs:
deploy:
concurrency:
group: production-deploy
cancel-in-progress: false
runs-on: ubuntu-latest
steps:
- run: ./deploy.sh
Errores comunes
- Cancelar despliegues a medias. Un despliegue cancelado puede dejar la infraestructura en mal estado. Utilice
cancel-in-progress: falsepara los despliegues. - Grupo demasiado amplio. Una cadena fija como
cien todas las ramas hace que pull requests no relacionados se cancelen entre sí. - Cancelar main. Cancelar las ejecuciones de la rama predeterminada oculta qué commit rompió la compilación.
- Cancelar ejecuciones de la cola de fusión. Las ejecuciones del evento
merge_groupno deberían cancelarse; consulte cola de fusión. - Olvidar el nombre del workflow. Dos workflows distintos con el mismo grupo comparten carril y se cancelan entre sí.
Términos relacionados
Para reducir aún más el gasto, consulte cómo reducir su factura de GitHub Actions.
Preguntas frecuentes
¿Cuál es la diferencia entre la concurrencia de workflow y la de job?
La concurrencia a nivel de workflow controla ejecuciones completas. La concurrencia a nivel de job controla un único job, útil para bloquear un recurso compartido, como un destino de despliegue.
¿Cancelar en curso ahorra dinero?
Sí. Las ejecuciones superadas dejan de consumir minutos. El ahorro depende de la frecuencia con la que haga push a pull requests abiertos.
¿Se facturan las ejecuciones canceladas?
Los minutos consumidos antes de la cancelación se facturan. Los minutos posteriores a la cancelación no.
Relacionado
- ¿Qué son los minutos de CI? Facturación de GitHub ActionsLos minutos de CI son el tiempo de cómputo facturado que usan sus pipelines. Cómo GitHub Actions cuenta los minutos y reduzca su consumo.
- ¿Qué es una clave de caché en GitHub Actions?Una clave de caché identifica una caché guardada en GitHub Actions. Aprenda cómo funcionan las claves y restore-keys y cómo evitar cachés obsoletas.
- ¿Qué es una prueba inestable? Definición y causasUna prueba inestable pasa y falla con el mismo código sin cambios. Conozca las causas habituales, cómo detectarlas en CI y cómo corregirlas o aislarlas.
- ¿Qué es una compilación de matriz en GitHub Actions?Una matrix build ejecuta un job varias veces con distintas entradas, como SO o versión de lenguaje. Aprenda la sintaxis, include/exclude y errores comunes.