无Nexus PRO许可证如何迁移现有Nexus 3 OSS文件系统Blobstore至S3存储桶

此前手动操作识别为空存储的核心原因 #

• 不同类型的Blob存储（文件系统/S3）并非仅靠metadata.properties中的type字段做识别校验，两类存储的内部目录结构、元数据映射规则、全局Blob索引逻辑完全独立。
• 仅把原有文件系统Blob的内容拷贝到S3桶、修改metadata.properties的type = file/1为type = s3/1的操作，会因为缺少S3 Blob适配的专属元数据节点、全局Blob ID映射索引，被Nexus判定为无有效内容的空存储，无法正常加载。
• 跨Blob存储同步的「组Blob存储」迁移能力本身是Nexus PRO版本的专属商业功能，OSS版本核心代码层就未开放该通路，不存在隐藏开启的方式。

无PRO权限的可行迁移方案 #

官方原生支持：仓库全量导出导入方案（零版本门槛） #

• 前置条件：提前在EC2节点部署好Docker容器化的目标Nexus OSS实例，完成S3 Blob存储的初始化配置，确认目标实例的网络可正常访问S3桶、可接收源实例的导出流量。
• 操作流程：
  • 在源文件系统Blob的Nexus实例中，暂停所有仓库的写入操作，避免迁移过程中产生增量数据。
  • 进入管理侧的仓库导出功能，选择需要迁移的所有托管、代理仓库，勾选「包含组件资产、仓库配置、关联权限」选项，将全量内容导出到本地临时目录。
  • 将导出的全量文件包拷贝到目标实例可访问的路径下，通过目标实例的仓库导入功能，将所有内容导入到绑定S3 Blob存储的对应仓库中。
  • 导入完成后，通过内置的仓库组件扫描功能，逐一校验各仓库的组件数量、资产下载可用性，确认数据无缺失后即可完成切换。

大存储场景：Blob层逐块同步方案 #

• 适用场景：Blob存储体积较大，全量导出导入效率偏低的情况。
• 操作逻辑：通过Nexus OSS原生开放的Blob读写API，遍历源文件系统Blob下的所有有效Blob块，严格按照S3 Blob的目录层级规则逐块写入到目标S3桶中，同步完成Blob元数据的重建，全程不依赖PRO版本的组存储能力。
• 操作注意事项：
  • 遍历同步时不能直接将原文件系统目录的原始文件全量拷贝到S3桶，必须严格匹配S3 Blob的固定目录结构和元数据格式。
  • 全量同步期间需要保持源实例为只读状态，避免新产生的Blob块导致数据不一致。
  • 所有Blob同步完成后，必须执行Nexus内置的Blob存储完整性校验，确认无缺失、损坏的Blob块后，再开放目标实例的写入权限。

操作避坑提示 #

• 禁止通过修改metadata.properties的类型字段实现Blob存储类型的强行切换，该操作会直接损坏Blob存储的元数据结构，导致组件资产无法被索引识别。
• 针对代理仓库的缓存类Blob，可选择不迁移全量缓存，在目标S3存储的实例上配置相同的远程仓库地址，待首次访问时自动拉取缓存内容，可大幅降低迁移阶段的数据传输量。

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