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"].
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
CMD node server.jsCMD ["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ă
CMD python app.py --port $PORTENTRYPOINT ["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
CMD ['node', 'server.js']CMD ["node", "server.js"]JSON acceptă doar ghilimele duble. Cu ghilimele simple, Docker tratează linia ca formă shell.
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.
Reparația
FROM node:20-alpine
WORKDIR /app
COPY server.js .
CMD ["node", "server.js"]docker build -t api:1.0 .
docker run --name api api:1.0API pornitDe ce merge
CMD node server.js pornea /bin/sh -c, deci shell-ul era procesul principal și nu transmitea semnalele. Lista JSON ["node", "server.js"] pornește direct node ca PID 1: la docker stop aplicația primește SIGTERM și se oprește curat, iar build-ul nu mai afișează avertismentul.
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
Containerul s-a oprit cu Exited (137) 137 = 128 + 9: procesul principal a fost omorât cu SIGKILL, nu s-a oprit singur. Cauzele: docker kill, docker stop care a așteptat degeaba 10 secunde sau lipsa de memorie (OOMKilled). Verifică cu docker inspect -f '{{.State.OOMKilled}}' nume și, pentru servicii, setează o politică de repornire. 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. 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.
