# syntax=docker/dockerfile:1.7 # Многоэтапная сборка: компилятор и исходники остаются в промежуточных этапах, а в итоговые # образы попадают только готовые файлы. Какой этап собрать, задаёт target в compose.yaml. # Версии образов закреплены, чтобы сборка повторялась. # Этап 1: компиляция всех программ проекта. FROM golang:1.26.10-alpine3.24 AS builder WORKDIR /src # Сначала только списки зависимостей: при изменении кода их загрузка берётся из кэша Docker. COPY app/go.mod app/go.sum ./ RUN go mod download # Затем весь код. Лишнее отсекает .dockerignore. COPY app/ ./ # Основной сервер API. CGO_ENABLED=0 — статический файл без зависимостей от системных библиотек, # -s -w убирают отладочные данные и уменьшают размер, -trimpath убирает локальные пути из файла. RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/messenger ./cmd/messenger # Генератор нагрузки для проверок под нагрузкой. RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/loadgen ./cmd/loadgen # Одноразовая подготовка S3-bucket. RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/s3init ./cmd/s3init # Очиститель объектов без метаданных и проверка прав S3 мимо API. RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/janitor ./cmd/janitor RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/s3check ./cmd/s3check # Этап 2: сборка инструмента миграций goose. Версия закреплена, драйверы ненужных БД # исключены тегами: нужен только PostgreSQL. FROM golang:1.26.10-alpine3.24 AS goose-builder RUN CGO_ENABLED=0 go install -trimpath -ldflags="-s -w" \ -tags='no_clickhouse no_libsql no_mssql no_mysql no_sqlite3 no_vertica no_ydb' \ github.com/pressly/goose/v3/cmd/goose@v3.26.0 # Образ одноразового сервиса migrate: только goose и файлы миграций. # Адрес БД читается из секрета при запуске, поэтому в образ не попадает. # exec заменяет оболочку на goose, и тот сам получает сигналы остановки. FROM alpine:3.24.3 AS migrate COPY --from=goose-builder /go/bin/goose /usr/local/bin/goose COPY migrations /migrations ENTRYPOINT ["/bin/sh", "-c", "exec goose -dir /migrations postgres \"$(cat \"$DATABASE_URL_FILE\")\" up"] # Образ генератора нагрузки (профиль bench). Работает не от root. FROM alpine:3.24.3 AS loadgen COPY --from=builder /out/loadgen /usr/local/bin/loadgen USER nobody ENTRYPOINT ["/usr/local/bin/loadgen"] # Образ одноразового сервиса s3-init. Credentials читаются из секретов при запуске. Работает не от root. FROM alpine:3.24.3 AS s3init COPY --from=builder /out/s3init /usr/local/bin/s3init USER nobody ENTRYPOINT ["/usr/local/bin/s3init"] # Образ очистителя. Работает не от root. FROM alpine:3.24.3 AS janitor COPY --from=builder /out/janitor /usr/local/bin/janitor USER nobody ENTRYPOINT ["/usr/local/bin/janitor"] # Образ проверки прав S3 (профиль tools). Работает не от root. FROM alpine:3.24.3 AS s3check COPY --from=builder /out/s3check /usr/local/bin/s3check USER nobody ENTRYPOINT ["/usr/local/bin/s3check"] # Итоговый образ API. Это последний этап, поэтому он собирается, когда target не указан. # В нём нет ни компилятора, ни goose, ни файлов миграций: реплики не могут запускать их при старте. FROM alpine:3.24.3 # Метка версии сборки: видна в образе и в окружении. По ней rolling update показывает смену версии. ARG APP_BUILD=dev ENV APP_VERSION=$APP_BUILD LABEL org.opencontainers.image.version=$APP_BUILD # Корневые сертификаты и отдельный пользователь без прав: процесс работает не от root. RUN apk add --no-cache ca-certificates && \ addgroup -S app && \ adduser -S -G app -H app WORKDIR /app # Из этапа сборки берётся только готовый файл. COPY --from=builder /out/messenger /app/messenger # Все следующие команды и сам сервер выполняются от этого пользователя. USER app # Документация порта. Наружу он не публикуется: снаружи доступен только LB. EXPOSE 8080 # Docker останавливает контейнер этим сигналом: приложение выводит себя из балансировки # и завершает открытые запросы. STOPSIGNAL SIGTERM # Проверка готовности для Docker (статус healthy). Трафик направляет не она, а собственные # проверки LB. wget входит в alpine, отдельно его ставить не нужно. HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \ CMD wget --quiet --spider "http://127.0.0.1:${APP_PORT:-8080}/health/ready" || exit 1 ENTRYPOINT ["/app/messenger"]