配置并运行您的第一个构建
在 TeamCity 术语中,一个 build 是一个由一个或多个步骤组成的过程,执行特定的 CI/CD 工作。
在您按照 此处所述安装并启动了 TeamCity 之后,您就可以配置并运行您的第一个构建了。

您可以观看快速视频指南,或阅读下面的完整教程。
创建您的第一个项目
您可以通过多种方式在 TeamCity 中创建项目:从仓库 URL 自动创建、通过 VCS 连接创建或手动创建。 本教程重点介绍最简单的方法 —— 从仓库 URL 创建项目。 只需提供您的仓库路径,TeamCity 将扫描该路径、检测构建步骤并建议配置设置。
每个 TeamCity 安装都包含一个默认的 根目录 项目,其中包含所有其他项目。 您创建的第一个项目将作为此根项目的子项目添加。 请按以下步骤创建该项目:
打开 项目 选项卡,然后点击“ +”。

输入项目名称和可选描述。 可以保留自动生成的 Project ID 不变。

TeamCity 项目本身不会执行构建,而是作为 build configuratons和 pipelines的容器。 项目仅用于帮助您组织相关构建、管理权限并共享资源,例如 connections和 build parameters。
保存项目信息后,TeamCity 将打开 设置您的构建 页面。 在此,您可以选择创建构建配置或 pipeline。 在本教程中,请选择经典构建配置。

从下拉菜单中选择 连接新仓库|任何 Git URL。
添加更多项目后,您将可以使用其他创建选项。 例如, 从现有 VCS 根创建,或通过 已认证的 VCS 连接选择仓库。
粘贴您的仓库 URL。 TeamCity 支持 Git、Subversion、Perforce、Azure 和 Mercurial(所有支持的 URL 格式列在 此处)。 对于示例项目,请使用:
https://github.com/JetBrains/Maven-Configuration-TeamCity-Samples这是一个公共仓库,因此您可以选择 HTTPS|匿名 身份验证方式。 对于私有仓库或需要写入权限的情况(例如 发布构建状态 ),请选择其他身份验证方法。 有关详细信息,请参阅 创建和编辑构建配置。

点击 继续 后,TeamCity 会定位仓库、检查其分支,并提示您选择 默认分支。 您还可以为新提交启用自动构建触发器。
点击 创建 以完成初始设置。 此时,您已有一个包含子构建配置的项目,并正查看构建配置设置。 使用右上角的 设置 按钮在“编辑”(修改配置)和“查看”(查看构建历史)模式之间切换。
您可以立即运行该构建配置。 TeamCity 代理将负责此构建,提取源代码,但由于当前尚未定义构建步骤,构建将很快结束。 现在让我们添加一些构建步骤。
在配置设置中,打开 构建步骤 选项卡。 在此,您可以定义配置在触发时执行的操作。
点击 自动检测构建步骤 以让 TeamCity 扫描您的仓库。 对于该示例项目,系统将建议两个 Maven构建步骤。 选择运行
清理测试并针对ch-simple/pom.xml文件执行的构建步骤,然后点击 使用已选择的。
运行您的第一个构建
要在 TeamCity 中运行构建,您需要 构建代理。 按照 此处的说明安装的全新 TeamCity 服务器,在同一台计算机上运行的注册构建代理有一个。 让我们使用这个代理来运行样本项目的构建。
在 构建配置设置 页面上,点击右上角的 运行:

TeamCity 将始终将构建分配给第一个可用且 适合 的构建代理。
您将被自动重定向到 构建结果 页面,在构建完成后,您可以查看构建进度并审查其结果。 您也可以从此页面访问您的构建配置设置,并根据需要进行编辑:
调整您的构建配置设置
您可能首先需要配置以下设置:
构建 artifacts 的路径
一种自定义模式用于 build number
对于其他设置,请参阅此 章节。
工件
如果您的构建生成了安装程序、WAR 文件、报告、日志文件等,您可能希望在完成构建后将它们发布在 TeamCity 服务器上。 您可以在 构建配置设置 | 常规设置 中指定此类工件的路径。 由于您已经完成了构建,因此构建代理已经签出了源代码。 在 Artifact paths 字段旁边,点击树形图标以打开签出目录浏览器。 您可以从这棵树中选择构件:

TeamCity 将把它们的路径放入文本字段中,所以如果需要,您可以修改它们:

保存构建配置设置。 现在,当您运行构建时,TeamCity 将把所有指定的报告放入一个存档并发布它们。
构建配置主页 页面列出了所有运行的构建,并允许查看其工件:

您还可以在 构建结果 页面查看和下载工件:

阅读更多详细信息 这里。
自动构建触发器
仓库中发生更改时自动触发构建对于任何 CI 来说都是必要的。 创建项目 / 构建配置时,TeamCity 将自动添加一个 VCS 触发器。 您还可以在 构建配置设置 | 触发器 页面手动添加它:

构建编号格式
TeamCity 中的每个构建都有一个构建号,这是一个字符串标识符。 它是根据 构建配置设置 | 常规设置 中定义的模式组成的(点击 Show advanced options以显示它)。 如果您保留默认值,构建编号格式将由 TeamCity 维护;每次启动新的构建时,该编号将解析为下一个整数值。 或者,您可以按照 这里所述的方式自定义模式。
要点
要在 TeamCity 中配置某个 CI / CD 工作:
从您的源代码库创建一个项目,并调整其主要设置。
在此项目内创建一个构建配置。
在构建配置设置中,添加代表构建阶段的构建步骤。
设置其他配置设置。 例如,添加便捷的构建功能和自动触发器。
在此之后,您可以根据创建的配置手动运行构建,或者如果配置了任何触发器,等待它被自动触发。