# kubernetes-sigs/ingress2gateway architecture

> Architecture diagram of the GitHub repository kubernetes-sigs/ingress2gateway, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubernetes-sigs/ingress2gateway
- Repository: https://github.com/kubernetes-sigs/ingress2gateway

## Overview

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: [`pkg/i2gw/ingress2gateway.go`](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/ingress2gateway.go) (Conversion runner), [`pkg/i2gw/provider_intermediate/intermediate_representation.go`](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/provider_intermediate/intermediate_representation.go) (Provider IR), [`pkg/i2gw/emitter_intermediate/intermediate_representation.go`](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitter_intermediate/intermediate_representation.go) (Emitter IR), [`cmd/print.go`](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/cmd/print.go) (Print command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and orchestration"]
  node_main["Program entry<br/>[main.go]"]
  node_print["Print command<br/>[print.go]"]
  node_orchestrator["Conversion runner<br/>[ingress2gateway.go]"]
  node_input["Cluster or files"]
end

subgraph group_providers["Input providers"]
  node_provider_registry["Provider selection<br/>[provider.go]"]
  node_provider_readers["Resource readers"]
end

subgraph group_conversion["Conversion layers"]
  node_common_conversion["Common conversion<br/>[converter.go]"]
  node_provider_ir["Provider IR"]
  node_provider_conversion["Provider-specific conversion"]
  node_gce_conversion["GCE conversion<br/>[ir_converter.go]"]
  node_istio_conversion["Istio conversion<br/>[converter.go]"]
  node_kong_tcp["Kong TCP ingress<br/>[tcpingress.go]"]
  node_nginx_grpc["NGINX gRPC feature<br/>[grpc_services.go]"]
  node_nginx_tls["NGINX TLS feature<br/>[ssl_services.go]"]
  node_traefik_entrypoints["Traefik entrypoints"]
  node_openapi_conversion["OpenAPI conversion<br/>[converter.go]"]
  node_emitter_ir["Emitter IR"]
end

subgraph group_emitters["Output emitters"]
  node_common_emitter["Common emitter<br/>[emitter.go]"]
  node_standard_emitter["Standard emitter<br/>[standard.go]"]
  node_specialized_emitters["Specialized emitters"]
  node_gce_emitter["GCE emitter<br/>[gce.go]"]
end

subgraph group_reporting["Output and reporting"]
  node_resources["Gateway API resources"]
  node_printer["Resource printer<br/>[print.go]"]
  node_notifications["Conversion report<br/>[report.go]"]
end

node_user(("CLI user"))
node_stdout(("YAML, JSON, KYAML"))

node_user -->|"runs CLI"| node_main
node_main -->|"executes command"| node_print
node_user -->|"provides resources"| node_input
node_print -->|"requests conversion"| node_orchestrator
node_orchestrator -->|"reads resources"| node_input
node_orchestrator -->|"constructs providers"| node_provider_registry
node_provider_registry -->|"selects providers"| node_provider_readers
node_provider_readers -.->|"converts inputs"| node_common_conversion
node_common_conversion -->|"builds provider IR"| node_provider_ir
node_provider_conversion -->|"builds provider IR"| node_provider_ir
node_gce_conversion -->|"converts GCE inputs"| node_provider_ir
node_istio_conversion -->|"converts Istio inputs"| node_provider_ir
node_kong_tcp -->|"converts TCP ingress"| node_provider_ir
node_nginx_grpc -->|"adds gRPC routes"| node_provider_ir
node_nginx_tls -->|"adds TLS policy"| node_provider_ir
node_traefik_entrypoints -->|"updates listeners"| node_provider_ir
node_openapi_conversion -->|"converts API spec"| node_provider_ir
node_orchestrator -->|"runs provider conversion"| node_provider_conversion
node_provider_ir -->|"translates representation"| node_emitter_ir
node_orchestrator -->|"runs common emission"| node_common_emitter
node_common_emitter -->|"updates emitter IR"| node_emitter_ir
node_orchestrator -->|"selects emitter"| node_standard_emitter
node_orchestrator -->|"selects emitter"| node_specialized_emitters
node_orchestrator -->|"selects GCE emitter"| node_gce_emitter
node_emitter_ir -->|"generates resources"| node_standard_emitter
node_emitter_ir -->|"generates resources"| node_specialized_emitters
node_emitter_ir -->|"generates GCE output"| node_gce_emitter
node_standard_emitter -->|"returns resources"| node_resources
node_specialized_emitters -->|"returns resources"| node_resources
node_gce_emitter -->|"adds GCE extensions"| node_resources
node_orchestrator -->|"collects report"| node_notifications
node_print -->|"prints resources"| node_printer
node_printer -->|"formats objects"| node_resources
node_printer -->|"writes output"| node_stdout
node_print -->|"renders report"| node_notifications

click node_main "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/main.go"
click node_print "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/cmd/print.go"
click node_orchestrator "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/ingress2gateway.go"
click node_provider_registry "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/provider.go"
click node_provider_readers "https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/providers"
click node_common_conversion "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/common/converter.go"
click node_provider_ir "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/provider_intermediate/intermediate_representation.go"
click node_provider_conversion "https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/providers"
click node_gce_conversion "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/gce/ir_converter.go"
click node_istio_conversion "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/istio/converter.go"
click node_kong_tcp "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/kong/crds/tcpingress.go"
click node_nginx_grpc "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/nginx/annotations/grpc_services.go"
click node_nginx_tls "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/nginx/annotations/ssl_services.go"
click node_traefik_entrypoints "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/traefik/router_entrypoints.go"
click node_openapi_conversion "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/openapi3/converter.go"
click node_emitter_ir "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitter_intermediate/intermediate_representation.go"
click node_common_emitter "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/common_emitter/emitter.go"
click node_standard_emitter "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/standard/standard.go"
click node_specialized_emitters "https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/emitters"
click node_gce_emitter "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/gce/gce.go"
click node_printer "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/cmd/print.go"
click node_notifications "https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/notifications/report.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_print,node_orchestrator,node_input,node_user toneBlue
class node_provider_registry,node_provider_readers toneAmber
class node_common_conversion,node_provider_ir,node_provider_conversion,node_gce_conversion,node_istio_conversion,node_kong_tcp,node_nginx_grpc,node_nginx_tls,node_traefik_entrypoints,node_openapi_conversion,node_emitter_ir toneMint
class node_common_emitter,node_standard_emitter,node_specialized_emitters,node_gce_emitter toneRose
class node_resources,node_printer,node_notifications,node_stdout toneIndigo
```

## Components

### CLI and orchestration

- [Program entry](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/main.go): `main.go`
- [Print command](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/cmd/print.go): `cmd/print.go`
- [Conversion runner](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/ingress2gateway.go): `pkg/i2gw/ingress2gateway.go`
- **Cluster or files**

### Input providers

- [Provider selection](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/provider.go): `pkg/i2gw/provider.go`
- [Resource readers](https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/providers): `pkg/i2gw/providers`

### Conversion layers

- [Common conversion](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/common/converter.go): `pkg/i2gw/providers/common/converter.go`
- [Provider IR](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/provider_intermediate/intermediate_representation.go): `pkg/i2gw/provider_intermediate/intermediate_representation.go`
- [Provider-specific conversion](https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/providers): `pkg/i2gw/providers`
- [GCE conversion](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/gce/ir_converter.go): `pkg/i2gw/providers/gce/ir_converter.go`
- [Istio conversion](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/istio/converter.go): `pkg/i2gw/providers/istio/converter.go`
- [Kong TCP ingress](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/kong/crds/tcpingress.go): `pkg/i2gw/providers/kong/crds/tcpingress.go`
- [NGINX gRPC feature](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/nginx/annotations/grpc_services.go): `pkg/i2gw/providers/nginx/annotations/grpc_services.go`
- [NGINX TLS feature](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/nginx/annotations/ssl_services.go): `pkg/i2gw/providers/nginx/annotations/ssl_services.go`
- [Traefik entrypoints](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/traefik/router_entrypoints.go): `pkg/i2gw/providers/traefik/router_entrypoints.go`
- [OpenAPI conversion](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/openapi3/converter.go): `pkg/i2gw/providers/openapi3/converter.go`
- [Emitter IR](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitter_intermediate/intermediate_representation.go): `pkg/i2gw/emitter_intermediate/intermediate_representation.go`

### Output emitters

- [Common emitter](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/common_emitter/emitter.go): `pkg/i2gw/emitters/common_emitter/emitter.go`
- [Standard emitter](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/standard/standard.go): `pkg/i2gw/emitters/standard/standard.go`
- [Specialized emitters](https://github.com/kubernetes-sigs/ingress2gateway/tree/main/pkg/i2gw/emitters): `pkg/i2gw/emitters`
- [GCE emitter](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/emitters/gce/gce.go): `pkg/i2gw/emitters/gce/gce.go`

### Output and reporting

- **Gateway API resources**
- [Resource printer](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/cmd/print.go): `cmd/print.go`
- [Conversion report](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/notifications/report.go): `pkg/i2gw/notifications/report.go`

### Other components

- **CLI user**
- **YAML, JSON, KYAML**

## Connections

- CLI user → Program entry: runs CLI (evidence: `main.go`)
- Program entry → Print command: executes command (evidence: `main.go`)
- CLI user → Cluster or files: provides resources (evidence: `README.md`)
- Print command → Conversion runner: requests conversion (evidence: `cmd/print.go`)
- Conversion runner → Cluster or files: reads resources (evidence: `pkg/i2gw/ingress2gateway.go`)
- Conversion runner → Provider selection: constructs providers (evidence: `pkg/i2gw/ingress2gateway.go`)
- Provider selection → Resource readers: selects providers (evidence: `README.md`)
- Resource readers → Common conversion: converts inputs
- Common conversion → Provider IR: builds provider IR (evidence: `pkg/i2gw/providers/common/converter.go`)
- Provider-specific conversion → Provider IR: builds provider IR (evidence: `README.md`)
- GCE conversion → Provider IR: converts GCE inputs (evidence: `pkg/i2gw/providers/gce/ir_converter.go`)
- Istio conversion → Provider IR: converts Istio inputs (evidence: `pkg/i2gw/providers/istio/converter.go`)
- Kong TCP ingress → Provider IR: converts TCP ingress (evidence: `pkg/i2gw/providers/kong/crds/tcpingress.go`)
- NGINX gRPC feature → Provider IR: adds gRPC routes (evidence: `pkg/i2gw/providers/nginx/annotations/grpc_services.go`)
- NGINX TLS feature → Provider IR: adds TLS policy (evidence: `pkg/i2gw/providers/nginx/annotations/ssl_services.go`)
- Traefik entrypoints → Provider IR: updates listeners (evidence: `pkg/i2gw/providers/traefik/router_entrypoints.go`)
- OpenAPI conversion → Provider IR: converts API spec (evidence: `pkg/i2gw/providers/openapi3/converter.go`)
- Conversion runner → Provider-specific conversion: runs provider conversion (evidence: `README.md`)
- Provider IR → Emitter IR: translates representation (evidence: `pkg/i2gw/provider_intermediate/intermediate_representation.go`)
- Conversion runner → Common emitter: runs common emission (evidence: `pkg/i2gw/ingress2gateway.go`)
- Common emitter → Emitter IR: updates emitter IR (evidence: `pkg/i2gw/emitters/common_emitter/emitter.go`)
- Conversion runner → Standard emitter: selects emitter (evidence: `README.md`)
- Conversion runner → Specialized emitters: selects emitter (evidence: `README.md`)
- Conversion runner → GCE emitter: selects GCE emitter
- Emitter IR → Standard emitter: generates resources (evidence: `pkg/i2gw/emitters/standard/standard.go`)
- Emitter IR → Specialized emitters: generates resources (evidence: `README.md`)
- Emitter IR → GCE emitter: generates GCE output (evidence: `pkg/i2gw/emitters/gce/gce.go`)
- Standard emitter → Gateway API resources: returns resources (evidence: `README.md`)
- Specialized emitters → Gateway API resources: returns resources (evidence: `README.md`)
- GCE emitter → Gateway API resources: adds GCE extensions (evidence: `pkg/i2gw/emitters/gce/gce.go`)
- Conversion runner → Conversion report: collects report (evidence: `pkg/i2gw/ingress2gateway.go`)
- Print command → Resource printer: prints resources (evidence: `cmd/print.go`)
- Resource printer → Gateway API resources: formats objects (evidence: `cmd/print.go`)
- Resource printer → YAML, JSON, KYAML: writes output (evidence: `cmd/print.go`)
- Print command → Conversion report: renders report (evidence: `cmd/print.go`)
