...
Eroare Docker · Imagini, tag-uri și registry

invalid reference format: repository name (MagazinWeb) must be lowercase

Pe scurt

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

Greșit
BASH
docker build -t MagazinWeb:1.0 .
Corect
BASH
docker build -t magazin-web:1.0 .

Numele repository-ului trebuie să fie cu litere mici. magazin-web respectă regula.

2Variabilă goală în comandă

Greșit
BASH
docker run -d $IMAGINE:1.0
Corect
BASH
IMAGINE=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

Greșit
BASH
docker run -v $(pwd)/date:/date alpine ls /date
# pwd = /home/ana/Proiecte noi
Corect
BASH
docker run -v "$(pwd)/date:/date" alpine ls /date

Spațiul rupe argumentul în două, iar a doua bucată e luată drept numele imaginii.

Repară tu

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

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 lowercase
  • docker: 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

← Toate erorile Docker

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