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

STATUS Init:CrashLoopBackOff (Back-off restarting failed container pregatire)

Pe scurt

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

Greșit
YAML
kubectl create configmap config-app --from-literal=altceva=1
# init: cp /sursa/config.json /config/
Corect
YAML
kubectl create configmap config-app --from-file=config.json

Fișierul apare în volum doar dacă ConfigMap-ul are cheia config.json.

2Migrare care cade

Greșit
YAML
initContainers:
- name: migrare
  command: ["migreaza", "--db", "$(DB_URL)"]   # DB_URL lipsă
Corect
YAML
initContainers:
- name: migrare
  envFrom:
  - secretRef:
      name: db-url

Init containerul are nevoie de propria configurare, nu o moștenește de la aplicație.

3Jurnalul aplicației în loc de init

Greșit
YAML
kubectl logs api
Corect
YAML
kubectl logs api -c pregatire --previous

Aplicația nu a pornit; eroarea e în init container.

Repară tu

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

Alte forme ale mesajului

  • Init:Error
  • Back-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 --rm cu 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

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