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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Docker Hub și alte registry-uri răspund la fel pentru un repository care nu există și pentru unul privat la care nu ai acces: „pull access denied, repository does not exist or may require authorization”. Din motive de securitate, nu îți spun care dintre ele e cazul.
De aceea verifică întâi numele. Greșeli dese: o literă (magazn), organizația lipsă (magazin:v1 în loc de academia/magazin:v1, deci se caută library/magazin), majuscule (numele de repository trebuie să fie cu litere mici), sau registry-ul omis pentru o imagine care nu e pe Docker Hub (magazin-privat:1.0 în loc de registry.academia.ro/magazin-privat:1.0).
Dacă numele e sigur corect, imaginea e privată: creează un Secret de tip docker-registry și pune-l în imagePullSecrets.
De ce apare: cauzele frecvente
1Literă greșită în numele repository-ului
image: academia/magazn:v1 image: academia/magazin:v1magazn nu există, iar registry-ul răspunde ca pentru un repository privat.
2Lipsește organizația
image: magazin:v1 image: academia/magazin:v1Fără organizație, Docker Hub caută în library/, unde sunt doar imaginile oficiale.
3Majuscule în nume
image: Nginx:1.27 image: nginx:1.27Numele de repository sunt doar cu litere mici.
Repară eroarea, direct în pagină
API-ul unui magazin de instrumente muzicale nu pornește: podurile Deploymentului magazin stau în ImagePullBackOff cu pull access denied. Află din evenimente ce imagine se încearcă, corectează numele repository-ului la academia/magazin:v1 și verifică pornirea.
Indiciu
Compară numele imaginii din evenimente cu academia/magazin, literă cu literă.
Reparația
Imaginea încercată și răspunsul registry-ului:
kubectl describe pod -l app=magazin | grep 'Failed to pull' | tail -1 Warning Failed 20s (x2 over 31s) kubelet 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 failedNumele corect:
kubectl set image deployment/magazin magazn=academia/magazin:v1
kubectl rollout status deployment/magazindeployment.apps/magazin image updated
Waiting for deployment "magazin" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "magazin" rollout to finish: 0 of 2 updated replicas are available...
Waiting for deployment "magazin" rollout to finish: 1 of 2 updated replicas are available...
deployment "magazin" successfully rolled outDe ce merge
Registry-ul răspunde la fel pentru un repository inexistent și pentru unul privat, așa că întâi verifici numele. Aici e scris magazn, fără i. Cu academia/magazin:v1, imaginea publică se descarcă, iar podurile pornesc. Doar dacă numele ar fi fost corect, următorul pas ar fi fost un imagePullSecret.
Alte forme ale mesajului
Failed to pull image "Nginx": ... pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failedError response from daemon: pull access denied for magazin, repository does not exist or may require 'docker login'
Cum o eviți pe viitor
- Copiază numele complet al imaginii din registry (inclusiv organizația și registry-ul), nu-l rescrie.
- Ține numele imaginilor în variabile ale pipeline-ului, folosite și la push, și la deploy.
- Pentru imagini private, configurează o dată
imagePullSecretspe ServiceAccount-ul namespace-ului. - Testează numele cu
docker pullde pe calculatorul tău.
Întrebări frecvente
De ce registry-ul nu spune clar „nu există”?
Ca să nu dezvăluie existența repository-urilor private. Pentru cineva fără acces, un repository privat și unul inexistent arată identic.
Ce înseamnă insufficient_scope?
Token-ul primit de la registry (anonim, aici) nu are drept de citire pe acel repository, fie pentru că nu există, fie pentru că e privat.
Erori înrudite
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. Failed to pull image "registry.academia.ro/magazin-privat:1.0": failed to pull and unpack image "registry.academia.ro/magazin-privat:1.0": failed to resolve reference "registry.academia.ro/magazin-privat:1.0": failed to authorize: failed to fetch anonymous token: unexpected status from GET request to https://registry.academia.ro/token?scope=repository%3Amagazin-privat%3Apull&service=registry.academia.ro: 401 Unauthorized Imaginea e într-un registry privat, iar kubelet-ul a încercat să o descarce fără autentificare. Creează un Secret de tip docker-registry cu datele de acces și adaugă-l în spec.imagePullSecrets al podului (sau pe ServiceAccount). 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. Î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.
