...
Eroare Docker · Docker Compose

validating /home/ana/magazin/compose.yaml: services.web.ports must be a array

Pe scurt

Î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ă

Greșit
BASH
services:
  web:
    image: nginx:1.27-alpine
    ports: 8080:80
Corect
BASH
services:
  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

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

volumes are aceeași regulă: listă, nu șir.

3Porturi fără ghilimele

Greșit
BASH
    ports:
      - 22:22
Corect
BASH
    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ă tu

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

Alte forme ale mesajului

  • services.web.volumes must be a array
  • services.db.environment must be a mapping
  • validating /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

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