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

Back-off restarting failed container api in pod api-6d8f7c9b5-x2kq9_default

Pe scurt

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

Greșit
YAML
kubectl create deployment api --image=academia/api:1.0
kubectl set env deploy/api DB_HOST=postgres
Corect
YAML
kubectl create secret generic api-db --from-literal=DB_PASSWORD=...
kubectl set env deploy/api --from=secret/api-db

Aplicația iese la pornire dacă nu are parola bazei de date; jurnalul spune exact asta.

2Citești jurnalul greșit

Greșit
YAML
kubectl logs api-6d8f7c9b5-x2kq9
Corect
YAML
kubectl logs api-6d8f7c9b5-x2kq9 --previous

Containerul curent poate să nu fi scris nimic; eroarea e în rularea anterioară.

3Ștergi podul în speranța că se repară

Greșit
YAML
kubectl delete pod api-6d8f7c9b5-x2kq9
Corect
YAML
kubectl logs deploy/api --previous
# repară configurarea în Deployment

Deploymentul creează un pod identic, care cade la fel.

Repară tu

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.

Alte forme ale mesajului

  • Warning BackOff kubelet Back-off restarting failed container
  • STATUS: 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

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