...
Eroare Docker · Docker Compose

service "web" depends on undefined service "baza": invalid compose project

Pe scurt

Î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

Greșit
BASH
services:
  web:
    image: nginx
    depends_on:
      - baza
  db:
    image: redis:7
Corect
BASH
services:
  web:
    image: nginx
    depends_on:
      - db
  db:
    image: redis:7

depends_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

Greșit
BASH
    depends_on:
      - postgres
Corect
BASH
    depends_on:
      - db   # cheia serviciului care folosește image: postgres:16

Compose nu caută după imagine sau container, doar după numele serviciului.

3Serviciul e în alt fișier compose

Greșit
BASH
docker compose -f compose.dev.yaml up -d
Corect
BASH
docker compose -f compose.yaml -f compose.dev.yaml up -d

Fișierele date cu -f se combină. Dacă serviciul db e doar în compose.yaml, trebuie inclus și el.

Repară tu

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

Alte forme ale mesajului

  • service "api" depends on undefined service db: invalid compose project
  • Service '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

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