Provision
—— XP

Миссия: образ, пригодный для эксплуатации

практика~60 минут+400 XP

В первой практике раздела мы оставили внутри образа отладочный сервер Flask. Он сам предупреждает при старте, что не предназначен для эксплуатации: работает одним процессом, упавшее не поднимает и не умеет аккуратно доработать запросы при остановке. Пора его заменить и собрать всё остальное: свой реестр, теги, по которым находятся исходники, лимиты и документ о том, что именно работает.

Миссия — задание: команды даны, а вывод на экране проверяешь сам по описанию.

Требования

Задача одна, но проверяется по пунктам.

Что должно получиться
Сервер приложений
gunicorn вместо встроенного сервера Flask, два рабочих процесса.
Свой реестр
registry:3 на петле, образ выложен под тегами 1.0.0 и sha-<коммит>.
Запуск как в эксплуатации
Контейнер prod: порт только на петле, лимиты 512 МБ и одно ядро, перезапуск после сбоев.
Паспорт
Документ с версией, digest, способом запуска и известными ограничениями.

Шаг 1. Сервер приложений

Gunicorn — сервер приложений для Python: он держит несколько рабочих процессов, поднимает упавшие и раздаёт им запросы. Встроенный сервер Flask рассчитан на разработку: запросы он принимает в потоках одного процесса, и если этот процесс упадёт или зависнет, отвечать некому. Добавь gunicorn в зависимости.

nano ~/infra/app/requirements.txt
flask==3.0.3
psycopg2==2.9.9
gunicorn==23.0.0

Шаг 2. Самая короткая команда

Замени последнюю строку Dockerfile. По-прежнему массив, то есть exec-форма: главным процессом станет gunicorn.

в ~/infra/app/Dockerfile, вместо строки CMD
CMD ["gunicorn", "main:app"]

main:app — файл main.py и объект app в нём, единственное, без чего gunicorn не запустится. Строку STOPSIGNAL SIGINT из Dockerfile удали. Она была нужна встроенному серверу Flask, который не слушал SIGTERM. Gunicorn слушает сам и понимает сигналы по-разному: на SIGTERM он даёт рабочим доделать текущие запросы и только потом выходит, а на SIGINT выходит сразу, обрывая их. Нам нужно первое, а SIGTERM Docker шлёт по умолчанию.

Шаг 3. Собрать и попробовать

Соберём и запустим пробный контейнер try на свободном порту 8099.

ubuntu@stand:~$
cd ~/infra/app
ubuntu@stand:~$
docker build -t provision-app:3.0 .

Имя образа сохраним в переменной шелла T, чтобы команда запуска осталась короткой.

ubuntu@stand:~$
T=provision-app:3.0
ubuntu@stand:~$
docker run -d --name try -p 127.0.0.1:8099:8000 $T
ubuntu@stand:~$
curl -sS localhost:8099/whoami
ubuntu@stand:~$
curl: (56) Recv failure: Connection reset by peer

Порт опубликован, а ответа нет. Журнал скажет, где слушает gunicorn:

ubuntu@stand:~$
docker logs try
ubuntu@stand:~$
[INFO] Starting gunicorn 23.0.0
[INFO] Listening at: http://127.0.0.1:8000 (1)
[INFO] Using worker: sync
[INFO] Booting worker with pid: 7

127.0.0.1 — петля внутри контейнера. Та же грабля, что с app.run в первой практике раздела: снаружи туда не попасть.

Шаг 4. Слушать все интерфейсы

Флаг --bind задаёт адрес. Поправь CMD:

в ~/infra/app/Dockerfile, строка CMD
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "main:app"]

Пересобери, удали пробный контейнер (docker rm -f try) и запусти его снова той же командой.

ubuntu@stand:~$
curl -s localhost:8099/whoami
ubuntu@stand:~$
{"app":"provision-app","host":"1c2f0b8a9e31","pid":7,"version":"1.0.0"}

Ответил. pid теперь не единица: первым номером идёт мастер gunicorn, а запрос обслужил рабочий процесс.

Шаг 5. Сколько рабочих

Сколько их всего, покажет docker top — процессы контейнера, как ps на хосте.

ubuntu@stand:~$
docker top try -o pid,args
ubuntu@stand:~$
PID      COMMAND
277865   /usr/local/bin/python3.12 /usr/local/bin/gunicorn --bind 0.0.0.0:8000 main:app
277929   /usr/local/bin/python3.12 /usr/local/bin/gunicorn --bind 0.0.0.0:8000 main:app

Мастер и один рабочий — значение по умолчанию. Завис он на долгом запросе — остальные ждут. Флаг --workers задаёт число; его считают от лимита процессора контейнера, а не от ядер машины. Нам хватит двух:

в ~/infra/app/Dockerfile, строка CMD
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "2", "main:app"]

Пересобери и перезапусти try — docker top покажет три строки: мастер и два рабочих.

Шаг 6. Журнал запросов

Сделай запрос и загляни в журнал.

ubuntu@stand:~$
docker logs try --tail 2
ubuntu@stand:~$
[INFO] Booting worker with pid: 7
[INFO] Booting worker with pid: 8

Запроса в журнале нет: gunicorn по умолчанию не пишет журнал запросов. Флаг --access-logfile - включает его и направляет в стандартный вывод (-), туда, где его видит docker logs.

в ~/infra/app/Dockerfile, строка CMD
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "2", "--access-logfile", "-", "main:app"]

Пересобери, перезапусти, сделай запрос — теперь в журнале строка:

ubuntu@stand:~$
172.17.0.1 - - [23/Oct/2026:15:26:36 +0000] "GET /whoami HTTP/1.1" 200 10 "-" "curl/8.5.0"

Пробный контейнер больше не нужен: docker rm -f try.

Шаг 7. Зафиксировать

Изменения в Dockerfile и зависимостях — в репозиторий, и именно сейчас, до последней сборки. На шаге 10 образ получит тег с хешем коммита, и этот коммит должен содержать то, что лежит в образе. Закоммитишь позже — тег укажет на код без gunicorn.

ubuntu@stand:~$
git -C ~/infra add app
ubuntu@stand:~$
git -C ~/infra commit -m "app: gunicorn"

Шаг 8. Собрать

Последняя сборка третьей версии — уже с закоммиченным Dockerfile. Слои возьмутся из кеша, сборка займёт секунды.

ubuntu@stand:~$
docker build -t provision-app:3.0 .

Шаг 9. Свой реестр

Реестр — это контейнер из образа registry:3. Публикуем его только на петлю: пароля и шифрования у него нет.

ubuntu@stand:~$
docker run -d -p 127.0.0.1:5000:5000 registry:3

Имя мы не задали, чтобы команда осталась короткой, и Docker придумал его сам. Флаг -l у docker ps показывает последний созданный контейнер — посмотри, как его назвали.

ubuntu@stand:~$
docker ps -l

Переименуй контейнер в registry, подставив своё случайное имя из колонки NAMES, и включи ему перезапуск после перезагрузки машины. Команда docker update меняет настройки уже созданного контейнера.

ubuntu@stand:~$
docker rename eager_turing registry
ubuntu@stand:~$
docker update --restart unless-stopped registry

Политика unless-stopped — поднимать контейнер после сбоя и после перезагрузки, но не после того, как его остановили руками.

Шаг 10. Теги

Чтобы не набирать длинный адрес реестра каждый раз, снова кладём его в переменную оболочки, как в уроке про реестр.

ubuntu@stand:~$
REPO=localhost:5000/provision/app

Переменная живёт, пока открыт этот терминал. Если прервёшься и вернёшься в новом сеансе, $REPO окажется пустым, и Docker ответит invalid reference format. Тогда просто выполни строку выше ещё раз — и IMG из шага 12 тоже. Всё остальное, что сделано до перерыва, лежит на диске и никуда не денется.

Первый тег — версия релиза.

ubuntu@stand:~$
docker tag provision-app:3.0 $REPO:1.0.0

Второй — короткий хеш текущего коммита репозитория ~/infra, того, что ты сделал на шаге 7. Узнай его.

ubuntu@stand:~$
git -C ~/infra rev-parse --short HEAD

Подставь свой хеш вместо a2f5d81.

ubuntu@stand:~$
docker tag provision-app:3.0 $REPO:sha-a2f5d81

Шаг 11. Отправить в реестр

Флаг --all-tags отправляет все теги этого репозитория разом.

ubuntu@stand:~$
docker push --all-tags $REPO

Спроси реестр, что в нём лежит. У него есть простой HTTP-интерфейс.

ubuntu@stand:~$
curl -s localhost:5000/v2/provision/app/tags/list

Ожидается JSON со списком из двух тегов. Digest образа покажет docker images --digests $REPO — запиши его, он понадобится для паспорта.

Шаг 12. Запустить как в эксплуатации

Контейнеры из прошлых практик больше не нужны: app на 8010 и app2 на 8011.

ubuntu@stand:~$
docker rm -f app app2

Запускаем образ из реестра, опубликовав порт только на петлю: снаружи к нему не попасть, а вход для людей в разделе про Compose встанет перед ним — nginx в контейнере. Ещё одна переменная — полное имя образа.

ubuntu@stand:~$
IMG=$REPO:1.0.0
ubuntu@stand:~$
docker run -d --name prod -p 127.0.0.1:8012:8000 $IMG

Шаг 13. Лимиты и перезапуск

