从Apigee Edge迁移至Apigee X的方案咨询

一、迁移前必做准备 #

• 先把你Edge环境里的所有资源列个完整清单：API代理、开发者应用、共享流、KVM（务必区分加密/非加密类型）、目标服务器、缓存配置，同时记录好各资源之间的依赖关系，避免迁移后出现断连
• 确认你的Apigee X环境已经部署完毕，相关权限配置到位（比如能创建代理、管理KVM的角色权限）
• 安装官方的apigee-migrate迁移工具，本地环境要保证有Java 8及以上版本，并且有Edge和Apigee X的API访问权限

二、核心资源迁移步骤 #

1. API代理与共享流 #

• 用迁移工具导出Edge上的代理或共享流：

  apigee-migrate export -t proxy -n <代理名称> -e <Edge环境名> -o ./exported-proxies
  

• 导出后一定要检查代理里的政策兼容性：比如Edge旧版的JavaScript政策语法、OAuthV1这类专属政策，需要调整成Apigee X支持的版本
• 导入到Apigee X：

  apigee-migrate import -t proxy -f ./exported-proxies/<代理名称>.zip -e <X环境名>
  

• 部署代理到X的环境后，先测基础流量是否正常，再逐步验证复杂逻辑

2. KVM（密钥值映射） #

• 非加密KVM直接用工具导出：

  apigee-migrate export -t kvm -n <KVM名称> -e <Edge环境名> -o ./exported-kvms
  

• 加密KVM工具没法直接导出加密值，得手动记录密钥名称，然后在Apigee X里重新创建加密KVM，手动录入对应的值
• 把非加密KVM导入X：

  apigee-migrate import -t kvm -f ./exported-kvms/<KVM名称>.json -e <X环境名>
  

• 迁移完记得验证，确保代理能正常读取KVM里的内容

3. 目标服务器与缓存 #

• 导出目标服务器配置：

  apigee-migrate export -t target-server -n <服务器名称> -e <Edge环境名> -o ./exported-targets
  

• 导入到Apigee X：

  apigee-migrate import -t target-server -f ./exported-targets/<服务器名称>.json -e <X环境名>
  

• 缓存配置：Edge的缓存参数可以通过API导出，然后在Apigee X控制台手动创建对应缓存，匹配好TTL、分区这些参数

4. 开发者应用 #

• 导出Edge上的应用和开发者信息：

  apigee-migrate export -t app -n <应用名称> -o ./exported-apps
  

• 导入到Apigee X：

  apigee-migrate import -t app -f ./exported-apps/<应用名称>.json
  

• 验证应用的API密钥、关联的产品是否正常，测试授权调用流程是否和Edge一致

三、迁移后验证工作 #

• 逐个测试API代理的功能，对比Edge和X的响应结果，确保逻辑完全一致
• 检查所有资源的依赖关系：比如代理调用共享流、读取KVM、访问目标服务器这些链路是否正常
• 开启Apigee X的日志监控，排查迁移后出现的错误或性能问题

内容的提问来源于stack exchange，提问作者Ashish Tripathi