Docker容器中运行Poetry创建的虚拟环境报错问题咨询

问题场景 #

需要在Docker容器内通过Poetry安装Python应用并激活虚拟环境运行，但遇到两个问题：

• 用poetry shell会启动交互式Shell，导致容器阻塞无法正常运行
• 尝试通过环境变量VENV_PATH调用虚拟环境Python时，触发文件找不到错误：

docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "$VENV_PATH/bin/python": stat $VENV_PATH/bin/python: no such file or directory: unknown.
ERRO[0000] error waiting for container: context canceled

问题根源 #

• RUN export VENV_PATH=...仅在当前构建层的Shell会话中生效，构建完成后该变量不会传递到容器运行阶段
• poetry shell是交互式命令，不适用于Docker的CMD/ENTRYPOINT非交互式场景

解决方案 #

方案1：用poetry run直接运行（推荐） #

Poetry自带的poetry run命令会自动使用其创建的虚拟环境执行指定命令，无需手动激活虚拟环境，是官方推荐的方式。修改Dockerfile的CMD部分即可：

FROM ghcr.io/osgeo/gdal:ubuntu-small-3.9.0

RUN apt clean && apt update && apt install -y pipx python3-pip libhdf5-dev pkg-config

RUN pipx install poetry
ENV PATH=/root/.local/bin:$PATH

RUN mkdir "/root/enrichment-consumer"
COPY . "/root/enrichment-consumer"
WORKDIR "/root/enrichment-consumer"

RUN poetry source add --priority=supplemental leitha-internal-py http://***:***@nexus-leitha.servizi.gr-u.it/repository/leitha-internal-py/simple
RUN poetry config certificates.leitha-internal-py.cert false
RUN poetry install

CMD ["poetry", "run", "python", "enrichment_consumer/app.py"]

方案2：固化虚拟环境路径到环境变量 #

如果一定要直接调用虚拟环境的Python可执行文件，需要用Docker的ENV指令在构建阶段将路径固化到镜像环境变量中（而非临时的RUN export）：

FROM ghcr.io/osgeo/gdal:ubuntu-small-3.9.0

RUN apt clean && apt update && apt install -y pipx python3-pip libhdf5-dev pkg-config

RUN pipx install poetry
ENV PATH=/root/.local/bin:$PATH

RUN mkdir "/root/enrichment-consumer"
COPY . "/root/enrichment-consumer"
WORKDIR "/root/enrichment-consumer"

RUN poetry source add --priority=supplemental leitha-internal-py http://***:***@nexus-leitha.servizi.gr-u.it/repository/leitha-internal-py/simple
RUN poetry config certificates.leitha-internal-py.cert false
RUN poetry install

# 将虚拟环境路径写入镜像环境变量，确保运行阶段可读取
ENV VENV_PATH=$(poetry env info --path)

CMD ${VENV_PATH}/bin/python enrichment_consumer/app.py

补充说明 #

• poetry run无需手动管理虚拟环境路径，避免路径硬编码或环境变量失效问题，更简洁可靠
• 方案2中ENV指令会在构建阶段解析变量值并固化到镜像中，容器运行时可直接调用

内容的提问来源于stack exchange，提问作者asant-leitha