service "web" depends on undefined service "baza": invalid compose project
În compose.yaml, depends_on (sau links) al serviciului web pomenește un serviciu care nu există în fișier. Pune la depends_on exact numele unei chei de sub services (aici db), sau adaugă serviciul lipsă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Înainte să pornească ceva, Docker Compose validează tot proiectul. La depends_on, fiecare nume trebuie să fie o cheie existentă sub services:. Mesajul îți spune ambele capete: serviciul care are dependența ("web") și numele care nu există ("baza"). invalid compose project înseamnă că nimic n-a fost pornit.
Cauzele sunt aproape mereu legate de nume: ai redenumit serviciul (din baza în db) și ai uitat referința, ai pus în depends_on numele containerului (magazin-db-1) sau numele imaginii (postgres) în loc de numele serviciului, ai o greșeală de scriere, ori serviciul e definit într-un alt fișier compose pe care nu l-ai inclus (-f compose.dev.yaml).
Atenție și la indentare: un serviciu indentat greșit poate ajunge, fără să-ți dai seama, sub alt serviciu în loc de services:, deci pentru Compose nu există.
De ce apare: cauzele frecvente
1Serviciul a fost redenumit
services:
web:
image: nginx
depends_on:
- baza
db:
image: redis:7services:
web:
image: nginx
depends_on:
- db
db:
image: redis:7depends_on folosește cheile de sub services. Serviciul se numește db, deci referința trebuie să fie db.
2Numele imaginii sau al containerului în loc de serviciu
depends_on:
- postgres depends_on:
- db # cheia serviciului care folosește image: postgres:16Compose nu caută după imagine sau container, doar după numele serviciului.
3Serviciul e în alt fișier compose
docker compose -f compose.dev.yaml up -ddocker compose -f compose.yaml -f compose.dev.yaml up -dFișierele date cu -f se combină. Dacă serviciul db e doar în compose.yaml, trebuie inclus și el.
Repară eroarea, direct în pagină
În ~/blog, docker compose up -d dă service "web" depends on undefined service "baza". Serviciul cache-ului a fost redenumit din baza în db, dar referința a rămas. Repară compose.yaml (tabul compose.yaml sau sed) și pornește proiectul, cu ambele servicii.
Indiciu
La depends_on se scrie numele unei chei de sub services:.
Reparația
Corectează referința și pornește proiectul:
sed -i 's/- baza$/- db/' compose.yaml
docker compose config --services
docker compose up -d
docker compose psFragmentul corectat:
depends_on:
- dbDe ce merge
Compose validează referințele înainte de pornire: depends_on: - baza cere un serviciu baza, care nu mai există după redenumire. Cu - db, referința indică serviciul real, proiectul e valid, iar Compose pornește întâi db, apoi web. docker compose config --services confirmă lista serviciilor înainte de pornire.
Alte forme ale mesajului
service "api" depends on undefined service db: invalid compose projectService 'web' depends on service 'baza' which is undefined.
Cum o eviți pe viitor
Alege nume scurte și stabile pentru servicii (web, api, db, cache) și folosește-le peste tot: în depends_on, în URL-urile de conexiune, în docker compose exec. Rulează docker compose config --services după fiecare modificare: îți arată lista serviciilor așa cum le vede Compose și validează fișierul fără să pornească nimic. Un editor cu schema Compose (VS Code cu extensia Docker) semnalează referințele greșite.
Întrebări frecvente
Cum văd ce servicii vede Compose?
docker compose config --services afișează numele lor, iar docker compose config afișează tot fișierul normalizat, după combinarea fișierelor și a variabilelor.
depends_on așteaptă ca baza să fie gata?
Forma simplă (listă) așteaptă doar ca containerul să pornească. Ca să aștepte ca baza să răspundă, folosește condition: service_healthy și un healthcheck la serviciul bazei.
Erori înrudite
dependency failed to start: container magazin-db-1 is unhealthy Un serviciu are depends_on cu condition: service_healthy, iar healthcheck-ul dependenței (aici db) pică, deci Compose nu pornește serviciul care așteaptă. Citește motivul cu docker inspect magazin-db-1 (State.Health.Log) și repară comanda din healthcheck sau serviciul în sine. yaml: line 4: mapping values are not allowed in this context compose.yaml are o greșeală de sintaxă YAML în jurul liniei 4, aproape mereu de indentare: o cheie mutată cu un spațiu, un Tab în loc de spații sau lipsa spațiului după două puncte. Aliniază cheile de același nivel exact la aceeași coloană, doar cu spații. Error response from daemon: No such container: magazin_db Nu există niciun container cu numele sau ID-ul dat: e scris greșit, a fost șters (de exemplu pornit cu --rm) sau are alt nume, cum sunt cele create de Docker Compose (proiect-serviciu-1). Vezi numele reale cu docker ps -a și folosește-l exact. Î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.
