apache/cassandra-centos7-build

Apache Cassandra 镜像文档

镜像概述和主要用途

Apache Cassandra 镜像用于快速部署和运行 Cassandra 分布式 NoSQL 数据库实例，适用于开发、测试和生产环境。该镜像封装了完整的 Cassandra 运行环境，支持单机部署和分布式集群配置，无需手动处理复杂的依赖项和系统环境配置，可快速集成到容器化应用架构中。

核心功能和特性

• 分布式对等架构：无中心节点设计，所有节点对等，避免单点故障
• 高可用性：多副本数据存储，自动故障检测与恢复，服务可用性达99.99%
• 线性可扩展性：横向扩展集群节点，性能随节点数量线性增长，支持数千节点规模
• 灵活一致性模型：支持强一致性（QUORUM）和最终一致性，可按需配置读写策略
• 宽列存储模型：动态列扩展能力，适合存储半结构化和结构化数据
• 多数据中心支持：内置跨区域数据复制机制，满足异地容灾需求
• 高性能读写：优化的存储引擎和缓存机制，支持高吞吐量读写操作
• 容错能力：节点故障不影响集群整体服务，自动修复数据一致性

使用场景和适用范围

• 海量数据存储：日志系统、监控数据、时间序列数据等TB/PB级数据场景
• 高可用业务系统：***交易、电商平台、支付系统等对服务连续性要求极高的业务
• 跨区域分布式应用：全球化业务的多区域部署，实现低延迟访问和异地容灾
• 读写密集型应用：社交媒体、实时分析、物联网数据采集等高并发读写场景
• 弹性扩展需求：业务快速增长，需要动态调整集群规模的弹性架构
• 替代传统关系型数据库：无需复杂事务和Join操作的NoSQL应用场景

详细使用方法和配置说明

基础单节点部署

通过Docker命令快速启动单个Cassandra实例：

bash
docker run --name cassandra -d \
  -p 9042:9042 \  # CQL客户端连接端口
  -p 7000:7000 \  # 节点间通信端口
  -p 7001:7001 \  # SSL节点间通信端口
  -p 7199:7199 \  # JMX监控端口
  -v cassandra-data:/var/lib/cassandra \  # 数据持久化卷
  -e CASSANDRA_CLUSTER_NAME=MyCluster \    # 集群名称
  apache/cassandra:latest

验证部署：

bash
# 连接CQL客户端
docker exec -it cassandra cqlsh

# 查看集群状态
cqlsh> SELECT cluster_name, data_center, host_id, rack FROM system.local;

分布式集群部署（Docker Compose）

使用docker-compose部署3节点Cassandra集群：

yaml
version: '3.8'

services:
  cassandra-seed:
    image: apache/cassandra:latest
    container_name: cassandra-seed
    environment:
      - CASSANDRA_CLUSTER_NAME=ProductionCluster
      - CASSANDRA_SEEDS=cassandra-seed
      - CASSANDRA_DC=DC1
      - CASSANDRA_RACK=Rack1
      - MAX_HEAP_SIZE=4G
      - HEAP_NEWSIZE=1G
    ports:
      - "9042:9042"
    volumes:
      - seed-data:/var/lib/cassandra
    networks:
      - cassandra-network

  cassandra-node1:
    image: apache/cassandra:latest
    container_name: cassandra-node1
    environment:
      - CASSANDRA_CLUSTER_NAME=ProductionCluster
      - CASSANDRA_SEEDS=cassandra-seed
      - CASSANDRA_DC=DC1
      - CASSANDRA_RACK=Rack1
      - MAX_HEAP_SIZE=4G
      - HEAP_NEWSIZE=1G
    volumes:
      - node1-data:/var/lib/cassandra
    networks:
      - cassandra-network
    depends_on:
      - cassandra-seed

  cassandra-node2:
    image: apache/cassandra:latest
    container_name: cassandra-node2
    environment:
      - CASSANDRA_CLUSTER_NAME=ProductionCluster
      - CASSANDRA_SEEDS=cassandra-seed
      - CASSANDRA_DC=DC1
      - CASSANDRA_RACK=Rack1
      - MAX_HEAP_SIZE=4G
      - HEAP_NEWSIZE=1G
    volumes:
      - node2-data:/var/lib/cassandra
    networks:
      - cassandra-network
    depends_on:
      - cassandra-seed

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

networks:
  cassandra-network:
    driver: bridge

启动集群：

bash
docker-compose up -d

验证集群状态：

bash
docker exec -it cassandra-seed nodetool status

环境变量配置参数

常用环境变量配置说明：

自定义配置文件

如需高级配置，可挂载自定义cassandra.yaml文件：

1. 提取默认配置文件：

bash
docker cp cassandra:/etc/cassandra/cassandra.yaml ./custom-cassandra.yaml

2. 修改配置后启动容器：

bash
docker run --name cassandra-custom -d \
  -v ./custom-cassandra.yaml:/etc/cassandra/cassandra.yaml \
  -v cassandra-data:/var/lib/cassandra \
  apache/cassandra:latest

生产环境注意事项

• 资源配置：根据数据量和访问量调整CPU、内存资源，推荐每节点至少4核8GB内存
• JVM优化：设置MAX_HEAP_SIZE不超过32GB（避免JVM压缩指针失效），新生代内存建议为老年代的1/4
• 数据备份：定期备份/var/lib/cassandra目录，或使用sstableloader工具导出数据
• 安全配置：启用认证（authenticator: PasswordAuthenticator）、授权（authorizer: CassandraAuthorizer）和SSL加密
• 监控配置：配置JMX监控和Prometheus指标导出，监控节点状态、性能和数据一致性
• 集群维护：定期运行nodetool repair修复数据一致性，避免长时间不维护导致数据不一致