可持续集成.md · 于世鹏/flyray-base

#可持续集成测试安装使用手册

[TOC]
## 一、前置条件
### 1.1系统要求
		jdk版本：要求java7，建议java8
        内存：最小内存为256M~1G，建议内存在8G以上
        磁盘：200G

## 二、安装步骤
### 2.1安装jenkins-2.40
	    wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
		rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key
        yum install jenkins
### 2.2安装jdk-1.80
		yum install java
        wget -c http://download.oracle.com/otn-pub/java/jdk/8u111-b14/jdk-8u111-linux-x64.tar.gz
        tar -zxvf jdk-8u111-linux-x64.tar.gz
### 2.3安装Tomcat-7.0.73
		wget -c http://apache.fayea.com/tomcat/tomcat-7/v7.0.73/bin/apache-tomcat-7.0.73.tar.gz
        tar -zxvf apache-tomcat-7.0.73.tar.gz
### 2.4安装maven-3.3.9
		wget -c http://apache.fayea.com/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
        tar -zxvf apache-maven-3.3.9
        在/etc/profile中添加以下几行配置信息：
        export MAVEN_HOME=/opt/json/jenkins-maven/apache-maven-3.3.9
		export PATH=${PATH}:${MAVEN_HOME}/bin
        执行source /etc/profile使环境变量生效
        用mvn -v检查maven是否安装成功
### 2.4启动、停止、重启jenkins
		service jenkins start/stop/restart
### 2.5jenkins访问路径
		http://112.74.12.115:8080/
### 2.6设置管理员初始密码
		在/var/lib/jenkins/secrets/initialAdminPassword路径下获取管理员的初始密码
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E8%AE%BE%E7%BD%AE%E5%AF%86%E7%A0%81.png)
### 2.6安装插件
		安装jenkins的默认推荐的插件，例如subversion plug-in、邮件发送插件等
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E5%AE%89%E8%A3%85%E9%BB%98%E8%AE%A4%E7%9A%84%E6%8F%92%E4%BB%B6.png)
### 2.7创建管理员用户
	   如下图创建一个管理员用户
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E7%94%A8%E6%88%B7.png)
### 2.8进入jenkins的首页
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-start%E9%A1%B5%E9%9D%A2.png)
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E9%BB%98%E8%AE%A4%E5%88%9D%E5%A7%8B%E9%A1%B5%E9%9D%A2.png)

## 三、配置步骤
### 3.1系统设置
#### 3.1.1点击系统管理，接着点击系统设置
		主目录：/var/lib/jenkins 这是jenkins的JENKINS_HOME路径
        执行者数量: 代表jenkins 最大支持几个任务同时执行
        生成前等待时间:一个计划中的构建在开始之前需要等待选项中设置的秒数
        SCM签出重试次数:从版本控制管理中签出的重试的次数
 ![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E7%B3%BB%E7%BB%9F%E7%AE%A1%E7%90%86%E9%85%8D%E7%BD%AE1.png)
