Jenkins详细教程

Jenkins详细教程

大纲

img

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自动化部署实现原理

  img

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.填写初始密码,激活系统

  img

  5.进入插件安装选择

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

  img

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

  img

  6.设置初始用户和密码

  img

  7.进入系统,安装完成

img

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

2.5.Jenkins基本配置

2.5.1.系统初始化配置

  img

  1.Configure System (系统设置)

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

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

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

  img

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

  a.配置用户相关的权限

  img

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

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

  img

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

  a.配置maven的全局settings路径

  img

  b.配置jdk

  img

  c.配置git

  img

  d.配置maven的安装路径

  img

 4.配置必要插件

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

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

  img

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

3.Jenkins自动化部署(springBoot+maven+gitHub)项目

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

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

  1.创建一个工程

  img

  2.General(基础配置)

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

  img

  3.源码管理

  img

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

  img

  4.构建触发器

  img

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

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

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

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

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

  5.构建环境(无需配置)

  6.构建

  img

  7.构建后操作

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

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

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

  img

  案例中给出的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服务上,上传上文中的两个脚本,用于启动和停止

  img

3.3.GitHub服务器配置

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

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

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

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

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

  img

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

4.测试

 1.测试代码

  img

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

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

  img

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

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

  img

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

  img

  说明已经启动成功

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

  img

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

  img

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

  img

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

  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自动化实战 - 网易云课堂

posted @ 2023-04-26 14:02  Little_Monster-lhq  阅读(169)  评论(0编辑  收藏  举报