# rh-ecosystem-edge/kernel-module-management architecture

> Architecture diagram of the GitHub repository rh-ecosystem-edge/kernel-module-management, 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/rh-ecosystem-edge/kernel-module-management
- Repository: https://github.com/rh-ecosystem-edge/kernel-module-management

## Overview

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: [`cmd/manager/main.go`](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/manager/main.go) (Main manager), [`internal/controllers/module_reconciler.go`](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/module_reconciler.go) (Module reconciler), [`internal/webhook/module.go`](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/webhook/module.go) (Module validator), [`cmd/webhook-server/main.go`](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/webhook-server/main.go) (Webhook server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Operator control"]
  node_manager["Main manager<br/>[main.go]"]
  node_api["Module APIs<br/>[module_types.go]"]
end

subgraph group_deploy["Module deployment"]
  node_module_recon["Module reconciler"]
  node_kernelmap["Kernel mapping<br/>[kernelmapper.go]"]
  node_mic["Module image config<br/>[mic.go]"]
  node_nmc["Node config helper<br/>[helper.go]"]
  node_nmc_recon["Node config reconciler<br/>[nmc_reconciler.go]"]
  node_podmgr["Worker pod manager"]
  node_worker["Kernel worker<br/>[worker.go]"]
end

subgraph group_build["Build and signing"]
  node_buildsign_recon["Build/sign controller<br/>[mbsc_reconciler.go]"]
  node_buildsign_mgr["Build/sign manager<br/>[manager.go]"]
  node_resource_mgr["Build resource manager<br/>[resourcemanager.go]"]
end

subgraph group_hub["Hub management"]
  node_hub_manager["Hub manager<br/>[main.go]"]
  node_mcm_recon["Managed module reconciler"]
  node_manifestwork["Manifest work<br/>[manifestwork.go]"]
  node_machineconfig["Day-one utility<br/>[main.go]"]
  node_mcproducer["Machine config producer<br/>[mcproducer.go]"]
end

subgraph group_validation["Admission"]
  node_webhook_server["Webhook server<br/>[main.go]"]
  node_module_webhook["Module validator<br/>[module.go]"]
  node_mcm_webhook["Managed module validator"]
  node_preflight["Preflight validation"]
end

node_admin(("Cluster administrator"))
node_kube[("Kubernetes API")]

node_admin -.->|"submits resources"| node_kube
node_kube -.->|"provides watched state"| node_manager
node_manager -.->|"registers controller"| node_module_recon
node_module_recon -->|"injects mapper"| node_kernelmap
node_module_recon -->|"injects config API"| node_mic
node_module_recon -->|"injects helper"| node_nmc
node_manager -->|"registers controller"| node_nmc_recon
node_nmc_recon -->|"uses pod manager"| node_podmgr
node_podmgr -->|"sets worker commands"| node_worker
node_manager -.->|"sets up controllers"| node_buildsign_recon
node_buildsign_recon -.->|"coordinates actions"| node_buildsign_mgr
node_buildsign_mgr -->|"delegates resources"| node_resource_mgr
node_hub_manager -.->|"sets up reconciliation"| node_mcm_recon
node_mcm_recon -.->|"dispatches work"| node_manifestwork
node_webhook_server -->|"registers validator"| node_module_webhook
node_webhook_server -->|"registers validator"| node_mcm_webhook
node_module_webhook -->|"validates modules"| node_api
node_mcm_webhook -->|"delegates validation"| node_module_webhook
node_manager -.->|"sets up validation"| node_preflight
node_machineconfig -->|"produces YAML"| node_mcproducer

click node_manager "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/manager/main.go"
click node_api "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/api/v1beta1/module_types.go"
click node_module_recon "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/module_reconciler.go"
click node_kernelmap "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/module/kernelmapper.go"
click node_mic "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/mic/mic.go"
click node_nmc "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/nmc/helper.go"
click node_nmc_recon "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/nmc_reconciler.go"
click node_podmgr "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/pod/workerpodmanager.go"
click node_worker "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/worker/worker.go"
click node_buildsign_recon "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/mbsc_reconciler.go"
click node_buildsign_mgr "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/buildsign/manager.go"
click node_resource_mgr "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/buildsign/resource/resourcemanager.go"
click node_hub_manager "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/manager-hub/main.go"
click node_mcm_recon "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/hub/managedclustermodule_reconciler.go"
click node_manifestwork "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/manifestwork/manifestwork.go"
click node_webhook_server "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/webhook-server/main.go"
click node_module_webhook "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/webhook/module.go"
click node_mcm_webhook "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/webhook/hub/managedclustermodule_webhook.go"
click node_preflight "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/preflightvalidation_reconciler.go"
click node_machineconfig "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/day1-utility/main.go"
click node_mcproducer "https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/pkg/mcproducer/mcproducer.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_manager,node_api toneBlue
class node_module_recon,node_kernelmap,node_mic,node_nmc,node_nmc_recon,node_podmgr,node_worker,node_kube toneAmber
class node_buildsign_recon,node_buildsign_mgr,node_resource_mgr toneMint
class node_hub_manager,node_mcm_recon,node_manifestwork,node_machineconfig,node_mcproducer toneRose
class node_webhook_server,node_module_webhook,node_mcm_webhook,node_preflight,node_admin toneIndigo
```

## Components

### Operator control

- [Main manager](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/manager/main.go): `cmd/manager/main.go`
- [Module APIs](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/api/v1beta1/module_types.go): `api/v1beta1/module_types.go`

### Module deployment

- [Module reconciler](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/module_reconciler.go): `internal/controllers/module_reconciler.go`
- [Kernel mapping](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/module/kernelmapper.go): `internal/module/kernelmapper.go`
- [Module image config](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/mic/mic.go): `internal/mic/mic.go`
- [Node config helper](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/nmc/helper.go): `internal/nmc/helper.go`
- [Node config reconciler](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/nmc_reconciler.go): `internal/controllers/nmc_reconciler.go`
- [Worker pod manager](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/pod/workerpodmanager.go): `internal/pod/workerpodmanager.go`
- [Kernel worker](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/worker/worker.go): `internal/worker/worker.go`

### Build and signing

- [Build/sign controller](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/mbsc_reconciler.go): `internal/controllers/mbsc_reconciler.go`
- [Build/sign manager](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/buildsign/manager.go): `internal/buildsign/manager.go`
- [Build resource manager](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/buildsign/resource/resourcemanager.go): `internal/buildsign/resource/resourcemanager.go`

### Hub management

- [Hub manager](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/manager-hub/main.go): `cmd/manager-hub/main.go`
- [Managed module reconciler](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/hub/managedclustermodule_reconciler.go): `internal/controllers/hub/managedclustermodule_reconciler.go`
- [Manifest work](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/manifestwork/manifestwork.go): `internal/manifestwork/manifestwork.go`
- [Day-one utility](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/day1-utility/main.go): `cmd/day1-utility/main.go`
- [Machine config producer](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/pkg/mcproducer/mcproducer.go): `pkg/mcproducer/mcproducer.go`

### Admission

- [Webhook server](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/cmd/webhook-server/main.go): `cmd/webhook-server/main.go`
- [Module validator](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/webhook/module.go): `internal/webhook/module.go`
- [Managed module validator](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/webhook/hub/managedclustermodule_webhook.go): `internal/webhook/hub/managedclustermodule_webhook.go`
- [Preflight validation](https://github.com/rh-ecosystem-edge/kernel-module-management/blob/main/internal/controllers/preflightvalidation_reconciler.go): `internal/controllers/preflightvalidation_reconciler.go`

### Other components

- **Cluster administrator**
- **Kubernetes API**

## Connections

- Cluster administrator → Kubernetes API: submits resources (evidence: `README.md`)
- Kubernetes API → Main manager: provides watched state
- Main manager → Module reconciler: registers controller (evidence: `cmd/manager/main.go`)
- Module reconciler → Kernel mapping: injects mapper (evidence: `internal/controllers/module_reconciler.go`)
- Module reconciler → Module image config: injects config API (evidence: `internal/controllers/module_reconciler.go`)
- Module reconciler → Node config helper: injects helper (evidence: `internal/controllers/module_reconciler.go`)
- Main manager → Node config reconciler: registers controller (evidence: `cmd/manager/main.go`)
- Node config reconciler → Worker pod manager: uses pod manager
- Worker pod manager → Kernel worker: sets worker commands (evidence: `internal/pod/workerpodmanager.go`)
- Main manager → Build/sign controller: sets up controllers (evidence: `cmd/manager/main.go`)
- Build/sign controller → Build/sign manager: coordinates actions
- Build/sign manager → Build resource manager: delegates resources (evidence: `internal/buildsign/manager.go`)
- Hub manager → Managed module reconciler: sets up reconciliation (evidence: `cmd/manager-hub/main.go`)
- Managed module reconciler → Manifest work: dispatches work
- Webhook server → Module validator: registers validator (evidence: `cmd/webhook-server/main.go`)
- Webhook server → Managed module validator: registers validator (evidence: `cmd/webhook-server/main.go`)
- Module validator → Module APIs: validates modules (evidence: `internal/webhook/module.go`)
- Managed module validator → Module validator: delegates validation (evidence: `internal/webhook/hub/managedclustermodule_webhook.go`)
- Main manager → Preflight validation: sets up validation (evidence: `cmd/manager/main.go`)
- Day-one utility → Machine config producer: produces YAML (evidence: `cmd/day1-utility/main.go`)
