Containerul s-a oprit cu Exited (137)
137 = 128 + 9: procesul principal a fost omorât cu SIGKILL, nu s-a oprit singur. Cauzele: docker kill, docker stop care a așteptat degeaba 10 secunde sau lipsa de memorie (OOMKilled). Verifică cu docker inspect -f '{{.State.OOMKilled}}' nume și, pentru servicii, setează o politică de repornire.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codurile de ieșire peste 128 înseamnă „omorât de un semnal”: codul minus 128 e numărul semnalului. 137 corespunde lui SIGKILL (9), semnalul care oprește procesul instantaneu, fără să-l lase să facă ceva. (Similar, 143 = SIGTERM, oprire normală cerută.)
Cine trimite SIGKILL: docker kill, docker rm -f, docker stop după ce aplicația n-a răspuns în 10 secunde la SIGTERM, sau kernelul, când containerul a depășit limita de memorie (-m, mem_limit) sau calculatorul a rămas fără memorie. În ultimul caz, docker inspect arată "OOMKilled": true.
Dacă ai oprit tu containerul, 137 e normal. Dacă s-a întâmplat singur, verifică OOMKilled și consumul cu docker stats; pentru servicii, o politică de repornire (unless-stopped) le readuce automat după un crash.
De ce apare: cauzele frecvente
1Containerul a fost oprit forțat
docker kill cache
# Exited (137)docker stop cache # SIGTERM, oprire curată
docker start cachedocker kill trimite direct SIGKILL. Pentru oprire normală folosește docker stop, care îi dă aplicației timp să se închidă.
2Limita de memorie e prea mică (OOMKilled)
docker run -d --name api -m 64m magazin-api:1.0docker inspect -f '{{.State.OOMKilled}}' api
docker rm api
docker run -d --name api -m 512m magazin-api:1.0Peste limită, kernelul omoară procesul cu SIGKILL. OOMKilled=true confirmă cauza; mărești limita sau reduci consumul aplicației.
3Aplicația ignoră SIGTERM, iar docker stop expiră
CMD npm start # forma shell, semnalul nu ajunge la nodeCMD ["node", "server.js"]În forma shell, procesul principal e /bin/sh, care nu transmite SIGTERM. După 10 secunde Docker trimite SIGKILL, iar codul devine 137.
Repară eroarea, direct în pagină
Containerul de cache cache (redis:7) apare Exited (137). Află cu docker inspect codul de ieșire și dacă a fost oprit din lipsă de memorie (OOMKilled), pornește-l din nou și setează-i politica de repornire unless-stopped, ca să revină singur după un crash.
Indiciu
docker inspect -f '{{.State.ExitCode}} {{.State.OOMKilled}}' cache; politica o schimbi pe containerul existent cu docker update --restart unless-stopped cache.
Reparația
Codul și cauza:
docker inspect -f '{{.State.ExitCode}} {{.State.OOMKilled}}' cache137 falseNu a fost lipsă de memorie, ci un SIGKILL. Pornește containerul și setează politica de repornire:
docker start cache
docker update --restart unless-stopped cache
docker ps --filter name=cacheDe ce merge
Codul 137 cu OOMKilled=false înseamnă că procesul a primit SIGKILL din afară (aici, un docker kill), nu că a rămas fără memorie. Containerul nu are nimic stricat, deci docker start îl repornește cu aceeași configurare și cu datele lui. docker update --restart unless-stopped schimbă politica de repornire fără să recreezi containerul.
Alte forme ale mesajului
Exited (137) 5 seconds agoExited (143) 2 seconds ago"OOMKilled": true
Cum o eviți pe viitor
- Folosește forma exec la CMD/ENTRYPOINT, ca aplicația să primească SIGTERM și să se oprească singură, curat.
- Setează limite de memorie realiste și urmărește consumul cu
docker stats --no-stream. - Pentru servicii, adaugă
--restart unless-stopped(saurestart: unless-stoppedîn compose.yaml). - Oprește containerele cu
docker stop, nu cudocker kill, mai ales bazele de date.
Întrebări frecvente
Cum aflu sigur dacă a fost lipsă de memorie?
docker inspect -f '{{.State.OOMKilled}} {{.State.ExitCode}}' nume. Dacă vezi true 137, kernelul l-a oprit pentru memorie. false 137 înseamnă un SIGKILL din altă parte, de obicei o comandă docker.
Politica de repornire repornește și un container oprit de mine?
Cu unless-stopped, nu: un container oprit manual rămâne oprit, chiar și după restartul daemon-ului. Cu always, pornește din nou la restartul daemon-ului.
Erori înrudite
Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Containerul se oprește imediat după docker run -d: Exited (0) Exited (0) înseamnă că procesul principal al containerului s-a terminat cu succes, deci containerul s-a oprit normal. Un container trăiește cât procesul lui: pentru un shell care să rămână pornit folosește docker run -dit (sau o comandă care nu se termină), iar pentru un server verifică dacă CMD pornește serverul în prim-plan. no space left on device Discul pe care Docker își ține datele (/var/lib/docker sau discul virtual al Docker Desktop) e plin. Vezi ce ocupă spațiul cu docker system df, apoi șterge containerele oprite, imaginile nefolosite și cache-ul de build: docker container prune, docker image prune, docker builder prune. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
