持续集成工具TeamCity快速入门

大名鼎鼎的Intellij IDEA大家都听说过吧,它的出品公司Jetbrains不仅推出了一系列好用的IDE,同时还推出了现在正热的Kotlin语言。Jetbrains还有一个非常好用的产品就是今天要介绍的持续集成工具TeamCity

安装

Windows下安装

要安装TeamCity很简单,首先到下载页面下载TeamCity,由于这里我用的是Windows系统,所以下载Windows版本的安装包。下载完成之后安装即可。在Windows下安装有一个好处就是可以安装为服务,这样以后如果需要管理TeamCity的状态会更方便一些。这里要说下,TeamCity分为两个服务,一个叫做构建代理,实际的项目构建都是通过这个代理服务来执行的;另一个服务就是TeamCity的网页版控制端,让我们可以方便的通过网页进行管理。

当然在下载页面上可以看到有多个操作系统,不论是Windows、macOS还是Linux都可以运行TeamCity。

Docker下安装

现在虚拟化服务越来越流行了,因为虚拟化真的非常方便。如果需要在Docker中启用TeamCity也同样简单。TeamCity对应的DockerHub页面在这里

首先要做的就差拉取TeamCity镜像。

docker pull jetbrains/teamcity-server

拉去镜像之后启动它的实例即可。下面是官方页面上给出的例子,当然这里的几个名称和文件位置可以根据需要自行修改。

docker run -it --name teamcity-server-instance  \
    -v <path to data directory>:/data/teamcity_server/datadir \
    -v <path to logs directory>:/opt/teamcity/logs  \
    -p <port on host>:8111 \
    jetbrains/teamcity-server

使用TeamCity

初始化

安装完成并启动TeamCity之后,我们就可以在Web页面中访问它了。如果是Windows系统,那么默认端口是80,如果是其他系统则是你自己设置的端口。然后访问浏览器的localhost:80即可看到TeamCity页面。第一次使用需要配置用户并初始化,之后稍微等待一段时间即可。

之后应该会看到类似的界面,这样TeamCity就安装好了。当然我新建了两个项目,所以实际的界面可能会有所差别。

TeamCity截图

配置数据库

还有一个注意点就是配置数据库了。默认情况下TeamCity使用的是内置的数据库,性能并不怎么样。所以为了将来使用更加顺畅,TeamCity推荐我们设置自己的数据库。

举个例子,如果我准备用MySQL数据库,那么我需要下载一个MySQL的JDBC驱动mysql-connector-java-5.1.42-bin.jar,然后把它放到TeamCity的数据文件夹的lib\jdbc下,然后在TeamCity中配置相应的数据库用户名和密码以便访问数据库。

当然这是Windows下的情况,如果使用Docker,可能不需要自己配置数据库。另外配置玩数据库之后并不是万事大吉,有时候TeamCity还会帮你检测到数据库的性能问题,这时候只要照着他的提示修改数据库的配置即可。

新建项目

第一次使用TeamCity的时候会提示你新建项目。之后如果要新建项目,点击右上角的Administration即可。新建项目时需要提供项目代码的URL,支持Git、SVN等工具,这里使用了我的一个简易小项目作为例子,它的代码在这里

新建项目

然后TeamCity会检查输入的地址,并提醒我们确认。

确认地址

这样,项目就建立完成了。

设置构建步骤

持续集成工具需要管理项目的整个生命周期,所以仅仅添加了项目还是不够的。下面一步就是要设置具体的项目构建步骤。不同的项目可能有不同的构建过程,所以这里就是设置的重点了。特别要说一下,TeamCity的免费版本只能支持20个构建步骤,所以如果需要用到更多配置的话就需要付费购买商业版了。

另外从这里就可以看出构建工具的重要性。如果项目是Java项目,使用了业界著名的Maven或Gradle这样的构建工具来管理项目,那么TeamCity只需要自动检测就可以完成所有配置步骤。如果没有使用这样的工具,那么可能需要自己设置构建过程了。(比方说我这里的WPF桌面程序,就只能自己设置了)

