您必须接受服务条款才能在 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”。
Note
如果拥有存储库的帐户尚未接受 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
一标识符将变为可用。
Note
在组织的 GitHub 配置文件上看到的“已验证”徽章不同于 GitHub Marketplace 上的已验证创建者徽章。 如果转移操作存储库,GitHub Marketplace 列表将丢失已验证创建者徽章,除非新所有者也是已验证的创建者。
关于 GitHub Marketplace 中的徽章
带有 或已验证创作者徽章的操作表示 GitHub 已验证操作的创建者为合作伙伴组织。 合作伙伴可以通过向 partnerships@github.com 发送电子邮件来请求已验证的创建者徽章。