Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

时间:2024-09-22 15:06:44

Jenkins是一个可扩展的持续集成引擎,Jenkins非常易于安装和配置,简单易用,下面开始搭建.net持续集成环境

Jenkins和SVN安装这里就不介绍了

一、准备工作

1、Jenkins中系统管理--》管理插件--》可选插件中找到MSBuild Plugin, 安装插件 MSBuild Plugin,用来对.net项目的自动编辑用

说明:配置过程中有些功能需要先安装一些插件,都可以去管理插件中查找并安装

2、配置MSBuild(系统管理--》Global Tool Configuration(全局工具配置)--》MSBuild安装)

 Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器) 

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

参数填写说明:

MSBuild Name 只是一个名称可以随便填,但建议填有点意义的名称,例如:MSBuild_v4.0

Path to MSBuild 这个是安装MSBuild所在的路径,例如:C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exe

这里的配置在后面构建(tab)操作中会用到

3、Jenkins Location 和 系统管理员邮件地址

系统管理--》系统设置 找到Jenkins Location

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器) 

4、邮件通知配置(邮件的发送者信息)

邮件通知需要配置两个地方,一处是在 系统管理 -》系统设置 Extended E-mail Notification,

一处是在每个job项目配置中的 构建后操作Editable Email Notification节点配置:

需要先下载安装 Email Extension Plugin 插件

系统管理--》系统设置 找到 Extended E-mail Notification(此插件需要安装,图中的部分信息需要点击 高级 按钮才能显示)

 Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)
 系统管理--》系统设置 找到邮件通知节点配置(图中的部分信息需要点击 高级 按钮才能显示):
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

上面的配置是邮件的发送者的163邮件信息,说明:

SMTP server(SMTP服务器) :登录163邮箱进行获取( 设置--》POP3/SMTP/IMAP)

User Name(用户名):登录发送者163邮箱的账号名称

Password(密码):登录发送者163邮箱的账号密码

Default Subject:构建通知:$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS

Default Content:这里我使用下面自定义的内容格式

<!DOCTYPE html>

<html>

<head>

<meta charset="UTF-8">

<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>

</head>

<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"

offset="0">

<table width="95%" cellpadding="0" cellspacing="0"

style="font-size: 13pt; font-family: Tahoma, Arial, Helvetica, sans-serif">

<tr>

<td><br />

<b><font color="#0B610B">构建信息</font></b>

<hr size="2" width="100%" align="center" /></td>

</tr>

<tr>

<td>

<ul>

<li>项目名称: ${PROJECT_NAME}</li>

<li>构建编号: 第${BUILD_NUMBER}次构建</li>

<li>SVN版本: ${SVN_REVISION}</li>

<li>构建日志: <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>

<li>构建 Url: <a href="${BUILD_URL}">${BUILD_URL}</a></li>

<li>工作目录: <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>

<li>项目 Url: <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>

<li>构建原因: ${CAUSE}</li>

</ul>

</td>

</tr>

<tr>

<td><b><font color="#0B610B">变更集</font></b>

<hr size="2" width="100%" align="center" /></td>

</tr>

<tr>

<td>${JELLY_SCRIPT,template="html"}</td>

</tr>

</table>

</body>

</html>

登录163邮箱--》设置--》POP3/SMTP/IMAP

开启 服务POP3/SMTP/IMAP    设置客户端授权码

5、每个job项目 构建后操作 里面邮件通知的配置(配置邮件接收者的信息),进入配置:

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)  
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

点击右下角的 Advanced Settings 进入高级设置:

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

注意需要添加Triggers,没有添加Triggers就不会发送通知邮件出来,这是一个触发条件。

主要添加的Triggers有三类:Failure-Any,Success,Unstable (Test Failures),分别对应构建失败,构建成功,构建不稳定时触发发送邮件通知。

send to就是指发送给什么人,默认发送给Developers,也就是对这次构建有过修改动作的人,我一般会选择Recipient List,就是默认列表中添加的成员邮箱都会被发送通知邮件。

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

说明:

Recipient List :接收邮件的邮箱(如果有多个用英文逗号隔开)

Content :发送邮件的模板

二、现在开始进行搭建job

点击 新建

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

点击 OK 按钮后 进入一下页面,

这里我选择 参数化构建过程,添加参数(一个布尔值参数),名称自定义为:isAosDeploy,描述也自定义

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

点击 源代码管理(tab)--》选中Subversion,这里我使用SVN作为版本控制工具

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

添加登录SVN账号和密码

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

构建触发器(tab)此项是设置间隔多长时间去检查一次SVN的代码有没有变化,如果有变化则重新编译

 构建环境(tab) 未研究此项配置有何作用,使用默认的,不做任何修改
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)
构建(tab) 此项设置自动编译方式、并将编译后的站点文件拷贝到服务器IIS的站点目录下,
注意这步很重要,如果不配置这步那么只能完成项目的构建操作,而并没有将构建后的 JenkinsWorkplace 工作空间下的项目进行自动编译并自动部署发布到服务端IIS上
完成此步操作需要先去安装插件 MSBuild Plugin
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器) 

说明:这里演示的例子安装的Jenkins和最终发布的IIS站点的服务器是同一台机器,因此是自动编译后在同机器上拷贝文件操作,相对简单些。如果是不同机器上或者网站是分布式部署到N个服务器上,那么就需要用FTP方式上传拷贝文件,那就需要安装插件 FTP publisher plugin 或者 Publish Over FTP,这两种插件使用方式不同,这种方式后续再介绍

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