由于我用的例子是WPF桌面程序,所以这里就来说说.NET程序的构建过程配置。如果使用了自动检测功能的话,那么TeamCity会自动帮你添加一个Visual Studio (sln)步骤。不过仅仅这一个步骤是远远不够的,所以我们需要添加其他步骤。

自动检测构建步骤

首先考虑到项目中可能使用多种第三方库,而在.NET平台下第三方库一般都是用NuGet获取。所以我们需要添加一个NuGet步骤。首先点击上图中的configure build steps manually,然后选择NuGet Installer类型,在弹出的界面中设置相应的选项。

NuGet构建步骤

然后需要设置构建步骤,选择Visual Studio (sln)即可。

构建步骤

这样一来,项目构建的步骤就配置好了。

构建过程配置完成2

构建项目

设置好构建步骤之后,下一步就可以开始构建项目了。点击页面上面的Projects,切换回项目视图。然后点击项目右边的Run即可。

运行项目

这时候构建代理右边的空白框也会变成蓝色,表示正在构建项目。等待片刻,项目就会构建完毕。一个构建任务就完成了。

构建成功

测试项目

一个成功的项目必然有完整的测试过程。还是那句话,如果项目使用了成熟的构建工具,那么TeamCity就会自动检测和使用这些功能。但是如果TeamCity没有自动检测到的话,就需要手动设置了。

首先点击对应项目的Build链接,然后点击构建设置(Settings),并在页面下方找到构建步骤(Build Steps)。

构建设置

在前面我们添加了两个步骤,下面还要继续添加一个测试步骤。新建一个步骤,类型选择Visual Studio Tests。在Visual Studio Tests下还有两个类型,MSTest和VSTest。它们的区别在于VSTest需要TeamCity构建代理服务器上同时安装有Visual Studio或者Visual Studio Test Agent。然后Test file names这里需要填写测试项目的程序集,只要填写相对路径就行了。具体程序集的位置和名称需要根据项目来确定,我这个测试项目的情况就是如图所示。最后如果需要检查测试覆盖率,还可以设置最后的.NET Coverage tool。

测试设置

设置完成后再次运行构建命令,可以看到这次不仅构建了项目,还同时运行了测试,测试结果也会一并显示。

测试结果

如果点击进入详情查看,还会获得更丰富的结果。这里我同时选择了代码覆盖率功能,可以看到非常方便的图表显示。

运行测试详细结果

自动构建

前面所有操作全部是手动点击执行构建的。当然TeamCity也支持自动构建,默认情况下每个项目都会添加一个触发器,当项目所在的版本控制系统更新的时候触发构建。当然这个条件也是可以修改的。

如下图所示,触发器的设置在项目设置中,如果需要其他触发器设置在这里更改即可。

构建触发器

邮件通知

如果构建失败的话,TeamCity可以向你账户发送电子邮件提醒你状况,不过这需要你在TeamCity中设置SMTP服务器才行。如果是公司的话,应该可以使用公司的企业邮箱进行设置。个人建议不要使用国内的电邮,因为有些国内电邮的服务器由于经常发送垃圾邮件,可能会被其他一些电邮拉黑,导致无法获取电子邮件。

电邮通知
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,585评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,400评论 25 707
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,724评论 6 342
  • 如果你要去玉泉路小市场看看琥珀蜜蜡,听听鸟鸣,要小心。 刘亮程冻坏的骨头里的冷被我丢在了那里。 再留它一会儿,我的...
    一个沈旸阅读 538评论 1 0
  • 1 小和尚跟着师父去化缘,两人走了很多路,又累又渴,可是正值荒年,百姓家要吃饱肚子都很难,实在没有多余的粮食可以分...
    凌云仙渡阅读 6,278评论 3 13