apache/pegasus

Apache Pegasus (incubating) Docker镜像

概述

Apache Pegasus (incubating) 是一个分布式键值存储系统，旨在提供高性能、高可用、可扩展的数据存储服务。本Docker镜像封装了Apache Pegasus服务组件，简化部署流程，便于快速搭建分布式存储集群，适用于需要可靠分布式存储支持的各类应用场景。

核心功能与特性

• 分布式架构：采用分片存储与多副本机制，实现数据分布式部署与冗余备份，保障数据可靠性
• 高性能读写：优化的存储引擎设计，支持低延迟（毫秒级）和高吞吐量数据访问，满足实时业务需求
• 高可用性：自动故障检测与恢复机制，节点故障时自动切换副本，确保服务持续可用
• 弹性扩展：支持动态添加节点，实现存储容量与处理能力的线性扩展，适应业务增长
• 灵活一致性模型：可配置强一致性或最终一致性策略，平衡数据一致性与性能需求
• 数据管理功能：支持数据备份、恢复、迁移等运维操作，简化数据生命周期管理

使用场景

• 大规模数据存储：适用于需要存储海量键值数据（如用户配置、业务指标、日志数据等）的场景
• 实时数据处理：作为高并发读写的数据存储层，支撑实时数据分析、监控系统等业务
• 高可用服务后端：为核心业务系统提供稳定的数据存储支持，保障服务连续性
• 分布式缓存：可作为分布式缓存系统，加速热点数据访问，减轻数据库压力

使用方法

基本启动命令

通过以下命令快速启动单个Pegasus节点容器（开发测试环境）：

bash
docker run -d \
  --name pegasus-node \
  -p 34601:34601 \  # 客户端访问端口
  -p 34602:34602 \  # 管理端口
  -v /host/data:/data/pegasus \  # 数据持久化目录
  apache/pegasus:latest

环境变量配置

容器支持通过环境变量自定义配置，常用参数如下：

Docker Compose集群部署

创建docker-compose.yml文件部署本地测试集群：

yaml
version: '3'
services:
  meta1:
    image: apache/pegasus:latest
    container_name: pegasus-meta1
    ports:
      - "34601:34601"
    environment:
      - PEGASUS_ROLE=meta
      - PEGASUS_CLUSTER_NAME=test-cluster
      - PEGASUS_META_SERVERS=meta1:34601,meta2:34601,meta3:34601
    volumes:
      - meta1-data:/data/pegasus

  meta2:
    image: apache/pegasus:latest
    container_name: pegasus-meta2
    ports:
      - "34602:34601"
    environment:
      - PEGASUS_ROLE=meta
      - PEGASUS_CLUSTER_NAME=test-cluster
      - PEGASUS_META_SERVERS=meta1:34601,meta2:34601,meta3:34601
    volumes:
      - meta2-data:/data/pegasus

  meta3:
    image: apache/pegasus:latest
    container_name: pegasus-meta3
    ports:
      - "34603:34601"
    environment:
      - PEGASUS_ROLE=meta
      - PEGASUS_CLUSTER_NAME=test-cluster
      - PEGASUS_META_SERVERS=meta1:34601,meta2:34601,meta3:34601
    volumes:
      - meta3-data:/data/pegasus

  server1:
    image: apache/pegasus:latest
    container_name: pegasus-server1
    depends_on:
      - meta1
      - meta2
      - meta3
    environment:
      - PEGASUS_ROLE=server
      - PEGASUS_CLUSTER_NAME=test-cluster
      - PEGASUS_META_SERVERS=meta1:34601,meta2:34601,meta3:34601
    volumes:
      - server1-data:/data/pegasus

volumes:
  meta1-data:
  meta2-data:
  meta3-data:
  server1-data:

启动集群：

bash
docker-compose up -d

数据持久化

通过挂载宿主机目录到容器/data/pegasus路径实现数据持久化，避免容器重启导致数据丢失：

bash
docker run -d \
  --name pegasus-server \
  -v /opt/pegasus/data:/data/pegasus \
  apache/pegasus:latest

注意事项

• 生产环境部署需至少配置3个元数据节点（meta）和3个存储节点（server），确保集群高可用
• 首次启动集群需执行元数据初始化，可通过容器内pegasus-cli工具完成（命令：pegasus-cli cluster init）
• 网络配置需保证节点间端口互通（默认34601-34603），跨主机部署时需配置正确的路由规则
• 镜像版本需与业务需求匹配，建议使用官方稳定版本并定期更新以获取功能优化和安全修复