56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
# Gitea - Git with a cup of tea
|
|
|
|
Instance Gitea auto-hébergée, robuste et performante, utilisant PostgreSQL.
|
|
|
|
## Architecture
|
|
|
|
- **Gitea** : Image Rootless (`gitea/gitea:1.21-rootless`)
|
|
- **Base de données** : PostgreSQL 16 (Alpine)
|
|
- **Réseaux** :
|
|
- `proxy_network` : Accès via Nginx Proxy Manager.
|
|
- `gitea_internal` : Communication privée entre Gitea et PostgreSQL.
|
|
|
|
## Configuration
|
|
|
|
- **URL Web** : `http://localhost:3001` (ou via ton domaine configuré dans NPM)
|
|
- **SSH** : Port `2222`
|
|
- **Utilisateur Système** : `nb` (UID 1001)
|
|
|
|
## Persistence
|
|
|
|
Les données sont stockées localement sur le SSD pour des performances optimales :
|
|
- `./data` : Données applicatives et dépôts Git.
|
|
- `./config` : Configuration Gitea (`app.ini`).
|
|
- `./db_data` : Fichiers de la base de données PostgreSQL.
|
|
|
|
## Sauvegardes (Backups)
|
|
|
|
Un script de sauvegarde automatisé est en place :
|
|
- **Script** : `./backup_gitea.sh`
|
|
- **Destination** : `/mnt/nas_freebox/backup/gitea/`
|
|
- **Fréquence** : Quotidienne à 03h00 via Cron.
|
|
- **Rétention** : 7 jours sur le NAS.
|
|
|
|
## Commandes utiles
|
|
|
|
```bash
|
|
# Lancer les services
|
|
docker compose up -d
|
|
|
|
# Arrêter les services
|
|
docker compose down
|
|
|
|
# Voir les logs
|
|
docker compose logs -f
|
|
|
|
# Lancer un backup manuel
|
|
./backup_gitea.sh
|
|
```
|
|
|
|
## Dépannage (Troubleshooting)
|
|
|
|
### Erreur réseau NPM (16/05/2026)
|
|
- **Problème** : Impossible d'accéder à Gitea via l'URL locale ou le domaine. NPM était arrêté avec l'erreur `network not found`.
|
|
- **Cause** : Désynchronisation de l'ID du réseau `proxy_network` après des modifications d'infrastructure.
|
|
- **Résolution** : Redémarrage complet de NPM via `docker compose down && docker compose up -d` pour forcer la reconnexion au réseau externe.
|