Skip to content

Document sessionAffinity in MCPServer scaling#956

Open
danbarr wants to merge 2 commits into
mainfrom
docs-k8s-mcpserver-session-affinity
Open

Document sessionAffinity in MCPServer scaling#956
danbarr wants to merge 2 commits into
mainfrom
docs-k8s-mcpserver-session-affinity

Conversation

@danbarr

@danbarr danbarr commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Description

Documents the spec.sessionAffinity field in the "Horizontal scaling" section of run-mcp-k8s.mdx, where the rest of the MCPServer scaling knobs (spec.replicas, spec.backendReplicas, session storage) already live. This mirrors how MCPRemoteProxy (remote-mcp-proxy.mdx) and VirtualMCPServer (vMCP scaling guide) document scaling on their own pages.

The new "Session affinity for proxy replicas" subsection clarifies that spec.sessionAffinity controls the proxy Service (client-to-proxy connections when spec.replicas > 1), which is distinct from the backend session routing already described in the following subsection.

Supersedes #951, which added a parallel section to redis-session-storage.mdx. That was the wrong home: the Redis page documents the session store, and its scaling content already overlapped with the affinity/Redis discussion in run-mcp-k8s.mdx. This PR puts the field where the scaling guidance lives and leaves the Redis page focused on the backend.

Type of change

  • Documentation update

Related issues/PRs

Addresses the sessionAffinity gap in #655. Supersedes #951.

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Reviewer checklist

Content

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 18, 2026 14:48
@vercel

vercel Bot commented Jun 18, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Jun 18, 2026 2:54pm

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Kubernetes Operator guide to document the MCPServer.spec.sessionAffinity scaling knob alongside the other MCPServer horizontal scaling controls, clarifying that it applies to client-to-proxy routing (proxy Service) and is distinct from backend session routing.

Changes:

  • Add a new “Session affinity for proxy replicas” subsection under Horizontal scaling in run-mcp-k8s.mdx.
  • Document spec.sessionAffinity behaviors (ClientIP vs None) with a focused YAML example.
  • Cross-link the recommendation to configure Redis session storage for reliable scaled operation.

Comment thread docs/toolhive/guides-k8s/run-mcp-k8s.mdx Outdated
Comment thread docs/toolhive/guides-k8s/run-mcp-k8s.mdx Outdated
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants