Skip to content

Commit 7ecf99d

Browse files
authored
chore(rel): warning to skip 5.10.0 release (#834)
This is just a little embellishment on technical changelog and upgrade notes explaining the autoupgrade path workaround for db drift and also warning customers to skip past v5.10.0 release
1 parent f7ec733 commit 7ecf99d

File tree

4 files changed

+32
-9
lines changed

4 files changed

+32
-9
lines changed

docs/admin/updates/docker_compose.mdx

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,17 @@ For upgrade procedures or general info about sourcegraph versioning see the link
1313
1414
## Unreleased
1515

16+
## v5.9.0 ➔ v5.10.1164
17+
18+
- This release resolves an issue in the v5.10.0 release which prevented multiversion upgrades from working. You may now target `v5.10.1164` using migrator's `upgrade` command. Or use autoupgrade by setting the environment variable `SRC_AUTOUPGRADE_IGNORE_DRIFT=true` on the `frontend` container.
19+
1620
## v5.9.0 ➔ v5.10.0
1721

18-
> Warning: This release updates the database container images from postgres 12 to postres 16, and begins using wolfi based images. See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
19-
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
22+
> Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.
23+
>
24+
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. Customers are advised to take a database backup before upgrading! See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
25+
>
26+
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade directly to `v5.10.1164`, or to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
2027
2128
#### Notes:
2229
- The container image for pgsql and codeintel-db have been renamed from `postgres-12-alpine` and `codeintel-db` respectively to `postgresql-16`. The `codeinsights-db` container has been renamed to `postgresql-16-codeinsights`.

docs/admin/updates/kubernetes.mdx

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,17 @@ For upgrade procedures or general info about sourcegraph versioning see the link
1515

1616
## Unreleased
1717

18+
## v5.9.0 ➔ v5.10.1164
19+
20+
- This release resolves an issue in the v5.10.0 release which prevented multiversion upgrades from working. You may now target `v5.10.1164` using migrator's `upgrade` command. Or use autoupgrade by setting the environment variable `SRC_AUTOUPGRADE_IGNORE_DRIFT=true` on the `frontend` deployment.
21+
1822
## v5.9.0 ➔ v5.10.0
1923

20-
> Warning: This release updates the database container images from postgres 12 to postres 16, and begins using wolfi based images. See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
21-
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
24+
> Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.
25+
>
26+
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. Customers are advised to take a database backup before upgrading! See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
27+
>
28+
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade directly to `v5.10.1164`, or to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
2229
2330
#### Notes:
2431
- The container image for pgsql and codeintel-db have been renamed from `postgres-12-alpine` and `codeintel-db` respectively to `postgresql-16`. The `codeinsights-db` container has been renamed to `postgresql-16-codeinsights`.

docs/admin/updates/server.mdx

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,19 @@ For upgrade procedures or general info about sourcegraph versioning see the link
1414

1515
## Unreleased
1616

17+
## v5.9.0 ➔ v5.10.1164
18+
19+
- This release resolves an issue in the v5.10.0 release which prevented multiversion upgrades from working. You may now target `v5.10.1164` using migrator's `upgrade` command. Or use autoupgrade by setting the environment variable `SRC_AUTOUPGRADE_IGNORE_DRIFT=true` on the sourcegraph container.
20+
1721
## v5.9.0 -> v5.10.0
1822

1923
#### Notes:
2024

25+
> Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.
26+
>
2127
> Warning: **In 5.10 the Sourcegraph database images are being updated from postgres 12 to postgres 16 to avoid postgres 12's end of life. This update will not yet be applied to Sourcegraph server's all in one database.**
22-
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
28+
>
29+
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade directly to `v5.10.1164`, or to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
2330
2431
**What does this mean for admins?**
2532
- During the postgres version upgrade `pg_upgrade` automatically makes some changes to the database schema.

docs/technical-changelog.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ This page documents all notable changes to Sourcegraph. For more detailed change
66

77
# 5.10 Patch 1
88

9-
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. See our [Postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
9+
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. Customers are advised to take a database backup before upgrading! See our [Postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
1010
>
11-
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
11+
> Warning: `automatic` upgrades will require setting the environment variable `SRC_AUTOUPGRADE_IGNORE_DRIFT=true` on the `sourcegraph-frontend` deployment/container.
1212
>
1313
> Also be sure to check your deployment type's [upgrade notes](http://sourcegraph.com/docs/admin/updates#instance-specific-procedures)!
1414

@@ -49,9 +49,11 @@ This page documents all notable changes to Sourcegraph. For more detailed change
4949

5050
# 5.10 Patch 0
5151

52-
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
52+
> Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.
5353
>
54-
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
54+
> Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. Customers are advised to have a database backup before upgrading! See our [postgres 12 end of life](https://sourcegraph.com/docs/admin/postgres12_end_of_life_notice#postgres-12-end-of-life) notice!
55+
>
56+
> Warning: `automatic` and migrator `upgrade` command will not work for this release, please upgrade directly to `v5.10.1164`, or to a 5.9 version and conduct a standard upgrade using migrator's default `up` command!
5557
>
5658
> Also be sure to check your deployment type's [upgrade notes](http://sourcegraph.com/docs/admin/updates#instance-specific-procedures)!
5759

0 commit comments

Comments
 (0)