SEC.01

Le playbook

Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.

  1. 01reconBorg déjà installé + version (1.2/1.4 attendu ; 2.x → syntaxe différente)
  2. 02reconle dossier source existe-t-il ? taille
  3. 03reconconfig / timer Borg déjà en place ? ne pas les écraser
  4. 04recondépôt local déjà initialisé ? → ne jamais refaire init
  5. 05recondépôt local : place libre, et même disque que la source ? (à signaler)
  6. 06recondistro → apt, dnf (Fedora) ou dnf + EPEL (RHEL/Rocky/Alma)
  7. 07agirInstaller Borgvérif
  8. 08agirGénérer la passphrasevérif
  9. 09agirÉcrire /etc/borg/borg.envvérif
  10. 10agirInitialiser le dépôt (si nouveau)vérif
  11. 11agirExporter la clé du dépôtvérif
  12. 12agirCréer le service borg-backupvérif
  13. 13agirPlanifier (${schedule})vérif
  14. 14agirActiver le timervérif
  15. 15agirPremière sauvegardevérif

SEC.02

Ce qu'elle vérifie

Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.

  1. 01Installer BorgVérifié parborg --versionattendu : borg 1.2.x ou 1.4.x
  2. 02Générer la passphraseVérifié parstat -c '%a %U' /etc/borg/passphraseattendu : 600 root
  3. 03Écrire /etc/borg/borg.envVérifié parstat -c '%a' /etc/borg/borg.env && grep -c '^BORG_REPO=' /etc/borg/borg.envattendu : 600 puis 1
  4. 04Initialiser le dépôt (si nouveau)Vérifié parbash -c 'set -a && . /etc/borg/borg.env && borg info' >/dev/null && echo okattendu : ok
  5. 05Exporter la clé du dépôtVérifié parstat -c '%a' /etc/borg/repo-key.txtattendu : 600
  6. 06Créer le service borg-backupVérifié parsystemd-analyze verify /etc/systemd/system/borg-backup.service 2>&1 | grep -c borg-backupattendu : 0
  7. 07Planifier (${schedule})Vérifié parcat /etc/systemd/system/borg-backup.timerattendu : OnCalendar= la fréquence choisie
  8. 08Activer le timerVérifié parsystemctl is-active borg-backup.timerattendu : active
  9. 09Première sauvegardeVérifié parbash -c 'set -a && . /etc/borg/borg.env && borg list --last 1'attendu : une archive <hostname>-<date>

SEC.03

Les garde-fous

Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.

La passphrase, borg.env et la clé exportée ne sont jamais affichés ni loggés. Ne refais jamais borg init sur un dépôt existant ; ne supprime aucune archive hors de la politique de prune. Le dépôt ne doit pas être dans la source ; même disque → signale que ce n’est pas une vraie sauvegarde.

SEC.04

Les variables

Ce que vous choisissez avant de lancer — la recette s'occupe du reste.

NomSignification
${source}Dossier à sauvegarder
${repo}Dépôt Borg
${schedule}Fréquence

SEC.05

Comment une recette s'exécute dans Servor

Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.

recipe — fail2ban_setup150+ in catalogue
security4 étapes · risque faible · idempotentelancer
reconsshd present? ufw active? existing jails?✓
actinstall fail2ban · write default jails✓
actenable service · restart sshd (safe)✓
verifytest ban 60s · jails active · sshd alive✓

recherche par intention — tapez « firewall », obtenez ufw

  • 01Reconnaissance en lecture seule avant tout changement
  • 02Chaque commande signée par votre navigateur, validée par vous
  • 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique

SEC.06

Bouton Deploy on Servor

Vous maintenez Sauvegardes Borg ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.

Deploy on ServorFond sombre
Deploy on ServorFond clair
[![Deploy on Servor](https://servor.app/badges/deploy-on-servor.svg)](https://servor.app/deploy/setup-borg-backup)

SEC.07

Recette vérifiée

Lancez cette recette sur votre serveur

Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.