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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru fiecare descărcare, containerd cere întâi un token de la registry. Fără date de acces, cere unul anonim, iar un registry privat îl refuză cu 401 Unauthorized. Bucata scope=repository:magazin-privat:pull arată ce încerca să facă: să citească repository-ul magazin-privat.
Kubelet-ul nu folosește docker login de pe calculatorul tău. Datele de acces trebuie date clusterului, ca Secret de tip kubernetes.io/dockerconfigjson, creat cu kubectl create secret docker-registry, în același namespace cu podul, și referit din imagePullSecrets.
Dacă Secret-ul există, dar eroarea persistă, verifică: numele din imagePullSecrets, namespace-ul Secret-ului, serverul din Secret (trebuie să fie exact registry.academia.ro) și parola (eventual un token expirat).
De ce apare: cauzele frecvente
1Lipsește imagePullSecrets
spec:
containers:
- name: magazin
image: registry.academia.ro/magazin-privat:1.0 spec:
imagePullSecrets:
- name: regcred
containers:
- name: magazin
image: registry.academia.ro/magazin-privat:1.0Fără imagePullSecrets, kubelet-ul cere un token anonim.
2Secret în alt namespace
kubectl create secret docker-registry regcred ... # în default
# podul e în magazinkubectl create secret docker-registry regcred -n magazin ...Podul poate folosi doar Secret-uri din namespace-ul lui.
3Server scris diferit în Secret
--docker-server=https://registry.academia.ro/v2/--docker-server=registry.academia.roServerul din Secret trebuie să se potrivească cu registry-ul din numele imaginii.
Repară eroarea, direct în pagină
Aplicația internă a unei firme de contabilitate folosește imaginea privată registry.academia.ro/magazin-privat:1.0, iar podurile Deploymentului contabil stau în ImagePullBackOff cu 401 Unauthorized. Creează Secret-ul regcred (utilizator elev, parola academia) și adaugă-l în imagePullSecrets-ul Deploymentului.
Indiciu
kubectl create secret docker-registry regcred --docker-server=... --docker-username=... --docker-password=..., apoi un kubectl patch pe șablon.
Reparația
Motivul:
kubectl describe pod -l app=contabil | grep 'Failed to pull' | tail -1 | grep -o '401 Unauthorized'401 UnauthorizedSecret-ul și imagePullSecrets:
kubectl create secret docker-registry regcred --docker-server=registry.academia.ro --docker-username=elev --docker-password=academia
kubectl patch deployment contabil -p '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"regcred"}]}}}}'
kubectl rollout status deployment/contabilsecret/regcred created
deployment.apps/contabil patched
Waiting for deployment "contabil" rollout to finish: 0 of 1 updated replicas are available...
deployment "contabil" successfully rolled outDe ce merge
Kubelet-ul nu are date de acces la registry-ul privat și primește 401 când cere un token anonim. Secret-ul docker-registry conține credențialele, iar imagePullSecrets din șablonul podului îi spune kubelet-ului să le folosească. Modificarea șablonului creează poduri noi, care descarcă imaginea cu autentificare.
Alte forme ale mesajului
failed to authorize: failed to fetch oauth token: unexpected status: 401 UnauthorizedUnable to retrieve some image pull secrets (regcred); attempting to pull the image may not succeed.
Cum o eviți pe viitor
- Pune
imagePullSecretspe ServiceAccount-uldefaultal namespace-ului, ca toate podurile să-l primească automat. - Folosește conturi de serviciu ale registry-ului (robot accounts) cu drept doar de citire, nu parola ta.
- Ține evidența expirării token-urilor de registry.
- Nu pune parola registry-ului în manifeste din git; creează Secret-ul din pipeline sau dintr-un manager de secrete.
Întrebări frecvente
De ce merge pe calculatorul meu, dar nu în cluster?
Pe calculatorul tău Docker folosește autentificarea din docker login. Nodurile clusterului nu au acces la ea; primesc datele doar prin imagePullSecrets.
Pot pune Secret-ul o singură dată pentru tot namespace-ul?
Da: kubectl patch serviceaccount default -p '{"imagePullSecrets":[{"name":"regcred"}]}'. Podurile noi care folosesc acel ServiceAccount îl primesc automat.
Erori înrudite
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. 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. Error: secret "db-secret" not found Containerul cere o valoare dintr-un Secret care nu există în namespace, așa că nu poate fi creat (CreateContainerConfigError). Creează Secret-ul cu numele și cheile așteptate (kubectl create secret generic); podul pornește singur la următoarea încercare. Î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.
