持续集成工具Jenkins结合SVN的安装和使用

╰半夏微凉° 2022-05-23 11:44 191阅读 0赞

## **一、引言** ##

在日常的开发过程中，发布版本的流程一般都是手动部署，具体如下图所示：  
![这里写图片描述][70]

我们需要把代码提交到SVN上，然后再把SVN上每个人提交的最新模块的代码拉下来，然后编译打包，最后手动上传到Tomcat上。这种方式很繁琐，也会浪费时间，如果有测试环境和生产环境，则效率更低。下面介绍一下Jenkins的使用和安装。

## **二、原理** ##

Jenkins的思想就是自动化部署，“自动化”的具体体现在：当我们向版本库（SVN）提交新的代码后，应用服务器（Tomcat）就会自动从我们的SVN上拉去新的war包，然后重新部署，用户或测试人员看到的就是最新的应用程序。  
Jenkins的原理图，如下所示：  
![这里写图片描述][70 1]

搭建上述持续集成环境可以把整个构建、部署过程自动化，很大程度上减轻工作量。对于我们程序员的日常开发来说不会造成任何额外负担，自己把代码提交上去之后，服务器上运行的马上就是最新版本，一切都发生在无形中，是不是很方便。

## **三、安装** ##

**1、在安装使用Jenkins之前，要说一下所需要的所有开发环境**

（1）版本控制子系统（SVN）：SVN服务器、项目对应版本库、版本库中钩子程序（提交代码后，触发Jenkins自动打包并部署到应用服务器）
    （2）持续集成子系统（存在Jenkins的服务器）：JDK、Tomcat、 Maven
    （3）Jenkins：主体程序、SVN 插件、Maven 插件、Deploy to Web Container 插件
    （4）应用发布子系统（项目的运行环境）：JDK、Tomcat

**2、在安装使用Jenkins之前，还有知道环境的配置信息**  
（1）设置并记录一下版本库（SVN）的访问账号密码  
![这里写图片描述][70 2]  
![这里写图片描述][70 3]  
![这里写图片描述][70 4]  
**特别提示：svnserve.conf 文件中anon-access 一定要打开注释并设置为none**  
（2）设置并记录Tomcat 服务器（项目运行环境）的访问账号密码，配置文件位置：tomcat/conf/tomcat-users.xml。

**3、安装步骤**  
**（1）Jenkins主体程序安装配置**

1)、把Jenkins.war放在Tomcat解压目录/webapps目录下,
    2）、打开Tomcat 解压目录/server.xml修改URL地址的编码解码字符集tomcat/conf/server.xml
    	<Connector port="8080" protocol="HTTP/1.1"	connectionTimeout="20000"redirectPort="8443" URIEncoding="UTF-8"/>
    3）、启动Tomcat 并通过浏览器访问：http://192.168.70.131:8080/jenkins

注意：此处的Tomcat是运行Jenkins的Tomcat，不一定是项目所运行的Tomcat，这两个肯能不是放在一个Tomcat里。

