Saltar al contenido

Tiempo máximo de ejecución de 360 minutos superado: solución

Última actualización · Publicado por primera vez

The job running on runner ... has exceeded the maximum execution time of 360 minutes significa que su job se ejecutó durante 6 horas, el límite de los runners alojados por GitHub, y GitHub lo detuvo. Casi siempre el job estaba bloqueado, no lento: una prueba colgada, un proceso que espera una entrada o un deadlock. Esta página explica cómo funciona timeout-minutes en jobs y steps, cómo encontrar qué se bloqueó y cómo fallar rápido en lugar de consumir 6 horas de minutos. Los límites proceden de la página de límites de uso y de la sintaxis de workflows de GitHub, verificados en octubre de 2026.

El mensaje exacto

The job running on runner GitHub Actions 5 has exceeded the maximum execution time of 360 minutes.

El nombre y el número del runner varían. Si configura un timeout-minutes más bajo, el número del mensaje coincide con su valor en lugar de 360. Un step que agota el tiempo aparece como cancelado, a veces con The operation was canceled (consulte esa página).

Los límites

  • Jobs en runners alojados por GitHub: limitados a 6 horas. Un job que llega a ese límite se termina y falla.
  • Jobs en runners autoalojados: limitados a 5 días.
  • Step timeout-minutes: máximo de 360 tanto para runners alojados como autoalojados.
  • Ejecución de workflow: 35 días, incluido el tiempo de espera y de aprobación. Las ejecuciones que llegan a ese límite se cancelan.
  • Tiempo en cola de jobs en runners autoalojados: 24 horas, tras las cuales se cancelan.

Si no configura timeout-minutes en un job, este puede ejecutarse hasta 360 minutos, que es el valor predeterminado en los runners alojados. Un job bloqueado de 6 horas en un runner grande resulta caro: seis horas a la tarifa de 8 núcleos suponen un coste real. Consulte los límites de tiempo y los precios.

Cómo funciona timeout-minutes

A nivel de job

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

Cuando el job supera los 20 minutos, GitHub lo cancela, ejecuta los steps con if: always() o if: cancelled() con el mejor esfuerzo posible y marca el job como fallido.

A nivel de step

steps:
  - run: ./integration-tests.sh
    timeout-minutes: 10

El step se detiene tras 10 minutos. El job entonces falla, salvo que el step tenga continue-on-error: true. Los tiempos de step no amplían el tiempo del job: el límite del job sigue aplicándose al total.

Jobs con matriz

timeout-minutes se aplica a cada job de la matriz por separado. Que una celda agote el tiempo puede provocar cancelaciones por fail-fast en las demás (detalles en The operation was canceled).

¿Por qué el job se bloqueó durante 6 horas?

1. Una prueba que nunca termina

Handles abiertos, una promesa sin resolver, un deadlock o una llamada de red sin timeout. Añada un timeout por prueba en su runner (Jest --testTimeout, pytest-timeout, go test -timeout 10m).

- run: go test -timeout 10m ./...
- run: pytest --timeout=300

2. Un comando que espera una entrada

Los instaladores, apt, ssh y npm init pueden pedir confirmación. Use flags no interactivos:

- run: sudo apt-get install -y --no-install-recommends build-essential
  env:
    DEBIAN_FRONTEND: noninteractive

3. Un proceso en segundo plano que mantiene vivo el step

Un servidor de desarrollo iniciado con & que nunca se detiene puede mantener abierto el step si su salida sigue conectada. Redirija la salida y detenga el proceso:

- run: |
    npm run start > server.log 2>&1 &
    npx wait-on http://localhost:3000 --timeout 60000
    npx playwright test

4. Esperar a un servicio externo o a una aprobación

Un step que consulta indefinidamente el estado de un despliegue, o un job que espera la aprobación de un entorno. Asigne un plazo a los bucles de sondeo.

5. Un runner sin memoria suficiente

El thrashing hace que todo vaya muy lento. Busque señales de código de salida 137 y de pérdida de comunicación.

6. El trabajo es realmente así de largo

Si un job legítimo necesita más de 6 horas, divídalo en varios jobs (matriz o sharding; consulte sharding de pruebas), o use un runner autoalojado, donde el límite es de 5 días. Las máquinas más rápidas también ayudan: compiler.dev ejecuta sus jobs existentes en máquinas de 8 vCPU / 16 GB tras cambiar una sola línea a runs-on: [self-hosted, Linux, compiler-ci]; consulte los benchmarks y los precios.

Encuentre lo que se bloqueó

  1. Abra el log del job cancelado. Las últimas líneas anteriores a la cancelación indican el step.
  2. Vuelva a ejecutar con logs de depuración configurando la variable ACTIONS_STEP_DEBUG en true.
  3. Reproduzca el problema con un timeout corto para no esperar seis horas: configure timeout-minutes: 10 temporalmente.
  4. Añada timeout a los comandos que sospeche:
timeout 300 ./slow-command.sh || echo "timed out after 300s"

Cómo elegir valores razonables

Una buena regla es unas 2 o 3 veces su duración habitual. Si las pruebas tardan 8 minutos, use 20 o 25. Revise las ejecuciones recientes para encontrar el tiempo p95. La guía de CI lento explica cómo reducir la duración normal, y la calculadora del coste de un CI lento muestra lo que cuestan los jobs bloqueados.

Cómo prevenirlo

  1. Configure timeout-minutes en todos los jobs. No deje el valor predeterminado de 360.
  2. Establezca límites más estrictos para los pasos que suelen bloquearse (pruebas e2e, sondeo de despliegues).
  3. Use también los tiempos de espera del ejecutor de pruebas para obtener un rastro de pila útil.
  4. Añada concurrency con cancel-in-progress para las PR, de modo que las ejecuciones abandonadas se detengan pronto; consulte cómo reducir la factura de Actions.
  5. Configure una alerta para cualquier job que dure más del doble de su mediana.

Preguntas frecuentes

¿Cuál es el tiempo de espera predeterminado de un job de GitHub Actions?

360 minutos (6 horas) en los ejecutores alojados en GitHub. Si configura timeout-minutes, el límite de ese job se reduce.

¿Puedo superar el límite de 360 minutos?

No en los ejecutores alojados en GitHub. Los jobs en ejecutores autoalojados pueden durar hasta 5 días.

¿Un tiempo de espera de un paso hace fallar el job?

Sí, a menos que el paso tenga continue-on-error: true.

¿Los minutos agotados por un tiempo de espera tienen coste?

Sí. El tiempo de los ejecutores alojados se factura por el periodo que el job estuvo en marcha antes de terminarse, así que un job bloqueado consume toda su duración.