Jenkins代码自动部署相关文档

时间:2024-05-01 14:32:03

环境

centos 7.0+

Java JDK 1.8+

jenkins 2.220

maven 3.0+

git 1.8+

注意事项

一. linux 安装 JDK (jdk-8u201-linux-x64.tar.gz)

1.下载jdk
2.在/usr 目录下,新建 /java 目录,
3.在/java 目录下,新建/jdk目录,
4.把jdk-8u201-linux-x64.tar.gz 拷贝到/jdk目录下
5.解压 [root@]# tar -zxvf jdk-8u201-linux-x64.tar.gz -C /usr/java/jdk/
6.vi /etc/profile 配置文件
配置内容如下: export PATH=/usr/java/jdk/jdk1.8.0_201/bin:/usr/java/jdk/jdk1.8.0_201/jre/bin:$PATH
7.[root@]#source /etc/profile 或者 [root@]# . /etc/profile
8.检查是否安装成功 # java -version
特别说明:执行命令 一定要注意空格,否则会提示 “-bash: tar-zxvf: command not found” 二. Linux下Git安装及配置 源码安装
安装依赖的包
yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker 下载git源码并解压
目前最新版本下载地址:https://github.com/git/git/releases/tag/v2.22.0
解压 tar zxvf git-2.11.0.tar.gz
cd git-2.11.0 编译安装
make prefix=/usr/local/git all
make prefix=/usr/local/git install 查看git
whereis git
git –version 配置环境变量
vim /etc/profile
加入export PATH=$PATH:/usr/local/git/bin
生效配置文件 source /etc/profile 配置git
1.设置用户名和email
[root@zhuzhonghua2-fqawb util]# git config –global user.name “hiddenzzh”
[root@zhuzhonghua2-fqawb util]# git config –global user.email “youremail@domain.com”
此时$HOME目录下会新建一个.gitconfig文件 2.为github账号添加SSH keys
ssh-keygen -C “youremail@domain.com”
系统会提示key的保存位置(一般是~/.ssh目录)和指定口令,保持默认,连续三次即可 然后vim打开id_rsa.pub文件,粘贴到github账号管理的添加SSH KEY界面中
vim ~/.ssh/id_rsa.pub
然后将id_rsa.pub文件中的内容粘贴到gitub的“SSH and GPG keys”中。 三. Linux 环境下安装Maven 1、安装wget命令 如果需要通过使用wget命令,直接通过网络下载maven安装包时,需要在linux系统中安装wget命令。 yum -y install wget 2、下载maven安装包 wget http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.6.1/binaries/apache-maven-3.6.1-bin.tar.gz 3、解压缩maven tar -zxvf apache-maven-3.5.2-bin.tar.gz 我这里将maven解压缩之后的路径为:/var/local 4、配置maven环境变量 vi /etc/profile 添加环境变量 export MAVEN_HOME=/var/local/apache-maven-3.5.2
export MAVEN_HOME
export PATH=$PATH:$MAVEN_HOME/bin 编辑之后记得使用source /etc/profile命令是改动生效。 5、验证结果 在任意路径下执行mvn -version验证命令是否有效。 正常结果如下,能够看到当前maven及jdk版本。

Jenkins思维导图

Jenkins代码自动部署相关文档

Jenkins主目录修改

Jenkins主目录修改
Jenkins储存所有的数据文件在这个目录下. 你可以通过以下几种方式更改:
1.使用你Web容器的管理工具设置JENKINS_HOME环境参数
打开tomcat的bin目录,编辑catalina.sh文件。
在# OS specific support. $var must be set to either true or false.上面添加:export JENKINS_HOME=""
在引号中填入你的路径。
1.在启动Web容器之前设置JENKINS_HOME环境变量.
用root用户登录
编辑profile文件:vi /etc/profile
在最后加入:export JENKINS_HOME=xxxx
保存,退出后执行:source /etc/profile
让配置生效
1.(不推荐)更改Jenkins.war(或者在展开的Web容器)内的web.xml配置文件
<env-entry>
<env-entry-name>HUDSON_HOME</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value></env-entry-value>
</env-entry>
<!-- 在<env-entry-value>节点中填入路径,windows系统建议使用/分隔路径 -->

Jenkins版本回滚

Jenkins版本回滚

一、新建一个*风格项目

二、配置参数化构建过程
1.
添加选项参数
2. 3.
填入以下内容
4. 5. 6.
7.添加字符参数
三、配置SVN 四、配置构建步骤
1. maven打包配置

