rocm/kernel-module-management-operator

KMM 镜像文档

概述

KMM（Kernel Module Manager）是一款专注于树外内核模块及设备插件全生命周期管理的工具，核心功能涵盖模块的管理、构建、签名与部署。树外内核模块指未包含在官方内核源码树中的自定义模块，广泛应用于硬件驱动开发、特定功能扩展等场景。KMM通过容器化方式提供标准化的构建与部署环境，简化内核模块从开发到上线的复杂流程。

核心功能与特性

1. 全生命周期管理

• 支持树外内核模块的创建、版本控制、依赖管理及更新维护
• 提供模块状态监控接口，实时追踪模块在目标环境的加载、运行状态

2. 自动化构建能力

• 集成完整构建工具链，可根据指定内核版本自动编译模块源码
• 兼容Makefile、CMake等主流构建系统，适配不同项目结构的模块开发

3. 安全签名机制

• 支持符合Linux内核规范的模块签名功能，通过加密证书确保模块完整性与来源可信
• 提供签名证书管理接口，支持证书轮换与权限控制

4. 灵活部署策略

• 支持物理机、虚拟机、容器等多环境部署，适配边缘计算、嵌入式系统等场景
• 提供滚动更新、蓝绿部署等部署模式，降低模块更新对业务的影响

使用场景与适用范围

典型应用场景

• 企业级内核定制：需为特定硬件或业务需求开发自定义内核模块的企业环境
• 边缘设备开发：边缘计算节点中需加载定制驱动以支持专用传感器、外设的场景
• 嵌入式系统：嵌入式设备中内核模块的快速迭代与跨版本兼容性测试
• 容器化环境：Kubernetes等容器平台中内核模块的容器化管理与部署
• 内核模块测试：模块开发者在多内核版本环境中验证兼容性的测试场景

使用方法与配置说明

前提条件

• 运行环境需支持Docker 19.03+版本
• 构建模块时需提供目标内核版本对应的内核头文件或源码
• 使用签名功能需准备符合PKCS#1格式的加密证书（公钥+私钥）

镜像获取

通过容器仓库拉取最新版本镜像：

bash
docker pull <registry>/kmm:latest

环境变量配置

部署示例

1. 基础构建流程

仅构建指定内核版本的模块：

bash
docker run -it \
  -e KERNEL_VERSION=5.15.0-78-generic \
  -e MODULE_SOURCE=/module-src \
  -v /host/path/to/module-src:/module-src \
  -v /host/lib/modules:/lib/modules \
  <registry>/kmm:latest \
  kmm build

2. 构建-签名-部署一体化流程

bash
docker run -it \
  --privileged \
  -e KERNEL_VERSION=5.15.0-78-generic \
  -e MODULE_SOURCE=/module-src \
  -e SIGN_CERT=/certs/cert.pem \
  -e SIGN_KEY=/certs/key.pem \
  -v /host/path/to/module-src:/module-src \
  -v /host/path/to/certs:/certs \
  -v /host/lib/modules:/lib/modules \
  -v /host/boot:/boot \
  <registry>/kmm:latest \
  kmm build-sign-deploy

核心命令参数

注意事项

• 构建时需确保目标内核版本与挂载的内核头文件版本完全一致，避免编译错误
• 使用签名功能时，证书需符合内核要求的格式（如SHA256哈希算法），否则模块加载时会验证失败
• 容器化部署场景中，需为容器配置足够权限（如--privileged）以支持内核模块加载操作
• 多版本内核环境中，建议通过KERNEL_VERSION环境变量明确指定目标版本，避免版本冲突