本文目标：在本地Windows上安装Jenkins，实现远程gitlab合并分支时自动触发CICD。
本文是上一篇文章基于Docker搭建JenkinsCICD流程 - 简书 (jianshu.com)的延续，上一篇是使用Docker进行Jenkins安装的，多少有些问题，所以才有了本篇文章。
一、Jenkins的安装
Jenkins的安装方式有很多种，可以参考官网的说明：Installing Jenkins，如果像我一样是在Windows上实验的，推荐使用下载安装包或者使用war包的方式，这里为了简单，就是用war包的方式演示。准备内容：
- 下载好Jenkins的war包；
- 下载并安装好JDK17；
- 下载并安装好maven；
然后我们就可以启动Jenkins了：
# 使用java17启动，设置合适的端口
D:\jdk17\jdk-17.0.4.1\bin\java -jar .\jenkins.war --httpPort=9090
然后访问localhost:9090就可以使用启动日志中的密码解锁Jenkins了，然后安装推荐的插件，并创建一个超管账户，到此Jenkins的启动配置就完成了。
二、Java项目的准备
从start.spring.io上新建一个SpringBoot项目，基本内容如下：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
@Slf4j
@RestController
public class HelloController {
@RequestMapping("/hello")
public String getHello(){
log.info("hello!!!");
return "hello!";
}
}
然后将该代码库提交到自己的gitlab仓库里面。
三、Pipeline任务的创建
现在我们在Jenkins界面选择新建一个任务，然后随意填写任务名称，选择类型为pipeline流水线类型，点击下一步，在流水线配置中内容填写如下：
- 定义选择
Pipeline script from SCM，即使用代码仓库中的Jenkinsfile来定义流水线； - SCM选择Git；
- Repository URL填写本地代码仓库所在的路径，本文为
http://10.96.12.149/gitlab-instance-9a531526/java-cicd-test.git； - 凭据需要临时创建一个，使用自己访问gitlab的账号密码即可；
- 其余配置暂时保持不动即可；
然后点击保存即可，一个流水线任务就创建完成了。
四、流水线的创建与配置
代码仓库中新增Jenkinsfile，内容如下：
pipeline {
agent any
stages {
stage('Build') {
steps {
bat 'mvn -B -DskipTests clean package'
}
}
}
}
因为本文是将jenkins安装在windows上的，所以是如上命令，如果是在Linux上，则改为如下命令：
sh 'mvn -B -DskipTests clean package'
然后提交到代码仓库中，再次回到Jenkins中，启动上一步创建的Pipeline任务，切换到Console Outout界面输入如下：
......
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.197 s
[INFO] Finished at: 2022-10-09T11:08:24+08:00
[INFO] ------------------------------------------------------------------------
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS
至此，一个手动触发的任务配置和执行成功了。
五、配置自动触发Pipeline
在Jenkins的项目的配置中，修改“构建触发器”的配置如下：
- 勾选
Build when a change is pushed to GitLab;然后保存后面的webhook地址，后面配置gitlab hook的时候需要用到； - 确保勾选
Filter branches by regex，然后Target Branch Regex填写master； - 然后点击generate secret token，保持生成的token值，后面配置gitlab hook的时候需要用到；
然后点击保存，下面再配置项目的Gitlab WebHook：
- 网址，填写Jenkins上该Pipeline任务的webhook地址；注意不能是本机地址，即gitlab和jenkins不能在同一台机器上；
- secret令牌，填写jenkins上generate secret token的值；
- 提送事件可以选择master，表示仅master分支的推送才会触发该webhook，这个可以视自己实际情况配置；
最后点击添加该webhook即可，可以点击测试，就能看到Jenkins上的该pipeline任务顺利执行了。
