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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CrashLoopBackOff nu e o eroare anume, ci un simptom: procesul principal al containerului se termină (cu eroare sau chiar cu succes), kubelet-ul îl repornește conform restartPolicy: Always, iar după fiecare cădere așteaptă mai mult: 10 s, 20 s, 40 s, până la 5 minute. Coloana RESTARTS crește la fiecare încercare.
Cauza se află în trei locuri. Jurnalul containerului căzut: kubectl logs POD --previous (fără --previous vezi containerul curent, care poate abia a pornit). Codul de ieșire și motivul, în kubectl describe pod, la Last State: Error cu codul aplicației, OOMKilled cu 137, Completed cu 0. Evenimentele: probe de liveness eșuate, care omoară containerul din afară.
Cauze frecvente: lipsește o variabilă de mediu sau o parolă, aplicația nu se poate conecta la o dependență și iese, un fișier de configurare lipsește, comanda e greșită.
De ce apare: cauzele frecvente
1Lipsește o variabilă obligatorie
kubectl create deployment api --image=academia/api:1.0
kubectl set env deploy/api DB_HOST=postgreskubectl create secret generic api-db --from-literal=DB_PASSWORD=...
kubectl set env deploy/api --from=secret/api-dbAplicația iese la pornire dacă nu are parola bazei de date; jurnalul spune exact asta.
2Citești jurnalul greșit
kubectl logs api-6d8f7c9b5-x2kq9kubectl logs api-6d8f7c9b5-x2kq9 --previousContainerul curent poate să nu fi scris nimic; eroarea e în rularea anterioară.
3Ștergi podul în speranța că se repară
kubectl delete pod api-6d8f7c9b5-x2kq9kubectl logs deploy/api --previous
# repară configurarea în DeploymentDeploymentul creează un pod identic, care cade la fel.
Repară eroarea, direct în pagină
API-ul unui serviciu de livrări (api, academia/api:1.0, cu DB_HOST=postgres) stă în CrashLoopBackOff. Citește jurnalul rulării care a căzut, află ce lipsește, pune valoarea Livrari2026 într-un Secret api-db (cheia DB_PASSWORD) și dă-l Deploymentului ca variabilă de mediu.
Indiciu
kubectl logs deploy/api --previous arată mesajul aplicației; kubectl set env --from=secret/... încarcă cheile unui Secret.
Reparația
Starea și jurnalul rulării căzute:
kubectl get pods -l app=api
kubectl logs deploy/api --previous --tail=2NAME READY STATUS RESTARTS AGE
api-qfv6d5vdq4-ml9zp 0/1 CrashLoopBackOff 3 (15s ago) 63s
Eroare: variabila DB_PASSWORD lipsește (pune parola bazei de date într-un Secret și dă-o containerului prin env).Secret-ul și variabila:
kubectl create secret generic api-db --from-literal=DB_PASSWORD=Livrari2026
kubectl set env deployment/api --from=secret/api-db
kubectl rollout status deployment/api
kubectl get pods -l app=apisecret/api-db created
deployment.apps/api env updated
Waiting for deployment "api" rollout to finish: 0 of 1 updated replicas are available...
deployment "api" successfully rolled out
NAME READY STATUS RESTARTS AGE
api-6bl7p4n9vq-ffndg 1/1 Running 0 4sDe ce merge
Kubelet-ul repornește containerul de fiecare dată când procesul iese, iar pauzele cresc. Jurnalul anterior spune motivul: lipsește DB_PASSWORD. Parola ține de un Secret, nu de manifest; set env --from=secret/api-db pune cheia ca variabilă în șablon, iar podurile noi pornesc cu ea.
Alte forme ale mesajului
Warning BackOff kubelet Back-off restarting failed containerSTATUS: CrashLoopBackOff
Cum o eviți pe viitor
- Fă aplicația să scrie un mesaj clar la pornire când îi lipsește ceva (variabilă, fișier, conexiune).
- Validează configurarea în pipeline, nu în producție: aceleași variabile, aceleași Secret-uri.
- Urmărește fiecare livrare cu
kubectl rollout status; un rollout blocat arată imediat podurile căzute. - Pune alerte pe numărul de restarturi al podurilor.
Întrebări frecvente
De ce containerul meu pornește bine local, dar cade în Kubernetes?
De obicei din cauza mediului: variabile de mediu lipsă, fișiere care nu sunt montate, dependențe (baze de date, servicii) inaccesibile sub numele folosite local, limite de memorie.
Ce înseamnă numărul din paranteză la RESTARTS, de exemplu 4 (30s ago)?
Câte reporniri au fost și cât timp a trecut de la ultima. Dacă numărul crește continuu, containerul nu rezistă pornit.
Erori înrudite
Error: Cannot find module './config.json' Aplicația Node din container nu găsește un fișier pe care îl încarcă la pornire, deci iese cu eroare, iar podul ajunge în CrashLoopBackOff. Dacă a apărut după o versiune nouă, întoarce Deploymentul la revizia anterioară (kubectl rollout undo) și repară imaginea; dacă fișierul e configurare, montează-l dintr-un ConfigMap. Error: Database is uninitialized and superuser password is not specified. Imaginea oficială postgres refuză să pornească fără parola superutilizatorului. Dă-i variabila POSTGRES_PASSWORD, ideal dintr-un Secret (secretKeyRef); containerul pornește la următoarea încercare. Last State: Terminated, Reason: OOMKilled, Exit Code: 137 Containerul a depășit limita de memorie (resources.limits.memory), iar kernel-ul l-a oprit forțat. Mărește limita la un nivel realist pentru aplicație sau reduce consumul de memorie; codul 137 înseamnă oprire cu SIGKILL. Î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.
