Nouveau · l'app mobile, second appareil pour relire et signer chaque ordre
kantamaSe connecterCréer un espace

Sauvegardes testées

Une sauvegarde ne compte que si sa restauration a été essayée. L'agent sauvegarde sur votre serveur, chiffre pour sa propre clé, et restaure à l'essai dans un conteneur jetable.

3 minutesMis à jour le 18 novembre 2026

Déclarer

kantama.yaml
backups:
  - name: base                 # [a-z][a-z0-9_-]{0,31}
    kind: postgres             # postgres | files
    service: postgres          # service du manifeste qui fait tourner la base
    database: cas
    env: production            # environnement où se signent ses ordres
    every: 24h                 # 1m à 744h
    at: "04:00"                # UTC, avec une fréquence multiple de 24h
    keep: 7                    # gardées sur le serveur (1 à 100)
    test_every: 168h           # restauration d'essai planifiée
    check: "select count(*) from orders"   # requête témoin
  - name: medias
    kind: files
    volume: casmarket_medias   # ou path: /srv/medias
    every: 24h

Faire une sauvegarde

  • postgres : pg_dump --format=custom dans le conteneur du service ; sa sortie part directement dans le chiffreur, aucun octet en clair n'est écrit sur le disque.
  • files : archive tar.gz d'un dossier du serveur ou d'un volume Docker.
  • Le fichier chiffré est gardé sur le serveur ; les keep plus récents restent.

Sur ordre, core.backup.run (une passkey) ; sinon selon le planning de l'agent (--sauvegardes 30s), signalé au central par un avis signé.

Chiffrée pour l'agent

Le fichier est chiffré au fil de l'eau pour la clé P-256 de l'agent, par blocs AES-256-GCM authentifiés. Un bloc modifié, permuté ou tronqué, ou le fichier d'une autre sauvegarde, rend la lecture impossible.

La restauration d'essai

  1. L'agent vérifie le SHA-256 du fichier, relevé à la sauvegarde.
  2. postgres : il crée un conteneur jetable sans réseau, y restaure le flux déchiffré, compte les tables et le nombre exact de lignes, et lance la requête témoin.
  3. files : il relit toute l'archive en mémoire et compare le nombre de fichiers et d'octets.
  4. Le conteneur est détruit quoi qu'il arrive.

Sur ordre, core.backup.test (une passkey), ou tous les test_every.

Essais garantis par la formule

Dans toutes les formules, l'agent fait lui-même ses restaurations d'essai tous les test_every : c'est le réglage de votre kantama.yaml qui décide, Solo compris.

Équipe et Entreprise y ajoutent un minimum garanti, pour chaque sauvegarde déclarée : un essai réussi au moins chaque semaine (Équipe) ou chaque jour (Entreprise), même si test_every est absent ou plus espacé.

FormuleEssais de restauration
Soloselon test_every
Équipeau moins un essai réussi par semaine
Entrepriseau moins un essai réussi par jour

Quand le minimum n'est pas tenu, la console ouvre l'alerte « essai de restauration en retard », avec un bouton Préparer l'essai : l'ordre core.backup.test est prêt, vous le relisez et le signez. L'alerte se ferme au premier essai réussi.

Ce que voit le central

Des métadonnées seulement : nom, identifiant, taille et empreinte du fichier chiffré, durée, nombre de tables, résultat des essais. Le contenu ne quitte jamais le serveur. Une sauvegarde en échec ou en retard ouvre une alerte ; une restauration d'essai en échec, une panne.

Cette page vous a-t-elle aidé ?Modifier cette page

Les propositions de modification de la documentation ne sont pas encore ouvertes au public.