Jenkins安装+Springboot项目完整部署流程（超详细）

淩亂°似流年 2023-10-08 15:37 31阅读 0赞

> Jenkins是一款使用Java开发的、开源的，项目持续集成工具。

## 1.安装前环境 ##

#### 1.1.1 JDK安装 ####

[JDK1.8][]  
提取码：t4c3  
（1）解压

tar -zxvf  jdk-8u231-linux-x64.tar.gz

（2）配置环境变量

# 编辑profile文件
    vim /etc/profile

添加内容如下：

export JAVA_HOME=/java/jdk8
    export CLASSPATH=.:$JAVA_HOME/lib/dt.:jar$JAVA_HOME/lib/tools.jar
    export PATH=$PATH:$JAVA_HOME/bin

`注意：按照自己的实际java解压路径来填写。`

#### 1.1.2 Maven ####

[Maven][]  
提取码：98ut  
（1）解压

tar -zxvf apache-maven-3.8.5-bin.tar.gz

（2）配置settings.xml文件

# 进入 解压后maven的conf文件夹(操作时根据自己实际的加压路径)
    cd /maven/conf
    
    
    # 编辑 settings.xml文件
    vim setttings.xml
    
    
    # 添加镜像 这样下载依赖（jar包）时会很快
    <mirrors>
       <mirror>
        <id>alimaven</id>
        <mirrorOf>central</mirrorOf>
        <name>aliyun maven</name>
        <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
      </mirror>
    </mirrors>

`注意：按照自己的实际maven解压路径来填写。`

#### 1.1.3 git ####

直接使用命令进行安装

yum install git

## 2.Jenkins安装 ##

### 1.1 通过war安装Jenkins ###

[Jenkins.war][]  
提取码：wkjn  
（1）启动Jenkins  
因为我们在`安装前环境`中已经安装了`JDK`，所以直接运行Jenkin的War包即可：

nohup java -jar jenkins.war & #后台运行

（2）访问Jenkins  
默认端口号为8080，在浏览器输入`ip地址`\+`8080`端口即可：

![在这里插入图片描述][39baf38c4ed64186b359a49b7f2153c3.png]  
`根据页面提示去linux系统中对应的文件目录下找管理员密码。`  
（3）安装插件、管理用户、配置实例  
![在这里插入图片描述][515de2e3e8eb4f1faffac86cae251d56.png]  
这里选择`安装推荐的插件`，使用war包运行的情况下，不会出现安装推荐插件失败的情况。  
![在这里插入图片描述][c06723e6f52a4c5589b07d9cc079bbd1.png]  
![在这里插入图片描述][fe3353d2a6d1460ea3e0203a8ddb129b.png]  
到此通过war包的方式安装Jenkins已经完成。  
`需要特别注意：通过war包的方式安装Jenkins，Jenkins的workspace文件夹和其他文件都是在下面的目录下：`

/root/.jenkins/

### 1.2 通过命令进行安装 ###

（1）下载

wget https://repo.huaweicloud.com/jenkins/redhat-stable/jenkins-2.190.3-1.1.noarch.rpm

（2）安装

rpm -ivh jenkins-2.190.3-1.1.noarch.rpm

（3）修改配置  
修改Jenkins的JDK路径为自己安装的JDK路径。命令如下：

cd /etc/init.d/
    vim jenkins

![在这里插入图片描述][fb2c4e4ea613454594fa84ec71f92d73.png]  
（4）运行Jenkins 查看状态

systemctl start jenkins #运行

systemctl status jenkins #查看状态

显示下面的标识正在运行：  
![在这里插入图片描述][3b0e7f0bc0e84114a736cb79d017e974.png]  
后续的步骤和运行war包的一致。  
`需要特别注意：通过命令行安装的Jenkins的配置文件和workspace文件夹都是在下面的目录下：`

cd /var/lib/jenkins/

`Jenkins的配置文件在：`

/etc/sysconfig/jenkins

## 3.Jenkins安装可能遇到的问题 ##

### 3.1 无法安装`安装推荐的插件` ###

#### （1）问题描述 ####

通过wget命令行下载Jenkins并安装，会出现无法安装插件的问题：

Caused by: javax.net.ssl.SSLHandshakeException: PKIX path building failed unable to find valid certification path to requested target

或者是：

There were errors checking the update sites: SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification

#### （2）问题原因 ####

这是因为请求是SSL证书的问题。

#### （3）问题解决 ####

进入Jenkins的JENKINS\_HOME目录：

/var/lib/jenkins/

找到该目录中的hudson.model.UpdateCenter.xml：  
![在这里插入图片描述][3cae77b3fbda4a3cae973642ed1da696.png]  
修改成以下所示：

<sites>
      <site>
        <id>default</id>
        <url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>
      </site>
    </sites>

