持续集成工具 Jetbrains TeamCity 简介

系统管理员 2021-09-02 03:22 477阅读 0赞

**目录**

安装

Windows下安装

Docker下安装

使用TeamCity

初始化

配置数据库

新建项目

设置构建步骤

构建项目

测试项目

自动构建

邮件通知

--------------------

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

## 安装 ##

### Windows下安装 ###

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

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

### Docker下安装 ###

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

首先要做的就差拉取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就安装好了。当然我新建了两个项目，所以实际的界面可能会有所差别。

![3d58146526620cb10dc9fef2b5e3ba4e.png][]

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等工具，这里使用了我的一个简易小项目作为例子，它的代码在[这里][Link 3]。

![2c29f993f83090f2283a21341eac75b4.png][]

新建项目

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

![e324abcb43df5576ad302e38f3cb723b.png][]

确认地址

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

### 设置构建步骤 ###

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

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

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

![f241dcf2b298d750a527c6f70ac12e7c.png][]

自动检测构建步骤

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

![235015054d8884f780b5b2f8739fe05b.png][]

NuGet构建步骤

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

![974dde2176c99e030aee543d8f153c7b.png][]

构建步骤

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

![ece3b0d9c32e7265835cc0a60b688ed7.png][]

构建过程配置完成2

### 构建项目 ###

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

![f20cc272cca98fac38fd9fbe3acac55f.png][]

运行项目

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

![d4c69a8a29bd19609920ce7cd0319971.png][]

构建成功

### 测试项目 ###

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

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

![9e850006543de8e1598de9797bcae59f.png][]

构建设置

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

![ec56a4404201eeaca300916d0b8e3bff.png][]

测试设置

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

![0b606514466e53cbab6e747a03b6dcb9.png][]

测试结果

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

![2733aab403bd431f5f1f10e80cbfcb76.png][]

运行测试详细结果

### 自动构建 ###

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

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

![0f8741c0320a2b8e5ec8d5915735313b.png][]

构建触发器

### 邮件通知 ###

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

![d26cf194d57c03656185b306b099b232.png][]

电邮通知

[TeamCity]: https://link.jianshu.com?t=https://www.jetbrains.com/teamcity/?fromMenu
[Link 1]: https://link.jianshu.com?t=https://www.jetbrains.com/teamcity/download/#section=windows
[Link 2]: https://link.jianshu.com?t=https://hub.docker.com/r/jetbrains/teamcity-server/
[3d58146526620cb10dc9fef2b5e3ba4e.png]: /images/20210728/0f78542436ee466383526f663824f446.png
[Link 3]: https://link.jianshu.com?t=https://code.csdn.net/u011054333/simplewebbrowser/tree/master
[2c29f993f83090f2283a21341eac75b4.png]: /images/20210728/b447e0a4b17948a0b429673b92f0c7e6.png
[e324abcb43df5576ad302e38f3cb723b.png]: /images/20210728/ff756e4ddd9e4202a0361e5d57586f59.png
[f241dcf2b298d750a527c6f70ac12e7c.png]: /images/20210728/bd809dbfff264e949604ce2766c449d6.png
[235015054d8884f780b5b2f8739fe05b.png]: /images/20210728/8618680ac1d84d23a89484cd050532de.png
[974dde2176c99e030aee543d8f153c7b.png]: /images/20210728/5d8f75146a564dd7bd3bb235b4666934.png
[ece3b0d9c32e7265835cc0a60b688ed7.png]: /images/20210728/28722cc219ed4391916fe2e14e708a0b.png
[f20cc272cca98fac38fd9fbe3acac55f.png]: /images/20210728/7da0841b4e1f4125b1141c541a57a8dd.png
[d4c69a8a29bd19609920ce7cd0319971.png]: /images/20210728/9f9fe1e8d8194976bd4e8ffbf2f131ce.png
[9e850006543de8e1598de9797bcae59f.png]: /images/20210728/ec730931f9104402b3091a33ed6c095d.png
[ec56a4404201eeaca300916d0b8e3bff.png]: /images/20210728/71666c5345744c1cb049d9da301c5b6a.png
[0b606514466e53cbab6e747a03b6dcb9.png]: /images/20210728/cf5cb54062794348a6ec1be310b28365.png
[2733aab403bd431f5f1f10e80cbfcb76.png]: /images/20210728/35f4958e087c42fb8adc563b8c4d8f53.png
[0f8741c0320a2b8e5ec8d5915735313b.png]: /images/20210728/d9d8e23585494d70988866b5d66258b4.png
[d26cf194d57c03656185b306b099b232.png]: /images/20210728/d2e75060a33749398410eaf9615577c9.png