service "db" refers to undefined volume pgdata: invalid compose project
Serviciul montează un volum numit (pgdata:/cale), dar volumul nu e declarat în secțiunea volumes: de la nivelul de sus al fișierului. Adaugă la final volumes: și sub el pgdata:, sau, dacă voiai un folder de pe calculator, scrie calea cu ./ în față (./pgdata:/cale).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În compose.yaml, - pgdata:/var/lib/postgresql/data poate însemna două lucruri: un volum numit (dacă sursa e un nume simplu) sau un bind mount (dacă sursa începe cu ./, ../, / sau ~). Volumele numite trebuie declarate și în secțiunea volumes: de la nivelul de sus, aliniată cu services:. Fără declarație, Compose refuză tot proiectul cu invalid compose project, înainte să pornească vreun container.
Greșelile obișnuite: lipsește secțiunea volumes: de sus; e indentată greșit (în interiorul serviciului, nu la nivelul lui services:); numele diferă (pg-data sus, pgdata la serviciu); voiai de fapt un folder local, dar ai uitat ./.
Mesajul similar pentru rețele: service "web" refers to undefined network front, cu aceeași reparație în secțiunea networks: de sus.
De ce apare: cauzele frecvente
1Lipsește declarația de sus
services:
db:
image: postgres:16
volumes:
- pgdata:/var/lib/postgresql/dataservices:
db:
image: postgres:16
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:Secțiunea volumes de la nivelul de sus creează volumul numit pentru proiect.
2Voiai un folder local
volumes:
- html:/usr/share/nginx/htmlvolumes:
- ./html:/usr/share/nginx/htmlCu ./, sursa e un folder de pe calculator (bind mount), care nu trebuie declarat.
3Nume diferite
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pg-data: volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:Numele de la serviciu trebuie să fie identic cu cel declarat.
Repară eroarea, direct în pagină
În ~/magazin, docker compose up -d dă service "db" refers to undefined volume pgdata: invalid compose project. Declară volumul numit pgdata în compose.yaml și pornește proiectul; serviciul db trebuie să ruleze cu datele în volumul magazin_pgdata.
Indiciu
La final, la același nivel cu services:, adaugă volumes: și sub el pgdata:.
Reparația
services:
db:
image: postgres:16
environment:
POSTGRES_PASSWORD: parola
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:docker compose up -d
docker volume lsDe ce merge
Compose nu creează un volum numit care nu e declarat la nivelul de sus. După ce adaugi volumes: {pgdata: }, proiectul e valid, Compose creează volumul magazin_pgdata și îl montează în /var/lib/postgresql/data, deci datele bazei rămân și după ce containerul e recreat.
Alte forme ale mesajului
service "web" refers to undefined volume date: invalid compose projectservice "web" refers to undefined network front: invalid compose projectNamed volume "pgdata:/var/lib/postgresql/data:rw" is used in service "db" but no declaration was found in the volumes section.
Cum o eviți pe viitor
Când adaugi un volum numit la un serviciu, adaugă-l imediat și în secțiunea volumes: de sus, cu același nume. Rulează docker compose config după fiecare modificare: verifică fișierul fără să pornească nimic și arată exact ce volume și rețele va crea proiectul. Pentru foldere locale, scrie mereu ./ în față.
Întrebări frecvente
Ce nume primește volumul pe daemon?
<proiect>_<volum>, de exemplu magazin_pgdata. Poți fixa alt nume cu volumes: {pgdata: {name: pgdata-magazin}}.
Pentru bind mount trebuie declarat ceva?
Nu. Căile care încep cu ./, ../, / sau ~ sunt foldere de pe calculator și se folosesc direct la serviciu.
Erori înrudite
Error response from daemon: get magazin-date: no such volume Volumul cu acest nume nu există pe daemon: numele e altul (Compose adaugă prefixul proiectului, de exemplu magazin_date), a fost deja șters sau ai scris greșit. Verifică cu docker volume ls și folosește numele exact din listă. 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ă. validating /home/ana/magazin/compose.yaml: services.web.ports must be a array În compose.yaml, ports (ca și volumes, expose, dns) trebuie să fie o listă, chiar și cu un singur element. Scrie-l pe rând nou, cu liniuță: ports: urmat de - "8080:80". docker: Error response from daemon: network magazin-net not found. Rețeaua dată la --network nu există pe acest daemon: n-a fost creată încă, are alt nume sau a fost ștearsă. Creeaz-o cu docker network create magazin-net (sau verifică numele cu docker network ls), apoi pornește containerul. Î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.
