Почему multi-stage сборка уменьшает размер Docker-образа?

Question

Размер образа уменьшается потому, что в финальный этап не попадают build-инструменты, временные файлы и промежуточные результаты. Docker берёт только то, что явно скопировали из предыдущих стадий. Поэтому компиляторы, заголовки, кэш пакетных менеджеров и прочее остаются в builder-стадии. В итоге production-образ содержит только runtime и готовые зависимости.

YeaHub · Accepted Answer

Чтобы понять, почему multi-stage уменьшает размер, нужно помнить: каждый FROM начинает новую цепочку слоёв, а итоговый образ берётся только из последней стадии. Предыдущие стадии существуют “для сборки”, но не входят в финальный образ напрямую.Откуда берётся большой размер в обычной сборкеBuild-инструментыgcc, make, build-essential, python-dev и т.п.они нужны только чтобы собрать зависимости, но не нужны для запускаВременные файлы и кэшикэш aptкэш pip (если не отключать)временные файлы сборки пакетовПромежуточные артефактыисходники библиотекраспакованные архивытестовые/документные файлы, которые случайно осталисьЧто делает multi-stage по-другомуРазделяет “сборку” и “запуск”стадия builder может быть сколько угодно “толстой”стадия runtime остаётся “тонкой”Контролирует, что попадёт в финалФинальный образ получает только то, что вы явно скопировали:COPY --from=builder /install /usr/local
Это означает:нет компиляторанет кэша aptнет временных директорий сборкинет лишних пакетовПозволяет минимизировать runtime-библиотекиЕсли нужны системные библиотеки для работы (например, libpq для Postgres), вы ставите только их, а не весь набор для сборки.Практическая иллюстрация на уровне логикиОбычная сборка:поставили build-essentialсобрали зависимостиbuild-essential остался в образе навсегда → + десятки/сотни мегабайтMulti-stage:build-essential стоит только в builderruntime начинается “с чистого slim”копируются только готовые зависимости → образ заметно меньшеВыводMulti-stage уменьшает размер потому, что финальный образ не наследует слои со сборочными инструментами и мусором. Он содержит только runtime и необходимые артефакты, которые вы явно перенесли из builder-стадии.