redislabs/client-libs-test

Redis客户端库测试镜像

概述

本镜像专为测试Redis客户端库设计，提供标准化的测试环境，确保客户端库在不同Redis版本、配置及部署模式下的兼容性、稳定性与功能完整性。通过预配置的测试场景和轻量级架构，简化客户端库开发过程中的测试流程。

主要特性

• 多版本兼容：支持Redis 4.x至7.x主流版本，可通过环境变量指定目标测试版本
• 场景化测试：内置常用测试场景，包括基础连接、数据结构操作、连接池性能、持久化验证及集群模式模拟
• 轻量高效：基于Alpine Linux构建，镜像体积小，启动速度快
• CI/CD集成：支持与Jenkins、GitHub Actions等工具集成，实现自动化测试流程

使用场景

• 客户端库开发阶段的本地功能验证与调试
• CI/CD流水线中客户端库的自动化回归测试
• 跨Redis版本兼容性验证
• 客户端异常场景（网络中断、节点故障）的容错能力测试

Docker部署方案示例

基础测试场景

bash
docker run -d \
  --name redis-client-test \
  -v /local/test-scripts:/tests \
  -e REDIS_VERSION=7.0 \
  -e TEST_MODE=basic \
  redis-client-test-image:latest

集群模式测试

bash
docker run -d \
  --name redis-cluster-test \
  -v /local/cluster-tests:/tests \
  -e REDIS_VERSION=6.2 \
  -e TEST_MODE=cluster \
  -e CLUSTER_NODES=3 \
  redis-client-test-image:latest

说明：

• /local/test-scripts：宿主机测试脚本目录，容器将自动执行该目录下的测试用例
• REDIS_VERSION：指定测试目标Redis版本（默认6.2）
• TEST_MODE：测试模式，可选值：basic（基础测试）、cluster（集群测试）、persistence（持久化测试）
• CLUSTER_NODES：集群模式下的节点数量（仅TEST_MODE=cluster时生效，默认3）

注意事项

• 本镜像仅用于测试环境，不建议生产环境部署
• 确保宿主机与容器网络互通，如需外部Redis服务，可通过REDIS_HOST环境变量指定（默认使用容器内置实例）
• 集群模式测试建议分配至少2GB内存，避免节点启动失败