文档中心

镜像仓库

事件通知

创建镜像推送通知规则

镜像仓库支持发送消息通知，帮忙您第一时间获取镜像推送成功的信息。本文介绍创建镜像推送通知规则的方法。

说明

本操作仅适用于标准版标准实例。

背景信息

镜像仓库支持对指定实例、命名空间或 OCI 制品仓库中的镜像推送事件发送通知。例如，推送规则的生效范围为 A 命名空间中的所有 Nginx 镜像版本，当 Nginx OCI 制品仓库中新增或更新镜像或 Chart 版本时，镜像仓库将发生镜像推送成功的通知。

前提条件

已创建标准版实例，操作方法参见创建标准实例。

注意事项

操作步骤

参数	描述
生效层级	支持基于实例、命名空间和 OCI 制品仓库维度制定通知规则。实例：基于实例维度制定通知规则，实例下所有命名空间和 OCI 制品仓库都为生效范围。命名空间：基于命名空间维度制定通知规则，命名空间下所有 OCI 制品仓库都为生效范围。 OCI 制品仓库：基于 OCI 制品仓库维度制定通知规则，支持选择多个 OCI 制品仓库。
实例	选择通知规则生效的实例。
命名空间	选择通知规则生效的命名空间。
OCI 制品仓库	选择通知规则生效的 OCI 制品仓库，支持选择多个。
制品类型	选择生效的制品的类型，当前支持镜像、Chart 或者全部。
版本	选择通知规则生效的镜像或者 Chart 版本。支持选择全部或者通过正则表达式筛选。常见的版本筛选正则表达式参见正则匹配示例。

参数	描述
规则状态	支持选择启用或禁用通知规则。最多支持启用 20 条通知规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。
通知方式	当前仅支持 HTTP（s）。
目标 URL	事件触发后访问的 URL 地址，通知的信息将传递到该地址中。例如 Webhook 的地址。
自定义 Header	支持根据业务场景，自定义目标 URL 的 Header。

消息示例

成功推送后，您将接收到 Hook 消息通知，示例和参数说明如下。

参数			描述
id			推送消息的 ID。
source			消息推送的源头，固定为 cr，表示镜像仓库产品。
type			触发通知的事件。cr:Image:Pushed 表示镜像推送事件。
specversion			消息通知版本，固定参数，无需关注。
time			消息通知发送的时间。
volcaccountid			消息通知创建人火山引擎账号的 ID。
volcregion			发送消息通知的火山引擎地域。
data	image	镜像的地址。
		registry	镜像所在的实例名称。
		namespace	镜像所在的命名空间。
		repository	OCI 制品的名称。
		tag	镜像的版本号。
		digest	镜像内容的标识符。
		operator	通知创建用户的火山引擎账号。
		type	推送的 OCI 制品的类型。 image ：镜像。 chart ：Helm Chart。

最近更新时间：2026.06.25 20:40:58

这个页面对您有帮助吗？

有用

无用