jenkins+maven+svn 持续集成环境搭建

说明:部署传统的web应用(.war)

准备工作:

(1) 系统环境:CentOS7

(2) 安装JDK:https://www.cnblogs.com/myitnews/p/11493847.html

(3) 安装Tomcat:https://www.cnblogs.com/myitnews/p/11493980.html

  在tomcat-users.xml中配置访问服务器的用户名和密码

(4) 安装Maven:https://www.cnblogs.com/myitnews/p/11492967.html

(5) 搭建SVN服务器:https://www.cnblogs.com/myitnews/p/11492187.html

  ※ 创建访问版本库的用户名和密码
  ※ svnserve.conf 文件中 anon-access 一定要打开注释并设置为 none

一、Jenkins 主体程序安装配置

下载地址:https://jenkins.io/download/

1. 把 jenkins.war (v2.176.3)放在 Tomcat 解压目录 /webapps 目录下

2. 打开 Tomcat 解压目录/server.xml 修改 URL 地址的编码解码字符集

vi /usr/local/tomcat7/conf/server.xml

 <Connector executor="tomcatThreadPool"
               port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" URIEncoding="UTF-8" />

3.  启动 Tomcat 并通过浏览器访问:http://192.168.178.5:8080/jenkins

4. 解锁 Jenkins
jenkins+maven+svn 持续集成环境搭建
依照提示,查看/root/.jenkins/secrets/initialAdminPassword 文件内容填入文本框 
#密文同时也是 admin 账号的密码
cat /root/.jenkins/secrets/initialAdminPassword

5. 选择插件安装方式

输入密文后,初始化后,选择插件安装方式(选择哪种方式都不会对后续操作有太大影响。因为有需要的插件我们可以在后续有针对性的安装)。在这里选择“安装推荐的插件”。

jenkins+maven+svn 持续集成环境搭建

开始安装插件如下:

打×的插件是由于网络传输导致的安装失败,后面再重新安装即可。
※注意:这个步骤中如果选择了安装插件则 Linux 必须能够联网。

jenkins+maven+svn 持续集成环境搭建

6. 新建账号或以管理员身份继续

可以选择使用 admin 账户继续,后面有需要仍然有机会注册新账户。
 jenkins+maven+svn 持续集成环境搭建
7. 开始使用 Jenkins 
 jenkins+maven+svn 持续集成环境搭建

二、系统初始化配置

1. 系统管理界面
jenkins+maven+svn 持续集成环境搭建
 
注:v2.176.3默认是英文的,若想转为中文版本(但还是不完全中文),可以在
(1) 主界面-->系统管理(Manage Jenkins)-->管理插件(Manage Plugins)-->可选插件(available)中找到Locale plugin插件进行安装
(2) 主界面-->系统管理(Manage Jenkins)-->系统设置(Configure System)界面中找到Locale,输入:zh_CN
jenkins+maven+svn 持续集成环境搭建
(3) 重启Jenkins。
 
2. 全局安全配置(Configure Global Security)
 jenkins+maven+svn 持续集成环境搭建
 
注:生产环境授权策略切记不可这样配置
 
3. 全局工具配置(Global Tool Configuration)
(1) Maven配置
 jenkins+maven+svn 持续集成环境搭建
 
(2) JDK
 jenkins+maven+svn 持续集成环境搭建
 
(3) Maven
jenkins+maven+svn 持续集成环境搭建
 
(4) 不使用 Git,所以删除即可。
 
最后点击 save 保存退出。
 
4. 管理插件(Manage Plugins)
 
Manage Plugins-->可选插件,搜索插件,并勾选:
jenkins+maven+svn 持续集成环境搭建
点击左下方的“直接安装”按钮即可。
jenkins+maven+svn 持续集成环境搭建
 
注:安装插件时受到网络状况的影响有可能会失败,不要紧,多试几次,直到成功。

三、创建工程

1. 准备工作
这里创建工程不是随便创建的。
(1) 在Windows下使用Eclipse工具创建一个项目名为Apple的Maven Project web项目。
package com.linhw.demo;
public class Apple {
    private String apple = "jenkins test......"; 
    public String getApple() {
        return apple;
    }
}
<%@page import="com.linhw.demo.Apple"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<%=new Apple().getApple() %>
</body>
</html>
(2) 在Linux的SVN中创建仓库
# 创建目录
mkdir apple
# 创建apple仓库
svnadmin create apple

(3) 修改SVN仓库相关的配置

authz :设置用户读写权限

passwd:设置用户名和密码

svnserve.conf:设置授权访问

(4) 在Eclipse下创建SVN仓库

仓库地址:svn://192.168.178.5/apple

(5) 在Eclipse下将Apple项目提交到SVN仓库中

