使用 TeamCity 构建 .NET 项目

本指南将介绍如何使用 TeamCity 构建 .NET 项目，适合完全没有接触过 TeamCity 的开发者。

前提

我们建议您对 .NET 和 .NET CLI 有基本的了解。 For more information, see the Getting Started guide in the .NET documentation.

第 1 步 - 创建 TeamCity 项目

  1. 点击 TeamCity 页面右上角的 Administration 齿轮。
  2. 点击 + Create Project，选择 From a repository URL 标签页。 In the Repository URL field, enter your repository, for example: https://github.com/matkoch/teamcity-dotnet.git. TeamCity 可以开箱即用地处理所有主流版本控制系统：Git、Subversion、Mercurial、Perforce 和 TFS（TeamCity Cloud + 本地部署）。 CVS、StarTeam 和 Visual SourceSafe 支持仅在 TeamCity 本地部署中可用。
  3. 如果您的仓库需要身份验证，请输入您的用户名和密码/访问令牌。
  4. 点击 Proceed。

如果 TeamCity 成功连接到您的仓库，您将看到以下对话框。

在 Create Project From URL 对话框中，您可以选择更改项目名称和初始构建配置名称。

注意：在较新版本的 TeamCity 中，您还将看到 Default branch 和 Branch specification 字段，用于指定 TeamCity 应构建的分支。 这可暂时忽略。

  • TeamCity 会建议一个默认的项目名称，但您可以根据需要为您的项目选择一个更合适的名称。
  • 每个 TeamCity 项目均应包含至少一个构建配置，其中包括构建项目所需的所有步骤。 TeamCity 的构建配置在其他 CI 系统中通常称为作业。 您暂时可以使用默认的构建配置名称“Build”。

点击 Proceed 后，TeamCity 会自动扫描您为支持的技术（在本例中为 .NET）使用的版本控制仓库。

如果 TeamCity 在您的仓库中检测到解决方案文件 (*.sln)，它将自动为您的项目建议构建步骤，包括使用 dotnet build 编译您的 .NET 解决方案并通过 dotnet test 运行其所有测试。

构建步骤不应与构建配置混淆。 构建配置可能包含许多构建步骤。

选中 .NET 构建步骤复选框，点击 Use selected。

现在，您已经成功使用 TeamCity 配置您的 .NET 仓库：

第 2 步 - 运行您的第一个构建

您现在可以按右上角的 Run 按钮运行您的第一个构建，如下所示：

注意：如果您使用的是 TeamCity Cloud，构建代理可能需要几分钟才能可用。 在此期间，您的构建将在队列中等待，直到被可用代理接收。

如果您将 TeamCity 本地部署与本地构建代理搭配使用，您的构建将立即开始。

构建开始后，您将被重定向到构建的概览页面，Build Log 标签页处于打开状态，显示与您的构建相关的实时数据。

构建运行完成后，您可以查看测试结果或浏览完整的构建日志。

第 3 步 - 配置 .NET TeamCity 项目

现在，您的 .NET 仓库已连接到 TeamCity，您可以继续开发并将代码推送到您的仓库。

默认情况下，TeamCity 每隔 60 秒轮询一次 VCS 仓库的主分支以获取传入更改，并为所有检测到的提交触发一个（组合）构建。

构建分支

如果您想让仓库中任意分支的每次更改（而不仅仅是主分支）都触发构建，应将通配符分支规范添加到您的 VCS 根设置。 请注意，VCS 设置属于 TeamCity 项目，而不属于单个构建配置。 因此，您所做的任何更改都将应用于使用相同 VCS 根的所有构建配置。

  1. 在项目的概览页面上，点击 Edit Project。 或者，如果您已打开 Build 构建配置，请点击 Edit Configuration。
  2. 导航到 VCS 根（版本控制系统）并编辑您的 VCS 根。
  3. 填写 Branch Specification 输入字段，然后点击 Save。 如果您看不到 Branch Specification 输入字段，请先点击 Show Advanced。

示例分支规范：

  • +:refs/heads/* – TeamCity 将检查项目所有分支中的更改，但不会检查 GitHub 等平台上的 Pull Request，因为其与 refs/pull/* 匹配。
  • +:* – TeamCity 将检查任何分支上的任何传入更改。
  • 您自己的自定义分支规范。

TeamCity 现在将监控所有符合您的分支规范并推送到您的仓库的分支，检查传入的更改，并相应地运行构建。

构建 Pull Request

如果您希望 TeamCity 针对您的仓库自动构建 Pull Request，可以将 Pull Request 构建功能添加到您的构建配置。

  1. 打开您的构建配置，点击 Edit Configuration。
  2. 导航到 Build Features，点击 Add Build Feature。 如果您看不到 Build Features 链接，请点击 Show More。
  3. 从下拉列表选择 Pull Requests，选择您的仓库以及仓库提供商（GitHub、GitLab 等）。
  4. 或者，按作者或分支名称应用 Pull Request Filtering。

注意：Pull Request 构建功能会透明地扩展分支规范（更多信息见上一步）。 例如，对于 GitHub，Pull Request 功能将（不可见地）把 +:refs/pull/* 添加到您的分支规范。

我们建议在使用 Pull Request 功能时，确保 Pull Request 分支不在您的通用分支规范内，否则 Pull Request 相关功能在 TeamCity 中将不可用。

TeamCity 现在将检查外部平台的 Pull Request，并为符合您的配置规则的请求触发构建。

注意：如果在公共仓库上，您应谨慎使用此功能，因为任何人都可能将有害代码推送到仓库（您显然不想构建这样的代码）。

Commit Status Publisher

When using the pull requests feature in combination with Azure DevOps, Bitbucket Server, GitHub, or GitLab, it also makes sense to use the Commit Status Publisher build feature. 此功能将在相应平台上以构建结果更新 Pull Request 的状态。

要将 TeamCity 设置为向 GitHub 报告构建结果，您需要执行以下步骤：

  1. 打开您的构建配置，点击 Edit Configuration。
  2. 导航到 Build Features，点击 Add Build Feature。
  3. 从下拉列表中选择 Commit Status Publisher，然后选择您的仓库和发布者（GitHub、GitLab 等）。
  4. 提供具有足够权限的访问令牌以发布提交状态。
  5. 点击 Save。

TeamCity 运行构建后，您可以直接从 GitHub 的 Pull Request 标签页（绿色复选标记）轻松查看更改是否导致构建失败。