管理触发器
更新时间：2024-09-04
容器镜像服务CCR企业版支持灵活配置并使用触发器（Webhook）功能。可以通过在实例中配置合适的触发器，当触发动作发生时，自动执行您自定义的POST请求。您也可以快速接入现有的研发流程或CI/CD平台，实现镜像更新自动触发应用部署等容器DevOps场景。
前提条件
操作步骤
创建触发器
- 登录容器镜像服务控制台。
- 在左侧导航栏，选择实例列表。
- 在“实例列表”页面单击目标实例。
- 在“实例管理”页面左侧导航栏中选择触发器。
- 在“触发器”页面单击创建触发器。
- 在“创建触发器”页面完成基本信息和触发规则配置。
| 配置项 | 必选/可选 | 配置说明 |
|---|---|---|
| 触发器名称 | 必选 | 输入自定义触发器名称。 |
| 备注 | 可选 | 输入触发器备注信息。 |
| 触发事件 | 必选 | 当前支持制品推送、制品拉取、制品删除、Helm Chart推送、Helm Chart拉取、Helm Chart删除。 |
| 命名空间 | 必选 | 触发器生效的命名空间。 |
| 仓库名称 | 可选 | 触发器生效的镜像仓库，支持对镜像仓库和Helm Chart仓库进行正则匹配，不填默认为全部仓库。 |
| 版本名称 | 可选 | 触发器生效的Tag，支持正则匹配，不填默认为全部版本。 |
注意：触发事件的触发对象为Tag，即当OCI制品、Helm Chart的Tag被推送、拉取或删除时触发事件才会生效。
- 继续完成访问配置。
| 配置项 | 必选/可选 | 配置说明 |
|---|---|---|
| 目标URL | 必选 | 输入触发器被触发后访问的URL地址。 |
| Auth Header | 可选 | 只需输入Authentication：xxxxxxx中的xxxxxx信息用于身份认证 |
- 单击确定即可完成创建触发器。
查看访问日志
单击触发器列表右侧操作中的“访问日志”，您可以查看触发器产生的访问日志。
说明：您可以对访问失败的日志重新触发。
相关信息
Webhook请求格式参考
当您对符合触发规则的制品或Helm Chart执行相应动作时，例如向指定镜像仓库推送新的镜像版本时，则相应的触发器将被触发，并向触发规则中配置的URL发起POST请求，请求Body中包含触发动作、仓库路径等信息。以下为推送镜像触发后并经解析的请求Body信息，可供开发Webhook服务端参考：
{
"type": "PULL_ARTIFACT", //类型有PUSH_ARTIFACT，PULL_ARTIFACT，DELETE_ARTIFACT，UPLOAD_CHART，DOWNLOAD_CHART，DELETE_CHART
"occur_at": 1589106605,
"event_data": {
"resources": [
{
"digest": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"tag": "v1.10.0",
"resource_url": "public/nginx:v1.10.0",
},
{
"digest": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"tag": "v1.11.0",
"resource_url": "public/nginx:v1.11.0",
}
],
"repository": {
"date_created": 1587119137,
"name": "nginx",
"namespace": "public",
"repo_full_name": "public/nginx",
"repo_type": "public"
}
},
"operator": "zhangsan"
}