openebs/mayastor-io-engine
openebs
Mayastor数据平面引擎是云原生存储解决方案的核心组件，负责数据的高效处理、存储管理和I/O操作，为容器化环境提供高性能、可靠的块存储服务。
1 次收藏下载次数: 0状态：社区镜像维护者：openebs仓库类型：镜像最近更新：23 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Mayastor数据平面引擎
镜像概述
Mayastor数据平面引擎（Data Plane Engine）是Mayastor云原生存储解决方案的核心组件，专注于处理实际的数据I/O路径，负责数据的存储、读取、复制和管理操作。作为数据平面的关键部分，该引擎为Kubernetes等容器编排平台提供高性能、低延迟的块存储服务，支持容器化应用的持久化存储需求。
核心功能与特性
高性能数据处理
- 优化数据路径设计，支持并行I/O操作，利用多核CPU和高速存储设备（如NVMe）提升吞吐量
- 实现低延迟数据访问，通过用户态I/O处理减少内核态切换开销
分布式存储支持
- 支持跨节点数据分布与冗余，通过副本机制（Replication）确保数据高可用
- 动态数据负载均衡，根据节点资源利用率自动调整数据分布
灵活存储适配
- 兼容多种存储介质（NVMe、SSD、HDD），支持根据应用需求选择存储后端
- 支持存储分层，将热数据自动迁移至高性能介质，冷数据迁移至低成本介质
数据可靠性保障
- 实时数据校验与错误恢复机制，支持数据损坏自动修复
- 集成快照（Snapshot）与克隆（Clone）功能，支持数据版本管理与快速恢复
使用场景与适用范围
Kubernetes集群块存储
作为Kubernetes CSI（容器存储接口）的后端实现，为Pod提供持久化块存储卷（PersistentVolume），支持动态供应（Dynamic Provisioning）与存储类（StorageClass）配置。
高性能应用支撑
适用于对存储性能敏感的应用场景，如数据库（MySQL、PostgreSQL、MongoDB）、分布式缓存（Redis）、实时数据分析平台等。
云原生环境存储
为微服务、Serverless等云原生应用提供可靠的持久化存储，支持应用跨节点迁移时的数据一致性。
边缘计算存储
支持边缘节点本地存储与远程存储结合，满足边缘环境低带宽、低延迟的存储需求。
使用方法与配置说明
基本部署（Docker Run）
Mayastor数据平面引擎通常以容器形式部署在Kubernetes节点上，以下是Docker运行示例：
bashdocker run -d \ --name mayastor-data-plane \ --privileged \ --network host \ --cap-add=SYS_ADMIN \ --cap-add=IPC_LOCK \ -v /dev:/dev \ -v /var/lib/mayastor:/var/lib/mayastor \ -v /run/mayastor:/run/mayastor \ -e NODE_NAME=k8s-node-01 \ -e IP_ADDR=192.168.1.10 \ -e LOG_LEVEL=info \ -e STORAGE_POOL=/dev/nvme0n1 \ mayastor/data-plane:latest
关键参数说明
容器运行参数
| 参数 | 说明 | 必要性 |
|---|---|---|
--privileged | 启用特权模式，需访问主机存储设备与网络资源 | 必需 |
--network host | 使用主机网络模式，减少网络转发延迟 | 必需 |
--cap-add=SYS_ADMIN | 添加系统管理权限，用于存储设备管理 | 必需 |
-v /dev:/dev | 挂载主机设备目录，访问存储硬件 | 必需 |
-v /var/lib/mayastor:/var/lib/mayastor | 挂载数据存储目录，持久化引擎配置与元数据 | 必需 |
环境变量配置
| 环境变量 | 说明 | 默认值 |
|---|---|---|
NODE_NAME | 当前节点名称，用于集群节点识别 | 主机名 |
IP_ADDR | 节点IP地址，用于数据平面节点间通信 | 自动获取 |
LOG_LEVEL | 日志级别（debug/info/warn/error） | info |
STORAGE_POOL | 存储池路径，指定用于创建存储池的设备 | 无 |
REPLICATION_FACTOR | 默认数据副本数（1-3） | 2 |
MAX_IO_QUEUE_DEPTH | I/O队列深度，调整并发处理能力 | 128 |
Docker Compose配置示例
yamlversion: '3.8' services: mayastor-data-plane: image: mayastor/data-plane:latest container_name: mayastor-data-plane restart: unless-stopped privileged: true network_mode: host cap_add: - SYS_ADMIN - IPC_LOCK volumes: - /dev:/dev - /var/lib/mayastor:/var/lib/mayastor - /run/mayastor:/run/mayastor - /sys/class/nvme:/sys/class/nvme # NVMe设备识别（如使用NVMe后端） environment: - NODE_NAME=k8s-worker-02 - IP_ADDR=10.244.2.15 - LOG_LEVEL=debug - STORAGE_POOL=/dev/nvme0n1,/dev/sdb - REPLICATION_FACTOR=3 - MAX_IO_QUEUE_DEPTH=256
部署注意事项
-
依赖要求
- 主机需支持Linux内核5.4+，开启NVMe/TCP等相关内核模块
- 存储设备需提前格式化（建议使用ext4或xfs文件系统）
- 确保节点间网络互通（默认需开放30000-32767端口用于数据平面通信）
-
与控制平面配合
- 数据平面引擎需与Mayastor控制平面（Control Plane）协同工作
- 控制平面负责存储卷生命周期管理、拓扑发现和调度决策
-
性能调优建议
- 对高性能需求场景，建议使用NVMe设备并配置
MAX_IO_QUEUE_DEPTH=256 - 根据应用I/O特性调整
REPLICATION_FACTOR（读密集型应用可降低副本数）
- 对高性能需求场景，建议使用NVMe设备并配置
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 mayastor-io-engine 镜像标签
docker pull docker.xuanyuan.run/openebs/mayastor-io-engine:<标签>
DockerHub 原生拉取命令
docker pull openebs/mayastor-io-engine:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"