Webhook介绍
阿里云镜像服务为每个仓库提供了Webhook的功能,帮助用户在镜像构建成功后进行消息的推送,实现持续集成的后续流程。如果用户设置了一个容器服务触发器的Webhook,那么当镜像构建成功后,将会自动触发容器服务上应用拉取新的镜像,并进行重新部署。详见文章
目前,阿里云镜像服务提供了两种不同的方式来设置Webhook的触发条件,一种是表达式触发,一种是Tag触发。表达式触发能基于正则表达式来进行Tag的过滤,只有当符合正则表达式的Tag才会继续触发Webhook;而Tag触发,则是基于用户筛选的Tag列表来进行触发。之前未设置触发条件的Webhook会默认为全部触发类型。
使用示例
1. 填写表达式触发
可以填写简单的正则表示,如"release-v.*",则只有Tag为“release-v”开头的镜像版本在构建后,才会触发后续持续集成的流程,否则为未触发状态,访问记录中访问状态码将显示“未触发"。
点击访问记录,可以查看webhook的历史访问详情。
2. 选择Tag触发
可以在列表中筛选需要触发的tag,最多可选10个,则只有当Tag在列表中时,才会在镜像构建后触发Webhook,否则为未触发状态,访问记录中访问状态码将显示“未触发"。
点击访问记录,可以查看webhook的历史访问详情:
通知内容
Webhook的通知内容包含了镜像仓库的信息,以及镜像的版本信息,如下所示。其中,镜像仓库信息包括了仓库的namespace、name以及仓库对应的region等。
POST /payload HTTP/1.1
Content-Type: application/json
Request URL: https://cs.console.aliyun.com/hook/trigger?triggerUrl=YzRmMWE5YzM2ZjMzYzQ0NmFiMGYzNWJlMmM2MjM2NzIyfGV4cHJlc3N8cmVkZXBsb3l8MThlMmllY2drdXYyZXw=&secret=365a4a664b45615438716a487a75695a7ac48329224b35b073c2197374e7d62a
Request method: POST
{
"push_data": {
"digest": "sha256:457f4aa83fc9a6663ab9d1b0a6e2dce25a12a943ed5bf2c1747c58d48bbb4917",
"pushed_at": "2016-11-29 12:25:46",
"tag": "latest"
},
"repository": {
"date_created": "2016-10-28 21:31:42",
"name": "repoTest",
"namespace": "namespace",
"region": "cn-hangzhou",
"repo_authentication_type": "NO_CERTIFIED",
"repo_full_name": "namespace/repoTest",
"repo_origin_type": "NO_CERTIFIED",
"repo_type": "PUBLIC"
}
}