TeamCity 命令行构建运行程序：如何使构建失败？

Question

我们使用 TeamCity 的命令行构建运行程序来调用 bat 文件。 bat 文件通过调用 Visual Studio 2008 的“devenv.exe”来构建我们的解决方案，然后执行单元测试并创建正确的文件夹结构。

我们想要做的是，如果对 devenv 的调用失败，则停止执行 bat 文件，并使 TeamCity 意识到构建失败。我们可以通过检查 ErrorLevel （如果构建失败，则为 1）来捕获失败的 devenv 调用，并且我们可以在此时退出 bat 文件。但是我们如何告诉 TeamCity 构建失败？

这是我们尝试过的：

call "build.bat"
IF ERRORLEVEL 1 EXIT /B 1

但 TeamCity 无法识别我们的退出代码。相反，构建日志如下所示：

[08:52:12]: ========== Build: 28 succeeded or up-to-date, 1 failed, 0 skipped ==========
[08:52:13]: C:\_work\BuildAgent\work\bcd14331c8d63b39\Build>IF ERRORLEVEL 1 EXIT /B 1 
[08:52:13]: Process exited with code 0
[08:52:13]: Publishing artifacts
[08:52:13]: [Publishing artifacts] Paths to publish: [build/install, teamcity-info.xml]
[08:52:13]: [Publishing artifacts] Artifacts path build/install not found
[08:52:13]: [Publishing artifacts] Publishing files
[08:52:13]: Build finished

因此 TeamCity 将报告构建成功。我们该如何解决这个问题？

解决方案：

TeamCity 提供了一种名为 服务消息可用于处理此类情况。 我已将构建脚本更新为如下所示：

IF %ERRORLEVEL% == 0 GOTO OK
echo ##teamcity[buildStatus status='FAILURE' text='{build.status.text} in compilation']
EXIT /B 1
:OK

因此，TeamCity 将报告我的构建因“编译失败”而失败。

Answer 1

请参阅构建与 TeamCity 的脚本交互主题。

您可以通过以下方式报告构建日志的消息：

##teamcity[消息文本='<消息文本>' errorDetails='<错误详细信息>' status='<状态值>']

地点：

• 状态属性可以采用以下值：NORMAL、WARNING、
  失败，错误。默认值为正常。
• 错误详情
  仅当状态为 ERROR 时才使用属性，在其他情况下则使用
  被忽略。

如果该消息的状态为“错误”，则该消息将导致构建失败，并且
“如果构建运行程序记录错误消息，则构建失败”复选框为
在构建配置常规设置页面上检查。例如：

##teamcity[消息文本='异常文本' errorDetails='堆栈跟踪' status='错误']

更新 2013-08-30：

自 TeamCity 起应使用 报告 7.1 构建失败buildProblem 服务消息改为：

##teamcity[buildProblem description='<description>' identity='<identity>']