STATUS Init:CrashLoopBackOff (Back-off restarting failed container pregatire)
Un init container iese cu eroare, iar kubelet-ul îl repornește la nesfârșit, așa că aplicația nu pornește. Citește-i jurnalul cu kubectl logs POD -c NUME-INIT (adaugă --previous dacă e gol) și repară cauza: fișier lipsă, comandă greșită, dependență indisponibilă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Init containerele trebuie să se termine cu codul 0. Dacă unul iese cu eroare, kubelet-ul îl repornește (la Deployment, restartPolicy e Always), cu aceleași pauze crescătoare ca la orice CrashLoopBackOff. Statusul arată Init:CrashLoopBackOff sau Init:Error, iar containerele aplicației nu pornesc deloc.
Cauza e în jurnalul init containerului: kubectl logs POD -c pregatire. Exemple tipice: cp: cannot stat '/sursa/config.json': No such file or directory (o cheie lipsă din ConfigMap-ul montat), o migrare de bază de date care eșuează, un script cu permisiuni lipsă.
După ce repari cauza din afara podului (de exemplu adaugi cheia în ConfigMap), kubelet-ul reîncearcă singur la următoarea pornire a init containerului.
De ce apare: cauzele frecvente
1Fișier lipsă din ConfigMap-ul montat
kubectl create configmap config-app --from-literal=altceva=1
# init: cp /sursa/config.json /config/kubectl create configmap config-app --from-file=config.jsonFișierul apare în volum doar dacă ConfigMap-ul are cheia config.json.
2Migrare care cade
initContainers:
- name: migrare
command: ["migreaza", "--db", "$(DB_URL)"] # DB_URL lipsăinitContainers:
- name: migrare
envFrom:
- secretRef:
name: db-urlInit containerul are nevoie de propria configurare, nu o moștenește de la aplicație.
3Jurnalul aplicației în loc de init
kubectl logs apikubectl logs api -c pregatire --previousAplicația nu a pornit; eroarea e în init container.
Repară eroarea, direct în pagină
Podul site al unei galerii de artă are un init container pregatire care copiază config.json din ConfigMap-ul config-app într-un volum comun, dar podul stă în Init:CrashLoopBackOff. Citește jurnalul init containerului și adaugă în ConfigMap cheia config.json cu valoarea {"tema":"verde"}, păstrând cheia existentă altceva=1.
Indiciu
Recreează ConfigMap-ul cu ambele chei prin --dry-run=client -o yaml | kubectl apply -f -.
Reparația
Starea și jurnalul init containerului:
kubectl get pod site
kubectl logs site -c pregatireNAME READY STATUS RESTARTS AGE
site 0/1 Init:Error 3 44s
cp: cannot stat '/sursa/config.json': No such file or directoryAdaugă cheia lipsă:
kubectl create configmap config-app --from-literal=altceva=1 --from-literal=config.json='{"tema":"verde"}' --dry-run=client -o yaml | kubectl apply -f -
k8ssim avans 90
kubectl get pod site
kubectl exec site -- cat /config/config.jsonconfigmap/config-app configured
Au trecut 90 de secunde (ora clusterului: 10:02:24).
NAME READY STATUS RESTARTS AGE
site 1/1 Running 4 2m22s
{"tema":"verde"}De ce merge
Volumul ConfigMap conține câte un fișier pentru fiecare cheie. Fără cheia config.json, cp nu găsește fișierul și iese cu eroare, iar init containerul e repornit la nesfârșit. După ce adaugi cheia, la următoarea încercare fișierul există, copierea reușește, iar containerul aplicației pornește cu configurația copiată.
Alte forme ale mesajului
Init:ErrorBack-off restarting failed container migrare in pod init2_default
Cum o eviți pe viitor
- Scrie scripturile init să afișeze un mesaj clar înainte să iasă cu eroare.
- Livrează ConfigMap-urile și Secret-urile înaintea podurilor care le folosesc.
- Testează init containerele separat (
kubectl run -it --rmcu aceeași imagine și aceleași volume). - Ține init containerele mici și cu o singură responsabilitate.
Întrebări frecvente
Init containerele se repornesc și când aplicația repornește?
Nu. Ele rulează doar la crearea podului (sau la repornirea întregului pod). O repornire a containerului aplicației nu le reia.
Pot sări peste un init container care cade?
Nu fără să schimbi șablonul. Dacă pasul nu e esențial, scoate-l din podul aplicației și fă-l Job separat.
Erori înrudite
STATUS Init:0/1 (podul nu trece de init container) Init containerul podului nu s-a terminat încă, de obicei pentru că așteaptă o dependență care nu există (un Service, o bază de date). Citește-i jurnalul cu kubectl logs POD -c NUME-INIT și creează sau repară dependența; podul pornește singur după. 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: couldn't find key PROGRAM in ConfigMap default/setari ConfigMap-ul există, dar nu are cheia cerută de configMapKeyRef (aici PROGRAM). Adaugă cheia în ConfigMap sau corectează numele cheii din pod (contează literele mari și mici). Î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.
