Provision
—— XP

Dockerfile: рецепт образа

теория~6 минут+160 XP

Раньше ответ на вопрос «как поднять окружение для этого приложения» жил в вики на три страницы: поставь такую-то версию Python, скачай пакеты, создай пользователя, не забудь переменную. Шаги пропускали, и окружения у всех получались чуть разными. Dockerfile заменяет эту вики двадцатью строками, которые машина выполняет сама. Это текстовый файл с рецептом образа: с какой основы начать, какие файлы положить, что установить и какую программу запускать.

Docker читает его сверху вниз, выполняет каждую инструкцию и в конце получает готовый образ — одинаковый на ноутбуке и на сборочном сервере. Файл лежит в репозитории рядом с кодом и правится как обычный текст: его видит и коллега, и конвейер CI, который ждёт тебя через несколько разделов. Для первого работающего образа хватает пяти инструкций — их и разберём. Ещё несколько добавляют сверху, когда образ уже собирается и запускается; их назовём в конце, а попробуешь в практике.

Если ты писал Dockerfile сам — этот урок можно пролистать и сразу открыть практику «первый образ приложения». Сдалась с первого раза — значит, ничего нового здесь для тебя нет; не сдалась — вернись сюда за тем, на чём споткнулся.

Основа и рабочий каталог

Любой образ строится поверх другого, готового. Для приложения на Python берут официальный образ Python — в нём уже есть интерпретатор и pip.

Dockerfile, начало
FROM python:3.12-slim
WORKDIR /app

FROM задаёт основу. Версия после двоеточия — тег, и пишут его всегда явно: python:latest сегодня и через полгода — разные образы, и сборка перестаёт повторяться. Слово slim — урезанный вариант без компиляторов и документации, он в несколько раз легче полного.

WORKDIR назначает рабочий каталог для всех следующих инструкций и сам его создаёт. Писать вместо него RUN cd /app бесполезно: cd действует только внутри своей строки.

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

Файлы и установка

Две инструкции делают основную работу: COPY кладёт файлы с машины в образ, RUN выполняет команду внутри образа во время сборки.

Dockerfile, середина
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .

Первая строка копирует список зависимостей в рабочий каталог — точка значит «сюда». Вторая ставит их; флаг --no-cache-dir не даёт pip сохранять в образе свой кеш скачанных пакетов, это лишние десятки мегабайт. Третья копирует весь остальной код.

Почему код копируется отдельно и последним — тема следующего урока про кеш. Пока запомни порядок: сначала зависимости, потом код.

Код и зависимости на месте. Осталось сказать, что запускать.

Команда запуска

Последняя инструкция говорит, какую программу запустить в контейнере. Пишут её массивом в квадратных скобках — это называется exec-форма.

Dockerfile, последняя строка
CMD ["python", "main.py"]

Форма важнее, чем кажется. Если написать строкой, CMD python main.py, Docker запустит приложение через оболочку sh, и главным процессом контейнера станет оболочка. При docker stop сигнал остановки SIGTERM — вежливая просьба завершиться — получит она, а приложению не передаст. Docker подождёт десять секунд и убьёт контейнер жёстко, оборвав текущие запросы.

Три случая: только CMD, только ENTRYPOINT и их сочетание. Для каждого показано, что получится при запуске без аргументов и с аргументом bash.
Есть ещё ENTRYPOINT: он задаёт программу, а CMD — её аргументы по умолчанию. В своих образах обычно хватает одного CMD.

Отсюда правило отладки: docker stop длится ровно десять секунд — значит, сигнал до приложения не дошёл. Одной exec-формы для этого иногда мало, и как это чинится, ты увидишь в практике. Рядом с CMD иногда стоит ENTRYPOINT; здесь достаточно знать, что такое есть, — в чужих образах ты его встретишь.

Сборка и .dockerignore

Рецепт готов, образ собирается одной командой docker build.

ubuntu@stand:~$
docker build -t app:1.0 .
ubuntu@stand:~$
[+] Building 24.1s (10/10) FINISHED
 => [1/5] FROM docker.io/library/python:3.12-slim
 => [2/5] WORKDIR /app
 => [3/5] COPY requirements.txt .
 => [4/5] RUN pip install --no-cache-dir -r requirements.txt
 => [5/5] COPY . .
 => => naming to docker.io/library/app:1.0

Флаг -t даёт образу имя и тег. Точка в конце — не украшение: это контекст сборки, каталог, который целиком отправляется демону перед сборкой. В выводе видно шаги по порядку, они совпадают со строками Dockerfile.

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

  • USER — от чьего имени работает процесс; без неё — от root.
  • STOPSIGNAL — каким сигналом docker stop просит контейнер завершиться.
  • HEALTHCHECK — как Docker проверяет, что приложение живо, а не просто запущено.
  • ENV — переменная окружения внутри образа; EXPOSE — пометка «приложение слушает такой-то порт», сама она ничего не открывает: наружу порт выводит флаг -p при запуске.
  • .dockerignore — не инструкция, а файл рядом с Dockerfile: какие файлы не отправлять в контекст сборки. Без него вместе с кодом уезжают .git со всей историей и .env с паролями.

Полный справочник инструкций — в документации Docker, раздел Dockerfile reference: https://docs.docker.com/reference/dockerfile/.

Словарь урока

Dockerfile
Рецепт образа: инструкции, которые Docker выполняет сверху вниз при сборке. ↩ к тексту
Exec-форма
Команда запуска массивом. Приложение становится процессом номер 1 и получает сигнал остановки. ↩ к тексту
STOPSIGNAL
Инструкция Dockerfile: каким сигналом docker stop просит контейнер завершиться. По умолчанию SIGTERM.
Контекст сборки
Каталог, который целиком отправляется демону при docker build. Ограничивается файлом .dockerignore. ↩ к тексту

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

  • Чем CMD отличается от ENTRYPOINT?
    ENTRYPOINT задаёт программу, CMD — аргументы по умолчанию. Аргументы docker run заменяют CMD целиком и дописываются к ENTRYPOINT.
  • docker stop всегда занимает десять секунд. Почему?
    SIGTERM не дошёл до приложения. Либо CMD записан строкой и сигнал получил sh, либо приложение — процесс номер 1 без обработчика SIGTERM, и ядро сигнал проигнорировало. Docker дождался таймаута и убил контейнер. Лечат exec-формой плюс STOPSIGNAL, --init или сервером с обработчиком.
  • Почему не пишут FROM python:latest?
    latest — подвижная метка: через месяц тот же Dockerfile соберёт другой образ, и сборка сломается без единой правки.

Что дальше

Из чего состоит рецепт, понятно. Дальше — почему порядок строк решает, будет сборка идти две минуты или две секунды.

Проверь себя+160 XPдве попытки
1
Инструкции
С какой инструкции начинается Dockerfile?
2
Инструкции
Что делает EXPOSE 8000?
3
Как записать команду запуска
Почему CMD пишут массивом, а не строкой?
4
.dockerignore
Зачем нужен файл .dockerignore?
ответь на все вопросы, чтобы проверить

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