Provision
—— XP

Практика: первый образ приложения

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

Копии приложения из раздела про nginx поднимались руками командой python3 -m http.server и не переживали перезагрузку стенда. Теперь у стенда будет настоящее маленькое приложение, собранное в образ: его можно запустить на любой машине одной командой.

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

Шаг 1. Каталог приложения

Всё, что относится к стенду, живёт в репозитории ~/infra из раздела про Git. Приложению заведём там свой каталог.

ubuntu@stand:~$
mkdir -p ~/infra/app
ubuntu@stand:~$
cd ~/infra/app

Флаг -p создаёт и промежуточные каталоги, если их нет, и молчит, если каталог уже есть.

Шаг 2. Код приложения

Это крошечное веб-приложение на Flask с двумя адресами: /health отвечает «жив», /whoami рассказывает о себе. Писать на Python DevOps-инженеру не обязательно — файл просто скопируй, а нам важны три вещи, о которых ниже.

nano ~/infra/app/main.py
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 приложение было бы доступно только изнутри самого контейнера.

Список зависимостей — одна строка.

nano ~/infra/app/requirements.txt
flask==3.0.3

Шаг 3. Минимальный Dockerfile

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

nano ~/infra/app/Dockerfile
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 и смотрим, сколько занимает каждый шаг.

ubuntu@stand:~$
docker build -t provision-app:1.0 .
ubuntu@stand:~$
[+] 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.

ubuntu@stand:~$
docker run -d --name app -p 8010:8000 provision-app:1.0

Флаг -d — фон, --name app — короткое имя контейнера (образ при этом называется provision-app), -p 8010:8000 — порт 8010 стенда ведёт на 8000 внутри контейнера. Спрашиваем приложение о себе.

ubuntu@stand:~$
curl -s localhost:8010/whoami
ubuntu@stand:~$
{"app":"provision-app","host":"438e1f92a446","pid":1,"version":"1.0.0"}

Два поля важны. host равен идентификатору контейнера: у контейнера своё имя машины. pid равен единице: приложение стало первым процессом внутри контейнера, значит exec-форма CMD сработала.

Минимальный образ работает. Дальше — что в нём не так.

Шаг 6. Правка кода пересобирает всё

Изобразим, что разработчик поправил код: допишем в конец main.py строку-комментарий. Для Python это пустяк, а для Docker — изменившийся файл.

ubuntu@stand:~$
echo '# v2' >> main.py

Два знака >> дописывают строку в конец файла, не стирая его. Собираем снова.

ubuntu@stand:~$
docker build -t provision-app:1.0 .
ubuntu@stand:~$
[+] 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. Сначала зависимости, потом код

Лекарство — разделить копирование на два: сначала только список зависимостей и их установку, потом остальной код.

nano ~/infra/app/Dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "main.py"]

Собери образ с новым порядком.

ubuntu@stand:~$
docker build -t provision-app:1.0 .
ubuntu@stand:~$
[+] 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

Первый раз зависимости ставятся заново: шаги поменялись, и старые слои к ним не подходят. Теперь снова поправь код и собери ещё раз.

ubuntu@stand:~$
echo '# v3' >> main.py
ubuntu@stand:~$
docker build -t provision-app:1.0 .
ubuntu@stand:~$
[+] 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 останавливает и удаляет работающий контейнер одной командой.

ubuntu@stand:~$
docker rm -f app
ubuntu@stand:~$
docker run -d --name app -p 8010:8000 provision-app:1.0

Теперь замерим остановку. Команда time перед любой другой меряет, сколько та работала.

ubuntu@stand:~$
time docker stop app
ubuntu@stand:~$
app
real    0m10.285s

Ровно десять секунд. docker stop шлёт процессу номер 1 сигнал SIGTERM — «пора завершаться» — и ждёт. Встроенный сервер Flask, будучи процессом номер 1, на SIGTERM не отвечает. Через десять секунд Docker теряет терпение и убивает контейнер сигналом SIGKILL — приложение не успевает ничего закрыть.

