centos/cassandra-311-centos7

镜像概述和主要用途

本仓库包含用于通用用途和OpenShift的Cassandra镜像Dockerfile。目前仅提供基于CentOS的镜像，可在https://hub.docker.com/r/centos/cassandra-3-centos7/%E8%8E%B7%E5%8F%96%EF%BC%8C%E9%95%9C%E5%83%8F%E5%90%8D%E7%A7%B0%E4%B8%BA%60centos/cassandra-3-centos7%60%E3%80%82

该容器镜像提供容器化的Cassandra守护进程和客户端应用。Cassandra服务器守护进程接受客户端连接，并代表客户端提供对Cassandra数据库内容的访问。更多关于Cassandra项目的信息可访问官方网站：[***]

核心功能和特性

• 容器化部署：简化Cassandra数据库的部署和管理流程
• 环境变量配置：支持通过环境变量自定义数据库参数
• 数据持久化：可挂载主机目录存储数据库数据，确保数据不丢失
• 自定义配置：支持挂载自定义cassandra.yaml和jvm.options文件
• 标准端口暴露：默认暴露集群通信、客户端连接和JMX监控端口

使用场景和适用范围

适用于需要高可扩展性、高可用性的分布式数据库场景，如大规模数据存储、实时数据分析等。可用于开发环境的快速部署和生产环境的稳定运行，满足从测试到大规模应用的不同需求。

使用方法和配置说明

基本使用方法

以下示例基于centos/cassandra-3-centos7镜像。若只需设置必填环境变量并将数据库存储在主机/home/user/database目录，执行以下命令：

bash
$ docker run -d -e CASSANDRA_ADMIN_PASSWORD=<password> -v /home/user/database:/var/opt/rh/sclo-cassandra3/lib/cassandra:Z centos/cassandra-3-centos7

环境变量

初始化容器时，可通过-e VAR=VALUE参数设置以下环境变量：

必填环境变量

可选环境变量（影响Cassandra配置文件）

更多变量详情参见：[***]

卷挂载

可通过-v /host:/container参数挂载以下目录：

注意：从主机挂载目录到容器时，需确保挂载目录具有适当权限，且目录的所有者和组与容器内运行的用户UID或名称匹配。

端口

Cassandra默认使用以下TCP端口：

• 7000：集群通信（启用SSL时为7001）
• 9042：原生协议客户端连接
• 7199：JMX监控

其中，集群通信和原生协议端口可在cassandra.yaml中配置，JMX端口可在cassandra-env.sh中通过JVM选项配置。

硬件要求

• 内存：生产环境32 GB至512 GB，最低8 GB；开发/非负载测试环境至少4 GB
• CPU：生产环境推荐16核CPU；开发/非负载测试环境2核足够
• 磁盘空间：推荐使用SSD，每个节点未压缩数据最大支持3-5 TB
• 网络：推荐带宽1000 Mb/s（千兆）或更高

更多硬件要求详情：[***]

自定义配置文件

支持使用自定义配置文件：

• 自定义cassandra.yaml：挂载到/etc/opt/rh/sclo-cassandra3/cassandra/cassandra.yaml，例如：

  bash
  -v /home/user/cassandra.yaml:/etc/opt/rh/sclo-cassandra3/cassandra/cassandra.yaml:Z
  

• 自定义jvm.options：挂载到/etc/opt/rh/sclo-cassandra3/cassandra/jvm.options，例如：

  bash
  -v /home/user/jvm.options:/etc/opt/rh/sclo-cassandra3/cassandra/jvm.options:Z
  

故障排除

容器内Cassandra守护进程日志输出到标准输出，可通过以下命令查看：

bash
docker logs <container>

官方文档

参见：[***]

参见

镜像的Dockerfile及其他源码：https://github.com/sclorg/cassandra-container
（CentOS的Dockerfile名为Dockerfile，RHEL的Dockerfile（开发中）名为Dockerfile.rhel7）