validating /home/ana/magazin/compose.yaml: (root) Additional property service is not allowed
La primul nivel din compose.yaml ai o cheie pe care Compose nu o cunoaște: de obicei service în loc de services, volume în loc de volumes sau un serviciu scris fără indentare. La rădăcină sunt permise doar services, volumes, networks, configs, secrets, name, include și x-...
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compose validează fișierul după o schemă. (root) înseamnă primul nivel al fișierului, fără indentare. Additional property service is not allowed spune că acolo a găsit cheia service, care nu face parte din schemă.
Cheile valide la rădăcină sunt services, volumes, networks, configs, secrets, name, include, version (învechită) și extensiile care încep cu x-. Orice altceva e respins: singularul (service, volume, network), o greșeală de scriere (sevices), un serviciu (db:) lipit la marginea din stânga în loc să fie indentat sub services:, sau o cheie de serviciu (ports:) care a pierdut indentarea.
Pe versiuni mai noi de Compose, mesajul poate apărea ca additional properties 'service' not allowed. Cheia din mesaj îți arată exact linia problematică.
De ce apare: cauzele frecvente
1Singular în loc de plural
service:
web:
image: nginxservices:
web:
image: nginxCheia de la rădăcină e services, la plural.
2Serviciu neindentat
services:
web:
image: nginx
db:
image: postgres:16services:
web:
image: nginx
db:
image: postgres:16Fără indentare, db ajunge la rădăcină, nu sub services.
3volume în loc de volumes
volume:
pgdata:volumes:
pgdata:Secțiunea de volume de la rădăcină se numește volumes.
Repară eroarea, direct în pagină
În ~/magazin, docker compose up -d se oprește cu (root) Additional property service is not allowed. Repară cheia de la începutul fișierului compose.yaml, astfel încât serviciul web (nginx, portul 8080) să fie recunoscut, și pornește proiectul.
Indiciu
Cheia sub care stau serviciile se scrie la plural.
Reparația
sed -i 's/^service:/services:/' compose.yaml
docker compose config --services
docker compose up -dwebDe ce merge
Schema Compose nu cunoaște cheia service la rădăcină, deci respingea tot fișierul înainte să pornească ceva. Cu services:, blocul web e citit ca serviciu, iar docker compose up -d creează rețeaua magazin_default și containerul magazin-web-1, publicat pe portul 8080. docker compose config --services confirmă că fișierul e acum valid.
Alte forme ale mesajului
validating /home/ana/magazin/compose.yaml: (root) additional properties 'service' not allowedvalidating /home/ana/magazin/compose.yaml: (root) Additional property db is not allowed(root) Additional property volume is not allowed
Cum o eviți pe viitor
Pornește de la un compose.yaml care merge și modifică-l pas cu pas. Folosește un editor cu extensia pentru Docker Compose (validează după schemă și completează cheile) și indentare cu spații, de câte 2. Rulează docker compose config după fiecare modificare: arată fișierul interpretat sau eroarea exactă.
Întrebări frecvente
De ce mesajul zice 'Additional property'?
Schema Compose listează cheile permise la fiecare nivel. Orice cheie în plus e „o proprietate suplimentară”, respinsă ca să prindă greșelile de scriere.
Pot adăuga chei proprii în fișier?
Da, dacă încep cu x- (de exemplu x-comun:). Le folosești pentru blocuri reutilizabile, cu ancore YAML.
Erori înrudite
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". 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. 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. Î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.
