weastur/poetry 镜像文档

镜像概述与主要用途

本镜像基于非Windows环境的官方Python Docker镜像构建，预安装了最新版Poetry依赖管理工具。它保留了官方Python镜像的简洁性，无任何额外依赖，适用于需要使用Poetry进行Python项目依赖管理、打包和发布的场景。

核心功能与特性

• 基于官方镜像：构建于非Windows官方Python镜像之上，确保基础环境的可靠性与兼容性
• 官方安装方式：使用Poetry官方安装器（[***]
• 无预设配置：未设置任何Poetry默认配置（如不自动启用virtualenvs.in-project）
• 自动化构建：通过GitHub Actions实现全流程自动化构建，确保镜像版本更新及时

使用场景与适用范围

• Python项目开发环境搭建
• 使用Poetry进行依赖管理的Python项目
• 需要标准化Python+Poetry开发环境的团队或个人
• Python项目打包与发布流程

使用方法与配置说明

镜像标签格式

镜像标签遵循以下格式：
{poetry-version}-python-{official-python-image-tag}

其中：

• {poetry-version}：Poetry版本号（如1.5.1）或latest（最新版）
• {official-python-image-tag}：官方Python镜像标签（如3.11.4-bookworm、3.11-alpine）

特殊标签：

• latest：等价于latest-python-latest，即基于python:latest镜像的最新Poetry版本

Dockerfile 示例

# 使用指定Poetry版本和Python版本
FROM weastur/poetry:1.5.1-python-3.11.4-bookworm

# 使用Alpine版本
FROM weastur/poetry:1.5.1-python-3.11-alpine

# 使用最新Poetry和Python 3.11
FROM weastur/poetry:latest-python-3.11

# 使用特殊标签latest（最新Poetry+最新Python）
FROM weastur/poetry:latest

使用 docker run 命令

镜像可通过docker run直接运行，其默认命令（COMMAND）与官方Python镜像一致，仍为python3：

# 启动交互式终端
docker run -ti weastur/poetry bash

# 运行Python脚本（与官方Python镜像用法相同）
docker run -v $(pwd):/app weastur/poetry python3 /app/script.py

镜像内部特性

精简无冗余

镜像使用Poetry官方安装器构建，无任何额外依赖，保持与官方Python镜像一致的精简性。例如，查看已安装包：

➜ docker run -ti weastur/poetry bash
root@87ef07a9832a:/# pip list
Package    Version
---------- -------
pip        22.0.4
setuptools 58.1.0
wheel      0.37.1

无预设Poetry配置

镜像未设置任何Poetry默认配置，所有Poetry行为遵循其默认设置（如不自动启用项目内虚拟环境）。如需自定义配置，需在使用时手动设置（如poetry config virtualenvs.in-project true）。

构建流程

镜像构建流程通过GitHub Actions自动化执行，确保每次更新都基于最新官方Python镜像和Poetry版本。

贡献指南

项目代码托管于GitHub：[***]

贡献要求

• 需安装Docker环境
• 构建流程可参考 .github/workflows/docker-build.yml
• 主要文件：Dockerfile 和 update.py

本地检查

可使用 pre-commit 在提交前进行本地检查：

pre-commit install

支持与***

如果您想支持开发或表达感谢，可通过以下方式：

• 成为GitHub Sponsor
• 购买咖啡（Buy Me A Coffee）

许可协议

本项目采用MIT许可协议，详情参见 LICENSE。