如何在Rush(pnpm)单体仓库中构建Docker部署应用（规避软链接）

针对你遇到的pnpm软链接在Docker COPY时失效的问题，以下是几个可行的生产部署方案：

方案1：使用pnpm deploy命令生成无软链接的部署目录 #

pnpm的deploy命令专门用于生成适合生产部署的目录结构，会自动将所有依赖（包括本地工作区的库）以实体文件形式复制到指定目录，完全消除软链接：

1. 在仓库根目录完成依赖安装与项目构建：

   rush install
   rush build
   

2. 进入目标应用的目录，执行deploy命令生成部署目录：

   cd apps/your-app
   pnpm deploy --prod ../deploy-target
   

   其中../deploy-target是你指定的输出目录，命令执行后该目录会包含应用的所有生产依赖（实体文件）和应用代码。
3. 在Dockerfile中直接复制这个部署目录到容器：

   FROM node:18-alpine
   COPY deploy-target /app
   WORKDIR /app
   CMD ["node", "index.js"]
   

方案2：打包本地库并修改依赖指向 #

将单体仓库中的本地库先打包为tar包，让应用依赖打包后的文件而非工作区软链接，这样pnpm安装时会直接解压实体文件：

1. 构建并打包所有本地库：

   rush build
   # 为每个库生成tar包，存放在各自目录下
   rush pnpm pack --filter "@your-scope/*"
   

2. 修改目标应用的package.json，将本地库的依赖从工作区协议改为本地tar包路径：

   {
     "dependencies": {
       "@your-scope/core-lib": "../libs/core-lib/package.tgz",
       "@your-scope/utils-lib": "../libs/utils-lib/package.tgz"
     }
   }
   

3. 安装生产依赖（此时所有依赖都是实体文件）：

   cd apps/your-app
   pnpm install --prod
   

4. 在Dockerfile中复制应用目录到容器即可：

   FROM node:18-alpine
   COPY apps/your-app /app
   WORKDIR /app
   CMD ["node", "index.js"]
   

方案3：Docker多阶段构建（推荐） #

通过多阶段构建在容器内完成依赖安装与项目构建，完全绕开本地软链接的问题，同时能减小最终镜像体积：

以Node.js后端应用为例：

# 构建阶段：安装依赖、编译代码
FROM node:18-alpine AS builder
WORKDIR /app
COPY . .
# 安装所有依赖（包括开发依赖用于构建）
RUN npm install -g @microsoft/rush
RUN rush install
RUN rush build --filter your-app

# 运行阶段：仅复制必要的运行文件
FROM node:18-alpine
WORKDIR /app
# 复制编译后的应用代码
COPY --from=builder /app/apps/your-app/dist ./dist
# 复制package.json并安装生产依赖（容器内安装无软链接问题）
COPY --from=builder /app/apps/your-app/package.json ./
RUN npm install -g pnpm && pnpm install --prod

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

如果是前端应用（如React/Vue），可以将构建后的静态文件复制到Nginx镜像：

FROM node:18-alpine AS builder
WORKDIR /app
COPY . .
RUN npm install -g @microsoft/rush
RUN rush install
RUN rush build --filter your-frontend-app

FROM nginx:alpine
COPY --from=builder /app/apps/your-frontend-app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

方案4：在容器内直接执行Rush安装 #

如果需要保留完整的应用目录结构，可以直接在Docker容器内执行Rush安装，此时pnpm生成的软链接指向容器内部的存储目录，不会出现失效问题：

FROM node:18-alpine
WORKDIR /app
COPY . .
RUN npm install -g @microsoft/rush
# 安装生产依赖
RUN rush install --prod
RUN rush build --filter your-app

CMD ["node", "apps/your-app/dist/index.js"]

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