webscam/cassandra

关于本仓库

这是Webscam Cassandra Docker镜像的Git仓库，是官方https://registry.hub.docker.com/_/cassandra/%E9%95%9C%E5%83%8F%E7%9A%84%E5%88%86%E6%94%AF%EF%BC%8C%E9%92%88%E5%AF%B9Docker Swarm模式做了适配修改。更多使用设置、贡献与问题信息，请参考https://registry.hub.docker.com/_/cassandra/%E3%80%82

Docker Swarm模式适配

Docker 1.12引入的Swarm模式实现自动服务编排，提升扩展与可用性，但早期版本存在Cassandra集群部署问题：

1. 虚拟IP与网格网络导致种子节点引导困难；
2. ingress网络新增接口，破坏hostname -i的广告主机名功能。

后续版本修复了这些问题，本文方法仅适用于Docker 17.03.0及以上。

使用方法

单节点/无挂载点

bash
# 初始化Swarm与网络
docker swarm init
docker network create -d overlay mynetwork

# 启动Cassandra服务
docker service create \
  --name cassandra \
  --network mynetwork \
  -e HEAP_NEWSIZE=12M \
  -e MAX_HEAP_SIZE=64M \
  webscam/cassandra:swarm_test

# 扩展服务（需逐个操作）
docker service scale cassandra=2
docker service scale cassandra=3

# 检查集群状态
docker exec -it $(docker ps | grep cassandra.1 | awk '{print $1}') nodetool status

多节点带卷挂载

bash
# 创建Swarm节点
docker-machine create -d virtualbox master node1 node2

# 初始化Swarm并加入节点
master_ip=$(docker-machine ip master)
docker $(docker-machine config master) swarm init --advertise-addr $master_ip
join_token=$(docker $(docker-machine config master) swarm join-token worker -q)
docker $(docker-machine config node1) swarm join --token $join_token $master_ip:2377
docker $(docker-machine config node2) swarm join --token $join_token $master_ip:2377

# 创建网络与目录服务
eval $(docker-machine env master)
docker network create -d overlay your_overlay_network
docker service create --name makedir -t --mode global --mount type=bind,dst=/home,src=/home alpine sh -c "mkdir -p /home/cassandra; sh"

# 启动持久化Cassandra服务
docker service create \
  --name cassandra \
  --network your_overlay_network \
  --update-delay 40s \
  --mode global \
  --mount type=bind,target=/var/lib/cassandra,source=/home/cassandra \
  webscam/cassandra:swarm_test

配置选项

• CASSANDRA_SEEDS: 逗号分隔的种子IP列表，默认auto（从tasks.$SERVICE_NAME DNS获取）；
• SERVICE_NAME: Swarm服务名称，默认cassandra，用于DNS查找集群节点。

维护注意事项

节点替换

• 非持久化服务：需确保Docker复用旧IP；
• 持久化服务：节点死亡需手动执行替换流程。

节点修复

需按gc_grace_period间隔在各节点依次运行nodetool repair，建议外部脚本化或手动干预。