Process Completed With Exit Code 143: SIGTERM Fix
Última actualización:
Process completed with exit code 143 significa que a un proceso se le pidió que se detuviera con SIGTERM. El número es 128 más 15, y 15 es la señal SIGTERM. A diferencia de exit code 137, que es un kill forzado, SIGTERM es una petición amable que el proceso puede capturar y limpiar después. En GitHub Actions, algo le indicó a su step que se detuviera: normalmente una ejecución cancelada, un timeout o el apagado del runner.
El mensaje exacto
Error: Process completed with exit code 143.
Es posible que vea Terminated impreso justo encima, y a menudo The operation was canceled cerca del final del log.
Causas, de la más probable a la menos probable
1. La ejecución fue cancelada
Alguien canceló la ejecución, o un grupo de concurrency del workflow con cancel-in-progress: true la canceló porque empezó una ejecución más reciente. El step que se estaba ejecutando en ese momento termina con 143.
concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
Este es un comportamiento previsto para los builds de pull request, pero peligroso en los workflows de deploy. No cancele un deploy a medio camino: use cancel-in-progress: false allí. Consulte The operation was canceled.
2. Un job o step alcanzó timeout-minutes
Cuando un job o step supera su timeout-minutes, GitHub lo termina. Compare la duración del job con el límite que configuró y consulte timeout-minutes.
3. El runner se está apagando
En los runners autoalojados, un servicio detenido, un reinicio o una reducción de escala envía SIGTERM al job. Consulte The runner has received a shutdown signal.
4. docker stop o un contenedor que se reemplaza
docker stop envía primero SIGTERM y, tras un periodo de gracia (10 segundos por defecto), fuerza el kill. Un contenedor cuyo proceso principal ignora SIGTERM termina con 137, y uno que lo gestiona termina con 143 o 0.
5. Su propio script lo envió
kill, pkill y timeout envían SIGTERM por defecto. Un pkill node que coincida con más procesos de los previstos también detendrá la herramienta de build.
Gestione SIGTERM en sus propios scripts
Para limpiar cuando se detenga el job, capture la señal:
- run: |
cleanup() { echo "stopping"; docker compose down; }
trap cleanup TERM INT
./long-running-task.sh &
wait $!
Para los steps que deben ejecutarse incluso cuando el job se cancela, use if: always() o if: cancelled():
- name: Stop services
if: always()
run: docker compose down
Un job cancelado dispone de un breve margen para ejecutar estos steps, así que mantenga la limpieza rápida.
Cómo prevenirlo
- Use
cancel-in-progresssolo en workflows que puedan interrumpirse sin riesgo. - Defina
timeout-minutescon margen por encima del tiempo de ejecución habitual. - Haga que las tareas largas puedan reanudarse y capture SIGTERM para liberar locks y contenedores.
- En los runners autoalojados, vacíe el runner antes de reiniciar.
- Sea específico en los comandos
pkillykill.
Preguntas frecuentes
¿Qué significa el código de salida 143?
El proceso recibió SIGTERM (128 + 15). Se le pidió que terminara, y terminó.
¿El código de salida 143 es un error en mi código?
Normalmente no. Indica que algo externo al step lo detuvo. Revise primero la cancelación, los timeouts y el runner.
¿Cuál es la diferencia entre 137 y 143?
137 es SIGKILL, que no puede capturarse y es típico de los kills por falta de memoria. 143 es SIGTERM, que un proceso puede capturar y gestionar.
¿Por qué un job que pasaba terminó con 143?
Si un step posterior falló y el workflow canceló el trabajo restante, o un job hermano de una matriz con fail-fast: true falló, los jobs en ejecución se cancelan y pueden terminar con 143. Configure fail-fast: false si quiere que terminen.
Relacionado
- Proceso completado con código de salida 1: cómo depurarlo"Process completed with exit code 1" en GitHub Actions indica que un comando ha fallado. Cómo encontrar el error real, depurarlo y corregir causas comunes.
- Process Completed With Exit Code 127: Command Not FoundSolucione "Process completed with exit code 127" en GitHub Actions: comando no encontrado. Herramientas ausentes, PATH entre pasos y finales de línea CRLF.
- El proceso '/usr/bin/git' falló con el código de salida 128Corrija "The process '/usr/bin/git' failed with exit code 128" en GitHub Actions: autenticación, refs ausentes, clones superficiales y propiedad dudosa.
- Código de salida 137 en GitHub Actions: solución de memoriaProcess completed with exit code 137 en GitHub Actions indica SIGKILL, normalmente por falta de memoria. Soluciones para Node, Jest, Gradle y Docker.