...
Eroare Docker · Docker Compose

service "db" refers to undefined volume pgdata: invalid compose project

Pe scurt

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

Greșit
BASH
services:
  db:
    image: postgres:16
    volumes:
      - pgdata:/var/lib/postgresql/data
Corect
BASH
services:
  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

Greșit
BASH
volumes:
  - html:/usr/share/nginx/html
Corect
BASH
volumes:
  - ./html:/usr/share/nginx/html

Cu ./, sursa e un folder de pe calculator (bind mount), care nu trebuie declarat.

3Nume diferite

Greșit
BASH
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pg-data:
Corect
BASH
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

Numele de la serviciu trebuie să fie identic cu cel declarat.

Repară tu

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

Alte forme ale mesajului

  • service "web" refers to undefined volume date: invalid compose project
  • service "web" refers to undefined network front: invalid compose project
  • Named 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

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