...
Eroare Kubernetes · Imagini: ErrImagePull și 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

Pe scurt

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.

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

Ce înseamnă

Mesajul complet vine de la containerd, prin kubelet. Citește-l de la coadă: docker.io/library/nginx:1.99: not found înseamnă că registry-ul a răspuns, a găsit repository-ul library/nginx, dar nu are tag-ul 1.99. docker.io/library/ e completarea automată pentru imaginile oficiale de pe Docker Hub scrise scurt (nginx).

Cauzele tipice: o versiune inventată sau scrisă invers (1.72 în loc de 1.27), un tag care a fost șters, un tag cu prefix (v1.2.0 față de 1.2.0) sau o imagine construită local care nu a fost încă publicată (docker push uitat în pipeline).

Spre deosebire de pull access denied, aici numele imaginii e bun; doar tag-ul trebuie corectat.

De ce apare: cauzele frecvente

1Versiune inexistentă

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

Tag-ul 1.99 nu a fost publicat niciodată.

2Prefixul v uitat sau pus în plus

Greșit
YAML
    image: academia/magazin:1
Corect
YAML
    image: academia/magazin:v1

Tag-urile sunt șiruri exacte: v1 și 1 sunt diferite.

3Imaginea nu a fost publicată

Greșit
YAML
docker build -t registry.intern.ro/api:2.0 .
kubectl set image deploy/api api=registry.intern.ro/api:2.0
Corect
YAML
docker build -t registry.intern.ro/api:2.0 .
docker push registry.intern.ro/api:2.0
kubectl set image deploy/api api=registry.intern.ro/api:2.0

Nodurile descarcă din registry; o imagine doar locală nu e acolo.

Repară tu

Repară eroarea, direct în pagină

Fișierul ~/k8s/web.yaml al site-ului unei pensiuni folosește nginx:1.99, iar podurile stau în ErrImagePull cu not found. Corectează tag-ul în fișier la nginx:1.27, aplică-l și verifică faptul că pornesc ambele replici.

Indiciu

Schimbă doar tag-ul imaginii în fișier, apoi kubectl apply -f.

Alte forme ale mesajului

  • failed to resolve reference "docker.io/academia/magazin:dev": docker.io/academia/magazin:dev: not found
  • manifest for nginx:1.99 not found: manifest unknown: manifest unknown

Cum o eviți pe viitor

  • Ia tag-urile din registry sau din pagina oficială a imaginii, nu din memorie.
  • În pipeline, fă deploy doar după un docker push reușit, cu același tag.
  • Fixează versiunile în fișiere și schimbă-le prin pull request, ca să le vadă și altcineva.
  • Testează imaginea nouă într-un mediu de test înainte de producție.

Întrebări frecvente

Ce înseamnă docker.io/library?

Registry-ul implicit (Docker Hub) și spațiul imaginilor oficiale. nginx:1.27 e de fapt docker.io/library/nginx:1.27.

Cum văd tag-urile disponibile?

Pe pagina imaginii din registry (Docker Hub, GitHub Packages, registry-ul firmei) sau cu unelte precum skopeo list-tags docker://nginx.

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.