Files
mtusi2026lab5/Dockerfile
T

100 lines
5.2 KiB
Docker

# 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"]