Artifactory Pro v5.x过期实例迁移至最新版本的数据迁移方法咨询

前置准备 #

• 确认旧实例可用性：尽管许可证过期，旧Artifactory通常会进入只读模式，足够完成数据导出。先检查关键制品、Docker镜像的存储目录，确保文件系统无损坏、可正常访问。
• 部署全新环境：按照最新版Artifactory的要求搭建好基础环境，暂不启动服务（或用临时许可证启动后暂停），确保新实例的存储配置（路径、存储类型）与旧实例匹配，或提前规划好目标存储位置。
• 全量备份旧实例：
  • 导出系统配置：在旧实例通过UI导出完整系统配置（包含仓库、权限、用户等核心设置），或使用命令jfrog rt export system（v5.x版本支持该命令）。
  • 备份二进制存储：直接拷贝旧实例的二进制文件目录（默认路径为$ARTIFACTORY_HOME/data/binaries），Docker镜像的层数据也存储于此。拷贝时建议用rsync工具，或通过md5sum校验文件完整性，避免拷贝损坏。
  • 备份数据库：若旧实例使用外部数据库（如MySQL、PostgreSQL），导出完整数据库备份；若为内置Derby数据库，直接备份$ARTIFACTORY_HOME/data/db目录。

迁移执行步骤 #

1. 停止新实例的Artifactory服务，防止数据写入冲突。
2. 恢复二进制存储：将备份的二进制目录完整拷贝至新实例的对应存储路径（如$NEW_ARTIFACTORY_HOME/data/binaries），确保目录权限与新实例运行用户一致。
3. 恢复数据库：
   • 外部数据库：提前创建好匹配的数据库和权限用户，导入旧数据库备份文件。
   • 内置Derby：直接替换新实例的data/db目录为备份的旧数据库目录。
4. 导入系统配置：启动新实例后，通过UI上传之前导出的配置文件，或执行jfrog rt import system导入配置，确保仓库结构、权限规则、用户信息完全恢复。
5. 激活新许可证：在新实例UI中输入购买的最新版Artifactory许可证，完成激活。

数据验证 #

• 检查所有仓库（包括Docker仓库）是否正常加载，结构与旧实例一致。
• 随机抽取关键制品和Docker镜像，下载后对比MD5/SHA256校验和，确认文件完整性。
• 测试Docker镜像的拉取、推送功能，验证流水线集成是否正常工作。
• 检查用户权限、组配置是否与旧实例完全匹配。

注意事项 #

• 迁移前必须在测试环境完整演练一遍，确认流程可行后再操作生产环境。
• 若新旧实例使用不同存储类型（如旧实例本地存储，新实例用S3），需在迁移完成后配置新存储，并将二进制数据迁移至新存储位置。
• v5.x到最新版版本跨度较大，部分配置格式可能有变更，导入配置后需核对关键配置项，参考官方版本升级文档调整。
• 迁移期间建议停止旧实例服务，避免只读模式下的意外数据变更。

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