TeamCity On-Premises 2024.03 Help

配置并运行您的第一个构建

在 TeamCity 术语中,一个 build 是一个由一个或多个步骤组成的过程,执行特定的 CI/CD 工作。

在您按照此处所述安装并启动了 TeamCity 之后,您就可以配置并运行您的第一个构建了。

运行您的第一个构建

您可以观看快速视频指南,或阅读下面的完整教程。

创建您的第一个项目

在 TeamCity 中创建项目有几种方法:自动从仓库 URL 创建,从与特定 VCS 的连接创建,或手动创建。 在本教程中,我们将重点关注默认且最简单的方式 - 从仓库 URL。 您只需提供您的代码仓库的路径 —— TeamCity 将会扫描它并建议一些设置以及可能的构建步骤。

每个 TeamCity 安装都有默认的 Root 项目,它将包含您创建的所有其他项目。 您创建的第一个项目将作为 Root 项目的子项目添加。 添加您的第一个项目:

  1. 点击 TeamCity UI 右上角的 管理,然后点击 创建项目

  2. Create Project 页面上,点击 From a repository UR,并将您的项目源代码仓库的 URL 粘贴为 仓库URL。 它可以是 Git、Subversion、Perforce、Azure 或者 Mercurial 仓库。 所有支持的 URL 格式都在 这里 列出。 要使用我们的样本仓库,请输入:

    https://github.com/mkjetbrains/SimpleMavenSample

    如果您的仓库访问受到限制,也请输入凭证。

    从仓库 URL 创建一个项目,步骤1

  3. 点击 继续 并按照向导进行。
    TeamCity 将识别您的仓库类型,测试连接,并自动配置仓库设置,同时还会建议项目和构建配置的名称。

    Create project2

  4. 点击 继续
    TeamCity 将扫描您的 VCS 存储库并自动检测 构建步骤

  5. 检查适当步骤的复选框,它们将被添加到该项目的第一个构建配置中。

    从仓库URL创建一个项目,步骤3

恭喜! 您现在已经准备好根据刚刚创建的构建配置运行第一个构建了。 您可以直接转到 运行它,然后再 调整其设置

运行您的第一个构建

要在 TeamCity 中运行构建,您需要 构建代理。 按照此处的说明安装的全新 TeamCity 服务器,在同一台计算机上运行的注册构建代理有一个。 让我们使用这个代理来运行样本项目的构建。

构建配置设置 页面,点击右上角的 运行

运行构建

TeamCity 将始终将构建分配给第一个可用且 适合 的构建代理。

您将会被自动重定向到 Build Results 页面,您可以在此监视构建进度并在构建完成后查看结果。 您也可以从此页面访问您的构建配置设置,并根据需要进行编辑:

构建结果

调整您的构建配置设置

您可能首先需要配置以下设置:

对于其他设置,请参阅此 章节

工件

如果您的构建生成了安装程序、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 工作:

  1. 从您的源代码库创建一个项目,并调整其主要设置。

  2. 在此项目内创建一个构建配置。

  3. 在构建配置设置中,添加代表构建阶段的构建步骤。

  4. 设置其他配置设置。 例如,添加便捷的构建功能和自动触发器。

在此之后,您可以根据创建的配置手动运行构建,或者如果配置了任何触发器,等待它被自动触发。

最后修改日期: 16日 7月 2024年