# 触发器 #### 操作场景 容器镜像服务企业版支持配置并使用触发器功能。您可以通过创建触发器，当有触发动作（如上传镜像）发生时，自动执行您定义的HTTP POST请求（如让流水线下载镜像并部署）。使用触发器，您可以快速接入现有研发流程及CI/CD平台，实现容器DevOps场景。 #### 创建触发器 1. 由于容器镜像服务企业版目前处于公测阶段，如果您的租户登录页面后看不到"企业版"链接，请提交[工单](https://console.huaweicloud.com/ticket/?locale=zh-cn#/ticketindex/createIndex)申请入口。申请成功后，登录容器镜像服务企业版控制台，在页面左上角切换Region到您所在的Region，单击注册表名称进入注册表详情页面。 2. 在左侧导航栏选择"运维中心 \> 触发器"。 3. 在右上角单击"创建触发器"。 4. 填写具体规则。 表1参数说明 | 参数名称 | 示例 | 参数说明 | |:---|:---|:---| | 规则名称 | **TriggerRule** | 触发器规则的名称。 由字母、汉字、数字、下划线(_)、中划线、(-)组成，1-256个字符。 | | 命名空间 | **library1** | 选择要创建触发器的命名空间。 | | 规则范围 | **nginx-\*** | **镜像** ：镜像名称，默认使用正则表达式匹配。单击![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002619404381.png)可手动选择镜像。 正则表达式规则可填写如nginx-\* 、{repo1, repo2} 等，其中： - **\***：匹配不包含路径分隔符"/"的任何字段。 - **\*\***：匹配包含路径分隔符"/"的任何字段。 - **?**：匹配任何单个非"/"的字符。 - **{选项1, 选项2, ...}**：同时匹配多个选项。 **版本**：镜像的版本，同样使用正则表达式匹配，匹配规则与镜像相同。 | | 触发动作 | **上传镜像** | 触发器支持如下触发动作： 上传镜像 | | 验证远程证书 | **-** | 勾选则校验证书是否是授信单位发布，不勾选则不校验。 | | 请求地址类型 | **内网** | - 内网，选择内网地址时，触发器将向内网中的目标地址发起请求。 - 公网，选择公网地址时，触发器将向公网中的目标地址发起请求。 | | 请求地址 | **-** | 触发器被触发后，发起请求的目标地址。触发器将向该地址发起POST请求。 注意： 请确保该地址的后端服务的IP在购买注册表时选择的VPC默认网段范围内，不支持配置VPC默认网段范围之外的IP地址。 | | 请求头域 | **-** | 触发器发起POST请求时，支持以Key:Value形式输入可携带的Header信息。例如，Authentication: xxxxxxx。 多个Header之间用英文分号（;）分隔，例如，param1:value1;param2:value2。 | 图1创建触发器 ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000001868029713.png) 5. 单击"确定"完成创建。 #### 管理触发器 成功创建后即可在"触发器"页面查看已创建的触发器规则，您可以执行以下操作管理触发器。 - 修改规则状态：![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000001141792386.png)表示规则启用，![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000001141792556.png)表示规则关闭。新创建的触发器规则默认为启用状态，您可以自行调整。 - 编辑：重新编辑触发器规则，除"命名空间"和"请求地址"外，其余参数均可编辑。 - 删除：删除该触发器规则，删除规则时需要输入DELETE进行二次确认。 - 图2管理触发器 ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002008306705.png) #### 触发器结果验证 完成触发器创建后， 按以下步骤验证配置是否生效： 1. 确认触发器状态，在"触发器"列表中，确保新建的规则状态为"已启用"，![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002589124636.png)表示规则启用，![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002619524261.png)表示规则关闭。 2. 触发一次符合条件的镜像操作，在对应的命名空间下，上传一个满足"规则范围"中镜像名称与版本匹配规则的镜像。 例如，规则范围为 nginx-\* 与 v1.\*，则上传 nginx-app:v1.0 可触发。 3. 查看触发历史，在触发器列表页，单击左侧下拉框，确认是否有新的触发记录产生。 图3触发记录 ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002657283427.png) 表2触发记录说明 | 参数 | 示例 | 参数说明 | |:---|:---|:---| | 触发动作 | 上传镜像 | 产生本次触发记录的具体操作类型，当前支持"上传镜像"动作。 | | 触发资源 | library/docker_test:v100 | 触发本次操作的镜像完整地址，包含命名空间、镜像名称和版本标签。 | | 状态 | 成功 | 触发器执行Webhook请求的状态。 - 成功：触发器成功执行了Webhook请求。 - 失败：触发器在执行Webhook请求时遇到错误，请求未能成功完成。 | | 创建时间 | 2025-03-25 10:30:22 GMT+08:00 | 触发器发起Webhook请求的时间，用于追溯触发顺序及排查延迟问题。 |