Skip to content

docs: Edge Proxy operational guide#7397

Open
gagantrivedi wants to merge 3 commits intomainfrom
docs/edge-proxy-operational-guide
Open

docs: Edge Proxy operational guide#7397
gagantrivedi wants to merge 3 commits intomainfrom
docs/edge-proxy-operational-guide

Conversation

@gagantrivedi
Copy link
Copy Markdown
Member

@gagantrivedi gagantrivedi commented May 4, 2026

Thanks for submitting a PR! Please check the boxes below:

  • I have read the Contributing Guide.
  • I have added information to docs/ if required so people know about the feature.
  • I have filled in the "Changes" section below.
  • I have filled in the "How did you test this code" section below.

Changes

Contributes to #7207

Extends docs/docs/deployment-self-hosting/edge-proxy.md with operational guidance that the existing setup-and-config doc didn't cover, addressing the recurring support patterns catalogued in the issue:

  • Identity overrides — explicit statement of behaviour, the Use identity overrides in local evaluation requirement, and the v2.21.1 deletion-propagation note.
  • Troubleshooting — symptom-first guides for 401, 403 (with step-by-step diagnosis), restart loops in ECS/K8s, stale flags after dashboard changes, and incorrect identity-based evaluation.
  • Production deployment — guidance for reverse proxy / load balancer setups, ECS/Fargate, Kubernetes (with a minimal Deployment manifest), and managing config.json as a secret in CI/CD.
  • Architecture and scaling — stateless model, polling-load implications of horizontal scale, when endpoint caches help, and a reference RPS table from internal benchmarks.

The Rust Edge Proxy section called out in the issue is intentionally out of scope for this PR.

How did you test this code?

Docs-only change, no runtime behaviour to test

@vercel
Copy link
Copy Markdown

vercel Bot commented May 4, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 4, 2026 8:34am
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
flagsmith-frontend-preview Ignored Ignored Preview May 4, 2026 8:34am
flagsmith-frontend-staging Ignored Ignored Preview May 4, 2026 8:34am

Request Review

Adds identity overrides, troubleshooting, production deployment, and
architecture/scaling sections to the Edge Proxy doc, addressing the
recurring support patterns catalogued in #7207.
@gagantrivedi gagantrivedi marked this pull request as ready for review May 4, 2026 08:47
@gagantrivedi gagantrivedi requested a review from a team as a code owner May 4, 2026 08:47
@gagantrivedi gagantrivedi requested review from adamvialpando and removed request for a team May 4, 2026 08:47
Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

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

⚠️ Code review skipped — your organization's overage spend limit has been reached.

Code review is billed via overage credits. To resume reviews, an organization admin can raise the monthly limit at claude.ai/admin-settings/claude-code.

Once credits are available, reopen this pull request to trigger a review.

@gagantrivedi gagantrivedi requested a review from Holmus May 4, 2026 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant