RedisRaft - 使用说明

2024-04-14 发布于文章 800 字 2 分钟

Redis

从官方仓库看测试可以分为两大类：

功能测试：即单元测试、集成测试，https://github.com/RedisLabs/redisraft/tree/master/tests
正确性测试：即混动工程测试，https://github.com/RedisLabs/redisraft/tree/master/jepsen

一、功能测试

基于docker运行测试case

先运行一个容器

docker pull debian:buster
docker run -d debian:buster -- tail
docker exec -it 121df5d7a654 bash

进入容器后安装一些工具

apt-get -y -q update && apt-get install -qqy git wget build-essential virtualenv cmake

拉取redis、redisraft代码并编译

cd ~
git clone https://github.com/redis/redis.git
cd redis
make
cd ..

git clone https://github.com/RedisLabs/redisraft
cd redisraft 
mkdir build && cd build
cmake .. && make
cd ..

运行测试case

mkdir -p .env
virtualenv --python=python3 .env
. .env/bin/activate
pip install -r tests/integration/requirements.txt
cd build
make tests

测试结果

集成测试
单元测试
详细日志 test.log
如果要单独跑某个case

cd ~/redisraft
pytest tests/integration/test_snapshots.py::test_snapshot_delivery -v --log-cli-level=debug

二、正确性测试

2.1说明

基于Jepsen构建

Jepsen是Kyle Kingsbury使用Clojure编写的分布式系统测试框架。Clojure是运行在JVM之上的Lisp方言，提供了强大的函数式编程的支持。Leiningen是Clojure的项目构建工具，类似于Maven。事实上，Leiningen底层完全使用Maven的包管理机制，只是Leiningen的构建脚本不是pom.xml，而是project.clj，它本身就是Clojure代码。

2.2 在docker中运行

cd jepsen/docker
./genkeys.sh
docker-compose build
docker-compose up -d
docker exec -w /jepsen jepsen-control \
    lein run test-all --ssh-private-key /root/.ssh/id_rsa \
        --follower-proxy \
        --time-limit 600 \
        --test-count 50 \
        --concurrency 4n \
        --nemesis partition,pause,kill,member \
        --redis-repo https://github.com/redis/redis \
        --redis-version unstable \
        --raft-repo https://github.com/redislabs/redisraft \
        --raft-version master

执行完前四个命令行后会发现启动了如下容器：