手动添加迁移

前提条件

已成功登录鲲鹏DevKit。

操作步骤

1. 在页面左侧，选择“系统迁移”单击“”进入“新建工程”页签。
   图1 基本配置
   
2. 填写“迁移工程名称”。工具默认会自动生成工程名称，也可根据实际情况进行自定义修改。

   名称需要满足如下要求：

   • 只能由中文、字母、数字和下划线组成。
   • 长度为1~64个字符。
3. “迁移场景”选择“手动添加迁移”。
4. 选择“迁移工程节点”，最多支持选择20个节点，可按照节点IP地址或名称进行搜索。若节点不存在可单击“添加节点”，添加迁移工程节点，具体操作可参考Agent管理。
5. 节点选择完成后单击“配置迁移成分”。请在“成分选型表”配置需要迁移的成分信息，支持以下两种方式：
   图2 配置迁移成分
   
   • 手动添加：可手动添加容器和非容器成分信息。
     1. 单击“手动添加”。
     2. 填写成分信息，参数如表1和表2所示。

        表1 非容器成分信息

        参数	说明
        容器迁移	是否为容器迁移。
        成分归属	成分归属，仅支持“数据库”、“中间件”、“应用”。
        所属节点	成分所属节点。
        源成分
        源成分名	需要迁移的源成分名称。
        版本号	源成分的版本号，仅支持数据库、中间件。
        源成分来源	选择源成分来源，仅支持中间件、应用。 说明： 若源成分名为Redis，则请参见Redis源成分打包进行打包；若源成分名为Nginx，则请参见Nginx源成分打包进行打包。 节点服务器获取：从所属节点的指定路径下获取源成分包，进行扫描分析，并生成迁移指导报告。若成分归属为“中间件”，请按照如下步骤进行操作。 将待扫描的源成分对应安装目录打包为压缩包，以tar.gz格式压缩包为例，压缩包名称及源成分对应目录请根据实际情况替换。 1 tar cvf xxx.tar.gz /xxx/xxx/xxx 使用SSH远程登录工具，将压缩包文件上传至节点服务器的自定义路径。 执行如下命令，进入保存压缩包文件的自定义目录。 1 cd 自定义路径 执行如下命令解压源成分压缩包，压缩包名称请根据实际情况替换。 1 tar xvf xxx.tar.gz 解压完成，可选择执行如下命令删除源成分压缩包。 1 rm -f xxx.tar.gz 指定解压后的文件路径为源成分所在路径。 源成分包上传：上传迁移源成分包进行扫描分析，并生成迁移指导报告。若成分归属为“中间件”，请按照如下步骤进行操作。 将待扫描的源成分对应目录打包为压缩包，以tar.gz格式压缩包为例，压缩包名称及源成分对应目录请根据实际情况替换。 1 tar cvf xxx.tar.gz /xxx/xxx/xxx 上传源成分压缩包文件。 无源成分：不提供源成分包，也不进行迁移指导分析（仅中间件支持该选项）。
        源成分所在路径	需要输入源成分在所属节点中路径。 说明： “源成分来源”选择“节点服务器获取”时显示该参数。
        源成分安装路径	需要输入源成分的安装路径。 说明： “成分归属”为“中间件”且“源成分来源”选择“源成分包上传”时显示该参数。
        源成分包上传	单击“上传”，上传所需的源软件包，格式为：zip、tar、tar.gz。 说明： “源成分来源”选择“源成分包上传”时显示该参数。
        目标成分
        目标成分名	需要迁移至的目标成分名称。
        目标成分来源	选择目标成分来源，仅支持数据库、中间件。 外网地址下载：从所属节点可访问的URL地址下载目标成分包，并进行自动化安装。 节点服务器获取：从所属节点的指定路径下获取目标成分包，并进行自动化安装。 访问安装包下载地址，获取目标成分的安装包文件。 https://mirrors.huaweicloud.com/kunpeng/archive/Kunpeng_Middleware/ 使用SSH远程登录工具，将安装包文件上传至节点服务器的自定义路径。 指定安装包文件所在路径为目标成分所在路径。 目标成分包上传：上传迁移目标成分包至DevKit节点，并进行自动化安装。 访问安装包下载地址，获取目标成分的安装包文件。 https://mirrors.huaweicloud.com/kunpeng/archive/Kunpeng_Middleware/ 上传目标成分安装包文件。
        外网地址	迁移目标外网地址。 说明： “目标成分来源”选择“外网地址下载”时显示该参数。
        目标成分所在路径	目标成分在所属节点中路径。 说明： “目标成分来源”选择“节点服务器获取”时显示该参数。
        目标成分包上传	单击“上传”，上传所需的目标软件包，格式为：zip、tar、tar.gz。 说明： “目标成分来源”选择“目标成分包上传”时显示该参数。
        商用证书	单击“上传”，上传所需的商用证书。

        表2 容器成分信息

        参数	说明
        容器迁移	是否为容器迁移。
        成分归属	成分归属，仅支持“中间件”、“应用”。
        所属节点	成分所属节点。
        源成分
        源成分名	需要迁移的源成分名称。
        版本号	源成分的版本号，仅支持中间件。
        源成分来源	选择源成分来源： Dockerfile（中间件默认已勾选） Image
        Dockerfile	单击“上传”，上传所需的Dockerfile文件。
        Image来源	节点服务器获取：从所属节点的指定路径下获取Image文件，进行扫描分析，并生成迁移指导报告。 Image上传：上传Image文件进行扫描分析，并生成迁移指导报告，若文件大小超过上限（默认2048MB）请使用“节点服务器获取”。 说明： “源成分来源”选择“Image”时显示该参数。
        Image	单击“上传”，上传所需的Image文件。 说明： “Image来源”选择“Image上传”时显示该参数。
        目标成分
        目标成分名	显示目标成分名称。
        目标成分来源	显示目标成分的来源。

     3. 填写完成后单击“确定”。
   • 通过Docker Compose导入：通过解析Docker Compose文件，可以获取文件中支持迁移的容器成分。
     

     Docker Compose是一个用于定义和运行多容器应用程序的工具。它是解锁精简高效的开发和部署体验的关键。Compose简化了对整个应用程序堆栈的控制，使您可以在一个简单易懂的YAML配置文件中管理服务、网络和卷。

     1. 单击“通过Docker Compose导入”。
     2. 请上传Docker Compose文件并选择“所属节点”。
     3. 单击“分析”。
     4. 导入解析出的成分后，可单击“操作”列“编辑”按钮完善配置信息，详见表3。

        表3 Compose成分信息

        参数	说明
        容器迁移	是否为容器迁移。
        成分归属	成分归属，仅支持“中间件”、“应用”。
        所属节点	成分所属节点。
        源成分
        源成分名	迁移的源成分名称。
        源成分来源	显示导入的Docker Compose文件。
        以下配置属于高级配置，可为迁移操作提供更加详尽的指导。
        Dockerfile	单击“上传”，上传所需的Dockerfile文件。
        Image来源	节点服务器获取：从所属节点的指定路径下获取Image文件，进行扫描分析，并生成迁移指导报告。 Image上传：上传Image文件进行扫描分析，并生成迁移指导报告，若文件大小超过上限（默认2048MB）请使用“节点服务器获取”。
        Image	若“Image来源”选择“节点服务器获取”，请输入Image文件在所属节点中的路径。 若“Image来源”选择“Image上传”，请单击“上传”，上传所需的Image文件。
        env_file	单击“上传”，上传所需的env_file文件。
        挂载卷来源	节点服务器获取：从所属节点的指定路径下获取挂载卷文件，进行扫描分析，并生成迁移指导报告。 挂载卷上传：上传挂载卷文件进行扫描分析，并生成迁移指导报告，若文件大小超过上限（默认2048MB）请使用“节点服务器获取”。
        挂载卷	若“挂载卷来源”选择“节点服务器获取”，请输入挂载卷文件在所属节点中的路径。 若“挂载卷来源”选择“挂载卷上传”，请单击“上传”，上传所需的挂载卷文件。
        容器层来源	节点服务器获取：从所属节点的指定路径下获取容器层文件，进行扫描分析，并生成迁移指导报告。 容器层上传：上传容器层文件进行扫描分析，并生成迁移指导报告，若文件大小超过上限（默认2048MB）请使用“节点服务器获取”。
        容器层	若“容器层来源”选择“节点服务器获取”，请输入容器层文件在所属节点中的路径。 若“容器层来源”选择“容器层上传”，请单击“上传”，上传所需的容器层文件。
        Redis数据文件来源	节点服务器获取：从所属节点的指定路径下获取Redis数据文件，进行扫描分析，并生成迁移指导报告。 Redis数据文件上传：上传Redis数据文件进行扫描分析，并生成迁移指导报告，若文件大小超过上限（默认2048MB）请使用“节点服务器获取”。
        Redis数据文件	若“Redis数据文件来源”选择“节点服务器获取”，请输入Redis数据文件在所属节点中的路径。 若“Redis数据文件来源”选择“Redis数据文件上传”，请单击“上传”，上传所需的Redis数据文件。
        目标成分
        目标成分名	显示目标成分名称。
        目标成分来源	显示导入的Docker Compose文件。

