Как комбинация ENTRYPOINT в exec-форме и CMD позволяет передавать аргументы по умолчанию, которые можно переопределить при запуске?

Короткий ответ

При ENTRYPOINT ["executable"] в exec-форме и CMD ["--default-flag"], docker run image без дополнительных аргументов выполнит executable --default-flag, а docker run image --other-flag заменит именно CMD, выполнив executable --other-flag, не трогая сам ENTRYPOINT.

Как это работает подробнее

Docker собирает финальную команду контейнера как конкатенацию массива ENTRYPOINT и массива аргументов — либо CMD из образа (если явных аргументов в docker run нет), либо аргументов, переданных после имени образа в docker run (если они есть, они целиком заменяют CMD, но не ENTRYPOINT). Это работает предсказуемо только при exec-форме (["..."]) обоих инструкций — shell-форма ломает эту механику, так как оборачивает команду в /bin/sh -c.

Пример кода

DockerfileКопировать

ENTRYPOINT ["python", "cli.py"]
CMD ["--mode=default"]

Что использовать на практике

• Практика. такой паттерн используют для образов-утилит, где ENTRYPOINT фиксирует саму программу, а CMD задаёт "разумные значения по умолчанию" флагов, которые пользователь образа может переопределить без необходимости переопределять весь ENTRYPOINT через --entrypoint.

Подводные камни

• Риск. задают ENTRYPOINT в shell-форме (ENTRYPOINT executable) и затем недоумевают, почему CMD с аргументами не подхватывается ожидаемым образом — в shell-форме Docker игнорирует CMD как аргументы в привычном смысле, так как вся команда уже единая строка, выполняемая через shell.