跳至主要内容

在 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 上,导航到仓库的主页。

  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 上,导航到仓库的主页。

  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.