Repository navigation
docs: Update upgrade docs for supported 7.x and 8.x releases - #2106
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Contributor
This comment has been minimized.
This comment has been minimized.
enriquegh
force-pushed
the
enrique/update-upgrade-types
branch
from
October 26, 2026 21:23
3775c19 to
0cf05fa
Compare
marcleblanc2
approved these changes
Oct 27, 2026
Describe the current version format, where the patch number is based on the time since the minor release, the monthly planned release, and the N-1 support policy. Define standard and multiversion upgrades as the frontend and migrator enforce them, and replace the 3.x to 5.x examples with 7.x and 8.x ones. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e
Sourcegraph 7.0 sunset AMI deployments and the AMI install script, and no machine image has been published for 7.x or 8.x. Remove the machine image (AWS AMI, AWS one-click, GCE), k3s install script, and AWS instance sizing pages, along with their sidebar entry, links, and the banners recommending machine images. Redirect the removed paths to the deployment docs. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
Upgrading Early Versions covers upgrades from before 4.0, and the automatic multi-version upgrade feature was removed in 6.12. Both predate the supported 7.x and 8.x releases. Remove the pages and their links, and redirect them to the updates page. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
Remove the PostgreSQL 12 and 5.9 to 6.0 upgrade warnings, the 4.5 section on using a multi-version upgrade to migrate to Kustomize, and the single-container and PostgreSQL 12 entries on the updates page. Update the migrator, downgrade, Docker Compose, Kubernetes, and Helm examples from 3.x to 6.0 versions to 7.x and 8.x, and use the latest release for migrator image tags. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
Replace the hand-written migrator output in the Docker Compose, Kubernetes, Helm, and downgrade examples with output captured from a real 7.5 to 8.1 upgrade and 8.1 to 8.0 downgrade using migrator 8.1.1335. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
Keep only the migrator's own output in the Docker Compose upgrade and downgrade examples. Amp-Thread-ID: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e Co-authored-by: Amp <amp@ampcode.com>
enriquegh
force-pushed
the
enrique/update-upgrade-types
branch
from
October 28, 2026 22:10
3e72715 to
9cecea9
Compare
enriquegh
enabled auto-merge (squash)
October 28, 2026 22:10
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the Updating Sourcegraph docs to match current behavior in
sourcegraph/sourcegraphand the N-1 support policy (current and previous major version: 7.x and 8.x).Upgrade types and release schedule
v8.1.1335), percmd/releaseregistry.IsValidUpgradeininternal/version/upgradestore/upgrade.go. Thefrontendservice andmigrator uprefuse to start when an upgrade crosses more than one minor version.One call for reviewers: the code also allows
upfrom any 7.x minor straight tov8.0. The docs keep the stricter, safer policy that a standard upgrade to a new major starts from the final minor release (v7.7→v8.0).Removed (sunset before 7.0)
Per
changelog/20260120_7-0-removals-deprecations.md, AMI deployments and the AMI install script are sunset.sourcegraph/deployhas no 7.x or 8.x tags; the last isv6.12.5040.Every removed path has a redirect, and existing
/admin/...redirects now point to the new destinations. Links, the sidebar entry, and the "use our machine image" banners on the Docker Compose pages are removed.Pre-7.0 guidance removed
{CURRENT_VERSION_NO_V}.The migrator output in the Docker Compose, Kubernetes, Helm, and downgrade examples is captured from a real run against the Docker Compose databases: a 7.5.4453 to 8.1
upgradeand an 8.1 to 8.0downgradewith migrator 8.1.1335. The Helm andkubectlheader lines around it are illustrative, since the run had no Kubernetes cluster.Checks
check links --check-anchors --check-self-linksagainst the merge-base baseline: no new dead linksdev/check-redirects.mjsagainst the baseline: no redirects brokentsc --noEmitpassAmp thread: https://ampcode.com/threads/T-01a16aa0-9b7d-7793-970e-c03fa931154e