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

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

我们想要做的是，如果对 devenv 的调用失败，则停止执行 bat 文件，并使 TeamCity 意识到构建失败。我们可以通过检查来捕获失败的 devenv 调用错误级别（如果构建失败，则为 1），此时我们可以退出 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 提供了一种称为服务信息 http://confluence.jetbrains.net/display/TCD5/Build+Script+Interaction+with+TeamCity#BuildScriptInteractionwithTeamCity-ReportingBuildStatus可以用来处理这样的情况。 我已经更新了我的构建脚本，如下所示：

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

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

See 与 TeamCity 构建脚本交互 http://confluence.jetbrains.net/display/TCD5/Build+Script+Interaction+with+TeamCity#BuildScriptInteractionwithTeamCity-reportingMessagesForBuildLog topic.

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

##teamcity[message text='<message text>' errorDetails='<error details>' status='<status value>']

where:

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

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

##teamcity[message text='Exception text' errorDetails='stack trace' status='ERROR']

2013年8月30日更新：

从 TeamCity 7.1 开始，应使用以下方式报告构建失败buildProblem http://confluence.jetbrains.com/display/TCD8/Build+Script+Interaction+with+TeamCity#BuildScriptInteractionwithTeamCity-ReportingBuildProblems服务消息改为：

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