Как упаковать Go-сервис в Docker-образ и зачем для этого многоэтапная сборка?
Проверила команда Сопровод · Обновлено
Короткий ответ
Go собирает сервис в один исполняемый файл, поэтому образ делают в два этапа. На первом, в образе golang, скачивают модули и компилируют бинарник с CGO_ENABLED=0, чтобы он не зависел от системных библиотек. На втором берут пустой scratch или distroless и копируют туда только бинарник через COPY --from. Образ весит десятки мегабайт вместо сотен и не содержит компилятора.
Почему этот вопрос задают
Почти каждый Go-сервис уезжает в прод в контейнере, и Dockerfile достается Junior-разработчику в первые недели. Ответ показывает, понимает ли кандидат, что попадает в образ и почему это важно.
Как рассуждать
- Объясните, что Go дает один бинарник и для запуска компилятор не нужен
- Разделите Dockerfile на этап сборки и финальный этап, где лежит только бинарник
- Назовите
CGO_ENABLED=0: без него бинарник может потребовать системную библиотеку C - Скопируйте
go.modиgo.sumраньше исходников, чтобы слой с модулями брался из кэша - Запускайте сервис от пользователя без прав root
Ответ с примером
Управляющая компания принимает показания счетчиков воды и света через сервис на Go. Первый этап собирает его в образе golang:1.27: сначала копирует go.mod и go.sum и скачивает модули, потом копирует код и собирает бинарник. Пока зависимости не менялись, Docker берет слой с модулями из кэша, и повторная сборка занимает секунды.
Второй этап начинается с нового FROM и забирает из первого только файл /meter. В distroless/static нет командной оболочки и пакетного менеджера: злоумышленнику в контейнере почти нечем пользоваться, а сканер уязвимостей находит меньше пакетов. Образ в один этап тащил бы за собой компилятор и весил бы сотни мегабайт, финальный занимает порядка 20 МБ.
| Строка Dockerfile | Зачем она |
|---|---|
| FROM golang:1.27 AS build | этап сборки с компилятором и модулями |
| WORKDIR /src | своя папка для кода вместо /go, где лежит кэш модулей |
| COPY go.mod go.sum ./ и RUN go mod download | слой с зависимостями кэшируется отдельно от кода |
| COPY . . | код копируется после модулей и не сбрасывает их кэш |
| RUN CGO_ENABLED=0 go build -o /meter ./cmd/meter | статический бинарник без системных библиотек |
| FROM gcr.io/distroless/static-debian13 | финальный этап без командной оболочки и пакетного менеджера |
| COPY --from=build /meter /meter | в образ попадает только бинарник |
| USER nonroot:nonroot и ENTRYPOINT ["/meter"] | запуск без прав root |
Как ответить сильнее
Что добавит опытный кандидат
Что спросят следом
Доступно по подписке
Приемы опытных и готовые ответы
Частые ошибки
«Многоэтапная сборка нужна, чтобы Docker собирал быстрее»
Поправьте: главное — маленький финальный образ без компилятора и исходников. Скорость дает порядок слоев, когда
go.modкопируется раньше кода«В финальный образ скопирую весь проект, вдруг что-то понадобится»
Скажите, что сервису нужен бинарник и, может быть, конфиги или миграции. Исходники и модули в образе только добавляют размер и поводы для уязвимостей
«Docker сам соберет Go-сервис, если положить в образ код»
Уточните, что сборку описывает
RUN go buildна первом этапе. Docker только выполняет шаги Dockerfile по порядку и кэширует слои«Контейнер можно запускать от root, он же изолирован»
Объясните, что изоляция контейнера не абсолютна, и уязвимость в сервисе с правами root опаснее. Укажите
USER nonrootв финальном этапе
Сигналы для интервьюера
Сильный ответ
Пишет многоэтапный Dockerfile по памяти и объясняет каждую строку: кэш модулей, CGO_ENABLED=0, финальный образ, пользователь без root
Тревожный сигнал
Знает слово multi-stage, но не может объяснить, почему статический бинарник Go так хорошо ложится в пустой образ
Красный флаг
Предлагает собрать образ на golang целиком и запускать сервис командой go run main.go прямо в продакшене
Как еще могут спросить
- Как написать Dockerfile для приложения на Go?
- Что такое multi-stage build в Docker?
- Почему Go-сервис можно запустить в образе
scratch? - Как уменьшить размер Docker-образа Go-приложения?











