...
Eroare Docker · Dockerfile și docker build

LegacyKeyValueFormat: "ENV key=value" should be used instead of legacy "ENV key value" format (line 3)

Pe scurt

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

Greșit
BASH
ENV PORT 3000
Corect
BASH
ENV PORT=3000

Forma cu egal e cea recomandată și nu mai dă avertismentul.

2Mai multe variabile în forma veche

Greșit
BASH
ENV PORT 3000 NODE_ENV production
Corect
BASH
ENV PORT=3000 NODE_ENV=production

Forma veche face din tot restul liniei valoarea lui PORT. Cu egal, fiecare variabilă primește valoarea ei.

3Valori cu spații

Greșit
BASH
ENV TITLU Magazin online
Corect
BASH
ENV TITLU="Magazin online"

În forma nouă, o valoare cu spații se pune între ghilimele.

Repară tu

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.

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

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