apache/cassandra-testing-ubuntu2004-java11

Apache Cassandra Testing Docker 镜像文档

镜像概述和主要用途

Apache Cassandra Testing Docker 镜像专为简化 Cassandra 数据库的测试流程而设计。该镜像基于官方 Cassandra 构建，集成了一系列测试工具和预配置环境，旨在帮助开发人员和测试工程师快速搭建一致的测试环境，执行单元测试、集成测试和性能测试。

核心功能和特性

• 基于最新稳定版 Apache Cassandra 构建
• 集成 Apache Maven 和 Gradle 构建工具
• 预配置 JUnit、TestNG 测试框架
• 包含 Cassandra 压力测试工具 (cassandra-stress)
• 支持多版本 Cassandra 兼容性测试
• 内置测试报告生成工具
• 轻量级设计，优化测试启动时间
• 支持自定义测试脚本和扩展

使用场景和适用范围

• Cassandra 开发人员的本地测试环境
• CI/CD 流水线中的自动化测试环节
• Cassandra 功能验证和回归测试
• 集群配置和部署策略测试
• 性能基准测试和压力测试
• 多节点集群模拟测试
• 培训和学习环境

使用方法和配置说明

基本使用方法

拉取镜像

bash
docker pull apache/cassandra-testing:latest

简单启动测试环境

bash
docker run -d --name cassandra-test apache/cassandra-testing:latest

执行默认测试套件

bash
docker exec -it cassandra-test run-tests

Docker Compose 配置示例

yaml
version: '3.8'

services:
  cassandra-test:
    image: apache/cassandra-testing:latest
    container_name: cassandra-test
    environment:
      - CASSANDRA_VERSION=4.0.0
      - TEST_SUITE=integration
      - CASSANDRA_CLUSTER_SIZE=3
      - TEST_DURATION=30m
    volumes:
      - ./test-reports:/opt/cassandra/test-reports
      - ./custom-tests:/opt/cassandra/custom-tests
    ports:
      - "9042:9042"  # Cassandra CQL 端口
      - "7199:7199"  # JMX 监控端口
    networks:
      - cassandra-test-network

networks:
  cassandra-test-network:
    driver: bridge

环境变量配置

卷挂载配置

自定义测试命令

bash
# 运行指定测试类
docker exec -it cassandra-test mvn test -Dtest=com.example.MyTestClass

# 运行性能测试
docker exec -it cassandra-test cassandra-stress write n=100000 -rate threads=8

# 生成测试报告
docker exec -it cassandra-test generate-report --format html --output /opt/cassandra/test-reports

CI/CD 集成示例 (GitHub Actions)

yaml
name: Cassandra Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3
      
      - name: Start Cassandra test container
        run: |
          docker run -d -v ${{ github.workspace }}/tests:/opt/cassandra/custom-tests \
                     -v ${{ github.workspace }}/reports:/opt/cassandra/test-reports \
                     --name cassandra-test apache/cassandra-testing:latest
      
      - name: Run custom tests
        run: docker exec cassandra-test run-custom-tests /opt/cassandra/custom-tests
      
      - name: Upload test reports
        uses: actions/upload-artifact@v3
        with:
          name: test-reports
          path: reports/

高级配置

多节点集群测试

bash
docker run -d --name cassandra-test-node1 \
  -e CASSANDRA_VERSION=4.0.0 \
  -e CASSANDRA_CLUSTER_SIZE=3 \
  -e CASSANDRA_SEED=node1 \
  apache/cassandra-testing:latest

docker run -d --name cassandra-test-node2 \
  --link cassandra-test-node1:node1 \
  -e CASSANDRA_VERSION=4.0.0 \
  -e CASSANDRA_CLUSTER_SIZE=3 \
  -e CASSANDRA_SEED=node1 \
  apache/cassandra-testing:latest

docker run -d --name cassandra-test-node3 \
  --link cassandra-test-node1:node1 \
  -e CASSANDRA_VERSION=4.0.0 \
  -e CASSANDRA_CLUSTER_SIZE=3 \
  -e CASSANDRA_SEED=node1 \
  apache/cassandra-testing:latest

版本兼容性测试

bash
docker run -it --rm \
  -e CASSANDRA_VERSION=3.11.14 \
  -e TEST_TARGET_VERSION=4.0.0 \
  -e TEST_COMPATIBILITY=true \
  apache/cassandra-testing:latest run-compatibility-tests

性能测试配置

bash
docker run -d --name cassandra-perf-test \
  -e CASSANDRA_VERSION=4.0.0 \
  -e TEST_SUITE=performance \
  -e TEST_DURATION=60m \
  -e TEST_THREADS=16 \
  -e TEST_WORKLOAD=read \
  apache/cassandra-testing:latest

故障排除

查看测试日志

bash
docker logs -f cassandra-test

进入容器调试

bash
docker exec -it cassandra-test /bin/bash

常见问题解决

1. 测试超时: 增加测试超时时间 -e TEST_TIMEOUT=300
2. 内存不足: 增加容器内存限制 --memory=4g --memory-swap=4g
3. 端口冲突: 自定义端口映射 -p 9043:9042
4. 配置不生效: 确认挂载配置目录的权限设置
5. 测试报告为空: 检查测试命令是否正确执行

维护和更新

• 定期更新镜像以获取最新安全补丁: docker pull apache/cassandra-testing:latest
• 清理旧测试数据: docker volume prune
• 监控镜像更新: 关注 https://github.com/apache/cassandra-builds 项目

相关资源

• Apache Cassandra 官方文档
• https://github.com/apache/cassandra-builds/tree/trunk/docker/testing
• Cassandra 测试最佳实践
• https://hub.docker.com/r/apache/cassandra-testing