不要把项目的.classpath、.project、.settings文件提交到svn仓库中。
 
2. 创建工程
jenkins+maven+svn 持续集成环境搭建
 
3. 指定工程名称和工程类型
jenkins+maven+svn 持续集成环境搭建
 
在主界面就可以看到任务列表:
jenkins+maven+svn 持续集成环境搭建
 
4. 源码管理
在任务列表中点击 “Name” 查看项目信息,如下:
jenkins+maven+svn 持续集成环境搭建
点击“配置”,如果没有Subversion,那是因为插件没有安装
jenkins+maven+svn 持续集成环境搭建
 
选择 Subversion,修改以下两个地方,其余保持默认即可。
jenkins+maven+svn 持续集成环境搭建
 
5. 配置构建命令并手动执行一次构建
进入工作区,提示“没有工作空间”
jenkins+maven+svn 持续集成环境搭建
进入“配置”界面,找到“构建”项,新建构建并配置
jenkins+maven+svn 持续集成环境搭建
 
保存后,然后手动“立即构建”
jenkins+maven+svn 持续集成环境搭建
jenkins+maven+svn 持续集成环境搭建
查看控制台输出:
jenkins+maven+svn 持续集成环境搭建
 
6. 构建完成后部署到Tomcat
进入“配置”界面,找到“构建后操作”项
jenkins+maven+svn 持续集成环境搭建
 
选择“Deploy war/ear to a container”,如果没有,那是因为没有安装插件“Deploy to container”。
 
jenkins+maven+svn 持续集成环境搭建
 
 jenkins+maven+svn 持续集成环境搭建
 
再次点击“立即构建”,查看tomcat的webapps文件夹,可以看到项目已经部署到tomcat上。
jenkins+maven+svn 持续集成环境搭建
 
 
7. 配置远程触发构建的TOKEN值
进入“配置”界面,找到“构建触发器”项
jenkins+maven+svn 持续集成环境搭建
 
JENKINS_URL是Jenkins的访问地址:http://192.168.178.5:8080/jenkins
TOKEN_NAME是我们这里任意输入的:LHW_APPLE
在浏览器*问上面的URL,查看Jenkins的构建历史(Build History),可以发现又进行构建了,这样我们就实现了通知Jenkins构建。
jenkins+maven+svn 持续集成环境搭建
 
8. curl命令触发构建

(1) 获取crubm值

由于2.0以上版本Jenkins增加了防跨站攻击功能,因此在每次访问Jenkins api的时候都需要将crubm参数带上,否则会提示认证不通过。

浏览器访问:http://ip:port/crumbIssuer/api/json

举例:http://192.168.178.5:8080/jenkins/crumbIssuer/api/json

{"_class":"hudson.security.csrf.DefaultCrumbIssuer","crumb":"1fe463da428285deb2a0ee0181c0b44f","crumbRequestField":"Jenkins-Crumb"}

(2) curl命令说明

Linux 的 curl 命令用来发送 HTTP 请求。
-X 参数:指定请求方式
-v 参数:显示响应结果
-u 参数:携带用户名/密码
-H 参数:携带请求消息头信息

格式:curl -X post -v -u [Jenkins 用户名]:[Jenkins 密码] -H "请求消息头信息" http://[服务器 IP 地址]:[服务器端口 号]/jenkins/job/[Jenkins 项目名称]/build?token=[身份验证令牌]

举例:curl -X post -v -u admin:d769b039ccdc4b4dbe5624689aa81ad0 -H "Jenkins-Crumb:1fe463da428285deb2a0ee0181c0b44f" http://192.168.178.5:8080/jenkins/job/Apple/build?token=LHW_APPLE

说明:-H可以不写,如果认证不通过,再加上

在Linux命令行环境中输入上面的curl命令,发现会再次构建。

9. 编辑SVN钩子程序

# 进入svn仓库
cd  /var/svn/svnrepos/apple
# 进入hooks文件夹
cd hooks
# 查看文件
ls -l

jenkins+maven+svn 持续集成环境搭建

#复制,千万不能带后缀名,直接post-commit
cp post-commit.tmpl post-commit

编辑:vi post-commit

可以将内容都注释掉,然后在末尾添加我们上面的curl命令。

保存退出,给post-commit授权执行

chmod 755 post-commit

这样我们在提交代码后,就会触发钩子程序,钩子程序通知Jenkins构建。

10. 测试验证整个自动化持续集成流程

在Eclipse中提交代码,查看JenKins的构建界面,用浏览器访问项目。

测试过程过程中,可能会发现Jenkins构建的总是上一个版本的,并不是最新的(在一些较低版本会出现),怎么解决呢?

在“源码管理”中的Repository URL为:svn://192.168.178.5/apple/[email protected]