Upfluence Cassandra Docker镜像文档

镜像概述

Upfluence Cassandra镜像是基于Apache Cassandra官方版本构建的Docker镜像，由Upfluence团队维护并优化。该镜像旨在简化Cassandra分布式数据库的部署流程，提供预设的最佳实践配置，适用于需要高可用性、可扩展性和容错能力的分布式数据存储场景。

核心功能与特性

基础特性

• 分布式架构：采用无中心节点的P2P架构，支持多节点协同工作
• 高可用性：通过数据自动复制机制，确保单节点故障不影响整体服务
• 线性扩展：支持节点横向扩展，性能随集群规模线性增长
• 多数据中心支持：原生支持跨数据中心部署，增强容灾能力
• 灵活的数据模型：基于列族的数据模型，支持动态列添加，平衡灵活性与性能

Upfluence定制优化

• 集成预设的生产级配置模板，减少部署前的配置工作
• 优化资源分配策略，适配容器化环境的资源限制
• 简化监控集成，支持常见监控工具（如Prometheus、Grafana）的数据暴露

使用场景与适用范围

典型使用场景

• 高写入吞吐量应用（如日志收集、事件跟踪系统）
• 需要跨地域数据同步的多数据中心部署
• 大规模分布式数据分析平台的底层存储
• 对数据可用性要求严苛的业务系统（如金融交易记录、用户行为数据）

适用范围

• 中小企业快速部署Cassandra集群
• 开发/测试环境的标准化部署
• 生产环境中需要简化运维的Cassandra实例
• 需要与容器编排平台（Kubernetes、Docker Swarm）集成的场景

使用方法与配置说明

基本部署（单节点）

简单启动命令

docker run -d \
  --name upfluence-cassandra \
  -p 7000:7000 \
  -p 9042:9042 \
  upfluence/cassandra

说明

• 7000端口：节点间通信端口（默认用于Gossip协议）
• 9042端口：CQL客户端连接端口

集群部署

多节点集群启动（3节点示例）

节点1（种子节点）

docker run -d \
  --name cassandra-node1 \
  -e CASSANDRA_CLUSTER_NAME="upfluence-cluster" \
  -e CASSANDRA_SEEDS="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' cassandra-node1)" \
  -e CASSANDRA_DC="dc1" \
  -e CASSANDRA_RACK="rack1" \
  -p 7000:7000 \
  -p 9042:9042 \
  upfluence/cassandra

节点2

docker run -d \
  --name cassandra-node2 \
  -e CASSANDRA_CLUSTER_NAME="upfluence-cluster" \
  -e CASSANDRA_SEEDS="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' cassandra-node1)" \
  -e CASSANDRA_DC="dc1" \
  -e CASSANDRA_RACK="rack1" \
  upfluence/cassandra

节点3

docker run -d \
  --name cassandra-node3 \
  -e CASSANDRA_CLUSTER_NAME="upfluence-cluster" \
  -e CASSANDRA_SEEDS="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' cassandra-node1)" \
  -e CASSANDRA_DC="dc1" \
  -e CASSANDRA_RACK="rack2" \
  upfluence/cassandra

环境变量配置

数据持久化

为避免容器重启导致数据丢失，建议挂载数据卷：

docker run -d \
  --name upfluence-cassandra \
  -v /host/path/cassandra-data:/var/lib/cassandra \
  -v /host/path/cassandra-logs:/var/log/cassandra \
  upfluence/cassandra

示例：docker-compose集群配置

version: '3'

services:
  cassandra-seed:
    image: upfluence/cassandra
    container_name: cassandra-seed
    environment:
      - CASSANDRA_CLUSTER_NAME=upfluence-prod-cluster
      - CASSANDRA_DC=dc1
      - CASSANDRA_RACK=rack1
      - MAX_HEAP_SIZE=2G
      - HEAP_NEWSIZE=512M
    volumes:
      - seed-data:/var/lib/cassandra
    ports:
      - "9042:9042"
    networks:
      - cassandra-net

  cassandra-node1:
    image: upfluence/cassandra
    container_name: cassandra-node1
    environment:
      - CASSANDRA_CLUSTER_NAME=upfluence-prod-cluster
      - CASSANDRA_SEEDS=cassandra-seed
      - CASSANDRA_DC=dc1
      - CASSANDRA_RACK=rack1
      - MAX_HEAP_SIZE=2G
      - HEAP_NEWSIZE=512M
    volumes:
      - node1-data:/var/lib/cassandra
    depends_on:
      - cassandra-seed
    networks:
      - cassandra-net

  cassandra-node2:
    image: upfluence/cassandra
    container_name: cassandra-node2
    environment:
      - CASSANDRA_CLUSTER_NAME=upfluence-prod-cluster
      - CASSANDRA_SEEDS=cassandra-seed
      - CASSANDRA_DC=dc1
      - CASSANDRA_RACK=rack2
      - MAX_HEAP_SIZE=2G
      - HEAP_NEWSIZE=512M
    volumes:
      - node2-data:/var/lib/cassandra
    depends_on:
      - cassandra-seed
    networks:
      - cassandra-net

networks:
  cassandra-net:
    driver: bridge

volumes:
  seed-data:
  node1-data:
  node2-data:

注意事项

• 生产环境中建议至少部署3个节点以确保高可用性
• 根据实际负载调整JVM内存配置（MAX_HEAP_SIZE和HEAP_NEWSIZE）
• 多节点部署时，确保所有节点网络互通，种子节点地址配置正确
• 定期备份挂载的数据卷以防止数据损坏