如何基于Yarn Workspaces单仓Node.js项目构建Docker镜像并部署

看来你们团队在Monorepo的CI流程上已经推进得很顺利了，现在卡在Docker镜像体积臃肿的问题上——全量拉取仓库+yarn install后700MB的大小确实没必要，尤其是如果只需要部署其中特定业务包的话，冗余内容只会拖慢部署速度、占用存储资源。下面给你几个实用的优化思路：

1. 用多阶段构建剥离构建与运行环境 #

这是Docker镜像瘦身最常用的手段，把依赖安装、代码构建和最终运行环境彻底分开：

• 构建阶段：选用带完整Node环境的镜像（比如node:18-alpine），拉取必要的Monorepo文件，执行依赖安装和目标包的构建命令。
• 运行阶段：切换到更轻量化的基础镜像（比如node:18-alpine-slim甚至distroless/nodejs），只复制构建好的产物和生产依赖，完全抛弃构建阶段的冗余内容。

示例Dockerfile片段：

# 第一阶段：构建产物
FROM node:18-alpine AS builder
WORKDIR /app
# 先复制依赖锁文件，利用Docker缓存（只有依赖变更才会重新安装）
COPY package.json yarn.lock ./
COPY packages/your-target-package/package.json ./packages/your-target-package/
# 安装全量依赖（包括构建工具）
RUN yarn install --frozen-lockfile --production=false
# 复制整个Monorepo（记得配合.dockerignore排除无用文件）
COPY . .
# 只构建目标业务包
RUN yarn workspace your-target-package build

# 第二阶段：运行镜像
FROM node:18-alpine-slim
WORKDIR /app
# 仅复制目标包的构建产物
COPY --from=builder /app/packages/your-target-package/dist ./dist
# 仅复制生产依赖所需的配置文件
COPY --from=builder /app/package.json /app/yarn.lock ./
COPY --from=builder /app/packages/your-target-package/package.json ./packages/your-target-package/
# 只安装生产依赖
RUN yarn install --frozen-lockfile --production=true

CMD ["node", "./dist/index.js"]

2. 避免拉取完整Monorepo，只取目标包相关内容 #

如果你的CI/CD工具支持（比如GitHub Actions、GitLab CI），可以用Git的sparse-checkout功能，只拉取构建目标包必需的文件，而不是整个仓库：

git init
git remote add origin <你的仓库地址>
git config core.sparseCheckout true
# 写入需要拉取的目录/文件
echo "packages/your-target-package" >> .git/info/sparse-checkout
echo "package.json" >> .git/info/sparse-checkout
echo "yarn.lock" >> .git/info/sparse-checkout
git pull origin main

这样能大幅减少拉取的文件体积，也能避免yarn install时处理无关包的依赖。

3. 优化依赖安装环节 #

• 安装时加上--production参数，只安装生产依赖，跳过测试工具、构建插件等devDependencies，这能砍掉一大半依赖体积。
• 如果团队可以切换到pnpm，它的硬链接依赖存储机制比Yarn经典版更高效，能进一步降低node_modules的占用空间。
• 安装完成后清理缓存：比如在yarn install后执行yarn cache clean，或者在构建阶段末尾删除node_modules/.cache这类临时文件。

4. 用更小的基础镜像 #

别再用node:18这种带完整Debian环境的镜像了，换成node:18-alpine（基于Alpine Linux，体积仅几十MB），如果追求极致轻量化，还可以试试Google的distroless/nodejs镜像——它只包含Node运行时和必要系统库，体积能压缩到十几MB。

最后别忘了配置.dockerignore文件，把node_modules、.git、.github、tests、docs这些无关文件排除在外，避免它们被误复制进镜像里增加体积。

内容的提问来源于stack exchange，提问作者33Fraise33