Move Gitea updating information to new page

2023-03-22 16:58:04 -05:00 · 2023-03-22 16:58:04 -05:00 · dcd21ae6fa
parent f4b31d4d79
commit dcd21ae6fa
3 changed files with 195 additions and 173 deletions
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@ -29,6 +29,7 @@

 ## Self-hosting
 * [Gitea](hosting/gitea.md)
+	* [Updating Gitea](hosting/updating-gitea.md)

 ## Related
 * [Related links](related.md)
--- a/src/hosting/gitea.md
+++ b/src/hosting/gitea.md
@ -1,6 +1,7 @@
 # Self-hosting with Gitea

 - [Gitea](https://gitea.io/en-us/)
+- [Updating Gitea](./gitea-update.md)

 ## Vultr Gitea instance with PostgreSQL

@ -151,179 +152,6 @@ server {
 	- `sudo nginx -t`
 	- `sudo systemctl restart nginx`

-### Update Gitea
-See https://docs.gitea.io/en-us/install-from-binary/#updating-to-a-new-version for more information.
-
-#### Create a backup
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-5. `exit`
-
-#### Update 1.16.8 to 1.16.9
-1. `VERSION=1.16.9`
-2. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-3. `sudo systemctl status gitea`
-	- Stop if needed/didn't backup.
-4. `sudo mv gitea /usr/local/bin/gitea`
-5. `sudo chmod +x /usr/local/bin/gitea`
-6. `sudo systemctl restart gitea`
-7. `sudo systemctl status gitea`
-8. After some period of time, delete the backup file.
-
-#### Updating 1.16.9 to 1.17.1
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-5. `exit`
-6. `VERSION=1.17.1`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-13. After some period of time, delete the backup file.
-
-#### Updating 1.17.1 to 1.17.2
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-5. `exit`
-6. `VERSION=1.17.2`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. After some period of time, delete the backup file.
-
-#### Updating 1.17.2 to 1.17.3
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-5. `exit`
-6. `VERSION=1.17.3`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. After some period of time, delete the backup file.
-
-Gitea LFS config also updated:
-
-1. `sudo vim /etc/gitea/app.ini`
-2. Move server.LFS_CONTENT_PATH to a new lfs.PATH (`/var/lib/gitea/data/lfs`).
-3. `sudo systemctl restart gitea`
-4. `sudo systemctl status gitea`
-
-#### Updating 1.17.3 to 1.17.4
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-	- `chmod a=r <new-backup-file>`
-5. `exit`
-6. `VERSION=1.17.4`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. After some period of time, delete the backup file.
-
-#### Updating 1.17.4 to 1.18.0
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-	- `chmod a=r <new-backup-file>`
-5. `exit`
-6. `VERSION=1.18.0`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. After some period of time, delete the backup file.
-
-#### Updating 1.18.0 to 1.18.3
-Updates came pretty fast, so I ran all three of these one after the other.
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-	- `chmod a=r <new-backup-file>`
-5. `exit`
-6. `VERSION=1.18.1`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. Test the site.
-14. `sudo systemctl stop gitea`
-15. `VERSION=1.18.2`
-16. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-17. `sudo mv gitea /usr/local/bin/gitea`
-18. `sudo chmod +x /usr/local/bin/gitea`
-19. `sudo systemctl restart gitea`
-20. Test.
-21. `sudo systemctl stop gitea`
-22. `VERSION=1.18.3`
-23. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-24. `sudo mv gitea /usr/local/bin/gitea`
-25. `sudo chmod +x /usr/local/bin/gitea`
-26. `sudo systemctl restart gitea`
-27. Test.
-28. After some period of time, delete the backup file.
-
-#### Updating 1.18.3 to 1.18.5
-1.18.4 included a bug.
-1. `sudo systemctl stop gitea`
-2. `sudo su - git`
-3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
-4. `ls -l --block-size=M`
-	- `rm <old-backup-file>`
-	- `chmod a=r <new-backup-file>`
-5. `exit`
-6. `VERSION=1.18.5`
-7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
-8. `sudo systemctl status gitea`
-	- Should be inactive/dead.
-9. `sudo mv gitea /usr/local/bin/gitea`
-10. `sudo chmod +x /usr/local/bin/gitea`
-11. `sudo systemctl restart gitea`
-12. `sudo systemctl status gitea`
-	- Should be active (running).
-13. After some period of time, delete the backup file.
-
 ### Regular backups
 On the server:
 ```bash
--- a/src/hosting/updating-gitea.md
+++ b/src/hosting/updating-gitea.md
@ -0,0 +1,193 @@
+# Updating Gitea
+See https://docs.gitea.io/en-us/install-from-binary/#updating-to-a-new-version for more information.
+
+The following covers what I've done for my instance.
+
+## Create a backup
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+5. `exit`
+
+## Update 1.16.8 to 1.16.9
+1. `VERSION=1.16.9`
+2. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+3. `sudo systemctl status gitea`
+	- Stop if needed/didn't backup.
+4. `sudo mv gitea /usr/local/bin/gitea`
+5. `sudo chmod +x /usr/local/bin/gitea`
+6. `sudo systemctl restart gitea`
+7. `sudo systemctl status gitea`
+8. After some period of time, delete the backup file.
+
+## Updating 1.16.9 to 1.17.1
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+5. `exit`
+6. `VERSION=1.17.1`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+13. After some period of time, delete the backup file.
+
+## Updating 1.17.1 to 1.17.2
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+5. `exit`
+6. `VERSION=1.17.2`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.
+
+## Updating 1.17.2 to 1.17.3
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+5. `exit`
+6. `VERSION=1.17.3`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.
+
+Gitea LFS config also updated:
+
+1. `sudo vim /etc/gitea/app.ini`
+2. Move server.LFS_CONTENT_PATH to a new lfs.PATH (`/var/lib/gitea/data/lfs`).
+3. `sudo systemctl restart gitea`
+4. `sudo systemctl status gitea`
+
+## Updating 1.17.3 to 1.17.4
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+	- `chmod a=r <new-backup-file>`
+5. `exit`
+6. `VERSION=1.17.4`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.
+
+## Updating 1.17.4 to 1.18.0
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+	- `chmod a=r <new-backup-file>`
+5. `exit`
+6. `VERSION=1.18.0`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.
+
+## Updating 1.18.0 to 1.18.3
+Updates came pretty fast, so I ran all three of these one after the other.
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+	- `chmod a=r <new-backup-file>`
+5. `exit`
+6. `VERSION=1.18.1`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. Test the site.
+14. `sudo systemctl stop gitea`
+15. `VERSION=1.18.2`
+16. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+17. `sudo mv gitea /usr/local/bin/gitea`
+18. `sudo chmod +x /usr/local/bin/gitea`
+19. `sudo systemctl restart gitea`
+20. Test.
+21. `sudo systemctl stop gitea`
+22. `VERSION=1.18.3`
+23. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+24. `sudo mv gitea /usr/local/bin/gitea`
+25. `sudo chmod +x /usr/local/bin/gitea`
+26. `sudo systemctl restart gitea`
+27. Test.
+28. After some period of time, delete the backup file.
+
+## Updating 1.18.3 to 1.18.5
+1.18.4 included a bug.
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+	- `chmod a=r <new-backup-file>`
+5. `exit`
+6. `VERSION=1.18.5`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.
+
+## Updating 1.18.5 to 1.19.0
+1. `sudo systemctl stop gitea`
+2. `sudo su - git`
+3. `gitea dump -c /etc/gitea/app.ini -w /var/lib/gitea -t /tmp`
+4. `ls -l --block-size=M`
+	- `rm <old-backup-file>`
+	- `chmod a=r <new-backup-file>`
+5. `exit`
+6. `VERSION=1.19.0`
+7. `sudo wget -O gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64`
+8. `sudo systemctl status gitea`
+	- Should be inactive/dead.
+9. `sudo mv gitea /usr/local/bin/gitea`
+10. `sudo chmod +x /usr/local/bin/gitea`
+11. `sudo systemctl restart gitea`
+12. `sudo systemctl status gitea`
+	- Should be active (running).
+13. After some period of time, delete the backup file.