#### 3.1.2全局属性、时间打印器、管理员监控配置
		全局属性：主要设置使用匿名统计和jenkins崩溃报告
        时间打印器：主要设置时间的格式
        管理员监控配置：主要监控磁盘使用情况、JVM崩溃报告、插件加载失败等
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E5%85%A8%E5%B1%80%E5%B1%9E%E6%80%A7%E8%AE%BE%E7%BD%AE.png)
#### 3.1.3JenkinsLocation配置
		jenkins的方位的URL地址，以及管理员邮件地址，即Jenkins邮件发送地址，必须配置
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E9%82%AE%E4%BB%B6%E9%85%8D%E7%BD%AE.png)
#### 3.1.4扩展邮件插件配置说明
		1. Override Global Settings：如果不选，该插件将使用默认的E-mail Notification通知选项。反之，您可以通过指定不同于( 默认选项)的设置来进行覆盖。
		2. Default Content Type：指定构建后发送邮件内容的类型，有Text和HTML两种.
		3. Use List-ID Email Header：为所有的邮件设置一个List-ID的邮件信头，这样你就可以在邮件客户端使用过滤。它也能阻止邮件发件人大部分的自动回复(诸如离开办公室、休假等等)。你可以使用你习惯的任何名称或者ID号，但是他们必须符合如下其中一种格式(真实的ID必须要包含在<和>标记里)：
		<ci-notifications.company.org>
		Build Notifications <ci-notifications.company.org>
		“Build Notifications” <ci-notifications.company.org>
		4. Add 'Precedence: bulk' Email Header：设置优先级.
		5. Default Recipients：自定义默认电子邮件收件人列表。如果没有被项目配置覆盖,该插件会使用这个列表。您可以在项目配置使用$ DEFAULT_RECIPIENTS参数包括此默认列表，以及添加新的地址在项目级别。添加抄送：cc:电子邮件地址例如,CC:someone@somewhere.com
		6. Reply To List：回复列表, A comma separated list of e-mail addresses to use in the Reply-To header of the email. This value will be available as $DEFAULT_REPLYTO in the project configuration.
		7. Emergency reroute：如果这个字段不为空，所有的电子邮件将被单独发送到该地址（或地址列表）。
		8. Excluded Committers：防止邮件被邮件系统认为是垃圾邮件,邮件列表应该没有扩展的账户名(如:@domain.com),并且使用逗号分隔
		9. Default Subject：自定义邮件通知的默认主题名称。该选项能在邮件的主题字段中替换一些参数，这样你就可以在构建中包含指定的输出信息。
		10. Maximum Attachment Size：邮件最大附件大小。
		11. Default Content：自定义邮件通知的默认内容主体。该选项能在邮件的内容中替换一些参数，这样你就可以在构建中包含指定的输出信息。
		12. Default Pre-send Script：默认发送前执行的脚本（注：grooy脚本，这是我在某篇文章上看到的，不一定准确）。
		13. Enable Debug Mode：启用插件的调试模式。这将增加额外的日志输出，构建日志以及Jenkins的日志。在调试时是有用的，但不能用于生产。
		14. Enable Security：启用时，会禁用发送脚本的能力，直接进入Jenkins实例。如果用户试图访问Jenkins管理对象实例，将抛出一个安全异常。
		15. Content Token Reference：邮件中可以使用的变量，所有的变量都是可选的。
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%89%A9%E5%B1%95%E9%82%AE%E4%BB%B6%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E.png)
#### 3.1.5邮件通知
		需在QQ邮箱设置中开启POP3/SMTP服务，同时获取生成的授权码，该授权码即为邮件通知使用SMTP认证的密码
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-qq%E9%82%AE%E7%AE%B1%E5%BC%80%E5%90%AF.png)
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E9%82%AE%E4%BB%B6%E5%8F%91%E9%80%81%E9%80%9A%E7%9F%A5.png)

### 3.2项目配置
#### 3.2.1创建Item项目
		如下图，创建banking-bp项目
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E5%88%9B%E5%BB%BAItem.png)
#### 3.2.2Gernael配置
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-General%E9%85%8D%E7%BD%AE.png)
#### 3.2.3源码管理
		Repository URL：SVN的地址
        Credentials：认证信息，SVN用户名和密码
        Check-out Strategy：检出策略，检出即开始一个新的构建
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%BA%90%E7%A0%81%E7%AE%A1%E7%90%86.png)
#### 3.2.4构建触发器
		Build periodically：周期进行项目构建（它不care源码是否发生变化）
        Poll SCM：定时检查源码变更（根据SCM软件的版本号），如果有更新就checkout最新code下来，然后执行构建动作
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%9E%84%E5%BB%BA%E8%A7%A6%E5%8F%91%E5%99%A8.png)
#### 3.2.5构建环境
		Add timestamps to the Console Output：将时间戳加到控制台输出
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%9E%84%E5%BB%BA%E7%8E%AF%E5%A2%83.png)
#### 3.2.6 BUild & PostSteps
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-build%E5%92%8CPost-Steps.png)
#### 3.2.7构建设置
		在以下三种情况下，需发邮件给相关人员：
        1.每次不稳定构建
        2.单独发送邮件给引起不稳定构建的人员
        3.模块构建失败
![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%9E%84%E5%BB%BA%E8%AE%BE%E7%BD%AE.png)
#### 3.2.7构建后操作

![](http://ojjwxa0q0.bkt.clouddn.com/jenkins-%E6%9E%84%E5%BB%BA%E5%90%8E%E6%93%8D%E4%BD%9C.png)

## 四、参考资料
	   jenkins官网：ttps://jenkins.io/
       jenkins参数化构建过程： http://www.cnblogs.com/ceshi2016/p/6029286.html
       jenkins技巧及常用插件：https://my.oschina.net/u/575122/blog/383890

于世鹏/flyray-base

About

Releases

Contributors

Activities