Restructure project following production-ready standards
- Add comprehensive docker-compose configuration with health checks - Create Makefile with 16 utility commands for easy management - Implement robust backup/restore/update scripts with error handling - Add optimized PostgreSQL configuration for Gitea workload - Enhance .env.example with clear dev/prod sections and documentation - Create comprehensive README with installation, configuration, and maintenance guides - Improve .gitignore to exclude all sensitive and generated files - Add Redis persistence (AOF) and memory limits - Configure service dependencies with health conditions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
BeauTroll
61
.env.example
61
.env.example
@@ -1,9 +1,56 @@
|
|||||||
POSTGRES_DATABASE=
|
# ============================================
|
||||||
POSTGRES_USER=
|
# CONFIGURATION GITEA DOCKER
|
||||||
POSTGRES_PASSWORD=
|
# ============================================
|
||||||
|
# Copiez ce fichier vers .env et remplissez les valeurs
|
||||||
|
# cp .env.example .env
|
||||||
|
|
||||||
GITEA_DOMAIN=domain.tld
|
# ============================================
|
||||||
GITEA_SSH_DOMAIN=domain.tld
|
# MODE DE DÉPLOIEMENT
|
||||||
GITEA_ROOT_URL=https://domain.tld
|
# ============================================
|
||||||
|
# Décommentez la section qui vous concerne (dev OU prod)
|
||||||
|
|
||||||
REDIS_PASSWORD=
|
# --- DÉVELOPPEMENT (local) ---
|
||||||
|
# GITEA_DOMAIN=localhost
|
||||||
|
# GITEA_SSH_DOMAIN=localhost
|
||||||
|
# GITEA_ROOT_URL=http://localhost:3000
|
||||||
|
|
||||||
|
# --- PRODUCTION ---
|
||||||
|
GITEA_DOMAIN=git.domain.tld
|
||||||
|
GITEA_SSH_DOMAIN=git.domain.tld
|
||||||
|
GITEA_ROOT_URL=https://git.domain.tld
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# BASE DE DONNÉES POSTGRESQL
|
||||||
|
# ============================================
|
||||||
|
# Nom de la base de données
|
||||||
|
POSTGRES_DATABASE=gitea
|
||||||
|
|
||||||
|
# Utilisateur PostgreSQL
|
||||||
|
POSTGRES_USER=gitea
|
||||||
|
|
||||||
|
# Mot de passe PostgreSQL (CHANGEZ-MOI EN PRODUCTION!)
|
||||||
|
# Générez un mot de passe sécurisé: openssl rand -base64 32
|
||||||
|
POSTGRES_PASSWORD=changeme_secure_password_here
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# CACHE REDIS
|
||||||
|
# ============================================
|
||||||
|
# Mot de passe Redis (CHANGEZ-MOI EN PRODUCTION!)
|
||||||
|
# Générez un mot de passe sécurisé: openssl rand -base64 32
|
||||||
|
REDIS_PASSWORD=changeme_redis_password_here
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# SAUVEGARDES
|
||||||
|
# ============================================
|
||||||
|
# Nombre de jours de rétention des sauvegardes
|
||||||
|
BACKUP_RETENTION_DAYS=7
|
||||||
|
|
||||||
|
# ============================================
|
||||||
|
# NOTES
|
||||||
|
# ============================================
|
||||||
|
# 1. Ne commitez JAMAIS le fichier .env dans Git
|
||||||
|
# 2. Utilisez des mots de passe forts en production (32+ caractères)
|
||||||
|
# 3. Pour générer des mots de passe: openssl rand -base64 32
|
||||||
|
# 4. En développement, Gitea est accessible sur http://localhost:3000
|
||||||
|
# 5. SSH est accessible sur le port 2223 (ssh -p 2223 git@localhost)
|
||||||
|
# 6. En production, utilisez un reverse proxy (nginx/traefik) avec SSL
|
||||||
|
|||||||
52
.gitignore
vendored
52
.gitignore
vendored
@@ -1,3 +1,51 @@
|
|||||||
postgres
|
# ============================================
|
||||||
data
|
# Gitea Docker .gitignore
|
||||||
|
# ============================================
|
||||||
|
|
||||||
|
# Fichiers de configuration sensibles
|
||||||
.env
|
.env
|
||||||
|
|
||||||
|
# Données de base de données PostgreSQL
|
||||||
|
postgres/
|
||||||
|
*.sql
|
||||||
|
*.dump
|
||||||
|
|
||||||
|
# Données Gitea (dépôts, uploads, etc.)
|
||||||
|
data/
|
||||||
|
|
||||||
|
# Données Redis
|
||||||
|
redis/
|
||||||
|
|
||||||
|
# Sauvegardes
|
||||||
|
backups/
|
||||||
|
*.tar.gz
|
||||||
|
*.zip
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
logs/
|
||||||
|
*.log
|
||||||
|
|
||||||
|
# Fichiers temporaires
|
||||||
|
tmp/
|
||||||
|
temp/
|
||||||
|
*.tmp
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# Système d'exploitation
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
desktop.ini
|
||||||
|
|
||||||
|
# IDE et éditeurs
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.iml
|
||||||
|
.project
|
||||||
|
.settings/
|
||||||
|
.classpath
|
||||||
|
|
||||||
|
# Docker
|
||||||
|
.docker/
|
||||||
|
docker-compose.override.yml
|
||||||
|
|||||||
86
Makefile
Normal file
86
Makefile
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
.PHONY: help up down restart ps logs logs-f backup restore update health shell-gitea shell-db clean
|
||||||
|
|
||||||
|
# Include .env file if it exists
|
||||||
|
-include .env
|
||||||
|
export
|
||||||
|
|
||||||
|
help: ## Afficher cette aide
|
||||||
|
@echo "Commandes disponibles pour Gitea Docker :"
|
||||||
|
@echo ""
|
||||||
|
@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf " \033[36m%-15s\033[0m %s\n", $$1, $$2}'
|
||||||
|
|
||||||
|
up: ## Démarrer tous les services
|
||||||
|
@echo "Démarrage des services Gitea..."
|
||||||
|
@docker compose up -d
|
||||||
|
@echo "Services démarrés. Accédez à Gitea sur http://localhost:3000"
|
||||||
|
|
||||||
|
down: ## Arrêter tous les services
|
||||||
|
@echo "Arrêt des services..."
|
||||||
|
@docker compose down
|
||||||
|
|
||||||
|
restart: ## Redémarrer tous les services
|
||||||
|
@echo "Redémarrage des services..."
|
||||||
|
@docker compose restart
|
||||||
|
|
||||||
|
ps: ## Afficher le statut des services
|
||||||
|
@docker compose ps
|
||||||
|
|
||||||
|
logs: ## Afficher les logs (dernières 100 lignes)
|
||||||
|
@docker compose logs --tail=100
|
||||||
|
|
||||||
|
logs-f: ## Suivre les logs en temps réel
|
||||||
|
@docker compose logs -f
|
||||||
|
|
||||||
|
backup: ## Créer une sauvegarde complète (DB + repositories)
|
||||||
|
@bash scripts/backup.sh
|
||||||
|
|
||||||
|
restore: ## Restaurer depuis une sauvegarde (usage: make restore FILE=backups/gitea_backup_YYYYMMDD_HHMMSS.tar.gz)
|
||||||
|
@if [ -z "$(FILE)" ]; then \
|
||||||
|
echo "Erreur: Spécifiez le fichier de sauvegarde avec FILE="; \
|
||||||
|
echo "Usage: make restore FILE=backups/gitea_backup_YYYYMMDD_HHMMSS.tar.gz"; \
|
||||||
|
exit 1; \
|
||||||
|
fi
|
||||||
|
@bash scripts/restore.sh "$(FILE)"
|
||||||
|
|
||||||
|
update: ## Mettre à jour Gitea (avec backup automatique)
|
||||||
|
@bash scripts/update.sh
|
||||||
|
|
||||||
|
health: ## Vérifier la santé des services
|
||||||
|
@echo "État de santé des services:"
|
||||||
|
@echo ""
|
||||||
|
@docker compose ps --format "table {{.Name}}\t{{.Status}}\t{{.Health}}"
|
||||||
|
@echo ""
|
||||||
|
@echo "Détails des health checks:"
|
||||||
|
@docker inspect --format='{{.Name}}: {{.State.Health.Status}}' $$(docker compose ps -q) 2>/dev/null || echo "Aucun service en cours d'exécution"
|
||||||
|
|
||||||
|
shell-gitea: ## Ouvrir un shell dans le conteneur Gitea
|
||||||
|
@docker compose exec gitea /bin/sh
|
||||||
|
|
||||||
|
shell-db: ## Ouvrir un shell PostgreSQL
|
||||||
|
@docker compose exec db psql -U $(POSTGRES_USER) -d $(POSTGRES_DATABASE)
|
||||||
|
|
||||||
|
clean: ## Nettoyer les conteneurs arrêtés et volumes non utilisés
|
||||||
|
@echo "Nettoyage des conteneurs arrêtés..."
|
||||||
|
@docker compose down -v
|
||||||
|
@echo "Nettoyage terminé"
|
||||||
|
|
||||||
|
pull: ## Télécharger les dernières images Docker
|
||||||
|
@docker compose pull
|
||||||
|
|
||||||
|
build: ## Rebuild les images si nécessaire
|
||||||
|
@docker compose build
|
||||||
|
|
||||||
|
config: ## Valider et afficher la configuration docker-compose
|
||||||
|
@docker compose config
|
||||||
|
|
||||||
|
# Commandes avancées
|
||||||
|
admin-create: ## Créer un utilisateur admin (usage: make admin-create USER=admin EMAIL=admin@example.com)
|
||||||
|
@if [ -z "$(USER)" ] || [ -z "$(EMAIL)" ]; then \
|
||||||
|
echo "Usage: make admin-create USER=username EMAIL=email@example.com"; \
|
||||||
|
exit 1; \
|
||||||
|
fi
|
||||||
|
@docker compose exec gitea gitea admin user create --admin --username $(USER) --email $(EMAIL) --password "ChangeMe123!"
|
||||||
|
@echo "Utilisateur admin créé. Mot de passe par défaut: ChangeMe123!"
|
||||||
|
|
||||||
|
stats: ## Afficher les statistiques d'utilisation des ressources
|
||||||
|
@docker stats --no-stream $$(docker compose ps -q)
|
||||||
519
README.md
Normal file
519
README.md
Normal file
@@ -0,0 +1,519 @@
|
|||||||
|
# Gitea Docker - Instance Auto-hébergée
|
||||||
|
|
||||||
|
Déploiement Docker de Gitea avec PostgreSQL et Redis, conçu pour être stable, maintenable et facilement déployable.
|
||||||
|
|
||||||
|
## Table des matières
|
||||||
|
|
||||||
|
- [Architecture](#architecture)
|
||||||
|
- [Prérequis](#prérequis)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Configuration](#configuration)
|
||||||
|
- [Démarrage](#démarrage)
|
||||||
|
- [Maintenance](#maintenance)
|
||||||
|
- [Sauvegardes](#sauvegardes)
|
||||||
|
- [Restauration](#restauration)
|
||||||
|
- [Mises à jour](#mises-à-jour)
|
||||||
|
- [Commandes Make](#commandes-make)
|
||||||
|
- [Dépannage](#dépannage)
|
||||||
|
- [Sécurité](#sécurité)
|
||||||
|
- [Structure du projet](#structure-du-projet)
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
Cette installation comprend 3 services Docker orchestrés :
|
||||||
|
|
||||||
|
### Services
|
||||||
|
|
||||||
|
1. **Gitea** - Serveur Git auto-hébergé
|
||||||
|
- Port web: `127.0.0.1:3000` (localhost uniquement)
|
||||||
|
- Port SSH: `2223`
|
||||||
|
- Base de données: PostgreSQL
|
||||||
|
- Cache: Redis
|
||||||
|
- Health check: API `/api/healthz`
|
||||||
|
|
||||||
|
2. **PostgreSQL 15** - Base de données
|
||||||
|
- Stockage: `./postgres`
|
||||||
|
- Configuration personnalisée: `./db-config/postgresql.conf`
|
||||||
|
- Health check: `pg_isready`
|
||||||
|
|
||||||
|
3. **Redis** - Cache et sessions
|
||||||
|
- Stockage: `./redis` (persistence AOF)
|
||||||
|
- Limite mémoire: 256MB
|
||||||
|
- Politique d'éviction: allkeys-lru
|
||||||
|
|
||||||
|
### Réseaux
|
||||||
|
|
||||||
|
- **gitea** (bridge) - Réseau interne pour la communication entre services
|
||||||
|
|
||||||
|
## Prérequis
|
||||||
|
|
||||||
|
### Logiciels requis
|
||||||
|
|
||||||
|
- Docker >= 20.10
|
||||||
|
- Docker Compose >= 2.0
|
||||||
|
- Make (optionnel mais recommandé)
|
||||||
|
- Bash >= 4.0
|
||||||
|
|
||||||
|
### Ressources matérielles recommandées
|
||||||
|
|
||||||
|
| Composant | Minimum | Recommandé |
|
||||||
|
| --------- | ------- | ---------- |
|
||||||
|
| CPU | 2 cœurs | 4+ cœurs |
|
||||||
|
| RAM | 2 GB | 4+ GB |
|
||||||
|
| Stockage | 10 GB | 50+ GB SSD |
|
||||||
|
|
||||||
|
### Système d'exploitation
|
||||||
|
|
||||||
|
- Linux (Ubuntu 20.04+, Debian 11+, etc.)
|
||||||
|
- macOS 10.15+
|
||||||
|
- Windows 10/11 avec WSL2
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### 1. Cloner le dépôt
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone <url-du-depot>
|
||||||
|
cd agence66-gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Créer le fichier de configuration
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp .env.example .env
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Configurer les variables d'environnement
|
||||||
|
|
||||||
|
Éditez le fichier `.env` et modifiez les valeurs :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano .env # ou vim, code, etc.
|
||||||
|
```
|
||||||
|
|
||||||
|
**IMPORTANT**: Changez tous les mots de passe par défaut !
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Générer des mots de passe sécurisés
|
||||||
|
openssl rand -base64 32
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
### Variables d'environnement
|
||||||
|
|
||||||
|
| Variable | Description | Exemple |
|
||||||
|
| ----------------------- | ------------------------- | ------------------------------- |
|
||||||
|
| `GITEA_DOMAIN` | Domaine principal | `git.example.com` |
|
||||||
|
| `GITEA_SSH_DOMAIN` | Domaine SSH | `git.example.com` |
|
||||||
|
| `GITEA_ROOT_URL` | URL complète | `https://git.example.com` |
|
||||||
|
| `POSTGRES_DATABASE` | Nom de la BDD | `gitea` |
|
||||||
|
| `POSTGRES_USER` | Utilisateur PostgreSQL | `gitea` |
|
||||||
|
| `POSTGRES_PASSWORD` | Mot de passe BDD | `changeme_secure_password_here` |
|
||||||
|
| `REDIS_PASSWORD` | Mot de passe Redis | `changeme_redis_password_here` |
|
||||||
|
| `BACKUP_RETENTION_DAYS` | Rétention des sauvegardes | `7` |
|
||||||
|
|
||||||
|
### Configuration Développement vs Production
|
||||||
|
|
||||||
|
#### Mode Développement (local)
|
||||||
|
|
||||||
|
Dans `.env`, utilisez :
|
||||||
|
|
||||||
|
```env
|
||||||
|
GITEA_DOMAIN=localhost
|
||||||
|
GITEA_SSH_DOMAIN=localhost
|
||||||
|
GITEA_ROOT_URL=http://localhost:3000
|
||||||
|
```
|
||||||
|
|
||||||
|
Accès :
|
||||||
|
|
||||||
|
- Web: http://localhost:3000
|
||||||
|
- SSH: `ssh -p 2223 git@localhost`
|
||||||
|
|
||||||
|
#### Mode Production
|
||||||
|
|
||||||
|
Dans `.env`, utilisez :
|
||||||
|
|
||||||
|
```env
|
||||||
|
GITEA_DOMAIN=domain.tld
|
||||||
|
GITEA_SSH_DOMAIN=domain.tld
|
||||||
|
GITEA_ROOT_URL=https://domain.tld
|
||||||
|
```
|
||||||
|
|
||||||
|
**IMPORTANT**: En production, utilisez un reverse proxy (nginx/traefik) avec SSL/TLS.
|
||||||
|
|
||||||
|
### Configuration PostgreSQL
|
||||||
|
|
||||||
|
La configuration optimisée se trouve dans `db-config/postgresql.conf`.
|
||||||
|
|
||||||
|
Ajustez selon vos ressources :
|
||||||
|
|
||||||
|
- `shared_buffers`: 25% de la RAM disponible
|
||||||
|
- `effective_cache_size`: 50-75% de la RAM disponible
|
||||||
|
|
||||||
|
## Démarrage
|
||||||
|
|
||||||
|
### Première installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Démarrer tous les services
|
||||||
|
make up
|
||||||
|
|
||||||
|
# Ou avec docker compose directement
|
||||||
|
docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### Accéder à Gitea
|
||||||
|
|
||||||
|
1. Ouvrez votre navigateur sur http://localhost:3000
|
||||||
|
2. Suivez l'assistant de configuration initial
|
||||||
|
3. Créez le premier utilisateur administrateur
|
||||||
|
|
||||||
|
**Note**: La plupart des paramètres sont déjà configurés via les variables d'environnement.
|
||||||
|
|
||||||
|
### Vérifier l'état des services
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make health
|
||||||
|
```
|
||||||
|
|
||||||
|
Ou :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose ps
|
||||||
|
```
|
||||||
|
|
||||||
|
## Maintenance
|
||||||
|
|
||||||
|
### Sauvegardes
|
||||||
|
|
||||||
|
#### Créer une sauvegarde manuelle
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make backup
|
||||||
|
```
|
||||||
|
|
||||||
|
Ou :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bash scripts/backup.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Contenu de la sauvegarde** :
|
||||||
|
|
||||||
|
- Base de données PostgreSQL (dump compressé)
|
||||||
|
- Dépôts Git
|
||||||
|
- Configuration Gitea
|
||||||
|
- Données utilisateur
|
||||||
|
|
||||||
|
**Emplacement** : `./backups/gitea_backup_YYYYMMDD_HHMMSS.tar.gz`
|
||||||
|
|
||||||
|
#### Rétention automatique
|
||||||
|
|
||||||
|
Les sauvegardes de plus de `BACKUP_RETENTION_DAYS` jours (défaut: 7) sont automatiquement supprimées.
|
||||||
|
|
||||||
|
#### Sauvegardes automatiques (cron)
|
||||||
|
|
||||||
|
Ajoutez une tâche cron pour des sauvegardes quotidiennes :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
crontab -e
|
||||||
|
```
|
||||||
|
|
||||||
|
Ajoutez :
|
||||||
|
|
||||||
|
```cron
|
||||||
|
# Sauvegarde quotidienne à 3h du matin
|
||||||
|
0 3 * * * cd /chemin/vers/agence66-gitea && make backup >> /var/log/gitea-backup.log 2>&1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Restauration
|
||||||
|
|
||||||
|
#### Restaurer depuis une sauvegarde
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make restore FILE=backups/gitea_backup_20240101_120000.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
Ou :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bash scripts/restore.sh backups/gitea_backup_20240101_120000.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
**ATTENTION** : Cette opération est destructive et écrasera toutes les données actuelles !
|
||||||
|
|
||||||
|
Le script vous demandera confirmation avant de procéder.
|
||||||
|
|
||||||
|
#### Processus de restauration
|
||||||
|
|
||||||
|
1. Extraction de l'archive
|
||||||
|
2. Arrêt des services
|
||||||
|
3. Restauration de la base de données
|
||||||
|
4. Restauration des fichiers
|
||||||
|
5. Redémarrage des services
|
||||||
|
|
||||||
|
### Mises à jour
|
||||||
|
|
||||||
|
#### Mettre à jour Gitea
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make update
|
||||||
|
```
|
||||||
|
|
||||||
|
Ou :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bash scripts/update.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Le script effectue** :
|
||||||
|
|
||||||
|
1. Sauvegarde automatique de sécurité
|
||||||
|
2. Téléchargement des nouvelles images
|
||||||
|
3. Arrêt des services
|
||||||
|
4. Démarrage avec les nouvelles versions
|
||||||
|
5. Vérification de l'état
|
||||||
|
|
||||||
|
**En cas de problème**, restaurez la sauvegarde créée automatiquement :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make restore FILE=backups/gitea_backup_YYYYMMDD_HHMMSS.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
## Commandes Make
|
||||||
|
|
||||||
|
| Commande | Description |
|
||||||
|
| ----------------------- | ---------------------------------------- |
|
||||||
|
| `make help` | Afficher l'aide |
|
||||||
|
| `make up` | Démarrer tous les services |
|
||||||
|
| `make down` | Arrêter tous les services |
|
||||||
|
| `make restart` | Redémarrer les services |
|
||||||
|
| `make ps` | Afficher le statut des services |
|
||||||
|
| `make logs` | Afficher les logs (100 dernières lignes) |
|
||||||
|
| `make logs-f` | Suivre les logs en temps réel |
|
||||||
|
| `make backup` | Créer une sauvegarde |
|
||||||
|
| `make restore FILE=...` | Restaurer une sauvegarde |
|
||||||
|
| `make update` | Mettre à jour Gitea |
|
||||||
|
| `make health` | Vérifier la santé des services |
|
||||||
|
| `make shell-gitea` | Ouvrir un shell dans Gitea |
|
||||||
|
| `make shell-db` | Ouvrir un shell PostgreSQL |
|
||||||
|
| `make clean` | Nettoyer les conteneurs arrêtés |
|
||||||
|
| `make pull` | Télécharger les dernières images |
|
||||||
|
| `make config` | Valider la configuration Docker |
|
||||||
|
| `make stats` | Afficher les statistiques de ressources |
|
||||||
|
|
||||||
|
### Créer un utilisateur admin en ligne de commande
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make admin-create USER=admin EMAIL=admin@example.com
|
||||||
|
```
|
||||||
|
|
||||||
|
Le mot de passe par défaut sera `ChangeMe123!` (à changer immédiatement).
|
||||||
|
|
||||||
|
## Dépannage
|
||||||
|
|
||||||
|
### Gitea ne démarre pas
|
||||||
|
|
||||||
|
**Vérifier les logs** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make logs-f
|
||||||
|
```
|
||||||
|
|
||||||
|
Ou :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose logs -f gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
**Causes courantes** :
|
||||||
|
|
||||||
|
- Base de données non prête : attendez que PostgreSQL soit healthy
|
||||||
|
- Permissions de fichiers : vérifiez `./data` (UID/GID 1000)
|
||||||
|
- Port déjà utilisé : vérifiez si le port 3000 ou 2223 est disponible
|
||||||
|
|
||||||
|
### Erreurs de base de données
|
||||||
|
|
||||||
|
**Vérifier PostgreSQL** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make shell-db
|
||||||
|
```
|
||||||
|
|
||||||
|
**Vérifier la connexion** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose exec db pg_isready -U gitea -d gitea
|
||||||
|
```
|
||||||
|
|
||||||
|
### Problèmes de performance
|
||||||
|
|
||||||
|
**Vérifier l'utilisation des ressources** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make stats
|
||||||
|
```
|
||||||
|
|
||||||
|
**Optimisations** :
|
||||||
|
|
||||||
|
1. Augmentez `shared_buffers` dans `db-config/postgresql.conf`
|
||||||
|
2. Ajustez la limite mémoire Redis dans `docker-compose.yml`
|
||||||
|
3. Activez la compression dans Gitea
|
||||||
|
|
||||||
|
### Redis ne fonctionne pas
|
||||||
|
|
||||||
|
**Vérifier Redis** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose exec redis redis-cli --raw incr ping
|
||||||
|
```
|
||||||
|
|
||||||
|
### Réinitialisation complète
|
||||||
|
|
||||||
|
**ATTENTION** : Cela supprimera toutes les données !
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make down
|
||||||
|
sudo rm -rf data/ postgres/ redis/ backups/
|
||||||
|
make up
|
||||||
|
```
|
||||||
|
|
||||||
|
## Sécurité
|
||||||
|
|
||||||
|
### Bonnes pratiques
|
||||||
|
|
||||||
|
1. **Mots de passe forts** : Utilisez des mots de passe de 32+ caractères
|
||||||
|
|
||||||
|
```bash
|
||||||
|
openssl rand -base64 32
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Fichier .env** : Ne le commitez JAMAIS dans Git (déjà dans .gitignore)
|
||||||
|
|
||||||
|
3. **Mises à jour régulières** : Mettez à jour Gitea régulièrement
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make update
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **Reverse proxy** : En production, utilisez nginx/traefik avec SSL/TLS
|
||||||
|
|
||||||
|
5. **Firewall** : Limitez l'accès aux ports nécessaires
|
||||||
|
- 3000 : Web (via reverse proxy uniquement)
|
||||||
|
- 2223 : SSH Git
|
||||||
|
|
||||||
|
6. **Sauvegardes** : Automatisez les sauvegardes et testez la restauration
|
||||||
|
|
||||||
|
7. **Logs** : Surveillez les logs pour détecter les activités suspectes
|
||||||
|
```bash
|
||||||
|
make logs-f
|
||||||
|
```
|
||||||
|
|
||||||
|
### Exposition sécurisée (Production)
|
||||||
|
|
||||||
|
**Avec nginx** :
|
||||||
|
|
||||||
|
```nginx
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
server_name git.domain.tld;
|
||||||
|
return 301 https://$server_name$request_uri;
|
||||||
|
}
|
||||||
|
|
||||||
|
server {
|
||||||
|
listen 443 ssl http2;
|
||||||
|
server_name git.domain.tld;
|
||||||
|
|
||||||
|
ssl_certificate /etc/letsencrypt/live/git.domain.tld/fullchain.pem;
|
||||||
|
ssl_certificate_key /etc/letsencrypt/live/git.domain.tld/privkey.pem;
|
||||||
|
|
||||||
|
location / {
|
||||||
|
proxy_pass http://127.0.0.1:3000;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Forwarded-Proto $scheme;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### SSH Git
|
||||||
|
|
||||||
|
Le service SSH Gitea est exposé sur le port **2223**.
|
||||||
|
|
||||||
|
**Cloner un dépôt** :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone ssh://git@domain.tld:2223/username/repository.git
|
||||||
|
```
|
||||||
|
|
||||||
|
**Configuration SSH** (`~/.ssh/config`) :
|
||||||
|
|
||||||
|
```
|
||||||
|
Host git.domain.tld
|
||||||
|
Port 2223
|
||||||
|
User git
|
||||||
|
```
|
||||||
|
|
||||||
|
Après cette configuration :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone git@git.domain.tld:username/repository.git
|
||||||
|
```
|
||||||
|
|
||||||
|
## Structure du projet
|
||||||
|
|
||||||
|
```
|
||||||
|
agence66-gitea/
|
||||||
|
├── .env # Configuration (ne pas committer)
|
||||||
|
├── .env.example # Template de configuration
|
||||||
|
├── .gitignore # Fichiers à ignorer par Git
|
||||||
|
├── docker-compose.yml # Orchestration Docker
|
||||||
|
├── Makefile # Commandes simplifiées
|
||||||
|
├── README.md # Cette documentation
|
||||||
|
├── backups/ # Sauvegardes (généré)
|
||||||
|
│ └── gitea_backup_*.tar.gz
|
||||||
|
├── data/ # Données Gitea (généré)
|
||||||
|
│ ├── git/ # Dépôts Git
|
||||||
|
│ ├── gitea/ # Configuration Gitea
|
||||||
|
│ └── ...
|
||||||
|
├── db-config/ # Configuration PostgreSQL
|
||||||
|
│ └── postgresql.conf
|
||||||
|
├── postgres/ # Données PostgreSQL (généré)
|
||||||
|
├── redis/ # Données Redis (généré)
|
||||||
|
└── scripts/ # Scripts de maintenance
|
||||||
|
├── backup.sh # Sauvegarde complète
|
||||||
|
├── restore.sh # Restauration
|
||||||
|
└── update.sh # Mise à jour
|
||||||
|
```
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
### Problèmes et questions
|
||||||
|
|
||||||
|
- Issues GitHub : Créez une issue sur le dépôt
|
||||||
|
- Documentation Gitea : https://docs.gitea.io/
|
||||||
|
- Docker : https://docs.docker.com/
|
||||||
|
|
||||||
|
### Logs utiles
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Tous les logs
|
||||||
|
make logs
|
||||||
|
|
||||||
|
# Logs Gitea uniquement
|
||||||
|
docker compose logs -f gitea
|
||||||
|
|
||||||
|
# Logs PostgreSQL
|
||||||
|
docker compose logs -f db
|
||||||
|
|
||||||
|
# Logs Redis
|
||||||
|
docker compose logs -f redis
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Auteur** : Agence66
|
||||||
|
**Licence** : À définir
|
||||||
|
**Version** : 1.0.0
|
||||||
77
db-config/postgresql.conf
Normal file
77
db-config/postgresql.conf
Normal file
@@ -0,0 +1,77 @@
|
|||||||
|
# ============================================
|
||||||
|
# Configuration PostgreSQL optimisée pour Gitea
|
||||||
|
# ============================================
|
||||||
|
# Cette configuration est adaptée pour une instance Gitea
|
||||||
|
# avec une charge modérée (petit à moyen serveur)
|
||||||
|
|
||||||
|
# CONNEXIONS
|
||||||
|
# -------------------------------------------
|
||||||
|
max_connections = 100
|
||||||
|
superuser_reserved_connections = 3
|
||||||
|
|
||||||
|
# MÉMOIRE
|
||||||
|
# -------------------------------------------
|
||||||
|
# Ajustez selon la RAM disponible
|
||||||
|
# Recommandation: 25% de la RAM pour shared_buffers
|
||||||
|
shared_buffers = 256MB
|
||||||
|
effective_cache_size = 1GB
|
||||||
|
maintenance_work_mem = 64MB
|
||||||
|
work_mem = 4MB
|
||||||
|
|
||||||
|
# WRITE AHEAD LOG (WAL)
|
||||||
|
# -------------------------------------------
|
||||||
|
wal_buffers = 16MB
|
||||||
|
min_wal_size = 1GB
|
||||||
|
max_wal_size = 4GB
|
||||||
|
checkpoint_completion_target = 0.9
|
||||||
|
|
||||||
|
# QUERY TUNING
|
||||||
|
# -------------------------------------------
|
||||||
|
random_page_cost = 1.1
|
||||||
|
effective_io_concurrency = 200
|
||||||
|
default_statistics_target = 100
|
||||||
|
|
||||||
|
# LOGGING
|
||||||
|
# -------------------------------------------
|
||||||
|
logging_collector = on
|
||||||
|
log_directory = 'log'
|
||||||
|
log_filename = 'postgresql-%Y-%m-%d.log'
|
||||||
|
log_rotation_age = 1d
|
||||||
|
log_rotation_size = 100MB
|
||||||
|
log_line_prefix = '%t [%p]: [%l-1] user=%u,db=%d,app=%a,client=%h '
|
||||||
|
log_timezone = 'UTC'
|
||||||
|
|
||||||
|
# Logs des requêtes lentes (> 1 seconde)
|
||||||
|
log_min_duration_statement = 1000
|
||||||
|
|
||||||
|
# LOCALE ET FORMATAGE
|
||||||
|
# -------------------------------------------
|
||||||
|
datestyle = 'iso, mdy'
|
||||||
|
timezone = 'UTC'
|
||||||
|
lc_messages = 'en_US.utf8'
|
||||||
|
lc_monetary = 'en_US.utf8'
|
||||||
|
lc_numeric = 'en_US.utf8'
|
||||||
|
lc_time = 'en_US.utf8'
|
||||||
|
default_text_search_config = 'pg_catalog.english'
|
||||||
|
|
||||||
|
# AUTOVACUUM
|
||||||
|
# -------------------------------------------
|
||||||
|
# Important pour maintenir les performances
|
||||||
|
autovacuum = on
|
||||||
|
autovacuum_max_workers = 3
|
||||||
|
autovacuum_naptime = 1min
|
||||||
|
autovacuum_vacuum_threshold = 50
|
||||||
|
autovacuum_analyze_threshold = 50
|
||||||
|
autovacuum_vacuum_scale_factor = 0.1
|
||||||
|
autovacuum_analyze_scale_factor = 0.05
|
||||||
|
|
||||||
|
# SÉCURITÉ
|
||||||
|
# -------------------------------------------
|
||||||
|
# Les connexions sont limitées au réseau Docker
|
||||||
|
listen_addresses = '*'
|
||||||
|
ssl = off
|
||||||
|
|
||||||
|
# AUTRES PARAMÈTRES
|
||||||
|
# -------------------------------------------
|
||||||
|
shared_preload_libraries = ''
|
||||||
|
dynamic_shared_memory_type = posix
|
||||||
@@ -4,8 +4,10 @@ services:
|
|||||||
container_name: gitea
|
container_name: gitea
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
depends_on:
|
depends_on:
|
||||||
- db
|
db:
|
||||||
- redis
|
condition: service_healthy
|
||||||
|
redis:
|
||||||
|
condition: service_started
|
||||||
environment:
|
environment:
|
||||||
- USER_UID=1000
|
- USER_UID=1000
|
||||||
- USER_GID=1000
|
- USER_GID=1000
|
||||||
@@ -34,9 +36,16 @@ services:
|
|||||||
- /etc/localtime:/etc/localtime:ro
|
- /etc/localtime:/etc/localtime:ro
|
||||||
networks:
|
networks:
|
||||||
- gitea
|
- gitea
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "curl", "-f", "http://localhost:3000/api/healthz"]
|
||||||
|
interval: 30s
|
||||||
|
timeout: 10s
|
||||||
|
retries: 3
|
||||||
|
start_period: 40s
|
||||||
|
|
||||||
db:
|
db:
|
||||||
image: postgres:15-alpine
|
image: postgres:15-alpine
|
||||||
|
container_name: gitea-db
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
environment:
|
environment:
|
||||||
- POSTGRES_DB=${POSTGRES_DATABASE}
|
- POSTGRES_DB=${POSTGRES_DATABASE}
|
||||||
@@ -44,15 +53,30 @@ services:
|
|||||||
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
|
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
|
||||||
volumes:
|
volumes:
|
||||||
- ./postgres:/var/lib/postgresql/data
|
- ./postgres:/var/lib/postgresql/data
|
||||||
|
- ./db-config/postgresql.conf:/etc/postgresql/postgresql.conf:ro
|
||||||
networks:
|
networks:
|
||||||
- gitea
|
- gitea
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DATABASE}"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 5
|
||||||
|
start_period: 10s
|
||||||
|
|
||||||
redis:
|
redis:
|
||||||
image: redis:alpine
|
image: redis:alpine
|
||||||
|
container_name: gitea-redis
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
networks:
|
networks:
|
||||||
- gitea
|
- gitea
|
||||||
command: redis-server --requirepass ${REDIS_PASSWORD}
|
command: redis-server --requirepass ${REDIS_PASSWORD} --maxmemory 256mb --maxmemory-policy allkeys-lru --appendonly yes
|
||||||
|
volumes:
|
||||||
|
- ./redis:/data
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 5
|
||||||
|
|
||||||
networks:
|
networks:
|
||||||
gitea:
|
gitea:
|
||||||
|
|||||||
121
scripts/backup.sh
Executable file
121
scripts/backup.sh
Executable file
@@ -0,0 +1,121 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# ============================================
|
||||||
|
# Script de sauvegarde Gitea
|
||||||
|
# ============================================
|
||||||
|
# Ce script crée une sauvegarde complète de:
|
||||||
|
# - Base de données PostgreSQL
|
||||||
|
# - Dépôts Git
|
||||||
|
# - Configuration Gitea
|
||||||
|
# - Données utilisateur
|
||||||
|
|
||||||
|
set -e # Arrêter en cas d'erreur
|
||||||
|
|
||||||
|
# Couleurs pour l'affichage
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# Charger les variables d'environnement
|
||||||
|
if [ -f .env ]; then
|
||||||
|
source .env
|
||||||
|
else
|
||||||
|
echo -e "${RED}Erreur: Fichier .env non trouvé${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Variables
|
||||||
|
BACKUP_DIR="./backups"
|
||||||
|
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
|
||||||
|
BACKUP_NAME="gitea_backup_${TIMESTAMP}"
|
||||||
|
TEMP_DIR="${BACKUP_DIR}/${BACKUP_NAME}"
|
||||||
|
RETENTION_DAYS=${BACKUP_RETENTION_DAYS:-7}
|
||||||
|
|
||||||
|
# Vérifier que les variables nécessaires sont définies
|
||||||
|
if [ -z "$POSTGRES_DATABASE" ] || [ -z "$POSTGRES_USER" ] || [ -z "$POSTGRES_PASSWORD" ]; then
|
||||||
|
echo -e "${RED}Erreur: Variables PostgreSQL non définies dans .env${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Fonction de nettoyage en cas d'erreur
|
||||||
|
cleanup() {
|
||||||
|
if [ -d "$TEMP_DIR" ]; then
|
||||||
|
echo -e "${YELLOW}Nettoyage des fichiers temporaires...${NC}"
|
||||||
|
rm -rf "$TEMP_DIR"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Piège pour nettoyer en cas d'erreur
|
||||||
|
trap cleanup EXIT
|
||||||
|
|
||||||
|
echo -e "${GREEN}=== Début de la sauvegarde Gitea ===${NC}"
|
||||||
|
echo "Timestamp: $TIMESTAMP"
|
||||||
|
|
||||||
|
# Créer les répertoires si nécessaire
|
||||||
|
mkdir -p "$BACKUP_DIR"
|
||||||
|
mkdir -p "$TEMP_DIR"
|
||||||
|
|
||||||
|
# Vérifier que les conteneurs sont en cours d'exécution
|
||||||
|
if ! docker compose ps | grep -q "gitea.*running"; then
|
||||||
|
echo -e "${RED}Erreur: Le conteneur Gitea n'est pas en cours d'exécution${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[1/4] Sauvegarde de la base de données PostgreSQL...${NC}"
|
||||||
|
# Exporter la base de données
|
||||||
|
export PGPASSWORD="$POSTGRES_PASSWORD"
|
||||||
|
docker compose exec -T db pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DATABASE" \
|
||||||
|
--format=custom \
|
||||||
|
--compress=9 \
|
||||||
|
--no-owner \
|
||||||
|
--no-acl \
|
||||||
|
> "${TEMP_DIR}/database.dump"
|
||||||
|
|
||||||
|
if [ ! -s "${TEMP_DIR}/database.dump" ]; then
|
||||||
|
echo -e "${RED}Erreur: Le dump de la base de données est vide${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo -e "${GREEN}✓ Base de données sauvegardée${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[2/4] Sauvegarde des dépôts Git et données...${NC}"
|
||||||
|
# Créer une archive des dépôts et données
|
||||||
|
docker compose exec -T gitea tar czf - \
|
||||||
|
-C /data \
|
||||||
|
--exclude='./log' \
|
||||||
|
--exclude='./cache' \
|
||||||
|
--exclude='./tmp' \
|
||||||
|
--exclude='./sessions' \
|
||||||
|
. > "${TEMP_DIR}/gitea_data.tar.gz"
|
||||||
|
|
||||||
|
if [ ! -s "${TEMP_DIR}/gitea_data.tar.gz" ]; then
|
||||||
|
echo -e "${RED}Erreur: L'archive des données est vide${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo -e "${GREEN}✓ Dépôts et données sauvegardés${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[3/4] Création de l'archive finale...${NC}"
|
||||||
|
# Créer l'archive finale
|
||||||
|
cd "$BACKUP_DIR"
|
||||||
|
tar czf "${BACKUP_NAME}.tar.gz" "${BACKUP_NAME}/"
|
||||||
|
|
||||||
|
if [ ! -s "${BACKUP_NAME}.tar.gz" ]; then
|
||||||
|
echo -e "${RED}Erreur: L'archive finale est vide${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Supprimer le répertoire temporaire
|
||||||
|
rm -rf "${BACKUP_NAME}"
|
||||||
|
cd - > /dev/null
|
||||||
|
|
||||||
|
BACKUP_SIZE=$(du -h "${BACKUP_DIR}/${BACKUP_NAME}.tar.gz" | cut -f1)
|
||||||
|
echo -e "${GREEN}✓ Archive créée: ${BACKUP_NAME}.tar.gz (${BACKUP_SIZE})${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[4/4] Nettoyage des anciennes sauvegardes (>$RETENTION_DAYS jours)...${NC}"
|
||||||
|
# Supprimer les sauvegardes plus anciennes que RETENTION_DAYS
|
||||||
|
find "$BACKUP_DIR" -name "gitea_backup_*.tar.gz" -type f -mtime +$RETENTION_DAYS -delete
|
||||||
|
REMAINING_BACKUPS=$(find "$BACKUP_DIR" -name "gitea_backup_*.tar.gz" -type f | wc -l)
|
||||||
|
echo -e "${GREEN}✓ Sauvegardes restantes: $REMAINING_BACKUPS${NC}"
|
||||||
|
|
||||||
|
echo -e "${GREEN}=== Sauvegarde terminée avec succès ===${NC}"
|
||||||
|
echo "Fichier: ${BACKUP_DIR}/${BACKUP_NAME}.tar.gz"
|
||||||
|
echo "Taille: $BACKUP_SIZE"
|
||||||
191
scripts/restore.sh
Executable file
191
scripts/restore.sh
Executable file
@@ -0,0 +1,191 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# ============================================
|
||||||
|
# Script de restauration Gitea
|
||||||
|
# ============================================
|
||||||
|
# Ce script restaure une sauvegarde complète de Gitea
|
||||||
|
# ATTENTION: Cette opération est destructive!
|
||||||
|
|
||||||
|
set -e # Arrêter en cas d'erreur
|
||||||
|
|
||||||
|
# Couleurs pour l'affichage
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# Vérifier qu'un fichier de sauvegarde a été fourni
|
||||||
|
if [ -z "$1" ]; then
|
||||||
|
echo -e "${RED}Erreur: Aucun fichier de sauvegarde spécifié${NC}"
|
||||||
|
echo "Usage: $0 <fichier_sauvegarde.tar.gz>"
|
||||||
|
echo "Exemple: $0 backups/gitea_backup_20240101_120000.tar.gz"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
BACKUP_FILE="$1"
|
||||||
|
|
||||||
|
# Vérifier que le fichier existe
|
||||||
|
if [ ! -f "$BACKUP_FILE" ]; then
|
||||||
|
echo -e "${RED}Erreur: Le fichier $BACKUP_FILE n'existe pas${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Vérifier que c'est bien un fichier gzip
|
||||||
|
if ! file "$BACKUP_FILE" | grep -q "gzip compressed"; then
|
||||||
|
echo -e "${RED}Erreur: Le fichier n'est pas une archive gzip valide${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validation du chemin (sécurité contre path traversal)
|
||||||
|
BACKUP_FILE=$(realpath "$BACKUP_FILE")
|
||||||
|
if [[ "$BACKUP_FILE" == *".."* ]]; then
|
||||||
|
echo -e "${RED}Erreur: Chemin invalide (path traversal détecté)${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Charger les variables d'environnement
|
||||||
|
if [ -f .env ]; then
|
||||||
|
source .env
|
||||||
|
else
|
||||||
|
echo -e "${RED}Erreur: Fichier .env non trouvé${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Vérifier que les variables nécessaires sont définies
|
||||||
|
if [ -z "$POSTGRES_DATABASE" ] || [ -z "$POSTGRES_USER" ] || [ -z "$POSTGRES_PASSWORD" ]; then
|
||||||
|
echo -e "${RED}Erreur: Variables PostgreSQL non définies dans .env${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Variables
|
||||||
|
TEMP_DIR=$(mktemp -d)
|
||||||
|
BACKUP_NAME=$(basename "$BACKUP_FILE" .tar.gz)
|
||||||
|
|
||||||
|
# Fonction de nettoyage
|
||||||
|
cleanup() {
|
||||||
|
if [ -d "$TEMP_DIR" ]; then
|
||||||
|
echo -e "${YELLOW}Nettoyage des fichiers temporaires...${NC}"
|
||||||
|
rm -rf "$TEMP_DIR"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Piège pour nettoyer en cas d'erreur ou d'interruption
|
||||||
|
trap cleanup EXIT INT TERM
|
||||||
|
|
||||||
|
echo -e "${RED}=== ATTENTION: Restauration de Gitea ===${NC}"
|
||||||
|
echo "Fichier de sauvegarde: $BACKUP_FILE"
|
||||||
|
echo -e "${RED}Cette opération va ÉCRASER toutes les données actuelles!${NC}"
|
||||||
|
echo ""
|
||||||
|
read -p "Êtes-vous sûr de vouloir continuer? (oui/non) " -r
|
||||||
|
if [[ ! $REPLY =~ ^[Oo][Uu][Ii]$ ]]; then
|
||||||
|
echo "Restauration annulée."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${GREEN}=== Début de la restauration ===${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[1/5] Extraction de l'archive...${NC}"
|
||||||
|
tar xzf "$BACKUP_FILE" -C "$TEMP_DIR"
|
||||||
|
|
||||||
|
# Trouver le répertoire de sauvegarde
|
||||||
|
BACKUP_DIR=$(find "$TEMP_DIR" -maxdepth 1 -type d -name "gitea_backup_*" | head -n 1)
|
||||||
|
if [ -z "$BACKUP_DIR" ]; then
|
||||||
|
echo -e "${RED}Erreur: Structure de sauvegarde invalide${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Vérifier que les fichiers nécessaires existent
|
||||||
|
if [ ! -f "$BACKUP_DIR/database.dump" ] || [ ! -f "$BACKUP_DIR/gitea_data.tar.gz" ]; then
|
||||||
|
echo -e "${RED}Erreur: Fichiers de sauvegarde manquants${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo -e "${GREEN}✓ Archive extraite${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[2/5] Arrêt des services...${NC}"
|
||||||
|
docker compose down
|
||||||
|
echo -e "${GREEN}✓ Services arrêtés${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[3/5] Démarrage de la base de données...${NC}"
|
||||||
|
docker compose up -d db
|
||||||
|
echo "Attente du démarrage de PostgreSQL..."
|
||||||
|
sleep 10
|
||||||
|
|
||||||
|
# Attendre que PostgreSQL soit prêt
|
||||||
|
MAX_TRIES=30
|
||||||
|
COUNTER=0
|
||||||
|
until docker compose exec -T db pg_isready -U "$POSTGRES_USER" > /dev/null 2>&1; do
|
||||||
|
COUNTER=$((COUNTER + 1))
|
||||||
|
if [ $COUNTER -gt $MAX_TRIES ]; then
|
||||||
|
echo -e "${RED}Erreur: PostgreSQL ne démarre pas${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo "En attente de PostgreSQL... ($COUNTER/$MAX_TRIES)"
|
||||||
|
sleep 2
|
||||||
|
done
|
||||||
|
echo -e "${GREEN}✓ PostgreSQL prêt${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[4/5] Restauration de la base de données...${NC}"
|
||||||
|
# Supprimer et recréer la base de données
|
||||||
|
export PGPASSWORD="$POSTGRES_PASSWORD"
|
||||||
|
docker compose exec -T db psql -U "$POSTGRES_USER" -d postgres -c "DROP DATABASE IF EXISTS $POSTGRES_DATABASE;"
|
||||||
|
docker compose exec -T db psql -U "$POSTGRES_USER" -d postgres -c "CREATE DATABASE $POSTGRES_DATABASE OWNER $POSTGRES_USER;"
|
||||||
|
|
||||||
|
# Restaurer le dump
|
||||||
|
docker compose exec -T db pg_restore \
|
||||||
|
-U "$POSTGRES_USER" \
|
||||||
|
-d "$POSTGRES_DATABASE" \
|
||||||
|
--clean \
|
||||||
|
--if-exists \
|
||||||
|
--no-owner \
|
||||||
|
--no-acl \
|
||||||
|
< "$BACKUP_DIR/database.dump"
|
||||||
|
|
||||||
|
echo -e "${GREEN}✓ Base de données restaurée${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[5/5] Restauration des données Gitea...${NC}"
|
||||||
|
# Démarrer Gitea
|
||||||
|
docker compose up -d gitea redis
|
||||||
|
|
||||||
|
# Attendre que Gitea soit prêt
|
||||||
|
echo "Attente du démarrage de Gitea..."
|
||||||
|
sleep 15
|
||||||
|
|
||||||
|
# Arrêter temporairement Gitea pour la restauration des fichiers
|
||||||
|
docker compose stop gitea
|
||||||
|
|
||||||
|
# Nettoyer les données existantes
|
||||||
|
if [ -d "./data" ]; then
|
||||||
|
echo "Suppression des anciennes données..."
|
||||||
|
rm -rf ./data/*
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Extraire les données depuis l'archive
|
||||||
|
mkdir -p ./data
|
||||||
|
tar xzf "$BACKUP_DIR/gitea_data.tar.gz" -C ./data
|
||||||
|
|
||||||
|
echo -e "${GREEN}✓ Données restaurées${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}Redémarrage de tous les services...${NC}"
|
||||||
|
docker compose up -d
|
||||||
|
|
||||||
|
# Attendre que les services soient prêts
|
||||||
|
sleep 10
|
||||||
|
MAX_TRIES=30
|
||||||
|
COUNTER=0
|
||||||
|
until docker compose ps | grep -q "gitea.*running"; do
|
||||||
|
COUNTER=$((COUNTER + 1))
|
||||||
|
if [ $COUNTER -gt $MAX_TRIES ]; then
|
||||||
|
echo -e "${YELLOW}Avertissement: Gitea met du temps à démarrer${NC}"
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
echo "En attente de Gitea... ($COUNTER/$MAX_TRIES)"
|
||||||
|
sleep 2
|
||||||
|
done
|
||||||
|
|
||||||
|
echo -e "${GREEN}=== Restauration terminée avec succès ===${NC}"
|
||||||
|
echo "Gitea devrait être accessible sur: http://localhost:3000"
|
||||||
|
echo ""
|
||||||
|
echo "Vérifications recommandées:"
|
||||||
|
echo " - Vérifier l'accès web"
|
||||||
|
echo " - Tester l'authentification"
|
||||||
|
echo " - Vérifier les dépôts"
|
||||||
|
echo " - Consulter les logs: docker compose logs -f gitea"
|
||||||
106
scripts/update.sh
Executable file
106
scripts/update.sh
Executable file
@@ -0,0 +1,106 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# ============================================
|
||||||
|
# Script de mise à jour Gitea
|
||||||
|
# ============================================
|
||||||
|
# Ce script met à jour Gitea de manière sécurisée
|
||||||
|
# avec une sauvegarde automatique avant la mise à jour
|
||||||
|
|
||||||
|
set -e # Arrêter en cas d'erreur
|
||||||
|
|
||||||
|
# Couleurs pour l'affichage
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# Charger les variables d'environnement
|
||||||
|
if [ -f .env ]; then
|
||||||
|
source .env
|
||||||
|
else
|
||||||
|
echo -e "${RED}Erreur: Fichier .env non trouvé${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Fonction de nettoyage en cas d'erreur
|
||||||
|
cleanup() {
|
||||||
|
echo -e "${YELLOW}Une erreur s'est produite. Vérifiez l'état des services.${NC}"
|
||||||
|
echo "Pour revenir à l'état précédent, utilisez la dernière sauvegarde:"
|
||||||
|
echo " make restore FILE=backups/gitea_backup_*.tar.gz"
|
||||||
|
}
|
||||||
|
|
||||||
|
trap cleanup ERR
|
||||||
|
|
||||||
|
echo -e "${GREEN}=== Mise à jour de Gitea ===${NC}"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Vérifier que les services tournent
|
||||||
|
if ! docker compose ps | grep -q "gitea.*running"; then
|
||||||
|
echo -e "${YELLOW}Avertissement: Gitea ne semble pas être en cours d'exécution${NC}"
|
||||||
|
read -p "Continuer quand même? (oui/non) " -r
|
||||||
|
if [[ ! $REPLY =~ ^[Oo][Uu][Ii]$ ]]; then
|
||||||
|
echo "Mise à jour annulée."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[1/6] Création d'une sauvegarde de sécurité...${NC}"
|
||||||
|
if ! bash scripts/backup.sh; then
|
||||||
|
echo -e "${RED}Erreur: La sauvegarde a échoué. Mise à jour annulée.${NC}"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo -e "${GREEN}✓ Sauvegarde créée${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[2/6] Téléchargement des nouvelles images...${NC}"
|
||||||
|
docker compose pull
|
||||||
|
echo -e "${GREEN}✓ Images téléchargées${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[3/6] Arrêt des services...${NC}"
|
||||||
|
docker compose down
|
||||||
|
echo -e "${GREEN}✓ Services arrêtés${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[4/6] Démarrage avec les nouvelles versions...${NC}"
|
||||||
|
docker compose up -d
|
||||||
|
echo -e "${GREEN}✓ Services démarrés${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[5/6] Attente du démarrage complet...${NC}"
|
||||||
|
sleep 10
|
||||||
|
|
||||||
|
# Attendre que Gitea soit prêt
|
||||||
|
MAX_TRIES=60
|
||||||
|
COUNTER=0
|
||||||
|
until docker compose exec -T gitea wget -q --spider http://localhost:3000/api/healthz 2>/dev/null; do
|
||||||
|
COUNTER=$((COUNTER + 1))
|
||||||
|
if [ $COUNTER -gt $MAX_TRIES ]; then
|
||||||
|
echo -e "${RED}Erreur: Gitea ne répond pas après la mise à jour${NC}"
|
||||||
|
echo "Vérifiez les logs: docker compose logs gitea"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo "En attente de Gitea... ($COUNTER/$MAX_TRIES)"
|
||||||
|
sleep 2
|
||||||
|
done
|
||||||
|
echo -e "${GREEN}✓ Gitea répond${NC}"
|
||||||
|
|
||||||
|
echo -e "${YELLOW}[6/6] Vérification de l'état...${NC}"
|
||||||
|
# Afficher les versions
|
||||||
|
echo ""
|
||||||
|
echo "Versions actuelles:"
|
||||||
|
docker compose images
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "État des services:"
|
||||||
|
docker compose ps
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo -e "${GREEN}=== Mise à jour terminée avec succès ===${NC}"
|
||||||
|
echo ""
|
||||||
|
echo "Vérifications recommandées:"
|
||||||
|
echo " 1. Accéder à l'interface web: http://localhost:3000"
|
||||||
|
echo " 2. Vérifier les dépôts existants"
|
||||||
|
echo " 3. Tester les fonctionnalités principales"
|
||||||
|
echo " 4. Consulter les logs: docker compose logs -f gitea"
|
||||||
|
echo ""
|
||||||
|
echo "En cas de problème, restaurez la sauvegarde:"
|
||||||
|
LATEST_BACKUP=$(ls -t backups/gitea_backup_*.tar.gz 2>/dev/null | head -n 1)
|
||||||
|
if [ -n "$LATEST_BACKUP" ]; then
|
||||||
|
echo " make restore FILE=$LATEST_BACKUP"
|
||||||
|
fi
|
||||||
Reference in New Issue
Block a user