您必须接受服务条款才能在 GitHub Marketplace 上发布操作。
关于发布操作
在您发布操作之前,您需要在您的仓库中创建操作。有关更多信息,请参阅“创建操作”。
当您计划将您的操作发布到 GitHub Marketplace 时,您需要确保仓库仅包含元数据文件、代码和操作所需的文件。为操作创建单个仓库可以让您在单个单元中标记、发布和打包代码。GitHub 还使用您 GitHub Marketplace 页面上的操作元数据。
操作会立即发布到 GitHub Marketplace,并且只要它们满足以下要求,就不会由 GitHub 审核。
- 操作必须位于公共仓库中。
- 每个仓库必须包含单个操作。
- 每个仓库不能包含任何工作流文件。
- 操作的元数据文件 (
action.yml
或action.yaml
) 必须位于仓库的根目录中。 - 操作元数据文件中的
name
必须是唯一的。name
不能与已发布在 GitHub Marketplace 上的现有操作名称匹配。name
不能与 GitHub 上的用户或组织匹配,除非用户或组织所有者发布了该操作。例如,只有 GitHub 组织才能发布名为github
的操作。name
不能与现有的 GitHub Marketplace 类别匹配。- GitHub 保留 GitHub 功能的名称。
发布操作
您可以通过将创建的操作标记为新版本并发布它来将其添加到 GitHub Marketplace。
要草拟新版本并将操作发布到 GitHub Marketplace,请按照以下说明操作
-
在 GitHub.com 上,导航到存储库的主页。
-
导航到存储库中的操作元数据文件(
action.yml
或action.yaml
),您将看到一个将操作发布到 GitHub Marketplace 的横幅。单击 **草拟发布**。 -
在“发布操作”下,选择 **将此操作发布到 GitHub Marketplace**。
**注意**:如果拥有存储库的帐户尚未接受 GitHub Marketplace 开发者协议,则“发布”复选框将被禁用。如果您拥有存储库或是有组织所有者,请单击链接以“接受 GitHub Marketplace 开发者协议”,然后接受协议。如果没有链接,请向组织所有者发送指向此“发布操作”页面的链接,并要求他们接受协议。
-
如果元数据文件中的标签存在任何问题,您将看到错误消息。通过更新元数据文件来解决它们。完成后,您将看到“一切正常!”消息。
-
选择 **主要类别** 下拉菜单,然后单击一个类别,这将有助于人们在 GitHub Marketplace 中找到您的操作。
-
可选地,选择 **另一个类别** 下拉菜单,然后单击一个辅助类别。
-
在标签字段中,为您的操作键入一个版本。这有助于人们了解版本包含哪些更改或功能。人们将在操作的专用 GitHub Marketplace 页面中看到该版本。
-
在标题字段中,键入一个发布标题。
-
填写所有其他字段,然后单击 **发布版本**。发布需要您使用双重身份验证。有关更多信息,请参阅“配置双重身份验证”。
从 GitHub Marketplace 中删除操作
要从 GitHub Marketplace 中删除已发布的操作,您需要更新每个已发布的版本。对已发布到 GitHub Marketplace 的每个操作版本执行以下步骤。
-
在 GitHub.com 上,导航到存储库的主页。
-
在文件列表的右侧,单击 **版本**。
-
在要编辑的版本旁边,单击 .
-
选择 **将此操作发布到 GitHub Marketplace** 以从框中删除选中标记。
-
单击页面底部的 **更新版本**。
转移操作存储库
您可以将操作存储库转移到其他用户或组织。有关更多信息,请参阅“转移存储库”。
当存储库管理员转移操作存储库时,GitHub 会自动从之前的 URL 创建重定向到新的 URL,这意味着使用受影响操作的工作流程无需更新。
发布在 GitHub Marketplace 上的操作通过其唯一的 name
标识符链接到存储库,这意味着您可以从转移的存储库中发布操作的新版本,这些版本在同一个 GitHub Marketplace 列表下。如果操作存储库被删除,GitHub Marketplace 列表也会被删除,并且唯一的 name
标识符将变为可用。
注意:组织的 GitHub 个人资料上显示的“已验证”徽章与 GitHub Marketplace 上的已验证创建者徽章不同。如果您转移操作存储库,GitHub Marketplace 列表将丢失已验证创建者徽章,除非新所有者也是已验证创建者。
关于 GitHub Marketplace 中的徽章
具有 或已验证创建者徽章的操作表明 GitHub 已将操作的创建者验证为合作伙伴组织。合作伙伴可以发送电子邮件至 [email protected] 以请求已验证创建者徽章。