-
Notifications
You must be signed in to change notification settings - Fork 76
chore(release): Clarify helm MVU warning about postgres version upgrade procedure #1046
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 1 commit
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -82,6 +82,26 @@ $ kubectl apply -f deploy-sourcegraph-k8s/base/sourcegraph/pgsql/pgsql.StatefulS | |
|
|
||
| ## Helm | ||
|
|
||
| To upgrade builtin containers in Helm admins must update their instance to v5.11.6271 via the [helm multi-version upgrade procedure](/admin/deploy/kubernetes#multi-version-upgrade-procedure) or standard upgrade procedure. This is because `helm upgrade` doesn't support just the DBs in a chart. | ||
| Unlike other deployment methods, Helm charts function as a complete unit and don't allow upgrading only the database components independently. Therefore, the PostgreSQL upgrade must be performed as part of a full Sourcegraph version upgrade. | ||
|
|
||
| <Callout type="warning"> In Sourcegraph version 6.0.0 Sourcegraph services will no longer be able to connect to a Postgres 12 database. This means at and after Sourcegraph 6.0.0, migrator will not be connect to older versions to execute the `upgrade` command. </Callout> | ||
| ### Required Upgrade Path | ||
|
|
||
| <Callout type="warning">Sourcegraph versions `v6.0.x` and later require PostgreSQL 16 and will not connect to PostgreSQL 12 databases. This means any direct upgrade from versions earlier than `v5.10.3940` to any version `v6.0.x` or later will fail because the migrator in `v6.0.x` and later cannot connect to PostgreSQL 12 to perform the upgrade.</Callout> | ||
|
|
||
| To safely upgrade PostgreSQL in Helm deployments: | ||
|
|
||
| 1. **First upgrade to an intermediate version**: | ||
| - Upgrade to either Sourcegraph `v5.10.3940` or `v5.11.6271` using the [helm multi-version upgrade procedure](/admin/deploy/kubernetes#multi-version-upgrade-procedure) or [standard upgrade procedure](/admin/deploy/kubernetes#standard-upgrades) | ||
| - These specific versions include the necessary PostgreSQL upgrade scripts to safely migrate from PG12 to PG16 | ||
|
|
||
| 2. **Verify the PostgreSQL upgrade** (optional): | ||
| - You can verify the PostgreSQL version has been successfully upgraded by connecting to the database: | ||
| ```bash | ||
| kubectl exec -it pgsql -- psql -U sg -c "SELECT version();" | ||
| ``` | ||
| - The output should show PostgreSQL 16.x | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Just curious, aren't we locked to a specific postgres 16 version in these Sourcegraph versions? If so, could we make this note a bit more precise? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ahh good point yea, I think its 16.6, but actually and 16 version would do |
||
|
|
||
| 3. **Proceed to target version**: | ||
| - Once PostgreSQL has been upgraded to version 16, you can safely upgrade to your target version (`v6.0.x` or later) using the standard upgrade procedure | ||
|
|
||
| For any issues during the PostgreSQL upgrade process, please contact [email protected]. | ||
Uh oh!
There was an error while loading. Please reload this page.