Встроенный сервер Flask зато понимает SIGINT — тот же сигнал, что приходит от Ctrl+C. Инструкция STOPSIGNAL говорит Docker, какой сигнал слать при остановке. Добавь её перед CMD.

~/infra/app/Dockerfile, перед строкой CMD
STOPSIGNAL SIGINT

Пересобери образ, замени контейнер (две команды выше) и замерь снова.

ubuntu@stand:~$
time docker stop app
ubuntu@stand:~$
app
real    0m0.289s

Меньше секунды: сигнал дошёл, приложение завершилось само. Есть и другие пути: настоящий сервер приложений вроде gunicorn сам слушает SIGTERM, и STOPSIGNAL ему не нужен — к этому мы придём в миссии раздела. Другая частая причина тех же десяти секунд — CMD строкой без скобок: тогда процессом номер 1 становится оболочка sh, и сигнал достаётся ей, а не приложению. Возвращаем контейнер.

ubuntu@stand:~$
docker start app

Шаг 9. Процесс работает от root

Проверим, от чьего имени работает приложение.

ubuntu@stand:~$
docker exec app id -un
ubuntu@stand:~$
root

Команда id -un печатает имя текущего пользователя. Если в Dockerfile не сказано иное, всё внутри контейнера идёт от root. Найдёт кто-то уязвимость в приложении — получит права root внутри контейнера, а это на шаг ближе к самой машине.

Заведём обычного пользователя и переключимся на него. Строку useradd поставь сразу после WORKDIR, а USER — после COPY . ..

~/infra/app/Dockerfile, после WORKDIR
RUN useradd --uid 10001 appuser
~/infra/app/Dockerfile, после COPY . .
USER appuser

useradd создаёт пользователя appuser с номером 10001 — заметно больше обычных, чтобы не совпасть с пользователем на самой машине. Строка стоит наверху, потому что не меняется никогда, и её слой всегда берётся из кеша. USER стоит после установки зависимостей: ставить пакеты всё ещё нужно от root, а запускать приложение — уже нет. Пересобери, замени контейнер и проверь.

ubuntu@stand:~$
docker exec app id -un
ubuntu@stand:~$
appuser

Другой вариант — флаг --user 10001 у docker run: он сработает и без правки образа, но про него надо помнить при каждом запуске. Инструкция в Dockerfile надёжнее.

Шаг 10. Docker не знает, живо ли приложение

Посмотрим на контейнер в списке.

ubuntu@stand:~$
docker ps
ubuntu@stand:~$
IMAGE               STATUS         PORTS                    NAMES
provision-app:1.0   Up 2 seconds   0.0.0.0:8010->8000/tcp   app

Up значит только «процесс не завершился». Зависни приложение или перестань отвечать на запросы — статус останется тем же. Инструкция HEALTHCHECK говорит Docker, как проверять, живо ли оно на самом деле. Добавь её перед STOPSIGNAL.

~/infra/app/Dockerfile, перед 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 одной строкой. Пересобери, замени контейнер и сразу посмотри список.

ubuntu@stand:~$
docker ps
ubuntu@stand:~$
IMAGE               STATUS                             NAMES
provision-app:1.0   Up 3 seconds (health: starting)    app

Первая проверка ещё не прошла. Через десять-пятнадцать секунд:

ubuntu@stand:~$
IMAGE               STATUS                    NAMES
provision-app:1.0   Up 15 seconds (healthy)   app

healthy — приложение ответило. Не ответит три раза подряд — станет unhealthy. Сам Docker такой контейнер не перезапускает, но Compose и оркестраторы по этому статусу решают, пускать ли на него трафик и ждать ли его перед запуском соседей. Ещё есть параметры --timeout (сколько ждать ответа), --retries (сколько неудач подряд считать падением) и --start-period (сколько дать на запуск), их значения по умолчанию нам пока подходят.

Шаг 11. Пароль уехал в образ

У настоящего приложения рядом с кодом обычно лежит .env с паролями. Изобразим его.

ubuntu@stand:~$
echo 'DB_PASSWORD=Secret123' > .env

