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.
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ă
image: nginx:1.99 image: nginx:1.27Tag-ul 1.99 nu a fost publicat niciodată.
2Prefixul v uitat sau pus în plus
image: academia/magazin:1 image: academia/magazin:v1Tag-urile sunt șiruri exacte: v1 și 1 sunt diferite.
3Imaginea nu a fost publicată
docker build -t registry.intern.ro/api:2.0 .
kubectl set image deploy/api api=registry.intern.ro/api:2.0docker 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.0Nodurile descarcă din registry; o imagine doar locală nu e acolo.
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.
Reparația
Motivul:
kubectl get pods -l app=web
kubectl describe pod -l app=web | grep 'Failed to pull' | tail -1NAME READY STATUS RESTARTS AGE
web-wt868dww92-775ww 0/1 ImagePullBackOff 0 33s
web-wt868dww92-gfcxt 0/1 ImagePullBackOff 0 33s
Warning Failed 1s (x3 over 33s) kubelet 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 foundTag-ul corect în fișier:
sed -i 's/nginx:1.99/nginx:1.27/' web.yaml
kubectl apply -f web.yaml
kubectl rollout status deploy/webdeployment.apps/web configured
Waiting for deployment "web" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 0 of 2 updated replicas are available...
Waiting for deployment "web" rollout to finish: 1 of 2 updated replicas are available...
deployment "web" successfully rolled outDe ce merge
Registry-ul a găsit repository-ul nginx, dar nu tag-ul 1.99, deci nicio reîncercare nu poate reuși. Corectarea în fișier, nu doar cu kubectl set image, păstrează fișierul ca sursă a adevărului: la următorul apply, versiunea bună nu va fi suprascrisă de una greșită.
Alte forme ale mesajului
failed to resolve reference "docker.io/academia/magazin:dev": docker.io/academia/magazin:dev: not foundmanifest 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 pushreuș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
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 "academia/magazn:v1": failed to pull and unpack image "docker.io/academia/magazn:v1": failed to resolve reference "docker.io/academia/magazn:v1": pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failed Registry-ul nu găsește repository-ul imaginii sau nu îți permite accesul: numele e scris greșit, majuscule în nume, ori imaginea e privată. Verifică numele complet (registry/organizație/imagine) și, pentru imagini private, adaugă imagePullSecrets. 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. Î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.
