TeamCity : 配置第一个工程

Posted 2020-10-10 石涛涛

前面我们已经创建了TeamCity Server 和一个 Agent，接下来我们为一个.net core 控制台程序配置自动化的编译。

创建 .net core 项目

我们在本地创建一个简单的 .net core demo程序 hello (这里假设您已经安装了.net core 的 SDK)：

mkdir hello
cd hello
dotnet new

dotnet restore
dotnet run

如果能看到输出 ”Hello World!”，就说明demo 程序已经OK了：

否则，请参照 .net core的相关文档进行排查。

管理源代码

您可以使用任何代码管理工具来管理demo程序的代码，因为TeamCity几乎支持我们能见到的所有源代码管理工具。笔者使用的是TFS，所以后面的配置会以TFS为例进行。

好了，我们已经完成了准备工作，下面就进入TeamCity开始创建相关的配置。

创建 TeamCity project

TeamCity 通过工程来管理项目相关的配置，所以我们先为 hello 程序创建一个 project。

点击 "Create project" 按钮开始创建 project：

选择手动创建相关的配置，然后进入创建 project 页面：

输入 project 的名称，然后点击 "Create" 按钮完成 project 的创建。

创建 build 配置

Project 可以包含一个或多个 build 配置，这些build 配置才是正干活的单位。我们的目的是要完成 hello 程序的自动化编译，所以我们需要创建一个 build 配置来完成这个工作。

选择手动创建一个 build 配置：

为新的 build 配置指定一个名称， 然后点击 "Create" 按钮完成创建并开始配置这个 build。

配置源代码工具

要编译代码，首先要解决从哪里获取代码的问题，通过创建一个新的 VSC Root，我们告诉 TeamCity 从TFS 上获取程序代码。当然，在这里要选择正确的 VCS 类型。

接着为新的 VCS Root 指定名称，并且设置获取代码的详细信息：

设置完成后可以先点击 "Test connection" 按钮测试一下，然后点击 "Create" 按钮完成 VCS Root 的创建。

看样子 TeamCity 已经可以从 TFS 上获取代码了，但我们仍然需要关注两处细节。

1. 管理获取到 Agent 上的代码的路径：

此处的设置为： 把取到的代码统统放入 hello 目录中。

2. 通过 TeamCity Server 来获取代码

由于我的 Agent 并不能直接连接 TFS， 所以我们可以让 TeamCity 从 TFS 上获取代码然后传递到 Agent 上去编译。

添加 build 步骤

由于稍微复杂一些的任务都不能一步搞定，所以可以为一个 build　配置添加多个 build 步骤。执行的时候，这些步骤被一个接一个的顺序执行。

我们的任务太简单了，所以添加一个命令行类型的 build 步骤就足够了：

其实，我们就是在 hello 目录下执行了 dotnet restore 和 dotnet build 两条命令而已。

收集编译产物

为了得到编译后的程序，我们需要把它们收集起来，然后通过 TeamCity 进行分发。

其实就是指定一个目录，然后让 TeamCity 把里面的东西都添加到一个压缩包里。

到此为止，TeamCity Server 上的配置已经完成了。但是真正干活的是 Agent， 所以我们还要看看 Agent 到底能不能完成编译 hello 程序的任务。

为 Agent 安装 .net core SDK

因为真正的编译是在 Agent 上完成的，所以我们必须保证，hello 程序能够在 Agent 被编译。那么当务之急就是在 Agent 上安装 .net core SDK。我们的 Agent 的 OS 是 Ubuntu 14.04，所以参照 .net core SDK 的安装说明进行安装即可：

sudo sh -c \'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list\'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
sudo apt-get install dotnet-dev-1.0.0-preview2-003131

检查劳动成果

打开 TeamCity 进入 build 配置页面，点击 "run" 按钮：

在编译完成后，我们可以点击下载编译后的 hello 程序。