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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fișierul e YAML valid, dar nu respectă schema Compose. Mesajul spune exact ce cheie (services.web.ports) și ce tip se aștepta (must be a array, adică listă). Ai scris probabil ports: 8080:80 sau ports: "8080:80", care e un șir, nu o listă.
În YAML, o listă se scrie fie pe rânduri cu liniuță (- "8080:80"), fie între paranteze drepte (["8080:80"]). Aceeași regulă e valabilă pentru volumes, expose, dns, env_file (care acceptă și șir) sau depends_on în forma scurtă.
Mesaje înrudite de validare, cu același tipar: services.db.environment must be a mapping (ai amestecat KEY=val cu KEY: val), services.web.ports.0 must be a string or number sau Additional property imagine is not allowed (cheie necunoscută, de exemplu tradusă sau scrisă greșit).
De ce apare: cauzele frecvente
1Portul scris ca șir, nu ca listă
services:
web:
image: nginx:1.27-alpine
ports: 8080:80services:
web:
image: nginx:1.27-alpine
ports:
- "8080:80"ports e o listă de mapări. Cu liniuța, chiar și o singură mapare devine listă.
2Volumul scris pe același rând
volumes: ./html:/usr/share/nginx/html volumes:
- ./html:/usr/share/nginx/htmlvolumes are aceeași regulă: listă, nu șir.
3Porturi fără ghilimele
ports:
- 22:22 ports:
- "22:22"Fără ghilimele, unele valori de forma x:y pot fi citite de YAML ca numere în baza 60. Ghilimelele le păstrează ca text.
Repară eroarea, direct în pagină
În ~/magazin, docker compose up -d dă services.web.ports must be a array. Corectează cheia ports din compose.yaml astfel încât portul 8080 al calculatorului să fie legat de portul 80 al serviciului web, apoi pornește proiectul și verifică pagina.
Indiciu
O listă YAML se scrie pe rândul următor, cu liniuță: - "8080:80".
Reparația
ports ca listă:
services:
web:
image: nginx:1.27-alpine
ports:
- "8080:80"docker compose up -d
curl -s localhost:8080De ce merge
Schema Compose cere ca ports să fie o listă, ca să poți publica mai multe porturi. ports: 8080:80 e un singur șir, deci validarea eșuează înainte de pornire. Pe rândul următor, cu - "8080:80", ports devine o listă cu o mapare, iar Compose publică portul. Ghilimelele păstrează valoarea ca text.
Alte forme ale mesajului
services.web.volumes must be a arrayservices.db.environment must be a mappingvalidating /home/ana/magazin/compose.yaml: services.web Additional property imagine is not allowed
Cum o eviți pe viitor
Pornește de la un compose.yaml corect (din documentație sau din alt proiect) și păstrează forma listelor cu liniuță pentru ports, volumes și depends_on. Scrie porturile mereu între ghilimele. Validează după fiecare modificare cu docker compose config și folosește un editor cu schema Compose, care subliniază tipurile greșite înainte să rulezi ceva.
Întrebări frecvente
De ce „a array” și nu „an array”?
Așa e scris mesajul în Compose (generat automat din schema JSON). Nu e o greșeală a ta; caută cheia din mesaj și transform-o în listă.
La environment pot scrie și listă, și mapare?
Da, ambele sunt acceptate: listă (- KEY=val) sau mapare (KEY: val). Nu le amesteca în același bloc.
Erori înrudite
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. docker: Error response from daemon: driver failed programming external connectivity on endpoint magazin: Bind for 0.0.0.0:8080 failed: port is already allocated. Portul de pe calculator din -p 8080:80 e deja folosit de alt container (sau de alt program). Găsește-l cu docker ps --filter publish=8080, oprește-l, sau publică pe alt port, de exemplu -p 8081:80. 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ă. Î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.
