Saltar al contenido

¿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: false para los despliegues.
  • Grupo demasiado amplio. Una cadena fija como ci en 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_group no 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í.

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.