Jenkins简要教程

Jenkins 简介

简单来说 Jenkins 是一个用 Java 编写的开源的 「持续集成」，「持续交付」，「持续部署」 的工具， 能够将下列这些流程给串联起来，达到自动化地目的。下面，简单来说下这几个概念:

持续集成

409-images-for-snap-blog-postedit_image1.png

持续集成强调开发人员提交了新代码之后，立刻进行构建、（单元）测试。根据测试结果，我们可以确定新代码和原有代码能否正确地集成在一起。

持续交付

409-images-for-snap-blog-postedit_image4-manual.png

持续交付在持续集成的基础上，将集成后的代码部署到更贴近真实运行环境的「类生产环境」中。比如，我们完成单元测试后，可以把代码部署到连接数据库的 Staging 环境中更多的测试。如果代码没有问题，可以继续手动部署到生产环境中。

持续部署

409-images-for-snap-blog-postedit_image3-auto.png

持续部署则是在持续交付的基础上，把部署到生产环境的过程自动化。

Jenkins Pipeline

根据上面的描述，我们知道 Jenkins 最主要的功能就是定义流程。Jenkins 将这个定义流程称为 Pipeline, 那么如何去定义个 Pipeline呢？只需要定义一个 Jenkinsfile 的文件，Jenkins 就能够根按这个文件里的声明来完成流程了，这样通过 code 定义流程也更加符合程序员的使用需要，不需要再页面上繁琐地一步步地创建了。

Jenkinsfile 是有个大概的结构的:

node {                   (1)
    stage('Build') {     (2)
        //               (3)
    }
    stage('Test') { 
        // 
    }
    stage('Deploy') { 
        // 
    }
}

....

(1) node 代表这个流程的运行的环境，node 可以定义多个。

(2) stage 就代表一个具体的步骤，实例上是一个 Build 的步骤，{} 可以定义具体的工作（比如：pull code, 执行编译等等）。

(3) 具体的一个步骤称为一个 step, step 是 pipeline 里的最小单元。

下图就是通过上面代码定义的具体流程图：

image

现在流程的骨架有了，就可以写 stage 里面具体的每个 step 了, 具体的么个 step 的定义可以参考官方文档，其实这个 Jenkinsfile 就是一个 groovy 的脚本，groovy 的语法逻辑将 step 步骤给整合起来，看一个简单的例子：

node {
    stage ('Step 1') {
        // groovy 定义变量，打印变量的语法
        def var = 'hello world'
        println var
        
        // 这个 checkout 就是一个具体的 step，它就是调用了 Jenkisn 的 SCM 插件去 gitlab 上 pull 代码，具体的参数可以去参考官方文档
        checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: '', url: 'git@xxxx:web.git']]])
    }
}

这里还有个问题就是，具体的 step 可读性不是很好，学习成本也比较高，这里有个小技巧，可以通过图形化的页面生成 step 的代码，在 Jenkins 的具体一个项目中，点击 流水线语法:

WX20180331-165318.png
WX20180331-170254.png

使用 Jenkins 来创建一个简单示例

流程：实现从代码的提交 -> 编译 -> 打包成docker image -> 发布

1. 搭建，方法有很多中，这里就用最方便的 docker 来运行，运行完成后就可以直接通过 http://localhost:8080 进行访问。

   docker run \
     -u root \
     --rm \
     -d \
     -p 8080:8080 \
     -p 50000:50000 \
     -v jenkins-data:/var/jenkins_home \
     -v /var/run/docker.sock:/var/run/docker.sock \
     jenkinsci/blueocean
   

2. 在 github 上创建了一个 test-jenkins-pipeline 的示例应用。
   

   WX20180331-163131.png
   我这里编译使用了docker 容器，这样就可以保障一个相对干净的环境，不需要在 Jenkins 上安装编译环境了，同时还实现了分布式打包发布，加快了速度。
   WX20180331-164946.png

3. 在 Jenkins 上新建 test-jenkins-pipeline 的项目。

   
   WX20180331-163244.png
   

   指定 Jenkinsfile 的位置：

   
   WX20180331-163401.png

4. 执行，这步也可以通过 github 的 webhook 自动实现触发。

   
   WX20180331-165028.png

参考

• The Product Managers’ Guide to Continuous Delivery and DevOps