我们用一个实例CISample来说明如何配置CC.Net、VSS等。
持续集成服务器源代码管理器配置:
从程序里面选择Microsoft Visual SourceSafe Administration运行源代码管理程序:
我们在磁盘上建立一个目录来作为源代码管理器的数据库目录(例:c:\vsswoker),从文件菜单里新建数据库,浏览到新建的目录下,创建一个名叫CISample的目录:
使用默认的CISample作为连接名字:
选择版本控制模型之后,CISample创建就完成了:
完成之后从Users菜单里面选择新建用户,添加参与这个项目的所有用户,用户可以是只读属性的:
最后共享VSSWorker目录:
同时设置相关人员的访问权限。
实例目录结构准备:
我们在开发用的机器上建立一个项目文件夹(例:Projects),用来存放项目,再建立一个库文件夹(例:Libs),用来存放其他需要引用的库文件和工具,比如NUnit等。将这两个目录用Subst命令映射成2个独立的盘符(例:subst p: c:\Projects, subst l: c:\Libs)。
VS2005源代码管理器配置:
从VS2005的工具菜单选择选项,展开源代码管理选择插件选择,VSS可以支持文件共享方式和Internet方式
新建一个项目:
打开VS2005,新建一个类库项目,位置选择映射的项目文件夹盘符,取名为CISample,同时创建解决方案目录,删除自动创建的Class1.cs文件。在解决方案上点击右键从菜单中选择将解决方案添加到源代码管理器:
在添加SourceSafe数据库向导中,选择连接到已存在的数据库:
在位置处输入\\CIServer\VSSWorker\CISample:
后面的连接名字使用默认的就可以了。然后使用前面建立的用户和密码登录:
出现添加到SourceSafe对话框,直接点击OK,随后的确认对话框选择Yes:
开始往源代码管理器添加文件:
添加完成之后,解决方案、项目以及文件前面都加了一把小锁:
在解决方案上点击右键,选择添加新项目,添加一个新的名为CISampleTest的类库项目,这个项目用于单元测试:
为这个项目添加CISample项目引用和NUnit的引用。
我们使用NUnit网站上Quick Start的例子。
在CISample项目上点击右键,添加一个类,命名为Account,然后输入下面的代码:
using System;
using System.Collections.Generic;
using Syste.Text;
namespace CISample
{
public class Account
{
private float balance;
public void Deposit(float amount)
{
balance+=amount;
}
public void Withdraw(float amount)
{
balance-=amount;
}
public void TransferFunds(Account destination, float amount)
{
}
public float Balance
{
get{ return balance;}
}
}
}
在CISampleTest项目上点右键,新建一个类,命名为AccountTest,然后输入下面的代码:
using System;
using System.Collections.Generic;
using Syste.Text;
using NUnit.Framework;
namespace CISampleTest
{
[TestFixture]
public class AccountTest
{
[Test]
public void TransferFunds()
{
Account source = new Account();
source.Deposit(200.00F);
Account destination = new Account();
destination.Deposit(150.00F);
source.TransferFunds(destination, 100.00F);
Assert.AreEqual(250.00F, destination.Balance);
Assert.AreEqual(100.00F, source.Balance);
}
}
}
现在build一次,通过。用Nunit-gui打开CISampleTest.dll,点击Run,看到下面的结果:
出错了,测试没有通过,现在不着急让它通过,先签入到源代码管理器中。
配置CC.Net:
在持续集成服务器上创建一个文件夹CIWorker,用来存放项目文件,再在下面创建一个CISample文件夹。
进入CC.Net的webdashboard目录,用记事本打开web.config文件进行编辑,找到xslReportBuildPlugin,添加msbuild的report插件,因为我们使用msbuild所以就要注释掉NAnt的report插件,Fitness以后再写文章介绍,所以也注释掉:
进入CC.Net的Server目录,创建一个名为MapDriver.bat的批处理文件:
subst p: /d
subst l: /d
subst p: c:\CIWorker
subst l: c:\tools
然后用记事本打开ccnet.config文件进行编辑:
保存之后,用浏览器打开http://localhost/ccnet,应该就可以看到:
点击CISample就可以看到CISample的日志了,不过目前还只能看到从VSS获取代码的日志,还没有build日志,在ccnet.config文件中添加如下红色内容:
点击Dashboard页面上的Force按钮强制build,然后点击CISample查看Build日志,可以看到msbuild的输出日志,继续修改ccnet.config,添加NUnit的配置:
再次点击Force按钮,查看日志,可以看到这次build失败了,是单元测试没有通过。
CISample项目,打开CISample项目的Account.cs文件,完成TransferFunds方法:
public void TransferFunds(Account destination, float amount)
{
destination.Deposit(amount);
Withdraw(amount);
}
重新生成解决方案,然后运行NUnit,可以看到测试通过了,将修改的代码签入到源代码管理器中,等一会打开dashboard页面,点击CISample查看日志,可以看到已经自动Build了一次:
下面介绍如何配置FxCop、NCover、Simian。因为CCNet没有支持FxCop等的task,所以只能在msbuild中配置FxCop等(对于NUnit,CCNet建议也在msbuild或NAnt里面配置)。
进入到CIWorker的CISample目录下面,创建一个名为CISample.FxCop的文本文件,输入如下内容:
创建一个名为CISample.msbuild的文本文件,输入如下内容:
同时修改ccnet.config文件:
再次点击Force按钮,查看CISample的最新build日志可以看到FxCop、NCover都有日志产生:
NCover的覆盖率为100%,FxCop的输出报表如图:
我们复制一个TransferFunds方法为TransferFunds1:
public void TransferFunds1(Account destination, float amount)
{
destination.Deposit(amount);
Withdraw(amount);
}
对这个方法不写单元测试,再次签入代码,可以看到覆盖测试率为85%了。然后我们把Account类重新拷贝一份命名为Account1,再次签入源代码管理器,过一会查看CISample的日志,会看到Simian报告了代码重复的行数。
至此,DotNet持续集成环境搭建和配置基本完成了。