tc-migrate 跨账号迁移 Skill

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

核心流程 — 4 步：

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

支持的资源类型

vpc

subnet

sg

clb

nat

cvm

ccn

前提条件

1. 安装依赖：

   pip install -r {baseDir}/requirements.txt
   

2. 安装 Terraform（>= 1.0）：

   # 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

   （在工作目录下）：

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

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

Step 1: 全自动配置

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

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

生成文件：

tc-migrate.yaml

Step 2: 资源扫描

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

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

更新文件：

tc-migrate.yaml

resources

💡

config auto

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

Step 3: 生成 Terraform 变量文件

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

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

生成文件：

{baseDir}/terraform/terraform.tfvars

Step 4: 执行迁移

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

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

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

常见场景

场景 1：完整首次迁移

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：增量变更

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

场景 3：销毁资源

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.md

troubleshooting.md