...
Eroare Kubernetes · Containere care nu pornesc sau cad

CrashLoopBackOff (Last State: Terminated, Reason: Completed, Exit Code: 0)

Pe scurt

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

Greșit
YAML
kubectl create deployment curatare --image=busybox:1.36 -- sh -c "echo curat"
Corect
YAML
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ă

Greșit
YAML
kubectl create deployment unelte --image=busybox:1.36
Corect
YAML
kubectl create deployment unelte --image=busybox:1.36 -- sleep infinity

busybox fără comandă iese imediat; sleep ține containerul pornit.

3Server pornit în fundal

Greșit
YAML
        command: ["sh", "-c", "nginx & echo pornit"]
Corect
YAML
        command: ["nginx", "-g", "daemon off;"]

Procesul principal trebuie să rămână în prim-plan; altfel containerul se încheie.

Repară tu

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 "...".

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

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.