**（2）Jenkins安装**  
![这里写图片描述][70 5]  
依照提示，查看/root/.jenkins/secrets/initialAdminPassword 文件内容，填入文本框，这里填入的密文同时也是admin账号的密码。  
![这里写图片描述][70 6]  
选择哪种方式都不会对后续操作有太大影响，因为有需要的插件我们可以在后续有针对性的安装，在这里选择“安装推荐的插件”。  
![这里写图片描述][70 7]  
打×的插件是由于网络传输导致的安装失败，后面再重新安装即可。**注意：这个步骤中如果选择了安装插件则系统必须能够联网。**  
![这里写图片描述][70 8]  
可以选择使用admin账户继续，后面有需要仍然有机会注册新账户。  
![这里写图片描述][70 9]  
开始使用Jenkins，gogogo~  
![这里写图片描述][70 10]  
点击系统管理。  
![这里写图片描述][70 11]  
![这里写图片描述][70 12]  
点保存，继续配置。  
![这里写图片描述][70 13]  
![这里写图片描述][70 14]  
![这里写图片描述][70 15]  
点保存，继续配置。  
![这里写图片描述][70 16]  
![这里写图片描述][70 17]  
![这里写图片描述][70 18]  
安装插件时受到网络状况的影响有可能会失败，不要紧，多试几次，直到成功。  
**（3）Jenkins配置项目**  
![这里写图片描述][70 19]  
![这里写图片描述][70 20]  
![这里写图片描述][70 21]  
![这里写图片描述][70 22]  
![这里写图片描述][70 23]  
**特别注意：这里指定的URL地址必须恰好定位到pom.xml文件的上一级，因为Jenkins就是到项目根目录下查询pom.xml。**  
![这里写图片描述][70 24]  
指定SVN的账户密码，要去前面配置的一致！！！设置完，一定要点add，再选一次。配置好的效果，如下图：  
![这里写图片描述][70 25]  
**注意：此时Jenkins 的工作区中还没有代码，需要执行一次构建操作之后Jenkins 才会下载代码。**  
![这里写图片描述][70 26]  
![这里写图片描述][70 27]  
点击保存，指定构建操作。  
![这里写图片描述][70 28]  
![这里写图片描述][70 29]  
![这里写图片描述][70 30]  
说明：  
1）WAR/EAR files：war包以项目根目录为基准的相对路径；  
2）Context path:浏览器访问项目时使用的项目名；  
3）Containers:选择与服务器想符合的Tomcat；  
![这里写图片描述][70 31]  
![这里写图片描述][70 32]  
这里的Tomcat指项目运行的Tomcat，用户名密码之前配置过！！！  
![这里写图片描述][70 33]

