如何在Rush monorepo中结合Docker volumes进行本地开发？

问题根源 #

Rush 会将 monorepo 的所有依赖集中存放在仓库根目录的 common/temp/node_modules 下，各个子包通过软链接引用这些依赖。你当前仅挂载单个子包目录到容器，容器内不存在 common 目录，软链接指向的路径无效，导致依赖找不到。

解决方案1：挂载整个Monorepo到容器 #

直接将整个 monorepo 根目录挂载到容器，保证 Rush 的 common 目录能被容器访问，软链接可正常解析。

假设你的 docker-compose.yml 位于 packages/server/docker 目录，monorepo 根目录在其三级父目录，调整配置如下：

version: '3'
services:
  web:
    build: .
    image: 'my-image'
    command: "npm start"
    user: "node"
    # 调整工作目录到容器内对应的子包路径
    working_dir: /home/node/app/packages/server/docker
    volumes:
      # 挂载整个monorepo根目录到容器
      - ../../..:/home/node/app

解决方案2：在容器内预安装Rush依赖 #

如果不想挂载整个 monorepo，可以在镜像构建阶段先安装好所有依赖，开发时仅挂载子包源码。

Dockerfile 示例 #

FROM node:18-alpine

WORKDIR /home/node/app

# 复制Rush核心配置文件
COPY rush.json .
COPY common/config/rush/ common/config/rush/
COPY package.json .
# 复制子包的package.json
COPY packages/server/docker/package.json packages/server/docker/

# 全局安装Rush并执行依赖安装
RUN npm install -g @microsoft/rush
RUN rush install

# 复制子包源码（开发时会被挂载目录覆盖）
COPY packages/server/docker/ packages/server/docker/

USER node

对应 docker-compose.yml #

version: '3'
services:
  web:
    build: .
    image: 'my-image'
    command: "npm start"
    user: "node"
    working_dir: /home/node/app/packages/server/docker
    volumes:
      # 仅挂载子包源码目录，依赖已包含在镜像中
      - ./:/home/node/app/packages/server/docker

补充说明 #

你之前考虑挂载 ../../common/temp/node_modules 的方式也可行，但需要保证容器内的目录结构与本地完全一致，同时挂载子包目录和 common 目录。相比之下，挂载整个 monorepo 更简洁，能避免路径匹配问题。

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