SuperAPI AI 工具集

teleport

部署与运维

查看项目

更新于 10-20 17:17

技能介绍

Teleport 是一个“全上下文迁移”技能,其核心定位不是局部转换,而是整体搬迁:数据、依赖、认证、流量路由、后台任务、密钥与人工工作流必须一起迁移并持续可用;同时旧系统在新系统被验证之前必须保持可恢复。资料将 Teleport 视为一种具有原型交付形态的混合型技能,规范参考输入为 Teleport(spell)。

用途

当用户描述需要把整个系统、服务或环境从一处移动到另一处,并保留状态与连续性时,应触发该技能。典型用途包括:数据库迁移(RDS→Cloud SQL、自管理→Atlas)、云厂商迁移(本地机房→AWS、Heroku→K8s)、环境晋级(staging→prod)、账号/租户整合、平台迁移(Jenkins→GitHub Actions、SendGrid→SES)、身份迁移(AD→Azure AD)、带迁移的集群升级。

主要能力与流程

  1. 先复述目标、成功条件与不可触碰的边界。
  2. 定义边界:识别源环境、目标环境,以及必须存活的五项不变量——数据完整性、认证、延迟/SLA、依赖图、回滚可行性;任一不变量未定义则停下询问。
  3. 盘点一切:列出所有必须迁移或重新连接的有状态面与依赖,包括数据库、缓存、队列、后台任务、密钥、DNS 记录、存储卷、CI/CD 流水线、监控告警、人工操作流程和第三方集成。
  4. 先设计安全网:在任何迁移计划之前,明确演练策略(在 staging 干跑)、切换窗口(时间、时长、审批人)、回滚路径( reversal 的具体步骤)、验证检查(如何证明到达成功)以及失败门(中途终止迁移的条件)。
  5. 编排迁移顺序:通常为复制数据→验证一致性→切换读流量→切换写流量→(观察期后)下线旧系统;输出带明确时间戳、负责人和 go/no-go 检查点的运行手册。
  6. 以交付物形式打包结果,并明确标注置信度、假设与未解决风险。

交付物

始终产出:(1) 含排序的迁移运行手册;(2) 带决策阈值的回滚计划;(3) 覆盖数据、流量、权限和依赖的到达后验证清单。

适用场景

适合需要保持状态与连续性的整体搬迁、平台替换、环境晋级、身份系统迁移和集群升级迁移等任务。

限制与护栏

在暗示迁移可完全投入运行之前,应先指出所需的粘合代码、权限或缺失的基础设施。若请求缺少回滚路径或缺少验证成功到达的方式,则只输出规划阶段,不进入执行步骤;在没有演练、备份和完整性验证步骤时,不得声称迁移是安全的。该技能不适用于:简单数据复制(单表、单文件),应使用数据提取类技能;格式转换(如 OpenAPI 2→3、Python→TypeScript),应使用翻译类技能;分支切换或 git 操作,应使用版本控制类技能;建立长期连接(VPN、隧道),应使用基础设施类技能;用同一配置做多环境部署,应使用部署类技能;功能开关或 A/B 测试,应使用实验类技能。

验证要点

检查结果是否包含上述每项承诺的交付物;区分已确认事实、假设与推断;区分具体行动与框架性描述,让用户能分辨哪些是当前真实可做的;在技能被视为就绪前,标注缺失的粘合代码、权限或后续工作。

调用示例

/teleport plan a full system migration from this source environment to that destination, including cutover, rollback, and post-arrival verification