Читаем Dockerfile по шагам

FROM выбирает базовый образ. В нашем python:3.12-alpine уже есть интерпретатор и стандартная библиотека. Ваш app.py туда автоматически не попадает: базовый образ не знает ничего о папке проекта.

FROM python:3.12-alpine
WORKDIR /app

WORKDIR назначает текущую папку для последующих инструкций и запуска. Если её ещё нет, Docker создаст её. Абсолютный путь удобнее относительного: результат не зависит от рабочей папки, унаследованной от базового образа. Именно поэтому здесь явно написано /app, а не просто app.

Наличие тега с номером версии полезно для читаемости, но тег может обновляться у издателя. В учебной среде базовый образ заранее подготовлен. В рабочем проекте команда отдельно определяет, когда обновляет базу и как фиксирует точную версию; выбор маленького образа сам по себе не гарантирует воспроизводимость или безопасность.

Подробнее: Рекомендации Docker по базовым образам и WORKDIR.

В COPY app.py . слева указан источник из контекста сборки, справа — назначение внутри образа. Точка назначения разрешается относительно WORKDIR. При рабочей папке /app результатом будет /app/app.py.

WORKDIR /app
COPY app.py .
# Итоговый путь: /app/app.py

Если написать COPY app.py /srv/app.py, а затем выполнить python app.py из /app, сборка может завершиться успешно, но Python не найдёт файл при старте. Полезный приём — мысленно вычислить абсолютный путь результата каждой инструкции, прежде чем менять несколько строк наугад.

Копирование не делает локальную папку «живой» частью контейнера. После редактирования исходника пересоберите образ и создайте новый контейнер из него. Механизм подключения файлов без пересборки называется bind mount; его будем изучать отдельно, чтобы не смешивать две разные модели.

Exec-форма CMD — JSON-массив: каждый аргумент отдельной строкой с двойными кавычками. Docker запускает программу напрямую, без дополнительной оболочки. Для нашего сервера это простой способ сделать Python главным процессом.

CMD ["python", "app.py"]

# Ошибочно: всё имя команды попало в один элемент
# CMD ["python app.py"]

# Ошибочно: одинарные кавычки не являются JSON
# CMD ['python', 'app.py']

RUN выполняется во время сборки, а CMD сохраняет запуск по умолчанию. Если заменить CMD на RUN python app.py, сервер начнёт бесконечно ждать запросов в процессе сборки. Образ не будет готов в ожидаемый момент. Это ошибка выбора этапа, а не медленный Docker.

Exec-форма также не подставляет $MESSAGE как shell. Позже приложение само прочитает переменную окружения через Python. Различия форм и этапов описаны в справочнике CMD.