返回上一级，找到updates文件夹，然后修改default.json文件，将文件中的所有

http://updates.jenkins-ci.org/download

替换成

https://mirrors.tuna.tsinghua.edu.cn/jenkins

将

http://www.google.com

替换成：

http://www.baidu.com

登陆Jenkins在`系统管理` \->`插件管理`\->`高级`，配置下站点：  
![在这里插入图片描述][ca482841a9cf4a1aacac7be11c8ba3a2.png]

https://updates.jenkins.io/update-center.json

然后再去下载插件。  
当然即使配置上面的东西，也会出现下载错误的插件，但是比较少，下面可以把失败的个别插件从[Jenkinsc官网插件页面][Jenkinsc]，下载后放到Jenkins中即可。例如：  
![在这里插入图片描述][80eb4ec904ad43f588c670d79299e111.png_pic_center]  
搜索下载失败的插件：  
![在这里插入图片描述][cb368bd0d77c4a83b1d4ad62baff4be0.png_pic_center]  
选择对应的版本（有的版本可能不兼容Jenkins的版本需要升级Jenkins版本）  
![在这里插入图片描述][e1720f5aa1bf4b6593c833f064d2fa9c.png_pic_center]  
登陆Jenkins在`系统管理` \->`插件管理`\->`高级`中上传插件：  
![在这里插入图片描述][accd87da2dd3407fa4de4f5d382ec12f.png_pic_center]

## 4. 配置一个Maven项目 ##

下面我以放到Gitee上面的代码作为例子：

### 4.1 下载Gitee和Maven插件 ###

登陆Jenkins`系统管理` \->`插件管理`  
这里我已安装过了，如果安装的话需要到 `可选插件`中搜索对应的插件名称进行安装。  
![在这里插入图片描述][42545e63d1b144bd914b5510ea8299a6.png_pic_center]  
![在这里插入图片描述][b93b8e2499b3462f90174e677a257fb8.png_pic_center]

### 4.2 创建Maven项目 ###

新建任务  
![在这里插入图片描述][898f7ef3499049ce8565996202590994.png]

![在这里插入图片描述][73c5650dce9a4b7f84aaef861ba9be1d.png]

### 4.3 配置项目 ###

#### 4.3.1 全局工具配置 ####

![在这里插入图片描述][6c662409273740bf8ad7ab05503cee2b.png]

（1）配置maven、JDK、git  
![在这里插入图片描述][823cf2db9441487e8b3904b8d8e5f5ef.png]  
![在这里插入图片描述][3f4d9c5a98284f56b75d55e48159cbbd.png]

maven、JDK、git路径就是安装的路径。

#### 4.3.2 系统配置 ####

![在这里插入图片描述][6384c047edc641af8e7681aa980795a1.png]  
（1）Gitee配置  
![在这里插入图片描述][6f6427323dc849ebbe3c159ed37d1066.png]  
那么如何获取Gitee的令牌呢？  
`登陆Gitee` \-> `设置` \-> `私人令牌`  
![在这里插入图片描述][0edfe8f3bacb4e2595bd7d8a820e18b1.png]  
![在这里插入图片描述][c3158b032e3148d28cb472263a13b4eb.png]  
![在这里插入图片描述][c5326c2f92654cf88f0b6b29ef9a94e2.png]  
然后提交。  
![在这里插入图片描述][8a8bd609d3824966b96e8aed851b2463.png]  
复制令牌。  
![在这里插入图片描述][fd70d2608f394b348d00b68b72824d06.png]  
![在这里插入图片描述][3740db2627d141b28430c0f51c7ba5cb.png]  
![在这里插入图片描述][e24cfb9fd63945279e5d25a713af505a.png]

### 4.3.3 项目配置 ###

（1）Gitee链接  
此处选择在`系统配置`中配置的Gitee链接。  
![在这里插入图片描述][f4922c662dcf4432b00990462ede5814.png]  
（2）源码管理

*  仓库URL：就是Gitee上面你的仓库地址。
 *  Credentials认证信息：填写的就是 上面配置的GiteeAPI令牌。
 *  分支：你需要Jenkins管理的分支是哪个。根据自己实际情况填写  
    ![在这里插入图片描述][b828d61e113445b0a3f34ee930cfa9f8.png]  
    （3）构建触发器  
    ![在这里插入图片描述][4d5a01a75bc34c41906a87905a974acc.png]  
    （4）构建环境  
    ![在这里插入图片描述][83aa8b720cf74cee81f56a49dcadb527.png]  
    （4）前置步骤（Pre Steps）  
    ![在这里插入图片描述][c7d58a05a0894ef6af7ba7a4037c0dc7.png]  
    （5）Build（重点）  
    使用Maven来构建项目，命令是：

clean install -Dmaven.test.skip=true

