clickhouse/server-jepsen-test

Jepsen测试服务器镜像

镜像概述和主要用途

本Docker镜像专为Jepsen测试设计，集成了服务器环境，提供一站式分布式系统测试解决方案。Jepsen是一款用于验证分布式系统正确性的工具，可测试系统在网络分区、节点故障等异常场景下的一致性、容错性和数据安全性。该镜像简化了Jepsen测试环境的部署流程，用户无需手动配置复杂的分布式节点，可快速启动测试并获取结果。

核心功能和特性

• 集成Jepsen框架：内置Jepsen测试工具及依赖组件，支持直接运行各类分布式系统测试用例。
• 内置服务器环境：包含测试所需的服务器节点配置，无需额外搭建分布式集群。
• 多场景测试支持：支持测试分布式系统的一致性（如线性izability、因果一致性）、容错性（节点崩溃恢复）、数据一致性（数据同步、副本一致性）等。
• 简化部署流程：通过Docker容器化，避免环境依赖冲突，一键启动测试环境。
• 可配置测试参数：支持自定义测试目标、节点数量、测试时长等参数，灵活适配不同测试需求。

使用场景和适用范围

• 分布式系统开发：开发人员验证分布式数据库、消息队列、分布式存储等系统的正确性。
• 测试环境：QA团队对分布式系统进行自动化一致性、容错性测试。
• 可靠性验证：在系统上线前或版本更新后，验证分布式系统在异常场景下的表现。
• 学习研究：用于分布式系统理论学习，实践Jepsen测试方法和一致性模型验证。

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动Jepsen测试容器：

bash
docker run -d --name jepsen-test \
  -e TARGET=etcd \          # 测试目标系统（如etcd、kafka、zookeeper等）
  -e NODES=5 \              # 测试节点数量（默认3）
  -e DURATION=300 \         # 测试时长（秒，默认300）
  -e TEST_TYPE=consistency  # 测试类型（consistency/fault-tolerance，默认consistency）
  jepsen-test-server:latest

Docker Compose配置示例

创建docker-compose.yml文件，配置多节点测试环境：

yaml
version: '3'
services:
  jepsen:
    image: jepsen-test-server:latest
    environment:
      - TARGET=kafka
      - NODES=3
      - DURATION=600
      - TEST_TYPE=fault-tolerance
    volumes:
      - ./test-results:/jepsen/results  # 挂载测试结果目录
    restart: unless-stopped

启动命令：docker-compose up -d

配置参数说明

测试结果查看

测试完成后，结果默认保存在容器内/jepsen/results目录。通过挂载宿主机目录（如上述示例中的./test-results），可在宿主机查看HTML格式报告、日志文件等测试输出。

注意事项

• 测试分布式系统时，建议根据目标系统调整NODES参数，模拟真实集群规模。
• 部分测试类型（如fault-tolerance）可能需要较长测试时长，建议设置合理的DURATION值。
• 首次运行时，镜像会拉取必要的测试依赖，可能需要较长时间，请确保网络通畅。