jenkins 持续集成环境搭建

末蓝、 2024-02-05 13:55 59阅读 0赞

#### 目录标题 ####

*  持续集成
 *   *  依赖以下原则达到目标
     *  产生的效益
 *  Jenkins安装
 *   *  安装jdk
     *  安装jenkins
     *  启动jenkins
     *  Jenkins 配置
     *  安装maven
     *  全局工具配置
     *  插件安装配置
 *  发布一个静态网站
 *   *  配置Hudson SCP publisher plugin插件
     *  新建一个软件项目test
 *  发布一个java后台工程
 *   *  安装Deploy to container Plugin插件
     *  配置tomcat web管理
     *  一个简单的maven工程代码
     *  maven 的简单使用
     *  新建一个maven工程
 *  版本回退
 *   *  对文件进行存档
     *  使用参数化构建过程
     *  构建选择“Execute Shell”的方式
     *  执行回退操作

## 持续集成 ##

持续集成（CI）是一种软件工程流程，将所有工程师对于软件的工作复本，每天集成数次到共用主线（mainline）上。

### 依赖以下原则达到目标 ###

*  维护一个代码库
 *  自动建置
 *  让建置时会自我测试
 *  所有人每天至少提交一次
 *  应该要建置每一个提交
 *  让建置维持快速
 *  用在线环境的复本测试
 *  让获取最新发布版本更容易
 *  任何人都可以查看最后建置的结果
 *  自动部署

### 产生的效益 ###

*  及早发现集成错误且由于修订的内容较小所以易于追踪，这可以节省项目的时间与成本。
 *  避免发布日期的前一分钟发生混乱，当每个人都会尝试为他们所造成的那一点点不兼容的版本做检查。
 *  当单元测试失败或发生错误，若开发人员需要在不除错的情况下还原代码库到一个没有问题的状态，只需要放弃一小部分的更改 (因为集成的次数频繁)。
 *  让 “最新” 的程序可保持可用的状态供测试、展示或发布用。
 *  频繁的提交代码会促使开发人员创建模块化，低复杂性的代码。 Jenkins是一个用Java编写的开源的持续集成工具，前身是Hudson (软件)项目，有丰富的插件支持；

## Jenkins安装 ##

### 安装jdk ###

