How nginxinc/kubernetes-ingress works
NGINX Ingress Controller watches Kubernetes routing resources and turns them into NGINX load-balancer configuration. Users configure standard Ingress, VirtualServer/VirtualServerRoute, and TransportServer resources; the controller reconciles changes, generates configuration, and applies it through the NGINX manager. Additional branches cover certificate management, external DNS, App Protect security, and telemetry. The README documents product capabilities; source excerpts are partial, so some orchestration links are shown as unverified rather than asserted as direct calls.
Main entry points: controller.go Kubernetes Reconciler · manager.go NGINX Manager · types.go Routing Resources · virtualserver.go Route Configuration
Components 18
Controller
- Kubernetes Reconciler
internal/k8s/controller.go
Routing Configuration
- Routing Resources
pkg/apis/configuration/v1/types.go - Policy Validation
pkg/apis/configuration/validation/policy.go - Route Configuration
internal/configs/virtualserver.go - Global Settings
internal/configs/configmaps.go
NGINX Runtime
- NGINX Manager
internal/nginx/manager.go - Config Rollback
internal/nginx/rollback_manager.go - NGINX Process
Extensions
- Certificate Controller
internal/certmanager/cm_controller.go - External DNS
internal/externaldns/controller.go - WAF Bundles
internal/configs/wafbundle/fetch.go - App Protect
internal/k8s/appprotect_waf.go - DoS Protection
internal/k8s/appprotect_dos.go - DNS Provider
Observability
- Health Checks
internal/healthcheck/healthcheck.go - Metrics
internal/metrics/collectors/manager.go - Telemetry
internal/telemetry/collector.go
Other components
- Cluster Operator
Connections 17
- Cluster Operator → Routing Resources: configures
README.md - Routing Resources → Kubernetes Reconciler: reconciled by
README.md - Kubernetes Reconciler → Policy Validation: validates
- Kubernetes Reconciler → Route Configuration: reconciles routes
- Kubernetes Reconciler → Global Settings: reads settings
- Route Configuration → NGINX Manager: produces config
- NGINX Manager → Config Rollback: uses rollback
- NGINX Manager → NGINX Process: manages process
- Kubernetes Reconciler → Certificate Controller: coordinates
internal/k8s/controller.go - Kubernetes Reconciler → External DNS: coordinates
internal/k8s/controller.go - External DNS → DNS Provider: publishes records
- Kubernetes Reconciler → WAF Bundles: coordinates
internal/k8s/controller.go - Kubernetes Reconciler → App Protect: coordinates
internal/k8s/controller.go - Kubernetes Reconciler → DoS Protection: coordinates
internal/k8s/controller.go - Kubernetes Reconciler → Health Checks: starts checks
- Kubernetes Reconciler → Metrics: feeds metrics
- Kubernetes Reconciler → Telemetry: feeds telemetry
internal/k8s/controller.go