Сборка, которую не страшно повторить

В большом проекте установка зависимостей может занимать минуты, а исходник меняется несколько раз в час. Если сначала копировать весь проект, изменение одной строки кода заставит пересмотреть и следующие шаги сборки. Поэтому файлы зависимостей часто копируют раньше исходников.

# Схема для проекта с зависимостями, не для офлайн-лаборатории:
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .

BuildKit переиспользует подходящий результат из кэша, когда инструкция и её зависимости не изменились. Указанный у pip параметр относится к кэшу самого pip, а не отключает кэш Docker. В нашем сервере сторонних зависимостей нет — добавлять requirements.txt ради этой схемы не нужно.

В учебной проверке каждая попытка получает отдельную машину, поэтому нельзя рассчитывать на кэш прошлой попытки. Оптимизация не должна быть условием корректности: правильный проект собирается и на чистой машине.

Подробнее: оптимизация кэша в документации Docker.

Тег python:3.12-alpine удобен для выбора семейства образов, но со временем его содержимое может обновиться. Digest указывает на конкретное содержимое образа. Для расследования регрессии полезно сохранять digest базы вместе с ревизией исходников и результатами тестов.

# Форма записи; вместо заглушки нужен настоящий digest:
# FROM python:3.12-alpine@sha256:DIGEST_ИЗ_РЕЕСТРА

Фиксация базы не отменяет обновления безопасности: команда должна осознанно обновлять digest и прогонять тесты. И она не обеспечивает повторяемость всей сборки, если следующий RUN каждый раз скачивает произвольную последнюю версию зависимости.

В лаборатории используйте именно python:3.12-alpine: этот образ подготовлен в среде заранее, доступ к реестру отсутствует. Не копируйте заглушку digest из примера в редактор. Здесь отрабатывается структура образа, а не скачивание новой базы.

Подробнее: фиксация базового образа в документации Docker.

Многостадийная сборка отделяет инструменты подготовки от среды запуска. Каждая инструкция FROM начинает стадию; COPY --from переносит выбранный результат. Например, компилятор может быть нужен в первой стадии, а в последней — только исполняемый файл.

FROM python:3.12-alpine AS prepared
WORKDIR /src
COPY app.py .

FROM python:3.12-alpine
WORKDIR /app
COPY --from=prepared /src/app.py .
CMD ["python", "app.py"]

Этот маленький пример специально не устанавливает пакеты и только показывает движение файла между стадиями. Для одного исходника он сложнее одностадийной сборки и сам по себе не делает образ меньше. В реальном проекте пользу определяет то, какие тяжёлые инструменты остаются за границей финальной стадии.

Не переносите исполняемый файл между произвольными базами без проверки совместимости библиотек и архитектуры. Для итоговой работы курса достаточно одной стадии: качественная сборка должна быть понятной, а не демонстрировать как можно больше инструкций.

Подробнее: многостадийная сборка в документации Docker.