管理触发器
更新时间：2026-04-14
概述
本文档介绍容器镜像服务 CCR 企业版如何配置并使用触发器（Webhook）功能。您可以在实例中配置合适的触发器，当触发动作发生时，自动执行自定义的 POST 请求；也可以快速接入现有研发流程或 CI/CD 平台，实现镜像更新自动触发应用部署等容器 DevOps 场景。
前提条件
操作步骤
创建触发器
导航路径：容器镜像服务 CCR -> 实例列表 -> 目标实例 -> 实例管理 -> 触发器
- 在 【实例列表】 页面单击目标实例。
- 在 【实例管理】 页面选择 【触发器】。
- 在 【触发器】 页面单击 【创建触发器】。
- 在 基本信息 和 触发规则 区域完成以下配置。
| 配置项 | 必选/可选 | 配置说明 |
|---|---|---|
| 触发器名称 | 必选 | 输入自定义触发器名称。 |
| 备注 | 可选 | 输入触发器备注信息。 |
| 触发事件 | 必选 | 当前支持制品推送、制品拉取、制品删除、Helm Chart 推送、Helm Chart 拉取、Helm Chart 删除。 |
| 命名空间 | 必选 | 触发器生效的命名空间。 |
| 仓库名称 | 可选 | 触发器生效的镜像仓库，支持对镜像仓库和 Helm Chart 仓库进行正则匹配，不填默认为全部仓库。 |
| 版本名称 | 可选 | 触发器生效的 Tag，支持正则匹配，不填默认为全部版本。 |
注意：触发事件的触发对象为Tag，即当OCI制品、Helm Chart的Tag被推送、拉取或删除时触发事件才会生效。
- 在 访问配置 区域完成以下配置。
| 配置项 | 必选/可选 | 配置说明 |
|---|---|---|
| 目标 URL | 必选 | 输入触发器被触发后访问的 URL 地址。 |
| Auth Header | 可选 | 只需输入 Authentication: xxxxxxx 中的 xxxxxxx 信息用于身份认证。 |
- 单击 【确定】。
查看访问日志
导航路径：容器镜像服务 CCR -> 实例列表 -> 目标实例 -> 实例管理 -> 触发器
- 在 【实例列表】 页面单击目标实例。
- 在 【实例管理】 页面选择 【触发器】。
- 在触发器列表中找到目标触发器，单击对应操作列的 【访问日志】。
- 查看触发器产生的访问日志。
说明：您可以对访问失败的日志重新触发。
相关信息
Webhook 请求格式参考
当您对符合触发规则的制品或 Helm Chart 执行相应动作时，例如向指定镜像仓库推送新的镜像版本时，相应的触发器将被触发，并向触发规则中配置的 URL 发起 POST 请求。请求 Body 中包含触发动作、仓库路径等信息。以下为触发后并经解析的请求 Body 信息，可供开发 Webhook 服务端参考：
Jsonc
1{
2 "type": "PULL_ARTIFACT", // 类型有 PUSH_ARTIFACT、PULL_ARTIFACT、DELETE_ARTIFACT、UPLOAD_CHART、DOWNLOAD_CHART、DELETE_CHART
3 "occur_at": 1589106605,
4 "event_data": {
5 "resources": [
6 {
7 "digest": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
8 "tag": "v1.10.0",
9 "resource_url": "public/nginx:v1.10.0",
10 },
11 {
12 "digest": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
13 "tag": "v1.11.0",
14 "resource_url": "public/nginx:v1.11.0",
15 }
16 ],
17 "repository": {
18 "date_created": 1587119137,
19 "name": "nginx",
20 "namespace": "public",
21 "repo_full_name": "public/nginx",
22 "repo_type": "public"
23 }
24 },
25 "operator": "zhangsan"
26}评价此篇文章