LegacyKeyValueFormat: "ENV key=value" should be used instead of legacy "ENV key value" format (line 3)
Avertismentul build-ului spune că ai scris ENV PORT 3000 (forma veche, cu spațiu). Folosește forma cu egal: ENV PORT=3000 (și la fel la LABEL și ARG), care permite și mai multe variabile pe aceeași linie fără ambiguitate.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ENV acceptă două sintaxe. Forma veche, ENV PORT 3000, setează o singură variabilă și ia tot restul liniei ca valoare, inclusiv spațiile. Forma nouă, ENV PORT=3000 NODE_ENV=production, poate seta mai multe variabile și e clară.
Capcana formei vechi: ENV PORT 3000 NODE_ENV production nu creează două variabile, ci una singură, PORT, cu valoarea 3000 NODE_ENV production. De aceea Docker 27 (build checks din BuildKit) avertizează cu LegacyKeyValueFormat, iar documentația spune că forma veche ar putea fi eliminată.
Build-ul nu eșuează; imaginea se creează cu valorile date. (line 3) arată linia din Dockerfile. Verifici ce variabile are imaginea cu docker inspect -f '{{.Config.Env}}' imagine.
De ce apare: cauzele frecvente
1ENV cu spațiu
ENV PORT 3000ENV PORT=3000Forma cu egal e cea recomandată și nu mai dă avertismentul.
2Mai multe variabile în forma veche
ENV PORT 3000 NODE_ENV productionENV PORT=3000 NODE_ENV=productionForma veche face din tot restul liniei valoarea lui PORT. Cu egal, fiecare variabilă primește valoarea ei.
3Valori cu spații
ENV TITLU Magazin onlineENV TITLU="Magazin online"În forma nouă, o valoare cu spații se pune între ghilimele.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul are ENV PORT 3000 și build-ul afișează LegacyKeyValueFormat. Un coleg vrea să adauge și NODE_ENV. Scrie linia ENV în forma cu egal, cu PORT=3000 și NODE_ENV=production, apoi reconstruiește api:1.0 și verifică variabilele imaginii.
Indiciu
ENV PORT=3000 NODE_ENV=production pe o singură linie.
Reparația
FROM node:20-alpine
WORKDIR /app
ENV PORT=3000 NODE_ENV=production
COPY server.js .
CMD ["node", "server.js"]docker build -t api:1.0 .
docker inspect -f '{{.Config.Env}}' api:1.0[PATH=... NODE_VERSION=... YARN_VERSION=... PORT=3000 NODE_ENV=production]De ce merge
În forma cheie=valoare, fiecare pereche e o variabilă separată, deci imaginea are exact PORT=3000 și NODE_ENV=production. În forma veche, a doua variabilă ar fi devenit parte din valoarea lui PORT. Avertismentul dispare, iar docker inspect arată ambele variabile în Config.Env.
Alte forme ale mesajului
LegacyKeyValueFormat: "LABEL key=value" should be used instead of legacy "LABEL key value" format (line 2)1 warning found (use docker --debug to expand): - LegacyKeyValueFormat: "ENV key=value" should be used instead of legacy "ENV key value" format (line 3)
Cum o eviți pe viitor
Scrie mereu ENV CHEIE=valoare (și LABEL cheie=valoare). Pentru mai multe variabile, pune-le pe linii separate cu \ sau pe aceeași linie, separate prin spații, iar valorile cu spații între ghilimele. Rulează docker build --check . înainte de commit, ca să prinzi avertismentele de stil înainte să ajungă în pipeline.
Întrebări frecvente
Variabila funcționează și în forma veche. De ce aș schimba?
Pentru o singură variabilă fără spații, rezultatul e același. Problema apare când adaugi a doua variabilă pe aceeași linie sau o valoare cu spații, iar forma veche poate fi scoasă în versiuni viitoare.
Pot suprascrie ENV la pornire?
Da, docker run -e PORT=8080 imagine înlocuiește valoarea din imagine doar pentru acel container.
Erori înrudite
JSONArgsRecommended: JSON arguments recommended for CMD to prevent unintended behavior related to OS signals (line 5) Avertismentul build-ului spune că CMD (sau ENTRYPOINT) e scris în forma shell, deci procesul principal devine /bin/sh și aplicația nu primește SIGTERM la docker stop. Scrie-l în forma exec, ca listă JSON: CMD ["node", "server.js"]. WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string. compose.yaml folosește ${DB_PAROLA}, dar variabila nu există nici în shell, nici în fișierul .env de lângă compose.yaml, așa că Compose pune un șir gol. Adaugă DB_PAROLA=valoare în .env (în folderul proiectului) sau exportă variabila înainte de docker compose up. ERROR: failed to solve: dockerfile parse error on line 3: unknown instruction: COPPY (did you mean copy?) Pe linia indicată, primul cuvânt nu e o instrucțiune Dockerfile validă: e o greșeală de scriere (COPPY, RUNN) sau o linie care continuă comanda de deasupra fără backslash. Corectează linia 3, după sugestia did you mean. Î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.
