使用bitnami镜像在K8s上通过Docker启动单节点Redis Cluster失败如何解决

首先明确：可以启动单节点Redis Cluster，你遇到的两个核心问题分别是「集群哈希槽未全量分配」和「节点广播地址为Docker容器内网IP，导致外部客户端无法连接」，可按以下步骤解决：

1. 修改容器启动参数，配置对外广播的地址端口 #

你原来的启动命令缺少集群广播相关配置，Redis Cluster默认会取节点自身的网卡IP对外广播，容器内默认获取的是Docker分配的内网IP（即你报错中的172.17.0.4），外部客户端拿到这个内网IP自然无法连通。
修改后完整启动命令如下：

docker run --name redis-cluster \
-e ALLOW_EMPTY_PASSWORD=yes \
-e REDIS_NODES=1 \
-e REDIS_PORT_NUMBER=30001 \
-p 30001:30001 \
-e REDIS_REPLICATION_MODE=master \
-e REDIS_CLUSTER_ANNOUNCE_IP=127.0.0.1 \
-e REDIS_CLUSTER_ANNOUNCE_PORT=30001 \
bitnami/redis-cluster:latest

参数REDIS_CLUSTER_ANNOUNCE_IP和REDIS_CLUSTER_ANNOUNCE_PORT是指定Redis对外广播的宿主机IP和端口，客户端拿到这个地址就能正常访问。

2. 给单节点分配全部16384个哈希槽 #

你执行CLUSTER INFO看到cluster_slots_assigned:0就是因为未分配哈希槽，Redis Cluster要求16384个哈希槽全部分配完成后，集群状态才会变为ok，才能处理读写请求。
执行以下命令完成槽位分配：

# 批量分配0-16383所有槽到当前节点
for i in {0..16383}; do redis-cli -p 30001 CLUSTER ADDSLOTS $i; done

分配完成后再执行CLUSTER INFO验证，可看到cluster_state:ok、cluster_slots_assigned:16384。

3. 客户端连接验证 #

Python 客户端 #

分配完槽位后你原来的代码即可正常运行，如果仍有槽位覆盖提示，可添加skip_full_coverage_check=True参数：

from rediscluster import RedisCluster
startup_nodes = [{"host": "127.0.0.1", "port": "30001"}]
rc = RedisCluster(startup_nodes=startup_nodes, decode_responses=True, skip_full_coverage_check=True)
rc.set("foo", "bar")
print(rc.get("foo")) # 输出bar即为运行正常

Java Lettuce 客户端 #

直接配置127.0.0.1:30001作为集群启动节点即可，不会再出现连接172.17.0.4的超时错误。

内容的提问来源于stack exchange，提问作者best wishes