How rh-ecosystem-edge/kernel-module-management works
KMM is a Kubernetes operator for deploying and managing out-of-tree kernel modules and associated device plug-ins, including lifecycle handling across kernel upgrades. Its main workflow is Kubernetes resources entering the operator’s controllers, which reconcile module intent into per-node configuration and worker pods; separate build/sign and hub controllers support related stages and multi-cluster management. The tree and excerpts show the manager wiring and several implementation responsibilities, but not every reconciler call path, so uncertain connections are omitted.
Main entry points: manager/main.go Main manager · module_reconciler.go Module reconciler · module.go Module validator · webhook-server/main.go Webhook server
Components 23
Operator control
- Main manager
cmd/manager/main.go - Module APIs
api/v1beta1/module_types.go
Module deployment
- Module reconciler
internal/controllers/module_reconciler.go - Kernel mapping
internal/module/kernelmapper.go - Module image config
internal/mic/mic.go - Node config helper
internal/nmc/helper.go - Node config reconciler
internal/controllers/nmc_reconciler.go - Worker pod manager
internal/pod/workerpodmanager.go - Kernel worker
internal/worker/worker.go
Build and signing
- Build/sign controller
internal/controllers/mbsc_reconciler.go - Build/sign manager
internal/buildsign/manager.go - Build resource manager
internal/buildsign/resource/resourcemanager.go
Hub management
- Hub manager
cmd/manager-hub/main.go - Managed module reconciler
internal/controllers/hub/managedclustermodule_reconciler.go - Manifest work
internal/manifestwork/manifestwork.go - Day-one utility
cmd/day1-utility/main.go - Machine config producer
pkg/mcproducer/mcproducer.go
Admission
- Webhook server
cmd/webhook-server/main.go - Module validator
internal/webhook/module.go - Managed module validator
internal/webhook/hub/managedclustermodule_webhook.go - Preflight validation
internal/controllers/preflightvalidation_reconciler.go
Other components
- Cluster administrator
- Kubernetes API
Connections 20
- Cluster administrator → Kubernetes API: submits resources
README.md - Kubernetes API → Main manager: provides watched state
- Main manager → Module reconciler: registers controller
cmd/manager/main.go - Module reconciler → Kernel mapping: injects mapper
internal/controllers/module_reconciler.go - Module reconciler → Module image config: injects config API
internal/controllers/module_reconciler.go - Module reconciler → Node config helper: injects helper
internal/controllers/module_reconciler.go - Main manager → Node config reconciler: registers controller
cmd/manager/main.go - Node config reconciler → Worker pod manager: uses pod manager
- Worker pod manager → Kernel worker: sets worker commands
internal/pod/workerpodmanager.go - Main manager → Build/sign controller: sets up controllers
cmd/manager/main.go - Build/sign controller → Build/sign manager: coordinates actions
- Build/sign manager → Build resource manager: delegates resources
internal/buildsign/manager.go - Hub manager → Managed module reconciler: sets up reconciliation
cmd/manager-hub/main.go - Managed module reconciler → Manifest work: dispatches work
- Webhook server → Module validator: registers validator
cmd/webhook-server/main.go - Webhook server → Managed module validator: registers validator
cmd/webhook-server/main.go - Module validator → Module APIs: validates modules
internal/webhook/module.go - Managed module validator → Module validator: delegates validation
internal/webhook/hub/managedclustermodule_webhook.go - Main manager → Preflight validation: sets up validation
cmd/manager/main.go - Day-one utility → Machine config producer: produces YAML
cmd/day1-utility/main.go