Чем CMD отличается от ENTRYPOINT
На этой странице
CMD задаёт команду или аргументы по умолчанию — аргументы docker run image ... полностью её заменяют. ENTRYPOINT задаёт исполняемый файл контейнера — аргументы docker run дописываются к нему, а заменить его можно только флагом --entrypoint. Вместе: ENTRYPOINT — программа, CMD — её аргументы по умолчанию. Обе инструкции пишут в exec-форме ["..."], чтобы процесс получал сигналы.
Вопрос
Чем CMD отличается от ENTRYPOINT и как они работают вместе?
Основная идея
CMD ["node", "dist/main.js"]docker run my-api # node dist/main.js
docker run my-api node dist/worker.js # node dist/worker.js — CMD заменёнENTRYPOINT ["node"]
CMD ["dist/main.js"]docker run my-api # node dist/main.js
docker run my-api dist/worker.js # node dist/worker.js — заменён только CMD
docker run --entrypoint sh my-api # sh — ENTRYPOINT заменёнТаблица сочетаний
| Dockerfile | docker run image | docker run image x |
|---|---|---|
CMD ["a"] | a | x |
ENTRYPOINT ["e"] | e | e x |
ENTRYPOINT ["e"] + CMD ["a"] | e a | e x |
Exec-форма и shell-форма
CMD ["node", "dist/main.js"] # exec-форма: node — это PID 1
CMD node dist/main.js # shell-форма: /bin/sh -c "node dist/main.js"В shell-форме PID 1 — оболочка sh, которая не пересылает SIGTERM дочернему процессу. В итоге docker stop ждёт 10 секунд и убивает контейнер через SIGKILL, а приложение не успевает закрыть соединения. Ещё одна ловушка: ENTRYPOINT в shell-форме игнорирует CMD и аргументы docker run.
Та же проблема с CMD ["npm", "start"]: npm запускает Node.js дочерним процессом и пересылает сигналы ненадёжно. В production запускают node напрямую.
Когда что использовать
Только CMD — для большинства сервисов (API, frontend-сервер, worker). Легко запустить другую команду для отладки или миграции:
docker run --rm my-api npx prisma migrate deployENTRYPOINT + CMD — когда контейнер ведёт себя как утилита:
ENTRYPOINT ["eslint"]
CMD ["."]docker run --rm -v "$(pwd)":/src -w /src my-eslint src/Скрипт-обёртка в ENTRYPOINT — когда перед стартом нужно подготовить окружение. Так устроен официальный образ PostgreSQL:
COPY docker-entrypoint.sh /usr/local/bin/
ENTRYPOINT ["docker-entrypoint.sh"]
CMD ["node", "dist/main.js"]#!/bin/sh
set -e
# подготовка: проверить env, дождаться зависимостей...
exec "$@" # заменить оболочку на CMD — процесс станет PID 1exec "$@" критичен: без него приложение будет дочерним процессом оболочки и не получит сигналы.
Частые ошибки
- Путать
RUN(сборка) иCMD(запуск). - Использовать shell-форму и получать 10-секундную остановку.
- Писать entrypoint-скрипт без
exec "$@". - Делать
ENTRYPOINTтам, где хватаетCMD, — потом неудобно запускать другие команды.
Что важно помнить
CMDзаменяется аргументамиdocker run,ENTRYPOINT— только--entrypoint.- В Compose им соответствуют поля
commandиentrypoint. - Если
CMDуказан несколько раз, действует последний.
Мини-шпаргалка
CMD— по умолчанию, легко заменить.ENTRYPOINT— программа, аргументы дописываются.ENTRYPOINT+CMD= программа + аргументы по умолчанию.- Exec-форма
["..."]всегда. - Скрипт-обёртка заканчивается
exec "$@".
Документация
Docker: Dockerfile reference — CMD, Docker: Dockerfile reference — ENTRYPOINT.