You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/platform/guides/database-management/create-database/redis.md
+24-1Lines changed: 24 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,10 +32,33 @@ Select the topology under **Database Mode**. Three modes are available:
32
32
|**Cluster**|**Master** count and **Replicas** per master. |
33
33
|**Sentinel**|**Number of Replicas** and the referenced **Sentinel** instance. |
34
34
35
+
## Announce Redis Endpoints (Cluster Mode Only)
36
+
37
+
> **Important — required if you plan to expose a Cluster-mode Redis externally.** The default external endpoint (via **Expose via Gateway**, see [Additional Options](common-steps.md#6-additional-options)) is a single Kubernetes Service that load-balances across *all* pods in *all* shards. Redis Cluster clients don't work well with that: a client's request is only served correctly if the pod it happens to connect to owns the requested key's slot — otherwise Redis replies with a redirect to the internal pod IP, which the external client cannot reach and the connection times out.
38
+
>
39
+
> Toggling on **Announce Redis Endpoints** tells each Redis node to advertise its externally reachable address instead of its internal IP, so redirects point somewhere the client can actually connect to.
40
+
41
+
If **Database Mode** is **Cluster**, an **Announce Redis Endpoints ?** toggle appears below **Storage Size**. Turn it on to reveal the **Announce** panel:
42
+
43
+

44
+
45
+
| Field | Description |
46
+
|---|---|
47
+
|**Type**| How the endpoint is advertised to clients — `hostname` or `ip`. Ask your cluster administrator which one your externally reachable Redis endpoints use. |
48
+
|**Shards**| One row per shard, in the same order the shards are provisioned (shard 0, shard 1, …). Each row's **Shard Endpoints** field takes a comma-separated list of the externally reachable endpoints for every node (master + replicas) in that shard. Use **+ Add new** to add a row if you have more shards than rows shown. |
49
+
50
+
The number of shard rows must match the **Shards** count you set above, and each row must list one endpoint per node in that shard (master + replicas).
51
+
52
+
You will need the externally reachable hostname or IP for every Redis pod before filling this in — get these from whoever set up the external gateway/DNS/load balancer for this cluster. All the underlying setup (gateway, DNS records, port mappings) is handled on the platform side; you only need to enter the resulting endpoints here.
53
+
54
+
> **Note:** This only applies when you intend to connect to a **Cluster**-mode Redis from outside Kubernetes. If you only access it from within the cluster, or you're using **Standalone**/**Sentinel** mode, leave this off.
55
+
56
+
For the underlying mechanism, see the [Redis External Connections guide](https://kubedb.com/docs/v2026.6.19/guides/redis/external-connections/exposure/).
57
+
35
58
## Create a Redis Database
36
59
37
60
1. Open the wizard and select **Redis** — see [Getting Started](common-steps.md#1-getting-started) and [Select a Database Type](common-steps.md#2-select-a-database-type).
38
61
1. Set the [namespace and name](common-steps.md#3-choose-namespace-and-name).
39
-
1. Pick the database version and the **Database Mode** described above, then set the machine profile and storage — see [Configure the Database](common-steps.md#4-configure-the-database).
62
+
1. Pick the database version and the **Database Mode** described above, then set the machine profile and storage — see [Configure the Database](common-steps.md#4-configure-the-database). For **Cluster** mode, configure [Announce Redis Endpoints](#announce-redis-endpoints-cluster-mode-only) if you'll expose it externally.
0 commit comments