Saltar al contenido

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

  1. Use runners efímeros para que se cree un runner por job y un escalado a la baja no lo reutilice.
  2. No ejecute jobs largos en instancias spot, salvo que volver a ejecutarlos sea barato.
  3. Drene un runner (impídale aceptar nuevos jobs) antes del mantenimiento, de los reinicios o de las actualizaciones.
  4. Configure alertas para los reinicios del servicio del runner y para los eventos de interrupción de la nube.
  5. 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.