Разработчик поправил одну букву в коде, ты запускаешь сборку — и Docker снова качает все зависимости, хотя они не менялись. С этим сталкивается почти каждый новичок, и почти всегда дело в порядке строк Dockerfile. Чтобы понять почему, нужно знать, из чего состоит образ. Слой — результат одной инструкции Dockerfile, которая меняет файлы. Образ — это стопка таких слоёв: внизу базовый образ, сверху установленные пакеты, ещё выше код приложения.
Слои Docker хранит по отдельности и при повторной сборке берёт готовые, если инструкция и её файлы не изменились. Это называется кеш сборки, и от него зависит, сколько ждать каждой сборки: две секунды или две минуты. Работает он как сохранения в компьютерной игре: ошибся на пятом уровне — загружаешься с последнего сохранения перед ошибкой, а не начинаешь с первого. Docker так же идёт по инструкциям сверху и берёт готовое, пока ничего не изменилось.
Из чего состоит образ
Посмотреть слои готового образа можно командой docker history. Она печатает инструкции снизу вверх: нижние — самые старые, они пришли из базового образа.
docker history app:1.0IMAGE CREATED CREATED BY SIZE a2a34da434f4 41 minutes ago CMD ["python" "main.py"] 0B <missing> 41 minutes ago USER appuser 0B <missing> 41 minutes ago COPY . . # buildkit 28.7kB <missing> 41 minutes ago RUN /bin/sh -c pip install --no-cache-dir -r… 15.4MB <missing> 41 minutes ago COPY requirements.txt . # buildkit 12.3kB <missing> 13 days ago WORKDIR /app 8.19kB
Вывод сокращён: справа убрана колонка COMMENT, снизу — строки базового образа. Длинные инструкции Docker обрезает многоточием, полностью их покажет флаг --no-trunc. Приписка # buildkit — имя сборщика: BuildKit собирает образы в современном Docker, и так он помечает свои шаги. А /bin/sh -c перед pip напоминает, что RUN в строковой форме выполняется через оболочку.
Смотреть стоит на колонку SIZE: сразу видно, какой шаг сколько весит. Здесь тяжелее всех установка зависимостей. Нулевые строки — не ошибка: CMD и ENV только записывают настройки и файлов не добавляют. Слово <missing> вместо номера тоже нормально: свой номер есть только у итогового образа.
У слоёв есть неприятное свойство. Если в одной инструкции скачать архив, а в следующей удалить его, образ не похудеет: удаление только пометит файл, а данные останутся в предыдущем слое. Поэтому мусор убирают в той же строке RUN, где его создали.
Слои дают не только экономию места — на них построен кеш.
Как работает кеш
Перед каждым шагом Docker проверяет: такая же инструкция с такими же файлами уже выполнялась? Если да — берёт готовый слой, и в выводе сборки появляется слово CACHED. Если нет — выполняет шаг заново, и все шаги ниже тоже, потому что они построены поверх изменившегося.
Вот как выглядит повторная сборка после правки одной строки кода при правильном порядке.
docker build -t app:1.0 .[+] Building 1.9s (10/10) FINISHED => CACHED [2/5] WORKDIR /app => CACHED [3/5] COPY requirements.txt . => CACHED [4/5] RUN pip install --no-cache-dir -r requirements.txt => [5/5] COPY . .
Три шага взяты готовыми, заново выполнилось только копирование кода. Две секунды вместо двадцати.
Только выигрыш этот случился потому, что строки стояли в удачном порядке: переставь их — и зависимости снова поедут с нуля.
Порядок инструкций
Типичная ошибка выглядит невинно: COPY . . первой строкой, установка зависимостей после. Человеческая логика — сначала принести всё, потом работать. Но тогда любая правка кода меняет скопированные файлы, кеш сбрасывается на копировании и pip install честно идёт в сеть при каждой сборке.
Правило одно: сверху то, что меняется реже всего. Базовый образ и системные пакеты меняются раз в месяцы, список зависимостей — раз в недели, код — по десять раз в день. Именно поэтому в прошлом уроке requirements.txt копировался отдельно и раньше кода.
Проверка простая: поправь строку кода и пересобери. Если в выводе снова пошла установка зависимостей без слова CACHED — порядок неверный.
Словарь урока
Что спросят на собеседовании
- Почему зависимости ставят до копирования кода?Кеш сбрасывается с первой изменившейся инструкции. Если код скопирован раньше установки, любая правка кода вызывает переустановку всех зависимостей.
- Удалили файл следующей инструкцией — почему образ не уменьшился?Слой лишь помечает файл удалённым, данные остаются в предыдущем слое. Создание и удаление должны быть в одной инструкции.
Что дальше
Теории хватит на первый образ. Дальше — практика: собрать в образ приложение стенда и увидеть кеш своими глазами.