Skip to content

docs: scale gRPC passthrough auth services - #11551

Closed
DuncanDoyle wants to merge 1 commit into
mainfrom
duncandoyle/grpcPassthroughLb
Closed

DuncanDoyle wants to merge 1 commit into
mainfrom
duncandoyle/grpcPassthroughLb

Conversation

@DuncanDoyle

Copy link
Copy Markdown

Note

AI-assisted: The PR description was generated by Claude, but the analysis, discussion, and definition of the change were human-led.

Description


Written by 🤖 (start)

This PR adds a "Scaling the passthrough service" section to the gRPC passthrough auth guide. The ExtAuth server now spreads passthrough checks round-robin over every address the passthrough address resolves to. The section covers what makes that work:

  1. A headless Service, with the container port in address.
  2. MaxConnectionAge on the passthrough server, so that new pods get checks.
  3. Graceful shutdown, so that scale-down does not deny checks.
  4. A TLS certificate that is valid for the hostname on every pod.
  5. The connection count per ExtAuth replica.

Notes for reviewers

  • Draft until the ExtAuth change ships. The 1.X.Y release in the notice is a placeholder for that release.
  • Backport to the release branches that pick up the ExtAuth change.

Testing steps

Verified on kind with 2 ExtAuth replicas and a headless passthrough Service:

Scenario Result
4 pods 4 of 4 pods used, even split
4 → 8 pods, no MaxConnectionAge new pods idle
4 → 8 pods, MaxConnectionAge=30s 8 of 8 pods used, even split
8 → 4 pods, graceful shutdown 0 failed checks

Written by 🤖 (end)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Thank you for the contribution! Gloo is reaching end of life and this repository no longer accepts changes to main, so this pull request is being closed automatically. Active development has moved to kgateway: https://github.com/kgateway-dev/kgateway — please check it out!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant