В первой практике раздела мы оставили внутри образа отладочный сервер Flask. Он сам предупреждает при старте, что не предназначен для эксплуатации: работает одним процессом, упавшее не поднимает и не умеет аккуратно доработать запросы при остановке. Пора его заменить и собрать всё остальное: свой реестр, теги, по которым находятся исходники, лимиты и документ о том, что именно работает.
Миссия — задание: команды даны, а вывод на экране проверяешь сам по описанию.
Требования
Задача одна, но проверяется по пунктам.
Шаг 1. Сервер приложений
Gunicorn — сервер приложений для Python: он держит несколько рабочих процессов, поднимает упавшие и раздаёт им запросы. Встроенный сервер Flask рассчитан на разработку: запросы он принимает в потоках одного процесса, и если этот процесс упадёт или зависнет, отвечать некому. Добавь gunicorn в зависимости.
flask==3.0.3 psycopg2==2.9.9 gunicorn==23.0.0
Шаг 2. Самая короткая команда
Замени последнюю строку Dockerfile. По-прежнему массив, то есть exec-форма: главным процессом станет gunicorn.
CMD ["gunicorn", "main:app"]main:app — файл main.py и объект app в нём, единственное, без чего gunicorn не запустится. Строку STOPSIGNAL SIGINT из Dockerfile удали. Она была нужна встроенному серверу Flask, который не слушал SIGTERM. Gunicorn слушает сам и понимает сигналы по-разному: на SIGTERM он даёт рабочим доделать текущие запросы и только потом выходит, а на SIGINT выходит сразу, обрывая их. Нам нужно первое, а SIGTERM Docker шлёт по умолчанию.
Шаг 3. Собрать и попробовать
Соберём и запустим пробный контейнер try на свободном порту 8099.
cd ~/infra/appdocker build -t provision-app:3.0 .Имя образа сохраним в переменной шелла T, чтобы команда запуска осталась короткой.
T=provision-app:3.0docker run -d --name try -p 127.0.0.1:8099:8000 $Tcurl -sS localhost:8099/whoamicurl: (56) Recv failure: Connection reset by peerПорт опубликован, а ответа нет. Журнал скажет, где слушает gunicorn:
docker logs try[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:
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "main:app"]Пересобери, удали пробный контейнер (docker rm -f try) и запусти его снова той же командой.
curl -s localhost:8099/whoami{"app":"provision-app","host":"1c2f0b8a9e31","pid":7,"version":"1.0.0"}Ответил. pid теперь не единица: первым номером идёт мастер gunicorn, а запрос обслужил рабочий процесс.
Шаг 5. Сколько рабочих
Сколько их всего, покажет docker top — процессы контейнера, как ps на хосте.
docker top try -o pid,argsPID 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 задаёт число; его считают от лимита процессора контейнера, а не от ядер машины. Нам хватит двух:
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "2", "main:app"]Пересобери и перезапусти try — docker top покажет три строки: мастер и два рабочих.
Шаг 6. Журнал запросов
Сделай запрос и загляни в журнал.
docker logs try --tail 2[INFO] Booting worker with pid: 7 [INFO] Booting worker with pid: 8
Запроса в журнале нет: gunicorn по умолчанию не пишет журнал запросов. Флаг --access-logfile - включает его и направляет в стандартный вывод (-), туда, где его видит docker logs.
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "2", "--access-logfile", "-", "main:app"]Пересобери, перезапусти, сделай запрос — теперь в журнале строка:
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.
git -C ~/infra add appgit -C ~/infra commit -m "app: gunicorn"Шаг 8. Собрать
Последняя сборка третьей версии — уже с закоммиченным Dockerfile. Слои возьмутся из кеша, сборка займёт секунды.
docker build -t provision-app:3.0 .Шаг 9. Свой реестр
Реестр — это контейнер из образа registry:3. Публикуем его только на петлю: пароля и шифрования у него нет.
docker run -d -p 127.0.0.1:5000:5000 registry:3Имя мы не задали, чтобы команда осталась короткой, и Docker придумал его сам. Флаг -l у docker ps показывает последний созданный контейнер — посмотри, как его назвали.
docker ps -lПереименуй контейнер в registry, подставив своё случайное имя из колонки NAMES, и включи ему перезапуск после перезагрузки машины. Команда docker update меняет настройки уже созданного контейнера.
docker rename eager_turing registrydocker update --restart unless-stopped registryПолитика unless-stopped — поднимать контейнер после сбоя и после перезагрузки, но не после того, как его остановили руками.
Шаг 10. Теги
Чтобы не набирать длинный адрес реестра каждый раз, снова кладём его в переменную оболочки, как в уроке про реестр.
REPO=localhost:5000/provision/appПеременная живёт, пока открыт этот терминал. Если прервёшься и вернёшься в новом сеансе, $REPO окажется пустым, и Docker ответит invalid reference format. Тогда просто выполни строку выше ещё раз — и IMG из шага 12 тоже. Всё остальное, что сделано до перерыва, лежит на диске и никуда не денется.
Первый тег — версия релиза.
docker tag provision-app:3.0 $REPO:1.0.0Второй — короткий хеш текущего коммита репозитория ~/infra, того, что ты сделал на шаге 7. Узнай его.
git -C ~/infra rev-parse --short HEADПодставь свой хеш вместо a2f5d81.
docker tag provision-app:3.0 $REPO:sha-a2f5d81Шаг 11. Отправить в реестр
Флаг --all-tags отправляет все теги этого репозитория разом.
docker push --all-tags $REPOСпроси реестр, что в нём лежит. У него есть простой HTTP-интерфейс.
curl -s localhost:5000/v2/provision/app/tags/listОжидается JSON со списком из двух тегов. Digest образа покажет docker images --digests $REPO — запиши его, он понадобится для паспорта.
Шаг 12. Запустить как в эксплуатации
Контейнеры из прошлых практик больше не нужны: app на 8010 и app2 на 8011.
docker rm -f app app2Запускаем образ из реестра, опубликовав порт только на петлю: снаружи к нему не попасть, а вход для людей в разделе про Compose встанет перед ним — nginx в контейнере. Ещё одна переменная — полное имя образа.
IMG=$REPO:1.0.0docker run -d --name prod -p 127.0.0.1:8012:8000 $IMGШаг 13. Лимиты и перезапуск
Лимиты можно было дать прямо в docker run, но команда растянулась бы на полэкрана. Зададим их по одному. --memory — потолок памяти; --memory-swap с тем же числом запрещает уходить в подкачку сверх него.
docker update --memory 512m --memory-swap 512m proddocker update --cpus 1 proddocker update --restart unless-stopped prodОбрати внимание, сколько флагов накопилось у одного контейнера. Запомнить и повторить их на другой машине трудно — ровно эту задачу решает Docker Compose из следующего раздела.
Шаг 14. Проверить
Через полминуты контейнер должен стать здоровым.
docker psВ строке prod ожидается Up … (healthy). Теперь посмотрим процессы внутри: docker top показывает их так же, как ps на хосте.
docker top prodСтрок gunicorn должно быть три: мастер и два рабочих. Спроси приложение о себе.
curl -s localhost:8012/whoamiПоле pid теперь не единица — и это правильно: на запрос ответил рабочий процесс, а первым номером идёт мастер. Остановка по-прежнему должна быть быстрой.
time docker stop prodОколо секунды: мастер получил SIGTERM, дал рабочим закончить запросы и вышел. Верни контейнер.
docker start prodШаг 15. Паспорт образа
Паспорт — документ, по которому через полгода понятно, что это за образ и как он запущен. Пример структуры — ниже, значения подставь свои.
ОБРАЗ 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, пароля у реестра, базы данных СЛОМАЕТСЯ длинная команда запуска: на новой машине её не повторить
Если что-то не сходится
Каждый несошедшийся пункт указывает на своё место.
Что спросят на собеседовании
- Почему в контейнере нужен gunicorn, а не встроенный сервер Flask?Встроенный — один процесс без присмотра: упал или завис — отвечать некому, при остановке запросы обрываются. Gunicorn держит несколько рабочих, поднимает упавших и останавливается аккуратно. Встроенный сервер для разработки и сам об этом предупреждает.
- Как связать работающий контейнер с исходным кодом?Тегом с коротким хешем коммита и записанным digest: тег для человека, digest для машины.
- Сколько рабочих процессов ставить в контейнере?От выделенного контейнеру лимита процессора, а не от числа ядер хоста, и задавать числом в настройках, а не зашивать навсегда.
Что дальше
Приложение стало артефактом с версией, digest и понятным составом. Но запускается оно командой с десятком флагов, а рядом скоро встанет база. Дальше — урок со шпаргалкой раздела, а затем Docker Compose: вся связка одним файлом.