kernel-module-management-operator

rocm/kernel-module-management-operator Docker Image

KMM用于管理、构建、签名和部署树外内核模块及设备插件的工具。

下载次数: 0状态:社区镜像维护者:AMD ROCm 官方容器镜像仓库类型:镜像最近更新:

KMM 镜像文档

概述

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

核心功能与特性

1. 全生命周期管理

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

2. 自动化构建能力

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

3. 安全签名机制

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

4. 灵活部署策略

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

使用场景与适用范围

典型应用场景

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

使用方法与配置说明

前提条件

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

镜像获取

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

bash
docker pull docker.xuanyuan.run/<registry>/kmm:latest

环境变量配置

环境变量名描述示例值是否必填
KERNEL_VERSION目标内核版本号5.15.0-78-generic是
MODULE_SOURCE模块源码在容器内的路径/app/module-src是
SIGN_CERT签名证书路径(容器内)/certs/module-cert.pem否
SIGN_KEY签名私钥路径(容器内)/certs/module-key.pem否
DEPLOY_TARGET部署目标类型(local/remote)local否

部署示例

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 \
  docker.xuanyuan.run/<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 \
  docker.xuanyuan.run/<registry>/kmm:latest \
  kmm build-sign-deploy

核心命令参数

命令参数描述示例用法
build仅执行模块构建kmm build
sign对指定模块进行签名kmm sign --module /path
deploy部署已构建的模块kmm deploy --target local
build-sign-deploy依次执行构建、签名、部署kmm build-sign-deploy
status查看已部署模块状态kmm status

注意事项

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

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 kernel-module-management-operator 镜像标签

docker pull docker.xuanyuan.run/rocm/kernel-module-management-operator:<标签>

DockerHub 原生拉取命令

docker pull rocm/kernel-module-management-operator:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告