如何在Atlassian Bamboo的FTL邮件模板中添加SVN构建检出版本号

解决步骤 #

1. 定位并编辑notificationCommonsHTML.ftl文件，找到templateOuter宏内“构建成功/失败”行（第15行）的位置。

2. 在该行之前插入以下Freemarker代码，用于显示SVN修订号：

   <p>SVN 检出版本号: ${build.customBuildData['svn.revision']!}</p>
   

   • 语法说明：!是Freemarker的空值保护符，避免因变量不存在导致模板渲染报错；svn.revision是Bamboo SVN插件自动存入的自定义构建数据键，对应检出的SVN版本号。

3. 如果上述变量不生效，可尝试以下备选方案：

   • 直接调用变更集的修订号字段：

     <p>SVN 检出版本号: ${build.changeset.revision!}</p>
     

   • 针对多SVN仓库/多变更的场景，遍历所有变更集：

     <#if build.changesets?has_content>
       <p>SVN 检出版本号列表:</p>
       <ul>
         <#list build.changesets as changeset>
           <li>${changeset.revision!}</li>
         </#list>
       </ul>
     </#if>
     

4. 保存模板后，触发一次构建并检查邮件通知，确认版本号已正确显示。

为什么${buildSummary.revision}不生效？ #

buildSummary对象的revision字段通常指向Bamboo内部的构建版本标识（如构建编号），而非SVN仓库的具体修订号，因此无法获取到你需要的SVN检出版本信息。

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