Back to posts

Gateway API Migration — Helm Chart for Ingress to Gateway API

Read the full guide on docs.beyondyou.my.id
kubernetesgateway-apihelmnetworkinggkemigration

Migrating dozens of Ingress resources to Gateway API manually is error-prone. This guide presents a Helm chart that automates the migration — generating HTTPRoutes, HealthCheckPolicies, and GCPBackendPolicies for multiple applications from a single values file.

Without automation, teams forget HealthCheckPolicies, misconfigure section names, and leave stale Ingress resources behind. This chart enforces consistency and prevents common migration pitfalls.

Key Takeaways

  • Templated Helm chart generates Gateway API resources for N applications from one values file
  • HealthCheckPolicy and GCPBackendPolicy included by default — no forgotten security policies
  • Blue-green migration strategy with Ingress and Gateway API running in parallel

What’s Covered

SectionDescription
Helm ChartChart structure with templates for HTTPRoute, HealthCheckPolicy, GCPBackendPolicy
Values ConfigMulti-app configuration with per-service hostnames, ports, and health checks
Migration StrategyParallel Ingress + Gateway API with DNS-based traffic shifting
ValidationAutomated checks for route acceptance and health check status
RollbackQuick revert procedure if issues are discovered post-migration
CleanupPost-migration Ingress resource removal and annotation cleanup

Values File Example

apps:
  - name: api-gateway
    hostname: api.example.id
    port: 8080
    healthPath: /actuator/health
  - name: web-frontend
    hostname: www.example.id
    port: 3000
    healthPath: /healthz

Read the full guide: Gateway API Migration — Helm Chart for Ingress to Gateway API → — includes full Helm chart source code, migration playbook, and rollback procedures.