Введение

Контейнеризация Python-приложений требует внимательного подхода к формированию финального образа. Стандартный подход с одной базовой системы часто приводит к раздуванию размера контейнера и увеличению времени деплоя. Чтобы создать многоступенчатый dockerfile, необходимо разделить процесс сборки и выполнения. Это позволяет изолировать инструменты компиляции, зависимости и временные файлы от легковесного runtime-окружения, что напрямую влияет на безопасность и скорость обновления кластеров.

Архитектура сборки

Каждый этап сборки обозначается инструкцией FROM. Первый этап (build-stage) использует полную версию образа, где установлены компиляторы C/C++, заголовочные файлы и системные утилиты. На этом этапе выполняется установка зависимостей через pip и компиляция нативных расширений. Второй этап (runtime-stage) копирует только артефакты первой стадии в минимальный образ. Такой подход критически важен, так как основная цель — оптимизация образа в production-средах, поскольку исключает из финального контейнера лишние уязвимости и отладочные инструменты.

Практическая реализация

Ниже приведен типовой dockerfile для типичного веб-приложения на FastAPI или Django. Обратите внимание на использование COPY --from=0 для переноса скомпилированных пакетов без установки системных зависимостей.

FROM python:3.12 AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir --prefix=/install -r requirements.txt

FROM python:3.12-slim AS runtime
WORKDIR /app
COPY --from=builder /install /usr/local
COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Сравнение подходов

Параметр	Одноэтапный	Многоступенчатый
Размер образа	900–1200 МБ	120–180 МБ
Время сборки	Быстрое	Увеличено на 15–20%
Безопасность	Низкая (лишние пакеты)	Высокая (минимум зависимостей)
Удобство отладки	Простое	Требует настройки промежуточных стадий

Ключевые рекомендации

При работе с python проектами всегда используйте --no-cache-dir для pip и --prefix для изоляции пакетов. Избегайте копирования каталога .git или тестовых файлов на финальный этап. Применяйте docker buildx для кэширования слоев и ускоряйте сборку за счет параллельных операций. Правильная структура dockerfile гарантирует предсказуемость развертывания и снижает нагрузку на реестры контейнеров. Рекомендуется также настраивать .dockerignore для исключения логов и временных файлов, а также объединять команды RUN для минимизации слоев.

Вопрос-ответ (FAQ)

Как проверить размер промежуточных слоев?

Используйте команду docker build --progress=plain -t app:test . или утилиту docker history для анализа каждого этапа сборки и выявления лишних данных.

Можно ли использовать alpine вместо slim?

Да, но образы на базе musl libc часто требуют дополнительной настройки для компиляции C-расширений. Для python проектов slim-версии предпочтительнее из-за совместимости с glibc.

Как передать переменные окружения между этапами?

Переменные не сохраняются автоматически. Используйте инструкцию ENV на каждом этапе или передавайте их через ARG во время сборки, явно прописывая COPY конфигурационных файлов.