从0搭建属于自己的Jenkins持续集成平台

Jenkins 在日常工作中占据了一个非常重要的角色，帮助我们节省了大量用于构建的时间。有些公司有运维大哥对 Jenkins 进行维护，如果没有那只能自己动手了。俗话说的好自己动手丰衣足食，所以本文就从 0 开始搭建属于自己的 Jenkins 持续平台。主要包含，普通项目构建 、 流水线构建 、 多分支流水线构建 并将构建结果辅以钉钉通知。

centos7 服务器一台

Docker 要求 CentOS 系统的内核版本高于 3.10. 通过 uname -r 命令查看你当前的内核版本。

[root@CentOS ~]# uname -r
3.10.0-1127.8.2.el7.x86_64

备份旧源

mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup

下载最新的源

wget -O /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo

生成缓存

yum makecache

更新

yum update

官方安装文档

yum install -y yum-utils

添加 docker 源

yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

安装 docker

yum install docker-ce

systemctl start docker

vim /etc/docker/daemon.json

加入阿里云源地址

{"registry-mirrors":["https://6kx4zyno.mirror.aliyuncs.com"]
}

重新读取配置

systemctl daemon-reload

重启 docker

systemctl restart docker

下载 jenkins 镜像

docker pull jenkins

设置端口为 9090 并映射 jenkins_home 到宿主机/home/jenkins_home。

docker run -d --name jenkins -p 9090:8080 -v /home/jenkins_home:/var/jenkins_home jenkins

可以通过 docker ps 查看运行的容器。

[root@CentOS home]# docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS              PORTS                               NAMES
ec6a4da6b83f        jenkins             "/bin/tini -- /usr/l…"   About a minute ago   Up About a minute   50000/tcp, 0.0.0.0:9090->8080/tcp   jenkins
[root@CentOS home]#

在运行启动 jenkins 的命令时，可能会出现 jenkins 无法启动情况。

[root@CentOS home]# docker ps -a
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                     PORTS               NAMES
b571f16dafbf        jenkins             "/bin/tini -- /usr/l…"   8 minutes ago       Exited (1) 8 minutes ago                       jenkins
[root@CentOS home]#

可以通过 docker logs 镜像名称 查看启动日志。

[root@CentOS home]# docker logs jenkins
touch: cannot touch '/var/jenkins_home/copy_reference_file.log': Permission denied
Can not write to /var/jenkins_home/copy_reference_file.log. Wrong volume permissions?
[root@CentOS home]#

查看输出的日志，如果出现 Permission denied 类似的错误。需要删除旧容器重新运行。

docker rm jenkins

运行命令加入了 -u 0 重新运行。

docker run -d --name jenkins -p 9090:8080 -v /home/jenkins_home:/var/jenkins_home -u 0 jenkins

参考 https://blog.csdn.net/minicto…

启动成功后输入 http:// 服务器:9090/

如果无法访问，请检查一下防火墙端口是否开放，如果是云服务器还需要检查安全组设置

首次启动 jenkins 需要输入密码，需要进入容器内获取密码。密码位于/var/jenkins_home/secrets/initialAdminPassword。

进入容器

docker exec -it jenkins /bin/bash

获取密码

cat /var/jenkins_home/secrets/initialAdminPassword

[root@CentOS jenkins_home]# docker exec -it jenkins /bin/bash
root@ec6a4da6b83f:/# cat /var/jenkins_home/secrets/initialAdminPassword
68eed23ad39541949972468e4f2ce1fd
root@ec6a4da6b83f:/#

由于我们将 /var/jenkins_home — 挂载到 –> /home/jenkins_home 所以也可以直接cat /home/jenkins_home/secrets/initialAdminPassword 获取密码。

输入密码以后，安装需要的插件，在安装途中由于网络原因会出现有些插件安装失败，这个可以不用理会。

设置 jenkins 的默认登录账号和密码

进入 jenkins 的主页面右上角可能会出现一些报错信息，主要是提示 jenkins 需要的某些插件没有安装，或者说 jenkins 版本太低了，插件无法使用这个时候我们需要先升级 jenkins 做一个升级。

Jenkins 提供了自动升级的方式

可以去 Jenkins 的官网下载好最新 jar 包上传到服务器，也可以使用 wget 命令。

wget http://jenkins 新版本的下载地址
#目前最新 2.239
wget http://updates.jenkins-ci.org/download/war/2.239/jenkins.war

