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

Error: ErrImagePull

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Înainte să pornească un container, kubelet-ul de pe nod descarcă imaginea din registry (prin containerd). ErrImagePull e statusul afișat imediat după o încercare eșuată, iar Error: ErrImagePull apare în evenimente. Kubelet-ul reîncearcă, cu pauze tot mai mari, iar între încercări statusul este ImagePullBackOff.

Statusul în sine nu spune cauza. Ea e în evenimentul Failed de dinaintea lui, din kubectl describe pod: not found (tag sau imagine inexistentă), pull access denied (repository inexistent sau privat), 401 Unauthorized (lipsesc datele de acces), no such host sau i/o timeout (registry inaccesibil din nod).

La un Deployment, rolling update-ul păstrează podurile vechi în funcțiune cât timp cele noi nu pornesc, deci aplicația nu cade, dar actualizarea rămâne blocată.

De ce apare: cauzele frecvente

1Tag greșit

Greșit
YAML
kubectl set image deploy/clinica nginx=nginx:1.72
Corect
YAML
kubectl set image deploy/clinica nginx=nginx:1.27

1.72 nu există în registry, deci descărcarea eșuează mereu.

2Nume de imagine scris greșit

Greșit
YAML
image: ngnix:1.27
Corect
YAML
image: nginx:1.27

Un repository inexistent dă pull access denied.

3Registry privat fără date de acces

Greșit
YAML
image: registry.academia.ro/magazin-privat:1.0
Corect
YAML
kubectl create secret docker-registry regcred ...
# imagePullSecrets: [{name: regcred}]

Registry-ul cere autentificare; kubelet-ul o primește din imagePullSecrets.

Repară tu

Repară eroarea, direct în pagină

După o actualizare grăbită, Deploymentul clinica (site-ul unei clinici stomatologice) are poduri noi în ErrImagePull. Citește evenimentele unui pod nou ca să vezi imaginea încercată, corectează tag-ul la nginx:1.27 și verifică faptul că actualizarea se încheie.

Indiciu

În evenimentele podului, linia Failed to pull image arată imaginea exactă.

Alte forme ale mesajului

  • Error: ImagePullBackOff
  • Failed to pull image "nginx:1.72": rpc error: code = NotFound desc = failed to pull and unpack image "docker.io/library/nginx:1.72": ...

Cum o eviți pe viitor

  • Folosește tag-uri exacte, verificate (nginx:1.27), nu latest și nu tag-uri scrise din memorie.
  • Verifică existența tag-ului înainte de livrare (docker pull sau pagina registry-ului).
  • Pentru registry-uri private, pune imagePullSecrets în șablon sau pe ServiceAccount.
  • Urmărește livrarea cu kubectl rollout status, ca să vezi imediat dacă podurile noi nu pornesc.

Întrebări frecvente

Care e diferența dintre ErrImagePull și ImagePullBackOff?

ErrImagePull e starea imediat după o încercare eșuată. ImagePullBackOff e pauza dintre încercări, care crește până la 5 minute. Cauza e aceeași.

Se rezolvă singur?

Doar dacă problema era temporară (rețea, registry căzut). Un tag inexistent nu apare niciodată, deci trebuie corectată imaginea.

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.