触发器

操作场景

容器镜像服务企业版支持配置并使用触发器功能。您可以通过创建触发器，当有触发动作（如上传镜像）发生时，自动执行您定义的HTTP POST请求（如让流水线下载镜像并部署）。使用触发器，您可以快速接入现有研发流程及CI/CD平台，实现容器DevOps场景。

创建触发器

1. 由于容器镜像服务企业版目前处于公测阶段，如果您的租户登录页面后看不到“企业版”链接，请提交工单申请入口。申请成功后，登录容器镜像服务企业版控制台，在页面左上角切换Region到您所在的Region，单击注册表名称进入注册表详情页面。
2. 在左侧导航栏选择“运维中心 > 触发器”。
3. 在右上角单击“创建触发器”。
4. 填写具体规则。

   表1 参数说明

   参数名称	示例	参数说明
   规则名称	TriggerRule	触发器规则的名称。 由字母、汉字、数字、下划线(_)、中划线、(-)组成，1-256个字符。
   命名空间	library1	选择要创建触发器的命名空间。
   规则范围	nginx-*	镜像：镜像名称，默认使用正则表达式匹配。单击可手动选择镜像。 正则表达式规则可填写如nginx-* 、{repo1, repo2} 等，其中： *：匹配不包含路径分隔符“/”的任何字段。 **：匹配包含路径分隔符“/”的任何字段。 ?：匹配任何单个非“/”的字符。 {选项1, 选项2, ...}：同时匹配多个选项。 版本：镜像的版本，同样使用正则表达式匹配，匹配规则与镜像相同。
   触发动作	上传镜像	触发器支持如下触发动作： 上传镜像
   验证远程证书	-	勾选则校验证书是否是授信单位发布，不勾选则不校验。
   请求地址类型	内网	内网，选择内网地址时，触发器将向内网中的目标地址发起请求。 公网，选择公网地址时，触发器将向公网中的目标地址发起请求。
   请求地址	-	触发器被触发后，发起请求的目标地址。触发器将向该地址发起POST请求。 注意： 请确保该地址的后端服务的IP在购买注册表时选择的VPC默认网段范围内，不支持配置VPC默认网段范围之外的IP地址。
   请求头域	-	触发器发起POST请求时，支持以Key:Value形式输入可携带的Header信息。例如，Authentication: xxxxxxx。 多个Header之间用英文分号（;）分隔，例如，param1:value1;param2:value2。

   图1 创建触发器
   

5. 单击“确定”完成创建。

管理触发器

成功创建后即可在“触发器”页面查看已创建的触发器规则，您可以执行以下操作管理触发器。

• 修改规则状态：表示规则启用，表示规则关闭。新创建的触发器规则默认为启用状态，您可以自行调整。
• 编辑：重新编辑触发器规则，除“命名空间”和“请求地址”外，其余参数均可编辑。
• 删除：删除该触发器规则，删除规则时需要输入DELETE进行二次确认。
• 图2 管理触发器
  

触发器结果验证

完成触发器创建后，

按以下步骤验证配置是否生效：

1. 确认触发器状态，在“触发器”列表中，确保新建的规则状态为“已启用”，表示规则启用，表示规则关闭。
2. 触发一次符合条件的镜像操作，在对应的命名空间下，上传一个满足“规则范围”中镜像名称与版本匹配规则的镜像。

   例如，规则范围为 nginx-* 与 v1.*，则上传 nginx-app:v1.0 可触发。

3. 查看触发历史，在触发器列表页，单击左侧下拉框，确认是否有新的触发记录产生。

图3 触发记录