配置构建步骤

每个构建步骤都提供与特定构建或测试工具的集成。 例如，在编译 VS 解决方案之前调用 NAnt 脚本。 您可以根据需要向您的构建配置中添加尽可能多的构建步骤。

本视频教程解释了如何根据项目需求选择构建步骤：

构建步骤会按顺序调用。

是否运行下一个构建步骤可能取决于前面构建步骤的退出状态，当前构建状态，或者 执行条件。

如果（1）构建过程返回的退出代码非零，并且（2）" 如果构建过程的退出代码不为零，则构建失败" 构建失败条件已启用（参见 构建失败条件 ），则认为构建步骤 失败 ；否则，构建步骤被认为 成功。

请注意，构建步骤的状态和构建本身的状态可能会有所不同。 所有构建步骤都可能成功，但是由于另一个构建失败条件，构建可能会失败，这并不是基于退出代码（如，测试失败）。 另一方面，如果构建步骤失败了，那么构建也会失败。

关于配置单个构建步骤的详细信息，请参考本节内的相关页面。

在构建触发后，构建代理检出源文件之前，会执行一个 引导步骤。 这允许您添加一个运行器（通常是 命令行 运行器），该运行器执行初始设置并确保后续步骤按预期运行。

要启用 bootstrap steps，首先将 teamcity.internal.bootstrap.steps.enabled=true 条目添加到 TeamCity 内部属性 或单个项目（作为该项目的 配置参数）。 此设置使您能够执行以下操作：

• 在步骤设置中启用 在引导期间运行 选项。

  

• 在配置的 构建步骤 页面上，单击 重排构建步骤 ，然后将所需步骤拖动到“准备阶段”块之前。

  

您可以创建一个带有 bootstrap 步骤的构建配置，并将此配置变成一个 template。 这种模板允许您在实际构建过程开始之前快速创建更多执行所需前提操作的配置。

Recipes 被视为单个步骤，因此无法分为在签出之前和之后执行的部分。

要在 Kotlin DSL 中将普通步骤变为 bootstrap 步骤，请添加 teamcity.step.phase 参数并将其值设置为“bootstrap”。

object MyConfig : BuildType({
  // ...
  steps {
    script {
      name = "Disk prep"
      id = "simpleRunner"
      scriptContent = "echo 'Initial setup'"
      param("teamcity.step.phase", "bootstrap") // Bootstrap step
    }
    // Regular steps
  }
  // ...
})

无代理构建步骤 是可以在外部软件中运行且无需附加 build agent 的步骤。

通常，一个正在运行的构建会占用一个构建代理，直到完全结束，即使其最后的步骤是在 TeamCity 之外执行的。 然而，如果构建不需要其代理进行一些剩余步骤，它可以从此代理分离。 代理一旦可用，即可立即分配给另一个构建。

这种方法可以节省代理的工作时间，并且对于使用第三方工具完成构建的配置来说是最优的：例如，运行众多测试或部署项目。 这样的构建可以在 TeamCity 外部完成；TeamCity 服务器将直接检测其状态报告，无需通过代理作为中介。

让我们考虑一个包含三个步骤的示例构建：编译，测试和部署。 即使部署步骤实际上是由外部软件执行的，所有这些都由代理处理。 代理仅在轮询外部软件并将构建状态报告给 TeamCity 服务器。

在无代理的方法中，代理无需处理最终的部署步骤，并且可以运行队列中的其他构建。 TeamCity 服务器将直接从外部工具中捕获以下报告。

另请参阅： 将构建与 Agent 分离

TeamCity 能够扫描项目的源 VCS 仓库，并在 Node.js、Kotlin、Python、Ant、NAnt、Gradle、Maven、MSBuild、Visual Studio 解决方案文件、PowerShell、Xcode 项目文件、Rake 以及 IntelliJ IDEA 项目中自动检测构建步骤。

在 构建步骤 中，单击 自动检测构建步骤 ，然后选择您希望添加到当前构建配置中的建议步骤。 您可以在之后更改它们的设置。

当扫描存储库时，TeamCity 会逐步在源树的两个最高级别中搜索项目文件。 在搜索时，它会考虑文件的扩展名。 例如：

• PowerShell： .ps1

• .NET： project.json， .proj， .csproj， .vbproj， .sln

如果检测到的步骤已经手动添加到此配置中，TeamCity 将跳过这些步骤。

TeamCity 提供了报告给定 ID 步骤状态的 teamcity.build.step.status.<步骤_ID> 参数。 步骤 ID 显示在其名称下方，只有在创建它们时才可以编辑。

teamcity.build.step.status.<步骤_ID> 参数的可用值为：

• 成功 — 当一个步骤没有错误地完成时。

• 失败 — 当一个步骤失败时。 即使所有构建问题都被 静音 ，也会报告此状态。

• 已取消 — 当该步骤运行时，构建被取消。

参数 teamcity.build.step.status.<步骤_ID> 只有在其对应的步骤完成后才会出现，而不是在构建开始的瞬间就可用。 这意味着既正在运行的步骤，也被跳过的步骤都无法获得其 teamcity.build.step.status.<步骤_ID> 参数。

您可以在构建结果页面的 参数选项卡 中检查所有步骤的状态...

...或通过 TeamCity REST API。

GET
http://<SERVER_URL>/app/rest/builds/<BUILD_ID>/resulting-properties

您可以使用这些参数来创建自定义 构建步骤执行条件。