Jenkins持续集成 & .NET

最近受累于测试环境每次发布都很麻烦，而且我们有多个测试环境，因此专门抽时间做了Jenkins的配置和研究。

折腾了两天终于绿灯以后，先来个截图，BlueOcean UI还是很nice的。

环境搭建

找一个干净点的Build服务器，然后开始持续集成之旅吧！

1. 安装JDK

我安装了Oracle的JDK之后貌似发送邮件SSL方式有些问题，然而网上的方案貌似不能修复。stack上人家推荐安装openjdk的，我还没来及折腾，不过全新安装的话，推荐openjdk吧。

1. Jenkins安装

Jenkins官网下载最新的安装包，选择对应的系统。安装都是无脑的包括启动，

1. 安装.NET编译环境

这里有点弯路！刚开始我也是满怀期待的想尽量的让Build服务器干净一些，所以找的是独立的MSBuild方式，然而后续的过程证明依赖VS编译的我们离不开VS环境！

独立的MSBuild安装包:下载

当然我的推荐是直接安装Visual Studio,由于我们全部用.NET 4.6.1 所以直接安装了 Visual Studio 2015社区版，尽量少些东西！

以上就是基础的Build环境了。

配置持续集成Job

Jenkins的强大之处在于，所有的任务可以被拆分成粒度自由的Job。而Job之间可以通过很多方式来组织。例如正常的持续集成流程是：获取代码->Build->单元测试脚本->发布到相应环境->自动化测试脚本->Email报告。这里的所有步骤可以分拆成单独的job然后再串起来执行，不过这样需要很了解Jenkins，这不是今天要记录的。（其实我也没研究会。。。长路漫漫了）

1. 新建Job

Job选择"自由风格的软件项目",OK之后General选项卡中默认即可。唯一需要注意的是如果你的多个工程之间有关联，又或者你有很多工程想放在一起，那么我建议配置上"自定义的工作空间"。

如图，我指定了我的工作控件是yqnwork,我创建的所有job都这样设定，那样源代码都会被获取到这里，之后的工作都在一个根目录下进行，将大大方便处理。不然坑起来都是填不完的（我爬出来的！！）

1. 源码管理

获取代码这里，我选择的是TFS，TFS不是原生支持的。如果选择Git/Subversion应该会更方便一些。

TFS需要插件支持，Team Foundation Server Plug-in，插件安装失败的先看Jenkins插件手动更新章节

安装完插件之后，重新编辑job，配置如下：

CollectionURL是TFS URL + 集合名称!
Project path是相对于集合的项目文件夹路径，必须要$开头，这些配置在VS源码管理中都可以自己看到的。

Credentials也是一个坑！坑了我大半天！务必要新建一个TFS帐号专门用于Jenkins，不然有workspace的冲突风险。我进了一直不能获取到最新版本的坑，google了半天，最后才发现的！
Local workfolder&Woekspace name根据实际填写。

1. 构建 Build

构建触发器和构建环境根据实际需要填写，这里默认即可。

.NET Build需要MSBuild插件的支持，如果根据前面的环境搭建已经安装了VS那么万事大吉！

安装完MSBuild Plugin需要配置下默认的MSBuild路径。在Global Tool Configuration中找到MSBuild节，新增一个配置如下：

注意依然有坑！！！ MSBuild的路径需要根据.NET的版本来决定，.NET 4.5以下的貌似引用的是C:\Windows\Microsoft.NET\Framework64\v4.0.30319中的，4.5以上的才是在图中的路径，具体的自己尝试吧~

回到Job的配置：

选择刚才配置的MSBuild，注意我这里是直接发布Asp.NET MVC项目，所以我Build File的目标是csproj。如果是要编译整个工程，请选择对应的sln。
编译参数根据需要配置。

其中需要说明的是，如果是发布那么就按照我这里来。
publishProfile是发布的配置文件，这个建议在VS中手动创建一个配置针对Jenkins的发布配置，选择发布对象为文件系统，目录是重点！！！目录请选择Build服务器上对应的目录，建议还是发布到workspace中。workspace的目录可以参看我的workspace目录

