TeamCity升级后邮件模板还原及EC2文件更新任务配置咨询

• 升级前备份自定义模板：进入TeamCity后台「Administration」→「Notification Templates」，选中自定义模板后点击「Export」，将模板保存为XML文件。
• 升级后重新导入模板：完成服务器升级后，回到模板管理界面，点击「Import」选择之前导出的XML文件，重新导入自定义模板。
• 迁移模板至安全存储目录：将自定义模板移至TeamCity数据目录下的config/_notifications文件夹，该目录下的文件在升级过程中不会被覆盖，修改后重启TeamCity服务生效。
• 排查升级日志：若问题反复出现，查看TeamCity升级日志（默认路径logs/upgrade.log），确认模板文件被覆盖的具体原因，排查配置冲突。

可行，具体操作步骤如下：

核心思路 #

通过TeamCity构建任务拉取GitHub仓库的邮件模板，再借助AWS工具将文件同步到目标EC2实例。

具体操作步骤 #

1. 配置GitHub仓库连接

   • 在TeamCity项目中添加Git类型的VCS根，填入GitHub仓库URL，配置SSH密钥或个人访问令牌作为凭据，确保能正常拉取代码。
   • 设置触发规则，比如当GitHub指定分支（如main）有新提交时自动触发构建。

2. 配置AWS权限

   • 给TeamCity服务器或构建代理配置AWS访问密钥（AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY），可通过TeamCity「Secure Parameters」存储敏感信息，避免明文暴露。
   • 确保该AWS密钥拥有访问目标EC2实例的权限（如SSM管理权限、SFTP传输权限）。

3. 选择文件同步方式

   方式一：使用AWS SSM Run Command #

   • 添加「Command Line」类型的构建步骤，执行以下操作：
     1. 拉取GitHub仓库的最新模板文件到构建代理本地。
     2. 执行aws ssm send-command命令将文件同步到EC2实例目标路径，示例命令：

        aws ssm send-command \
          --instance-ids i-xxxxxx \
          --document-name AWS-RunShellScript \
          --parameters commands="cp ${teamcity.build.checkoutDir}/templates/email-template.html /opt/teamcity/templates/" \
          --output text
        

   • 前提：目标EC2实例已激活SSM Agent，且在AWS SSM管理范围内。

   方式二：使用SFTP直接传输 #

   • 在构建代理上安装SFTP客户端（如lftp），添加「Command Line」构建步骤执行传输命令：

     lftp -u ec2-user -p 22 sftp://ec2-xx-xx-xx-xx.compute-1.amazonaws.com << EOF
     put ${teamcity.build.checkoutDir}/templates/email-template.html -o /opt/teamcity/templates/email-template.html
     bye
     EOF
     

   • 建议使用SSH密钥认证，将密钥存储在TeamCity安全参数中。

4. 验证同步结果

   • 添加构建后步骤，执行远程命令验证文件是否更新，示例：

     aws ssm send-command \
       --instance-ids i-xxxxxx \
       --document-name AWS-RunShellScript \
       --parameters commands="ls -l /opt/teamcity/templates/email-template.html" \
       --output text
     

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