Что такое ENTRYPOINT?

Что такое ENTRYPOINT в контексте Docker?

ENTRYPOINT — это ключевая инструкция в Dockerfile, которая определяет исполняемую команду, запускаемую при старте контейнера. По сути, это точка входа в контейнер, задающая его основное предназначение. В отличие от CMD, который предоставляет аргументы по умолчанию, ENTRYPOINT фиксирует команду, делая контейнер исполняемым, как самостоятельное приложение.

Основные аспекты ENTRYPOINT

1. Формы записи
   Инструкция поддерживает два формата:
   • Shell-формат: ENTRYPOINT команда параметр1 параметр2

     Исполняется через оболочку (например, `/bin/sh -c`), что может мешать корректной обработке сигналов (например, SIGTERM).  

• Exec-формат (рекомендуется): ENTRYPOINT ["исполняемый_файл", "параметр1", "параметр2"]

     Запускает процесс напрямую, обеспечивая корректное получение сигналов и PID=1.

1. Взаимодействие с CMD
   Эти инструкции дополняют друг друга:

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

   Пример:

   ENTRYPOINT ["nginx"]
   CMD ["-g", "daemon off;"]
   

   При запуске docker run my-nginx выполнится nginx -g "daemon off;". Если добавить аргументы, например, docker run my-nginx -t, CMD будет заменён, и выполнится nginx -t.

2. Переопределение ENTRYPOINT
   Его можно изменить при запуске контейнера через флаг --entrypoint:

   docker run --entrypoint /bin/bash my-container
   

   Это полезно для отладки (например, запуска оболочки вместо основного приложения).

Практическое применение и примеры

Пример 1: Контейнер как утилита
Создадим контейнер для проверки URL с помощью curl:

FROM alpine:latest
RUN apk add --no-cache curl
ENTRYPOINT ["curl"]
CMD ["--help"]

• Сборка: docker build -t my-curl .
• Запуск:
  docker run my-curl — покажет справку curl.
  docker run my-curl -I https://google.com — выполнит curl -I https://google.com, заменив CMD.

Пример 2: Веб-сервер с фиксированной конфигурацией

FROM nginx:alpine
COPY nginx.conf /etc/nginx/nginx.conf
ENTRYPOINT ["nginx", "-c", "/etc/nginx/nginx.conf", "-g", "daemon off;"]

Здесь ENTRYPOINT жёстко задаёт команду запуска, делая контейнер специализированным.

Рекомендации по использованию

• Используйте exec-формат для корректной обработки сигналов (например, graceful shutdown при docker stop).
• Комбинируйте ENTRYPOINT и CMD, если контейнер должен работать как исполняемый файл с настраиваемыми аргументами.
• Избегайте Shell-формата, если не требуется расширение переменных окружения через оболочку.
• Для отладки временно меняйте ENTRYPOINT на /bin/sh или используйте docker exec для доступа к запущенному контейнеру.

Отличия от CMD

• CMD предоставляет аргументы по умолчанию, которые легко переопределить.
• ENTRYPOINT определяет, какая команда будет выполнена, делая контейнер более предсказуемым.
• Если в Dockerfile указан ENTRYPOINT, CMD становится его дополнением, а не самостоятельной командой.

Итог: ENTRYPOINT — это мощный инструмент для определения поведения контейнера. Он превращает контейнер в самостоятельную исполняемую единицу, упрощает его использование и повышает надёжность, особенно при работе в оркестраторах, таких как Kubernetes, где важно корректное управление жизненным циклом процессов. Правильное применение ENTRYPOINT является признаком зрелого DevOps-подхода к созданию Docker-образов.