从Jenkins向JFrog发布Python制品遇损坏问题，求正确操作方法

前置准备 #

• 确保JFrog Artifactory配置了Python仓库（本地/虚拟仓库均可），仓库类型选择PyPI格式。
• Jenkins中安装JFrog Artifactory插件，完成JFrog服务器的连接配置（URL、凭证）。
• 构建环境预装python、pip，以及上传工具twine或JFrog CLI。

两种可靠上传方式 #

方式一：Twine + JFrog PyPI仓库 #

1. 构建合法Python包
   执行标准构建命令生成符合PyPI规范的包文件（sdist/wheel），避免构建过程中篡改产物：

   # 传统setup.py方式
   python setup.py sdist bdist_wheel
   # 基于pyproject.toml的现代方式
   python -m build
   

   可提前用twine check dist/*校验包的合法性，排除本身损坏的可能。

2. 配置Twine指向JFrog仓库
   在Jenkins中通过环境变量注入凭证，生成Twine配置文件：

   echo -e "[pypi]\nrepository = https://<jfrog域名>/artifactory/api/pypi/<你的PyPI仓库名>\nusername = ${JFROG_USER}\npassword = ${JFROG_PWD}" > ~/.pypirc
   

   其中${JFROG_USER}和${JFROG_PWD}是Jenkins中存储的JFrog凭证变量。

3. 上传包至JFrog
   使用Twine完成上传，禁止直接用cp/curl等原生文件传输命令（这是包损坏的高频诱因）：

   twine upload dist/* --config-file ~/.pypirc
   

方式二：JFrog CLI（推荐，集成度更高） #

1. 安装JFrog CLI
   在构建环境中快速安装：

   curl -fL https://getcli.jfrog.io | sh
   

2. 配置JFrog连接
   绑定Jenkins中存储的JFrog凭证：

   jfrog rt config --url=https://<jfrog域名>/artifactory --user=${JFROG_USER} --password=${JFROG_PWD}
   

3. 构建并上传
   完成包构建后，用CLI上传并关联Jenkins构建信息：

   jfrog rt upload "dist/*" <你的PyPI仓库名> --props="build.name=${BUILD_NAME};build.number=${BUILD_NUMBER}"
   

防损坏关键注意事项 #

• 绝对避免用原生文件传输命令（cp/scp/curl）直接上传二进制包，此类命令可能破坏文件结构。
• 上传前后可对比包的哈希值（MD5/SHA256），在JFrog仓库中校验完整性。
• 确保上传用户拥有JFrog仓库的Deploy权限，避免因权限不足导致上传中断、文件截断。
• 构建环境的Python版本需与包的兼容要求匹配，避免生成不合法的包文件。

内容的提问来源于stack exchange，提问作者PT_1010