rocm/kernel-module-management-signimage

KMM镜像文档

概述

KMM（Kernel Module Management）是一个专注于树外内核模块和设备插件全生命周期管理的工具。它提供一站式解决方案，涵盖模块的管理、构建、签名及部署流程，旨在简化树外内核模块的开发与运维工作。

核心功能与特性

• 全生命周期管理：统一管理树外内核模块的版本控制、依赖关系和生命周期
• 构建自动化：支持针对不同内核版本构建定制化的树外内核模块
• 安全签名：提供内核模块签名功能，确保模块完整性和安全性
• 部署支持：简化设备插件和内核模块的部署流程，适配多种运行环境

使用场景与适用范围

KMM适用于以下场景：

• 自定义硬件驱动程序的开发与部署
• 特定设备插件（如GPU、FPGA等）的管理与维护
• 多内核版本环境下的模块兼容性管理
• 对内核模块安全性有严格要求的企业级环境

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -it --rm kmm:latest [command] [options]

常用命令

• kmm build：根据指定内核版本构建树外模块
• kmm sign：对构建完成的内核模块进行签名
• kmm deploy：将内核模块或设备插件部署到目标环境
• kmm manage：管理已部署模块的生命周期（更新、回滚等）

环境变量配置

Docker Compose示例

yaml
version: '3'
services:
  kmm:
    image: kmm:latest
    environment:
      - KERNEL_VERSION=5.15.0-78-generic
      - MODULE_NAME=custom-driver
      - SIGN_KEY_PATH=/keys/sign.key
    volumes:
      - ./keys:/keys
      - ./modules:/output
    command: ["kmm", "build", "--output", "/output"]