39 lines
1.9 KiB
Markdown
39 lines
1.9 KiB
Markdown
# Backup, restore, aggiornamenti
|
|
|
|
## Cosa salvare
|
|
Tutto lo stato è in `./gitea-data` (repo, SQLite, app.ini con SECRET_KEY, chiavi host SSH) e `./caddy/data` (certificati TLS, riemettibili). Nessuno dei due è versionato.
|
|
|
|
## Metodo semplice (consigliato per SQLite)
|
|
```bash
|
|
docker compose stop gitea
|
|
tar czf gitea-backup-$(date +%F).tgz gitea-data
|
|
docker compose start gitea
|
|
```
|
|
Conservare il backup fuori dall'host e **insieme** a `app.ini` (senza SECRET_KEY i dati cifrati/2FA sono persi).
|
|
|
|
## gitea dump
|
|
Richiede Gitea fermo per consistenza. In Docker (RUN_USER=git in app.ini):
|
|
```bash
|
|
docker exec -u git -w /tmp gitea /usr/local/bin/gitea dump -c /data/gitea/conf/app.ini
|
|
docker cp gitea:/tmp/gitea-dump-*.zip .
|
|
```
|
|
Lo zip contiene `app.ini`, `custom/`, `data/`, `repos/`, `gitea-db.sql`, `log/` (non necessario). Opzioni: `--file`, `--tempdir`, `--type`, `--database`, `--skip-repository`, `--skip-log`, ecc. Per MySQL/Postgres preferire `mysqldump`/`pg_dump`.
|
|
|
|
## Restore (manuale, non esiste comando)
|
|
1. Estrarre lo zip.
|
|
2. `data/*` → `/data/gitea`, `repos/*` → `/data/git/repositories`, `app.ini` → `/data/gitea/conf/`.
|
|
3. Importare `gitea-db.sql` (con SQLite basta ripristinare `gitea.db`).
|
|
4. `chown -R git:git /data` (nel container).
|
|
5. `gitea admin regenerate hooks`; se problemi `gitea doctor check --all --fix`.
|
|
|
|
## Aggiornamento
|
|
```bash
|
|
# 1) backup 2) poi:
|
|
docker compose pull
|
|
docker compose up -d
|
|
```
|
|
L'immagine è `gitea/gitea:latest`: per aggiornamenti controllati fissare un tag (es. `gitea/gitea:1.x`) e leggere le note di rilascio. Le migrazioni DB partono in automatico (`AUTO_MIGRATION`) e non sono reversibili: il backup pre-update è l'unico rollback.
|
|
|
|
## Cambio tipo di database
|
|
`gitea dump --database postgres` genera SQL nel formato di destinazione; poco testato, scegliere il DB giusto dall'inizio. Prima: `gitea doctor check --all --fix` e `doctor recreate-table`.
|