Saltar al contenido

La operación fue cancelada en GitHub Actions

Última actualización

The operation was canceled significa que GitHub detuvo su job o step antes de que terminara, y lo hizo a propósito: una ejecución más reciente lo reemplazó, un job hermano falló, se alcanzó un timeout o alguien pulsó cancelar. Rara vez significa que su código sea incorrecto. Esta página enumera las causas por probabilidad y muestra cómo distinguirlas desde la página de la ejecución. El comportamiento procede de la referencia de sintaxis de workflows de GitHub, revisada en octubre de 2026.

El mensaje exacto

Error: The operation was canceled.

Variantes que puede ver junto a este mensaje:

Canceling since a higher priority waiting request for 'ci-refs/heads/main' exists
Error: The run was canceled by @username.
The runner has received a shutdown signal.

Revise las anotaciones en la parte superior del resumen de la ejecución. El texto suele indicar la causa.

Causa 1: concurrency con cancel-in-progress

Si un workflow declara concurrency con cancel-in-progress: true, al volver a hacer push se cancela la ejecución anterior del mismo grupo. El job cancelado registra The operation was canceled.

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

Es lo deseado para el CI de pull requests, pero no para despliegues ni jobs de publicación, donde cancelar a mitad de camino puede dejar las cosas a medias. Tenga en cuenta además la regla de GitHub: por defecto, una ejecución pending existente en el mismo grupo es sustituida por la nueva en cola, incluso sin cancel-in-progress. Eso es lo que significa el mensaje "higher priority waiting request".

Solución para despliegues:

concurrency:
  group: deploy-production
  cancel-in-progress: false

Con false, una ejecución avanza y otra espera; las ejecuciones en espera más antiguas siguen descartándose. Si necesita que todas las ejecuciones se completen, use nombres de grupo únicos por ejecución o una merge queue (véase merge queue de GitHub). Cancele solo en los jobs de CI:

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

Causa 2: fail-fast en matrix

En una matrix, fail-fast vale true por defecto. Cuando falla una celda, GitHub cancela las celdas que siguen ejecutándose, y estas informan "The operation was canceled" aunque estuvieran bien. El fallo real está en la celda en rojo, no en las canceladas.

strategy:
  fail-fast: false
  matrix:
    node: [18, 20, 22]

Establezca fail-fast: false mientras depura para ver el resultado real de cada celda. Véase compilaciones con matrix.

Causa 3: timeouts

Un step o job que supera timeout-minutes se cancela. El máximo de un step es de 360 minutos, y los jobs en runners alojados por GitHub están limitados a 6 horas. A menudo un step se queda bloqueado esperando una entrada o un servicio de red. Lea comportamiento de timeout-minutes y límites de tiempo. Establezca límites explícitos para que los bloqueos fallen rápido:

jobs:
  test:
    timeout-minutes: 20
    steps:
      - run: npm test
        timeout-minutes: 15

Causa 4: una persona o una API canceló la ejecución

Alguien hizo clic en Cancel workflow, o una automatización llamó a la API. Para comprobarlo:

gh run view RUN_ID --log | head -50
gh api repos/OWNER/REPO/actions/runs/RUN_ID --jq '.conclusion, .actor.login'

Son habituales las herramientas de publicación automatizada y el comando gh run cancel en otros workflows.

Causa 5: apagado o pérdida del runner

Los runners autoalojados en instancias spot, o los hosts de runner que se reinician, muestran The runner has received a shutdown signal y después cancelan los steps. Los runners alojados también pueden ser recuperados tras un incidente de infraestructura. Use runners efímeros con drenado controlado, o vuelva a los alojados por GitHub. Si el log indica que se perdió la comunicación, lea pérdida de comunicación con runners alojados.

Causa 6: un job dependiente falló

Un job con needs: se omite, no se cancela, cuando falla su dependencia. Si ve una cancelación, revise antes fail-fast o concurrency. Un step de limpieza con if: always() se ejecuta también al cancelar solo si usa if: always() o if: cancelled():

- name: Clean up
  if: always()
  run: ./cleanup.sh

Diagnóstico paso a paso

  1. Abra el resumen de la ejecución y lea las anotaciones. A menudo indican quién o qué la canceló.
  2. Revise el workflow en busca de concurrency:. Si existe y cancel-in-progress: true, es probablemente la causa.
  3. Compruebe si hay una matrix. Si alguna celda falló, corrija esa.
  4. Compare la duración del job con timeout-minutes.
  5. Si solo ocurre en runners autoalojados, revise los logs del host por reinicios.

Cómo prevenirlo

  1. Use grupos de concurrency por ref, nunca un único grupo global para todas las ramas.
  2. Desactive cancel-in-progress en los workflows de despliegue y publicación.
  3. Establezca fail-fast: false en las matrix cuyas celdas son independientes.
  4. Añada timeout-minutes a cada job y a los steps lentos.
  5. Use if: always() en la limpieza que debe ejecutarse siempre.

Las ejecuciones canceladas consumen minutos hasta el momento en que se detienen, por eso el enfoque con concurrency ahorra dinero; véase reducir la factura de GitHub Actions. También ayuda con las colas, véase Esperando a un runner. Si quiere jobs más cortos para que se cancelen con menos frecuencia, compiler.dev ejecuta los jobs existentes en máquinas de 8 vCPU / 16 GB con un cambio de una línea en runs-on.

Preguntas frecuentes

¿Cancela cancel-in-progress solo las ejecuciones más antiguas?

Sí. La ejecución más reciente de un grupo de concurrency continúa, y las ejecuciones en curso de ese mismo grupo se cancelan cuando cancel-in-progress: true.

¿Por qué las celdas de mi matrix que pasaban aparecen como canceladas?

fail-fast vale true por defecto. Una celda fallida cancela las demás que seguían ejecutándose.

¿Puedo saber quién canceló una ejecución?

Sí, en la anotación del resumen de la ejecución y mediante el campo de la API actor, además del registro de auditoría del repositorio.

¿Se factura una ejecución cancelada?

Solo paga los minutos utilizados antes de la cancelación.