materialize/chbench-mysql

MySQL测试容器（集成chbench与Debezium）

镜像概述

该Docker镜像集成chbench（数据库基准测试工具）和Debezium（变更数据捕获工具），提供一站式MySQL测试环境。通过容器化部署，可快速搭建性能测试与CDC功能验证平台，简化测试流程并确保环境一致性。

核心功能与特性

• 性能测试支持：集成chbench工具，模拟多用户并发场景，评估MySQL在不同负载下的吞吐量、响应时间等性能指标。
• CDC功能验证：内置Debezium连接器，捕获MySQL数据变更（插入、更新、删除），验证变更数据同步流程的完整性。
• 环境一致性：容器化部署确保测试环境与依赖工具版本统一，避免环境差异导致的测试结果偏差。
• 灵活配置：通过环境变量配置MySQL连接参数、测试参数及Debezium配置，适应不同测试需求。

使用场景

• 数据库性能评估：在MySQL版本升级、架构调整或优化前后，通过chbench进行基准测试，对比性能差异。
• CDC流程验证：验证Debezium与MySQL集成的变更数据捕获功能，确保数据同步至下游系统（如Kafka、数据仓库）的准确性。
• 集成测试环境：为应用系统提供包含MySQL、性能测试工具及CDC组件的完整测试环境，支持端到端功能与性能测试。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+）及Docker Compose（可选）。
• 目标MySQL数据库需开启binlog，配置binlog_format=ROW以支持Debezium CDC。

基本使用（docker run）

bash
docker run -d \
  --name mysql-test-container \
  -e MYSQL_HOST=mysql.example.com \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=testuser \
  -e MYSQL_PASSWORD=testpass \
  -e MYSQL_DATABASE=testdb \
  -e CHBENCH_DURATION=300 \  # 测试时长（秒）
  -e CHBENCH_CONCURRENCY=10 \  # 并发用户数
  -e DEBEZIUM_OFFSET_STORAGE_FILE=/tmp/offsets.dat \  # Debezium偏移量存储路径
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  mysql-test:
    image: your-image-name:latest
    container_name: mysql-test-container
    environment:
      - MYSQL_HOST=mysql  # 关联同一网络中的MySQL容器
      - MYSQL_PORT=3306
      - MYSQL_USER=root
      - MYSQL_PASSWORD=rootpass
      - MYSQL_DATABASE=benchmark
      - CHBENCH_DURATION=600
      - CHBENCH_CONCURRENCY=20
      - DEBEZIUM_CONNECTOR_NAME=mysql-connector
      - DEBEZIUM_KAFKA_BOOTSTRAP_SERVERS=kafka:9092  # 同步至Kafka
    depends_on:
      - mysql
      - kafka  # 可选，Debezium输出至Kafka时需配置
    networks:
      - test-network

  mysql:
    image: mysql:8.0
    container_name: test-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=benchmark
    command: --binlog-format=ROW --server-id=1  # 开启binlog支持CDC
    networks:
      - test-network

  kafka:
    image: confluentinc/cp-kafka:7.3.0
    container_name: test-kafka
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
    depends_on:
      - zookeeper
    networks:
      - test-network

  zookeeper:
    image: confluentinc/cp-zookeeper:7.3.0
    container_name: test-zookeeper
    environment:
      - ZOOKEEPER_CLIENT_PORT=2181
    networks:
      - test-network

networks:
  test-network:

关键环境变量说明

测试结果查看

• chbench性能测试结果输出至容器日志，通过docker logs mysql-test-container查看。
• Debezium捕获的变更数据根据配置输出至Kafka主题或本地文件，路径由DEBEZIUM_OFFSET_STORAGE_FILE等参数指定。