兼容性与工具配置说明
最近更新时间: 2025-02-18 16:02:00
支持的操作系统
目前在线迁移工具支持的源端主机操作系统包括但不限于以下操作系统:
Linux 操作系统 | Windows 操作系统 |
---|---|
CentOS 5/6/7/8 | Windows Server 2008 Windows Server 2012 Windows Server 2016 Windows Server 2019 Windows Server 2022 |
Ubuntu 10/12/14/16/18/20 | |
Debian 7/8/9/10 | |
SUSE 11/12/15 | |
openSUSE 42 | |
Amazon Linux AMI | |
Red Hat 5/6/7/8 | |
Oracle Linux 5/6/7/8 |
支持的迁移模式
公网迁移模式
如果您的源端主机和目标云服务器都具有公网访问能力,则可以使用公网迁移模式进行迁移。
在目前的公网迁移模式中,工具的控制链路通过互联网访问云平台的 API 发起迁移请求,工具的数据链路通过互联网向目标云服务器传输数据,将源端主机迁移至云平台的目标云服务器。此模式对应的mode参数值为0。
内网迁移模式
如果您的源端主机或目标云服务器处于某个内网或 VPC 中,源端主机不能通过互联网直接与目标云服务器建立连接,则可以使用工具的内网迁移模式进行迁移。内网迁移模式需要通过使用如 VPC 对等连接、VPN 连接、或者 专线接入 等方式建立源端主机与目标云服务器的连接通道。
- 场景1:(该场景仅支持使用工具迁移)如果您的源端主机或目标云服务器不能访问公网,则可以先通过一台拥有公网访问能力的主机(如网关)以互联网方式访问云平台的 API 发起迁移请求(工具的控制链路),再通过内网通道向目标云服务器传输数据进行迁移(工具的数据链路)。此场景不要求对源端主机和目标云服务器具有公网访问能力。此场景对应的mode参数值为1。
- 场景2:如果您的源端主机可以访问公网,则可以先在源端主机上通过互联网访问云平台的 API 发起迁移请求(工具的控制链路),再通过内网通道向目标云服务器传输数据进行迁移(工具的数据链路)。此场景要求对源端主机具有公网访问能力,而目标云服务器则不要求。此场景对应的mode参数值为2。
- 场景3:如果您的源端主机可以通过Http代理访问公网,则可以先在源端主机上通过网络代理访问云平台的 API 发起迁移请求(工具的控制链路),再通过内网通道向目标云服务器传输数据进行迁移(工具的数据链路)。此场景不要求对源端主机和目标云服务器具有公网访问能力。此场景对应的mode参数值为3。
压缩包文件说明
go2cloud.zip
解压后,文件说明如下:
文件名 | 说明 |
---|---|
go2cloud-linux.zip | Linux 系统的迁移压缩包。 |
go2cloud-windows.zip | Windows 系统的迁移压缩包。 |
readme.txt | 目录简介文件。 |
release_notes.txt | 迁移工具变更日志。 |
go2cloud-linux.zip
解压后,文件说明如下:
文件名 | 说明 |
---|---|
go2cloud_x64 | x86架构64位 Linux 系统的迁移工具可执行程序。 |
go2cloud_x32 | x86架构32位 Linux 系统的迁移工具可执行程序。 |
go2cloud_arm64 | arm架构64位 Linux 系统的迁移工具可执行程序。 |
user.json | 迁移时的用户信息。 |
client.json | 迁移工具的配置文件。 |
rsync_excludes_linux.txt | rsync 配置文件,排除 Linux 系统下不需要迁移的文件目录。Windows系统因为是块级迁移,不支持文件和目录过滤。 |
go2cloud-windows.zip
解压后,文件说明如下:
文件名 | 说明 |
---|---|
go2cloud_x64.exe | x86架构64位 Windows 系统的迁移工具可执行程序。 |
user.json | 迁移时的用户信息。 |
client.json | 迁移工具的配置文件。 |
client.exe | Windows 系统的数据迁移可执行程序。 |
注意:
不能删除配置文件,并请将配置文件存放在和 go2cloud 可执行程序同级目录下。
user.json 文件参数说明
user.json 配置文件说明如下表:
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
SecretId | String | 否 | 账户 API 访问密钥 SecretId。 |
SecretKey | String | 否 | 账户 API 访问密钥 SecretKey。 |
Region | String | 否 | 目标云服务器的地域,只需填写地域,无需填写可用区。 |
InstanceId | String | 否 | 目标云服务器 CVM 的实例 ID,形如 ins-xxxxxxxx。(暂不支持轻量应用服务器) |
EndPoint | string | 否 | 目标环境的云API的EndPoint域名。 |
client.json 文件参数说明
client.json 配置文件部分说明如下表:
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
Client.Extra.IgnoreCheck | Bool | 否 | 默认值为 false,迁移工具默认在工具开始运行时自动检查源端主机环境,如果需要略过检查,请设置为 true。也可以直接使用工具的-ignore-check启动参数触发。 |
Client.Extra.Daemon | Bool | 否 | 默认值为 false,如果需要迁移工具后台运行,请设置为 true。也可以直接使用工具的-daemon启动参数触发。 |
Client.Net.Proxy.Ip | String | 否 | 默认值为空,若迁移场景为内网迁移 场景3 时,需要配置网络代理的 IP 地址。也可以直接使用工具的-proxy-ip启动参数传递IP值。 |
Client.Net.Proxy.IPv6 | Bool | 否 | 默认值为 false,若您期望使用 IPv6(例如迁移场景中源端或对端只有 IPv6 IP 的情况下)传输数据,需要您将此选项设置为 true,否则,迁移流量将通过 IPv4 传输。 |
Client.Net.Proxy.Port | String | 否 | 默认值为空,若迁移场景为内网迁移 场景3 时,需要配置网络代理的端口。也可以直接使用工具的-proxy-port启动参数传递端口值。 |
Client.Net.Proxy.User | String | 否 | 默认值为空,若迁移场景为内网迁移 场景3 ,且您的网络代理还需认证时,需要配置网络代理的用户名。也可以直接使用工具的-proxy-user启动参数传递用户名。 |
Client.Net.Proxy.Password | String | 否 | 默认值为空,若迁移场景为内网迁移 场景3 ,且您的网络代理还需认证时,需要配置网络代理的密码。也可以直接使用工具的-proxy-password启动参数传递密码值。 |
说明:
client.json 文件配置项通常无需填写。
rsync_excludes_linux.txt 文件说明
排除 Linux 源端主机中不需要迁移传输的文件,或指定目录下的配置文件。该文件中已经默认排除以下目录和文件,请勿删改。
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
如果您需要排除其他目录和文件,请在该文件尾部追加内容。例如,排除挂载在 /mnt/disk1
的数据盘的所有内容。
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
/mnt/disk1/*
工具运行参数说明
参数选项 | 说明 |
---|---|
--help | 打印帮助信息。 |
--check | 检查源机器是否满足迁移,仅做检查不迁移。 |
--log-file | 设置日志文件名称,默认为 log。 |
--log-level | 日志输出级别,取值范围为1(ERROR 级别),2(INFO 级别)和3(DEBUG 级别),默认值为2。 |
--version | 打印版本号。 |
--clean | 使目的机器退出迁移模式,并清理还原工具配置文件。 |
-secret-id | 云API访问密钥SecretId。 |
-secret-key | 云API访问密钥SecretKey。 |
-region | 需要迁移到的目的地域。 |
-instance-id | 迁移为实例时,需要迁移到的目的实例ID。 |
-out-image-name | 迁移为镜像时,镜像名称。 |
-remote-ip | 目的机器ip,默认自动从云api获取不需要指定。 |
-mode | 默认值为0。0为走公网传输数据,2为源端可以直接连接公网时但走内网传输数据,3为借助http代理访问公网然后数据走内网传输数据。 |
-dest-subnet-id | 使用内网模式迁移为镜像时,已打通内网的子网ID。 |
-dest-vpc-id | 使用内网模式迁移为镜像时,已打通内网的VPC ID。 |
-transit-image-id | 使用内网模式迁移为镜像时,中转实例的镜像ID。 |
-ignore-check | 迁移时跳过检查,直接迁移。 |
-console | 自动创建任务进行迁移,无需在控制台手动创建任务。 |
-no-console | 不依赖控制台进行迁移,此时控制台上看不到任务。 |
-proxy-ip | 当借助http代理内网迁移时,设置http代理ip。 |
-proxy-port | 设置http代理端口。 |
-proxy-user | 设置http代理用户名。 |
-proxy-password | 设置http代理密码。 |
-disable-cloud-init | 迁移后不对机器安装cloud-init。仅在Linux迁移有效。 |
-disable-cloud-init-network | 设置迁移后不让cloud-init初始化网络配置。仅在Linux迁移有效。 |
-preserve-hostname | 迁移后保留原hostname。仅在Linux迁移有效。 |
-preserve-hosts | 迁移后保留原hosts。仅在Linux迁移有效。 |
-preserve-dns | 迁移后保留原dns。仅在Linux迁移有效。 |
-preserve-mirrors | 迁移后保留原软件源。仅在Linux迁移有效。 |
-preserve-ntp | 迁移后保留原ntp。仅在Linux迁移有效。 |
-bandwidth-limit | 设置限速带宽,单位是KB/s。仅在Linux迁移有效。 |
-incremental-time | 设置持续保持增量同步的时间,单位是分钟。 |
-minify | 允许迁移至磁盘空间更小的目的机器上,适用于迁移时缩容。 |
-blocktest | 测试是否可以进行块迁移。 |
-inject-virtio-skip | Windows下跳过Virtio驱动自动安装。 |
-skip-inet-ip-checker | 当保持内网ip不变迁移时,跳过内网ip的检查。 |
迁移失败指引
在控制台服务器迁移操作后,会因为一些原因导致任务失败。在任务失败的情况下,您可以在 在线迁移控制台 查看错误码,并根据以下内容进行排查。
错误码 | 错误说明 | 指引 |
---|---|---|
`ERROR_REMOTE_INSTANCE_STATUS_NOT_VALID` | 当前迁移目标实例状态不允许迁移 | 仅支持运行中和已关机的实例作为迁移目标实例。 |
`ERROR_SAME_INSTANCE` | 源实例和目标实例相同,不允许迁移 | 请更换目标实例后重新发起迁移任务。 |
`ERROR_NO_IPV6` | 目标实例 IPV6 地址缺失 | 目标实例没有 IPv6 地址,您可以使用 IPv4 地址进行迁移。 |
`ERROR_NO_PUBLIC_IP` | 目标实例没有公网 IP,无法使用公网模式迁移 | 目标实例没有公网 IP,无法使用公网模式迁移,您可以将云上的目标实例分配一个弹性公网IP,或者使用内网模式迁移。 |
`ERROR_SAME_IP` | 内网迁移模式下,源实例内网 ip 和目标实例内网 ip 相同,无法建立连接 | 您可以采用公网模式进行迁移;或者更换目标实例的内网 IP。 |
`ERROR_OS_NOT_MATCH` | Windows 与 Linux 实例不能互相迁移 | Windows 系统的实例只能迁移到 Windows 实例上。Linux 系统的实例只能迁移到 Linux 的实例上。您可以更换目标实例重新迁移。 |
`ERROR_INSTANCE_TYPE_NOT_SUPPORTED` | 目标实例的实例类型暂不支持作为迁移目标 | 方法一:您可以将迁移目标设置为镜像,得到自定义镜像后,再选择您需要的实例类型基于此自定义镜像创建实例。 方法二:您可以先迁移到另一台支持的类型(例如标准型 SA5 等)的实例上,迁移后创建自定义镜像,再选择您需要的实例类型基于此自定义镜像创建实例。 |
`ERROR_SEC_GROUP_PORT_NOT_OPEN3` | 目标实例安全组80、443、3389端口未开放 | 您可在私有网络 > 安全 > 安全组控制台开放您相应的安全组端口。 |
`ERROR_ADD_MORE_DISK` | 目标实例数据盘数量不够 | 您可以增加目标实例的数据盘数量,以达到迁移的要求。 |
`ERROR_SYSTEM_DISK_SIZE_NOT_ENOUGH` | 目标实例系统盘空间不足 | 您可以扩容系统盘,以达到迁移的要求。 |
`ERROR_ENTER_MIGRATE_MODE` | 目标实例进入迁移模式失败 | 请您联系客服协助。 |
`ERROR_HOST_TO_HOST_CONNECTION` | 迁移源无法连接到目标实例 | 请您联系客服协助。 |
`ERROR_INIT_SERVER` | 初始化目标服务器失败 | 请您联系客服协助。 |
`ERROR_DATA_TRANSMISSION` | 数据传输失败 | 请您联系客服协助。 |