...
Eroare Docker · Dockerfile și docker build

JSONArgsRecommended: JSON arguments recommended for CMD to prevent unintended behavior related to OS signals (line 5)

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Din Docker 27 (BuildKit cu build checks), build-ul afișează la final 1 warning found și o listă de verificări. JSONArgsRecommended apare când CMD sau ENTRYPOINT sunt în forma shell: CMD node server.js.

În forma shell, Docker pornește de fapt /bin/sh -c "node server.js". Procesul cu PID 1 e shell-ul, nu aplicația. La docker stop, semnalul SIGTERM ajunge la shell, care nu-l transmite mai departe, iar după 10 secunde Docker omoară totul cu SIGKILL: containerul se oprește greu și iese cu 137, iar aplicația nu apucă să închidă conexiunile.

În forma exec, CMD ["node", "server.js"], aplicația e chiar PID 1 și primește semnalele. Build-ul nu eșuează din cauza avertismentului; imaginea se creează, dar merită reparat. (line 5) îți spune linia din Dockerfile.

De ce apare: cauzele frecvente

1CMD în forma shell

Greșit
BASH
CMD node server.js
Corect
BASH
CMD ["node", "server.js"]

Lista JSON pornește direct node, fără shell intermediar, deci SIGTERM ajunge la aplicație.

2Ai nevoie de variabile de mediu în comandă

Greșit
BASH
CMD python app.py --port $PORT
Corect
BASH
ENTRYPOINT ["sh", "-c", "exec python app.py --port \"$PORT\""]

Forma exec nu expandează $PORT. Cu sh -c și exec, shell-ul expandează variabila, apoi se înlocuiește cu aplicația.

3Ghilimele simple în JSON

Greșit
BASH
CMD ['node', 'server.js']
Corect
BASH
CMD ["node", "server.js"]

JSON acceptă doar ghilimele duble. Cu ghilimele simple, Docker tratează linia ca formă shell.

Repară tu

Repară eroarea, direct în pagină

În ~/api, build-ul imaginii api:1.0 afișează JSONArgsRecommended: JSON arguments recommended for CMD, pentru că Dockerfile-ul are CMD node server.js. Rescrie CMD în forma exec, reconstruiește api:1.0 și rulează containerul api din ea (trebuie să afișeze API pornit).

Indiciu

Forma exec: CMD ["node", "server.js"], cu ghilimele duble.

Alte forme ale mesajului

  • 1 warning found (use docker --debug to expand): - JSONArgsRecommended: JSON arguments recommended for ENTRYPOINT to prevent unintended behavior related to OS signals (line 4)
  • JSONArgsRecommended: JSON arguments recommended for ENTRYPOINT/CMD to prevent unintended behavior related to OS signals

Cum o eviți pe viitor

Scrie mereu CMD și ENTRYPOINT ca liste JSON cu ghilimele duble. Dacă ai nevoie de logică de shell la pornire, pune-o într-un script care se termină cu exec "$@". Rulează docker build --check . ca să vezi toate avertismentele fără să construiești imaginea.

Întrebări frecvente

Build-ul a reușit. Trebuie să repar?

Imaginea funcționează, dar docker stop va aștepta 10 secunde și va omorî aplicația cu SIGKILL (Exited 137). Pentru o oprire curată, trece la forma exec.

Cum văd avertismentele fără build complet?

docker build --check . rulează doar verificările. Cu # check=error=true pe prima linie din Dockerfile, avertismentele fac build-ul să eșueze, util în CI.

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.