Jenkins+Gitlab搭建CICD流程入门

本文目标：在本地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的账号密码即可；
• 其余配置暂时保持不动即可；

然后点击保存即可，一个流水线任务就创建完成了。

pipeline配置 pipeline配置添加凭据

四、流水线的创建与配置

代码仓库中新增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：

gitlab的webhook配置

• 网址，填写Jenkins上该Pipeline任务的webhook地址；注意不能是本机地址，即gitlab和jenkins不能在同一台机器上；
• secret令牌，填写jenkins上generate secret token的值；
• 提送事件可以选择master，表示仅master分支的推送才会触发该webhook，这个可以视自己实际情况配置；

最后点击添加该webhook即可，可以点击测试，就能看到Jenkins上的该pipeline任务顺利执行了。

gitlab测试webhook