add config validation support

This commit is contained in:
BeauTroll
2025-12-16 05:54:49 +01:00
parent 66e4cd166f
commit b215d8c325
3 changed files with 64 additions and 15 deletions

View File

@@ -61,19 +61,30 @@ borg key export /path/to/repo backup-key.txt
## Tests
```bash
# 1. Tester les notifications
# 1. Valider la configuration
sudo borgmatic config validate
# 2. Tester les notifications
./scripts/test-notifications.sh
# 2. Vérifier la santé du système
# 3. Vérifier la santé du système
sudo ./scripts/healthcheck.sh
# 3. Test à vide (dry-run)
# 4. Test à vide (dry-run)
sudo borgmatic --dry-run --verbosity 2
# 4. Premier backup réel
# 5. Premier backup réel
sudo borgmatic --verbosity 1
```
### Explications des commandes de test
- **`borgmatic config validate`** : Vérifie la syntaxe YAML et la structure de config.yaml
- **`test-notifications.sh`** : Envoie des notifications de test via ntfy
- **`healthcheck.sh`** : Vérifie l'installation, la config, le timer, le repository
- **`--dry-run`** : Simule un backup complet sans rien modifier (teste la connexion au repo)
- **Sans `--dry-run`** : Exécute un vrai backup
## Vérifier le timer
```bash
@@ -140,19 +151,35 @@ borgmatic list # Devrait afficher vos anciennes archives
## En cas de problème
```bash
# Vérifier la santé
# 1. Valider d'abord la configuration
sudo borgmatic config validate
# 2. Vérifier la santé du système
sudo ./scripts/healthcheck.sh
# Voir les logs
# 3. Voir les logs
journalctl -u borgmatic.service -n 50
# Tester la configuration (avec dry-run)
borgmatic --dry-run
# 4. Tester avec dry-run
sudo borgmatic --dry-run --verbosity 2
# Mode verbeux
sudo borgmatic --verbosity 2
# 5. Mode debug (très verbeux)
sudo borgmatic --verbosity 2 --list --log-file-verbosity 2
```
### Erreurs courantes
**`repositories' is a required property`**
- Vérifiez que `repositories:` est présent dans config.yaml
- Vérifiez que `BORG_REPO` est défini dans .env
**`Additional properties are not allowed`**
- Vous utilisez une vieille structure de config pour Borgmatic 1.x
- Mettez à jour vers Borgmatic 2.0+ : `sudo pipx install borgmatic --force`
**`command not found: borgmatic`**
- Créez les liens symboliques : `sudo ln -sf /root/.local/bin/borgmatic /usr/local/bin/borgmatic`
## Support
Consultez le [README.md](README.md) pour plus de détails.