从0搭建属于自己的jenkins持续集成平台（采用流水线方式构建）

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

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

前言

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

前期准备

centos7 服务器一台

确认是否能安装docker

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

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

更改yum源为阿里云

备份旧源

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

安装docker

官方安装文档

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

启动docker

systemctl start docker

更改docker镜像源

vim /etc/docker/daemon.json

加入阿里云源地址

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

重新读取配置

systemctl daemon-reload

重启docker

systemctl restart docker

安装jenkins

下载jenkins镜像

docker pull jenkins

启动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 docker镜像遇到的volume权限问题

在运行启动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/article/details/73539986

Jenkins初始化

启动成功后输入 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

配置jenkins

全局工具配置

主要配置 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([{
 mathJaxContainer[0]}{
 BRANCH_NAME}"]], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: "{
 mathJaxContainer[1]}{
 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。

钉钉机器人插件使用文档

构建结果

版权声明：本文内容转载自阿里云，遵循CC 4.0 BY-SA版权协议上原链接及本声明。本作品采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行可。原文链接：https://developer.aliyun.com/article/1247431如有涉及到侵权，请联系，将立即予以删除处理。在此特别鸣谢原作者的创作。此篇文章的所有版权归原作者所有，与本公众号无关，商业转载建议请联系原作权，业转载请注明出处。

前言

前期准备

确认是否能安装docker

更改yum源为阿里云

安装docker

启动docker

更改docker镜像源

安装jenkins

启动jenkins

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

Jenkins初始化

处理插件安装失败

自动升级

手动升级

安装必要的插件

配置jenkins

全局工具配置

配置jdk

配置git

配置maven

系统设置

配置服务器

配置钉钉

自由风格的软件项目

新建项目

设置项目简介

源码管理

添加凭证

构建触发器

构建

构建后操作

流水线

项目创建

流水线编写

多分支流水线

创建项目

配置分支源

构建配置

扫描触发器

编写jenkinsfile文件

构建结果

关于CentOS 7/8系列修改服务器IP地址以及查看服务器版本信息【Anolis 8.8测试成功】

Linux下配置安装jdk、maven搭建基础java环境【测试成功】

编写`jenkinsfile`文件