Clarify Redis session routing is conditional on Redis being configured

[yrobla]

Summary

• Makes it explicit that Redis-backed session-to-pod routing only applies when Redis session storage is configured, not unconditionally whenever backendReplicas > 1
• Replaces "falls back to" (implying Redis is the default) with "relies on" to avoid the implication that client-IP affinity is a fallback from an always-on Redis path

Closes #727

Type of change

• Documentation update

Test plan

• Diff reviewed — wording matches the proposed fix from the Copilot review comment on PR Explain proxyrunner session-aware backend pod routing #710

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs-website	Ready	Preview, Comment	Apr 16, 2026 9:08am

[Copilot]

Pull request overview

Updates the Kubernetes operator guide to clarify that Redis-backed session-to-pod routing is conditional on Redis session storage being configured, avoiding the implication that Redis is always used whenever backendReplicas > 1.

Changes:

• Adds a new “Session routing for backend replicas” subsection under Horizontal scaling.
• Adjusts phrasing to distinguish Redis session storage behavior vs. client-IP affinity behavior.
• Adds an explanatory note about when SessionStorageWarning fires.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

[Copilot]

In this note you refer to spec.replicas > 1, but later switch to backendReplicas > 1 without the spec. prefix. For consistency with the rest of the doc’s field-path style (and the earlier spec.backendReplicas bullet), consider using spec.backendReplicas > 1 in both occurrences here.

Suggested change

	`backendReplicas > 1`. Stateless workloads can use `sessionAffinity: None`.
	`spec.backendReplicas > 1`. Stateless workloads can use `sessionAffinity: None`.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• cdn.jsdelivr.net
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/docs-website/docs-website/node_modules/.bin/docusaurus build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[danbarr]

@yrobla Your previous PR #710 was based off #709's branch and merged into there.

This one will end up conflicting with 709, so should the wording update just be applied directly there instead of reintroducing all of the language that 710 added (and that 709 now contains)?