1 简介
gitlab不光提供了代码管理,还有其他一些实用的功能,比如Webhooks,Triggers,Piplines以及各种api。本文介绍一下Webhooks与api的使用,本文基于gitlab版本8.14.3,各个版本直接会存在差异。
2 WebHooks
配置webhooks入口在页面右上角设置下面,点击展开后选择Webhooks
- URL写具体要通知的地址,例如Jenkins配置接收Gitlab Hook中Jenkins产生的地址
- <label class="label-light" for="hook_token">Secret Token</label> 这个下面注释解释的也很清楚
- Trigger 配置在哪个阶段去触发这个请求
配置好之后点击Add Webhook就可以了
创建好之后就会在下面显示,后面的Test可以测试请求是否成功。
3 API使用
gitlab的API一定不要百度,因为每个版本的API都不一致,避免出现一些不必要的问题。gitlab的API文档入口:页面右上角点击用户头像->Help,进入页面之后,在页面中找API,点击API进入的页面就是该版本对应的API文档。
API请求需要携带token,token创建的入口:页面右上角点击头像->Profile Setting->AccessTokens下填写Name与Expires at就创建好了。
token的使用:可以加在请求参数后:
GET https://gitlab.example.com/api/v3/projects?private_token=9koXpg98eAheJpvBs5tK
也可以加在请求的header中:
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects"