huawei-cloud-sms-migration-assistant

概述

辅助华为云 SMS（Server Migration Service）主机迁移操作。 主要步骤如下：

1. 高危操作禁止列表 — 牢记迁移过程中绝对不能执行的操作

2. 迁移前检查 — 网络连通性、源端资源水位、磁盘/OS 兼容性

3. API 迁移流程 — hcloud CLI + SMS API 完整流程

4. 迁移后启动修复 — 如果源端使用UEFI，需要使用helper ecs把内核替换成BIOS、网络配置、密码注入

5. 迁移后校验 — 目的端与源端一致性比对

6. 常见错误与修复 — 实战踩坑（SMS.0515/SMS.0007/SMS.6562 等） 如果迁移中遇到报错，首先参考 references/MIGRATION_REFERENCE.md错误目录，以及解决方案

核心原则

在不修改任何源端信息的情况下，将源端数据原封不动地安全复制到目的端。

1. 源端保护第一 — 源端严格只读，禁止任何增删改
2. 数据完整性 — 源端所有数据完整复制到目的端
3. 严格按输入创建目的端 — 不允许偏差或改动
4. 源端业务不变 — 迁移过程中源端业务状态保持不变
5. 命名规则强制 — 所有新创建的目的端 ECS 必须按 {hostname}_{MMDD} 命名

最关键风险点：源端保护

迁移过程中，源端必须严格只读。任何增删改操作都会导致致命后果。

• 禁止：数据库写入、文件上传/修改/删除、日志清空/新增、配置变更、应用重启、软件安装、用户添加/修改、权限变更、磁盘分区调整
• 后果：源端业务瘫痪 + 迁移失败 + 目的端数据不一致 + 无法恢复
• Agent 必须：定期检查源端磁盘/数据库/日志大小，发现任何变化立即停止迁移、回滚、通知用户

一、禁止执行的高危操作

级别一：数据丢失或迁移失败（绝对禁止）

源端保护

目的端保护

其他关键操作

级别二：迁移问题或额外成本

级别三：需注意

二、迁移前检查

1. 迁移前检查     →  python3 scripts/pre_migration_check.py --input migration_hosts.json

三、SMS Agent 安装

### 源端安装。如果以下目录里已有SMS Agent, 跳过安装步骤，请勿重复安装。
cd /root/SMS-Agent && bash ./startup.sh
### 交互输入：y / y / <AK> / <SK> / sms_domain / 0

如果是首次安装，第 5 步输入 sms_domain 字符串；重启输入 y 确认。传错会无限循环。

详细交互序列、非交互式安装、验证方法见 references/MIGRATION_REFERENCE.md A 节。

四、SMS API 迁移流程

4.1 流程概览

1. 解析 'migration_hosts.json' → 源端信息 vs 目的端信息
2. 查询目的端资源（VPC/子网/安全组/规格/镜像）
3. 创建模板（CreateTemplate）— 含 target_password
4. 创建任务（CreateTask）— 三个关键参数！
5. 启动（UpdateTaskStatus --operation=start）
6. 轮询（ShowTask）→ MIGRATE_SUCCESS
7. （跳过）割接（--operation=cutover）— 不允许割接或者删除源端主机。任务停留在割接前这一步，直到用户手动启动割接
8. 迁移后启动修复（第七节）— 如果主机无法启动，进行修复
9. 迁移后校验

如果删除任务，在下一次重建任务前要先重建迁移Template模版

输入数据严格性：必须按 'migration_hosts' JSON 创建目的端，禁止修改或猜测。有疑问先问用户。

4.2 网络类型与 EIP 规则

⚠️ VPN/专线 网络类型 EIP 规则（强制，违反即违规）

当 migration_hosts 中网络类型为 VPN/专线 时：

1. 创建模板（CreateTemplate）时禁止传入 --template.publicip.type / --template.publicip.bandwidth_size 等任何 publicip 参数 — SMS 服务会据此自动创建 EIP 并绑定到目的端 ECS，违反 VPN 网络类型不允许公网访问的安全要求
2. 迁移完成后（MIGRATE_SUCCESS 后），必须检查每台目的端 ECS 是否被绑定了浮动 IP — 即使模板未配 publicip，SMS 在跨云迁移场景下仍可能自动创建 EIP 用于中间传输
3. 如发现目的端 ECS 有浮动 IP，必须立即解绑并释放：

   # 解绑 EIP
   hcloud EIP DisassociatePublicips --cli-region=<region> --publicip_id=<eip_id> 
   # 释放 EIP
   hcloud EIP DeletePublicip --cli-region=<region> --publicip_id=<eip_id>
   

4. 此规则适用于迁移全生命周期：模板创建、任务执行、迁移后修复、清理阶段，任何阶段发现 VPN 场景下有 EIP 都必须清理
5. 根因：VPN/专线网络类型的主机通过私网与内网通信，公网 EIP 暴露攻击面，违反网络安全隔离要求

4.3 创建模板（CreateTemplate）— 关键必填参数

target_password 的真相：该参数设置 SMS 创建中间 ECS 时的密码。但全盘迁移完成后，源盘的 /etc/shadow 会覆盖中间 ECS 的密码 — 最终迁移盘上的密码是源端的，不是 target_password 设的值。因此必须在迁移后修复脚本中重新设置密码（见第七节修复项 6）。

完整命令见 references/MIGRATION_REFERENCE.md C.3 节。

4.4 创建任务（CreateTask）— 三个关键参数缺一不可

磁盘信息来源：hcloud SMS ShowServer 返回的 disks。

新建的目的端ECS 命名：--target_server.name={hostname}_{MMDD}（见如下命名规则）。

所有通过 SMS API 或修复流程创建的 ECS，命名格式：

{hostname}_{MMDD}

规则：

• {hostname} = Excel/JSON 中目的端主机名（如 server-01）
• 时间戳 = 创建时刻的 date +%m%d
• 辅助 ECS 也带时间戳：helper_{MMDD}
• 禁止使用 ecs-boot-fix、helper-ecs 等无时间戳名称
• 上传到 OBS 的文件名带更详细时间戳{YYYYMMDD_HHMMSS}
• SMS任务名称可以不带时间戳，用源端主机名命名任务即可

完整命令见 references/MIGRATION_REFERENCE.md C.4 节。

4.5 任务状态流转

READY → RUNNING → MIGRATE_FAIL / SYNCING / CUTOVER_READY
子任务：CREATE_CLOUD_SERVER → SSL_CONFIG → ATTACH_AGENT_IMAGE → FORMAT_DISK_LINUX_FILE → MIGRATE_LINUX_FILE

五、迁移后校验

• 源端无写操作：对比迁移前后 df -h、数据库/日志大小、mtime
• 目的端规格一致（CPU/内存/磁盘）/ OS 版本一致 / 网络连通 / 应用启动
• VPN/专线场景：目的端 ECS 无浮动 IP（见 4.2 节 EIP 规则）

详细校验命令见 references/MIGRATION_REFERENCE.md D 节。

六、常见错误速查

完整错误目录见 references/MIGRATION_REFERENCE.md E 节。

七、迁移后启动修复

MIGRATE_SUCCESS 不代表 ECS 可用。 AWS Ubuntu 迁移到华为云后通常遇到 5 个叠加问题：

判断标志

ECS ACTIVE + ARP 有 MAC + ping 不通 + SSH 超时 → 需要修复

修复流程（9 步）

修复脚本核心（Step 5）— 9 个修复项

在辅助 ECS 上 chroot 到迁移磁盘执行：

完整脚本见 references/MIGRATION_REFERENCE.md G 节。

Secure Boot 注意事项

华为云 ECS 可能启用 Secure Boot（Ubuntu 24.04 镜像）。此时：

