Skip to content

chore/admin: Document frontend-owned object storage configuration - #2096

Open
bobheadxi wants to merge 3 commits into
mainfrom
robert/document-frontend-object-storage
Open

bobheadxi wants to merge 3 commits into
mainfrom
robert/document-frontend-object-storage

Conversation

@bobheadxi

Copy link
Copy Markdown
Member

Shared object storage configuration is moving to frontend in https://github.com/sourcegraph/sourcegraph/pull/17156. Administrators need to know where to set the environment variables and which authentication requirements still apply to consuming services.

Update the object storage guide to configure SOURCEGRAPH_UPLOAD_* identically on every frontend, explain configuration precedence and consumer restarts, and distinguish distributed static credentials from per-service IAM roles and Application Default Credentials. Document frontend-only GCS credential-file mounts and the permissions required for bucket management. Leave separate code graph and search job bucket configuration unchanged.

Publication dependency: Coordinate merge/publication with the release or weekly update containing sourcegraph/sourcegraph#17156; do not publish these instructions before that behavior ships. During rollout, put matching shared-bucket configuration on every frontend first and retain matching environment settings and credential mounts on older consumers until all services are upgraded. Capture that transition in the corresponding upgrade notes once the release is assigned.

Related: https://linear.app/sourcegraph/issue/SVC-2268

Explain where to set shared bucket configuration, how consuming services restart, and which credentials remain local to each service.

Keep separate code graph and search job bucket configuration unchanged.

Amp-Thread-ID: https://ampcode.com/threads/T-01a14212-3602-734c-b207-d4d009c1f321
@vercel

vercel Bot commented Oct 17, 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 Oct 17, 2026 5:21am UTC

Request Review

@github-actions

github-actions Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

Direct preview links to pages changed in this PR:

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

This comment has been minimized.

This branch was successfully deployed

1 active deployment
Preview — e186067b Deployed Oct 17, 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