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

说明

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

## 背景信息镜像仓库支持对指定实例、命名空间或 OCI 制品仓库中的镜像推送事件发送通知。例如，推送规则的生效范围为 A 命名空间中的所有 Nginx 镜像版本，当 Nginx OCI 制品仓库中新增或更新镜像或 Chart 版本时，镜像仓库将发生镜像推送成功的通知。 ## 前提条件已创建标准版实例，操作方法参见 [创建标准实例](https://www.volcengine.com/docs/6420/106367) **。** ## 注意事项 * 最多支持启用 20 条通知规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。 * 通知规则创建完成并开启后才能生效。支持以下开启方式。 * 创建时：在 **通知规则 \> 规则状态** 选中 **开启**。 * 创建后：在通知规则列表页，目标规则的 **操作** 列下单击 **启用**，开启规则。 ## 操作步骤 1. 登录 [镜像仓库控制台](https://console.volcengine.com/cr)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏单击 **事件通知**。 4. 在 **事件通知** 页面，单击 **创建通知规则**。 5. 填写通知规则参数。 * **基本信息** |参数 |描述 | |---|---| |触发动作 |选择触发通知的事件。本场景中选择 **镜像推送**。 | |名称 |自定义通知规则的名称。 | * **生效范围**![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c0a217d995711ae189d72a710a04d8d7.png) |参数 |描述 | |---|---| |生效层级 |支持基于实例、命名空间和 OCI 制品仓库维度制定通知规则。

* 实例：基于实例维度制定通知规则，实例下所有命名空间和 OCI 制品仓库都为生效范围。

* 命名空间：基于命名空间维度制定通知规则，命名空间下所有 OCI 制品仓库都为生效范围。

* OCI 制品仓库：基于 OCI 制品仓库维度制定通知规则，支持选择多个 OCI 制品仓库。 | |实例 |选择通知规则生效的实例。 | |命名空间 |选择通知规则生效的命名空间。 | |OCI 制品仓库 |选择通知规则生效的 OCI 制品仓库，支持选择多个。 | |制品类型 |选择生效的制品的类型，当前支持 **镜像**、**Chart** 或者全部。 | |版本 |选择通知规则生效的镜像或者 Chart 版本。支持选择全部或者通过正则表达式筛选。常见的版本筛选正则表达式参见 [正则匹配示例](https://www.volcengine.com/docs/6420/2488135?lang=zh)。 | * **通知规则**![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9e30873a56cb67604a94ffe8c8b5d210.png) |参数 |描述 | |---|---| |规则状态 |支持选择启用或禁用通知规则。最多支持启用 20 条通知规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。 | |通知方式 |当前仅支持 **HTTP（s）** 。 | |目标 URL |事件触发后访问的 URL 地址，通知的信息将传递到该地址中。例如 Webhook 的地址。 | |自定义 Header |支持根据业务场景，自定义目标 URL 的 Header。 | 6. 配置完成后单击 **确定**，完成创建。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_793009bde06828982a96d92c5633c838.png) ## 消息示例成功推送后，您将接收到 Hook 消息通知，示例和参数说明如下。 ```json { "id": "283154ee-797d-4842-9ce4-****", "source": "cr", "type": "cr:Tag:Push", "specversion": "1.0", "time": "2024-02-03T20:02:11Z", "volcaccountid": "210013****", "volcregion": "cn-beijing", "data": { "image": "enterprise-****.cr.volces.com/event-****/event-****:event-****", "registry": "enterprise-****", "namespace": "event-****", "repository": "event-****", "tag": "event-****", "digest": "sha256:4e973642bc4933eb9bea99e5b64ddc1bc16a152a4e7038a442bcf2338994****", "operator": "paas****@****", "type": "Image" } } ``` |参数 ||描述 | |---|---|---| |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。 | ##