Skip to content

Document dedicated Sourcegraph services gateway proxy - #2130

Draft
bobheadxi wants to merge 1 commit into
mainfrom
robert/docs-gateway-proxy
Draft

bobheadxi wants to merge 1 commit into
mainfrom
robert/docs-gateway-proxy

Conversation

@bobheadxi

@bobheadxi bobheadxi commented Nov 3, 2026 •

Copy link
Copy Markdown
Member

Scope

Docs for sourcegraph/sourcegraph#17104: https://github.com/sourcegraph/sourcegraph/pull/17104

Verified against its reviewed head https://github.com/sourcegraph/sourcegraph/commit/96a55a379969436edbb74797cae7fe31d44bb812. The implementation merged as https://github.com/sourcegraph/sourcegraph/commit/97fd0cffa413fe14985adb78d4143ac9bbb0e91e.

Updates the private-network guide with frontend-only SERVICES_GATEWAY_PROXY configuration, consistent replica values, ServiceConnections distribution and restart behavior, HTTP CONNECT and optional Basic authentication, destination TLS, precedence over standard proxy settings, failure behavior, and process-local HTTPS_PROXY/HTTP_PROXY/NO_PROXY selection with localhost exceptions.

This covers only the gateway proxy change, not the separate migrator, drift endpoint, object-storage, or Redis changes.

Publication timing

Keep this draft until Robert requests publication. The implementation is merged, but release and deployment are not confirmed. Coordinate docs merge/publication with the release or weekly update that makes this behavior available to customers.

The permanent guide intentionally omits legacy migration prose. Release upgrade notes should tell customers using TELEMETRY_HTTP_PROXY that it is removed without a fallback, and direct them to frontend SERVICES_GATEWAY_PROXY or process-local HTTPS_PROXY.

Validation

  • git diff --check passed.
  • Baseline-relative links and anchors: no new dead links.
  • Filename, image, added-line hostname, duplication, and CSpell checks passed.
  • Contentlayer compiled all 493 documents successfully.
  • Vercel preview verified in Chromium: both proxy sections render correctly, heading anchors are present, and TELEMETRY_HTTP_PROXY is absent. Inspected screenshots of both sections. Local preview attempts were OOM-killed in the 2 GiB orb; the successful Vercel preview resolves that verification limitation. No application UI code changed.

Describe frontend-distributed gateway proxy configuration and process-local proxy behavior.

Refs sourcegraph/sourcegraph#17104

Amp-Thread-ID: https://ampcode.com/threads/T-01a19e7e-3391-7202-84d2-f3c8e1b70413
Co-authored-by: Amp <amp@ampcode.com>
@vercel

vercel Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
sourcegraph-docs Ready Ready Preview Nov 3, 2026 12:11am UTC

Request Review

@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Direct preview links to pages changed in this PR:

This branch was successfully deployed

1 active deployment
Preview — c6849f87 Deployed Nov 3, 2026 by vercel[bot]
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.

1 participant