您必须接受服务条款才能在 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 上,导航到存储库的主页面。
-
导航到存储库中的操作元数据文件(
action.yml
或action.yaml
),将看到用于将操作发布到 GitHub Marketplace 的横幅。 单击“草稿版本”。 -
在“发布操作”下,选择“将此操作发布到 GitHub Marketplace”。
注意:如果拥有存储库的帐户尚未接受 GitHub Marketplace 开发人员协议,则禁用“发布”复选框。 如果你拥有存储库或是组织所有者,请单击“接受 GitHub Marketplace 开发人员协议”链接,然后接受该协议。 如果没有链接,请向组织所有者发送指向此“发布操作”页面的链接来要求他们接受该协议。
-
如果元数据文件中的标签包含任何问题,您将看到一条错误消息。 通过更新元数据文件来解决这些问题。 完成后,你将看到“看起来一切正常!”消息 消息作为响应。
-
选择“主要类别”下拉菜单,然后单击可帮助用户在 GitHub Marketplace 中查找操作的类别。
-
(可选)选择“其他类别”下拉菜单,然后单击一个辅助类别。
-
在标记字段中,为操作键入一个版本。 这有助于人们知道发行版包含哪些变化或特征。 人们将在操作的专门 GitHub Marketplace 页面中看到版本。
-
在标题字段中,键入发布标题。
-
完成所有其他字段,然后单击“发布版本”。 发布需要使用双重身份验证。 有关详细信息,请参阅“配置双重身份验证”。
从 GitHub Marketplace 删除操作
要从 GitHub Marketplace 删除已发布的操作,您需要更新每个已发布的发行版。 对已发布到 GitHub Marketplace 的操作的每个发行版执行以下步骤。
-
在 GitHub 上,导航到存储库的主页面。
-
在文件列表右侧,单击“发布”。
-
在要编辑的版本旁边,单击 。
-
选择“将此操作发布到 GitHub Marketplace”以取消选中复选框。
-
单击页面底部的“更新版本”。
转移操作存储库
可以将操作存储库转移到其他用户或组织。 有关详细信息,请参阅“转让仓库”。
当存储库管理员转移操作存储库时,GitHub 会自动创建从上一 URL 到新 URL 的重定向,这意味着不需要更新使用受影响操作的工作流。
在 GitHub Marketplace 上发布的操作通过其唯一 name
标识符链接到存储库,这意味着你可以在同一 GitHub Marketplace 列表下从转移的存储库中发布操作的新版本。 删除操作存储库会同时删除 GitHub Marketplace 列表,并且唯 name
一标识符将变为可用。
注意: 在组织的 GitHub 配置文件上看到的“已验证”徽章不同于 GitHub Marketplace 上的已验证创建者徽章。 如果转移操作存储库,GitHub Marketplace 列表将丢失已验证创建者徽章,除非新所有者也是已验证的创建者。
关于 GitHub Marketplace 中的徽章
带有 或已验证创作者徽章的操作表示 GitHub 已验证操作的创建者为合作伙伴组织。 合作伙伴可以通过向 partnerships@github.com 发送电子邮件来请求已验证的创建者徽章。