Могут ли одновременно существовать CMD и entrypoint?

Взаимодействие CMD и ENTRYPOINT в Docker

Да, CMD и ENTRYPOINT могут существовать одновременно в Dockerfile, и их совместное использование является рекомендованной практикой для создания гибких и удобных Docker-образов. Эти директивы не являются взаимоисключающими, а скорее дополняют друг друга, образуя единую команду запуска контейнера.

Роль каждой директивы

• ENTRYPOINT определяет исполняемую программу (бинарник или скрипт), которая будет запущена при старте контейнера. Её можно рассматривать как фиксированную часть команды, которую сложно изменить.
• CMD задаёт аргументы по умолчанию для ENTRYPOINT. Эти аргументы можно легко переопределить при запуске контейнера через docker run.

Формы записи и режимы взаимодействия

Существует два режима, задаваемых инструкцией ENTRYPOINT:

1. Exec-форма (рекомендуется): Используется в виде JSON-массива.

   ENTRYPOINT ["executable", "param1", "param2"]
   CMD ["param3", "param4"]
   

    При таком объявлении полная команда для запуска будет выглядеть как:

```
executable param1 param2 param3 param4
```

    Аргументы из `CMD` можно переопределить:

```bash
docker run my-image arg5 arg6
```

    Тогда команда превратится в:

```
executable param1 param2 arg5 arg6
```

2. Shell-форма: Используется обычная строка. В этом случае CMD игнорируется, а команда выполняется через /bin/sh -c. dockerfile ENTRYPOINT executable param1 param2 # CMD в этом случае не будет использован при наличии shell-формы ENTRYPOINT

Практический пример для PHP-образа

Рассмотрим типичный Dockerfile для PHP-FPM приложения:

FROM php:8.2-fpm

# ... установка зависимостей, копирование кода

# Определяем фиксированный бинарник для запуска
ENTRYPOINT ["php-fpm"]

# Задаем аргументы конфигурации по умолчанию
CMD ["-F", "-O", "-c", "/usr/local/etc/php-fpm.conf"]

При сборке и запуске:

• Базовый запуск: docker run my-php-app выполнит php-fpm -F -O -c /usr/local/etc/php-fpm.conf
• Запуск с переопределением аргументов: docker run my-php-app -F -R выполнит php-fpm -F -R (аргументы из CMD полностью заменены)
• Запуск в отладочном режиме: docker run --entrypoint php my-php-app -m выполнит php -m, полностью заменив точку входа для проверки модулей.

Ключевые преимущества совместного использования

1. Гибкость: Образ становится подобным исполняемому бинарнику. ENTRYPOINT — это "команда", а CMD — её "аргументы по умолчанию".
2. Удобство для пользователей: Частые сценарии использования работают из коробки, но при необходимости поведение можно кастомизировать.
3. Следование принципу единственной ответственности: ENTRYPOINT отвечает за что запускать, CMD — за как запускать по умолчанию.
4. Упрощение команд запуска: Для стандартного сценария не нужно указывать длинные команды.

Важные нюансы

• Приоритет переопределения: Аргументы, указанные в конце команды docker run, заменяют всю инструкцию CMD.
• Полная замена точки входа: Ключ --entrypoint в docker run позволяет полностью заменить ENTRYPOINT.
• Если указан только CMD: Он может быть легко переопределён и служит командой по умолчанию.
• Если указан только ENTRYPOINT: Для него можно передавать аргументы через CMD из Dockerfile или через командную строку.

Вывод

Совместное использование ENTRYPOINT и CMD — это лучшая практика создания production-образов. Она обеспечивает предсказуемое поведение контейнера (через фиксированный ENTRYPOINT) и сохраняет возможность гибкой настройки (через переопределяемый CMD). Для PHP-приложений это позволяет создавать образы, которые по умолчанию запускают, например, php-fpm, но при этом могут быть временно переключены в режим отладки или выполнения CLI-скриптов без изменения Dockerfile.