Back-off pulling image "academia/magazin:v4"
Kubelet-ul a încercat de mai multe ori să descarce imaginea, a eșuat și acum așteaptă înainte de încercarea următoare (ImagePullBackOff). Caută în evenimente motivul primei erori (not found, pull access denied, 401) și corectează imaginea; nu ajută să aștepți.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ImagePullBackOff și evenimentul Back-off pulling image înseamnă că descărcarea imaginii a eșuat deja (o dată sau de mai multe ori), iar kubelet-ul a intrat în așteptare exponențială: 10 secunde, apoi 20, 40, până la 5 minute între încercări. Coloana RESTARTS rămâne 0, pentru că niciun container nu a pornit.
Așteptarea e utilă doar pentru probleme trecătoare: registry suprasolicitat, limită de descărcări atinsă, rețea întreruptă. Pentru o imagine sau un tag care nu există, nu se va rezolva niciodată.
Cauza reală e în evenimentul Failed to pull image ... din kubectl describe pod, chiar deasupra liniei cu back-off. După ce corectezi imaginea într-un Deployment, se creează poduri noi, care încearcă imediat, fără să moștenească pauza.
De ce apare: cauzele frecvente
1Versiune care încă nu există
kubectl set image deploy/magazin magazin=academia/magazin:v4kubectl set image deploy/magazin magazin=academia/magazin:v2v4 nu a fost publicată; v2 există în registry.
2Aștepți să se rezolve singur
kubectl get pods -w # ImagePullBackOff de 20 de minutekubectl describe pod POD | grep 'Failed to pull'Pauza crește până la 5 minute, dar cauza rămâne. Citește motivul.
3Limită de descărcări Docker Hub
image: nginx:1.27 # toomanyrequestsimage: registry.intern.ro/mirror/nginx:1.27Un mirror propriu sau autentificarea la Docker Hub elimină limita pentru utilizatori anonimi.
Repară eroarea, direct în pagină
Deploymentul magazin al unui anticariat a fost actualizat la academia/magazin:v4, dar podurile noi stau în ImagePullBackOff. Versiunea v4 nu a fost publicată încă; ultima versiune existentă e v2. Confirmă motivul din evenimente și treci Deploymentul pe academia/magazin:v2.
Indiciu
Linia Failed to pull image din kubectl describe pod arată ce răspunde registry-ul.
Reparația
Back-off și motivul:
kubectl get pods -l app=magazin
kubectl describe pod -l app=magazin | grep -E 'Failed to pull|Back-off' | tail -2NAME READY STATUS RESTARTS AGE
magazin-6sxg7xc4zs-75hkq 1/1 Running 0 82s
magazin-6sxg7xc4zs-vd7mj 1/1 Running 0 82s
magazin-s7rzpjdnr8-n48mb 0/1 ImagePullBackOff 0 63s
Warning Failed 31s (x3 over 63s) kubelet Failed to pull image "academia/magazin:v4": rpc error: code = NotFound desc = failed to pull and unpack image "docker.io/academia/magazin:v4": failed to resolve reference "docker.io/academia/magazin:v4": docker.io/academia/magazin:v4: not found
Normal BackOff 0s (x6 over 62s) kubelet Back-off pulling image "academia/magazin:v4"Versiunea existentă:
kubectl set image deployment/magazin magazin=academia/magazin:v2
kubectl rollout status deployment/magazindeployment.apps/magazin image updated
Waiting for deployment "magazin" rollout to finish: 0 out of 2 new replicas have been updated...
Waiting for deployment "magazin" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "magazin" rollout to finish: 1 old replicas are pending termination...
deployment "magazin" successfully rolled outDe ce merge
Back-off înseamnă doar că kubelet-ul așteaptă între încercări. Motivul real, not found, arată că v4 nu există în registry, deci nicio așteptare nu ajută. kubectl set image creează o revizie nouă cu v2, iar podurile noi descarcă imediat imaginea existentă.
Alte forme ale mesajului
Error: ImagePullBackOffWarning Failed kubelet Error: ImagePullBackOff
Cum o eviți pe viitor
- Publică imaginea în registry înainte să actualizezi Deploymentul (în pipeline: build, push, apoi deploy).
- Folosește tag-uri imutabile (versiune sau commit SHA), nu
latest. - Pentru clustere mari, folosește un mirror sau un cache de imagini, ca să nu atingi limitele registry-urilor publice.
- Monitorizează podurile în ImagePullBackOff după fiecare livrare.
Întrebări frecvente
Pot forța o încercare imediată?
Da, ștergând podul: controllerul creează unul nou, care încearcă imediat. Dar dacă imaginea e greșită, noul pod ajunge la fel.
De ce RESTARTS e 0?
Pentru că containerul nu a pornit niciodată: lipsește imaginea. Restarturile se numără doar după ce un container rulează și se oprește.
Erori înrudite
Error: ErrImagePull Kubelet-ul nu a putut descărca imaginea containerului. Motivul exact e în evenimentele podului (kubectl describe pod): tag inexistent (not found), nume greșit sau registry privat (pull access denied, 401 Unauthorized). Corectează imaginea sau datele de acces; după câteva încercări statusul devine ImagePullBackOff. Failed to pull image "nginx:1.99": rpc error: code = NotFound desc = failed to pull and unpack image "docker.io/library/nginx:1.99": failed to resolve reference "docker.io/library/nginx:1.99": docker.io/library/nginx:1.99: not found Repository-ul există, dar tag-ul cerut nu (aici nginx:1.99). Verifică tag-urile disponibile în registry și scrie unul real, de exemplu nginx:1.27; după corectare podurile pornesc. 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ă. Î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.
