duffn/python-poetry

python-poetry

镜像概述和主要用途

这是一系列使用poetry进行依赖管理的https://hub.docker.com/r/duffn/python-poetry%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E8%AF%A5%E9%95%9C%E5%83%8F%E8%BF%98%E5%8C%85%E5%90%AB%E4%BB%A5%E4%B8%8B%E7%89%B9%E6%80%A7%EF%BC%9A

• 安装https://github.com/krallin/tini%E7%94%A8%E4%BA%8E%E7%AE%80%E5%8D%95%E7%9A%84%60init%60%E5%88%9D%E5%A7%8B%E5%8C%96
• 使用https://github.com/hexops/dockerfile#run-as-a-non-root-user

核心功能和特性

• 依赖管理：集成poetry工具，简化Python项目依赖的安装、管理和打包
• 初始化工具：内置tini，提供更安全的容器进程管理
• 安全运行：默认使用非root用户（用户名nonroot，UID ***，GID ***）运行，降低安全风险
• 环境隔离：通过虚拟环境（$VENV_PATH）隔离项目依赖与poetry自身依赖

使用场景和适用范围

• 需要使用poetry管理依赖的Python项目开发和部署
• 追求容器安全性，需要非root用户运行的场景
• 需要多阶段构建优化镜像大小的生产环境部署
• 希望简化依赖安装流程的Python应用容器化

使用方法和配置说明

简单使用

dockerfile
FROM duffn/python-poetry:3.9-slim

COPY pyproject.toml poetry.lock ./
# Poetry通过`pip`安装，因此激活虚拟环境并在其中安装项目依赖，避免与poetry的依赖冲突
RUN . $VENV_PATH/bin/activate && $POETRY_HOME/poetry install --no-root

WORKDIR /app
COPY . .

# 容器用户ID为10000，组ID为10001
RUN chown 10000:10001 -R /app

# 非root用户名
USER nonroot

# 使用tini启动容器
ENTRYPOINT ["tini", "--"]
CMD ["./my-start-command.sh"]

多阶段构建

dockerfile
FROM duffn/python-poetry:3.9-slim as base

COPY ./poetry.lock ./pyproject.toml ./
# 在基础多阶段构建中仅安装生产依赖
RUN . $VENV_PATH/bin/activate && $POETRY_HOME/poetry install --no-root --no-dev

# 开发镜像
FROM base as development

# 在开发目标中额外安装开发依赖
RUN . $VENV_PATH/bin/activate && $POETRY_HOME/poetry install --no-root

WORKDIR /app
COPY . .

RUN chown 10000:10001 -R /app

USER nonroot

ENTRYPOINT ["tini", "--"]
CMD ["./my-start-command.sh"]

# 生产镜像
# 使用--target production标志仅构建单个目标
# `docker build --target production -t my-image:latest .`
FROM base as production

# 基础镜像已包含生产依赖，无需在此处重复安装
WORKDIR /app
COPY . .

RUN chown 10000:10001 -R /app

USER nonroot

ENTRYPOINT ["tini", "--"]
CMD ["./my-start-command.sh"]

启动脚本示例（my-start-command.sh）：

bash
#!/bin/bash

set -e

. /venv/bin/activate

flask run --host=0.0.0.0

标签说明

所有镜像均基于https://hub.docker.com/_/python%E6%9E%84%E5%BB%BA%EF%BC%9A

• X.X-<name>格式标签（如3.9-slim）：使用https://github.com/python-poetry/poetry/releases
• X.X-<name>-X.X.X格式标签（如3.9-slim-1.1.4）：可固定poetry版本（最低支持1.1.4版本）

所有可用标签可在https://hub.docker.com/repository/docker/duffn/python-poetry/tags?page=1&ordering=last_updated%E6%9F%A5%E7%9C%8B%E3%80%82

许可证

MIT