Копии приложения из раздела про nginx поднимались руками командой python3 -m http.server и не переживали перезагрузку стенда. Теперь у стенда будет настоящее маленькое приложение, собранное в образ: его можно запустить на любой машине одной командой.
Начнём с самого короткого Dockerfile, который работает, — пять строк. Потом будем запускать результат и смотреть, что в нём не так: сборка медленная, остановка долгая, процесс от root, пароль уехал в образ. Каждую проблему закроем одной-двумя строками и узнаем, какие ещё есть варианты.
Шаг 1. Каталог приложения
Всё, что относится к стенду, живёт в репозитории ~/infra из раздела про Git. Приложению заведём там свой каталог.
mkdir -p ~/infra/appcd ~/infra/appФлаг -p создаёт и промежуточные каталоги, если их нет, и молчит, если каталог уже есть.
Шаг 2. Код приложения
Это крошечное веб-приложение на Flask с двумя адресами: /health отвечает «жив», /whoami рассказывает о себе. Писать на Python DevOps-инженеру не обязательно — файл просто скопируй, а нам важны три вещи, о которых ниже.
import os import socket from flask import Flask, jsonify app = Flask(__name__) @app.get("/health") def health(): return "ok" @app.get("/whoami") def whoami(): return jsonify(app=os.getenv("APP_NAME", "provision-app"), version=os.getenv("APP_VERSION", "1.0.0"), host=socket.gethostname(), pid=os.getpid()) if __name__ == "__main__": app.run(host="0.0.0.0", port=8000)
Первое: настройки приходят из переменных окружения APP_NAME и APP_VERSION, а не зашиты в код. Второе: /whoami печатает номер своего процесса, по нему проверим exec-форму. Третье: адрес 0.0.0.0 в последней строке — слушать все интерфейсы. С 127.0.0.1 приложение было бы доступно только изнутри самого контейнера.
Список зависимостей — одна строка.
flask==3.0.3Шаг 3. Минимальный Dockerfile
Пять инструкций из урока про Dockerfile: взять базовый образ с Python, перейти в рабочий каталог, скопировать туда всё, поставить зависимости и сказать, что запускать.
FROM python:3.12-slim WORKDIR /app COPY . . RUN pip install --no-cache-dir -r requirements.txt CMD ["python", "main.py"]
CMD записан в квадратных скобках — это exec-форма: Docker запустит python напрямую, без оболочки. Флаг --no-cache-dir не даёт pip хранить скачанные архивы в образе: внутри контейнера они никому не нужны.
Шаг 4. Собрать образ
Отдаём рецепт Docker и смотрим, сколько занимает каждый шаг.
docker build -t provision-app:1.0 .[+] Building 6.6s (9/9) FINISHED => [1/4] FROM docker.io/library/python:3.12-slim 0.0s => [2/4] WORKDIR /app 0.1s => [3/4] COPY . . 0.1s => [4/4] RUN pip install --no-cache-dir -r requirements.txt 5.9s => => naming to docker.io/library/provision-app:1.0
Флаг -t задаёт имя и тег, точка — контекст сборки, то есть каталог, файлы которого уходят демону. Время справа показывает, что дорого: почти всё ушло на установку зависимостей. При самой первой сборке ещё и FROM займёт несколько секунд — Docker скачает базовый образ. Твои секунды будут другими, важна разница между шагами.
Шаг 5. Запустить и спросить приложение
Запускаем контейнер в фоне и публикуем порт 8010.
docker run -d --name app -p 8010:8000 provision-app:1.0Флаг -d — фон, --name app — короткое имя контейнера (образ при этом называется provision-app), -p 8010:8000 — порт 8010 стенда ведёт на 8000 внутри контейнера. Спрашиваем приложение о себе.
curl -s localhost:8010/whoami{"app":"provision-app","host":"438e1f92a446","pid":1,"version":"1.0.0"}Два поля важны. host равен идентификатору контейнера: у контейнера своё имя машины. pid равен единице: приложение стало первым процессом внутри контейнера, значит exec-форма CMD сработала.
Минимальный образ работает. Дальше — что в нём не так.
Шаг 6. Правка кода пересобирает всё
Изобразим, что разработчик поправил код: допишем в конец main.py строку-комментарий. Для Python это пустяк, а для Docker — изменившийся файл.
echo '# v2' >> main.pyДва знака >> дописывают строку в конец файла, не стирая его. Собираем снова.
docker build -t provision-app:1.0 .[+] Building 7.3s (9/9) FINISHED => CACHED [2/4] WORKDIR /app 0.0s => [3/4] COPY . . 0.1s => [4/4] RUN pip install --no-cache-dir -r requirements.txt 6.5s
Мы поменяли одну строку кода, а зависимости поставились заново. Причина в порядке: COPY . . копирует вместе с кодом и main.py, файл изменился — и Docker пересобирает этот шаг и все шаги ниже. Здесь это шесть секунд, в настоящем проекте с сотней зависимостей — минуты на каждую правку.
Шаг 7. Сначала зависимости, потом код
Лекарство — разделить копирование на два: сначала только список зависимостей и их установку, потом остальной код.
FROM python:3.12-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD ["python", "main.py"]
Собери образ с новым порядком.
docker build -t provision-app:1.0 .[+] Building 7.6s (10/10) FINISHED => [3/5] COPY requirements.txt . 0.1s => [4/5] RUN pip install --no-cache-dir -r requirements.txt 6.5s => [5/5] COPY . . 0.1s
Первый раз зависимости ставятся заново: шаги поменялись, и старые слои к ним не подходят. Теперь снова поправь код и собери ещё раз.
echo '# v3' >> main.pydocker build -t provision-app:1.0 .[+] Building 0.7s (10/10) FINISHED => CACHED [3/5] COPY requirements.txt . 0.0s => CACHED [4/5] RUN pip install --no-cache-dir -r requirem 0.0s => [5/5] COPY . . 0.1s
Слово CACHED у установки зависимостей: requirements.txt не менялся, и Docker взял готовый слой. Заново выполнено только копирование кода. Семь секунд превратились в одну. Зависимости по-прежнему переустановятся, когда поменяется сам requirements.txt, — но это раз в неделю, а не на каждую правку.
Правило общее для любого языка: то, что меняется редко, — выше, то, что меняется часто, — ниже. У Node это package.json перед кодом, у Go — go.mod.
Шаг 8. Остановка за десять секунд
Пересоберём образ и заменим контейнер новым. Старый сначала удаляем: два контейнера с именем app быть не может. Флаг -f у docker rm останавливает и удаляет работающий контейнер одной командой.
docker rm -f appdocker run -d --name app -p 8010:8000 provision-app:1.0Теперь замерим остановку. Команда time перед любой другой меряет, сколько та работала.
time docker stop appapp real 0m10.285s
Ровно десять секунд. docker stop шлёт процессу номер 1 сигнал SIGTERM — «пора завершаться» — и ждёт. Встроенный сервер Flask, будучи процессом номер 1, на SIGTERM не отвечает. Через десять секунд Docker теряет терпение и убивает контейнер сигналом SIGKILL — приложение не успевает ничего закрыть.
Встроенный сервер Flask зато понимает SIGINT — тот же сигнал, что приходит от Ctrl+C. Инструкция STOPSIGNAL говорит Docker, какой сигнал слать при остановке. Добавь её перед CMD.
STOPSIGNAL SIGINTПересобери образ, замени контейнер (две команды выше) и замерь снова.
time docker stop appapp real 0m0.289s
Меньше секунды: сигнал дошёл, приложение завершилось само. Есть и другие пути: настоящий сервер приложений вроде gunicorn сам слушает SIGTERM, и STOPSIGNAL ему не нужен — к этому мы придём в миссии раздела. Другая частая причина тех же десяти секунд — CMD строкой без скобок: тогда процессом номер 1 становится оболочка sh, и сигнал достаётся ей, а не приложению. Возвращаем контейнер.
docker start appШаг 9. Процесс работает от root
Проверим, от чьего имени работает приложение.
docker exec app id -unrootКоманда id -un печатает имя текущего пользователя. Если в Dockerfile не сказано иное, всё внутри контейнера идёт от root. Найдёт кто-то уязвимость в приложении — получит права root внутри контейнера, а это на шаг ближе к самой машине.
Заведём обычного пользователя и переключимся на него. Строку useradd поставь сразу после WORKDIR, а USER — после COPY . ..
RUN useradd --uid 10001 appuserUSER appuseruseradd создаёт пользователя appuser с номером 10001 — заметно больше обычных, чтобы не совпасть с пользователем на самой машине. Строка стоит наверху, потому что не меняется никогда, и её слой всегда берётся из кеша. USER стоит после установки зависимостей: ставить пакеты всё ещё нужно от root, а запускать приложение — уже нет. Пересобери, замени контейнер и проверь.
docker exec app id -unappuserДругой вариант — флаг --user 10001 у docker run: он сработает и без правки образа, но про него надо помнить при каждом запуске. Инструкция в Dockerfile надёжнее.
Шаг 10. Docker не знает, живо ли приложение
Посмотрим на контейнер в списке.
docker psIMAGE STATUS PORTS NAMES provision-app:1.0 Up 2 seconds 0.0.0.0:8010->8000/tcp app
Up значит только «процесс не завершился». Зависни приложение или перестань отвечать на запросы — статус останется тем же. Инструкция HEALTHCHECK говорит Docker, как проверять, живо ли оно на самом деле. Добавь её перед STOPSIGNAL.
HEALTHCHECK --interval=10s CMD python -c "import urllib.request as u; u.urlopen('http://127.0.0.1:8000/health')"Раз в десять секунд (--interval=10s) Docker выполняет команду внутри контейнера — здесь запрос к /health. В урезанном образе нет curl, поэтому запрос делает сам Python одной строкой. Пересобери, замени контейнер и сразу посмотри список.
docker psIMAGE STATUS NAMES provision-app:1.0 Up 3 seconds (health: starting) app
Первая проверка ещё не прошла. Через десять-пятнадцать секунд:
IMAGE STATUS NAMES provision-app:1.0 Up 15 seconds (healthy) app
healthy — приложение ответило. Не ответит три раза подряд — станет unhealthy. Сам Docker такой контейнер не перезапускает, но Compose и оркестраторы по этому статусу решают, пускать ли на него трафик и ждать ли его перед запуском соседей. Ещё есть параметры --timeout (сколько ждать ответа), --retries (сколько неудач подряд считать падением) и --start-period (сколько дать на запуск), их значения по умолчанию нам пока подходят.
Шаг 11. Пароль уехал в образ
У настоящего приложения рядом с кодом обычно лежит .env с паролями. Изобразим его.
echo 'DB_PASSWORD=Secret123' > .envПересобери образ и загляни в него: флаг --rm удалит контейнер сразу после команды.
docker run --rm provision-app:1.0 cat /app/.envDB_PASSWORD=Secret123COPY . . скопировала весь каталог, включая пароль. Отправишь такой образ в реестр — пароль уедет вместе с ним к каждому, кто его скачает. Файл .dockerignore рядом с Dockerfile перечисляет, что не отдавать в сборку, по одному шаблону в строке.
.env .git __pycache__ *.log
Кроме .env здесь кеш Python и журналы. Строка .git на будущее: сейчас каталог .git лежит уровнем выше, в ~/infra, и в сборку не попадает. Но стоит перенести Dockerfile в корень репозитория — и без этой строки вся история уедет в образ. Пересобери и проверь снова.
docker run --rm provision-app:1.0 cat /app/.envcat: /app/.env: No such file or directoryПароля в образе нет. Как передать его приложению правильно — переменными окружения при запуске, — разберём в уроке про сети и конфигурацию.
Шаг 12. Итоговый файл
Вот что получилось из пяти строк, сверь со своим.
FROM python:3.12-slim WORKDIR /app RUN useradd --uid 10001 appuser COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . USER appuser HEALTHCHECK --interval=10s CMD python -c "import urllib.request as u; u.urlopen('http://127.0.0.1:8000/health')" STOPSIGNAL SIGINT CMD ["python", "main.py"]
Образ по этому файлу ты уже собрал в шаге 11, а контейнер app ещё работает со старым образом, до .dockerignore. Замени его последний раз — для сдачи он должен работать именно с этим файлом.
docker rm -f appdocker run -d --name app -p 8010:8000 provision-app:1.0Шаг 13. Зафиксировать в репозитории
Dockerfile — такой же исходный код, как приложение, и живёт он в том же репозитории. Файл .env с паролем удали: в репозиторий он попасть не должен, а приложению пока не нужен.
rm .envgit -C ~/infra add appФлаг -C заставляет Git работать в указанном каталоге, где бы ты ни стоял.
git -C ~/infra commit -m "app: приложение стенда в образе"Если что-то не работает
Симптомов немного, и каждый указывает на своё место.
Что спросят на собеседовании
- Почему приложение в контейнере должно слушать 0.0.0.0?127.0.0.1 внутри контейнера — его собственная петля, снаружи она недостижима. На опубликованном порту будет connection refused.
- Зачем HEALTHCHECK, если есть журнал?Он даёт машиночитаемое состояние: Docker, Compose и оркестраторы по нему решают, перезапускать ли контейнер и пускать ли на него трафик.