配置并运行您的第一个构建
在 TeamCity 术语中,一个 build 是一个由一个或多个步骤组成的过程,执行特定的 CI/CD 工作。
在您按照此处所述安装并启动了 TeamCity 之后,您就可以配置并运行您的第一个构建了。
您可以观看快速视频指南,或阅读下面的完整教程。
创建您的第一个项目
在 TeamCity 中创建项目有几种方法:自动从仓库 URL 创建,从与特定 VCS 的连接创建,或手动创建。 在本教程中,我们将重点关注默认且最简单的方式 - 从仓库 URL。 您只需提供您的代码仓库的路径 —— TeamCity 将会扫描它并建议一些设置以及可能的构建步骤。
每个 TeamCity 安装都有默认的 Root 项目,它将包含您创建的所有其他项目。 您创建的第一个项目将作为 Root 项目的子项目添加。 添加您的第一个项目:
点击 TeamCity UI 右上角的 管理,然后点击 创建项目。
在 Create Project 页面上,点击 From a repository UR,并将您的项目源代码仓库的 URL 粘贴为 仓库URL。 它可以是 Git、Subversion、Perforce、Azure 或者 Mercurial 仓库。 所有支持的 URL 格式都在 这里 列出。 要使用我们的样本仓库,请输入:
https://github.com/mkjetbrains/SimpleMavenSample如果您的仓库访问受到限制,也请输入凭证。
点击 继续 并按照向导进行。
TeamCity 将识别您的仓库类型,测试连接,并自动配置仓库设置,同时还会建议项目和构建配置的名称。点击 继续。
TeamCity 将扫描您的 VCS 存储库并自动检测 构建步骤。检查适当步骤的复选框,它们将被添加到该项目的第一个构建配置中。
运行您的第一个构建
要在 TeamCity 中运行构建,您需要 构建代理。 按照此处的说明安装的全新 TeamCity 服务器,在同一台计算机上运行的注册构建代理有一个。 让我们使用这个代理来运行样本项目的构建。
在 构建配置设置 页面,点击右上角的 运行:
TeamCity 将始终将构建分配给第一个可用且 适合 的构建代理。
您将会被自动重定向到 Build Results 页面,您可以在此监视构建进度并在构建完成后查看结果。 您也可以从此页面访问您的构建配置设置,并根据需要进行编辑:
调整您的构建配置设置
您可能首先需要配置以下设置:
构建 artifacts 的路径
一种自定义模式用于build number
对于其他设置,请参阅此 章节。
工件
如果您的构建生成了安装程序、WAR 文件、报告、日志文件等,您可能希望在完成构建后将它们发布在 TeamCity 服务器上。 您可以在 Build Configuration Settings | General Settings 中指定这些工件的路径。 由于您已经完成了构建,因此构建代理已经签出了源代码。 在 Artifact paths 字段旁边,点击树形图标以打开签出目录浏览器。 您可以从这棵树中选择构件:
TeamCity 将把它们的路径放入文本字段中,所以如果需要,您可以修改它们:
保存构建配置设置。 现在,当您运行构建时,TeamCity 将把所有指定的报告放入一个存档并发布它们。
Build Configuration Home 页面列出了所有运行构建,允许查看它们的产物:
您还可以从 构建结果 页面查看和下载工件:
阅读更多详细信息 这里。
自动构建触发器
仓库中发生更改时自动触发构建对于任何 CI 来说都是必要的。 创建项目 / 构建配置时,TeamCity 将自动添加一个 VCS 触发器。 您也可以在 Build Configuration settings | Triggers 页面手动添加它:
构建编号格式
TeamCity 中的每个构建都有一个构建号,这是一个字符串标识符。 它是根据在 Build Configuration Settings | General Settings 中定义的模式组成的(点击 Show advanced options 来显示它)。 如果您保留默认值,构建编号格式将由 TeamCity 维护;每次启动新的构建时,该编号将解析为下一个整数值。 或者,您可以按照这里所述的方式自定义模式。
要点
要在 TeamCity 中配置某个 CI / CD 工作:
从您的源代码库创建一个项目,并调整其主要设置。
在此项目内创建一个构建配置。
在构建配置设置中,添加代表构建阶段的构建步骤。
设置其他配置设置。 例如,添加便捷的构建功能和自动触发器。
在此之后,您可以根据创建的配置手动运行构建,或者如果配置了任何触发器,等待它被自动触发。