**（4）配置触发钩子程序，自动构建**  
![这里写图片描述][70 34]  
远程触发的基本原理是：SVN服务器给Jenkins项目特定的URL地址发送请求，但必须以请求参数的形式携带一个特定值，这个特定值就是这里的“身份验证令牌”。  
比如我们这个项目的地址触发地址是：[http://192.168.63.178:8080/jenkins/job/apple/build][http_192.168.63.178_8080_jenkins_job_apple_build]  
身份验证令牌是：APPLE\_TOKEN  
那么最终的访问地址就是：[http://192.168.63.178:8080/jenkins/job/apple/build?token=APPLE\_TOKEN][http_192.168.63.178_8080_jenkins_job_apple_build_token_APPLE_TOKEN]  
触发访问地址中Jenkins访问地址是根据实际情况改变的，项目名称根据实际情况改变，其他都不变。  
![这里写图片描述][70 35]  
**（5）Linux的curl命令**  
Linux的curl命令：Linux的curl命令用来发送HTT 请求。  
\-X 参数：指定请求方式  
\-v 参数：显示响应结果  
\-u 参数：携带用户名/密码  
\-H 参数：携带请求消息头信息  
![这里写图片描述][70 36]  
**（6）获取crumb 值**  
**这个crumb值也不是必须的**，设置该值的步骤如下：  
![这里写图片描述][70 37]  
![这里写图片描述][70 38]  
下面是如何生成crumb值  
![这里写图片描述][70 39]  
![这里写图片描述][70 40]

**（7）编辑SVN 版本库中的钩子程序**

1）钩子程序由post-commit.tmpl复制得到，这里注意不要使用任何扩展名。如果按照我们习惯的使用.sh扩展名则钩子程序无法正常工作。
    2）记得使用chmod 命令设置为可执行权限，把原有内容注释，加入curl命令

![这里写图片描述][70 41]

## **四、测试** ##

（1）在Eclipse中修改并提交svn，在页面上查看显示内容变化.

（2）**如果发生Jenkins服务器从SVN服务器下载代码不是最新版的情况，那么就在SVN服务器的URL地址后面加上@HEAD强制要求下载最新版。**  
![这里写图片描述][70 42]

[70]: /images/20220523/3a9ee042564247f5963feb135716fc43.png
[70 1]: /images/20220523/f27f5a1413944bb68ebc74a103442e1c.png
[70 2]: /images/20220523/0172f67bb8f54b6a9027161206bce173.png
[70 3]: /images/20220523/106863dabefa483cb382855c3d5d9922.png
[70 4]: /images/20220523/32eda82730db4b5ab1212c2a2177ab35.png
[70 5]: /images/20220523/d1028058857d4fdabce0d37e28d713e6.png
[70 6]: /images/20220523/75a1cdfb4a2f4b6788c2dd1b7fe0dd38.png
[70 7]: /images/20220523/7198759f867a4b69abed5200c6f2de41.png
[70 8]: /images/20220523/dd65a81dec284be0952cf2f26b9e0154.png
[70 9]: /images/20220523/8894853986974fbb88bcc7117de21dc5.png
[70 10]: /images/20220523/d5afa9ac87a44cdb830d1767531ec0b6.png
[70 11]: /images/20220523/59b4eed51b20455d851df06710cf60e2.png
[70 12]: /images/20220523/0c73f68c62934dae8121b9a0e7deb7ff.png
[70 13]: /images/20220523/d7fb13e30d7c4dad809d4fb259b0fcfc.png
[70 14]: /images/20220523/fbfcf384538342e1916616b1331f8eb4.png
[70 15]: /images/20220523/02adf0127856430b83883c3e84726b4d.png
[70 16]: /images/20220523/67e44e459f1e44348c2ab818f7ddb585.png
[70 17]: /images/20220523/bf5d37b664d04ffcbb2efb3841c2808d.png
[70 18]: /images/20220523/9f8173183f324d1889380c9e5742c143.png
[70 19]: /images/20220523/2ab003cb7fe442e184ad358d43fbddbe.png
[70 20]: /images/20220523/922c60433f594afa8739aa746341b2fc.png
[70 21]: /images/20220523/47ca2271ab0941ed94087a831171f8a8.png
[70 22]: /images/20220523/0ab86b6995b542218c7c320e8986952a.png
[70 23]: /images/20220523/49ca7c393e124edab9922b4ae067c560.png
[70 24]: /images/20220523/f2623fd8f8c64dadbf21ae0806ef40f9.png
[70 25]: /images/20220523/fb476d2c8e1b44e5807e43df5e356be2.png
[70 26]: /images/20220523/ce525f592f3f415e8822f41bc523f748.png
[70 27]: /images/20220523/978163d9958d4122a34cec3702af44c3.png
[70 28]: /images/20220523/54a963c15f744dd594c7fab076f535da.png
[70 29]: /images/20220523/f0882d666c694398ab7f3fbb6bcb43b4.png
[70 30]: /images/20220523/e3a4bfda833f4f85a972b063b5327b12.png
[70 31]: /images/20220523/6fbab80187e74febbb9c69db3234c87e.png
[70 32]: /images/20220523/db7f9da9ceb64e0284768a9ce2397108.png
[70 33]: /images/20220523/b0c0e9cba3e54c27b1376448adb23f64.png
[70 34]: /images/20220523/3930029a80f440f481c42cf5b876a35e.png
[http_192.168.63.178_8080_jenkins_job_apple_build]: http://192.168.63.178:8080/jenkins/job/apple/build
[http_192.168.63.178_8080_jenkins_job_apple_build_token_APPLE_TOKEN]: http://192.168.63.178:8080/jenkins/job/apple/build?token=APPLE_TOKEN
[70 35]: /images/20220523/1f9278d81cd14c15b4e155859ba9abc4.png
[70 36]: /images/20220523/2bb5ec425ca44fef96b8fef01286a652.png
[70 37]: /images/20220523/78c8477f3e6f42c2a11f18a22b8f008f.png
[70 38]: /images/20220523/83481c42b635480fad1c1a1ee829d18d.png
[70 39]: /images/20220523/9139c8b8efdb4fdf8f1f251736f2d659.png
[70 40]: /images/20220523/1807aaae07b64594b7bd5f373da1e727.png
[70 41]: /images/20220523/c1c0571995b94e3e8eb4d66c71345dbd.png
[70 42]: /images/20220523/aa0ca076d1a24f3d96bee322bb121ccf.png