tc-migrate 跨账号迁移 Skill#

腾讯云跨账号资源迁移工具，将源账号的云资源迁移到目标账号，通过 CCN 云联网实现网络互通。

核心流程 — 4 步：

text

① 配置 → ② 扫描 → ③ 生成 → ④ 部署

---

支持的资源类型#

资源类型KeyVPCvpcSubnetsubnetSecurity GroupsgCLBclbNAT GatewaynatCVMcvmCCN（自动创建）ccn

---

前提条件#

1. 安装依赖： bash

   pip install -r {baseDir}/requirements.txt
   
   

2. 安装 Terraform（>= 1.0）： bash

   # CentOS/RHEL
   sudo yum install -y yum-utils
   sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
   sudo yum -y install terraform
   
   # 验证
   terraform --version
   
   

3. 准备 account.yaml（在工作目录下）： yaml

   account_a:  # 源账号
     secret_id: "AKID..."
     secret_key: "..."
   account_b:  # 目标账号
     secret_id: "AKID..."
     secret_key: "..."
   region_a: "ap-beijing"
   region_b: "ap-guangzhou"
   
   

⚠️ 安全提醒：绝不要在对话中显示或记录密钥值！

---

Step 1: 全自动配置#

bash

# 基本用法（推荐）
python3 {baseDir}/main.py config auto --skip-empty-vpc

# 生成密钥模板（如果没有 account.yaml）
python3 {baseDir}/main.py config account-init

生成文件： tc-migrate.yaml

---

Step 2: 资源扫描#

bash

# 扫描并保存（推荐）
python3 {baseDir}/main.py scan --save --skip-empty-vpc

# 仅预览
python3 {baseDir}/main.py scan

更新文件： tc-migrate.yaml（追加 resources 配置）

💡 config auto 默认自动扫描，可跳过此步。

---

Step 3: 生成 Terraform 变量文件#

bash

# 生成 tfvars（推荐）
python3 {baseDir}/main.py generate --force

# 仅预览
python3 {baseDir}/main.py generate --preview

生成文件： {baseDir}/terraform/terraform.tfvars

---

Step 4: 执行迁移#

bash

# 执行迁移（会在 apply 前确认）
python3 {baseDir}/main.py run

# 跳过确认
python3 {baseDir}/main.py run -y

内部流程：generate → init → plan → apply

---

常见场景#

场景 1：完整首次迁移#

bash

python3 {baseDir}/main.py config account-init     # 1. 生成密钥模板
# 编辑 account.yaml 填入密钥
python3 {baseDir}/main.py config auto --skip-empty-vpc  # 2. 配置 + 扫描
python3 {baseDir}/main.py generate                # 3. 生成 tfvars
python3 {baseDir}/main.py run                     # 4. 执行迁移

场景 2：增量变更#

bash

# 修改 tc-migrate.yaml 后
python3 {baseDir}/main.py generate
python3 {baseDir}/main.py plan
python3 {baseDir}/main.py apply

场景 3：销毁资源#

bash

python3 {baseDir}/main.py destroy

---

重要提醒#

1. 绝不显示或记录密钥值
2. 执行 apply 前务必确认 plan 输出
3. CCN 安全配置已通过 Terraform 自动实现
4. 妥善保管 terraform.tfstate（包含敏感信息）

---

参考文档#

详细信息请查阅 {baseDir}/reference/ 目录：

文档内容installation.md安装指南commands.md完整命令参考file-structure.md文件结构和配置示例ccn-security.mdCCN 安全配置详解troubleshooting.md故障排查指南