jamesbabbc/twine

twine Docker镜像文档

镜像概述

本镜像封装了twine工具，twine是一个用于安全上传Python包（如wheel格式）到PyPI（Python Package Index）的命令行工具。通过容器化方式提供twine运行环境，避免本地环境配置依赖冲突，简化Python包的发布流程。

核心功能与特性

• 安全上传：通过HTTPS协议上传包，避免明文传输凭据
• 包验证：上传前自动验证包元数据和兼容性
• 支持多种仓库：可配置上传至PyPI官方仓库或自定义私有仓库
• 环境隔离：容器化运行，不干扰本地Python环境配置
• 轻量级：基于官方Python基础镜像构建，体积小巧

使用场景

• Python包开发者上传wheel包到PyPI
• CI/CD流程中集成自动化包发布步骤
• 需要在多环境中保持一致的包上传工具版本
• 临时或一次性的PyPI包发布需求

使用方法

基本用法

需挂载包含待上传wheel包的本地目录，并通过环境变量提供PyPI凭据。

1. 本地文件上传

bash
docker run -v /本地路径/to/wheels:/wheels \
  -e TWINE_USERNAME=你的PyPI用户名 \
  -e TWINE_PASSWORD=你的PyPI密码或API令牌 \
  twine-image twine upload /wheels/*.whl

2. 使用API令牌（推荐）

PyPI推荐使用API令牌替代密码，需确保令牌具有上传权限：

bash
docker run -v /本地路径/to/wheels:/wheels \
  -e TWINE_USERNAME=__token__ \
  -e TWINE_PASSWORD=pypi-你的API令牌 \
  twine-image twine upload /wheels/*.whl

3. 上传到测试PyPI

如需上传到测试仓库（test.pypi.org）：

bash
docker run -v /本地路径/to/wheels:/wheels \
  -e TWINE_USERNAME=测试仓库用户名 \
  -e TWINE_PASSWORD=测试仓库密码 \
  twine-image twine upload --repository-url https://test.pypi.org/legacy/ /wheels/*.whl

docker-compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  twine-upload:
    image: twine-image
    volumes:
      - ./wheels:/wheels
    environment:
      - TWINE_USERNAME=__token__
      - TWINE_PASSWORD=pypi-你的API令牌
    command: twine upload /wheels/*.whl

运行：docker-compose run twine-upload

配置参数说明

环境变量

命令参数

twine支持的常用命令参数可直接在容器命令中添加，例如：

• --verbose：显示详细上传过程
• --skip-existing：跳过已存在的包版本
• --sign：对包进行GPG签名

示例：

bash
docker run -v /wheels:/wheels -e TWINE_USERNAME=__token__ -e TWINE_PASSWORD=pypi-token twine-image twine upload --verbose --skip-existing /wheels/*.whl

注意事项

• 确保本地wheel文件路径正确挂载到容器内的/wheels目录（或自定义路径）
• API令牌应妥善保管，避免硬编码在脚本中，建议通过环境变量注入
• 上传前建议使用twine check命令验证包完整性：docker run -v /wheels:/wheels twine-image twine check /wheels/*.whl