El runner ha recibido una señal de apagado: solución
Última actualización:
The runner has received a shutdown signal significa que la máquina o el servicio que ejecutaba su job recibió la orden de detenerse mientras el job seguía en marcha. En los runners alojados por GitHub es poco frecuente. En los runners autoalojados casi siempre significa que algo externo al job detuvo el runner: una instancia spot recuperada por la nube, un autoescalador que reduce capacidad, un reinicio o un servicio detenido. Esta página le muestra cómo identificar cuál fue la causa y cómo evitar que se repita.
El mensaje exacto
Error: The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled.
Error: The operation was canceled.
La segunda línea suele aparecer después de la primera. Si solo ve The operation was canceled y la ejecución fue cancelada por una persona o por un push más reciente, lea The operation was canceled en su lugar.
Causas, de la más probable a la menos probable
1. Se recuperaron instancias spot o preemptible
Si sus runners autoalojados se ejecutan en máquinas virtuales spot, preemptible o de baja prioridad, la nube puede recuperar la máquina con poco aviso, y el runner recibe un apagado mientras hay un job en ejecución. Busque en el registro de eventos de su nube un evento de interrupción o terminación que coincida con el momento del fallo.
Solución: use instancias bajo demanda para los runners que ejecutan jobs largos, o mantenga los jobs cortos y seguros de volver a ejecutar. Consulte instancias spot para runners de CI.
2. Un autoescalador redujo el runner mientras estaba ocupado
La lógica de reducción que elimina runners inactivos según su antigüedad o su número puede eliminar uno que acaba de recibir un job. Con Actions Runner Controller (ARC), un pod también puede ser expulsado o reiniciado durante el drenado de un nodo o una actualización.
Solución: reduzca solo los runners que no reporten ningún job, use runners efímeros (un job y después se eliminan) y configure presupuestos de interrupción de pods y un periodo de gracia de terminación en los pods de runner de ARC.
3. Se detuvo el servicio del runner o la máquina se reinició
Compruebe el servicio en el host del runner:
sudo ./svc.sh status
sudo journalctl -u 'actions.runner.*' --since "2 hours ago" | tail -50
last -x reboot shutdown | head
Una actualización desatendida que reinicia el host, una herramienta de configuración que reinicia el servicio o alguien que pulsa Ctrl+C en un ./run.sh iniciado manualmente producirán este error.
Solución: programe los reinicios y las actualizaciones para cuando el runner esté drenado, y ejecute el runner como servicio en lugar de desde una terminal.
4. El host se quedó sin memoria o sin disco
Un host sin memoria puede terminar el propio proceso del runner. Revise dmesg en busca de Out of memory, y consulte hosted runner lost communication y exit code 137.
5. Se reemplazó un runner alojado por GitHub
Si solo utiliza runners alojados por GitHub y ningún job suyo detuvo la máquina, se trata de un fallo de infraestructura. Revise la página de estado de GitHub y vuelva a ejecutar los jobs fallidos.
Haga que el job sobreviva a una parada
No puede evitar que se recupere una máquina virtual, pero sí puede reducir el daño. Mantenga cada job corto, guarde resultados y cachés a medida que avanza, y haga que los pasos sean seguros de repetir. Un paso de limpieza que siempre debe ejecutarse debe usar if: always():
- name: Upload partial results
if: always()
uses: actions/upload-artifact@v4
with:
name: results-${{ matrix.shard }}
path: results/
Cómo prevenirlo
- Use runners efímeros para que se cree un runner por job y un escalado a la baja no lo reutilice.
- No ejecute jobs largos en instancias spot, salvo que volver a ejecutarlos sea barato.
- Drene un runner (impídale aceptar nuevos jobs) antes del mantenimiento, de los reinicios o de las actualizaciones.
- Configure alertas para los reinicios del servicio del runner y para los eventos de interrupción de la nube.
- Mantenga los jobs cortos. Dividir un job largo con una matrix reduce lo que cuesta una sola interrupción.
Preguntas frecuentes
¿Este error lo causa mi workflow?
Rara vez. El mensaje describe que el runner fue detenido desde fuera del job. Un paso bloqueado tiene más probabilidades de terminar en un timeout, no en una señal de apagado.
¿GitHub reintentará el job automáticamente?
No por defecto. Usted vuelve a ejecutar los jobs fallidos o añade su propia lógica de reintento alrededor del trabajo.
¿Esto ocurre en los runners alojados por GitHub?
Puede ocurrir, pero es poco común y suele estar vinculado a un incidente. Consulte la página de estado y vuelva a ejecutar.
¿En qué se diferencia del código de salida 143?
El código de salida 143 indica que un proceso recibió SIGTERM. Una señal de apagado en el runner suele terminar con 143 en el paso que se estaba ejecutando. Consulte exit code 143.
Relacionado
- Cache Service Responded With 429: Cómo solucionarloSolucione "Failed to restore: Cache service responded with 429" en GitHub Actions: demasiadas solicitudes de caché. Actualice actions/cache y restaure y guarde una vez.
- fatal: could not read Username for github.com: SoluciónSolucione "fatal: could not read Username for 'https://github.com'" en GitHub Actions: repos privados, submódulos y dependencias git necesitan un token.
- Archivo de flujo de trabajo no válido: cómo solucionar el error de sintaxis YAMLCorrija "Invalid workflow file" y "You have an error in your yaml syntax" en GitHub Actions: sangría, valor inesperado, expresiones erróneas, con actionlint.
- JavaScript Heap Out of Memory en GitHub Actions: soluciónSolucione "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" y npm ENOMEM en GitHub Actions con NODE_OPTIONS.