Bitbucket 更新触发Jenkins任务
xiaodaiwang 2014-04-08
(一)Jenkins项目的准备
1.首先要有一个项目
2.现在我们的源码管理一般采用Git或者Mercurial.下面分别介绍两种代码库的设置。
Git：
(1)在源码管理下，选择Git。
(2)Repository URL文本框需要填写clone时使用代码库的https地址。(需要去掉username@)
注意：如果提示status = 404，证明你填写的URL不正确
(3)Credentials需要选择代码库对应的帐号和密码。在下拉框中如果没有你的帐号和密码，请联系Jenkins管理员，普通用户是没有权限添加这个选项的，需要管理员设置。
注意：如果提示status = 401，证明你选择的Credentials不正确。
(4)在构建触发器下，选择触发器远程构建、Build when a change is pushed to Gitbucket和Build when a change is pushed to GitHub这个三个选项。在选中触发器远程构建选项之后，会出现“身份验证令牌”，该处需要填写一个token串，在下面配置Bitbucket hook时会需要使用。
(5)进入用户设置，会看到一个API Token项，点击Show API Token。会显示一串数字和字母的组合。拷贝这个Token串。
Mercurial:
(1)在源码管理下，选择Mercurial，而不是Mercurial(feature branch aware)。
(2)Repository URL设置与Git设置类似，填写的都是去掉username@的代码库地址。
(3)Credentials需要选择代码库对应的帐号和密码。
(4)在构建触发器下，选择触发器远程构建、Build when a change is pushed to Gitbucket和Build when a change is pushed to GitHub这个三个选项。在选中触发器远程构建选项之后，会出现“身份验证令牌”，该处需要填写一个token串，在下面配置Bitbucket hook时会需要使用。
(5)进入用户设置，会看到一个API Token项，点击Show API Token。会显示一串数字和字母的组合。拷贝这个Token串。
(二)设置Bitbucket hook
在设置之前，需要有代码库的管理员权限。
1.进入到代码库，点击administration。
2.点击Hooks选项（侧栏）
3.在select a hook中选择Jenkins，点击add hook。
4.在弹出的对话框中会有四个文本框：
Endpoint:该文本框需要填写触发构建的Jenkins信息。格式为：http://username:[email protected]
username为Jenkins用户名
apitoken为在上面(5)得到的APIToken串
JenkinsServeUrl.com为Jenkins服务器地址，需要为外网地址。
Module name:可选。该选项可以设置你关注的侧重点。如果设置，只有push的commit中包含对这个文件间或者文件的修改才会触发一次构建。
Project name:为Jenkins建立的job的项目名称
Token:需要填写上面(4)设置的token串。
