批量迁移JFrog仓库至私有依赖库

背景信息

JFrog仓库是一个用于存储和管理软件包的中央存储库，提供了一种集中式的方式来管理软件包，支持各种软件包管理工具，如Maven、Gradle、npm、NuGet等。CodeArts Artifact的私有依赖库提供了批量迁移工具，支持将JFrog仓库迁移至私有依赖库。本节介绍如何批量迁移JFrog仓库至私有依赖库。

待迁移的JFrog仓库示例如图1所示。

图1 待迁移的JFrog仓库

准备工作

依赖Java运行环境，需要安装JRE，请参考安装JRE。

步骤一：获取私有依赖库地址与配置

1. 获取私有依赖库地址。
   1. 进入私有依赖库，选择“仓库视图”，并在左侧边栏中选择目标Maven私有依赖库。
   2. 单击仓库名称，右侧页面中仓库的“概览”页签中详细信息显示“仓库地址”。单击即可复制仓库地址。
      图2 获取私有依赖库地址
      

2. 获取私有依赖库配置。
   1. 单击页面右上方“操作指导”。
   2. 在“操作指导”对话框中单击“下载配置文件”，下载配置文件settings.xml至本地。
      图3 下载配置文件
      
   3. 在本地打开配置文件settings.xml，在文件中搜索并找到如下红框中的用户名与密码。

      

步骤二：配置迁移工具

1. 返回私有依赖库，单击页面右侧并在下拉列表选择“下载迁移工具”。
   图4 下载迁移工具
   

2. 将迁移工具MigrateTool.rar包下载到本地，并执行以下命令，将MigrateTool.rar包解压并进入解压后的目录中。

   unrar x MigrateTool.rar
   cd MigrateTool/

3. 用记事本打开MigrateTool.rar包解压后目录中的application.yaml文件，配置表1所示参数。

   表1 配置迁移工具参数

   参数名称	参数说明
   package_type	JFrog源仓库类型，配置为“maven”。
   repo_type	JFrog源仓库类型，配置为“jfrog”。
   domain	JFrog源仓库地址，例如“http://本地JFrog仓库IP:本地JFrog仓库端口/artifactory”。
   repo	需要迁移的JFrog源仓库名称，根据实际名称填写。
   user_name	登录JFrog源仓库的账号，根据实际情况填写。
   password	登录JFrog源仓库的密码，根据实际情况填写。
   target_repo_type	迁移后的目标仓库类型，配置为“artifactory”。
   target_domain	迁移后的目标仓库地址，配置为图5中“/artgalaxy/”前半段的的信息。
   target_repo	迁移后的目标仓库ID，配置为图5中“/artgalaxy/”后半段的的信息。
   target_user_name	迁移后的目标仓库账号，配置为从2.c中获取的username。
   target_password	迁移后的目标仓库密码，配置为从2.c中获取的password。

   图5 迁移后的目标仓库详细信息
   

步骤三：执行迁移

nohup java -jar /tools/relocation-jfrog.jar --spring.config.additional-location=./application-product.yaml > /log/relocation-jfrog.log 2>&1 &

图6 执行迁移

图6中“fail file”值为0时则表示迁移成功；否则迁移失败，可尝试重新执行迁移或联系客服寻求技术支持。

• 该命令会处于后台运行。
• /tools/relocation-jfrog.jar：指定迁移工具路径。
• --spring.config.additional-location=./application-product.yaml：指定配置文件路径。
• /log/relocation-jfrog.log：指定迁移工具执行日志路径，可通过该日志查看迁移情况。