Skip to content

使用受信任的发布者创建 PyPI 项目

受信任的发布者不仅适用于现有的 PyPI 项目:您还可以使用它们来创建PyPI 项目!

这再次减少了设置全自动 PyPI 发布工作流程所需的步骤:无需手动上传首个版本来“启动”PyPI 项目,您可以配置一个“待发布”的发布者,该发布者会在首次使用时创建项目。“待发布”的发布者会在首次使用时转换为“普通”的发布者,这意味着无需进行任何其他配置。

配置“待定”发布者的步骤与配置普通发布者的步骤类似,不同之处在于,该页面位于您的帐户侧边栏下,而不是任何项目的侧边栏下(因为该项目尚不存在):

图片显示了帐户侧边栏中的“发布”链接

点击“发布”按钮将跳转到一个页面,其中列出了不同的潜在可信发布者。此页面上的表单与现有项目的发布者表单相同,只是您还需要提供要创建的 PyPI 项目的名称。

重要的

“待定”发布者不会创建项目或保留项目名称,直到实际用于发布为止。

如果您创建了一个“待定”发布者,但另一个用户在您实际发布到该项目之前注册了该项目名称,则您的“待定”发布者将 失效。

如果您有一个仓库, https://github.com/octo-org/sampleproject其发布工作流位于, release.yml并且有一个名为的环境pypi,您希望将其发布到 PyPI sampleproject,那么您可以执行以下操作:

图片展示了如何添加新的 GitHub 发布者

笔记

与“普通”可信发布一样,配置 GitHub Actions 环境是可选的,但强烈建议这样做。

点击“添加”按钮,即可注册“待审核”的发布者,并将其显示给您:

图片显示了新添加的 GitHub 发布者

如果您有一个名为 `<service account name>` 的服务帐户 SERVICE_ACCOUNT_NAME@PROJECT_NAME.iam.gserviceaccount.com,并且该帐户被您想要发布到 PyPI 的环境使用,那么您可以执行以下操作:

图片显示添加新的 Google Cloud 发布商

笔记

与“普通”可信发布一样,配置主题是可选的。

点击“添加”按钮,即可注册“待审核”的发布者,并将其显示给您:

图片显示的是新添加的 Google Cloud 发布商。

使用 ActiveState 创建 PyPI 项目与更新项目相同。您需要提供 ActiveState 项目名称、项目所属的 ActiveState 组织以及将执行发布操作的 ActiveState 用户。点击此处了解更多关于在 ActiveState 平台上进行设置的信息。

图片显示添加新的 ActiveState 发布者

点击“添加”按钮,即可注册“待审核”的发布者,并将其显示给您:

图片显示了新添加的 ActiveState 发布者

笔记

目前仅支持托管在https://gitlab.com上的项目。不支持自托管实例。

如果您有一个仓库,其中 https://gitlab.com/namespace/sampleproject包含一个在 `<repository_name>` 中定义的顶级管道 .gitlab-ci.yml,以及一个名为 `<environment_name>` 的环境,release并且您希望将其发布到 PyPI sampleproject,那么您可以执行以下操作:

图片显示如何添加新的 GitLab 发布者

笔记

与“普通”可信发布一样,配置 GitLab CI/CD 环境是可选的,但强烈建议这样做。

点击“添加”按钮,即可注册“待审核”的发布者,并将其显示给您:

图片显示了新添加的 GitLab 发布者

从现在开始,“待定”发布者可以像“普通”发布者一样使用,首次使用后,它将被转换为“普通”发布者。