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

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

Pe scurt

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

Greșit
YAML
    spec:
      containers:
      - name: magazin
        image: registry.academia.ro/magazin-privat:1.0
Corect
YAML
    spec:
      imagePullSecrets:
      - name: regcred
      containers:
      - name: magazin
        image: registry.academia.ro/magazin-privat:1.0

Fără imagePullSecrets, kubelet-ul cere un token anonim.

2Secret în alt namespace

Greșit
YAML
kubectl create secret docker-registry regcred ...   # în default
# podul e în magazin
Corect
YAML
kubectl create secret docker-registry regcred -n magazin ...

Podul poate folosi doar Secret-uri din namespace-ul lui.

3Server scris diferit în Secret

Greșit
YAML
--docker-server=https://registry.academia.ro/v2/
Corect
YAML
--docker-server=registry.academia.ro

Serverul din Secret trebuie să se potrivească cu registry-ul din numele imaginii.

Repară tu

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.

Alte forme ale mesajului

  • failed to authorize: failed to fetch oauth token: unexpected status: 401 Unauthorized
  • Unable to retrieve some image pull secrets (regcred); attempting to pull the image may not succeed.

Cum o eviți pe viitor

  • Pune imagePullSecrets pe ServiceAccount-ul default al 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

← 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.