Apache Cassandra 测试 Docker 镜像

1. 镜像概述和主要用途

Apache Cassandra 测试 Docker 镜像是由 Apache Cassandra 项目官方提供的专用测试环境镜像。该镜像基于官方 Cassandra 构建流程，旨在为开发人员和测试人员提供一个标准化、可重复的测试环境，用于验证 Cassandra 功能、性能和兼容性。

主要用途包括：

• Cassandra 单元测试和集成测试执行
• 多版本兼容性验证
• 集群配置测试
• 自动化测试流程集成
• 开发环境快速部署

2. 核心功能和特性

• 基于官方 Cassandra 源代码构建，确保测试环境准确性
• 预配置测试工具和依赖项，减少环境准备时间
• 支持多种测试场景和配置模式
• 包含完整的 Cassandra 构建和测试工具链
• 支持自定义测试参数和环境配置
• 兼容主流 CI/CD 系统集成

3. 使用场景和适用范围

适用场景

• Cassandra 源代码修改验证
• 新功能开发测试
• 回归测试执行
• 性能基准测试
• 集群部署模式验证
• 故障恢复机制测试

适用范围

• Cassandra 项目贡献者
• 企业级 Cassandra 应用开发团队
• 数据库管理员进行部署测试
• 质量保证团队执行自动化测试
• 研究人员分析 Cassandra 行为特性

4. 使用方法和配置说明

4.1 基本使用流程

4.1.1 获取源代码和构建镜像

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

# 构建测试镜像
docker build -t apache/cassandra-testing .

4.1.2 基本测试运行

# 运行默认测试套件
docker run --rm apache/cassandra-testing

4.2 环境变量配置

4.3 高级使用方法

4.3.1 运行指定测试类

docker run --rm -e TEST_CLASS=org.apache.cassandra.service.StorageServiceTest apache/cassandra-testing

4.3.2 运行集成测试

docker run --rm -e TEST_SUITE=integration apache/cassandra-testing

4.3.3 挂载本地代码进行开发测试

docker run --rm -v /path/to/local/cassandra/src:/cassandra-src \
  -e CASSANDRA_VERSION=local \
  apache/cassandra-testing

5. Docker 部署方案示例

5.1 基本 Docker Run 命令

# 运行性能测试
docker run --rm -e TEST_SUITE=stress -e HEAP_SIZE=4G \
  --name cassandra-stress-test apache/cassandra-testing

5.2 Docker Compose 集群测试配置

version: '3.8'

services:
  cassandra-test-node1:
    image: apache/cassandra-testing
    container_name: cassandra-test-node1
    environment:
      - CASSANDRA_VERSION=4.0.0
      - TEST_SUITE=cluster
      - HEAP_SIZE=4G
      - SEEDS=cassandra-test-node1,cassandra-test-node2
    volumes:
      - test-reports:/cassandra/test/reports

  cassandra-test-node2:
    image: apache/cassandra-testing
    container_name: cassandra-test-node2
    environment:
      - CASSANDRA_VERSION=4.0.0
      - TEST_SUITE=cluster
      - HEAP_SIZE=4G
      - SEEDS=cassandra-test-node1,cassandra-test-node2
    depends_on:
      - cassandra-test-node1
    volumes:
      - test-reports:/cassandra/test/reports

volumes:
  test-reports:

5.3 CI/CD 集成示例 (GitHub Actions)

name: Cassandra Test

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Build test image
        run: |
          cd docker/testing
          docker build -t apache/cassandra-testing .
      
      - name: Run unit tests
        run: |
          docker run --rm -v ${{ github.workspace }}/test-reports:/cassandra/test/reports \
            -e TEST_SUITE=unit \
            apache/cassandra-testing
      
      - name: Upload test results
        uses: actions/upload-artifact@v3
        with:
          name: test-reports
          path: test-reports/

6. 测试结果和报告

测试完成后，结果将输出到容器内的 /cassandra/test/reports 目录。要获取测试报告，可以使用以下命令:

# 从运行中的容器复制报告
docker cp cassandra-test:/cassandra/test/reports ./local-reports

# 或在容器启动时挂载报告目录
docker run --rm -v $(pwd)/reports:/cassandra/test/reports apache/cassandra-testing

报告包含:

• 测试摘要和通过/失败统计
• 详细的测试日志
• 性能测试指标(如适用)
• JUnit 兼容的 XML 报告

7. 故障排除

7.1 常见问题解决

1. 测试超时

   • 增加 HEAP_SIZE 环境变量
   • 通过 -e PARALLEL=false 禁用并行测试
   • 调整测试超时参数

2. 内存不足错误

   • 增加 Docker 可用内存资源
   • 减少并行测试线程数
   • 增加 HEAP_SIZE 配置

3. 测试环境不一致

   • 使用指定的 CASSANDRA_VERSION 版本
   • 确保使用最新的测试镜像

7.2 查看详细日志

docker logs <container_id>

或实时查看日志:

docker logs -f <container_id>