![在这里插入图片描述][2731abf610bf4232b970a51ae049a383.png]  
（5）Post Steps（重点）  
添加 `执行shell`  
![在这里插入图片描述][78159aca50ce4db8a3e9745c5eaf2395.png]  
![在这里插入图片描述][7784dbf1fb0b4f10ad8184141fe11141.png]

shell脚本解释：

cd /java/project/ # 进入存放项目的文件夹（自定义的）

sh stop.sh # 停止正在运行的旧版本项目 shell脚本

sh replace.sh # 替换编译后的jar包 shell脚本

#启动新编译打包的项目
    BUILD_ID=dontKillMe nohup java -jar /java/project/编译后包的名称.jar &

stop.sh 和 replace.sh 内容：

#stop.sh
    #找到正在运行旧项目的 编号
    #然后停止
    pid=`ps -ef | grep 编译后的jar包的名称 | grep -v grep | awk '{print $2}'`
    if [ -n "$pid" ]
    then
       kill -9 $pid
    fi

#replate.sh
    #判断指定路径下的jar包是否存在
    #如果存在，更名备份
    #将Jenkins打包编译后的项目移动到指定的项目目录下
    file="/java/project/编译后包的名称.jar"
    if [ -f "$file" ]
    then
       mv /java/project/编译后包的名称.jar /java/project/编译后包的名称.jar.`date +%Y%m%d%H%M%S`
    fi
       mv /root/.jenkins/workspace/项目名称/target/编译后包的名称.jar /java/project/

（6）保存配置。

## 5.构建项目 ##