选择调用顶层Maven目标,Maven版本之前已经在全局工具配置中设置过,目标中填入打包命令
 
2. 执行shell配置

此脚本为打包备份,回滚脚本
 
填入以下脚本
 
case $Status in
Deploy)
echo "Status:$Status"
path="${WORKSPACE}/bak/${BUILD_NUMBER}" #创建每次要备份的目录
if [ -d $path ];
then
echo "The files is already exists "
else
mkdir -p $path
fi
\cp -f ${WORKSPACE}/target/*.war $path #将打包好的war包备份到相应目录,覆盖已存在的目标
echo "Completing!"
;;
Rollback)
echo "Status:$Status"
echo "Version:$Version"
cd ${WORKSPACE}/bak/$Version #进入备份目录
\cp -f *.war ${WORKSPACE}/target/ #将备份拷贝到程序打包目录中,并覆盖之前的war包
;;
*)
exit
;;
esac

这样发布后以后,就会备份如下
    
3. 定期删除脚本
项目备份不可能无限制备份,这样很快就会占满磁盘,所以我们必须有清除老旧备份的机制。此处配置一个脚本,每次发布都执行一次,判断备份数是否超过5个,如果超过,则删除老旧备份,只保留最新的5个。

再添加一个执行shell步骤,填入以下脚本,其中备份数量可以自行修改减小或加大
  
ReservedNum=5 #保留文件数
FileDir=${WORKSPACE}/bak/
date=$(date "+%Y%m%d-%H%M%S") cd $FileDir #进入备份目录
FileNum=$(ls -l | grep '^d' | wc -l) #当前有几个文件夹,即几个备份 while(( $FileNum > $ReservedNum))
do
OldFile=$(ls -rt | head -1) #获取最旧的那个备份文件夹
echo $date "Delete File:"$OldFile
rm -rf $FileDir/$OldFile
let "FileNum--"
done
五、配置发送到远程tomcat目录 其中Source files要注意配置正确,否则发送不了war包,我的jenkins该项目的workspace如下: 六、发布
回到项目主界面,点击Build with Parameters 
发布选择Deploy--->开始构建,即可开始发布。
 

回滚选择Rollback--->输入回滚版本---->开始构建,版本号从构建历史中选择一个输入
  

使用Jenkins实现Spring Cloud自动化部署

使用Jenkins实现Spring Cloud自动化部署

Jenkins简介
       Jenkins是基于Java开发的一种持续集成工具,用于监控持续重复的工作。简单点来讲就是配置好Jenkins以后可以一键发布项目,包括从git master分支拉取最新的代码,然后打包,然后上传到远程Linux服务器发布等一系列步骤它都可以帮你一键完成。这无疑可以省去很多程序员重复性繁琐的操作。特别是对于现在的spring cloud微服务来说,一个项目由多个小项目组成,每个小项目都独立部署,使用jenkins是最好的部署和管理工具了。 安装Jenkins
安装JDK
安装Git (公钥要配置好,保证本地和远程库可以正常push代码)
安装Maven  安装完maven在/etc/profile中配置环境变量。
安装Jenkins  https://jenkins.io/ 官网下载war包,使用命令java -jar jenkins.war运行。
指定端口 java -jar jenkins.war --ajp13Port=-1 --httpPort=8081      Jenkins默认访问8080端口(注意本地机器防火墙配置)      如果端口8080已经被占用,要修改配置文件来改变端口。      sudo vi /etc/default/jenkins      找到HTTP_PORT=8080,把8080改为8000,然后       sudo service jenkins restart 初始化配置Jenkins
    1. 在Jenkins启动后访问http://localhost:8080进入Jenkins主页。登录。           2. 在以上第二步使用java –jar jenkins.war运行后,console会输出一段密钥将它粘贴到主页输入框,或者去它指定的地址去复制。     3. 进入选择插件安装界面,选择第一个(Install suggested plugins)          4. 插件安装完成之后,需要创建第一个用户          5. 创建用户之后,就可以使用jenkins了        使用Jenkins
    1. 将你的maven工程使用git上传到你的Git(Git Lab或者GitHub)     2. 进入Jenkins主页          3. 安装Maven插件           4. 以同样的方式安装git plugin插件(用于从git拉取最新的代码)和publish over ssh插件(用于上传打包好的项目到远程Linux)。进入系统管理--管理插件--可选插件,在搜索框里面输入git plugin 和publish over ssh,然后点击安装即可。安装好以后可以在“已安装”选项里面看看是否安装成功。       5. 配置Maven 和 JDK 和Git     6. 选择你本地安装好的maven jdk 路径(git 直接 yum install git)         安装后whereis git查看git可执行文件路径,填入Path to Git executable     7. 安装完成后返回主页,创建一个新的jenkins任务      8 .如果你的maven插件安装没有问题,在新建任务时会有Maven Project选项,起名创建。   9. 开始配置Jenkins任务         ① General基本设置         General注意到丢弃旧的构建Disable this project,jenkins默认情况下会保存每次的构建结果,时间久了可想而知硬盘容易塞满,我在实际使用的过程中发现确实很占硬盘,使用这个功能可以删除历史构建保持jenkins工作目录的轻便。         ② Source Code Managerment源码管理工具        使用git,添加地址、用户名密码,设置使用分支,git验证也可以使用ssh key的方式,点击add添加git账号密码。  在Kind下拉菜单可以选择认证方式,一般使用用户名密码或者密钥配置。     ③ Build Triggers 构建触发器      顾名思义就是如何触发构建操作,在这可以设置自动定时执行,还可以远程触发构建,远程机器通过访问url http://jenkins服务器IP:8080/job/项目名称/build?token=TOKEN_NAME来触发构建。丢给小组同事们这一个url后他们就可以潇洒的发测试包啦。   ④Builde Environment构建环境 ⑤Pre Steps        构建环境和preSteps主要是触发构建之前的一些操作,删除workspace,执行远程命令等等。我在构建前做了两件事,清空启动日志,备份原有jar包,install依赖的包     ⑥ Build构建 这块就是打包的配置了,配置构建项目的pom所在路径,在Goals and options上设置了clean package -Dmaven.test.skip=true跳过测试步骤。注意,如果这里写相对路径,应该是相对于JENKINS_HOME/workspace/构建名/   的路径,我的jenkins版本是2.141默认主目录路径是/var/lib/jenkins       ⑦ Post Steps 打包后配置※         1)先保存上述配置,打开jenkins首页,点击“系统管理”-->“系统设置”,下拉找到找到publish over ssh,进行以下设置(请确保)面的步骤中publish over ssh插件已经安装成功,如果没有发现,那就是还没有安装成功,请返回去安装)。         2)这里的ip设置为目标部署服务器的ip.这里Passphrase为jenkins服务器密码,或者导入jenkins私钥到key       以下是我的配置          3)进入上面的已经创建好的jenkinsWeb项目,点击配置,下拉找到Post Steps进行配置。                  这块是重中之重,是紧跟在打包之后的操作,使用linux shell编写操作。Shell脚本请自行编写…. 参数说明: Transfer SetSource files:表示要上传的本地的jar包及路径,可到工作空间去看。 Remove prefix:表示要上传时要去除的文件夹,即只上传jar包。 remote driectory:即表示执行时的路径,相当于把jar包上传到这里了。 exec commad:要执行的命令脚本。 一下是我的启动脚本内容,仅做参考:      ⑧  Build Settings构建设置         可配置被通知邮箱,服务器邮箱需要服务器搭建smtp服务,然后在jenkins首页->“系统管理”-->“系统设置”去配置发件邮箱      ⑨  Post-build Action构建后的设置         这个按需求自行配置     10. 以上配置完成后,可以开始构建你的项目        点击Console output查看日志输出   至此,使用Jenkins完成自动化部署配置完成。   总结部署过程遇到的各种坑:
1、所构建项目的pomx.xml路径问?配置时候提示->没有这个文件.pom.xml      创建一个jenkins构建项目时,会在jenkins主目录下的workspace路径下创建与构建名同名的文件夹,git插件会将项目拉去到该文件夹下,因此pom文件的路径应该是相对于该路径. 2、启动过程中,执行脚本保存,console输出没有文件执行权限      jenkins安装后,会在服务器中新增一个jenkins用户,jenkins的构建操作都是以该用户以及用户组去操作的,因此如果该用户没有操作文件的权限就汇报没有权限错误。修改方法:1,为该用户添加权限。2,将用户修改为root而不是用jenkins用户 这里只针对2方法说明: vim /etc/sysconfig/jenkins 修改$JENKINS_USER="root"           ##Tips:同样,该配置文件可以指定jenkins主目录而不使用默认 修改Jenkins相关文件夹用户权限 chown -R root:root /var/lib/jenkins chown -R root:root /var/cache/jenkins chown -R root:root /var/log/jenkins 重启Jenkins服务并检查运行Jenkins的用户是否已经切换为root service jenkins restart # 查看Jenkins进程所属用户 ps -ef | grep jenkins # 若显示为root用户,则表示修改完成. 3、脚本执行成功,但是远程服务并没有启动,查看服务启动日志显示: nohup: failed to run command `java': No such file or directory 这是因为远程服务执行脚本需要配置jdk环境变量, 脚本中添加环境变量 export JAVA_HOME=/home/sinorail/jdk1.8.0_121 export PATH=$JAVA_HOME/bin:$PATH 4、启动打包报错 Failure to find xxxx.jar http://repo.maven.apache.org/maven2 was cached in the local repository  如果你的项目依赖于其他工程,当然你在mvn package当前工程前,要先install所依赖的工程;然而jenkins默认会有一套自己的本地manve库在其主目录下,而不使用自己所配置的本地库. 解决方法:   先将jenkins用户改为root,然后在构建前的执行脚本中添加mvn clean install 父pom的内容。也就是说,让jinkins使用我们自己的库,并且每次构建都在父pom中install一下,然后再构建当前项目.   这样 这个问题就完美解决了。 1.General
General是构建任务的一些基本配置。名称,描述之类的。 项目名称: 是刚才创建构建任务步骤设置的,当然在这里也可以更改。
描述: 对构建任务的描述。  
丢弃旧的构建: 服务器资源是有限的,有时候保存了太多的历史构建,会导致Jenkins速度变慢,并且服务器硬盘资源也会被占满。当然下方的"保持构建天数" 和 保持构建的最大个数是可以自定义的,需要根据实际情况确定一个合理的值。
其他几个选项在这里不做介绍,有兴趣的可以查看Jenkins"帮助信息", 会有一个大概的介绍。不过这些"帮助信息"都是英文的。 点击右方的这些"问号"查看"帮助信息"
  2.源码管理
源码管理就是配置你代码的存放位置。 源码管理
 Git: 支持主流的github 和gitlab代码仓库。因我们的研发团队使用的是gitlab,所以下面我只会对该项进行介绍。
Repository URL:仓库地址
Credentials:凭证。可以使用HTTP方式的用户名密码,也可以是RSA文件。 但要通过后面的"ADD"按钮添加凭证。
Branches to build:构建的分支。*/master表示master分支,也可以设置为其他分支。
源码浏览器:你所使用的代码仓库管理工具,如github, gitlab.  
URL:填入上方的仓库地址即可。
Version: 8.7   这个是我们gitlab服务器的版本。
Subversion:就是SVN,这里不作介绍。 3.构建触发器
构建触发器,顾名思义,就是构建任务的触发器。 触发远程构建(例如,使用脚本): 该选项会提供一个接口,可以用来在代码层面触发构建。这里不做介绍,后期可能会用到。
Build after other projects are built: 该选项意思是"在其他projects构建后构建"。这里不作介绍,后期可能会用到该选项。
Build periodically: 周期性的构建。很好理解,就是每隔一段时间进行构建。日程表类似        linux crontab书写格式。如下图的设置,表示每隔30分钟进行一次构建。  
Build when a change is pushed to GitLab:当有更改push到gitlab代码仓库,即触发构建。后面会有一个触发构建的地址,一般被称为webhooks。需要将这个地址配置到gitlab中,webhooks如何配置后面介绍。这个是常用的构建触发器。
Poll SCM:该选项是配合上面这个选项使用的。当代码仓库发生改动,jenkins并不知道。需要配置这个选项,周期性的去检查代码仓库是否发生改动。 十分钟检查一次 五、构建结果说明
构建状态
Successful蓝色:构建完成,并且被认为是稳定的。
Unstable黄色:构建完成,但被认为是不稳定的。
Failed红色:构建失败。
Disable灰色:构建已禁用
 
构建稳定性
构建稳定性用天气表示:晴、晴转多云、多云、小雨、雷阵雨。天气越好表示构建越稳定,反之亦然。
 
构建历史界面
 console output: 输出构建的日志信息
六、jenkins权限管理
由于jenkins默认的权限管理体系不支持用户组或角色的配置,因此需要安装第三发插件来支持角色的配置,本文将使用Role Strategy Plugin。基于这个插件的权限管理设置请参考这篇文章:http://blog.****.net/russ44/article/details/52276222,这里不作详细介绍。