Jenkins 的更新主要是替换 jenkins 镜像里面的 war 包，我们可以把下载好的 war 包使用 docker cp 直接进行复制命令如下：

docker cp jenkins.war jenkins:/usr/share/jenkins

重新启动 Jenkins 即可完成升级。

docker restart jenkins

更插件源

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

替换完源以后点击提交。
然后进入插件管理页面将出错的插件重新安装。
及时更新插件。

Localization: Chinese (Simplified) 1.0.14 汉化包搜索关键字 chinese
Publish Over SSH 1.20.1 搜索关键字 ssh
DingTalk 钉钉通知 2.3.0

主要配置 jdk、maven、git 等常用环境。需要注意配置的别名，后续构建将会使用到。

配置 jdk

因为 jenkins 镜像自带 jdk 所以无需安装直接使用即可，进入 Jenkins 容器，使用 java -verbose 查看 java 安装路径。

docker exec -it jenkins /bin/bash

java -verbose

配置 git

进入容器内使用 whereis git 即可查询到 git 安装路径。

root@6a9fbb129cbe:~# whereis git
git: /usr/bin/git /usr/share/man/man1/git.1.gz
root@6a9fbb129cbe:~#

配置 maven

maven 直接使用自动安装即可。

配置服务器

点击新增即可添加服务器，主要配置：

Name 名称 – 构建的时候将会用到
Hostname 服务器地址
Username 用户名
Remote Directory 远程目录 – 上传文件的目录默认配置根目录即可/。

点击高级进行其他参数配置

如果需要使用密码登录，则选中Use password authentication, or use a different key 复选框即可，如下图所示。

除了配置密码还可以配置端口 Port，跳板机Jump Host 的参数，可以根据实际情况配置。默认可以使用密码。

配置完成以后点击 Test Configuration 按钮，如果配置正常会出现Success 反之出现错误信息，可以根据错误信息，调整配置参数。

配置钉钉

钉钉主要用于构建通知，在配置前需要在钉钉群内，添加自定义机器人。

以 https://gitee.com/huangxunhui/jenkins_demo.git 为例。

配置仓库地址。
配置凭证 - 主要用于拉取代码。
配置需要构建的分支。

添加凭证

如果项目是开源，则可以跳过这一步。反之需要设置凭证，要不然将无法拉取代码进行构建。

可以根据实际情况选择，案例采用轮询的方式进行构建。

将 jar 包发送到相应的服务器。

Source files jar 包的路径。支持通配符匹配.
Remove prefix 移除前缀，一般 jar 包的路径都存在于 **/target 下，如果不移除，会在目标服务器上建立相应的目录结构。
Remote directory 远程目录。

注意的点，在之前配置服务器时也配置了Remote directory，这时候部署的实际目录是，服务器设置的远程目录 + 现在配置的远程目录。

Exec command 执行脚本，主要用于将 jar 发送到目标服务器后，执行相应的启动脚本。

配置完成点击保存即可。

点击开始构建

发送钉钉通知

流水线构建，将上述构建步骤代码化，方便调整。

由于配置步骤类似，前面简单的步骤可以参照，自由风格的软件项目。这里主要讲流水线如何编写。

注意右下角的流水线语法，后续会用上。

我们可以点击右上角的下拉按钮，生成一个简单的流水线。比如说 hello world。

pipeline {
    
    // 表示所有机器都能运行   
   agent any

   stages {stage('Hello') {
         steps {echo 'Hello World'}
      }
   }
}

通过上面的 pipeline 可以知道，有一个 Hello 的步骤，这个步骤执行的是，输出hello world。依葫芦画瓢，一次完整的构建我们可以总结出如下几个步骤：拉取代码(checkout) -> 打包(build) -> 部署(deploy)。

pipeline {
   agent any
   
   stages {stage('checkout') {steps {}
      }
      
      stage('build') {steps {}
      }
      
    stage('deploy') {steps {}
      }
   }
}

步骤梳理好了，这个时候就可以完善对应的步骤了，这就需要用到提到的，流水线语法。

将生成好的流水线脚本复制到对应的步骤即可。

注意：如果使用到 maven 需要将 maven 引入，tools相应的内容就是配置 maven 时配置的别名。

