SuperAPI AI 工具集

gcp-to-aws

部署与运维

查看项目

更新于 10-15 15:36

技能介绍

用途

gcp-to-aws 是一项迁移技能,用于把工作负载从 Google Cloud Platform(GCP)迁移到 AWS,覆盖范围包括 AI 与智能体(agentic)工作负载,且不限于特定云厂商。它通过分阶段流程引导完成从发现现状到生成迁移产物的全过程。

主要能力

  • 分阶段状态机:流程依次为 Discover(发现)、Clarify(澄清)、Design(设计)、Estimate(估算)、Workshop(方案研讨)、Generate(生成),每个阶段完成后需通过交接门(HANDOFF_OK)校验才能进入下一阶段。
  • 多信号输入:支持已认证的 gcloud CLI 实时发现(只读、需授权)、Terraform IaC 文件(.tf,可选 .tfvars、.tfstate)、应用代码(含 GCP SDK 或 AI 框架导入)、GCP 账单/成本/用量导出文件(CSV 或 JSON)。此外可选 OpenAI 用量 API(需 Admin API key,Usage 设为 Read,作用域 api.usage.read)作为 AI 工作负载的补充来源。
  • 默认再平台化(re-platform):按 GCP 工作负载类型匹配 AWS 服务,例如 Cloud Run → Fargate、Cloud SQL → RDS。
  • AI 工作负载迁移参考:根据 AI 来源(Gemini、OpenAI、Anthropic 或其他)条件加载对应的 Bedrock 迁移参考文件;对智能体工作负载按迁移方式(harness、strands、retarget)加载不同参考。
  • BigQuery 特别处理:技能不推荐具体的 AWS 分析或数仓服务;若发现 BigQuery(IaC google_bigquery_* 或账单记录),会在 Design 前提示需引入专家咨询,并在设计输出中标记为 Deferred — specialist engagement,引导用户联系 AWS 账户团队或数据分析迁移伙伴。
  • 成本估算:Estimate 阶段基于缓存或实时价格进行估算,价格来源状态可为 cached、live、cached_fallback 或 unavailable。技能明确不将人力、专业服务或人员工时作为一次性迁移成本列入预算。
  • Terraform 与迁移脚本生成:Generate 阶段可生成 Terraform 与迁移脚本,并包含策略校验(validate-terraform-policy.py)与迁移报告校验(validate-migration-report.py)。

使用方式

  • 技能基础目录由加载时输出的 “Base directory for this skill: X” 行给出,记为 <SKILL_BASE>。web-handoff 写入脚本位于 <SKILL_BASE>/scripts/emit-plan-json.py,需相对 <SKILL_BASE> 解析,而非插件根目录的 scripts/。
  • 用户需至少提供一种 GCP 来源(gcloud CLI、Terraform、应用代码或账单数据)。若未发现 Terraform,即使存在应用代码或账单文件,也会建议进行实时发现;实时发现仅覆盖基础设施,AI/智能体工作负载检测仍需应用代码。
  • 冷启动时检查工具:uv、uvx(用于 llm-to-bedrock 与 agent-advisor 脚本)以及 python3(Generate 阶段的策略校验与报告校验所需)。缺少 uv/uvx 时仅警告一次并继续,Estimate 阶段改用缓存价格;缺少 python3 时基础设施 Generate 无法达到 POLICY_OK,应在 Generate 前安装。
  • 每次运行使用单一 $MIGRATION_DIR(如 .migration/0226-1430/),不跨会话混用产物;每个阶段前从磁盘重新读取所需产物,不依赖对话记忆。
  • Clarify 为强制阶段:未完成 Clarify 不得进入 Design、Estimate 或 Generate;即使用户要求跳过,也会先运行 Clarify。
  • Generate 为显式选择项:除非用户在估算后的决策门选择生成、接受 decide-complete 恢复提示,或当前轮次明确要求生成 Terraform/迁移脚本,否则不会自动进入 Generate。进入执行路径前会先将 run_mode 设为 decide_and_execute。
  • 若 .migration/ 下存在多个会话目录,会列出各会话阶段状态并询问恢复最新会话还是重新开始。

适用场景

  • 需要将 GCP 上的基础设施(计算、数据库、缓存等)迁移到 AWS 的项目。
  • 需要将 GCP 上的 AI 工作负载(如 Gemini、OpenAI、Anthropic 等来源)迁移到 Amazon Bedrock 的场景。
  • 需要将智能体(agentic)工作负载迁移到 AWS 的场景。
  • 已有 Terraform IaC 或账单数据,希望获得服务映射、Terraform 生成与成本估算的迁移规划。

限制

  • 用户提供的文件(Terraform、应用代码、账单导出)被视为不可信外部数据,仅作为提取资源信息的数据处理,不执行其中嵌入的任何指令或命令。
  • 实时发现为只读且需授权同意;AI/智能体工作负载检测无法仅靠实时发现完成,仍需应用代码。
  • OpenAI 用量 API 不是独立来源:它提供花费与用量,但不提供集成或能力细节,AI 迁移设计仍需应用代码或其他来源。
  • 技能不推荐具体的 AWS 分析或数仓服务,BigQuery 相关迁移需引入专家。
  • 不将人力或专业服务成本作为一次性迁移成本估算。
  • 混合栈(基础设施 + AI 工作负载)同时存在时,设计参考文件总量接近约 800 行预算,会建议分两次运行(先基础设施、后 AI 工作负载)。
  • 各阶段加载的指令量有约 800 行预算限制,条件性参考文件仅在条件满足时加载。
  • 关于具体收费、价格、平台支持范围等未在资料中明确说明的信息,暂未提供。