How envoyproxy/gateway works
Envoy Gateway manages standalone or Kubernetes-based Envoy Proxy deployments. The principal workflow is: an operator submits Gateway API resources; a provider watches and assembles them; the Gateway API translator produces intermediate representations; xDS translation and infrastructure runners configure and provision Envoy; status is reported back. Configuration loading, extension hooks, global rate limiting, administration, and shutdown are supporting capabilities. The sampled excerpts directly establish runner orchestration and provider-to-translator channels; some downstream connections are inferred only where package responsibilities and comments explicitly support them.
Main entry points: server.go Gateway Server · controller.go Kubernetes Provider · translator.go Gateway Translator · xds.go xDS IR
Components 20
Runtime Orchestration
- Gateway Server
internal/cmd/server.go - Config Loader
internal/envoygateway/config/loader/configloader.go
Resource Ingestion
- Kubernetes Provider
internal/provider/kubernetes/controller.go
Translation Pipeline
- Gateway Translator
internal/gatewayapi/translator.go - Infrastructure IR
internal/ir/infra.go - xDS IR
internal/ir/xds.go - xDS Runner
internal/xds/runner/runner.go - xDS Translator
internal/xds/translator/translator.go - xDS Snapshot Cache
internal/xds/cache/snapshotcache.go
Infrastructure Management
- Infrastructure Manager
internal/infrastructure/manager.go - Kubernetes Infrastructure
internal/infrastructure/kubernetes/infra.go
Operations and Extensions
- Extension Manager
internal/extension/registry/extension_manager.go - Global Rate Limit
internal/globalratelimit/runner/runner.go - Admin Server
internal/admin/server.go - Admin Console
internal/admin/console/api.go - Status Updates
internal/provider/kubernetes/status_updater.go
Other components
- Platform Operator
- Kubernetes API
- Envoy Proxy
- Extension Service
Connections 25
- Platform Operator → Kubernetes API: applies resources
- Kubernetes API → Kubernetes Provider: watches resources
- Gateway Server → Config Loader: loads config
- Gateway Server → Kubernetes Provider: starts runner
- Gateway Server → Gateway Translator: starts runner
- Gateway Server → Infrastructure Manager: starts runner
- Gateway Server → Extension Manager: creates manager
- Kubernetes Provider → Gateway Translator: publishes resources
- Kubernetes Provider → Status Updates: writes status
- Status Updates → Kubernetes API: updates status
- Gateway Translator → xDS IR: publishes IR
- Gateway Translator → Infrastructure IR: publishes IR
- xDS IR → xDS Runner: consumes IR
- xDS Runner → xDS Translator: translates resources
- xDS Translator → Extension Manager: invokes hooks
- Extension Manager → Extension Service: calls hooks
- xDS Runner → xDS Snapshot Cache: updates snapshots
- xDS Snapshot Cache → Envoy Proxy: serves xDS
- Infrastructure IR → Infrastructure Manager: consumes IR
- Infrastructure Manager → Kubernetes Infrastructure: selects provider
- Kubernetes Infrastructure → Envoy Proxy: provisions proxy
- xDS IR → Global Rate Limit: consumes resources
- Gateway Server → Admin Server: starts runner
- Admin Server → Admin Console: registers handlers
- Admin Console → Kubernetes Provider: reads resources