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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul 1 este codul generic de eroare: procesul principal a pornit, a întâlnit o problemă și a ieșit. Docker nu știe ce s-a întâmplat în aplicație, dar a păstrat tot ce a scris ea pe ecran, așa că răspunsul e aproape mereu în docker logs nume.
Containerul oprit rămâne în docker ps -a (dacă nu l-ai pornit cu --rm), cu jurnalul întreg. Ce cauți în jurnal: Error: Cannot find module '/app/server.js' (Node, cale greșită în CMD), ModuleNotFoundError (Python, pachet neinstalat), can't open file (fișier lipsă), mesaje despre variabile lipsă (DATABASE_URL is not set) sau o excepție din codul tău.
Dacă jurnalul e gol, pornește un shell în aceeași imagine (docker run --rm -it imagine sh) și rulează CMD de mână: vezi eroarea direct și poți verifica ce fișiere există.
De ce apare: cauzele frecvente
1Calea din CMD nu se potrivește cu fișierele copiate
COPY src/ ./src/
CMD ["node", "raport.js"]COPY src/ ./src/
CMD ["node", "src/raport.js"]Fișierul e în /app/src/raport.js, dar CMD caută /app/raport.js. Node iese cu Cannot find module și codul 1.
2Dependențele nu sunt instalate în imagine
COPY . .
CMD ["python", "app.py"] # ModuleNotFoundError: flaskCOPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "app.py"]Pachetele de pe calculatorul tău nu ajung în imagine. Trebuie instalate în Dockerfile.
3Lipsește o variabilă de mediu obligatorie
docker run -d --name api magazin-api:1.0docker run -d --name api -e DATABASE_URL=postgres://... magazin-api:1.0Multe aplicații (și imagini ca postgres sau mysql) refuză să pornească fără configurarea minimă și ies cu 1.
Repară eroarea, direct în pagină
În ~/rapoarte ai imaginea rapoarte:1.0, care trebuie să afișeze raportul zilnic și să se termine cu succes. Containerul raport se oprește însă cu Exited (1). Citește jurnalul, repară CMD din Dockerfile (codul e în src/raport.js), reconstruiește imaginea și rulează din nou containerul raport, care trebuie să se termine cu codul 0.
Indiciu
docker logs raport arată ce fișier caută Node; containerul vechi trebuie șters înainte să refolosești numele.
Reparația
Cauza, în jurnal:
docker logs raportError: Cannot find module '/app/raport.js'Repară CMD, reconstruiește și rulează din nou:
sed -i 's|"raport.js"|"src/raport.js"|' Dockerfile
docker build -t rapoarte:1.0 .
docker rm raport
docker run --name raport rapoarte:1.0Raport zilnic: 14 comenzi noiDe ce merge
Dockerfile-ul copiază codul în /app/src/, dar CMD rulează node raport.js, adică /app/raport.js, care nu există. Node iese cu Cannot find module și codul 1. După ce CMD devine ["node", "src/raport.js"] și reconstruiești imaginea, containerul nou afișează raportul și se termină cu 0, cum trebuie pentru un job.
Alte forme ale mesajului
Exited (1) 3 seconds agoRestarting (1) 5 seconds agoExited (2) 1 second ago
Cum o eviți pe viitor
- Testează imaginea imediat după build cu
docker run --rm imagineîn prim-plan: vezi eroarea pe loc. - Ține CMD sincronizat cu structura folderelor din imagine (
docker run --rm imagine ls -R /appîți arată ce s-a copiat). - Instalează dependențele în Dockerfile, din fișierul de dependențe (package.json, requirements.txt).
- Documentează variabilele obligatorii și dă-le valori implicite cu
ENVacolo unde e posibil.
Întrebări frecvente
Ce înseamnă Restarting (1)?
Containerul are o politică de repornire (--restart always sau on-failure) și crapă la fiecare pornire cu codul 1, deci Docker îl tot repornește. Cauza se află tot în docker logs.
Diferența dintre Exited (1) și Exited (137)?
1 e o eroare raportată de aplicația ta. 137 = 128 + 9: procesul a fost omorât din afară cu SIGKILL (docker kill, lipsă de memorie sau docker stop care a expirat).
Erori înrudite
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. Error: Database is uninitialized and superuser password is not specified. Imaginea oficială postgres refuză să pornească fără parolă pentru utilizatorul postgres și se oprește cu Exited (1). Pornește containerul cu -e POSTGRES_PASSWORD=parola (în compose: environment: POSTGRES_PASSWORD). 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. Î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.
