invalid project name "Magazin": must consist only of lowercase alphanumeric characters, hyphens, and underscores as well as start with a letter or number
Numele proiectului Compose (din name: în compose.yaml, din -p sau din COMPOSE_PROJECT_NAME) are litere mari, spații sau alte caractere. Folosește doar litere mici, cifre, cratime și underscore, de exemplu name: magazin.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compose pune numele proiectului în fața tuturor resurselor: containerele devin magazin-db-1, rețeaua magazin_default, volumele magazin_pgdata. Aceste nume trebuie să fie valide pentru Docker, așa că proiectul are voie să conțină doar litere mici, cifre, - și _ și să înceapă cu o literă sau o cifră.
Numele vine, în ordinea priorității, din -p / --project-name, din variabila COMPOSE_PROJECT_NAME, din cheia name: de sus din compose.yaml și, la final, din numele folderului. Când îl dai explicit (primele trei), Compose îl verifică și refuză numele cu majuscule (Magazin), spații (magazin online) sau puncte.
Numele folderului e tratat mai blând: Compose îl transformă singur în litere mici și elimină caracterele nepermise.
De ce apare: cauzele frecvente
1Majuscule în name:
name: Magazin
services:
web:
image: nginx:1.27-alpinename: magazin
services:
web:
image: nginx:1.27-alpineLitere mici, deci un nume valid pentru containere, rețele și volume.
2Spațiu în -p
docker compose -p "magazin online" up -ddocker compose -p magazin-online up -dCratima înlocuiește spațiul.
3Variabilă de mediu uitată
export COMPOSE_PROJECT_NAME=Magazin.Test
docker compose up -dexport COMPOSE_PROJECT_NAME=magazin_test
docker compose up -dVariabila are prioritate peste name: din fișier, deci și ea trebuie să fie validă.
Repară eroarea, direct în pagină
În ~/magazin, compose.yaml începe cu name: Magazin, iar docker compose up -d dă invalid project name "Magazin". Corectează numele proiectului în fișier, ca proiectul să se numească magazin, și pornește-l (serviciul web trebuie să ruleze).
Indiciu
Prima linie devine name: magazin.
Reparația
name: magazin
services:
web:
image: nginx:1.27-alpine
ports:
- "8080:80"docker compose up -dDe ce merge
Numele dat explicit cu name: e folosit ca prefix pentru containere, rețele și volume, deci trebuie să fie scris cu litere mici. Cu name: magazin, Compose creează rețeaua magazin_default și containerul magazin-web-1, iar proiectul apare în docker compose ls sub numele corect.
Alte forme ale mesajului
invalid project name "magazin online": must consist only of lowercase alphanumeric characters, hyphens, and underscores as well as start with a letter or numberproject name must not be empty
Cum o eviți pe viitor
Pune name: în compose.yaml, cu litere mici și cratime (name: magazin-online), ca proiectul să aibă același nume indiferent de folder. Evită COMPOSE_PROJECT_NAME global în profilul shell-ului, unde e ușor de uitat. Verifică numele cu docker compose config (prima linie, name:) sau docker compose ls.
Întrebări frecvente
De ce numele folderului cu majuscule nu dă eroare?
Când numele vine din folder, Compose îl normalizează automat (litere mici, fără caractere nepermise). Doar numele date explicit sunt verificate strict.
Dacă schimb numele proiectului, ce se întâmplă cu datele?
Volumele au prefixul proiectului, deci un nume nou înseamnă volume noi, goale. Volumele vechi rămân, sub numele vechi, până le ștergi.
Erori înrudite
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 . no configuration file provided: not found Docker Compose nu găsește compose.yaml (sau docker-compose.yml) în folderul curent. Intră în folderul proiectului cu cd înainte de docker compose, sau dă fișierul explicit cu -f cale/compose.yaml. WARN[0000] Found orphan containers ([magazin-cache-1]) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up. În proiect au rămas containere ale unui serviciu pe care l-ai scos sau redenumit în compose.yaml. Compose nu le mai gestionează, dar ele rulează în continuare. Curăță-le cu docker compose up -d --remove-orphans (sau docker compose down --remove-orphans și apoi up). Î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.
