rocm/kernel-module-management-webhook-server

KMM 镜像文档

概述

KMM (Kernel Module Manager) 是一款专注于树外内核模块和设备插件生命周期管理的工具，提供从构建、签名到部署的全流程支持，旨在简化自定义内核模块在容器化环境中的管理复杂度。

核心功能与特性

• 全生命周期管理：集成管理、构建、签名和部署能力，覆盖树外内核模块从开发到运行的完整流程
• 树外模块支持：专门针对非内核主线的自定义内核模块设计，满足特定硬件驱动或功能扩展需求
• 设备插件管理：支持设备插件的部署与维护，实现GPU、FPGA等硬件资源在容器间的高效分配
• 安全签名：内置内核模块签名功能，确保模块符合系统安全策略，适配启用Secure Boot的环境

使用场景与适用范围

• 自定义内核模块场景：需开发、测试或部署非主线内核模块的环境，如硬件厂商驱动开发、特定功能模块构建
• 容器化设备管理：在Kubernetes等容器编排平台中，通过设备插件实现硬件资源的容器化访问与调度
• 安全合规环境：对内核模块有签名要求的场景，确保模块加载过程符合系统安全规范（如企业级Linux环境）

使用方法

基本使用（Docker Run）

bash
docker run --rm -v /host/modules:/modules -v /host/keys:/keys kmm:latest \
  --build /modules/custom-module \
  --sign --key /keys/signing-key.pem \
  --deploy --target k8s

Docker Compose 配置示例

yaml
version: '3'
services:
  kmm:
    image: kmm:latest
    volumes:
      - ./local-modules:/modules      # 挂载本地内核模块源代码
      - ./signing-keys:/keys          # 挂载签名密钥文件
      - /lib/modules:/lib/modules     # 共享主机内核模块目录（可选）
    command: >
      --build /modules/network-driver
      --sign --key /keys/enterprise-key.pem
      --deploy --target k8s
    environment:
      - KMM_LOG_LEVEL=debug           # 日志级别：debug/info/warn/error
      - KERNEL_VERSION=5.15.0-78-generic  # 目标内核版本（默认使用主机内核）
      - DEPLOY_NAMESPACE=kube-system  # Kubernetes部署命名空间

环境变量说明

核心命令参数

• --build <path>: 指定内核模块源代码路径，触发构建流程
• --sign: 启用模块签名功能（需配合--key指定密钥文件）
• --key <path>: 指定签名密钥文件路径（与--sign配合使用）
• --deploy: 启用部署功能
• --target <target>: 指定部署目标（支持k8s/local，k8s为Kubernetes集群，local为本地主机）
• --help: 查看完整命令帮助信息