Linux安装Jenkins并构建SpringBoot工程

深碍√TFBOYSˉ_ 2023-10-09 22:29 36阅读 0赞

## Linux安装Jenkins并构建SpringBoot工程 ##

转自：[https://www.cnblogs.com/cao-lei/p/14768858.html][https_www.cnblogs.com_cao-lei_p_14768858.html]

##### 1. 简介 #####

Jenkins是一个独立的开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。前身是Hudson是一个可扩展的持续集成引擎。可用于自动化各种任务，如构建，测试和部署软件。  
官网：[https://www.jenkins.io/zh/][https_www.jenkins.io_zh]

*  主要用于：
    
     *  持续、自动地构建/测试软件项目，如CruiseControl与DamageControl；
     *  监控一些定时执行的任务。
 *  特点：
    
     *  开源免费;
     *  跨平台，支持所有的平台;
     *  master/slave支持分布式的build;
     *  web形式的可视化的管理页面;
     *  安装配置超级简单;
     *  tips及时快速的帮助;
     *  已有的200多个插件。

##### 2. 安装前需要准备 #####

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>名称</th> 
   <th>参考博客</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>Jdk1.8</td> 
   <td><a href="https://www.cnblogs.com/cao-lei/p/14768643.html" rel="nofollow">Linux安装Jdk1.8并配置环境变量</a></td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>Maven</td> 
   <td><a href="https://www.cnblogs.com/cao-lei/p/14768835.html" rel="nofollow">Linux安装Maven并配置环境变量</a></td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>Git</td> 
   <td><a href="https://www.cnblogs.com/cao-lei/p/14769257.html" rel="nofollow">Linux安装git</a></td> 
  </tr> 
 </tbody> 
</table>

##### 3. 安装Jenkins #####

*  添加Jenkins源

Copywget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
    
    # 如果之前导入过Jenkins密钥，则此步骤报错，请忽略
    rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

*  yum源安装Jenkins

Copyyum -y install jenkins

*  安装完成后重点目录说明

<table> 
 <thead> 
  <tr> 
   <th>路径</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>/usr/lib/jenkins/jenkins.war</td> 
   <td>War包位置</td> 
  </tr> 
  <tr> 
   <td>/etc/sysconfig/jenkins</td> 
   <td>Jenkins配置文件</td> 
  </tr> 
  <tr> 
   <td>/var/lib/jenkins/</td> 
   <td>默认的Jenkins Home目录</td> 
  </tr> 
  <tr> 
   <td>/var/log/jenkins/jenkins.log</td> 
   <td>Jenkins日志文件</td> 
  </tr> 
 </tbody> 
</table>

*  修改端口（可选）

Copy# 因为Jenkins默认端口为8080，容易和Tomcat冲突，因此需要修改为：8010
    vim /etc/sysconfig/jenkins
    
    # 修改参数
    JENKINS_PORT="8010"

*  启动Jenkins

Copyservice jenkins start

*  异常处理
    
     *  报错
    
        Copy# 报错信息：
        Starting jenkins (via systemctl): Job for jenkins.service failed because the control process.service" and "journalctl -xe" for details.
    
    因为Jenkins的配置信息中没有Java命令，如果没有安装JDK，则可参考博客：
    
    Linux安装Jdk1.8并配置环境变量
    
    如果通过yum源安装，则Java命令路径为：/usr/bin/java，无需额外配置；如果为介质安装，需要手动添加Java命令路径：/usr/local/java/jdk1.8.0\_291/bin/java。建议通过介质安装JDK1.8。
    
        Copyvim /etc/init.d/jenkins
        
        # 在属性candidates中添加java命令路径
        /usr/local/java/jdk1.8.0_291/bin/java
    
    ![img][]
    
     *  警告
    
        Copy# 警告信息：
        Warning: jenkins.service changed on disk. Run 'systemctl daemon-reload' to reload units.
    
    提示Jenkins服务在磁盘上已经修改，建议执行
    
        systemctl daemon-reload
    
    命令。可以执行，也可忽略。
    
     *  处理后重新启动Jenkins
    
        Copyservice jenkins start

##### 4. 初始化配置 #####

*  浏览器访问：http://\{ip\}:8010  
    ![img][img 1]  
    Jenkins的初始化admin的密码存放在：/var/lib/jenkins/secrets/initialAdminPassword下。

Copycat /var/lib/jenkins/secrets/initialAdminPassword

*  安装推荐插件  
    ![img][img 2]  
    推荐安装Jenkins社区推荐的插件。
 *  创建账号  
    ![img][img 3]  
    可以创建管理员账号，也可以使用admin账号。这里，点击`使用admin账号继续`按钮。
 *  实例配置  
    ![img][img 4]  
    配置Jenkins实例，点击`保存并完成`即可。

##### 5. 开始使用 #####

*  修改admin密码（可选）  
    如果已经创建了管理员账号，可以使用自己创建的账号。如果继续使用admin账号，为了安全考虑，建议修改admin账号的密码。修改后重新登录即可。  
    ![img][img 5]![img][img 6]![img][img 7]![img][img 8]![img][img 9]
 *  如果发现Jenkins的汉化并不是很完整，建议重启

Copyservice jenkins restart

![img][img 10]

*  安装插件  
    因为目前大部分项目都是Maven项目，因此，需要安装Maven插件。安装选项建议勾选“安装完成后重启Jenkins(空闲时)”。  
    ![img][img 11]![img][img 12]![img][img 13]![img][img 14]![img][img 15]因为需要将项目远程部署到另外一台服务器，因此需要SSH插件。安装选项建议勾选“安装完成后重启Jenkins(空闲时)”。  
    ![img][img 16]![img][img 17]
 *  全局工具配置
    
    ![img][img 18]
    
    ![img][img 19]
    
     *  JDK配置  
        ![img][img 20]需要配置名称，和JAVA\_HOME，并取消“自动安装”选项。
    
        Copy# 如果是yum源安装的jdk1.8，则JAVA_HOME路径查询方法为：
        which java
        
        # 返回
        /usr/bin/java
        
        # ls -l命令
        ls -l /usr/bin/java
        
        # 返回
        lrwxrwxrwx 1 root root 22 Nov 13 14:37 /usr/bin/java -> /etc/alternatives/java
        
        # ls -l命令
        ls -l /etc/alternatives/java
        
        # 返回
        lrwxrwxrwx 1 root root 73 Nov 13 14:37 /etc/alternatives/java -> /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.272.b10-1.el7_9.x86_64/jre/bin/java
        
        # 则JAVA_HOME路径为：/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.272.b10-1.el7_9.x86_64
        
        # 如果是介质方式安装，则通过环境变量查询JAVA_HOME
        echo $JAVA_HOME
    
     *  Git配置  
        ![img][img 21]需要配置名称，和git命令的路径，并取消“自动安装”选项。
    
        Copywhich git
    
     *  Maven配置  
        ![img][img 22]需要配置名称，和MAVEN\_HOME路径，并取消“自动安装”选项。
    
        Copy# Maven建议介质方式安装，可以参考博客：https://www.cnblogs.com/cao-lei/p/14768835.html
        # 根据环境变量查询MAVEN_HOME路径
        echo $MAVEN_HOME
 *  系统配置
    
     *  如果需要部署到远程服务器，需要配置SSH相关信息。  
        ![img][img 23]![img][img 24]![img][img 25]![img][img 26]配置服务器密码，新增SSH，配置名称、主机名、用户名称和远程路径（建议设置为“/”），点击高级设置，可以设置连接端口等信息。设置完成后可以点击“Test Configuration”按钮测试连接。

##### 6. 构建任务并发布到远程服务器\# #####

*  新建任务  
    填写任务名称，选择“构建一个maven项目”，点击“确定”按钮。  
    ![img][img 27]![img][img 28]![img][img 29]
 *  配置general（可选）  
    可以填写任务描述。  
    ??根据实际情况，可以配置“丢弃旧的构建”。  
    ![img][img 30]
 *  源码管理  
    选择“Git”，填写仓库URL。第一次构建需要设置git账号和密码，以后可以选择之前设置的用户名和密码或者填写新的账号信息。  
    点击“Credentials”下的添加按钮，在弹出的页面填写用户名和密码，点击“添加”按钮，然后在左侧选择刚刚添加的账号信息即可。  
    默认指定分支为master分支，可以根据需要修改。  
    ![img][img 31]![img][img 32]![img][img 33]
 *  构建触发器（可选）  
    如果项目需要固定的时间构建，则可以配置定时构建。  
    ![img][img 34]定时构建的日程表规则如下：

Copy# 语法
    * * * * *
    
    # 第一个*表示分钟，取值0~59
    # 第二个*表示小时，取值0~23
    # 第三个*表示一个月的第几天，取值1~31
    # 第四个*表示第几月，取值1~12
    # 第五个*表示一周中的第几天，取值0~7，其中0和7代表的都是周日
    
    # 举例
    # 每5分钟构建一次
    H/5 * * * *
    
    # 每两小时构建一次
    H H/2 * * *
    
    # 每天12点构建一次
    H 12 * * *
    
    # 每天18点构建一次
    H 18 * * *
    
    # 在每前半个小时内的每10分钟构建一次
    H(0-29)/10 * * * *
    
    # 每周一到周五的9点至18点之间，每两小时构建一次
    H 9-18/2 * * 1-5

*  构建环境（可选）  
    建议勾选“Add timestamps to the Console Output”，勾选后在构建的日志信息中会有时间戳。  
    ![img][img 35]
 *  Pre Steps（可选）  
    本次示例中不需要配置。
 *  Build  
    配置pom.xml的相对位置，一般pom.xml在项目的根路径，因此不需要改动。  
    配置Maven打包命令：`clean install -Dmaven.test.skip=true`。  
    ![img][img 36]
 *  Post Steps  
    勾选“Run only if build succeeds”仅在构建成功后运行。  
    ![img][img 37]
 *  构建后操作  
    选择“Send build artifacts over SSH”，将构建后的包发送到远程服务器。选择在全局配置中配置的服务器信息，填写迁移包相关信息。  
    ![img][img 38]![img][img 39]

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Source files</td> 
   <td>项目生成包的相对路径</td> 
   <td>target/*.jar</td> 
  </tr> 
  <tr> 
   <td>Remove prefix</td> 
   <td>包路径前缀</td> 
   <td>target</td> 
  </tr> 
  <tr> 
   <td>Remote directory</td> 
   <td>远程服务器的路径，注意此处为全局配置远程路径（“/”）的相对路径</td> 
   <td>/data/app/jar</td> 
  </tr> 
  <tr> 
   <td>Exec command</td> 
   <td>指定命令</td> 
   <td>sh /data/app/startup.sh</td> 
  </tr> 
  <tr> 
   <td>??在/data/app下创建文件startup.sh：</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

Copy# 创建文件
    cd /data/app
    touch startup.sh
    
    # 编辑内容
    DIR=//data/app/jar/
    JARFILE=web-0.0.1-SNAPSHOT.jar
    
    cd $DIR
    ps -ef | grep $JARFILE | grep -v grep | awk '{print $2}' | xargs kill -9
    java -jar $JARFILE > out.log &
    if [ $? = 0 ];then
            sleep 10
            tail -n 100 out.log
    fi
    
    # 退出并保存，如果在全局配置的SSH用户不是root用户，请给该用户授权

*  构建  
    ??如果配置了定时构建，可以等下一次执行时间自动构建。当然，点击左侧“立即构建”或者回到首页，点击后边的“构建”按钮即可。  
    在构建过程中，可以在左侧底部点击进度条查看控制台日志。  
    ![img][img 40]

##### 7. 构建任务并发布到同一服务器 #####

*  新建任务
 *  配置general（可选）
 *  源码管理
 *  构建触发器（可选）
 *  构建环境（可选）
 *  Pre Steps（可选）
 *  Build
 *  Post Steps  
    勾选“Run only if build succeeds”仅在构建成功后运行。  
    点击“Add post-build step”按钮选择“执行shell”，填写下面脚本：

Copysh /data/app/jar2/stop.sh
    sh /data/app/jar2/startup.sh

*  构建后操作（无需配置）
 *  创建脚本

Copycd /data/app
    mkdir jar2
    
    # 创建停止脚本
    touch stop.sh
    
    # 编辑内容
    #!/bin/bash
    echo "start stop SpringBoot Application"
    pid=`ps -ef | grep web-0.0.1-SNAPSHOT.jar | grep -v grep | awk '{print $2}'`
    if [ -n "$pid" ]
    then
    kill -9 $pid
    fi
    rm -rf /data/app/jar2/*.jar
    echo "end stop SpringBoot Application"
    
    # 保存并退出
    
    # 创建启动脚本
    touch startup.sh
    
    # 编辑内容
    # export BUILD_ID=dontKillMe为必须。因为默认Jenkins执行完后会kill自己的进程，因此也会将启动的进程kill。
    #!/bin/bash
    export BUILD_ID=dontKillMe
    echo "start startup SpringBoot Application"
    cp /usr/local/maven/repository/com/c3stones/web/0.0.1-SNAPSHOT/web-0.0.1-SNAPSHOT.jar /data/app/jar2
    cd /data/app/jar2/
    nohup java -jar web-0.0.1-SNAPSHOT.jar &
    echo "end startup SpringBoot Application"
    
    # 保存并退出

![img][img 41]![img][img 42]

*  特别注意  
    因为Jenkins使用的默认用户为jenkins，因此在配置完成后，执行构建操作会提示没有权限。

Copy+ sh /data/app/jar2/stop.sh
    start stop SpringBoot Application
    /data/app/jar2/stop.sh: line 6: kill: (28812) - Operation not permitted
    end stop SpringBoot Application
    + sh /data/app/jar2/startup.sh
    start startup SpringBoot Application
    cp: cannot create regular file ‘/data/app/jar2/web-0.0.1-SNAPSHOT.jar’: Permission denied
    end startup SpringBoot Application
    Error: Unable to access jarfile web-0.0.1-SNAPSHOT.jar

有两种解决方案：  
（1）修改Jenkins默认用户为root，快速但不安全；

Copyvim /etc/sysconfig/jenkins
    
    # 修改JENKINS_USER="jenkins"为root
    JENKINS_USER="root"
    
    # 退出并保存
    
    # 重启Jenkins
    service jenkins restart

（2）给Jenkins用户授权，安全推荐使用；  
此示例使用第一种方案。

*  构建

##### 8. 扩展 #####

可以将上述Post Steps执行两种脚本合并为一个脚本即可：

Copy# 在执行shell只改为
    sh sh /data/app/jar2/restart.sh
    
    # 创建重启脚本
    cd /data/app/jar2
    touch restart.sh
    
    # 编辑内容
    #!/bin/bash
    # stop
    echo "start stop SpringBoot Application"
    pid=`ps -ef | grep web-0.0.1-SNAPSHOT.jar | grep -v grep | awk '{print $2}'`
    if [ -n "$pid" ]
    then
    kill -9 $pid
    fi
    rm -rf /data/app/jar2/*.jar
    echo "end stop SpringBoot Application"
    
    # start
    export BUILD_ID=dontKillMe
    echo "start startup SpringBoot Application"
    cp /usr/local/maven/repository/com/c3stones/web/0.0.1-SNAPSHOT/web-0.0.1-SNAPSHOT.jar /data/app/jar2
    cd /data/app/jar2/
    nohup java -jar web-0.0.1-SNAPSHOT.jar &
    echo "end startup SpringBoot Application"

[https_www.cnblogs.com_cao-lei_p_14768858.html]: https://www.cnblogs.com/cao-lei/p/14768858.html
[https_www.jenkins.io_zh]: https://www.jenkins.io/zh/
[img]: https://img-blog.csdnimg.cn/img_convert/773797f211145c4c14ac9b4578719f4f.png
[img 1]: https://img-blog.csdnimg.cn/img_convert/b3bd8d74f10c1b88ea54c75f86e2a8a0.png
[img 2]: https://img-blog.csdnimg.cn/img_convert/783295a8d74d09ed138af3e7d301ec68.png
[img 3]: https://img-blog.csdnimg.cn/img_convert/7bd2bfbb03bb32cb4b27182d7531cdfa.png
[img 4]: https://img-blog.csdnimg.cn/img_convert/b7b70fa27ae41b57abddd3f806399407.png
[img 5]: https://img-blog.csdnimg.cn/img_convert/41c9ab26110dfbcba04cc42bd91e0c7c.png
[img 6]: https://img-blog.csdnimg.cn/img_convert/e2cbc5dcf6c593f10a87f6503266be8d.png
[img 7]: https://img-blog.csdnimg.cn/img_convert/22e67f56936b83460381b9ae80d84461.png
[img 8]: https://img-blog.csdnimg.cn/img_convert/a9b55ab21c6987fc5bf15757382feeb1.png
[img 9]: https://img-blog.csdnimg.cn/img_convert/65a0dbeee2f5eed8be5880f38d0f00df.png
[img 10]: https://img-blog.csdnimg.cn/img_convert/2939fb6b5bec76ae9ba19403c469010f.png
[img 11]: https://img-blog.csdnimg.cn/img_convert/307e5e142b6c9a7bcc3de6afeffa75c2.png
[img 12]: https://img-blog.csdnimg.cn/img_convert/39458922e2d97d6a07aff2c9cad82da9.png
[img 13]: https://img-blog.csdnimg.cn/img_convert/eca3ff0d45ae1d5f255748a5c8019810.png
[img 14]: https://img-blog.csdnimg.cn/img_convert/a3f816d0482ec89c6997d541102772fc.png
[img 15]: https://img-blog.csdnimg.cn/img_convert/3cf7535c87d7b14b969a824d411fa05f.png
[img 16]: https://img-blog.csdnimg.cn/img_convert/679542b08fdee998433c4dadd11a62a6.png
[img 17]: https://img-blog.csdnimg.cn/img_convert/447be94e6a7fdaac7ee7e71c9d4487d8.png
[img 18]: https://img-blog.csdnimg.cn/img_convert/145cb78ccdb8bb950e8a6ff1612a7d54.png
[img 19]: https://img-blog.csdnimg.cn/img_convert/2fef9119943ba618dbbf22c11d2eb9da.png
[img 20]: https://img-blog.csdnimg.cn/img_convert/bd33dadfe0e4645c66ac9fa73fa305ba.png
[img 21]: https://img-blog.csdnimg.cn/img_convert/5bb4ca69455d291025aa7f62a89993ff.png
[img 22]: https://img-blog.csdnimg.cn/img_convert/c530d207b9f9e9fa8d628abf0c275224.png
[img 23]: https://img-blog.csdnimg.cn/img_convert/a0a449c5fbea05936e429c0eadb768b0.png
[img 24]: https://img-blog.csdnimg.cn/img_convert/5de2ce23f3b0cb82190b58e6a3006f99.png
[img 25]: https://img-blog.csdnimg.cn/img_convert/f6059475df865c470ac97d38580f8f05.png
[img 26]: https://img-blog.csdnimg.cn/img_convert/d279e9dadf5404fa36212f97b78067a0.png
[img 27]: https://img-blog.csdnimg.cn/img_convert/e7fac74caed48c9cb0e5a91358c576d4.png
[img 28]: https://img-blog.csdnimg.cn/img_convert/16329cd0d00ef029c2b208cb1478e3a8.png
[img 29]: https://img-blog.csdnimg.cn/img_convert/d09b2772450dea36f85b34ab29466af7.png
[img 30]: https://img-blog.csdnimg.cn/img_convert/af478d94b9c8759a9a320fede9361dbb.png
[img 31]: https://img-blog.csdnimg.cn/img_convert/3fc5fffe3f7c3f22f2a2bed6c92cc105.png
[img 32]: https://img-blog.csdnimg.cn/img_convert/51ccb5423799746d6a74e19ad0c166c6.png
[img 33]: https://img-blog.csdnimg.cn/img_convert/f3fb6e8c888c13537183bcd3a120ec5d.png
[img 34]: https://img-blog.csdnimg.cn/img_convert/84a10042a1b2656096eb4ea84fdbe9ab.png
[img 35]: https://img-blog.csdnimg.cn/img_convert/514defa5411011d4da19843dc5212c11.png
[img 36]: https://img-blog.csdnimg.cn/img_convert/b2ec6bc7f5d9442a956f9d97aee619c3.png
[img 37]: https://img-blog.csdnimg.cn/img_convert/34cb5d1519ec681e87c8da42d0d4050d.png
[img 38]: https://img-blog.csdnimg.cn/img_convert/c9da2b619bfca7886c1ff1d8ba6d2942.png
[img 39]: https://img-blog.csdnimg.cn/img_convert/288648c8aacbe17c25a15224c3240dd6.png
[img 40]: https://img-blog.csdnimg.cn/img_convert/59f7b0ca0f1178fd1e24f2d07d09a233.png
[img 41]: https://img-blog.csdnimg.cn/img_convert/b85ed9904166b540fc6b505bfde072a2.png
[img 42]: https://img-blog.csdnimg.cn/img_convert/e7d0353be0633568d465b39f59a68223.png