Jenkins详细教程

Jenkins详细教程

大纲

1.背景

　　在实际开发中，我们经常要一边开发一边测试，当然这里说的测试并不是程序员对自己代码的单元测试，而是同组程序员将代码提交后，由测试人员测试；

　　或者前后端分离后，经常会修改接口，然后重新部署；

　　这些情况都会涉及到频繁的打包部署；

　　手动打包常规步骤：

　　1.提交代码

　　2.问一下同组小伙伴有没有要提交的代码

　　3.拉取代码并打包（war包，或者jar包）

　　4.上传到Linux服务器

　　5.查看当前程序是否在运行

　　6.关闭当前程序

　　7.启动新的jar包

　　8.观察日志看是否启动成功

　　9.如果有同事说，自己还有代码没有提交......再次重复1到8的步骤！！！！！（一上午没了）

　　那么，有一种工具能够实现，将代码提交到git后就自动打包部署勒，答案是肯定的：Jenkins

　　当然除了Jenkins以外，也还有其他的工具可以实现自动化部署，如Hudson等

　　只是Jenkins相对来说，使用得更广泛。

2.Jenkins服务器搭建及基本配置

2.1.简介

　　Jenkins是一个开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。

2.2.Jenkins自动化部署实现原理

　　

2.3.Jenkins部署环境

　　基本环境：

　　1.jdk环境，Jenkins是java语言开发的，因需要jdk环境。

　　2.git/svn客户端，因一般代码是放在git/svn服务器上的，我们需要拉取代码。

　　3.maven客户端，因一般java程序是由maven工程，需要maven打包，当然也有其他打包方式，如：gradle

　　以上是自动化部署java程序jenkins需要的基本环境，请自己提前安装好，下面着重讲解Jenkins的安装部署配置。

2.4.Jenkins安装

　　1.下载安装包jenkins.war；

　　2.在安装包根路径下，运行命令 java -jar jenkins.war --httpPort=8080，（linux环境、Windows环境都一样）；

　　补充:一个童鞋遇到的问题,反馈说,git自动触发时报错403,启动加如下参数可以解决问题

　　nohup java -jar -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true /usr/local/jenkins/jenkins.war --httpPort=8080 &

　　3.打开浏览器进入链接 http://localhost:8080.

　　4.填写初始密码，激活系统

　　

　　5.进入插件安装选择

　　这里建议选择，推荐安装的插件，保证基本常用的功能可以使用。

　　

　　选择后，进入插件安装页面

　　

　　6.设置初始用户和密码

　　

　　7.进入系统，安装完成

　　注意，如果还是进入不了系统，需要稍等一下，或者刷新页面，如果还是进入不了，需要重新启动jenkinds服务器。

2.5.Jenkins基本配置

2.5.1.系统初始化配置

　　

　　1.Configure System (系统设置)

　　在系统设置这里，我们只需要设置最后面的一项，配置远程服务器地址，

　　即我们代码最终运行的服务器地址信息，就像我们之前手动部署时使用xshell登录Linux服务器一样，

　　当然这里是可以配置多台远程Linux服务器的，配置完成后点击保存即可，为后面我们配置自动化部署做准备，配置如下图

　　

　　2.Configure Global Security (全局安全配置)

　　a.配置用户相关的权限

　　

　　b.配置钩子程序（当用代码更新时通知）访问权限，避免报403错误

　　默认是勾选上了的，这里去掉勾选

　　

　　3.Global Tool Configuration (全局工具配置 )

　　a.配置maven的全局settings路径

　　

　　b.配置jdk

　　

　　c.配置git

　　

　　d.配置maven的安装路径

　　

　4.配置必要插件

　　 主要是检查如下这两个插件是否已安装

　　插件1：Publish over SSH
　　插件2：Deploy to container Plugin

　　

　　到这里，我们配置一个自动化部署的的java程序（springBoot+maven+gitHub），基本必要配置就差不多了，后面配置过程中如果需要在配置。

3.Jenkins自动化部署（springBoot+maven+gitHub）项目

3.1.Jenkins服务器上创建项目和配置

　　大体步骤：General(基础配置)--》源码管理--》构建触发器--》构建环境--》构建--》构建后操作

　　1.创建一个工程

　　

　　2.General(基础配置)

　　仅需填写标准部分，其他可不填写

　　

　　3.源码管理

　　

　　上图中点击“添加”按钮添加一组账号和密码

　　

