Skip to content

Add comprehensive migration guides for major API gateways#926

Draft
ntotten wants to merge 1 commit intomainfrom
claude/migration-guides-api-gateways-PDmBZ
Draft

Add comprehensive migration guides for major API gateways#926
ntotten wants to merge 1 commit intomainfrom
claude/migration-guides-api-gateways-PDmBZ

Conversation

@ntotten
Copy link
Member

@ntotten ntotten commented Mar 19, 2026

Summary

Added comprehensive migration documentation for teams moving from Kong, Google Apigee, AWS API Gateway, and Azure API Management to Zuplo. This includes detailed concept mapping, step-by-step migration procedures, and policy translation examples for each platform.

Key Changes

  • New migration overview document (migration-overview.md) - Provides high-level reasons why teams migrate to Zuplo and a general migration approach applicable across platforms

  • Kong Gateway migration guide (migrate-from-kong.md) - Covers migration from Kong OSS, Konnect, and self-hosted deployments with:

    • Concept mapping table (services, routes, plugins, consumers, etc.)
    • Plugin-to-policy translation guide
    • Lua plugin to TypeScript conversion examples
    • DB-less mode to GitOps comparison
  • Google Apigee migration guide (migrate-from-apigee.md) - Addresses migration from Apigee X, hybrid, and legacy Edge with:

    • Concept mapping for proxies, policies, flows, and environments
    • XML policy to TypeScript translation examples
    • JavaScript callout conversion examples
    • KVM to environment variable migration
  • AWS API Gateway migration guide (migrate-from-aws-api-gateway.md) - Covers REST API, HTTP API, and WebSocket API migrations with:

    • Integration type mapping (Lambda, HTTP, Mock)
    • VTL template to TypeScript conversion
    • Lambda authorizer replacement strategies
    • Usage plan to rate limiting migration
  • Azure API Management migration guide (migrate-from-azure-apim.md) - Addresses APIM instance migrations with:

    • Policy mapping for XML-based Azure policies
    • C# expression to TypeScript conversion
    • Subscription key to API key migration
    • Named value to environment variable mapping
  • Updated sidebar navigation - Added new "Migration Guides" category to the API Gateway section with links to all migration documents

Notable Implementation Details

  • Each guide includes a "Why teams migrate" section highlighting pain points specific to that platform
  • Concept mapping tables provide quick reference for platform-specific terminology
  • Step-by-step procedures include both before/after code examples for policy and configuration translation
  • Guides emphasize that Zuplo works with existing backend infrastructure (no backend migration required)
  • All guides link to relevant Zuplo documentation for deeper dives into specific features

https://claude.ai/code/session_019Xc7mA1pHd5eP1dxLkVdw1

Create comprehensive migration documentation to help teams move from legacy
API gateways to Zuplo. Each guide includes concept mapping, policy translation
tables, step-by-step migration instructions, and code examples showing how to
convert platform-specific configs (Lua plugins, XML policies, VTL templates,
C# expressions) to Zuplo's TypeScript-based policies.

https://claude.ai/code/session_019Xc7mA1pHd5eP1dxLkVdw1
@vercel
Copy link

vercel bot commented Mar 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 19, 2026 0:37am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants