多可执行文件Cargo Workspace的Docker构建缓存优化问询

核心思路 #

利用Docker多阶段构建的层缓存特性，先统一构建并缓存整个Workspace的依赖层，再为每个服务单独编译可执行文件，彻底避免重复编译依赖的问题。

具体实现步骤 #

1. 根目录创建通用依赖构建镜像（Dockerfile.deps） #

这个镜像专门负责生成并缓存Workspace的所有依赖，作为所有服务的共享基础层：

FROM rust:1.78-slim AS planner
WORKDIR /src
# 复制所有Cargo配置文件（仅需配置文件，无需源码）
COPY Cargo.toml Cargo.lock ./
COPY Service1/Cargo.toml Service1/
COPY Service2/Cargo.toml Service2/
# 安装cargo-chef并生成依赖清单
RUN cargo install cargo-chef
RUN cargo chef prepare --recipe-path recipe.json

FROM rust:1.78-slim AS builder-deps
WORKDIR /src
COPY --from=planner /src/recipe.json recipe.json
RUN cargo install cargo-chef
# 缓存依赖层，仅当Cargo配置变更时才会重新执行
RUN cargo chef cook --release --recipe-path recipe.json

2. 为每个服务创建单独的Dockerfile #

基于共享的依赖层，仅编译当前服务的可执行文件：

Dockerfile.service1

# 引入预构建好的依赖缓存层
FROM builder-deps AS builder
WORKDIR /src
# 复制整个Workspace源码
COPY . .
# 仅构建Service1的可执行文件，跳过其他crates
RUN cargo build --release --bin service1

# 生成轻量运行镜像
FROM debian:bookworm-slim AS runtime
WORKDIR /app
# 复制编译好的可执行文件
COPY --from=builder /src/target/release/service1 ./
CMD ["./service1"]

Dockerfile.service2

FROM builder-deps AS builder
WORKDIR /src
COPY . .
# 仅构建Service2的可执行文件
RUN cargo build --release --bin service2

FROM debian:bookworm-slim AS runtime
WORKDIR /app
COPY --from=builder /src/target/release/service2 ./
CMD ["./service2"]

3. 构建命令 #

先构建依赖镜像，再依次构建各个服务：

# 构建共享依赖层镜像
docker build -t workspace-deps -f Dockerfile.deps .

# 构建Service1镜像
docker build -t service1 -f Dockerfile.service1 .

# 构建Service2镜像
docker build -t service2 -f Dockerfile.service2 .

关键优化点 #

• 依赖层复用：builder-deps镜像仅在Cargo.toml/Cargo.lock变更时重新构建，所有服务共享这一层缓存，大幅缩短构建时间。
• 精准编译：通过cargo build --release --bin <服务名>指定目标服务，避免编译整个Workspace的无关crates。
• 轻量镜像：最终运行镜像采用debian-slim，仅包含可执行文件，有效缩减镜像体积。

内容的提问来源于stack exchange，提问作者V.Rashkov