Раньше ответ на вопрос «как поднять окружение для этого приложения» жил в вики на три страницы: поставь такую-то версию Python, скачай пакеты, создай пользователя, не забудь переменную. Шаги пропускали, и окружения у всех получались чуть разными. Dockerfile заменяет эту вики двадцатью строками, которые машина выполняет сама. Это текстовый файл с рецептом образа: с какой основы начать, какие файлы положить, что установить и какую программу запускать.
Docker читает его сверху вниз, выполняет каждую инструкцию и в конце получает готовый образ — одинаковый на ноутбуке и на сборочном сервере. Файл лежит в репозитории рядом с кодом и правится как обычный текст: его видит и коллега, и конвейер CI, который ждёт тебя через несколько разделов. Для первого работающего образа хватает пяти инструкций — их и разберём. Ещё несколько добавляют сверху, когда образ уже собирается и запускается; их назовём в конце, а попробуешь в практике.
Если ты писал Dockerfile сам — этот урок можно пролистать и сразу открыть практику «первый образ приложения». Сдалась с первого раза — значит, ничего нового здесь для тебя нет; не сдалась — вернись сюда за тем, на чём споткнулся.
Основа и рабочий каталог
Любой образ строится поверх другого, готового. Для приложения на Python берут официальный образ Python — в нём уже есть интерпретатор и pip.
FROM python:3.12-slim WORKDIR /app
FROM задаёт основу. Версия после двоеточия — тег, и пишут его всегда явно: python:latest сегодня и через полгода — разные образы, и сборка перестаёт повторяться. Слово slim — урезанный вариант без компиляторов и документации, он в несколько раз легче полного.
WORKDIR назначает рабочий каталог для всех следующих инструкций и сам его создаёт. Писать вместо него RUN cd /app бесполезно: cd действует только внутри своей строки.
Пока в образе есть только основа и пустой рабочий каталог — ни кода, ни зависимостей, запускать нечего.
Файлы и установка
Две инструкции делают основную работу: COPY кладёт файлы с машины в образ, RUN выполняет команду внутри образа во время сборки.
COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . .
Первая строка копирует список зависимостей в рабочий каталог — точка значит «сюда». Вторая ставит их; флаг --no-cache-dir не даёт pip сохранять в образе свой кеш скачанных пакетов, это лишние десятки мегабайт. Третья копирует весь остальной код.
Почему код копируется отдельно и последним — тема следующего урока про кеш. Пока запомни порядок: сначала зависимости, потом код.
Код и зависимости на месте. Осталось сказать, что запускать.
Команда запуска
Последняя инструкция говорит, какую программу запустить в контейнере. Пишут её массивом в квадратных скобках — это называется exec-форма.
CMD ["python", "main.py"]Форма важнее, чем кажется. Если написать строкой, CMD python main.py, Docker запустит приложение через оболочку sh, и главным процессом контейнера станет оболочка. При docker stop сигнал остановки SIGTERM — вежливая просьба завершиться — получит она, а приложению не передаст. Docker подождёт десять секунд и убьёт контейнер жёстко, оборвав текущие запросы.
Отсюда правило отладки: docker stop длится ровно десять секунд — значит, сигнал до приложения не дошёл. Одной exec-формы для этого иногда мало, и как это чинится, ты увидишь в практике. Рядом с CMD иногда стоит ENTRYPOINT; здесь достаточно знать, что такое есть, — в чужих образах ты его встретишь.
Сборка и .dockerignore
Рецепт готов, образ собирается одной командой docker build.
docker build -t app:1.0 .[+] 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/.
Словарь урока
Что спросят на собеседовании
- Чем CMD отличается от ENTRYPOINT?ENTRYPOINT задаёт программу, CMD — аргументы по умолчанию. Аргументы docker run заменяют CMD целиком и дописываются к ENTRYPOINT.
- docker stop всегда занимает десять секунд. Почему?SIGTERM не дошёл до приложения. Либо CMD записан строкой и сигнал получил sh, либо приложение — процесс номер 1 без обработчика SIGTERM, и ядро сигнал проигнорировало. Docker дождался таймаута и убил контейнер. Лечат exec-формой плюс STOPSIGNAL, --init или сервером с обработчиком.
- Почему не пишут FROM python:latest?latest — подвижная метка: через месяц тот же Dockerfile соберёт другой образ, и сборка сломается без единой правки.
Что дальше
Из чего состоит рецепт, понятно. Дальше — почему порядок строк решает, будет сборка идти две минуты или две секунды.