手动添加迁移

前提条件

• 已成功登录鲲鹏DevKit。
• 已完成迁移源成分准备，具体操作请参见迁移源成分准备。

注意事项

• 同一节点迁移任务结束后，支持在该节点新建迁移任务。
• 已被其他工程占用的节点，可等待占用工程结束后自动释放节点或删除占用工程后重新选择节点。
• 同一节点下的成分不能迁移到相同的目标成分。

操作步骤

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

   名称需要满足如下要求：

   • 只能由中文、字母、数字和下划线组成。
   • 长度为1~64个字符。
3. “迁移场景”选择“手动添加迁移”。
4. 选择“迁移工程节点”，最多支持选择20个节点，可按照节点IP地址或名称进行搜索。若节点不存在可单击“添加节点”，添加迁移工程节点，具体操作可参考Agent管理。
   

   手动添加迁移支持添加本机节点（即当前登录的DevKit节点）为迁移工程节点。

5. 节点选择完成后单击“配置迁移成分”。请在“成分选型表”配置需要迁移的成分信息，支持以下两种方式：
   图2 配置迁移成分
   
   

   界面会根据所选择的迁移内容实时显示预计的迁移时长，用户可根据实际情况调整迁移计划。

   • 手动添加：可手动添加容器和非容器成分信息。
     1. 单击“手动添加”。
     2. 填写成分信息，参数如表1和表2所示。

        表1 非容器成分信息

        参数	说明
        容器迁移	是否为容器迁移。
        成分归属	成分归属，仅支持“数据库”、“中间件”、“应用”。
        所属节点	成分所属节点。
        源成分
        源成分名	需要迁移的源成分名称。
        版本号	源成分的版本号，仅支持数据库、中间件。
        源成分来源	选择源成分来源，仅支持中间件、应用。 说明： 中间件除RabbitMQ外，其余源成分请参见迁移源成分准备进行打包。 节点服务器获取：从所属节点的指定路径下获取源成分包，进行扫描分析，并生成迁移指导报告。若成分归属为“中间件”，请按照如下步骤进行操作。 将待扫描的源成分对应安装目录打包为压缩包，以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。 说明： “源成分来源”选择“源成分包上传”时显示该参数。
        目标成分
        目标成分名	需要迁移至的目标成分名称。
        目标成分来源	选择目标成分来源，仅支持数据库、中间件。 外网地址下载：默认从鲲鹏镜像仓下载目标成分包，并自动化安装。 节点服务器获取：从所属节点的指定路径下获取目标成分包，并进行自动化安装。 访问鲲鹏镜像仓，获取目标成分的安装包文件。 使用SSH远程登录工具，将安装包文件上传至节点服务器的自定义路径。 指定安装包文件所在路径为目标成分所在路径。 目标成分包上传：请单击下方提示信息中“成分包来源”，获取目标成分包。
        外网地址	迁移目标外网地址。 说明： “目标成分来源”选择“外网地址下载”时显示该参数。
        目标成分所在路径	目标成分在所属节点中路径。 说明： “目标成分来源”选择“节点服务器获取”时显示该参数。
        目标成分包上传	单击“上传”，上传所需的目标软件包，格式为：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. 单击“开始迁移”，进入迁移实施界面。