Provision
—— XP

Слои и кеш сборки

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

Разработчик поправил одну букву в коде, ты запускаешь сборку — и Docker снова качает все зависимости, хотя они не менялись. С этим сталкивается почти каждый новичок, и почти всегда дело в порядке строк Dockerfile. Чтобы понять почему, нужно знать, из чего состоит образ. Слой — результат одной инструкции Dockerfile, которая меняет файлы. Образ — это стопка таких слоёв: внизу базовый образ, сверху установленные пакеты, ещё выше код приложения.

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

Из чего состоит образ

Посмотреть слои готового образа можно командой docker history. Она печатает инструкции снизу вверх: нижние — самые старые, они пришли из базового образа.

ubuntu@stand:~$
docker history app:1.0
ubuntu@stand:~$
IMAGE          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. Если нет — выполняет шаг заново, и все шаги ниже тоже, потому что они построены поверх изменившегося.

Вверху правило работы кеша. Ниже два варианта Dockerfile: слева копирование всего кода до установки зависимостей, справа сначала файл со списком зависимостей. Итог — три минуты против четырёх секунд.
Правка одной строки кода в левом варианте отменяет кеш и у копирования, и у всего, что ниже. В правом отменяется только последний слой.

Вот как выглядит повторная сборка после правки одной строки кода при правильном порядке.

ubuntu@stand:~$
docker build -t app:1.0 .
ubuntu@stand:~$
[+] 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 — порядок неверный.

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

Слой
Результат одной инструкции, меняющей файлы. Доступен только на чтение и переиспользуется. ↩ к тексту
Кеш сборки
Переиспользование готовых слоёв. Сбрасывается с первой изменившейся инструкции и до конца файла. ↩ к тексту
docker history
Список слоёв образа с размером каждого — первое, куда смотрят, когда образ слишком тяжёлый.

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

  • Почему зависимости ставят до копирования кода?
    Кеш сбрасывается с первой изменившейся инструкции. Если код скопирован раньше установки, любая правка кода вызывает переустановку всех зависимостей.
  • Удалили файл следующей инструкцией — почему образ не уменьшился?
    Слой лишь помечает файл удалённым, данные остаются в предыдущем слое. Создание и удаление должны быть в одной инструкции.

Что дальше

Теории хватит на первый образ. Дальше — практика: собрать в образ приложение стенда и увидеть кеш своими глазами.

Проверь себя+160 XPдве попытки
1
Слои
Откуда в образе берутся слои?
2
Кеш сборки
Изменилась строка на шаге 3 из 6. Что пересоберётся?
3
Порядок инструкций
Что ставят в начало Dockerfile?
ответь на все вопросы, чтобы проверить

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