piraeusdatastore/piraeus-server

Piraeus 容器镜像文档

概述

Piraeus容器镜像是Piraeus Datastore的官方容器化封装，整合了控制器（controller）、卫星节点（satellite）和客户端（client）核心组件，提供一站式存储管理能力。该镜像旨在简化分布式存储系统的部署流程，通过统一的组件封装，降低Kubernetes环境中存储资源管理的复杂度，支持存储策略配置、数据副本管理及存储资源监控等功能。

核心功能和特性

1. 组件整合

• 控制器（Controller）：负责存储集群的核心管理逻辑，包括存储资源分配、副本调度、故障恢复等；
• 卫星节点（Satellite）：运行于集群各节点的代理组件，执行控制器下发的存储操作，管理本地存储设备；
• 客户端（Client）：提供命令行工具与API接口，支持用户与存储集群交互，执行存储卷创建、扩容、快照等操作。

2. 统一存储管理

• 支持存储资源的集中化配置与监控，简化多节点存储集群的运维流程；
• 内置存储策略模板，支持自定义副本数、存储类型（如SSD/HDD）、访问模式（如ReadWriteOnce、ReadWriteMany）等。

3. Kubernetes集成

• 原生支持Kubernetes CSI（Container Storage Interface），可作为集群存储插件直接部署；
• 兼容Kubernetes资源模型，支持通过PVC（PersistentVolumeClaim）动态申请存储资源。

4. 配置持久化

• 支持存储配置、元数据及运行状态的持久化存储，确保集群重启后配置不丢失。

使用场景和适用范围

适用场景

• Kubernetes集群存储部署：作为K8s集群的分布式存储解决方案，提供持久化存储服务；
• 存储资源集中管理：适用于需要统一管控多节点存储设备、简化存储策略配置的场景；
• 分布式存储环境搭建：用于构建高可用、可扩展的分布式存储集群，支持数据多副本与故障自动转移。

适用人群/角色

• Kubernetes集群管理员
• 存储运维工程师
• 需要在容器环境中部署分布式存储的企业IT团队

使用方法和配置说明

基本使用（Docker Run）

通过docker run命令直接启动Piraeus容器，需指定必要的环境变量与卷挂载：

bash
docker run -d \
  --name piraeus-node \
  --net=host \
  --privileged \
  -e CONTROLLER_ENDPOINT="http://piraeus-controller:8080" \
  -e NODE_NAME="k8s-node-01" \
  -e LOG_LEVEL="info" \
  -v /var/lib/piraeus:/var/lib/piraeus \
  -v /etc/piraeus:/etc/piraeus \
  -v /dev:/dev \
  quay.io/piraeusdatastore/piraeus:latest

参数说明：

• --net=host：使用主机网络，确保组件间网络通信；
• --privileged：获取设备访问权限，用于管理本地存储设备；
• -e CONTROLLER_ENDPOINT：指定控制器服务地址（必填）；
• -e NODE_NAME：当前节点名称（需与K8s节点名称一致，必填）；
• -e LOG_LEVEL：日志级别（可选，默认info，支持debug/warn/error）；
• 卷挂载：
  • /var/lib/piraeus：持久化存储运行时数据；
  • /etc/piraeus：存储配置文件；
  • /dev：挂载主机设备目录，用于存储设备访问。

Docker Compose 配置示例

创建docker-compose.yml文件，定义Piraeus服务组件：

yaml
version: '3.8'
services:
  piraeus:
    image: quay.io/piraeusdatastore/piraeus:latest
    container_name: piraeus-node
    network_mode: host
    privileged: true
    environment:
      - CONTROLLER_ENDPOINT=http://piraeus-controller:8080
      - NODE_NAME=k8s-node-01
      - LOG_LEVEL=info
      - STORAGE_POOL=default-pool
      - REPLICATION_FACTOR=3
    volumes:
      - /var/lib/piraeus:/var/lib/piraeus
      - /etc/piraeus:/etc/piraeus
      - /dev:/dev
      - /run/udev:/run/udev
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

核心配置参数

环境变量

卷挂载

注意事项

• 该镜像需运行在支持Kubernetes的节点环境中，且节点需具备存储设备（如SSD/HDD）；
• 生产环境中建议通过Kubernetes Deployment或StatefulSet部署，而非直接使用Docker命令；
• 控制器（controller）需独立部署，或通过镜像内置模式启动（需设置START_CONTROLLER=true环境变量）。