说明:

MSBuilder Version 为之前配置的 "MSBuild_V4.0"

MSBuild Build File 是 JenkinsWorkplace 工作空间下的项目文件或者工程文件的名称

/t:Rebuild   表示每次都重建,不使用增量编译

/t:ResolveReferences;Compile /t:_CopyWebApplication

/p:Configuration=Release   表示编译Release版本

/property:TargetFrameworkVersion=v4.0  表示编译的目标是.NET 4.0

/p:WebProjectOutputDir=D:\JenkinsWorkplace\VueDEMO  表示网站发布文件的输出路径(本例没使用

/p:OutputPath=D:\JenkinsWorkplace\VueDEMO\bin  表示网站发布dll的输出路径 (本例没使用

/p:DeployOnBuild=true  表示启用编译并发布

/p:VisualStudioVersion=11.0  表示是VS2012

站点的文件拷贝命令

xcopy D:\JenkinsWorkplace\VueDEMO G:\JenkinsWeb\VueDEMO /s/e/y/exclude:C:\Users\VueDEMO\Desktop\exclude.txt

D:\JenkinsWorkplace\VueDEMO 要拷贝的文件目录

G:\JenkinsWeb\VueDEMO 拷贝文件到此目录下

/s 复制目录和子目录,除了空的。

/e 复制目录和子目录,包括空的。

/y 禁止提示以确认改写一个现存目标文件(如果文件存在则覆盖)。

exclude:C:\Users\VueDEMO\Desktop\exclude.txt

/exclude 指定含有字符串的文件列表。如果有任何字符串与要被复制的文件的绝对路径相符,那个文件将不会得到复制。例如,指定如 \obj\ 或 .obj 的将会排除目录 obj 下面的所有文件或带有.obj 扩展名的文件。

exclude.txt文档是排除文件或者目录,如果有排除多种类型的文件或者目录,则用户换行分割,如本实例中

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器) 

排除 .pdb后缀的文件,和 web.config 文件,obj 文件夹,等等

构建后操作(tab) 此项主要是配置邮件通知 将编译情况发送给开发者,前面已经介绍过
到此已经job配置完成,下面来看看 构建结果
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)
由于构建记录太长了,这里我只截取关键部分展示出来
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

 三、账号权限设置
系统管理--》全局安全配置 
Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

四、手动安装的插件如下

MSBuild Plugin

Build Timeout

Email Extension Plugin

Publish Over FTP

FTP publisher plugin

五、Jenkins FTP 上传文件(自动部署到网站服务器IIS)

下面分两种方式介绍:

第一种:使用 FTP publisher plugin 插件

第一步:系统管理--》系统设置 找到 FTP repository hosts,新增一个,编辑好,保存

Timeout(ms): 超时时间(毫秒)

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)  

第二步:打开Job项目配置

增加构建后操作步骤,选择 Publish artifacts to FTP

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)  

第二种:使用 Publish Over FTP Plugin 插件

第一步:系统管理--》系统设置 找到 Publish over FTP,新增一个,编辑好,保存

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)  

Timeout(ms): 超时时间(毫秒)

Use active data mode: (未选中)默认选项使用PASV(被动模式),选中使用PORT (主动模式)

Don't make nested dirs:不创建下级目录(具体的自己看帮助)

第二步:打开Job项目配置

在项目配置中,可以从下面两个地方找到此插件的配置。

构建步骤:Send Files over FTP

构建后操作:Send build artifacts over FTP

增加构建步骤,选择 Send files over FTP

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)

Exclude files:排除的文件(在你传输目录的时候很有用,使用通配符,例如:**/*.log, **/*.tmp, VueDEMO/obj/**)

Pattern separator:分隔符(配置Exclude files和Source files的分隔符。如果你这儿更改了,上面的内容也需要更改)

No default excludes:禁止默认的排除规则(具体的自己看帮助)

Make empty dirs:此选项会更改插件的默认行为。默认行为是匹配该文件是否存在,如果存在则创建目录存放。选中此选项会直接创建一个目录存放文件,即使是空目录。(个人理解)

Flatten files:只在ftp上建立文件,不创建目录(除了远程目录)

Remote directory is a date format:远程目录建立带日期的文件夹(需要在Remote directory中配置日期格式),具体格式参考下表:

Remote directory

Directories created

'qa-approved/'yyyyMMddHHmmss

qa-approved/20101107154555

'builds/'yyyy/MM/dd/'build-${BUILD_NUMBER}'

builds/2010/11/07/build-456 (if the build was number 456)

yyyy_MM/'build'-EEE-d-HHmmss

2010_11/build-Sun-7-154555

yyyy-MM-dd_HH-mm-ss

2010-11-07_15-45-55

Clean remote:上传前会删除远程目录中的所有的文件(血的教训啊,测试的时候用的是运营小组的ftp,然后一不小心就把他们的数据删除了,害的我去做数据恢复。)

ASCII mode:文件传输的方式,一般默认不选。

增加构建后操作步骤,选择 Send build artifacts over FTP

配置方式同上

Jenkins+MSbuild+SVN实现快速搭建.net持续集成环境(构建、编辑、部署到服务器)