自构建工具TeamCity的安装及使用
第2章 安装步骤
2.2 软件安装
2.2.1 安装包位置
\\192.168.0.5\persons\下载软件\TeamCity-8.1.5.exe
附属安装包
\\192.168.0.5\persons\下载软件\WDeploy.exe
2.2.2 安装
点击 Teamcity-8.1.5.exe 按提示安装即可,安装完成后在安装目录有个文件加 TeamCity
同时管理用的网站也配置好了
在浏览器输入配置的地址打开如下:http://localhost:8080/login.html
输入admin,admin (默认管理员帐号)(首次要求创建管理员帐号)
也可自己注册新帐号,注册好后联系管理员分配权限
登入后 点击 又上角的 administrator即可创建,管理用户,用户组等
2.2.3 WDeploy.exe web部署服务安装
WDeploy.exe 是微软的web部署工具,因为发布web站点时要用到,点击安装,自定义安装,勾选所有项进行安装即可。
安装完成后,进入控制面板-管理工具-服务,
MsDepSvc,WMSVC 这两个服务设为自动启动并启动,如下图:
第3章 软件使用
本例以***.Webapi的自构建为例说明如何配置管理项目
3.1 创建project
进入 administrator 如图:
点击 create project 进入创建页面
输入信息完成创建
3.2 配置project
点击左上角的 project 选下拉图标,选择刚创建的 project 如图:
点击项目右边的 下拉图标,选择 edit Settings
3.2.1 General Settings
上半部分可以修改
点击 Create Build configuration
创建完成后 在build list 里 点击 edit 进入 build 的配置页面
3.2.1..1 Build Configuration Setttings
General Settings
该部分信息可不用修改
Version Control Setting
该部分输入信息如下:
Build Steps
构建步骤分十步(dev),即添加十个build step,分别如下
1-4 步为nuget package还原
5-7 为 project 自动编译
8-10 为文档自动生成
第一步:
Runner type:选择合适的类型 nugget Installer
Step name : 自定义
Excute step 一般选 If all previous steps finished successfully 即可
Nugget Settings: default 2.8.3 没有这项从下面的 nugget settings 设置即可
Path to solution file: 选择需要还原nuget package 的解决方案
第二步:
同上,nuget一般以sln为单位;有个要注意的地方,如果解决方案下工程文件路径有调整最好在解决方案管理nuget包里把包的引用删除再添加下。否则会出现teamcity里编译找不到dll的问题
第三步:
同上
第四步:
同上
第五步:
Runner type:选择合适的类型 MSBuild
Step name : 自定义
Path to solution file: 选择需要编译的工程文件 csproj
MSBuild version : Microsoft Build Tools 2013
MSBuild ToolsVersion: 12.0
Run platform:x86
Targets: rebuild
Command line parameters:
/p:ReferencePath="..\Lib\Public;..\Lib\Aliyun_dotnet_SDK\bin"
/p:Configuration=TestServer
/p:OutputPath=bin
/p:DeployOnBuild=True
/p:DeployTarget=MSDeployPublish
/p:MsDeployServiceUrl=https://192.168.0.106:8172/msdeploy.axd
/p:username=Administrator
/p:password=***
/p:AllowUntrustedCertificate=True
/p:DeployIisAppPath=webapi.dev
/p:MSDeployPublishMethod=WMSVC
/p:EnableMSDeployAppOffline=true
/p:MSDeployUseChecksum=true
说明:
ReferencePath 除了nuget package 引用外的其它引用
Configuration 是配置 debug,release 还有自定义的配置可选
OutputPath 输出路径
MsDeployServiceUrl 里的IP 改成目标网站的ip
Username,password 为目标机器的帐号信息
DeployIisAppPath 为目标网站的网站名 iis中的网站名
.NET Coverage tool: <No .NET Coverage> 因为暂没做自动测试,故选择这个
这里一般是webapi的编译设置。
如果是vs2013建的网站项目,是没有proj文件的,可以在网站项目上发布网站,这样就会有website.publishproj 文件了,但这样的文件编译后有个问题,引用的第三方包及要用到的系统包不能编译进bin,本人通过手动修改website.publishproj文件解决。如下:
在itemgroup 加入要用到但没有的包(红色部分)
<ItemGroup>
<AssemblyAttributes Include="AssemblyFileVersion">
<Value>$(AssemblyFileVersion)</Value>
</AssemblyAttributes>
<AssemblyAttributes Include="AssemblyVersion">
<Value>$(AssemblyVersion)</Value>
</AssemblyAttributes>
<Reference Include="System.Diagnostics.Tracing" />
<Reference Include="System.Runtime" />
<Reference Include="System.Runtime.InteropServices" />
<Reference Include="System.Diagnostics.Tracing" />
<Reference Include="MongoDB.Bson">
<HintPath>..\..\packages\mongocsharpdriver.1.9.2\lib\net35\MongoDB.Bson.dll</HintPath>
</Reference>
<Reference Include="MongoDB.Driver">
<HintPath>..\..\packages\mongocsharpdriver.1.9.2\lib\net35\MongoDB.Driver.dll</HintPath>
</Reference>
<Reference Include="log4net">
<HintPath>..\..\packages\log4net.2.0.3\lib\net40-full\log4net.dll</HintPath>
</Reference>
<Reference Include="AspNetPager">
<HintPath>..\..\packages\AspNetPager.7.4.3\lib\AspNetPager.dll</HintPath>
</Reference>
</ItemGroup>
网站项目的build的paramline 设置如下:同webapi,略有一点点区别 /p:OutputPath=bin 不用设
/p:Configuration=Debug
/p:DeployOnBuild=True
/p:DeployTarget=MSDeployPublish
/p:MsDeployServiceUrl=https://192.168.1.9:8172/msdeploy.axd
/p:username=Administrator
/p:password=***
/p:AllowUntrustedCertificate=True
/p:DeployIisAppPath=Promotion
/p:MSDeployPublishMethod=WMSVC
/p:EnableMSDeployAppOffline=true
/p:MSDeployUseChecksum=true
第六步:
第七步:
同上
第八步:
/p:OutputPath="C:\Help\entity" 当输出路径与项目中不一致时可重新设置这个路径
*.shfbproj 是由Sandcastle Help File Build创建的项目 可参考 http://blog.csdn.net/huwei2003/article/details/42028163;主要用来根据代码注释自动生成文档
第九步
同上
第十步:
同上
Build step 是自构建设置中最重要也是最繁琐的一步,参照截图配置即可。
Tiggers
即设置触发构建的条件
Failure Contitions
无须设置
Build Features
无须设置
Dependencies
无须设置
Parameters
无须设置
Agent Requirements
无须设置,如图
3.2.2 VCS Roots
如图:同build step 里的版本库设置相同
3.2.3 Report Tabs
无须设置
3.2.4 Parameters
无须设置
3.2.5 Builds Schedule
无须设置
3.2.6 Shared Resources
无须设置
3.2.7 Maven Settings
无须设置
3.2.8 Meta-Runners
无须设置
3.2.9 SSH Keys
无须设置
当以上都设置好后,只要版本库有代码跟新则会触发自动构建,构建完成后 成功会显示 success ,否则会显示 感叹号图标,点击可看错误原因。