使用Jenkins实现自动化部署

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运行。
     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一下，然后再构建当前项目.

 

这样 这个问题就完美解决了。

 

 

 

 

原文来自：https://blog.csdn.net/sinat_30802291/article/details/82697321