invalid reference format: repository name (MagazinWeb) must be lowercase
Numele imaginilor Docker pot conține doar litere mici, cifre și separatorii . _ - /, deci MagazinWeb e refuzat. Scrie numele cu litere mici, de exemplu docker build -t magazin-web:1.0 .
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O referință de imagine are forma [registry/][cont/]nume[:tag]. Partea de nume (repository) acceptă doar litere mici, cifre și separatorii ., _, -, iar / desparte contul de nume. Tagul de după : poate avea și majuscule, dar numele nu.
Mesajul îți arată exact partea refuzată, în paranteză: repository name (MagazinWeb) must be lowercase. Îl primești la docker build -t, docker tag, docker run sau docker pull.
Varianta scurtă invalid reference format (fără partea cu lowercase) apare când referința e greșită altfel: un spațiu sau două puncte în plus, un tag gol (app:), o variabilă goală (docker run $IMAGINE fără IMAGINE setată) sau ${PWD} cu spații în cale în fața opțiunii -v.
De ce apare: cauzele frecvente
1Majuscule în numele imaginii
docker build -t MagazinWeb:1.0 .docker build -t magazin-web:1.0 .Numele repository-ului trebuie să fie cu litere mici. magazin-web respectă regula.
2Variabilă goală în comandă
docker run -d $IMAGINE:1.0IMAGINE=magazin-web
docker run -d "$IMAGINE:1.0"Cu IMAGINE nesetată, comanda devine docker run -d :1.0, o referință fără nume.
3Cale cu spații la -v, fără ghilimele
docker run -v $(pwd)/date:/date alpine ls /date
# pwd = /home/ana/Proiecte noidocker run -v "$(pwd)/date:/date" alpine ls /dateSpațiul rupe argumentul în două, iar a doua bucată e luată drept numele imaginii.
Repară eroarea, direct în pagină
În ~/magazin ai un site static și un Dockerfile. Comanda docker build -t MagazinWeb:1.0 . a dat eroarea repository name (MagazinWeb) must be lowercase. Construiește imaginea cu numele magazin-web:1.0 și pornește containerul magazin din ea, pe portul 8080.
Indiciu
Doar numele imaginii trebuie schimbat: litere mici, cuvintele despărțite prin cratimă.
Reparația
Numele imaginii cu litere mici:
docker build -t magazin-web:1.0 .
docker run -d --name magazin -p 8080:80 magazin-web:1.0
curl -s localhost:8080<h1>Magazinul de jucării Pitic</h1>De ce merge
Docker acceptă în numele imaginii doar litere mici, cifre și separatori, așa că MagazinWeb e respins înainte să înceapă build-ul. Cu magazin-web:1.0 referința e validă, build-ul rulează, iar containerul magazin servește pagina copiată în imagine. Tagul 1.0 rămâne la fel: regula cu litere mici se aplică doar numelui.
Alte forme ale mesajului
docker: invalid reference format: repository name (MagazinWeb) must be lowercase.ERROR: invalid tag "MagazinWeb:1.0": invalid reference format: repository name (MagazinWeb) must be lowercasedocker: invalid reference format.
Cum o eviți pe viitor
Alege o convenție de nume pentru imagini și ține-te de ea: litere mici, cuvinte despărțite prin cratimă, versiunea în tag (magazin-web:1.0). Pune ghilimele în jurul variabilelor și al căilor din comenzi ("$(pwd)/date:/date"), ca un spațiu sau o variabilă goală să nu strice referința. În scripturi, oprește-te devreme dacă variabila lipsește: ${IMAGINE:?lipsește numele imaginii}.
Întrebări frecvente
Tagul poate avea majuscule?
Da. Tagul (după :) acceptă litere mari și mici, cifre, _, . și -, de exemplu app:Release-1.0. Doar numele repository-ului trebuie să fie cu litere mici.
De ce primesc doar „invalid reference format”, fără motiv?
Pentru că referința e stricată altfel decât prin majuscule: un caracter interzis, un tag gol, o variabilă goală sau o cale cu spații care a rupt comanda. Afișează comanda cu echo înainte de rulare și vezi ce primește de fapt Docker.
Erori înrudite
docker: Error response from daemon: pull access denied for ngnix, repository does not exist or may require 'docker login': denied: requested access to the resource is denied Docker nu găsește imaginea cerută pe Docker Hub: de obicei numele e scris greșit (ngnix în loc de nginx) sau e o imagine privată ori una locală care nu există încă. Corectează numele sau construiește imaginea înainte, iar pentru cele private rulează docker login. ERROR: "docker buildx build" requires exactly 1 argument. Lipsește contextul de build, de obicei punctul de la final: scrie docker build -t site:1.0 . (punctul = folderul curent). Același mesaj apare dacă ai pus un argument în plus, de exemplu un tag fără -t. Error response from daemon: manifest for nginx:1.99 not found: manifest unknown: manifest unknown Imaginea există pe registry, dar tagul cerut (aici 1.99) nu. Alege un tag care există, de exemplu nginx:1.27 sau nginx:alpine, după lista de taguri de pe pagina imaginii; la imaginile tale, verifică dacă ai urcat chiar tagul pe care îl ceri. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
