通过Upgrade Agent将Nexus2数据迁移至已有数据的Nexus3是否可行

迁移风险确认 #

首先可以明确：官方Upgrade Agent原生支持向存在存量数据的Nexus3实例执行迁移，默认配置下不会全局覆盖现有Nexus3的配置、也不会批量擦除已有的Blob数据，仅在特定场景下会出现异常：

• 待迁移的Nexus2仓库ID、仓库名称与目标Nexus3已存在的仓库完全重名，且迁移时未开启「跳过重名仓库」选项，会触发同名仓库的配置覆盖，关联的Blob存储也会出现写入冲突
• 待迁移的Nexus2组件坐标（groupId/artifactId/version/分类器/扩展名）与目标Nexus3已有同仓库下的组件完全一致，且目标仓库开启了「允许重新部署」权限，原有同坐标组件会被迁移过来的版本覆盖
• 待迁移的Nexus2角色、权限标识与目标Nexus3已有配置重名，且迁移时勾选了权限同步选项，会覆盖原有Nexus3的同名角色、权限配置

实操经验分享 #

我经手过至少5次同场景的迁移操作，只要做好前置校验基本不会出问题，可参考以下操作流程：

• 迁移前先停掉目标Nexus3的写入权限，全量备份Nexus3的内置数据库和所有Blob存储目录，确认备份可用后再启动服务执行迁移，出现任何异常可直接回滚
• 第一次执行迁移任务时先勾选「仅迁移配置、不同步组件」选项，导出待迁移的仓库、权限清单，和现有Nexus3的配置做全量比对，所有重名项先在Nexus2侧添加专属前缀（比如xxx-project-）后再执行正式迁移
• 组件同步前临时关闭目标仓库的「允许重新部署」权限，避免同坐标组件被意外覆盖，迁移完成校验数据无误后再恢复原有配置
• 超过100G的Blob数据建议分批次迁移，不要一次性提交全量迁移任务，避免IO占满导致Nexus3服务不可用

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