持续交付
持续交付
文档指南
请输入
- 文档首页
持续交付用户指南流水线触发器镜像源 Webhook 触发
复制全文
下载 pdf镜像源 Webhook 触发
文档反馈
问问助手持续交付可通过 Webhook 插件的形式监听镜像仓库（CR）的行为，一旦发生符合条件的事件，将自动触发流水线运行。本文为您介绍如何配置镜像源 Webhook 触发规则。
背景信息
对于使用镜像仓库服务的用户，可通过配置镜像源 Webhook 触发规则，在镜像更新后自动触发流水线运行。例如：镜像更新后自动触发流水线的部署任务。
说明
持续交付镜像源 Webhook 触发功能可联动镜像仓库事件通知，在镜像加速场景下自动完成 Nydus 镜像转换，缩短容器冷启动阶段的镜像拉取耗时，具体操作可参考 通过流水线自动转换 Nydus 加速镜像。
前提条件
- 已创建流水线，具体操作请参见 创建流水线。
- 已创建镜像仓库实例、命名空间与 OCI 制品仓库，具体操作请参见 镜像仓库快速入门。
- 本地环境已准备镜像，可推送至镜像仓库触发源镜像 Webhook，推送镜像至镜像仓库的具体操作请参见 推送和拉取镜像。
操作步骤
第一步：创建动态自定义变量
自定义流水线动态变量，用于获取镜像源消息中的镜像完整地址。
- 登录流水线的流程编排页签。
- 登录 持续交付控制台。
- 在左侧导航栏选择 工作区。
- 单击目标工作区名称，进入当前工作区。
- 在左侧导航栏选择 流水线，进入流水线页面。
- 在流水线列表中选择目标流水线，单击 ... > 编辑，进入当前流水线的流程编排页签。
- 单击 变量管理，弹出变量设置面板。
- 切换至 自定义变量 页签，单击 添加，新增一个自定义变量。
- 按如下要求配置自定义变量，配置完成后单击 确定。
- 配置项说明参数输入自定义变量的名称，同一条流水线内名称唯一。建议避免与预置变量重名。本示例设置为image。类型选择变量类型。本场景选择 字符串，由用户自行输入默认值。默认值输入默认使用的镜像完整地址。描述填写当前变量的备注信息，可以为空。隐私不开启隐私设置开关。动态开启动态设置开关。环境变量开启环境变量后引用方式为 ${变量名称} 或 $变量名称。
第二步：创建镜像源 Webhook 触发
- 在流水线的流程编排页签，在 代码源&触发器 面板，单击 添加 > 镜像源 Webhook 触发。
- 按要求配置触发规则，配置完成后单击 确定。
- 配置项说明触发器名称自定义镜像源 Webhook 触发器的名称。同一流水线下的镜像源 Webhook 触发器名称不可重复。URL展示当前流水线的 Webhook URL，流水线通过该 URL 接收镜像仓库 Webhook 事件通知。过滤条件配置触发流水线运行的触发动作和触发条件。
- 触发动作：选择触发流水线运行的事件。当前仅支持 镜像推送。
- 触发条件：可选配置，用于二次过滤符合条件的镜像推送事件。如不配置，则以镜像仓库侧配置的事件通知规则的 生效范围 为准。
- 触发条件可填写地域、镜像类型、实例名、命名空间、OCI 制品仓库、Tag。当前仅支持填写一个触发条件，填写时支持正则表达式，具体示例可参见控制台。
- 例如：触发动作为镜像推送，触发条件为"data":{.*?"repository":"nginx"。表示 nginx 仓库发生镜像推送事件时将触发流水线运行。
运行时变量备注填写当前触发器的备注信息，可以为空。运行时分支当流水线存在代码源时，支持配置运行时使用的代码分支。- 开启：可选择镜像源触发流水线时使用的代码分支。如果希望镜像源触发时使用非默认分支，请配置此参数。例如：同一条流水线，代码源默认分支为主分支，但希望镜像源触发特定分支，则可通过配置此参数实现。
- 关闭：镜像源触发流水线时会使用代码源配置的默认分支。
- 单击 保存，保存流水线配置。
说明
您可在后续流水线部署任务中，通过 $(parameters.变量名) 引用 CR Webhook 消息中获取的完整镜像地址，对应用进行镜像升级。例如：本场景中变量名设置为image，故引用方式为 $(parameters.image)。
第三步：创建镜像推送通知规则
注意
预置占位符
镜像源 Webhook 触发时，可将镜像仓库推送消息中的以下内容，通过占位符赋值给动态变量。动态变量支持添加多个，选择变量来自于动态自定义变量，运行值可为任意下列占位符。
镜像源消息 | 占位符 |
镜像完整地址 | CR_PUSH_IMAGE_URL |
仓库域名 | CR_REGISTRY_HOST |
命名空间 | CR_NAMESPACE |
OCI 制品仓库 | CR_REPOSITORY_NAME |
镜像版本 | CR_IMAGE_TAG |
最近更新时间：2026.06.30 16:25:09
这个页面对您有帮助吗？
有用
有用
无用
无用