VisualStudioVersion请选择对应的VS版本！！

这里我遇到一个坑，由于nuget版本太低导致dll获取错误编译失败。手动升级了工程中.nuget目录下的nuget.exe。(打到这里vs code死了。。。没保存。。。)

另外Nuget由于墙的问题很卡啊，我还手动在Build服务器上开启了代理。

1. 附加的任务执行

由于我不想把不同环境的配置文件也在这个时候生成，被push到相应的环境（我们分QA、STA环境），所以这里我直接删掉了生成后的文件。选择添加一个windows command的步骤，执行del指令，这里本来可以用环境变量但是作为del指令的参数出了些问题，所以改用绝对路径！

关于这些配置文件我的想法是根据不同环境从TFS中获取不同的文件，这点在将来再讨论实现。

1. 发布

发布一般都是使用FTP或者SSH，windows的服务器自然选择FTP。由于IIS自带FTP发布功能，因此首先配置IIS FTP发布功能。

先从MS的Microsoft Web Platform Installer中安装 IIS:FTP发布服务&IIS:FTP扩展性。 然后打开IIS之后选择目标网站，右键里会出现添加FTP发布，配置如下:

建议是启用虚拟的主机名，这样便于多个站点的FTP分开维护，当然你可以选择默认的IP，然后修改成指定的website目录的FTP，这样很方便，但是不建议哦！

然后选择"基本"的身份验证，授权给指定的账户，建议单独建立一个Jenkins账户用来发布！这样IIS FTP就配置完成了，测是的话可以用command的ftp命令来测试。

如果使用虚拟主机名配置了FTP，访问时的帐号是 www.demo.com|jenkins！！！ 域名 + "|" + 账户名

然后回到Jenkins，添加FTP配置：首先安装插件Publish over FTP。然后到系统设置中添加FTP帐号。依然提醒注意帐号名称。

接着回到Job配置FTP：

Source files这里最好点击问号，看看详细的正则规则，全部文件夹及文件就配置成**/*。
我这里由于我每个项目都publish到指定文件夹，因为带了前缀。然后发布到服务器的FTP地址是不需要这些前缀文件夹的，因此需要配置Remove prefix来移除。

'Transfer Set'我研究了下还有更复杂的功能可以配置，自行研究吧。

1. 备份发布

由于每次发布都会直接删掉原来的发布文件，因此一般发布完成之后都会备份一份文件，这样做也便于回滚哦~！

备份的话我选择执行一段windows command，直接贴Command：

1. 邮件配置

这个功能不提了，配置很简单，先到系统配置下邮件的发送服务器，然后添加一个步骤Email Notification就可以了。

workspace目录

这里贴一下我的workspace目录：

bak:我用来存放备份文件，一会再说。
CodeV2:是对应的TFS上的代码路径
publish:对应各个项目的发布文件地址。上边提到的publishProfile中的目标路径就是这个。

各个文件夹下，我也是按照项目划分 Demo1/Demo2/Demo3...

Jenkins插件手动更新

Jenkins可能受墙的影响更新起来出错概率非常高，所以建议出错了直接手动下载。

下载地址是：http://updates.jenkins-ci.org/download/plugins/

这个列表里有所有插件的安装包，先找到wiki看下插件的依赖，下载的时候把依赖也都下载一遍。这里有个坑是permalink to the latest这个链接下载来的有时候不是最新的，所以最好是手动点最新的！

下载了文件之后，保存到Jekins目录下的plugins，然后重启Jenkins即可。

重启指令是: http://你的Jekins地址/restart

另外文章开头和结尾的截图都是Jenkins的BlueOcean插件，这是它的新UI，老的真的有点丑啊。
这个插件不成功就直接手动吧，安装了好多回，累！

总结

以上就是整个Jenkins自动化构建的研究,建议每个步骤单独分解成job配置run成功之后再整合，否则每次跑一遍狠费时。这也是反复强调的一个workspace，合理文件夹存放的好处之一，否则都没法单独拆分成job来测试。文章中有任何问题，欢迎探讨指正。

最后来一张success：