storageos/node

StorageOS Node容器

StorageOS Node容器将您的Docker节点转变为超融合存储平台。每个运行Node容器的Docker主机可将可用的本地或附加存储贡献到分布式存储池中，该存储池通过全局命名空间供所有集群成员使用。

卷可跨集群使用，因此如果容器迁移到其他节点，仍能访问其数据。数据可通过同步复制进行保护。默认启用压缩、缓存和QoS，且所有卷均采用精简配置。无需其他硬件或软件。

完整文档可访问 [***]

核心功能与特性

• 超融合存储平台：将Docker节点转换为分布式存储节点，无需额外硬件
• 分布式存储池：聚合集群中各节点的本地或附加存储资源
• 全局命名空间：统一管理集群存储资源，实现跨节点数据访问
• 跨节点卷可用性：容器迁移后仍可访问数据，确保业务连续性
• 数据保护：支持同步复制，提高数据可靠性
• 默认优化：内置压缩、缓存和QoS功能，提升存储性能
• 精简配置：所有卷均采用精简配置，提高存储利用率

使用场景

• 容器化应用需要跨节点持久化存储
• 微服务架构中多节点数据共享
• 需要高可用、高可靠存储的Docker集群
• 希望简化存储管理的容器环境

快速启动

前提条件

1. 安装StorageOS命令行界面(CLI)，参考文档：[***]
2. 确保满足系统先决条件

部署容器

提供主机IP地址（通过ADVERTISE_IP）和集群发现令牌（通过JOIN）安装容器：

bash
$ JOIN=$(storageos cluster create)
$ docker run -d --name storageos \
    -e HOSTNAME \
    -e ADVERTISE_IP=xxx.xxx.xxx.xxx \  # 替换为实际主机IP
    -e JOIN=${JOIN} \
    --net=host \
    --pid=host \
    --privileged \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    -v /sys:/sys \
    -v /var/lib/storageos:/var/lib/storageos:rshared \
    -v /run/docker/plugins:/run/docker/plugins \
    storageos/node:v2.0.0 server

其他配置参数（见下方配置参数）可通过类似方式设置。

使用StorageOS

使用StorageOS卷运行容器

bash
sudo docker run -it --rm --volume-driver storageos -v test01:/data alpine sh -c "echo hello > /data/myfile"

预创建和管理StorageOS卷

bash
sudo docker volume create --driver storageos --opt size=20 --opt storageos.com/replicas=2 vol01

配置参数

默认设置适用于大多数环境，以下配置可通过环境变量（如上述-e参数）进行调整：

• HOSTNAME：Docker节点的主机名，仅在需要覆盖默认值时设置
• ADVERTISE_IP：Docker节点的IP地址，用于接收连接。默认为第一个非环回地址
• USERNAME：API认证用户名。默认为storageos
• PASSWORD：API认证密码。默认为storageos
• JOIN：节点加入集群的URI，可采用IP列表、集群令牌（通过storageos cluster create创建）或两者组合形式
• API_PORT：API监听端口。默认为5705（IANA注册端口）
• NATS_PORT：NATS消息传递监听端口。默认为4222
• NATS_CLUSTER_PORT：NATS集群服务监听端口。默认为8222
• SERF_PORT：Serf协议监听端口。默认为***
• DFS_PORT：DirectFS监听端口。默认为***
• KV_ADDR：外部键值存储的IP地址/端口。必须与KV_BACKEND=etcd同时指定
• KV_BACKEND：使用的KV存储类型。默认为嵌入式存储；支持etcd（需设置KV_ADDR指向外部etcd实例）或boltdb（用于单节点测试）
• LOG_LEVEL：日志级别，可选debug、info、warning或error。默认为info
• LOG_FORMAT：日志输出格式，可选text或json。默认为json
• DISABLE_TELEMETRY：禁用集群***使用报告，设为true。默认为false。为改进产品，会收集API使用情况和StorageOS配置等数据
• DISABLE_ERROR_REPORTING：禁用集群错误报告，设为true。默认为false。报告错误有助于识别和解决潜在问题