南山草舍

0%

jenkins 持续集成环境搭建

发表于 更新于 分类于

持续集成

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

依赖以下原则达到目标

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

产生的效益

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

Jenkins安装

安装jdk

jdk下载地址： http://www.oracle.com/technetwork/java/archive-139210.html

1
tar xf jdk-8u112-linux-x64.tar.gz -C /usr/local/

配置jdk环境变量
vim /etc/profile

1
2
3
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

1
2
3
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

1
/usr/local/jdk1.8.0_112/bin/java

jenkins
修改jenkins默认时区

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

启动jenkins

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

访问路径 http://192.168.6.102:8080
默认密码存在这个文件中 /var/lib/jenkins/secrets/initialAdminPassword
jenkins
创建一个管理用户
jenkins
jenkins

Jenkins 配置

安装maven

jdk下载地址：https://dlcdn.apache.org/maven/

1
tar xf apache-maven-3.3.9-bin.tar.gz -C /usr/local/

配置maven环境变量
vim /etc/profile

1
2
3
4
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
jenkins
针对项目中使用的jdk和maven情况添加对应的版本
jenkins

插件安装配置

点击系统配置-插件管理
jenkins

  • 可选插件直接安装
    右上角的过滤功能很好用，可以直接搜索安装
    安装以下插件
    Hudson SCP publisher plugin
    Deploy to container Plugin
    Maven Integration plugin
    Publish Over SSH
    Publish Over CIFS
    Backup plugin / ThinBackup
    Email Ext Recipients Column Plugin
    Localization: Chinese (Simplified)
  • 高级选项中上传插件安装
    http://mirrors.jenkins-ci.org/plugins/
    安装完插件之后，建议重启一下jenkins，防止插件未加载上，不生效；

发布一个静态网站

配置Hudson SCP publisher plugin插件

此插件用于发布静态网站，拷贝文件很方便
jenkins
配置需要发布的服务器hostname，端口，路径，用户名，密码（如果是正式环境，不建议使用root用户）

ps:这里有个小技巧，如果这台机器上有多个静态网站目录的话，可以在服务器设置多个hosts记录，这里使用主机名来分区不同的路径

新建一个软件项目test

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

发布一个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

1
2
3
4
5
6
<role rolename="tomcat"/>
<role rolename="role1"/>
<role rolename="manager-gui"/>
<role rolename="manager-gui,manager-script,manager-jmx,manager-status"/>
<user username="tomcat" password="tomcat" roles="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui,manager-script,manager-jmx,manager-status"/>

由于jenkins把8080端口占用，我这里修改tomcat端口为8081
vim /usr/local/apache-tomcat-7.0.77/conf/server.xml

1
<Connector port="8081" protocol="HTTP/1.1"

tomcat8之后的版本，为了安全，默认只有本机可以访问管理控制台，因此需要修改$TOMCAT/webapp/manager/META-INF和$TOMCAT/webapp/host-manager/META-INF目录下的content.xml
修改

1
2
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

为

1
2
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="\d+\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

一个简单的maven工程代码

https://github.com/nsxq/hello-world-war

maven 的简单使用

查看版本

1
mvn -version

查看详细信息

1
mvn X

测试

1
mvn test

清理（target目录下的编译内容）

1
mvn clean

编译项目

1
mvn compile

打包发布

1
mvn package

生成eclipse项目文件

1
mvn eclipse:eclipse

产生site

1
mvn site

安装当前工程的jar安装到本地仓库

1
mvn install

安装jar包到本地仓库

1
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

分析项目的依赖信息

1
mvn dependency:analyze / mvn dependency:tree

新建一个maven工程

获取代码
jenkins
编译参数
jenkins
构建后发布
jenkins
点击立即构建
查看日志，已经发布完成了
jenkins
访问项目
http://192.168.6.102:8081/hello
jenkins
至此，一个maven工程已经实现自动化编译、打包、发布！

版本回退

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

对文件进行存档

为了能够进行版本回退，构建完成的需要对文件进行存档
jenkins

使用参数化构建过程

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

构建选择“Execute Shell”的方式

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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

执行回退操作

点击构建，根据不同的参数选择发布还是版本回退，回退的时候填写要回退到的历史版本号
jenkins
jenkins

PS: Tomcat8配置web管理后，Tomcat访问 manager页面 报403的解决办法：https://blog.52itstyle.com/archives/274/