Apache Cassandra测试Docker镜像文档

1. 镜像概述

本镜像为Apache Cassandra官方提供的测试专用Docker镜像，由apache/cassandra-builds项目维护（源码位于[***]

2. 核心功能与特性

2.1 多版本测试支持

• 支持构建和测试多个Cassandra版本（通过指定构建参数可切换不同分支/标签）
• 兼容不同JDK版本（如OpenJDK 8/11/17）的测试环境配置

2.2 测试工具集成

• 内置Cassandra测试框架（如JUnit测试套件、cassandra-dtest）
• 集成常用测试工具（cqlsh、nodetool、stress测试工具）

2.3 配置灵活性

• 支持通过环境变量快速调整关键测试参数（集群规模、节点配置、存储引擎等）
• 允许挂载自定义测试脚本、配置文件和测试数据集

2.4 隔离测试环境

• 提供独立的网络和存储隔离，避免测试环境相互干扰
• 支持单节点和多节点集群测试拓扑

2.5 自动化测试支持

• 兼容主流CI/CD工具（Jenkins、GitHub Actions等）
• 支持测试结果输出与日志收集，便于问题定位

3. 使用场景

3.1 开发阶段测试

• 开发人员验证代码变更对Cassandra核心功能的影响
• 快速测试新特性或修复补丁的有效性

3.2 版本兼容性验证

• QA团队测试不同Cassandra版本间的数据迁移兼容性
• 验证客户端驱动与Cassandra服务端的版本匹配性

3.3 CI/CD流程集成

• 作为持续集成 pipeline 的测试环节，自动验证代码提交质量
• 在发布流程中执行自动化功能测试和性能测试

3.4 学***与研究

• 构建隔离的测试环境，学***Cassandra集群配置和故障处理
• 复现特定问题或测试边缘场景

4. 使用方法

4.1 获取镜像

该测试镜像需从源码构建（目前未发布至Docker Hub），构建步骤如下：

# 克隆源码仓库
git clone [***]
cd cassandra-builds/docker/testing

# 构建镜像（可指定CASSANDRA_VERSION和JDK版本）
docker build --build-arg CASSANDRA_VERSION=4.1.3 --build-arg JDK_VERSION=11 -t apache/cassandra-test:4.1.3-jdk11 .

4.2 基本运行命令

启动单节点测试环境：

docker run -d \
  --name cassandra-test-node \
  -p 9042:9042 \  # CQL端口
  -p 7199:7199 \  # JMX端口
  apache/cassandra-test:4.1.3-jdk11

4.3 自定义测试配置

4.3.1 通过环境变量配置

常用环境变量：

示例：启动集成测试模式的节点

docker run -d \
  --name cassandra-integration-test \
  -e TEST_MODE=integration \
  -e CASSANDRA_CLUSTER_NAME=IntegrationTest \
  apache/cassandra-test:4.1.3-jdk11

4.3.2 挂载测试脚本和数据

挂载本地测试脚本至容器：

docker run -d \
  --name cassandra-custom-test \
  -v $(pwd)/test-scripts:/opt/cassandra/test-scripts \  # 挂载测试脚本目录
  -v $(pwd)/test-data:/opt/cassandra/test-data \        # 挂载测试数据集
  apache/cassandra-test:4.1.3-jdk11 \
  /opt/cassandra/test-scripts/run-custom-tests.sh      # 执行自定义测试脚本

4.4 多节点集群测试示例（docker-compose）

创建docker-compose.yml：

version: '3'
services:
  cassandra-seed:
    image: apache/cassandra-test:4.1.3-jdk11
    container_name: cassandra-seed
    environment:
      - CASSANDRA_CLUSTER_NAME=MultiNodeTest
      - CASSANDRA_NUM_TOKENS=128
      - CASSANDRA_SEEDS=cassandra-seed  # 种子节点指向自身
    ports:
      - "9042:9042"
    networks:
      - cassandra-test-net

  cassandra-node1:
    image: apache/cassandra-test:4.1.3-jdk11
    container_name: cassandra-node1
    environment:
      - CASSANDRA_CLUSTER_NAME=MultiNodeTest
      - CASSANDRA_NUM_TOKENS=128
      - CASSANDRA_SEEDS=cassandra-seed  # 连接种子节点
    depends_on:
      - cassandra-seed
    networks:
      - cassandra-test-net

  cassandra-node2:
    image: apache/cassandra-test:4.1.3-jdk11
    container_name: cassandra-node2
    environment:
      - CASSANDRA_CLUSTER_NAME=MultiNodeTest
      - CASSANDRA_NUM_TOKENS=128
      - CASSANDRA_SEEDS=cassandra-seed
    depends_on:
      - cassandra-seed
    networks:
      - cassandra-test-net

networks:
  cassandra-test-net:
    driver: bridge

启动集群并执行测试：

# 启动集群
docker-compose up -d

# 进入种子节点执行集群状态检查
docker exec -it cassandra-seed nodetool status

# 执行分布式测试脚本
docker exec -it cassandra-seed /opt/cassandra/test-scripts/run-cluster-tests.sh

4.5 测试结果查看

测试日志默认输出至容器/var/log/cassandra/test.log，可通过以下命令查看：

docker exec -it cassandra-test-node cat /var/log/cassandra/test.log

或挂载日志目录至本地：

docker run -d \
  -v $(pwd)/test-logs:/var/log/cassandra \
  apache/cassandra-test:4.1.3-jdk11

5. 注意事项

• 该镜像仅用于测试目的，不建议用于生产环境
• 测试数据默认存储于容器内部，如需持久化需挂载数据卷
• 高版本JDK可能需要调整JVM参数，可通过JVM_OPTS环境变量自定义
• 多节点测试需确保容器间网络互通（推荐使用自定义bridge网络）