☰
10.11.2025

Что такое Multi-Stage Builds в Docker и зачем они нужны

Оптимизация Docker-образов — важный шаг на пути к быстрому и безопасному деплою. Один из самых мощных инструментов для этого — multi-stage builds. Эта техника позволяет создавать компактные и чистые образы без лишних зависимостей, значительно упрощая поддержку и ускоряя сборку.

В этой статье мы подробно рассмотрим, что такое multi-stage builds в контексте Docker, какие проблемы они решают и как именно работают на практике. Вы узнаете, как с помощью многоступенчатой сборки можно существенно уменьшить размер Docker-образов, улучшить безопасность, повысить производительность процессов CI/CD и упростить управление зависимостями. Мы также разберём реальные примеры использования multi-stage builds для разных языков и технологий — от Go и Node.js до Python и Java. Кроме того, вы получите рекомендации, в каких сценариях стоит применять этот подход, и узнаете, каких ошибок следует избегать.

Разрабатывайте и тестируйте проекты в облаке — гибкая инфраструктура, готовые окружения и мгновенное масштабирование под нужды команды - Начать разработку

Что такое Multi-Stage Builds?

Multi-stage build — это подход, при котором Dockerfile содержит несколько этапов сборки (stages), каждый из которых может использовать свою базовую образ. В конечный образ копируются только нужные артефакты, а все промежуточные зависимости (например, компиляторы, тестовые утилиты) отбрасываются.

Это позволяет:

Пример: Сборка Go-приложения

Обычный подход:

FROM golang:1.21

WORKDIR /app
COPY . .
RUN go build -o myapp

CMD ["./myapp"]

Такой образ содержит весь Go toolchain, хотя он не нужен на продакшене.

Multi-stage решение:

# Этап сборки
FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN go build -o myapp

# Этап запуска
FROM alpine
COPY --from=builder /app/myapp /myapp
ENTRYPOINT ["/myapp"]

Результат: финальный образ весит всего несколько мегабайт и содержит только исполняемый файл.

Почему это важно?

Преимущества multi-stage builds:

Примеры использования

Node.js

# Сборка
FROM node:20 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# Продакшн
FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
CMD ["node", "dist/index.js"]

Python (например, с компиляцией C-зависимостей)

# Сборка
FROM python:3.12 AS builder
WORKDIR /app
COPY . .
RUN pip install --user -r requirements.txt

# Финальный образ
FROM python:3.12-slim
WORKDIR /app
COPY --from=builder /root/.local /root/.local
COPY . .
ENV PATH=/root/.local/bin:$PATH
CMD ["python", "main.py"]

Когда использовать multi-stage builds?

Используйте их, если:

Заключение

Multi-stage builds — это простой, но мощный способ оптимизировать Docker-образы. Они позволяют разделять процесс сборки и запуска, создавая чистые, безопасные и лёгкие образы без избыточных зависимостей.

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

Такой подход не только уменьшает размер итогового Docker-образа, но и повышает его безопасность за счёт устранения потенциальных уязвимостей, связанных с ненужным ПО. Это особенно полезно при развертывании в продакшене, где важно минимизировать поверхностные риски и ускорить запуск контейнеров. Multi-stage builds позволяют добиться чистоты, модульности и предсказуемости в контейнерной среде, что делает их неотъемлемой частью современного DevOps-подхода.

Это особенно важно в продакшене, где размер образа и его уязвимости напрямую влияют на безопасность, скорость развертывания и потребление ресурсов. Multi-stage builds позволяют сократить объём передаваемых данных, ускорить доставку контейнеров и минимизировать возможные уязвимости за счёт удаления неиспользуемых компонентов.

Если вы хотите ускорить сборку, уменьшить расходы на инфраструктуру и повысить безопасность, multi-stage builds — обязательный элемент вашего DevOps-инструментария. Они также упрощают поддержку CI/CD-процессов, позволяя создавать стабильные и предсказуемые образы, соответствующие лучшим практикам контейнеризации.

Docker и Serverspace

Если вы только начинаете работать с Docker или хотите углубить свои знания, обратите внимание на Базу знаний Serverspace.

Здесь вы найдёте множество подробных инструкций, гайдов и практических материалов по Docker и его ключевым компонентам — от базовых понятий до продвинутых тем, включая работу с Docker Compose, оптимизацию образов, настройку CI/CD и использование в облачной инфраструктуре. Материалы регулярно обновляются и подойдут как новичкам, так и опытным DevOps-инженерам.