第13章 使用 Trusted Publisher 创建 PyPI 项目
使用可信发布者创建 PyPI 项目
可信发布者不仅适用于现有的 PyPI 项目,你同样可以用它来创建新项目。
这进一步简化了搭建全自动 PyPI 发布流程的步骤:你不再需要手动上传首个版本来“初始化”项目,而是可以配置一个“待激活”(pending)发布者。该发布者在首次使用时会自动创建项目。 “待激活”发布者在首次使用后会自动转变为“常规”发布者,这意味着无需进行额外配置。
配置“待激活”发布者的步骤与常规发布者类似,区别在于配置页面位于你的账户侧边栏下,而不是某个项目的侧边栏下(因为项目尚未创建):
点击“发布”(publishing)会进入一个列出各种可信发布者选项的页面。该页面上的表单操作方式与针对现有项目的发布者配置相同,只是你需要额外提供将要创建的 PyPI 项目名称。
重要 “待激活”发布者不会立即创建项目或预留项目名称,只有在你实际用于发布时才会生效。 如果你创建了“待激活”发布者,但其他用户在你实际发布之前注册了该项目名称,你的“待激活”发布者将失效。
GitHub Actions Google Cloud ActiveState GitLab CI/CD
如果你有一个位于 https://github.com/octo-org/sampleproject 的仓库,其中包含位于 release.yml 的发布工作流,以及名为 pypi 的环境,且你希望将其发布为 PyPI 上的 sampleproject,请按以下步骤操作:
注意 与常规可信发布配置一样,配置 GitHub Actions 环境是可选的,但强烈建议配置。
点击“添加”将注册该“待激活”发布者,并展示给你:
如果你有一个名为 SERVICE_ACCOUNT_NAME@PROJECT_NAME.iam.gserviceaccount.com 的服务账号,它正用于你希望从该环境发布到 PyPI 的服务中,请按以下步骤操作:
注意 与常规可信发布配置一样,配置 subject 是可选的。
点击“添加”将注册该“待激活”发布者,并展示给你:
配置 ActiveState 以创建 PyPI 项目与更新项目的操作相同。你需要提供 ActiveState 项目名称、该名称所属的 ActiveState 组织,以及执行发布操作的 ActiveState 用户。请参阅此处了解如何在 ActiveState 平台上进行设置。
点击“添加”将注册该“待激活”发布者,并展示给你:
注意 目前仅支持托管在 https://gitlab.com 上的项目。不支持自托管实例。
如果你有一个位于 https://gitlab.com/namespace/sampleproject 的仓库,其中在 .gitlab-ci.yml 中定义了顶级流水线,以及名为 release 的环境,且你希望将其发布为 PyPI 上的 sampleproject,请按以下步骤操作:
注意 与常规可信发布配置一样,配置 GitLab CI/CD 环境是可选的,但强烈建议配置。
点击“添加”将注册该“待激活”发布者,并展示给你:
从此刻起,该“待激活”发布者可以像常规发布者一样使用,并在首次使用后自动转换为常规发布者。