TeamCity 10.0.4迁移至2022.04版本：保留构建配置但清除构建历史的可行方案咨询

我来分享几个经过验证的方案，帮你完成从TeamCity 10.0.4到2022.04的迁移，同时保留所有构建配置、清除历史记录：

方案一：导出/导入项目配置（最稳妥） #

这种方法完全剥离了构建历史，只迁移核心配置，完美匹配你的需求：

• 在旧TeamCity服务器上，针对每个项目操作：
  1. 进入项目的Settings页面，找到「Export Project」选项。
  2. 在导出设置中，只勾选「Project settings and build configurations」「VCS roots」（如果需要保留用户权限，也可以勾选「Users and groups」），务必取消所有和构建历史、日志、制品相关的选项。
  3. 导出后保存生成的.zip配置文件。如果项目数量多，推荐用TeamCity的REST API批量导出，能大幅提升效率。
• 安装并初始化新版TeamCity 2022.04：
  1. 完成服务器基础配置（数据库、数据目录等），确保服务器能正常启动。
  2. 进入新服务器的Administration页面，找到「Import Project」选项，逐个导入之前导出的配置文件。
• 验证：导入完成后，检查每个构建配置的VCS关联、构建步骤、参数是否和旧服务器一致，确认没有任何构建历史记录。

方案二：修改备份文件，排除构建历史后恢复 #

之前的备份恢复失败，大概率是备份文件包含了构建历史的关联数据，导致新版本无法兼容。可以按以下步骤调整：

• 重新在旧服务器创建精准备份：
  1. 进入Administration > Backup，点击「Run Backup」。
  2. 在备份选项中，只保留以下内容：
     • Server settings
     • Projects and build configurations
     • VCS roots
     • Users and groups（可选，根据需求）
  3. 取消勾选所有和构建历史相关的选项：Build logs、Build artifacts、Build history records、Statistics data等。
• 手动调整备份文件：
  1. 找到生成的备份.zip文件，解压后删除所有和构建历史相关的内容：比如builds目录、数据库备份脚本中涉及BUILD_*（如BUILD_HISTORY、BUILD_LOG）的SQL语句。
• 在新服务器完成恢复：
  1. 启动新版TeamCity，进入恢复流程，选择修改后的备份文件完成恢复。
  2. 启动服务器后，检查构建配置完整性，确认构建历史为空。

关键注意事项 #

• 迁移前务必在测试环境验证方案，避免影响生产环境。
• 新版本TeamCity可能对旧版本的某些插件或构建步骤有兼容性要求，迁移后如果遇到配置异常，检查是否需要更新对应的插件。
• 如果使用REST API批量操作，可以通过对应端点批量导出/导入项目，减少手动操作的工作量。

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