garrison 0.9.0

Garrison - 面向 Rust 生态的一站式身份认证鉴权框架
Documentation
# Copyright (c) 2026 Kirky.X🌠
# SPDX-License-Identifier: Apache-2.0

# Garrison Auth Server 容器镜像(debian-slim 变体)。
#
# 三阶段(cargo-chef 依赖缓存):
#   planner  生成 recipe.json(依赖清单,不含源码实现体)
#   builder  cook 预编译依赖(缓存命中时增量编译仅业务代码)→ 编译 release 二进制
#   runner   debian:bookworm-slim + 非 root 运行 + 内置 healthcheck 探针
#
# 构建示例:
#   docker build \
#     --build-arg VERSION=0.9.0-rc.3 \
#     --build-arg GIT_SHA=$(git rev-parse HEAD) \
#     -t garrison-auth:local .
#
# feature 门禁(对齐单根二进制 serve 子命令的 cfg 门控,保持最小依赖面):
#   auth-server + cache-memory  `garrison serve` 子命令的编译门控
#   server-health-check         /healthz liveness 探针路由(HEALTHCHECK 依赖)
#   tracing-log                 stdout 结构化 JSON 日志
#   不用 full/production:会拉入 serve/healthcheck 不消费的 db-postgres/cedar 等重依赖;
#   需要更强 feature 面时覆盖:--build-arg FEATURES=production

# 在 chef 基座层补装 stable(对应仓库 MSRV 声明通道),
# 将工具链安装固定在 chef 缓存层——planner/builder 共享该层、不逐阶段重装;
# --profile minimal 跳过 rust-docs 等组件,省数百 MB
ARG CHEF_IMAGE=lukemathwalker/cargo-chef:latest-rust-1
FROM ${CHEF_IMAGE} AS chef
WORKDIR /app
RUN rustup toolchain install stable --profile minimal

FROM chef AS planner
COPY . .
RUN cargo chef prepare --recipe-path recipe.json

FROM chef AS builder
# sdforge build script 需要 protoc
RUN apt-get update && apt-get install -y --no-install-recommends protobuf-compiler \
    && rm -rf /var/lib/apt/lists/*
# FEATURES 声明置于 apt 层之后、cook 之前:feature 变更不连带重跑 apt 层
# (ARG 在使用前声明即可)
ARG FEATURES=auth-server,cache-memory,server-health-check,tracing-log
COPY --from=planner /app/recipe.json recipe.json
# Cargo.lock 必须先于 cook 就位:--locked 要求锁文件存在,且保证预编译的
# 依赖版本与最终 build 完全一致(依赖缓存才有效)
COPY --from=planner /app/Cargo.lock Cargo.lock
RUN cargo chef cook --release --locked --recipe-path recipe.json \
    --features "${FEATURES}" --bin garrison
COPY . .
RUN cargo build --release --locked --features "${FEATURES}" \
    --bin garrison

FROM debian:bookworm-slim AS runner
ARG VERSION=dev
ARG GIT_SHA=unknown
# 版本仅落 OCI labels:garrison 无运行时版本端点,不做伪注入
LABEL org.opencontainers.image.title="garrison" \
    org.opencontainers.image.description="Garrison - 面向 Rust 生态的一站式身份认证鉴权框架(Auth Server 镜像)" \
    org.opencontainers.image.licenses="Apache-2.0" \
    org.opencontainers.image.source="https://github.com/Kirky-X/garrison" \
    org.opencontainers.image.documentation="https://docs.rs/garrison" \
    org.opencontainers.image.version="${VERSION}" \
    org.opencontainers.image.revision="${GIT_SHA}"

RUN apt-get update \
    && apt-get install -y --no-install-recommends ca-certificates \
    && rm -rf /var/lib/apt/lists/* \
    && useradd --uid 1000 --no-create-home garrison

WORKDIR /app
COPY --from=builder /app/target/release/garrison /app/garrison

# GAR-30:容器内端口必须绑 0.0.0.0 才能被 docker ports 映射(bin 缺省
# 127.0.0.1 仅限宿主直跑的 secure-by-default);对外暴露面由 ports 映射/
# 防火墙控制,参考 docker-compose.example.yml
ENV GARRISON_EXTERNAL_BIND=0.0.0.0 \
    GARRISON_INTERNAL_BIND=0.0.0.0

USER 1000
EXPOSE 8080 8081
# 探测本容器外网端口的 sdforge liveness 探针(恒 200);目标端口随
# GARRISON_EXTERNAL_PORT 环境变量自动对齐(见 src/cli/mod.rs healthcheck 子命令)
HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 CMD ["/app/garrison", "healthcheck"]
# 单根二进制:ENTRYPOINT 固定 garrison,缺省子命令 serve(原 auth_server 行为);
# 运维侧可用 `docker run --entrypoint /app/garrison <img> healthcheck` 等覆写
ENTRYPOINT ["/app/garrison"]
CMD ["serve"]