Gitea beheerprocedure

Doel

Deze procedure beschrijft het dagelijks beheer van Gitea op de server manage.

Basisgegevens

Onderdeel	Waarde
URL	https://git.laspect.nl
Server	manage
IP-adres	172.16.200.230
Installatietype	Native binary
Service	gitea.service
Configuratie	/etc/gitea/app.ini
Data	/var/lib/gitea
Database	MariaDB
Database naam	gitea
Linux user	git

Status controleren

sudo systemctl status gitea --no-pager -l

Logs bekijken

sudo journalctl -u gitea -n 100 --no-pager

Service herstarten

sudo systemctl restart gitea

Versie controleren

gitea --version

HTTPS controleren

curl -I https://git.laspect.nl

SSH controleren

Vanaf een beheerwerkstation:

ssh -T git@git.laspect.nl

Verwachte melding:

You've successfully authenticated
Gitea does not provide shell access.

Configuratie controleren

sudo grep -E "^(ROOT_URL|DOMAIN|SSH_DOMAIN|HTTP_ADDR|HTTP_PORT|SSH_PORT)" /etc/gitea/app.ini

Belangrijke waarden:

Instelling	Gewenste waarde
ROOT_URL	https://git.laspect.nl/
DOMAIN	git.laspect.nl
SSH_DOMAIN	git.laspect.nl
HTTP_ADDR	127.0.0.1
HTTP_PORT	3000
SSH_PORT	22

Back-up

Minimaal back-uppen:

• /etc/gitea/app.ini
• /var/lib/gitea
• MariaDB database gitea

Voorbeeld database dump:

sudo mariadb-dump gitea > /tmp/gitea.sql

Restore aandachtspunten

Een restore is alleen volledig als configuratie, data en database uit hetzelfde herstelmoment komen.

Controleer na restore:

sudo systemctl restart gitea
curl -I https://git.laspect.nl
ssh -T git@git.laspect.nl

Updateprocedure

1. Maak een baseline/back-up.
2. Controleer de gewenste Gitea-versie.
3. Download de nieuwe ARM64 binary.
4. Controleer checksum/signature.
5. Stop Gitea.
6. Vervang /usr/local/bin/gitea.
7. Start Gitea.
8. Controleer web, SSH en logs.

Rollback

Bij problemen:

1. Stop Gitea.
2. Zet vorige binary terug.
3. Zet database terug indien migratie is uitgevoerd.
4. Start Gitea.
5. Controleer logs.