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

Pe scurt

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

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

magazn nu există, iar registry-ul răspunde ca pentru un repository privat.

2Lipsește organizația

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

Fără organizație, Docker Hub caută în library/, unde sunt doar imaginile oficiale.

3Majuscule în nume

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

Numele de repository sunt doar cu litere mici.

Repară tu

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

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 failed
  • Error 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ă imagePullSecrets pe ServiceAccount-ul namespace-ului.
  • Testează numele cu docker pull de 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

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