# 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 # Одноразовая подготовка S3-bucket. RUN CGO_ENABLED=0 GOOS=linux go build \ -ldflags="-s -w" \ -trimpath \ -o /out/s3init ./cmd/s3init RUN CGO_ENABLED=0 GOOS=linux go build -trimpath -o /out/worker ./cmd/worker # Проверки с настоящим WebP encoder, включая целостность crop после генерации optimized. # docker build --target tests -t mtusi-lab5-tests . FROM builder AS tests RUN apk add --no-cache libwebp-tools RUN go test -v ./... # Этап 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"] # Образ одноразового сервиса 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"] FROM alpine:3.24.3 AS worker RUN apk add --no-cache ca-certificates libwebp-tools COPY --from=builder /out/worker /usr/local/bin/worker USER nobody ENTRYPOINT ["/usr/local/bin/worker"] # Итоговый образ 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"]