Skip to content

Commit 4d5ba80

Browse files
yroblaclaude
andcommitted
Clarify Redis session routing is conditional on Redis being configured
When backendReplicas > 1, the proxy runner only uses Redis for session-to-pod routing when Redis session storage is actually configured. The previous wording implied Redis was always used, then contradicted itself in the next paragraph. Closes #727 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent baf0a15 commit 4d5ba80

1 file changed

Lines changed: 9 additions & 9 deletions

File tree

docs/toolhive/guides-k8s/run-mcp-k8s.mdx

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -457,15 +457,15 @@ actual MCP server and executes tools.
457457

458458
MCP connections are stateful: once a client establishes a session with a
459459
specific backend pod, all subsequent requests in that session must reach the
460-
same pod. When `backendReplicas > 1`, the proxy runner uses Redis to store a
461-
session-to-pod mapping so every proxy runner replica knows which backend pod
462-
owns each session.
463-
464-
Without Redis, the proxy runner falls back to Kubernetes client-IP session
465-
affinity on the backend Service, which is unreliable behind NAT or shared egress
466-
IPs. If a backend pod is restarted or replaced, its entry in the Redis routing
467-
table is invalidated and the next request reconnects to an available pod —
468-
sessions are not automatically migrated between pods.
460+
same pod. When `backendReplicas > 1` and Redis session storage is configured,
461+
the proxy runner uses Redis to store a session-to-pod mapping so every proxy
462+
runner replica knows which backend pod owns each session.
463+
464+
Without Redis session storage, the proxy runner relies on Kubernetes client-IP
465+
session affinity on the backend Service, which is unreliable behind NAT or
466+
shared egress IPs. If a backend pod is restarted or replaced, its entry in the
467+
Redis routing table is invalidated and the next request reconnects to an
468+
available pod — sessions are not automatically migrated between pods.
469469

470470
:::note
471471

0 commit comments

Comments
 (0)