TiPocket 使用教程

项目介绍

TiPocket 是一个专为测试 TiDB 设计的测试工具包。它封装了一些适用于测试其他数据库的测试工具。TiPocket 受到 jepsen-io/jepsen 的启发，专注于 TiDB 的稳定性测试，并使用 chaos-mesh 在 TiDB 集群中注入各种故障。

项目快速启动

环境要求

• TiDB Operator >= v1.1.9
• Chaos Mesh >= v1.1.0

快速启动步骤

1. 克隆项目

   git clone https://github.com/pingcap/tipocket.git
   cd tipocket
   

2. 构建项目

   make build
   

3. 初始化测试案例

   go run cmd/tipocket/main.go init -c demo
   

4. 在 K8s 集群上部署和运行案例

   export KUBECONFIG=[YOUR_KUBECONFIG_PATH]
   make build
   bin/[testcase] -namespace=[ns] -hub=docker.io -image-version=nightly -storage-class=local-path
   

应用案例和最佳实践

使用 go-sqlsmith 进行模糊测试

go-sqlsmith 是一个基于 Go 实现的模糊测试工具，可以生成随机的 MySQL 方言 SQL 查询。以下是一个简单的使用案例：

go run cmd/go-sqlsmith/main.go -dsn "user:password@tcp(127.0.0.1:4000)/test"

使用 go-elle 进行事务一致性检查

go-elle 是一个通用的黑盒数据库事务一致性检查器。以下是一个简单的使用案例：

go run cmd/go-elle/main.go -dsn "user:password@tcp(127.0.0.1:4000)/test"

典型生态项目

Chaos Mesh

Chaos Mesh 是一个云原生混沌工程平台，用于在 Kubernetes 环境中模拟各种故障。它是 TiPocket 的核心依赖之一，用于在 TiDB 集群中注入故障。

TiDB Operator

TiDB Operator 是 Kubernetes 上的 TiDB 集群自动运维系统，提供包括部署、升级、扩缩容、备份恢复、配置变更的 TiDB 全生命周期管理。

通过这些工具和项目的结合使用，可以有效地进行 TiDB 的稳定性测试和故障注入，确保 TiDB 在各种复杂环境下的稳定运行。