pipeline {
   agent any
   
    // 工具
    tools {
        maven 'maven'
        jdk 'jdk'
    }

   stages {stage('checkout') {
         steps {checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[url: 'https://gitee.com/huangxunhui/jenkins_demo.git']]])
         }
      }
      
      stage('build') {
         steps {sh 'mvn clean package -Dmaven.test.skip=true'}
      }
      
    stage('deploy') {
         steps {
            sshPublisher(publishers: [sshPublisherDesc(configName: 'dev', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand:'''cd /home/project 
nohup java -jar jenkins_demo.jar > nohup.out 2>&1 &''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator:'[,]+', remoteDirectory:'/home/project', remoteDirectorySDF: false, removePrefix:'/target', sourceFiles:'**/target/jenkins_demo.jar')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
         }
      }
      
   }
}

配置完成点击应用即可。

构建测试

上面演示的是将流水线配置在 jenkins 内，其实我们还可以从 SCM 中获取，比如git。

我们可以建立一个仓库专门维护不同项目的构建脚本Jenkinsfile，也可以在每个项目下，建立对应的Jenkinsfile.

注意的点：项目中的 Jenkinsfile 需要和配置的一致。比如说上面的配置，是扫描项目根目录下名字为 Jenkinsfile 的文件。

所以我们可以在 jenkins_demo 仓库内添加 Jenkinsfile 文件。

配置点击完成，即可。

在日常开发中，通常是基于 git-flow 进行开发的，前面两种都是基于单分支构建，如果每个分支都去配置，那将耗费大量时间。所以 多分支流水线 就是用来解决这个问题的。

完成上述配置，点击应用即可。

编写 `jenkinsfile` 文件

核心思想是，根据不同的分支使用不同的打包命令，发送到不同的服务器进行运行。

pipeline {
    // 指定集群 any 表示所有
    agent any

    // 工具
    tools {
        maven 'maven'
        jdk 'jdk'
    }

    // 定义常量
    environment {

        // 钉钉机器人编号
        rebootId = 'a3c07482-d031-47a6-8542-05ac56c5f17a'

        // 开始 logo
        imageOfStart = 'https://www.easyicon.net/api/resizeApi.php?id=1229977&size=128'

        // 成功 logo
        imageOfSuccess = 'https://www.easyicon.net/api/resizeApi.php?id=1194837&size=128'

        // 失败 logo
        imageOfFailure = 'https://www.easyicon.net/api/resizeApi.php?id=1201052&size=128'

        // 不稳定 logo
        imageOfUnstable = 'https://www.easyicon.net/api/resizeApi.php?id=1219854&size=128'

        // 终止 logo
        imageOfAborted = 'https://www.easyicon.net/api/resizeApi.php?id=1183198&size=128'

        // 认证 Id
        credentialsId = '98e9c197-f0ae-44c3-8f67-4ca0339028a8'

        // 仓库地址
        repositoryUrl = 'https://gitee.com/huangxunhui/jenkins_demo.git'

        // 打包命令 - 项目需要配置 maven 多环境
        mavenProd = 'mvn clean package -P prod -Dmaven.test.skip=true'
        mavenTest = 'mvn clean package -P test -Dmaven.test.skip=true'
        mavenDev = 'mvn clean package -P dev -Dmaven.test.skip=true'

        // 服务器名称 - 案例测试 - 全部部署到 dev 环境
        devServer = 'dev'
        testServer = 'dev'
        prodServer = 'dev'

        // sshPublisher 配置
        removePrefix = '/target'
        remoteDirectory = '/home/project/jenkins_demo'
        sourceFiles = '**/target/jenkins_demo.jar'

        execCommandProd = 'cd /home/project && ./manage.sh jenkins_demo/ restart'
        execCommandTest = 'cd /home/project && ./manage.sh jenkins_demo/ restart'
        execCommandDev = 'cd /home/project && ./manage.sh jenkins_demo/ restart'

    }

    stages {stage('开始构建通知'){
            steps {
                dingtalk (robot: "${rebootId}",
                        type: 'LINK',
                        title: "${env.JOB_NAME}",
                        text: ["开始构建 - 编号为 #${BUILD_NUMBER}"
                        ],
                        messageUrl: "${env.BUILD_URL}",
                        picUrl: "${imageOfStart}"
                )
            }
        }

        stage('拉取代码'){
            steps {echo "拉取 ${BRANCH_NAME} 分支的代码。"
                checkout([$class: 'GitSCM', branches: [[name: "*/${BRANCH_NAME}"]], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: "${credentialsId}", url: "${repositoryUrl}"]]])
            }
        }

        stage('进行打包'){
            steps {
                script {if (env.BRANCH_NAME == 'master') {sh "${mavenProd}"
                    } else if (env.BRANCH_NAME == 'test') {sh "${mavenTest}"
                    } else if (env.BRANCH_NAME == 'dev') {sh "${mavenDev}"
                    } else {sh "${mavenDev}"
                    }
                }
            }
        }

        stage('项目部署'){
            steps {
                script {if (env.BRANCH_NAME == 'master') {
                        // 部署生产环境
                        sshPublisher(publishers: [sshPublisherDesc(configName: "${prodServer}", transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand:"${execCommandProd}", execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator:'[,]+', remoteDirectory:"${remoteDirectory}", remoteDirectorySDF: false, removePrefix:"${removePrefix}", sourceFiles:"${sourceFiles}")], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                    } else if (env.BRANCH_NAME == 'test') {
                        // 部署测试环境
                        sshPublisher(publishers: [sshPublisherDesc(configName: "${testServer}", transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand:"${execCommandTest}", execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator:'[,]+', remoteDirectory:"${remoteDirectory}", remoteDirectorySDF: false, removePrefix:"${removePrefix}", sourceFiles:"${sourceFiles}")], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                    } else if (env.BRANCH_NAME == 'dev') {
                        // 部署开发环境
                        sshPublisher(publishers: [sshPublisherDesc(configName: "${devServer}", transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand:"${execCommandDev}", execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator:'[,]+', remoteDirectory:"${remoteDirectory}", remoteDirectorySDF: false, removePrefix:"${removePrefix}", sourceFiles:"${sourceFiles}")], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                    } else {sshPublisher(publishers: [sshPublisherDesc(configName: "${devServer}", transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand:"${execCommandTest}", execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator:'[,]+', remoteDirectory:"${remoteDirectory}", remoteDirectorySDF: false, removePrefix:"${removePrefix}", sourceFiles:"${sourceFiles}")], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                    }
                }
            }
        }
    }

    // 流水线结束通知
    post {

        // 成功通知
        success {
            dingtalk (robot: "${rebootId}",
                    type: 'LINK',
                    title: "${env.JOB_NAME}",
                    text: ["构建成功 - 编号为 #${BUILD_NUMBER}"
                    ],
                    messageUrl: "${env.BUILD_URL}",
                    picUrl: "${imageOfSuccess}"
                )
        }

        // 失败通知
        failure {
            dingtalk (robot: "${rebootId}",
                    type: 'LINK',
                    title: "${env.JOB_NAME}",
                    text: ["构建失败 - 编号为 #${BUILD_NUMBER}"
                    ],
                    messageUrl: "${env.BUILD_URL}",
                    picUrl: "${imageOfFailure}"
            )
        }

        // 构建不稳定通知
        unstable {
            dingtalk (robot: "${rebootId}",
                    type: 'LINK',
                    title: "${env.JOB_NAME}",
                    text: ["构建不稳定 - 编号为 #${BUILD_NUMBER}"
                    ],
                    messageUrl: "${env.BUILD_URL}",
                    picUrl: "${imageOfUnstable}"
            )
        }

        // 构建终止通知
        aborted {
            dingtalk (robot: "${rebootId}",
                    type: 'LINK',
                    title: "${env.JOB_NAME}",
                    text: ["构建终止 - 编号为 #${BUILD_NUMBER}"
                    ],
                    messageUrl: "${env.BUILD_URL}",
                    picUrl: "${imageOfAborted}"
            )
        }
    }
}

使用到的启动脚本manage.sh。

钉钉机器人插件使用文档

如果觉得对你有帮助，可以多多评论，多多点赞哦，也可以到我的主页看看，说不定有你喜欢的文章，也可以随手点个关注哦，谢谢。

前言

前期准备

确认是否能安装 docker

更改 yum 源为阿里云

安装 docker

启动 docker

更改 docker 镜像源

安装 jenkins

启动 jenkins

把玩 jenkins docker 镜像遇到的 volume 权限问题

Jenkins 初始化

处理插件安装失败

自动升级

手动升级

安装必要的插件

配置 jenkins

全局工具配置

配置 jdk

配置 git

配置 maven

系统设置

配置服务器

配置钉钉

自由风格的软件项目

新建项目

设置项目简介

源码管理

添加凭证

构建触发器

构建

构建后操作

流水线

项目创建

流水线编写

多分支流水线

创建项目

配置分支源

构建配置

扫描触发器

编写 jenkinsfile 文件

构建结果

结尾

编写 `jenkinsfile` 文件