• grub-install 生成无签名 EFI 二进制，Secure Boot 会拒绝 → 静默 halt
• 解决：安装 grub-efi-amd64-signed 包（需 chroot 内 DNS 可用），或通过华为云控制台关闭 Secure Boot
• BIOS 模式（i386-pc）不受 Secure Boot 影响，优先使用 BIOS GRUB

修复项根因

八、迁移完成后清理策略

不要删除华为云控制台上的 SMS 迁移任务和模板。

九、完整迁移流程速查

1. 安装 SMS Agent（源端）
   └─ startup.sh：y / y / AK / SK / sms_domain / 0

2. 获取源端信息
   └─ ListServers → source_server_id
   └─ ShowServer → disk_id, disk_size, pv_uuid, pv_size

3. 创建模板（CreateTemplate）
   └─ 必填：vpc.id + cidr + nics + security_groups + image_id + publicip + is_template + target_password
   └─ target_password 全盘迁移后会被源盘覆盖，需在修复脚本中重设

4. 创建任务（CreateTask）— 三个关键参数！
   └─ --syncing=false / --use_public_ip=false / --disks.1.disk_id=<src_disk_id>
   └─ ECS 命名：{hostname}_{MMDD}

5. 启动任务（UpdateTaskStatus --operation=start）

6. 轮询状态（ShowTask）→ MIGRATE_SUCCESS

7. 如果主机无法ping通，迁移后修复（第七节）
   └─ BIOS GRUB + 替换内核 + netplan(DHCP) + 99-net-ifnames.cfg + 禁用cloud-init + 设密码 + SSH

8. 清理（第八节）
   └─ 删辅助 ECS
   └─ 不删 SMS 任务和模板
   └─ VPN/专线场景：检查并释放目的端 ECS 的 EIP（见 4.2 节）

9. 检查目的端ECS是否根据ECS命名规则进行命名，如果不是，重新根据命名规则修改目的端ECS名称

十、前置条件

• Python 3.6+ / hcloud CLI 已配置 AK/SK 和 region
• 迁移前检查需能访问源端网络 / 迁移后校验需能访问目的端网络
• 目的端 VPC/子网/安全组信息从 Excel 表获取
• 任何疑问必须先问用户，确认无误再创建迁移任务

文件结构

sms-migration-assistant/
├── SKILL.md                          ← 本文件（流程概览 + 禁止操作 + 关键参数）
├── references/
│   └── MIGRATION_REFERENCE.md        ← 详细命令、脚本、错误目录、格式规范
├── scripts/
│   ├── pre_migration_check.py        ← 迁移前检查
│   └── post_migration_check.py       ← 迁移后校验
  

Example

input: migration_hosts.json 源端主机名: server-01 源端主机内网IP: 172.196.0.134 源端系统盘大小: 8GB 源端数据盘大小: 0 (如果为0，或者没有这个输入，不需要创建额外数据盘） 端口号： 22 用户名： ubuntu Key文件名: server-01key.pem 源端区域id: ap-southeast-1 源端区域名: Singapore 源端OS: ubuntu 网络类型: VPN 目的端主机名: server-01-{时间戳} 目的端系统盘大小: 40GB (目的端系统盘至少要和源端系统盘一样或者比它大） 目的端数据盘大小: 0 目的端区域id: ap-southeast-3 目的端VPC名: vpc-agent-84346077 目的端子网名: subnet-migration 目的端子网CIDR: 192.168.3.0/24 是否迁移至已有主机?: 否

migration template: Name: AgentMigration Region/Project: ap-southeast-3 Migration Method: File-level Network: Private Target Server: create new Start Target Upon Launch: Yes

server template: Template Name: AgentTemplate Region/Project: ap-southeast-3 AZ: AZ1 Disk: General purpose SSD VPC: vpc-agent-84346077 Subnet: subnet-migration Security group: sg-agent-84346077