rocm/kernel-module-management-worker

KMM 镜像文档

镜像概述

KMM（Kernel Module Management）是一个专注于树外内核模块和设备插件生命周期管理的工具镜像。它提供从模块构建、签名到部署的完整流程支持，帮助用户在各类环境中高效管理非主线内核模块及相关设备插件。

核心功能与特性

• 全生命周期管理：统一管理树外内核模块的创建、更新和移除过程
• 自动化构建：支持针对不同内核版本构建定制化内核模块
• 安全签名：提供内核模块数字签名功能，确保模块完整性和可信度
• 设备插件部署：简化设备插件的分发与部署流程，支持主流容器编排平台

使用场景与适用范围

适用于以下场景：

• Kubernetes等容器平台中自定义内核模块的部署与管理
• 树外内核模块的开发、测试与生产环境交付
• 需要确保内核模块安全性和合规性的企业级应用
• 硬件设备插件的跨环境一致性部署

使用方法

基本运行方式

通过Docker运行KMM镜像的基础命令：

bash
docker run --rm docker.xuanyuan.run/kmm:latest [command] [options]

核心命令说明

• build：构建指定内核模块
• sign：对内核模块进行数字签名
• deploy：部署内核模块或设备插件
• manage：管理已部署模块的生命周期（状态检查、更新、回滚）

配置参数

KMM支持通过环境变量进行配置，关键参数包括：

• KERNEL_VERSION：目标内核版本（如5.15.0-78-generic）
• MODULE_SOURCE：内核模块源代码路径
• SIGNING_KEY_PATH：签名密钥文件路径
• DEPLOY_NAMESPACE：部署目标命名空间（Kubernetes环境）
• PLUGIN_CONFIG：设备插件配置文件路径

使用示例

构建并签名内核模块

bash
docker run --rm \
  -e KERNEL_VERSION=5.15.0-78-generic \
  -e MODULE_SOURCE=/module-src \
  -e SIGNING_KEY_PATH=/keys/signing.key \
  -v /host/path/to/module:/module-src \
  -v /host/path/to/keys:/keys \
  docker.xuanyuan.run/kmm:latest build sign

部署设备插件到Kubernetes

bash
docker run --rm \
  -e DEPLOY_NAMESPACE=kube-system \
  -e PLUGIN_CONFIG=/plugin/config.yaml \
  -v /host/path/to/plugin/config:/plugin \
  -v $HOME/.kube/config:/root/.kube/config \
  kmm:latest deploy device-plugin