oscerd/cassandra

oscerd/cassandra镜像中文文档

镜像概述

本镜像基于Ubuntu系统构建，提供多个版本的Apache Cassandra（覆盖2.0.0至3.11.3），主要用于开发环境快速部署Cassandra单节点或多节点集群，支持集群配置验证、数据操作练习等开发场景。

核心功能

1. 支持多版本Cassandra：涵盖2.0.x、2.1.x、2.2.x、3.0.x、3.11.x系列版本；
2. 集群构建：通过SEED环境变量指定种子节点IP，自动配置cassandra.yaml实现集群节点加入；
3. 容器管理：提供容器连接、集群状态检查、数据操作的完整流程示例；
4. 轻量便捷：基于Ubuntu基础镜像，部署快速，适合开发环境使用。

使用场景

1. 开发阶段的Cassandra应用本地测试；
2. 学习Cassandra集群搭建与数据操作；
3. 验证Cassandra多版本兼容性。

配置说明

• SEED环境变量：用于指定集群种子节点IP，当启动节点时设置该变量，镜像会自动将种子节点信息写入cassandra.yaml配置文件，实现节点加入集群。

部署示例

1. 拉取镜像

拉取默认版本（3.11.3）：

shell
docker pull docker.xuanyuan.run/oscerd/cassandra

拉取指定版本（如3.11.2）：

shell
docker pull docker.xuanyuan.run/oscerd/cassandra:cassandra-3.11.2

2. 运行单节点

shell
docker run --name master_node -dt docker.xuanyuan.run/oscerd/cassandra

3. 构建4节点集群

• 启动主节点（种子节点）：

  shell
  docker run --name master_node -dt docker.xuanyuan.run/oscerd/cassandra
  

• 加入节点1：

  shell
  docker run --name node1 -d -e SEED="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' master_node)" docker.xuanyuan.run/oscerd/cassandra
  

• 加入节点2：

  shell
  docker run --name node2 -d -e SEED="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' master_node)" docker.xuanyuan.run/oscerd/cassandra
  

• 加入节点3：

  shell
  docker run --name node3 -d -e SEED="$(docker inspect --format='{{ .NetworkSettings.IPAddress }}' master_node)" docker.xuanyuan.run/oscerd/cassandra
  

4. 检查集群状态

shell
docker exec -ti master_node /opt/cassandra/bin/nodetool status

5. 连接容器并操作数据

假设本地已安装Cassandra，连接主节点：

shell
<本地Cassandra路径>/bin/cqlsh $(docker inspect --format='{{ .NetworkSettings.IPAddress }}' master_node)

创建键空间和表：

shell
create keyspace test with replication = {'class':'SimpleStrategy', 'replication_factor':3};
use test;
create table users ( id int primary key, name text );
insert into users (id,name) values (1, 'oscerd');

6. 连接运行中的容器

shell
docker exec -ti <容器名称> /bin/bash