6. 信任目标成分外网地址：目标成分来源若选择“外网地址下载”，请确认是否信任目标成分外网地址。

   若开启“信任目标成分外网地址”，则本次迁移任务的所有软件下载将跳过SSL证书认证，请确保外网地址是可信的下载链接。

7. 上传源码包：如需进行源码SQL扫描（支持DM数据库SQL兼容性评估）、非国密算法扫描，请上传所有需要的源码包。仅支持JAVA源码包和.Net源码包。
   1. 单击“上传”按钮，可拖动源码包至上传区域，或单击“添加文件”选择源码包上传至服务器，然后单击“上传”按钮上传。
   2. 可选：若“成分选型表”中选择数据库迁移，且需要扫描SQL的源码包，则建议配置数据定义语言（DDL）文件。DDL文件获取请参见导出数据库定义语言文件方法。
   

   • 支持上传tar、tar.bz、tar.bz2、tar.gz、tar.xz、tbz、tbz2、tgz、txz、zip格式的源码包，可同时上传多个源码包，单个源码包大小限制默认为2048MB。
   • 对于Dockerfile和Docker Compose文件，会识别文件中不支持Arm架构的语句，提供指导建议。对于文件的匹配规则请参见Dockerfile和Docker Compose白名单及替换名单使用说明。
   • 支持识别源码中驱动、依赖、Druid、JPA配置，提供Quick Fix修改建议。
8. 单击“开始迁移”，进入迁移实施界面。