PNPM Monorepo结合Docker Compose部署的结构优化方案咨询

针对你的PNPM Monorepo在Docker构建时的痛点——要么因Docker上下文限制无法访问根目录依赖文件，要么全量打包代码库拖慢构建速度，这里提供3种实用方案：

方案1：调整Dockerfile位置+用.dockerignore精简上下文 #

把API服务的Dockerfile移到项目根目录（命名为Dockerfile.api），通过.dockerignore排除无关文件，既解决文件访问问题，又严格控制上下文体积。

步骤： #

1. 根目录创建Dockerfile.api：

FROM node:18-alpine As base
RUN npm i -g pnpm

# 安装生产依赖
FROM base AS dependencies
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml .npmrc ./
RUN pnpm install --frozen-lockfile --prod

# 构建环节（若需编译TS等）
FROM base AS builder
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml .npmrc ./
RUN pnpm install --frozen-lockfile
COPY services/api/src ./src
# 如有编译命令（如tsc），添加在此处

# 生产镜像
FROM base AS production
WORKDIR /usr/src/app
COPY --from=dependencies /usr/src/app/node_modules ./node_modules
COPY --from=builder /usr/src/app/src ./src
CMD ["node", "src/index.js"]

2. 根目录创建.dockerignore，排除不必要的文件：

node_modules/
apps/
# 若API依赖packages下的特定包，取消对应注释
# !packages/shared-api-utils/
packages/**/*
.git/
pnpm-debug.log
*.md

3. docker-compose.yaml中配置API服务：

services:
  api:
    build:
      context: .
      dockerfile: Dockerfile.api
    # 其他配置...

方案2：利用PNPM --filter特性，仅安装API相关依赖 #

保持原有Dockerfile位置，但将docker-compose的上下文设为项目根目录，结合PNPM的--filter命令精准安装API服务所需依赖，同时通过.dockerignore减少上下文冗余。

修改后的services/api/Dockerfile： #

FROM node:18-alpine As base
RUN npm i -g pnpm

FROM base AS dependencies
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml .npmrc ./
# 仅安装API服务的生产依赖
RUN pnpm install --filter api --prod --frozen-lockfile

FROM base AS builder
WORKDIR /usr/src/app
COPY package.json pnpm-lock.yaml .npmrc ./
RUN pnpm install --filter api --frozen-lockfile
COPY services/api/src ./src
# 编译步骤（如需要）

FROM base AS production
WORKDIR /usr/src/app
COPY --from=dependencies /usr/src/app/node_modules ./node_modules
COPY --from=builder /usr/src/app/src ./src
CMD ["node", "src/index.js"]

docker-compose.yaml配置： #

services:
  api:
    build:
      context: .
      dockerfile: services/api/Dockerfile
    # 其他配置...

方案3：用PNPM deploy生成独立依赖目录（最小上下文体积） #

通过PNPM的deploy命令，将API服务所需的源码和依赖打包到单独目录，再基于这个目录构建Docker镜像，上下文体积达到最小。

步骤： #

1. 在项目根目录执行命令，生成API的部署目录：

pnpm deploy --filter api ./services/api/deploy

该命令会把API服务的源码、必要依赖以及package.json等核心文件复制到services/api/deploy目录。

2. 修改services/api/Dockerfile：

FROM node:18-alpine
RUN npm i -g pnpm
WORKDIR /usr/src/app
# 仅复制deploy目录内容，上下文体积极小
COPY deploy/ ./
CMD ["node", "src/index.js"]

3. docker-compose.yaml保持原有上下文配置：

services:
  api:
    build:
      context: ./services/api
      dockerfile: Dockerfile
    # 其他配置...

方案对比 #

• 方案1：结构清晰，兼容本地开发和CI流程，通过.dockerignore灵活控制上下文内容，适合大多数场景。
• 方案2：无需移动Dockerfile位置，利用PNPM过滤特性精准安装依赖，适合希望保持原有目录结构的场景。
• 方案3：上下文体积最小，构建速度最快，但需要额外的deploy步骤，适合对镜像大小和构建速度要求极高的生产环境。

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