tendisplus Docker镜像文档

镜像概述与主要用途

本镜像为单节点tendisplus服务的Docker化封装，旨在提供快速部署tendisplus服务的能力。支持单节点模式直接启动，也可通过环境变量配置开启集群模式，适用于快速构建tendisplus运行环境，兼容Redis客户端访问。

核心功能与特性

• 单节点快速部署：无需复杂配置，一键启动tendisplus单节点服务，简化部署流程。
• 集群模式支持：通过环境变量CLUSTER可切换至集群模式，支持构建多节点集群（需配合多实例部署）。
• 密码访问控制：支持通过REDIS_PASSWORD环境变量设置访问密码，默认密码为test。
• Redis协议兼容：可直接使用Redis客户端（如redis-cli）连接和操作，降低使用门槛。

使用场景与适用范围

• 开发测试环境：快速搭建tendisplus服务，用于功能验证、应用调试或集成测试。
• 小型生产环境：单节点部署满足中小规模数据存储需求，简化运维成本。
• 集群测试与评估：通过多节点集群模式部署，用于测试集群功能或评估性能表现。

使用方法与配置说明

环境变量说明

部署示例

1. 单节点无密码（默认密码）部署

默认情况下，服务使用密码test启动，直接映射端口即可访问：

bash
# 启动单节点tendisplus（默认密码test）
docker run -itd -p 51002:51002 tencentdbforkv/tendisplus

2. 单节点带自定义密码部署

通过REDIS_PASSWORD指定自定义密码，增强访问安全性：

bash
# 启动单节点tendisplus（自定义密码为"mypass123"）
docker run -itd -p 51002:51002 \
  --env REDIS_PASSWORD=mypass123 \
  tencentdbforkv/tendisplus

3. 集群模式启动

设置CLUSTER=yes开启集群模式（需配合多实例部署以构建完整集群）：

bash
# 启动集群模式节点（密码为"tendisplustest"）
docker run -itd -p 51002:51002 \
  --env CLUSTER=yes \
  --env REDIS_PASSWORD=tendisplustest \
  tencentdbforkv/tendisplus

注意：集群模式需部署多个节点，并通过tendisplus集群管理工具配置节点间通信，单节点集群仅用于功能测试。

4. Docker Compose部署示例

通过docker-compose.yml定义服务配置，支持批量管理：

yaml
# docker-compose.yml
version: '3'
services:
  tendisplus:
    image: tencentdbforkv/tendisplus
    container_name: tendisplus-node
    ports:
      - "51002:51002"  # 映射服务端口
    environment:
      - REDIS_PASSWORD=mypass123  # 自定义密码
      # - CLUSTER=yes  # 如需集群模式，取消此行注释
    restart: unless-stopped  # 服务异常时自动重启

启动命令：

bash
docker-compose up -d

连接测试

使用Redis客户端（如redis-cli）连接服务，验证部署是否成功：

bash
# 连接默认密码（test）的服务
redis-cli -p 51002 -a test

# 连接自定义密码（如"mypass123"）的服务
redis-cli -p 51002 -a mypass123

连接成功后可执行Redis命令验证，例如：

bash
127.0.0.1:51002> PING
PONG
127.0.0.1:51002> SET demo "hello tendisplus"
OK
127.0.0.1:51002> GET demo
"hello tendisplus"