longhornio/longhorn-share-manager

Longhorn Share Manager (RWX) 镜像文档

镜像概述和主要用途

Longhorn Share Manager 是 Longhorn 分布式存储系统的核心组件之一，专门用于实现 ReadWriteMany (RWX) 访问模式的存储卷共享。该组件通过集成网络文件共享协议（如 NFS），将 Longhorn 提供的 ReadWriteOnce (RWO) 基础卷转换为多节点可同时读写的共享卷，从而支持 Kubernetes 集群中多 Pod 共享存储的场景。

核心功能和特性

核心功能

• RWX 访问模式支持：将 Longhorn RWO 卷转换为 RWX 卷，允许多个 Pod 同时挂载并读写。
• 协议支持：默认支持 NFSv4 协议，提供稳定的跨节点文件共享能力（部分版本可能支持 SMB，需参考 Longhorn 版本说明）。
• 动态配置管理：根据 Longhorn 卷的创建、删除、扩容等事件，自动更新共享配置（如 NFS 导出规则）。
• 与 Longhorn 生态深度集成：与 Longhorn Manager、CSI 驱动等组件协同工作，接收卷元数据、状态信息，确保共享服务与卷生命周期同步。

特性

• 轻量级设计：基于 Alpine 或极简 Linux 基础镜像，资源占用低。
• 高可用性：依赖 Longhorn 卷的副本机制，确保共享服务后端数据可靠。
• 自动故障转移：当卷的主副本切换时，Share Manager 可配合 Longhorn 自动重建或迁移，恢复共享服务。
• 安全隔离：每个 RWX 卷对应独立的 Share Manager 实例，避免跨卷干扰。

使用场景和适用范围

使用场景

• 多 Pod 共享存储：如 WordPress 多实例共享主题/插件目录、分布式应用（如 Kafka、ZooKeeper）的数据共享需求。
• 动态卷供应：通过 Longhorn CSI 驱动动态创建 RWX 卷时，自动触发 Share Manager 部署。
• 跨节点数据访问：需要跨 Kubernetes 节点的 Pod 访问同一存储卷的场景（如 CI/CD 流水线共享工作区）。

适用范围

• 依赖环境：必须与 Longhorn 存储系统（v1.2.0+）配合使用，无法独立运行。
• Kubernetes 集群：仅适用于 Kubernetes 环境，通常由 Longhorn Operator 或 Deployment 自动管理。
• 协议限制：当前主要支持 NFSv4，部分版本可能支持 NFSv3（需通过 Longhorn 配置启用）。

使用方法和配置说明

Longhorn Share Manager 通常由 Longhorn 系统自动部署和管理，无需用户手动操作。以下为关键配置流程和说明：

前置条件

1. 已在 Kubernetes 集群中安装 Longhorn（参考 https://longhorn.io/docs/latest/installation/%EF%BC%89%E3%80%82
2. 集群节点已安装 NFS 客户端工具（如 nfs-common），确保 Pod 可挂载 NFS 卷。

手动配置（高级场景）

若需自定义 Share Manager 行为，可通过 Longhorn 配置文件（如 values.yaml 或 longhorn-config ConfigMap）调整以下参数：

• shareManagerImage: 指定 Share Manager 镜像版本（默认使用与 Longhorn 一致的版本）。
• nfsProtocolVersion: 设置 NFS 协议版本（如 nfs4 或 nfs3）。
• shareManagerResources: 限制 Share Manager 实例的 CPU/内存资源（如 requests: {cpu: 100m, memory: 128Mi}）。

配置参数与环境变量

Share Manager 实例通过环境变量接收 Longhorn Manager 的动态配置，关键参数如下：

Docker 部署示例（仅供调试）

注意：生产环境中，Share Manager 由 Longhorn 自动部署。以下为本地调试用 Docker 命令示例（需手动模拟 Longhorn 环境依赖）：

bash
docker run -d \
  --name longhorn-share-manager \
  --net=host \  # 需暴露 NFS 端口，生产环境不建议
  -e LONGHORN_MANAGER_URL=http://longhorn-manager:9500 \
  -e VOLUME_NAME=test-rwx-volume \
  -e VOLUME_NAMESPACE=default \
  -e SHARE_PROTOCOL=nfs \
  -v /var/lib/longhorn/volumes/test-rwx-volume:/export:rshared \  # 挂载 Longhorn 卷目录
  longhornio/longhorn-share-manager:v1.6.0  # 替换为实际版本

注意事项

1. 版本兼容性：Share Manager 版本必须与 Longhorn 集群版本一致，避免因 API 不兼容导致故障。
2. 资源限制：每个 Share Manager 实例建议分配至少 100m CPU 和 128Mi 内存，高并发场景可适当增加。
3. 网络策略：确保 Kubernetes 网络策略允许 Share Manager 与 Longhorn Manager（9500 端口）、NFS 客户端（2049 端口）通信。
4. 数据安全：NFS 共享默认不加密，敏感场景需通过 Kubernetes NetworkPolicy 或外部存储加密（如 Longhorn 卷加密）增强安全性。

参考链接

• https://longhorn.io/docs/latest/advanced-resources/rwx-volume/
• https://github.com/longhorn/longhorn-share-manager
• https://longhorn.io/docs/latest/installation/