如何在TeamCity构建状态窗口中展示自定义页面输出

Build Result Decorator插件触发下载问题修复 #

• 首先确认status.html已作为构建产物正常上传，路径与你配置的artifactFilename参数完全匹配，无多余层级前缀
• 修改TeamCity安全配置：默认情况下TeamCity为防范XSS风险，会给所有HTML格式产物添加强制下载的响应头，你需要进入「管理 > 服务器管理 > 全局设置」，找到「允许展示的HTML产物路径」配置项，添加规则**/status.html，保存后重启TeamCity服务即可生效
• 确认插件版本与你当前使用的TeamCity版本兼容，版本不匹配会直接导致渲染逻辑失效，可在插件管理页检查版本适配性

无插件替代方案 #

如果插件调试后仍无法正常使用，可使用TeamCity原生功能实现需求，稳定性更高：

方案1：自定义构建报告 #

• 将需要展示的JPG图表、表格内容整理为HTML文件，和图片资源一起作为构建产物上传
• 进入构建配置的「报告」标签页，添加自定义报告，指定HTML入口文件的产物路径，配置完成后构建结果页会新增对应报告标签，可直接渲染展示完整HTML内容，无需担心下载问题

方案2：自定义统计图表 #

如果只需展示指标类图表，可使用原生统计功能：

• 在构建过程中通过服务消息输出指标数值，格式为：
  ##teamcity[buildStatisticValue key='自定义指标名' value='指标数值']
• 进入构建配置的「统计」标签，添加自定义图表，选择你输出的指标，TeamCity会自动生成折线/柱状图，直接展示在构建状态页的统计区域

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