　　4.构建触发器

　　

　　如上图：当前项目的回调地址为：

　　http://localhost:8080/job/jenkinsSpringBootDemo/build?token=token_demo2

　　只要执行这个地址（在浏览器上访问改地址），该项目就会发起一次构建项目，即拉取代码打包部署操作，

　　在实际中，是由git服务器回调改地址，在后面讲git服务器配置时详细讲解 ，

　　值得注意的是，如果你是学习测试，使用的是GitHub服务，要确保你的回调地址已经试外网映射过的，即往外网可以访问

　　5.构建环境（无需配置）

　　6.构建

　　

　　7.构建后操作

　　构建后操作的意思是，jar打包好后，要将jar发送到哪里去，发送后去和启动等

　　这里需要提前在需要部署的服务器上配置好路径，写好启动和停止项目的脚本，并设置为可以执行的脚本，

　　其实就是我们平时在Linux上手动部署项目操作的脚本

　　

　　案例中给出的stop.sh脚本如下：

1 #!/bin/bash
2 echo "Stop Procedure : demo2-0.0.1-SNAPSHOT.jar"
3 pid=`ps -ef |grep java|grep demo2-0.0.1-SNAPSHOT.jar|awk '{print $2}'`
4 echo 'old Procedure pid:'$pid
5 if [ -n "$pid" ]
6 then
7 kill -9 $pid
8 fi

　　案例中给出的start.sh脚本如下：

1 #!/bin/bash
 
 
 
2 export JAVA_HOME=/usr/java/jdk1.8.0_131
 
 
 
3 echo ${JAVA_HOME}
 
 
 
4 echo 'Start the program : demo2-0.0.1-SNAPSHOT.jar' 
 
 
 
5 chmod 777 /home/ldp/app/demo2-0.0.1-SNAPSHOT.jar
 
 
 
6 echo '-------Starting-------' 
 
 
 
7 cd /home/ldp/app/
 
 
 
8 nohup ${JAVA_HOME}/bin/java -jar demo2-0.0.1-SNAPSHOT.jar &
 
 
 
9 echo 'start success'

　到此，Jenkinds服务器配置完成，接下来我还有要配置Linux服务器和Git服务器。

3.2.Linux服务器配置

　　在Liux服务上，上传上文中的两个脚本，用于启动和停止

　　

3.3.GitHub服务器配置

　　在GitHub服务器上的指定项目里面配置上文中提到的回调地址

　　特别注意：为了保证回调地址网可以使用，

　　我已经将地址：http://localhost:8080/job/jenkinsSpringBootDemo/build?token=token_demo2，

　　通过花生壳进行外网映射为：http://zhishidi.imwork.net/job/jenkinsSpringBootDemo/build?token=token_demo2

　　所以，下面配置的是外网映射地址。

　　

　　到这里所有配置搞定，只需修改代码，提交到git,然后访问程序看是否生效。

4.测试

　1.测试代码

　　

　　2.提交代码到git,触发构建

　　3.在GitHub服务器上去看，是否已经触发

　　

　　4.在Jenkins的控制台查看是否，正在构建

　　从下图中可以看出，正在构建

　　

　　5.查看当次构建的控制台日志

　　

　　说明已经启动成功

　　6.查看Linux服务器，是否上传代码

　　

　　7.在Linux上使用命令jps，查看是否启动

　　

　　8.浏览器上访问，看是否能用

　　

　　说明，已经正常启动可以使用。

　　9.再次确认是否能自动化部署

　　修改代码，重新提交代码，循环1到8步查看。

　　如果测试结果是你预期的，那么自动化部署成功。

5.总结&资料下载

5.1.总结

　　自动化部署Jenkins，作为一款工具，有着非常强大的功能，

　　上面我们只是讲了生产上做Java自动化部署的一个主要流程，

　　其他的功能，大家可以参看官方文档：Jenkins 用户手册

　　但是，本着学习是为了解决生产的原则，

　　个人建议，用到Jenkins的什么功能就学什么就可以了，

　　没必要把Jenkins的所有功能都学完在使用，

　　就如同我们使用word文档一样，并没有系统的他word文档学完后，在开始使用，而是用到什么功能就学习什么功能！

5.2.相关资料

　　1.案例中的源码地址：https://github.com/bangbangw/demo01.git

　　2.官方文档：Jenkins 用户手册

​ 3.博客配套视频教程:Jenkins自动化实战 - 网易云课堂