跳至主要内容

在 GitHub Marketplace 上发布操作

您可以在 GitHub Marketplace 上发布操作,并与 GitHub 社区共享您创建的操作。

您必须接受服务条款才能在 GitHub Marketplace 上发布操作。

关于发布操作

在您发布操作之前,您需要在您的仓库中创建操作。有关更多信息,请参阅“创建操作”。

当您计划将您的操作发布到 GitHub Marketplace 时,您需要确保仓库仅包含元数据文件、代码和操作所需的文件。为操作创建单个仓库可以让您在单个单元中标记、发布和打包代码。GitHub 还使用您 GitHub Marketplace 页面上的操作元数据。

操作会立即发布到 GitHub Marketplace,并且只要它们满足以下要求,就不会由 GitHub 审核。

  • 操作必须位于公共仓库中。
  • 每个仓库必须包含单个操作。
  • 每个仓库不能包含任何工作流文件。
  • 操作的元数据文件 (action.ymlaction.yaml) 必须位于仓库的根目录中。
  • 操作元数据文件中的name必须是唯一的。
    • name不能与已发布在 GitHub Marketplace 上的现有操作名称匹配。
    • name不能与 GitHub 上的用户或组织匹配,除非用户或组织所有者发布了该操作。例如,只有 GitHub 组织才能发布名为github的操作。
    • name 不能与现有的 GitHub Marketplace 类别匹配。
    • GitHub 保留 GitHub 功能的名称。

发布操作

您可以通过将创建的操作标记为新版本并发布它来将其添加到 GitHub Marketplace。

要草拟新版本并将操作发布到 GitHub Marketplace,请按照以下说明操作

  1. 在 GitHub.com 上,导航到存储库的主页。

  2. 导航到存储库中的操作元数据文件(action.ymlaction.yaml),您将看到一个将操作发布到 GitHub Marketplace 的横幅。单击 **草拟发布**。

  3. 在“发布操作”下,选择 **将此操作发布到 GitHub Marketplace**。

    **注意**:如果拥有存储库的帐户尚未接受 GitHub Marketplace 开发者协议,则“发布”复选框将被禁用。如果您拥有存储库或是有组织所有者,请单击链接以“接受 GitHub Marketplace 开发者协议”,然后接受协议。如果没有链接,请向组织所有者发送指向此“发布操作”页面的链接,并要求他们接受协议。

  4. 如果元数据文件中的标签存在任何问题,您将看到错误消息。通过更新元数据文件来解决它们。完成后,您将看到“一切正常!”消息。

  5. 选择 **主要类别** 下拉菜单,然后单击一个类别,这将有助于人们在 GitHub Marketplace 中找到您的操作。

  6. 可选地,选择 **另一个类别** 下拉菜单,然后单击一个辅助类别。

  7. 在标签字段中,为您的操作键入一个版本。这有助于人们了解版本包含哪些更改或功能。人们将在操作的专用 GitHub Marketplace 页面中看到该版本。

  8. 在标题字段中,键入一个发布标题。

  9. 填写所有其他字段,然后单击 **发布版本**。发布需要您使用双重身份验证。有关更多信息,请参阅“配置双重身份验证”。

从 GitHub Marketplace 中删除操作

要从 GitHub Marketplace 中删除已发布的操作,您需要更新每个已发布的版本。对已发布到 GitHub Marketplace 的每个操作版本执行以下步骤。

  1. 在 GitHub.com 上,导航到存储库的主页。

  2. 在文件列表的右侧,单击 **版本**。

    Screenshot of the main page of a repository. A link, labeled "Releases", is highlighted with an orange outline.

  3. 在要编辑的版本旁边,单击 .

    Screenshot of a release in the releases list. A pencil icon is highlighted with an orange outline.

  4. 选择 **将此操作发布到 GitHub Marketplace** 以从框中删除选中标记。

  5. 单击页面底部的 **更新版本**。

转移操作存储库

您可以将操作存储库转移到其他用户或组织。有关更多信息,请参阅“转移存储库”。

当存储库管理员转移操作存储库时,GitHub 会自动从之前的 URL 创建重定向到新的 URL,这意味着使用受影响操作的工作流程无需更新。

发布在 GitHub Marketplace 上的操作通过其唯一的 name 标识符链接到存储库,这意味着您可以从转移的存储库中发布操作的新版本,这些版本在同一个 GitHub Marketplace 列表下。如果操作存储库被删除,GitHub Marketplace 列表也会被删除,并且唯一的 name 标识符将变为可用。

注意:组织的 GitHub 个人资料上显示的“已验证”徽章与 GitHub Marketplace 上的已验证创建者徽章不同。如果您转移操作存储库,GitHub Marketplace 列表将丢失已验证创建者徽章,除非新所有者也是已验证创建者。

关于 GitHub Marketplace 中的徽章

具有 或已验证创建者徽章的操作表明 GitHub 已将操作的创建者验证为合作伙伴组织。合作伙伴可以发送电子邮件至 [email protected] 以请求已验证创建者徽章。

Screenshot of GitHub Actions with the verified creator badge.