ENV и параметры запуска

Допустим, на тестовом стенде API должно отвечать одним приветствием, а на демонстрационном — другим. Создавать отдельную ветку кода ради текста неудобно: приходится заново сопоставлять, какие изменения действительно относятся к функциональности. Вынесем сообщение в настройку MESSAGE.

import os

message = os.getenv("MESSAGE", "Hello, Docker!")

os.getenv читает окружение процесса. Если ключ отсутствует, Python использует второй аргумент. Здесь это резервное значение приложения. Переменные окружения — строки: значение "8000" при необходимости нужно преобразовать в число, а "false" не становится автоматически логическим False.

Простое добавление переменной в Dockerfile ничего не изменит, если приложение продолжает возвращать жёстко записанную строку. Нужны обе части: доставка настройки процессу и её чтение в точке формирования ответа.

В Dockerfile можно задать настройку, которая попадёт в окружение контейнера при обычном запуске. Для этого используется ENV. Кавычки в примере группируют значение с пробелами и не становятся частью сообщения.

FROM python:3.12-alpine
WORKDIR /app
ENV MESSAGE="Hello from ENV!"
COPY app.py .
CMD ["python", "app.py"]

При таком образе вызов os.getenv("MESSAGE", "Hello, Docker!") вернёт Hello from ENV!. Резервная строка из Python не нужна, потому что ключ уже существует. В лаборатории мы специально различаем эти два значения: так видно, какой источник действительно сработал.

ENV подходит для обычных настроек, а не для секретов, которые нельзя хранить в образе. Ещё не путайте его с ARG: аргумент сборки сам по себе не становится настройкой окружения запущенного приложения. Семантика описана в Dockerfile reference: ENV.

Флаг -e в docker run передаёт переменную конкретному контейнеру. Значение с тем же именем переопределит ENV образа. Пересобирать приложение ради смены приветствия не нужно: создайте новый контейнер с другими параметрами.

docker run --rm -e "MESSAGE=Runtime wins!" qa-api:env

Порядок выбора теперь такой: переданное при запуске значение, затем значение образа, затем резервный вариант приложения при отсутствии переменной. Пустая строка — существующее значение, поэтому -e MESSAGE= не включает автоматически резервный текст в os.getenv. Это отдельный граничный случай для тестирования.

Если после передачи -e ответ не изменился, проверьте имя ключа с учётом регистра и чтение окружения в Python. Также убедитесь, что запрашиваете именно новый контейнер. Параметры -e разобраны в документации запуска контейнеров.