![在这里插入图片描述][f8db8cf713184f0e9cfb9a10199a659c.png]  
查看构建日志：  
!\[在这里插入图片描述\](https://img-blog.csdnimg.cn/0ecd236d95504488a2ced0238b40a89a.png![在这里插入图片描述][8503df9373f840b1b051e119280089cc.png]

![在这里插入图片描述][e9c62df41a3646a797e4dd6a9dd31f39.png]

## 6. 总结 ##

Jenkins构建项目并运行的流程如下：  
![在这里插入图片描述][dde616d0634b4dc590323438e9d380d2.png_pic_center]

*  通过运行war包安装的Jenkins，编译后的包是在`/root/.jenkins/workspace/`下面。
 *  通过命令安装的Jenkins，编译后的包是在`/var/lib/jenkins/workspace/`下面

[JDK1.8]: https://pan.baidu.com/s/1W9KfxEQONd5790O3D_r4Og
[Maven]: https://pan.baidu.com/s/1bcoQvFr0pAou4x2X_Ui2KA
[Jenkins.war]: https://pan.baidu.com/s/1l0j2EFDzZJ9rhtL2UFzoug
[39baf38c4ed64186b359a49b7f2153c3.png]: https://img-blog.csdnimg.cn/39baf38c4ed64186b359a49b7f2153c3.png
[515de2e3e8eb4f1faffac86cae251d56.png]: https://img-blog.csdnimg.cn/515de2e3e8eb4f1faffac86cae251d56.png
[c06723e6f52a4c5589b07d9cc079bbd1.png]: https://img-blog.csdnimg.cn/c06723e6f52a4c5589b07d9cc079bbd1.png
[fe3353d2a6d1460ea3e0203a8ddb129b.png]: https://img-blog.csdnimg.cn/fe3353d2a6d1460ea3e0203a8ddb129b.png
[fb2c4e4ea613454594fa84ec71f92d73.png]: https://img-blog.csdnimg.cn/fb2c4e4ea613454594fa84ec71f92d73.png
[3b0e7f0bc0e84114a736cb79d017e974.png]: https://img-blog.csdnimg.cn/3b0e7f0bc0e84114a736cb79d017e974.png
[3cae77b3fbda4a3cae973642ed1da696.png]: https://img-blog.csdnimg.cn/3cae77b3fbda4a3cae973642ed1da696.png
[ca482841a9cf4a1aacac7be11c8ba3a2.png]: https://img-blog.csdnimg.cn/ca482841a9cf4a1aacac7be11c8ba3a2.png
[Jenkinsc]: https://plugins.jenkins.io/
[80eb4ec904ad43f588c670d79299e111.png_pic_center]: https://img-blog.csdnimg.cn/80eb4ec904ad43f588c670d79299e111.png#pic_center
[cb368bd0d77c4a83b1d4ad62baff4be0.png_pic_center]: https://img-blog.csdnimg.cn/cb368bd0d77c4a83b1d4ad62baff4be0.png#pic_center
[e1720f5aa1bf4b6593c833f064d2fa9c.png_pic_center]: https://img-blog.csdnimg.cn/e1720f5aa1bf4b6593c833f064d2fa9c.png#pic_center
[accd87da2dd3407fa4de4f5d382ec12f.png_pic_center]: https://img-blog.csdnimg.cn/accd87da2dd3407fa4de4f5d382ec12f.png#pic_center
[42545e63d1b144bd914b5510ea8299a6.png_pic_center]: https://img-blog.csdnimg.cn/42545e63d1b144bd914b5510ea8299a6.png#pic_center
[b93b8e2499b3462f90174e677a257fb8.png_pic_center]: https://img-blog.csdnimg.cn/b93b8e2499b3462f90174e677a257fb8.png#pic_center
[898f7ef3499049ce8565996202590994.png]: https://img-blog.csdnimg.cn/898f7ef3499049ce8565996202590994.png
[73c5650dce9a4b7f84aaef861ba9be1d.png]: https://img-blog.csdnimg.cn/73c5650dce9a4b7f84aaef861ba9be1d.png
[6c662409273740bf8ad7ab05503cee2b.png]: https://img-blog.csdnimg.cn/6c662409273740bf8ad7ab05503cee2b.png
[823cf2db9441487e8b3904b8d8e5f5ef.png]: https://img-blog.csdnimg.cn/823cf2db9441487e8b3904b8d8e5f5ef.png
[3f4d9c5a98284f56b75d55e48159cbbd.png]: https://img-blog.csdnimg.cn/3f4d9c5a98284f56b75d55e48159cbbd.png
[6384c047edc641af8e7681aa980795a1.png]: https://img-blog.csdnimg.cn/6384c047edc641af8e7681aa980795a1.png
[6f6427323dc849ebbe3c159ed37d1066.png]: https://img-blog.csdnimg.cn/6f6427323dc849ebbe3c159ed37d1066.png
[0edfe8f3bacb4e2595bd7d8a820e18b1.png]: https://img-blog.csdnimg.cn/0edfe8f3bacb4e2595bd7d8a820e18b1.png
[c3158b032e3148d28cb472263a13b4eb.png]: https://img-blog.csdnimg.cn/c3158b032e3148d28cb472263a13b4eb.png
[c5326c2f92654cf88f0b6b29ef9a94e2.png]: https://img-blog.csdnimg.cn/c5326c2f92654cf88f0b6b29ef9a94e2.png
[8a8bd609d3824966b96e8aed851b2463.png]: https://img-blog.csdnimg.cn/8a8bd609d3824966b96e8aed851b2463.png
[fd70d2608f394b348d00b68b72824d06.png]: https://img-blog.csdnimg.cn/fd70d2608f394b348d00b68b72824d06.png
[3740db2627d141b28430c0f51c7ba5cb.png]: https://img-blog.csdnimg.cn/3740db2627d141b28430c0f51c7ba5cb.png
[e24cfb9fd63945279e5d25a713af505a.png]: https://img-blog.csdnimg.cn/e24cfb9fd63945279e5d25a713af505a.png
[f4922c662dcf4432b00990462ede5814.png]: https://img-blog.csdnimg.cn/f4922c662dcf4432b00990462ede5814.png
[b828d61e113445b0a3f34ee930cfa9f8.png]: https://img-blog.csdnimg.cn/b828d61e113445b0a3f34ee930cfa9f8.png
[4d5a01a75bc34c41906a87905a974acc.png]: https://img-blog.csdnimg.cn/4d5a01a75bc34c41906a87905a974acc.png
[83aa8b720cf74cee81f56a49dcadb527.png]: https://img-blog.csdnimg.cn/83aa8b720cf74cee81f56a49dcadb527.png
[c7d58a05a0894ef6af7ba7a4037c0dc7.png]: https://img-blog.csdnimg.cn/c7d58a05a0894ef6af7ba7a4037c0dc7.png
[2731abf610bf4232b970a51ae049a383.png]: https://img-blog.csdnimg.cn/2731abf610bf4232b970a51ae049a383.png
[78159aca50ce4db8a3e9745c5eaf2395.png]: https://img-blog.csdnimg.cn/78159aca50ce4db8a3e9745c5eaf2395.png
[7784dbf1fb0b4f10ad8184141fe11141.png]: https://img-blog.csdnimg.cn/7784dbf1fb0b4f10ad8184141fe11141.png
[f8db8cf713184f0e9cfb9a10199a659c.png]: https://img-blog.csdnimg.cn/f8db8cf713184f0e9cfb9a10199a659c.png
[8503df9373f840b1b051e119280089cc.png]: https://img-blog.csdnimg.cn/8503df9373f840b1b051e119280089cc.png
[e9c62df41a3646a797e4dd6a9dd31f39.png]: https://img-blog.csdnimg.cn/e9c62df41a3646a797e4dd6a9dd31f39.png
[dde616d0634b4dc590323438e9d380d2.png_pic_center]: https://img-blog.csdnimg.cn/dde616d0634b4dc590323438e9d380d2.png#pic_center