Пересобери образ и загляни в него: флаг --rm удалит контейнер сразу после команды.

ubuntu@stand:~$
docker run --rm provision-app:1.0 cat /app/.env
ubuntu@stand:~$
DB_PASSWORD=Secret123

COPY . . скопировала весь каталог, включая пароль. Отправишь такой образ в реестр — пароль уедет вместе с ним к каждому, кто его скачает. Файл .dockerignore рядом с Dockerfile перечисляет, что не отдавать в сборку, по одному шаблону в строке.

nano ~/infra/app/.dockerignore
.env
.git
__pycache__
*.log

Кроме .env здесь кеш Python и журналы. Строка .git на будущее: сейчас каталог .git лежит уровнем выше, в ~/infra, и в сборку не попадает. Но стоит перенести Dockerfile в корень репозитория — и без этой строки вся история уедет в образ. Пересобери и проверь снова.

ubuntu@stand:~$
docker run --rm provision-app:1.0 cat /app/.env
ubuntu@stand:~$
cat: /app/.env: No such file or directory

Пароля в образе нет. Как передать его приложению правильно — переменными окружения при запуске, — разберём в уроке про сети и конфигурацию.

Шаг 12. Итоговый файл

Вот что получилось из пяти строк, сверь со своим.

~/infra/app/Dockerfile
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. Замени его последний раз — для сдачи он должен работать именно с этим файлом.

ubuntu@stand:~$
docker rm -f app
ubuntu@stand:~$
docker run -d --name app -p 8010:8000 provision-app:1.0

Шаг 13. Зафиксировать в репозитории

Dockerfile — такой же исходный код, как приложение, и живёт он в том же репозитории. Файл .env с паролем удали: в репозиторий он попасть не должен, а приложению пока не нужен.

ubuntu@stand:~$
rm .env
ubuntu@stand:~$
git -C ~/infra add app

Флаг -C заставляет Git работать в указанном каталоге, где бы ты ни стоял.

ubuntu@stand:~$
git -C ~/infra commit -m "app: приложение стенда в образе"

Если что-то не работает

Симптомов немного, и каждый указывает на своё место.

Симптом и причина
curl: connection refused
Порт не опубликован, либо приложение слушает 127.0.0.1 внутри контейнера.
Контейнер сразу Exited
Главный процесс завершился. docker logs app — причина там одной строкой, часто опечатка в main.py.
STATUS (unhealthy)
HEALTHCHECK не проходит: проверь адрес и порт в нём, приложение должно слушать 8000.
Conflict: name is already in use
Контейнер с таким именем уже есть: docker rm -f app и запустить снова.
docker stop идёт ровно 10 с
Сигнал не дошёл до приложения: CMD записан строкой или в Dockerfile нет STOPSIGNAL SIGINT.

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

  • Почему приложение в контейнере должно слушать 0.0.0.0?
    127.0.0.1 внутри контейнера — его собственная петля, снаружи она недостижима. На опубликованном порту будет connection refused.
  • Зачем HEALTHCHECK, если есть журнал?
    Он даёт машиночитаемое состояние: Docker, Compose и оркестраторы по нему решают, перезапускать ли контейнер и пускать ли на него трафик.
Практика 02+400 XP

Собрать образ приложения стенда, увидеть работу кеша сборки и запустить контейнер как положено: не от root и с командой в exec-форме.

  • Контейнер работает и здоров
  • Приложение отвечает через опубликованный порт
  • Приложение — процесс номер 1
  • Процесс работает не от root
  • Зависимости ставятся до копирования кода
  • Контейнер останавливается сразу
  • В образе объявлена проверка здоровья
  • Контекст сборки ограничен
Команда сдачи — выполни на своей машине
команда
docker ps --filter name=app --format 'NAME={{.Names}} STATUS={{.Status}}'; curl -s localhost:8010/whoami; echo; echo "USER=$(docker exec app id -un)"; cat ~/infra/app/Dockerfile ~/infra/app/.dockerignore

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