构建提速实录：Monorepo Turborepo 增量缓存与 Docker 远端缓存

构建提速实录：Monorepo Turborepo 增量缓存与 Docker 远端缓存

在大规模前端与全栈工程体系中，多包大仓（Monorepo）因其方便统一代码规范、共享组件库与跨包原子化提交，成为了大厂架构演进的主流选择。

然而，随着大仓内部应用（Apps）与公共库（Packages）数量超过 30 个，持续集成（CI）流水线经常陷入可怕的“构建瓶颈”：每次开发者仅仅修改了 packages/ui-tokens 里的一个颜色常量，CI 机器就要从头把 10 个业务前端应用、4 个 Node.js BFF 网关全部重新跑一遍 TypeScript 类型检查、Vite 打包和 Docker 镜像构建。每次提交代码都要漫长等待 25 分钟，CI Runner 机器的 CPU 经常被持续拉满。

通过引入 Turborepo 的 DAG 增量缓存计算 结合 Docker BuildKit Registry 远端分层缓存，我们成功将全大仓的平均 CI 构建时间从 24 分钟压缩至 4 分半，提速超过 80%。

为什么传统 Monorepo 构建会沦为算力黑洞？

核心优化一：Turborepo 增量任务编排与远程缓存

Turborepo 的核心优势在于它会为每一个任务（Task）计算一个全局唯一的 Hash 指纹。这个 Hash 由源码内容、相关依赖项的 Hash、环境变量以及构建配置共同决定。

生产级 turbo.json 配置

{
"$schema": "https://turbo.build/schema.json",
"globalDependencies": ["**/.env.production", "tsconfig.base.json"],
"tasks": {
"build": {
"dependsOn": ["^build"],
"inputs": ["src/**", "public/**", "package.json", "tsconfig.json"],
"outputs": ["dist/**", ".next/**", "build/**"],
"cache": true
},
"type-check": {
"dependsOn": ["^type-check"],
"inputs": ["src/**", "tsconfig.json"],
"cache": true
},
"lint": {
"inputs": ["src/**", ".eslintrc.*"],
"cache": true
}
}
}

在 CI 流水线中，通过指定 –filter 参数，仅对本次 Git Diff 受影响的包及其下游进行构建，其余直接命中缓存极速下载：

# 仅构建受当前 PR 影响的包，极大节省 CI 算力
pnpm turbo run build type-check lint –filter=…[origin/main]

核心优化二：Docker Prune 剪裁与 BuildKit Registry 远程缓存

在为特定的子应用（如 apps/order-web）构建生产镜像时，利用 turbo prune 命令生成一个仅包含该应用及其真实依赖包的精简代码沙箱：

# 阶段 1：Monorepo 骨架剪裁
FROM node:20-alpine AS pruner
WORKDIR /app
RUN npm install -g turbo
COPY . .
# 仅抽离 apps/order-web 及其依赖的 packages/*
RUN turbo prune @company/order-web –docker

# 阶段 2：依赖安装（完全隔离，最大化利用 Layer 缓存）
FROM node:20-alpine AS installer
WORKDIR /app
RUN npm install -g pnpm
COPY –from=pruner /app/out/json/ .
COPY –from=pruner /app/out/pnpm-lock.yaml ./pnpm-lock.yaml
RUN pnpm install –frozen-lockfile

# 阶段 3：源码编译
COPY –from=pruner /app/out/full/ .
COPY turbo.json turbo.json
RUN pnpm turbo run build –filter=@company/order-web

# 阶段 4：最小化生产运行镜像
FROM nginx:alpine AS runner
COPY –from=installer /app/apps/order-web/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

在 GitHub Actions 中挂载远程 Docker 缓存

docker buildx build \\
–cache-from type=registry,ref=registry.internal.net/cache/order-web-cache:latest \\
–cache-to type=registry,ref=registry.internal.net/cache/order-web-cache:latest,mode=max \\
–target runner \\
–tag registry.internal.net/prod/order-web:${GITHUB_SHA} \\
–push .

构建提速实战数据复盘

总结

构建提速不是靠盲目给 CI 机器堆更贵的 CPU，而是通过精密的依赖图剪裁与分布式缓存，坚决不把宝贵的算力浪费在没有发生变化的代码上。