MultipleInstructionsDisallowed: Multiple CMD instructions should not be used in the same stage because only the last one will be used (line 5)
O etapă are mai multe CMD (sau ENTRYPOINT), dar contează doar ultimul, deci containerul nu pornește ce credeai. Păstrează un singur CMD; dacă vrei mai multe comenzi la pornire, pune-le într-un script.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CMD nu adaugă o comandă de rulat, ci stabilește comanda implicită a containerului. Dacă o etapă are două CMD, al doilea îl înlocuiește pe primul, iar BuildKit te avertizează: Multiple CMD instructions should not be used in the same stage because only the last one will be used, cu linia celui ignorat. Același lucru e valabil pentru ENTRYPOINT și HEALTHCHECK.
Simptomul tipic: containerul afișează versiunea lui Node, rulează testele sau se oprește imediat, în loc să pornească serverul. docker inspect -f '{{json .Config.Cmd}}' imagine arată comanda care a rămas.
Apare când cineva adaugă un CMD de test la final și uită de el, când două Dockerfile-uri sunt lipite într-unul, sau când se crede că fiecare CMD rulează pe rând, ca RUN.
De ce apare: cauzele frecvente
1CMD de test rămas la final
CMD ["node", "server.js"]
CMD ["node", "--version"]CMD ["node", "server.js"]Rămâne o singură comandă implicită, cea a serverului.
2Mai multe comenzi la pornire
CMD ["node", "migrare.js"]
CMD ["node", "server.js"]COPY start.sh .
CMD ["sh", "start.sh"]
# start.sh: node migrare.js && exec node server.jsScriptul rulează pașii în ordine; exec face din server procesul principal.
3CMD folosit în loc de RUN
CMD npm install
CMD ["npm", "start"]RUN npm install
CMD ["npm", "start"]RUN execută la build; CMD doar alege comanda de pornire.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul imaginii api:1.0 are două CMD, iar build-ul afișează MultipleInstructionsDisallowed. Containerul afișează doar versiunea lui Node în loc să pornească server.js. Păstrează un singur CMD, cel care pornește serverul, reconstruiește api:1.0 și rulează containerul api (trebuie să afișeze Server pornit).
Indiciu
Șterge linia CMD ["node", "--version"].
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.0Server pornitDe ce merge
Al doilea CMD îl înlocuia pe primul, deci imaginea pornea node --version. Cu un singur CMD ["node", "server.js"], comanda implicită a imaginii e serverul: docker inspect arată ["node","server.js"], iar containerul afișează Server pornit. Avertismentul dispare, pentru că etapa are o singură instrucțiune CMD.
Alte forme ale mesajului
MultipleInstructionsDisallowed: Multiple ENTRYPOINT instructions should not be used in the same stage because only the last one will be used (line 4)MultipleInstructionsDisallowed: Multiple HEALTHCHECK instructions should not be used in the same stage because only the last one will be used (line 7)
Cum o eviți pe viitor
Pune un singur CMD, pe ultima linie a etapei finale, și verifică după build cu docker inspect -f '{{json .Config.Cmd}}' imagine. Pentru mai mulți pași la pornire (migrări, configurare), scrie un script de pornire care se termină cu exec comanda principală. Rulează docker build --check . ca să vezi avertismentele fără build complet.
Întrebări frecvente
Pot avea câte un CMD în fiecare etapă a unui multi-stage?
Da, verificarea se face pe etapă. Contează doar CMD-ul etapei finale (sau al celei alese cu --target).
CMD din imaginea de bază contează?
E moștenit, dar un CMD în Dockerfile-ul tău îl înlocuiește. Avertismentul apare doar pentru mai multe CMD scrise în aceeași etapă.
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"]. Containerul se oprește imediat după docker run -d: Exited (0) Exited (0) înseamnă că procesul principal al containerului s-a terminat cu succes, deci containerul s-a oprit normal. Un container trăiește cât procesul lui: pentru un shell care să rămână pornit folosește docker run -dit (sau o comandă care nu se termină), iar pentru un server verifică dacă CMD pornește serverul în prim-plan. docker: Error response from daemon: No command specified. Imaginea nu are CMD sau ENTRYPOINT, iar tu n-ai dat nicio comandă după numele ei, deci Docker nu știe ce să pornească. Se întâmplă cu imaginile create cu docker import sau din FROM scratch. Dă comanda explicit (docker run img cat /fisier) sau adaugă CMD în Dockerfile. Î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.
