python-poetry Docker镜像文档

镜像概述和主要用途

python-poetry 是基于官方 python 镜像的衍生版本，预安装了 Python 依赖管理工具 poetry。本镜像旨在提供开箱即用的 Python 开发与运行环境，无需手动安装 poetry，尤其适用于需要快速启动依赖管理流程的场景（如 CI/CD 流水线），可有效节省环境配置时间。

核心功能和特性

• 基于官方 Python 镜像：完全兼容官方 Python 镜像的基础环境，确保应用运行一致性。
• 预装 Poetry：内置 Python 依赖管理工具 poetry，支持项目依赖声明、安装、打包等全流程操作。
• 定期自动更新：通过 CI 流水线每月重建镜像，确保 poetry、pip、setuptools 等工具为最新稳定版本。
• 多 Python 版本支持：提供多种 Python 版本标签，适配不同项目的运行环境需求。

使用场景和适用范围

• CI/CD 流水线：在自动化构建、测试、部署流程中直接使用，避免重复安装 poetry，简化流水线配置。
• Python 项目开发环境：本地开发时快速搭建包含 poetry 的隔离环境，统一团队依赖管理工具版本。
• 自动化测试环境：在测试流程中使用，确保依赖安装与项目声明一致，提升测试稳定性。

使用方法和配置说明

支持的镜像标签

本镜像提供以下 Python 版本标签（与官方 Python 镜像版本对应）：
latest、3.13、3.12、3.11、3.10、3.9、3.8、3.7

预装软件包

• poetry：Python 依赖管理工具
• pip：Python 包安装工具（最新版本）
• setuptools：Python 包构建工具（最新版本）

拉取镜像

通过 Docker Hub 拉取指定版本镜像：

docker pull d21d3q/python-poetry:<tag>

示例（拉取 Python 3.12 版本）：

docker pull d21d3q/python-poetry:3.12

运行容器示例

1. 验证 Poetry 安装

运行容器并检查 poetry 版本：

docker run --rm d21d3q/python-poetry:latest poetry --version

输出示例：

Poetry (version 1.8.3)  # 版本号随镜像更新可能变化

2. 运行项目依赖安装

挂载本地项目目录，使用 poetry 安装依赖：

# 假设项目目录在当前路径，包含 pyproject.toml
docker run --rm -v $(pwd):/app -w /app d21d3q/python-poetry:3.12 poetry install

3. docker-compose 配置示例

创建 docker-compose.yml 快速启动项目：

version: '3.8'
services:
  app:
    image: d21d3q/python-poetry:3.12
    volumes:
      - ./:/app  # 挂载本地项目目录
    working_dir: /app  # 设置工作目录为项目根目录
    command: poetry run python main.py  # 运行项目主程序

启动服务：

docker-compose up

其他信息

• 项目仓库：[***]
• CI 流水线状态：![pipeline status]([***]
• 更新频率：每月自动重建镜像，同步 poetry、pip、setuptools 至最新版本。