forked from NYANDEV/forgejo
Add markdownlint (#20512)
Add `markdownlint` linter and fix issues. Config is based on the one from electron's repo with a few rules relaxed.
This commit is contained in:
parent
6554d5197f
commit
ae52df6a64
68 changed files with 1339 additions and 823 deletions
|
@ -20,14 +20,14 @@ menu:
|
|||
{{< toc >}}
|
||||
|
||||
To update Gitea, download a newer version, stop the old one, perform a backup, and run the new one.
|
||||
Every time a Gitea instance starts up, it checks whether a database migration should be run.
|
||||
Every time a Gitea instance starts up, it checks whether a database migration should be run.
|
||||
If a database migration is required, Gitea will take some time to complete the upgrade and then serve.
|
||||
|
||||
## Backup for downgrade
|
||||
|
||||
Gitea keeps compatibility for patch versions whose first two fields are the same (`a.b.x` -> `a.b.y`),
|
||||
these patch versions can be upgraded and downgraded with the same database structure.
|
||||
Otherwise (`a.b.?` -> `a.c.?`), a newer Gitea version will upgrade the old database
|
||||
Gitea keeps compatibility for patch versions whose first two fields are the same (`a.b.x` -> `a.b.y`),
|
||||
these patch versions can be upgraded and downgraded with the same database structure.
|
||||
Otherwise (`a.b.?` -> `a.c.?`), a newer Gitea version will upgrade the old database
|
||||
to a new structure that may differ from the old version.
|
||||
|
||||
For example:
|
||||
|
@ -39,8 +39,8 @@ For example:
|
|||
| 1.4.x | 1.5.y | ✅ Database gets upgraded. You can upgrade from 1.4.x to the latest 1.5.y directly. |
|
||||
| 1.5.y | 1.4.x | ❌ Database already got upgraded and can not be used for an old Gitea, use a backup to downgrade. |
|
||||
|
||||
**Since you can not run an old Gitea with an upgraded database,
|
||||
a backup should always be made before a database upgrade.**
|
||||
**Since you can not run an old Gitea with an upgraded database,
|
||||
a backup should always be made before a database upgrade.**
|
||||
|
||||
If you use Gitea in production, it's always highly recommended to make a backup before upgrade,
|
||||
even if the upgrade is between patch versions.
|
||||
|
@ -56,7 +56,6 @@ Backup steps:
|
|||
If you are using cloud services or filesystems with snapshot feature,
|
||||
a snapshot for the Gitea data volume and related object storage is more convenient.
|
||||
|
||||
|
||||
## Upgrade with Docker
|
||||
|
||||
* `docker pull` the latest Gitea release.
|
||||
|
@ -73,16 +72,16 @@ a snapshot for the Gitea data volume and related object storage is more convenie
|
|||
|
||||
* Download the latest Gitea binary to a temporary directory.
|
||||
* Stop the running instance, backup data.
|
||||
* Replace the installed Gitea binary with the downloaded one.
|
||||
* Replace the installed Gitea binary with the downloaded one.
|
||||
* Start the Gitea instance.
|
||||
|
||||
A script automating these steps for a deployment on Linux can be found at [`contrib/upgrade.sh` in Gitea's source tree](https://github.com/go-gitea/gitea/blob/main/contrib/upgrade.sh).
|
||||
|
||||
## Take care about customized templates
|
||||
|
||||
Gitea's template structure and variables may change between releases, if you are using customized templates,
|
||||
do pay attention if your templates are compatible with the Gitea you are using.
|
||||
Gitea's template structure and variables may change between releases, if you are using customized templates,
|
||||
do pay attention if your templates are compatible with the Gitea you are using.
|
||||
|
||||
If the customized templates don't match Gitea version, you may experience:
|
||||
`50x` server error, page components missing or malfunctioning, strange page layout, ...
|
||||
If the customized templates don't match Gitea version, you may experience:
|
||||
`50x` server error, page components missing or malfunctioning, strange page layout, ...
|
||||
Remove or update the incompatible templates and Gitea web will work again.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue