...
Eroare Docker · Dockerfile și docker build

MultipleInstructionsDisallowed: Multiple CMD instructions should not be used in the same stage because only the last one will be used (line 5)

Pe scurt

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

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

Rămâne o singură comandă implicită, cea a serverului.

2Mai multe comenzi la pornire

Greșit
BASH
CMD ["node", "migrare.js"]
CMD ["node", "server.js"]
Corect
BASH
COPY start.sh .
CMD ["sh", "start.sh"]
# start.sh: node migrare.js && exec node server.js

Scriptul rulează pașii în ordine; exec face din server procesul principal.

3CMD folosit în loc de RUN

Greșit
BASH
CMD npm install
CMD ["npm", "start"]
Corect
BASH
RUN npm install
CMD ["npm", "start"]

RUN execută la build; CMD doar alege comanda de pornire.

Repară tu

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

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

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