如何将Monorepo中Poetry子项目打包为可执行文件？

核心思路 #

用Docker多阶段构建拆分构建环境和运行环境：

1. 构建阶段：复制整个Monorepo，通过Poetry将所有依赖（包括本地路径依赖）完整安装到虚拟环境（替代开发阶段的软链接）
2. 运行阶段：仅从构建阶段复制虚拟环境、目标应用的必要文件，舍弃整个Monorepo以缩小镜像体积

步骤1：调整Poetry安装命令（关键） #

开发阶段的develop=true会创建软链接，构建时需让Poetry将本地依赖包真正安装到虚拟环境，执行以下命令：

poetry install --no-dev --no-root --sync

• --no-dev：跳过开发依赖
• --no-root：先安装所有依赖，再单独安装当前项目
• --sync：确保虚拟环境仅保留pyproject.toml声明的依赖，清理冗余包

若主应用在./apps/main-app，本地依赖在./libs/some-lib，进入主应用目录执行上述命令后，Poetry会自动打包some-lib并完整安装到虚拟环境。

步骤2：Dockerfile多阶段构建示例 #

假设Monorepo结构如下：

monorepo/
├── libs/
│   └── some-lib/
│       ├── pyproject.toml
│       └── src/
└── apps/
    └── main-app/
        ├── pyproject.toml
        ├── src/
        └── Dockerfile

main-app/Dockerfile内容：

# 第一阶段：构建环境
FROM python:3.11-slim AS builder

# 安装指定版本的Poetry
RUN pip install --no-cache-dir poetry==1.7.1

# 复制整个Monorepo到构建容器
WORKDIR /monorepo
COPY ../.. .

# 配置Poetry将虚拟环境放在项目目录内，方便后续复制
WORKDIR /monorepo/apps/main-app
RUN poetry config virtualenvs.in-project true

# 安装所有依赖（含本地路径依赖）
RUN poetry install --no-dev --no-root --sync
# 安装主应用本身
RUN poetry install --no-dev

# 第二阶段：运行环境
FROM python:3.11-slim AS runner

# 复制构建好的虚拟环境和主应用代码
WORKDIR /app
COPY --from=builder /monorepo/apps/main-app/.venv ./.venv
COPY --from=builder /monorepo/apps/main-app/src ./src
COPY --from=builder /monorepo/apps/main-app/pyproject.toml ./

# 设置环境变量，让Python使用虚拟环境
ENV VIRTUAL_ENV=/app/.venv
ENV PATH="$VIRTUAL_ENV/bin:$PATH"

# 启动主应用（根据实际情况调整命令，如uvicorn或自定义脚本）
CMD ["python", "src/main.py"]

关键细节说明 #

• poetry config virtualenvs.in-project true：将虚拟环境放在项目目录下，避免跨路径复制的问题
• 构建阶段必须复制整个Monorepo，因为Poetry需要访问路径依赖的源码目录才能完成打包安装
• 运行阶段仅保留虚拟环境、主应用源码和配置，完全剔除Monorepo的其他冗余内容
• 若主应用是Poetry生成的可执行脚本，可直接复制虚拟环境内的脚本：COPY --from=builder /monorepo/apps/main-app/.venv/bin/your-app ./，之后直接运行./your-app

验证方法 #

构建镜像后进入容器检查：

docker run --rm -it <你的镜像名> bash
# 查看本地依赖是否为完整文件而非软链接
ls -la $VIRTUAL_ENV/lib/python3.11/site-packages/some_lib

若显示实际文件而非链接，则配置生效。

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