Лимиты можно было дать прямо в docker run, но команда растянулась бы на полэкрана. Зададим их по одному. --memory — потолок памяти; --memory-swap с тем же числом запрещает уходить в подкачку сверх него.

ubuntu@stand:~$
docker update --memory 512m --memory-swap 512m prod
ubuntu@stand:~$
docker update --cpus 1 prod
ubuntu@stand:~$
docker update --restart unless-stopped prod

Обрати внимание, сколько флагов накопилось у одного контейнера. Запомнить и повторить их на другой машине трудно — ровно эту задачу решает Docker Compose из следующего раздела.

Шаг 14. Проверить

Через полминуты контейнер должен стать здоровым.

ubuntu@stand:~$
docker ps

В строке prod ожидается Up … (healthy). Теперь посмотрим процессы внутри: docker top показывает их так же, как ps на хосте.

ubuntu@stand:~$
docker top prod

Строк gunicorn должно быть три: мастер и два рабочих. Спроси приложение о себе.

ubuntu@stand:~$
curl -s localhost:8012/whoami

Поле pid теперь не единица — и это правильно: на запрос ответил рабочий процесс, а первым номером идёт мастер. Остановка по-прежнему должна быть быстрой.

ubuntu@stand:~$
time docker stop prod

Около секунды: мастер получил SIGTERM, дал рабочим закончить запросы и вышел. Верни контейнер.

ubuntu@stand:~$
docker start prod

Шаг 15. Паспорт образа

Паспорт — документ, по которому через полгода понятно, что это за образ и как он запущен. Пример структуры — ниже, значения подставь свои.

~/devops-lab/reports/image-passport.txt
ОБРАЗ       localhost:5000/provision/app:1.0.0
            digest sha256:c41e9d2b7f08a93e...
            теги 1.0.0 (релиз), sha-a2f5d81 (коммит в ~/infra)
ВНУТРИ      python:3.12-slim, gunicorn 2 процесса, appuser
СБОРКА      два этапа, компилятора в образе нет, 232 МБ
ЗАПУСК      контейнер prod, 127.0.0.1:8012, 512 МБ / 1 ядро
            restart unless-stopped, снаружи недоступен
НЕТ         сборки в CI, пароля у реестра, базы данных
СЛОМАЕТСЯ   длинная команда запуска: на новой машине её не повторить

Если что-то не сходится

Каждый несошедшийся пункт указывает на своё место.

Симптом и причина
health: starting не меняется
Проверка не проходит: docker logs prod покажет, поднялся ли gunicorn и на каком адресе.
Failed to find attribute 'app' in 'main'
В CMD опечатка в main:app, или в main.py объект называется иначе.
push: connection refused
Реестр не запущен или опубликован не на 5000: docker ps.
curl: connection refused на 8012
Контейнер prod не запущен или порт опубликован не на 127.0.0.1:8012: docker ps.

Что спросят на собеседовании

  • Почему в контейнере нужен gunicorn, а не встроенный сервер Flask?
    Встроенный — один процесс без присмотра: упал или завис — отвечать некому, при остановке запросы обрываются. Gunicorn держит несколько рабочих, поднимает упавших и останавливается аккуратно. Встроенный сервер для разработки и сам об этом предупреждает.
  • Как связать работающий контейнер с исходным кодом?
    Тегом с коротким хешем коммита и записанным digest: тег для человека, digest для машины.
  • Сколько рабочих процессов ставить в контейнере?
    От выделенного контейнеру лимита процессора, а не от числа ядер хоста, и задавать числом в настройках, а не зашивать навсегда.

Что дальше

Приложение стало артефактом с версией, digest и понятным составом. Но запускается оно командой с десятком флагов, а рядом скоро встанет база. Дальше — урок со шпаргалкой раздела, а затем Docker Compose: вся связка одним файлом.

Практика 05+400 XP

Собрать образ по всем правилам раздела и запустить его как в эксплуатации: gunicorn, проверка здоровья, лимиты, свой реестр, теги и паспорт образа.

  • Контейнер prod работает и здоров
  • Приложение работает под gunicorn с несколькими процессами
  • Задан лимит памяти
  • Задан лимит процессора
  • В реестре версия и тег коммита
  • Приложение отвечает на петле и не торчит наружу
  • Паспорт образа составлен
Команда сдачи — выполни на своей машине
команда
docker ps --filter name=prod --format 'STATUS={{.Status}}'; docker top prod | grep -c gunicorn; docker inspect prod | grep -E '"(Memory|NanoCpus)"'; curl -s localhost:5000/v2/provision/app/tags/list; echo; curl -s localhost:8012/whoami; echo; echo "OUTSIDE=$(ss -tln | grep -c '0.0.0.0:8012')"; cat ~/devops-lab/reports/image-passport.txt

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.