How kubernetes-sigs/ingress2gateway works
Ingress2gateway is a CLI that reads Kubernetes Ingress and provider-specific resources from a cluster or files, converts them through provider implementations into an intermediate representation, and emits Gateway API resources for stdout. Its main path runs from print through resource loading, provider conversion, and the selected emitter; reports surface unsupported or untranslated features. The README documents nine providers and six emitters. Several provider-specific feature modules are included as distinct conversion stages; unsampled provider details are represented by their enclosing source directory.
Main entry points: ingress2gateway.go Conversion runner · provider_intermediate/intermediate_representation.go Provider IR · emitter_intermediate/intermediate_representation.go Emitter IR · print.go Print command
Components 26
CLI and orchestration
- Program entry
main.go - Print command
cmd/print.go - Conversion runner
pkg/i2gw/ingress2gateway.go - Cluster or files
Input providers
- Provider selection
pkg/i2gw/provider.go - Resource readers
pkg/i2gw/providers
Conversion layers
- Common conversion
pkg/i2gw/providers/common/converter.go - Provider IR
pkg/i2gw/provider_intermediate/intermediate_representation.go - Provider-specific conversion
pkg/i2gw/providers - GCE conversion
pkg/i2gw/providers/gce/ir_converter.go - Istio conversion
pkg/i2gw/providers/istio/converter.go - Kong TCP ingress
pkg/i2gw/providers/kong/crds/tcpingress.go - NGINX gRPC feature
pkg/i2gw/providers/nginx/annotations/grpc_services.go - NGINX TLS feature
pkg/i2gw/providers/nginx/annotations/ssl_services.go - Traefik entrypoints
pkg/i2gw/providers/traefik/router_entrypoints.go - OpenAPI conversion
pkg/i2gw/providers/openapi3/converter.go - Emitter IR
pkg/i2gw/emitter_intermediate/intermediate_representation.go
Output emitters
- Common emitter
pkg/i2gw/emitters/common_emitter/emitter.go - Standard emitter
pkg/i2gw/emitters/standard/standard.go - Specialized emitters
pkg/i2gw/emitters - GCE emitter
pkg/i2gw/emitters/gce/gce.go
Output and reporting
- Gateway API resources
- Resource printer
cmd/print.go - Conversion report
pkg/i2gw/notifications/report.go
Other components
- CLI user
- YAML, JSON, KYAML
Connections 35
- CLI user → Program entry: runs CLI
main.go - Program entry → Print command: executes command
main.go - CLI user → Cluster or files: provides resources
README.md - Print command → Conversion runner: requests conversion
cmd/print.go - Conversion runner → Cluster or files: reads resources
pkg/i2gw/ingress2gateway.go - Conversion runner → Provider selection: constructs providers
pkg/i2gw/ingress2gateway.go - Provider selection → Resource readers: selects providers
README.md - Resource readers → Common conversion: converts inputs
- Common conversion → Provider IR: builds provider IR
pkg/i2gw/providers/common/converter.go - Provider-specific conversion → Provider IR: builds provider IR
README.md - GCE conversion → Provider IR: converts GCE inputs
pkg/i2gw/providers/gce/ir_converter.go - Istio conversion → Provider IR: converts Istio inputs
pkg/i2gw/providers/istio/converter.go - Kong TCP ingress → Provider IR: converts TCP ingress
pkg/i2gw/providers/kong/crds/tcpingress.go - NGINX gRPC feature → Provider IR: adds gRPC routes
pkg/i2gw/providers/nginx/annotations/grpc_services.go - NGINX TLS feature → Provider IR: adds TLS policy
pkg/i2gw/providers/nginx/annotations/ssl_services.go - Traefik entrypoints → Provider IR: updates listeners
pkg/i2gw/providers/traefik/router_entrypoints.go - OpenAPI conversion → Provider IR: converts API spec
pkg/i2gw/providers/openapi3/converter.go - Conversion runner → Provider-specific conversion: runs provider conversion
README.md - Provider IR → Emitter IR: translates representation
pkg/i2gw/provider_intermediate/intermediate_representation.go - Conversion runner → Common emitter: runs common emission
pkg/i2gw/ingress2gateway.go - Common emitter → Emitter IR: updates emitter IR
pkg/i2gw/emitters/common_emitter/emitter.go - Conversion runner → Standard emitter: selects emitter
README.md - Conversion runner → Specialized emitters: selects emitter
README.md - Conversion runner → GCE emitter: selects GCE emitter
- Emitter IR → Standard emitter: generates resources
pkg/i2gw/emitters/standard/standard.go - Emitter IR → Specialized emitters: generates resources
README.md - Emitter IR → GCE emitter: generates GCE output
pkg/i2gw/emitters/gce/gce.go - Standard emitter → Gateway API resources: returns resources
README.md - Specialized emitters → Gateway API resources: returns resources
README.md - GCE emitter → Gateway API resources: adds GCE extensions
pkg/i2gw/emitters/gce/gce.go - Conversion runner → Conversion report: collects report
pkg/i2gw/ingress2gateway.go - Print command → Resource printer: prints resources
cmd/print.go - Resource printer → Gateway API resources: formats objects
cmd/print.go - Resource printer → YAML, JSON, KYAML: writes output
cmd/print.go - Print command → Conversion report: renders report
cmd/print.go