...
Eroare Kubernetes · Imagini: ErrImagePull și ImagePullBackOff

Back-off pulling image "academia/magazin:v4"

Pe scurt

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ă

Greșit
YAML
kubectl set image deploy/magazin magazin=academia/magazin:v4
Corect
YAML
kubectl set image deploy/magazin magazin=academia/magazin:v2

v4 nu a fost publicată; v2 există în registry.

2Aștepți să se rezolve singur

Greșit
YAML
kubectl get pods -w   # ImagePullBackOff de 20 de minute
Corect
YAML
kubectl 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

Greșit
YAML
image: nginx:1.27   # toomanyrequests
Corect
YAML
image: registry.intern.ro/mirror/nginx:1.27

Un mirror propriu sau autentificarea la Docker Hub elimină limita pentru utilizatori anonimi.

Repară tu

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.

Alte forme ale mesajului

  • Error: ImagePullBackOff
  • Warning 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

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