From 5ea739c8d13781bc89aa40beee75ee697c842637 Mon Sep 17 00:00:00 2001 From: Earl Warren Date: Mon, 21 Aug 2023 10:55:19 +0200 Subject: [PATCH] admin: ugprade add notes about v1.20.[12]-0 --- docs/admin/upgrade.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/admin/upgrade.md b/docs/admin/upgrade.md index 30eb6a8d..bb3b1c1b 100644 --- a/docs/admin/upgrade.md +++ b/docs/admin/upgrade.md @@ -8,7 +8,7 @@ This guide helps Forgejo admins perform upgrades safely and provides guidance to ### Backup -To be safe, make sure to perform a full backup before upgrading. It is a requirement when upgrading to a new stable release (going from v1.20 to v1.21 for instance) but is also a good precaution when installing a patch release (going from v1.20.1-0 to v1.20.2-0 for instance). +To be safe, make sure to perform a full backup before upgrading. It is a requirement when upgrading to a new stable release (going from v1.19 to v1.20 for instance) but is also a good precaution when installing a patch release (going from v1.19.3-0 to v1.19.4-0 for instance). The reliable way to perform a backup is with a synchronized point-in-time snapshot of all the storage used by Forgejo. @@ -75,8 +75,8 @@ The database version is stored in the database and can be retrieved with **selec | Forgejo version | Date | Database | | --------------------------------------------------------------------------------------------- | ------------- | -------- | -| [1.20.1-0](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md#1-20-1-0) | July 2023 | v259 | -| [1.19.4-0](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md#1-19-4-0) | July 2023 | v243 | +| [1.20.3-0](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md#1-20-3-0) | August 2023 | v260 | +| [1.19.4-0](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md#1-19-4-0) | July 2023 | v244 | | [1.18.5-0](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md#1-18-5-0) | February 2023 | v231 | | Gitea version | Date | Database | @@ -93,6 +93,8 @@ The database version is stored in the database and can be retrieved with **selec #### When upgrading from a specific version... +- Any version before Forgejo v1.20.3-0 + - verify the `app.ini` file does not problematic `[storage*]` sections [as explained in the v1.20.3-0 blog post](https://forgejo.org/2023-08-release-v1-20-3-0/) - Any version before [Gitea 1.17](https://github.com/go-gitea/gitea/releases/tag/v1.17.4) - preserve a custom gitconfig: [episode 1](https://gna.org/blog/1-17-breaking-episode-1/), [episode 2](https://gna.org/blog/1-17-breaking-episode-2/) - [Gitea 1.13.0](https://blog.gitea.io/2020/12/gitea-1.13.0-is-released/) @@ -102,9 +104,9 @@ The database version is stored in the database and can be retrieved with **selec ### Only when upgrading to a specific version -- [1.20.1-0](https://forgejo.org/2023-07-release-v1/) +- From [v1.19] to a version greater or equal to than [1.20](https://forgejo.org/2023-07-release-v1/) -- The [tokens](https://forgejo.org/docs/v1.21/user/oauth2-provider/#scoped-tokens) were refactored in a way that does not guarantee their scope will be preserved. They may be larger or narrower and the only way to be sure that the intended scope is preserved is to re-create the token. + - The [tokens](https://forgejo.org/docs/v1.20/user/oauth2-provider/#scoped-tokens) were refactored in a way that does not guarantee their scope will be preserved. They may be larger or narrower and the only way to be sure that the intended scope is preserved is to re-create the token. - [1.15.2](https://blog.gitea.io/2021/09/gitea-1.15.2-is-released/) @@ -121,7 +123,7 @@ The database version is stored in the database and can be retrieved with **selec ### Versions with known issues -Gogs from before September 2015 migrated to Forgejo v1.18 may have a [dangling `pull_repo` table](https://forum.gna.org/t/73) and the corresponding pull requests will be removed by `gitea doctor --fix --all`. +- Gogs from before September 2015 migrated to Forgejo v1.18 may have a [dangling `pull_repo` table](https://forum.gna.org/t/73) and the corresponding pull requests will be removed by `gitea doctor --fix --all`. [From the 1.11.3 release notes](https://blog.gitea.io/2020/03/gitea-1.11.3-and-1.10.6-released/):