CrashLoopBackOff (Last State: Terminated, Reason: Completed, Exit Code: 0)
Procesul containerului se termină cu succes, dar podul face parte dintr-un Deployment, unde containerele trebuie să ruleze continuu, așa că e repornit la nesfârșit. Pentru o sarcină care se termină folosește un Job (sau CronJob); pentru un serviciu, asigură-te că procesul rămâne pornit în prim-plan.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un Deployment (și ReplicaSet, DaemonSet, StatefulSet) are restartPolicy: Always: orice container care se oprește, chiar cu cod 0, e pornit din nou. Dacă programul își face treaba și iese (un script, o migrare, un raport), rezultă Completed urmat de reporniri și, în final, CrashLoopBackOff.
În kubectl describe pod vezi Last State: Terminated, Reason: Completed, Exit Code: 0. Jurnalul arată de obicei că sarcina a reușit.
Cauze frecvente: o sarcină unică pusă greșit într-un Deployment; o imagine de bază fără proces de lungă durată (busybox, alpine, ubuntu fără comandă ies imediat); un server pornit în fundal (nginx &, service x start), după care scriptul principal se termină.
De ce apare: cauzele frecvente
1Sarcină unică într-un Deployment
kubectl create deployment curatare --image=busybox:1.36 -- sh -c "echo curat"kubectl create job curatare --image=busybox:1.36 -- sh -c "echo curat"Un Job rulează sarcina o dată și o marchează Complete, fără reporniri.
2Imagine de bază fără comandă
kubectl create deployment unelte --image=busybox:1.36kubectl create deployment unelte --image=busybox:1.36 -- sleep infinitybusybox fără comandă iese imediat; sleep ține containerul pornit.
3Server pornit în fundal
command: ["sh", "-c", "nginx & echo pornit"] command: ["nginx", "-g", "daemon off;"]Procesul principal trebuie să rămână în prim-plan; altfel containerul se încheie.
Repară eroarea, direct în pagină
Curățenia nocturnă a unui magazin online a fost pusă din greșeală într-un Deployment (curatare): scriptul se termină cu succes, dar podul intră în CrashLoopBackOff. Confirmă motivul (Completed, codul 0), șterge Deploymentul și rulează aceeași sarcină ca Job cu același nume (busybox:1.36, sh -c "echo curatare gata").
Indiciu
kubectl create job curatare --image=busybox:1.36 -- sh -c "...".
Reparația
Motivul:
kubectl get pods -l app=curatare
kubectl describe pod -l app=curatare | grep -A3 'Last State'NAME READY STATUS RESTARTS AGE
curatare-nqdw574tbr-rtc9w 0/1 CrashLoopBackOff 3 (20s ago) 63s
Last State: Terminated
Reason: Completed
Exit Code: 0
Started: Thu, 15 Jan 2026 10:00:45 +0200Job în loc de Deployment:
kubectl delete deployment curatare
kubectl create job curatare --image=busybox:1.36 -- sh -c "echo curatare gata"
kubectl wait --for=condition=complete job/curatare --timeout=60s
kubectl logs job/curataredeployment.apps "curatare" deleted
job.batch/curatare created
job.batch/curatare condition met
curatare gataDe ce merge
Deploymentul repornește orice container care se oprește, chiar și cu codul 0, deci o sarcină care se termină ajunge în CrashLoopBackOff. Job-ul e făcut pentru sarcini finite: rulează podul o dată, iar după ieșirea cu 0 marchează sarcina ca reușită și nu mai repornește nimic.
Alte forme ale mesajului
Back-off restarting failed container curatare in pod curatare-7b9c4d8f6-k2x9p_default
Cum o eviți pe viitor
- Alege tipul potrivit: Deployment pentru servicii care rulează continuu, Job pentru sarcini care se termină, CronJob pentru sarcini periodice.
- Pornește serverele în prim-plan (fără
&, fără opțiuni de daemon). - Pentru poduri de depanare cu imagini de bază, dă o comandă de lungă durată (
sleep 3600).
Întrebări frecvente
De ce scrie CrashLoopBackOff dacă nu a căzut nimic?
Pentru că pentru un Deployment orice oprire e o problemă: el trebuie să țină containerul pornit. Statusul descrie ciclul de reporniri, nu o eroare a programului.
Pot pune restartPolicy: Never într-un Deployment?
Nu, Deploymentul acceptă doar Always. Pentru alte politici folosești Job sau un pod simplu.
Erori înrudite
Back-off restarting failed container api in pod api-6d8f7c9b5-x2kq9_default Containerul pornește și se oprește iar și iar, iar kubelet-ul așteaptă tot mai mult între reporniri (CrashLoopBackOff). Cauza e aproape mereu în jurnalul rulării care a căzut: kubectl logs POD --previous. Repară configurarea sau codul care face procesul să iasă. error: cannot exec into a container in a completed pod; current phase is Succeeded Procesul principal al podului s-a terminat (faza Succeeded sau Failed), deci nu mai există niciun container în care să rulezi o comandă. Citește jurnalul cu kubectl logs, iar pentru depanare pornește un pod nou care rămâne activ (de exemplu cu sleep). The Job "import" is invalid: spec.template.spec.restartPolicy: Required value: valid values: "OnFailure", "Never" Podurile unui Job (și ale unui CronJob) trebuie să aibă restartPolicy Never sau OnFailure; valoarea implicită Always nu e permisă, pentru că un job trebuie să se poată termina. Adaugă restartPolicy: Never (sau OnFailure) în șablonul podului. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
