Différences

Ci-dessous, les différences entre deux révisions de la page.

--- software:applications:restic:000_restic [2026/07/20 16:31] – créée yoann
+++ software:applications:restic:000_restic [2026/07/22 17:10] (Version actuelle) – yoann
@@ Ligne 3: / Ligne 3: @@
 ====== Sauvegarder avec restic ======
+**restic** un programme en ligne de commande permettant de sauvegarder ses données.
 Principales caractéristiques de **restic** :
-  * **Agnostic** : il existe sur les principaux systèmes d'exploitation : Linux, BSD, Mac et Windows ;
+  * **Agnostique** : il existe sur les principaux systèmes d'exploitation : Linux, BSD, Mac et Windows ;
   * **Flexible** : il s'interface avec de nombreux systèmes de stockage auto-hébergés ou via les services en ligne ;
   * **Simple** : exécutable autonome sans dépendances de services ou de serveurs ;
@@ Ligne 25: / Ligne 28: @@
 </code>
-restic conserve les sauvegardes au sein d'un dépôt qu'il nous faut initialiser :
+==== Initialiser un dépôt ====
+restic conserve les sauvegardes au sein d'un dépôt. On commence donc par en créer un via la commande ''init''.
 <code bash>
@@ Ligne 33: / Ligne 38: @@
 A la création du dépôt un mot de passe est demandé. Ce mot de passe est important, il sera nécessaire pour toute interaction avec le dépôt.
-Pour ne pas avoir à systématiquement préçiser le dépôt à utiliser via l'option ''%%--repo%%'', on pourra définir une variable d'environnement :
+Pour ne pas avoir à systématiquement préciser le dépôt à utiliser via l'argument ''%%--repo%%'', on pourra définir une variable d'environnement :
 <code bash>
 export RESTIC_REPOSITORY=/home/yoann/backups/restic-repo/
+# Pour éviter de ressaisir le mot de passe
+export RESTIC_PASSWORD=MyVeryGooooodPassWord
 </code>
-On peut faire créer sa première sauvegarde :
+==== Sauvegarder ====
+On peut à présent créer sa première sauvegarde :
 <code bash>
+restic backup ~/Documents
+</code>
+restic désigne par "snapshots" vos sauvegardes. Pour lister les snapshots présents dans le dépôt :
+<code bash>
+restic snapshots
 </code>
+Certaines commandes peuvent être exécutés "à blanc" via l'option ''%%--dry-run%%''. C'est le cas pour la sauvegarde.
+On ajoute un nouveau fichier au dossier ''~/Documents'', puis on simule une sauvegarde (avec l' option ''%%--dry-run%%'')
+<code bash>
+echo "Hello World!" > ~/Documents/aNewFile.txt
+# test la commande de sauvegarde
+restic backup ~/Documents/ --dry-run
+</code>
+restic détecte bien le nouveau fichier et indique que seulement celui-ci sera copié. On peut effectivement exécuter la sauvegarde :
+<code bash>
+restic backup ~/Documents
+</code>
+==== Lister/rechercher dans le dépot ====
+Pour lister l'ensemble des fichiers présents dans le snapshot le plus récent :
+<code bash>
+restic ls latest
+</code>
+Pour ne lister que le contenu d'un sous-dossier :
+<code bash>
+restic ls latest /home/yoann/Documents/factures
+</code>
+Pour rechercher un fichier dans les sauvegardes :
+<code bash>
+restic find "wishlist*"
+# rechercher uniquement dans le dernier snapshot
+resstic find "wishlist*" latest
+# rechercher uniquement dans les snapshot désignés
+restic find "wishlist*" 5e1ea3aa 4d22f100
+</code>
+La recherche est sensible à la casse de caractères mais on peut utiliser l'option ''%%--ignore-case%%'' pour changer ce comportement par défaut.
+<code bash>
+restic find --ignore-case "contrat*" latest
+</code>
+==== Restaurer ====
+Par défaut la restauration reconstruit le chemin complet dans le répertoire de destination (cible) :
+<code bash>
+# le fichier et les dossiers parents sont recréés sur la destination (target)
+restic restore latest --include /home/yoann/Documents/wishlist.txt --target /tmp
+</code>
+Dans le cas présenté ci-dessus le dossier ''/tmp'' contiendra après exécution de la restauration ''/tmp/home/yoann/Documents/wishlist.txt''.
+Si l'on souhaite restaurer le fichier à son emplacement initial, on peut saisir :
+<code bash>
+restic restore latest --include /home/yoann/Documents/wishlist.txt --target /
+</code>
+Pour ne pas reconstruire l'ensemble de l’arborescence et restaurer seulement le fichier souhaité dans un répertoire cible différent, on peut utiliser la syntaxe :
+<code bash>
+restic restore latest:/home/yoann/Documents/ --include "wishlist.txt" --target /tmp
+</code>
+De la même manière, pour restaurer le dossier ''/home/yoann/Documents/factures'' et son contenu dans le répertoire cible ''/tmp'' sans recréer toute l'arborescence :
+<code bash>
+restic restore latest:/home/yoann/Documents --include factures --target /tmp/
+</code>
+Pour restaurer le dernier snapshot :
+<code bash>
+restic restore latest --target /
+</code>
+==== Supprimer un snapshot ====
+La suppression s'effectue en deux temps via les commandes ''forget'' puis ''prune''.
+  * La commande forget supprime les références vers les données mais pas les données-elles même qui restent dans le dépôt. Cette opération est rapide.
+  * L'opération prune conduit à la suppression des données non référencées présentes dans le dépôt et la la libération de l'espace disque. Cette opération est plus longue et pendant qu'elle s'effectue, le dépôt n'est pas accessible.
+''forget'' et ''prune'' ont également une option d'exécution à blanc via l'argument ''%%--dry-run%%''
+<code bash>
+restic forget latest --dry-run
+restic forget latest
+restic prune --dry-run
+</code>
+Après la commande ''prune'' on peut vouloir vérifier l'intégrité du dépôt.
+==== Maintenance du dépôt ====
+Il est recommandé de vérifier périodiquement l'état du dépôt :
+<code bash>
+restic check
+restic check --read-data
+</code>
 ===== Références =====

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page