jdk下载地址： [http://www.oracle.com/technetwork/java/archive-139210.html][http_www.oracle.com_technetwork_java_archive-139210.html]  
tar xf jdk-8u112-linux-x64.tar.gz -C /usr/local/  
配置jdk环境变量vim /etc/profile

export JAVA_HOME=/usr/local/jdk1.8.0_112
    export CLASSPATH=.:$JAVA_HOME/lib/:$JAVA_HOME/jre/lib/
    export PATH=$JAVA_HOME/bin:$PATH

### 安装jenkins ###

wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
    rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
    yum install jenkins

添加java路径到jenkins启动脚本中vim /etc/init.d/jenkins  
/usr/local/jdk1.8.0\_112/bin/java  
![05cbdb9e625c14f371b3294d0f74aa95.png][]  
修改jenkins默认时区

vim /etc/sysconfig/jenkins
    JENKINS_JAVA_OPTIONS="-Djava.awt.headless=true -Dorg.apache.commons.jelly.tags.fmt.timeZone=Asia/Shanghai"

### 启动jenkins ###

/etc/init.d/jenkins start
    chkconfig --level 35 jenkins on

访问路径 [http://192.168.6.102:8080][http_192.168.6.102_8080]默认密码存在这个文件中 /var/lib/jenkins/secrets/initialAdminPassword  
![e2923d4ffd21ab34878c46466c1ce0c4.png][]  
创建一个管理用户  
![af9ee7e6716a5fbf225fc92d4342ed8a.png][]  
![fb889799d5053bedfb18c627039cbf13.png][]

### Jenkins 配置 ###

### 安装maven ###

jdk下载地址： [http://apache.mirrors.lucidnetworks.net/maven/maven-3/][http_apache.mirrors.lucidnetworks.net_maven_maven-3]  
tar xf apache-maven-3.3.9-bin.tar.gz -C /usr/local/  
配置maven环境变量vim /etc/profile

export JAVA_HOME=/usr/local/jdk1.8.0_112
    export CLASSPATH=.:$JAVA_HOME/lib/:$JAVA_HOME/jre/lib/
    export M3_HOME=/usr/local/apache-maven-3.3.9
    export PATH=$JAVA_HOME/bin:$PATH:$M3_HOME/bin

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

点击系统配置-Global Tool Configuration  
![214ec48e470b4b94e815f24553951431.png][]  
针对项目中使用的jdk和maven情况添加对应的版本![0f54e8a3eebf56583951d310cf3aecae.png][]

### 插件安装配置 ###

点击系统配置-插件管理  
![137ac9ff589e295f11525bfe23954e04.png][]

*  可选插件直接安装右上角的过滤功能很好用，可以直接搜索安装安装以下插件Hudson SCP publisher pluginDeploy to container PluginMaven Integration pluginPublish Over SSHPublish Over CIFSBackup plugin / ThinBackupEmail Ext Recipients Column PluginLocalization: Chinese (Simplified)
 *  高级选项中上传插件安装[http://mirrors.jenkins-ci.org/plugins/][http_mirrors.jenkins-ci.org_plugins]安装完插件之后，建议重启一下jenkins，防止插件未加载上，不生效；

## 发布一个静态网站 ##

### 配置Hudson SCP publisher plugin插件 ###

此插件用于发布静态网站，拷贝文件很方便  
![2a45e6109eb5d08d5425a56949493da9.png][]  
配置需要发布的服务器hostname，端口，路径，用户名，密码（如果是正式环境，不建议使用root用户）  
ps:这里有个小技巧，如果这台机器上有多个静态网站目录的话，可以在服务器设置多个hosts记录，这里使用主机名来分区不同的路径

### 新建一个软件项目test ###

![50753b61f90ef3f1fff4c6949bf4b4bc.png][]  
源码管理：填写svn路径有获取代码权限的用户名密码![f5fc3daa7e701b977186cb174fdf518e.png][]  
构建后操作：选择需要scp的路径Source \*\* 表示所有Keep Hierarchy 保持目录结构（否则不能拷贝文件夹）  
![14b15c55afbf3c4d1f1d042624c3b613.png][]  
点击立即构建  
![a28fb6546b3d800fac95f29e473dc9d0.png][]  
通过 Console Output可以看到详细日志  
![140bb056b8bbb5646bff9b8c642d86a6.png][]  
至此，一个静态网站就发布完成了！

## 发布一个java后台工程 ##

### 安装Deploy to container Plugin插件 ###

此插件可以将war/ear 包发布到tomcat，glassfish，jetty，weblogic等中间件上

### 配置tomcat web管理 ###

vim /usr/local/apache-tomcat-7.0.77/conf/tomcat-users.xml

由于jenkins把8080端口占用，我这里修改tomcat端口为8081vim /usr/local/apache-tomcat-7.0.77/conf/server.xml  
<Connector port=“8081” protocol=“HTTP/1.1”  
tomcat8之后的版本，为了安全，默认只有本机可以访问管理控制台，因此需要修改 T O M C A T / w e b a p p / m a n a g e r / M E T A − I N F 和 TOMCAT/webapp/manager/META-INF和 TOMCAT/webapp/manager/META−INF和TOMCAT/webapp/host-manager/META-INF目录下的content.xml修改

为

### 一个简单的maven工程代码 ###

[https://github.com/nsxq/hello-world-war][https_github.com_nsxq_hello-world-war]

### maven 的简单使用 ###

查看版本  
mvn -version  
查看详细信息  
mvn X  
测试  
mvn test  
清理（target目录下的编译内容）  
mvn clean  
编译项目  
mvn compile  
打包发布  
mvn package  
生成eclipse项目文件  
mvn eclipse:eclipse  
产生site  
mvn site  
安装当前工程的jar安装到本地仓库  
mvn install  
安装jar包到本地仓库  
mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=/usr/local/src/ojdbc14-10.2.0.4.0.jar  
分析项目的依赖信息  
mvn dependency:analyze / mvn dependency:tree

### 新建一个maven工程 ###

获取代码  
![783217b83efcfaa426641d6aedbe1cb7.png][]编译参数  
![2f9d7d7cc82397e93317ee599745123c.png][]  
构建后发布  
![746d0dd1e17f671ba2ffeac270e8194d.png][]  
点击立即构建查看日志，已经发布完成了  
![bcac3b5357a9497049b0ff5aa0fae4f6.png][]  
访问项目[http://192.168.6.102:8081/hello][http_192.168.6.102_8081_hello]  
![67e2ecbe16364f1fe30d483df3b40034.png][]  
至此，一个maven工程已经实现自动化编译、打包、发布！

## 版本回退 ##

有时候发布一个新版本失败或发布有问题，我们需要回滚到指定版本的构建，这样才能更灵活的进行项目的构建部署。我们可以选择“参数化的构建过程”进行传递不同的参数来选择是进行新的构建还是退

### 对文件进行存档 ###

为了能够进行版本回退，构建完成的需要对文件进行存档  
![d5b35667d9b5cce96bc2f466061b319c.png][]

### 使用参数化构建过程 ###

让后面的脚步可以根据不同的变量执行不同的操作。添加“Choice”参数配置不同的选项，让选择发布还是回滚，添加“String Parameter”参数来传递要回退的版本号。  
![0576a23b7a964182efe26a66004dbe56.png][]

### 构建选择“Execute Shell”的方式 ###

自己根据变量，自定义构建的脚本，此时如果是发布安装maven的构建过程进行新的构建，如果是回滚，知道历史构建后的文件，复制到当前构建结果目录。

case $deploy_env in
    	deploy)
        	echo "deploy:$deploy_env"
            mvn clean test compile install package
            ;;
        rollback)
        	echo "rollback:$deploy_env"
            echo "version: $version"
            rm -fr target/hello-1.war
            cp -R ${JENKINS_HOME}/jobs/myapp/builds/${version}/com.efsavage\$hello/archive/com.efsavage/hello/1/hello-1.war .
            pwd && ls
            ;;
    	*)
        exit
        	;;
    esac

### 执行回退操作 ###

点击构建，根据不同的参数选择发布还是版本回退，回退的时候填写要回退到的历史版本号  
![64dcfdd00b50ac4b32fb1533a2b75bdb.png][]  
![c36bc1cc11a5c4435adc2b1308279511.png][]  
PS: Tomcat8配置web管理后，Tomcat访问 manager页面 报403的解决办法：[https://blog.52itstyle.com/archives/274/][https_blog.52itstyle.com_archives_274]

[http_www.oracle.com_technetwork_java_archive-139210.html]: http://www.oracle.com/technetwork/java/archive-139210.html
[05cbdb9e625c14f371b3294d0f74aa95.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/22d573f54c83412fa0eae47626fc8290.png
[http_192.168.6.102_8080]: http://192.168.6.102:8080/
[e2923d4ffd21ab34878c46466c1ce0c4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/c4d45dd56ad048869d91321c072e0a90.png
[af9ee7e6716a5fbf225fc92d4342ed8a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/8222da10b09a40248decab78f8fd3af3.png
[fb889799d5053bedfb18c627039cbf13.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/a18c3c28099e4d09a728be8bc015dc80.png
[http_apache.mirrors.lucidnetworks.net_maven_maven-3]: http://apache.mirrors.lucidnetworks.net/maven/maven-3/
[214ec48e470b4b94e815f24553951431.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/c2da6a207b544517b662473cc5754775.png
[0f54e8a3eebf56583951d310cf3aecae.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/bbbfbc18620d47c8a1dc47e9e4713d16.png
[137ac9ff589e295f11525bfe23954e04.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/0bf54856a73244b3a8d699f66830e9f8.png
[http_mirrors.jenkins-ci.org_plugins]: http://mirrors.jenkins-ci.org/plugins/
[2a45e6109eb5d08d5425a56949493da9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/0648c756603843e7aa66fd384747d46c.png
[50753b61f90ef3f1fff4c6949bf4b4bc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/da0b35f894ad4eebb3b6bcf0ddff1fd2.png
[f5fc3daa7e701b977186cb174fdf518e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/39e9a138c58d437b9749e911c5bab8e3.png
[14b15c55afbf3c4d1f1d042624c3b613.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/e69e8435a9ee4148b53365588e38236e.png
[a28fb6546b3d800fac95f29e473dc9d0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/4ae9c5208b974427a02cffd5357ecb9b.png
[140bb056b8bbb5646bff9b8c642d86a6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/a64c84e66fca40e88344f184da88cc78.png
[https_github.com_nsxq_hello-world-war]: https://github.com/nsxq/hello-world-war
[783217b83efcfaa426641d6aedbe1cb7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/fb2d9f6f3aa34390bb4809d54455ee7d.png
[2f9d7d7cc82397e93317ee599745123c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/368cdaa4968347f4ac5379369f237730.png
[746d0dd1e17f671ba2ffeac270e8194d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/0467eb56e9fb497aaccdef7e786ffe7c.png
[bcac3b5357a9497049b0ff5aa0fae4f6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/da8985aa44c240949f7fc95e892493ab.png
[http_192.168.6.102_8081_hello]: http://192.168.6.102:8081/hello
[67e2ecbe16364f1fe30d483df3b40034.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/d72eec74356841919c583dedff434014.png
[d5b35667d9b5cce96bc2f466061b319c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/3d9884a1c7fd40b08af8a57ae1f92ff8.png
[0576a23b7a964182efe26a66004dbe56.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/fda112f771b44e94a2b1fafd8da71bb9.png
[64dcfdd00b50ac4b32fb1533a2b75bdb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/8f593cff8bd447be80b0e32b0f689b2e.png
[c36bc1cc11a5c4435adc2b1308279511.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/d137e3cf6ba8418a82d272003bf2da5b.png
[https_blog.52itstyle.com_archives_274]: https://blog.52itstyle.com/archives/274/