TeamCity构建状态中Bash变量未替换问题的修复咨询

问题根源 #

TeamCity会在SSH Exec步骤执行过程中，提前扫描脚本内的服务消息格式字符串（##teamcity[...]），即便脚本因错误未执行到该echo命令，当步骤失败时，TeamCity仍会自动拼接扫描到的未被Bash替换的变量文本，生成异常状态消息。

解决方案 #

1. 拆分服务消息格式，避免提前识别 #

通过将服务消息拆分为Bash拼接的片段，让TeamCity无法在脚本执行前识别为完整的服务消息，确保变量仅在Bash执行时被替换：

echo '##teamcity[buildStatus text='\''{build.status.text}. Deployed to '"${TARGET_HOST}"'.'\''

或者用变量延迟拼接：

TC_PREFIX='##teamcity'
TC_CONTENT="[buildStatus text='{build.status.text}. Deployed to ${TARGET_HOST}.']"
echo "${TC_PREFIX}${TC_CONTENT}"

2. 主动捕获错误并输出自定义失败状态 #

在脚本中添加错误捕获逻辑，当部署失败时主动输出包含正确变量的失败状态消息，覆盖TeamCity自动生成的异常消息：

# 捕获脚本内的错误信号
trap '
  echo "##teamcity[buildStatus text=''Failed. Deployment to ${TARGET_HOST} failed.'' status=''FAILURE'']"
  exit 1
' ERR

# 执行部署命令
your_deployment_command

# 部署成功后输出状态
echo "##teamcity[buildStatus text='{build.status.text}. Deployed to ${TARGET_HOST}.']"

3. 修改SSH Exec步骤执行方式 #

在TeamCity的SSH Exec步骤设置中，选择将脚本作为文件传输到代理执行（而非直接作为命令执行）。这种方式下，TeamCity不会提前扫描脚本内容，仅捕获远程执行后输出的服务消息，从根源避免提前解析问题。

内容的提问来源于stack exchange，提问作者andrybak