Politique de sauvegarde de fichiers

Ce que fait une politique de fichiers

Une politique de fichiers sauvegarde les chemins que vous donnez sur une machine. L'agent lit ces chemins, il chiffre les données, puis il les envoie dans le dépôt de la machine.

Vous posez des exclusions pour laisser de côté une partie d'un chemin : un dossier de cache, un type de fichier, un sous-dossier lourd.

Chaque sauvegarde réussie donne un point de restauration. Vous parcourez ensuite ce point pour restaurer un fichier, un dossier ou une sélection.

Prérequis

• Une machine avec un agent enrôlé. Voir Installer l'agent sur Linux ou Installer l'agent sur Windows.
• Le rôle Technicien ou Administrateur. Le rôle Lecture seule lit la politique sans la changer. Voir Rôles et droits.
• Une licence de la plateforme qui permet les sauvegardes.
• Pour parcourir la machine depuis le formulaire : un agent en ligne.
• Pour ajouter un partage réseau : un partage déjà déclaré sur l'agent.

Les champs d'une politique de fichiers

Le formulaire a six parties.

Partie	Ce que vous réglez
Nom et type	Le nom de la politique, et son type Fichiers.
Ce qu'il faut sauvegarder	Les Chemins et les Exclus.
Quand	Les plannings, le fuseau horaire et la fenêtre de démarrage.
Rétention	Le nombre de points de restauration gardés.
Réseau	La limite d'envoi de cette politique.
Options avancées	Ignorer les dossiers de cache et Rester sur un seul système de fichiers.

Une politique porte aussi des scripts avant et après la sauvegarde.

Les valeurs d'une nouvelle politique sont : un planning tous les jours à 02:00, le fuseau horaire de votre navigateur, aucune limite de fenêtre, et une rétention de 7 points quotidiens, 4 hebdomadaires et 12 mensuels.

Créer une politique de fichiers

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis la machine.
3. Ouvrez l'onglet Politiques.
4. Cliquez Créer une politique. Quand la machine n'a encore aucune politique, le bouton s'appelle Créer la politique.
5. Saisissez un Nom, par exemple Fichiers métier. Ce nom s'affiche dans la liste des politiques.
6. Choisissez le type Fichiers.
7. Saisissez les Chemins, un chemin absolu par ligne. Voir Choisir les chemins.
8. Saisissez les Exclus, un motif par ligne. Voir Poser les exclusions.
9. Laissez les autres parties sur leurs valeurs, ou réglez-les.
10. Cliquez Créer la politique.

Le portail revient à l'onglet Politiques. Il écrit la date de la prochaine sauvegarde, ou « Les sauvegardes planifiées sont en pause. » quand la politique est désactivée.

Choisir les chemins

Un chemin est absolu. Sa forme suit le système de la machine.

Source	Forme du chemin	Exemple
Disque local d'une machine Linux	/ puis les noms	/etc, /var/www
Disque local d'une machine Windows	La lettre du lecteur, puis \	C:\Users, D:\Donnees
Partage réseau déclaré sur l'agent	/@shares/ puis le nom court du partage	/@shares/compta, /@shares/compta/Factures/2026

Pour ajouter un partage réseau, cliquez Ajouter un partage sous le champ Chemins. Le portail écrit le chemin du partage dans le champ. Un partage est d'abord déclaré sur l'agent. Voir Partage réseau.

Un chemin écrit directement en UNC (\\serveur\partage) n'est pas accepté. Passez toujours par un partage déclaré.

Le portail refuse une liste de chemins vide.

Parcourir la machine

Le portail lit les dossiers de la machine en direct. Vous cochez les dossiers au lieu de taper les chemins.

1. Ouvrez le formulaire de la politique.
2. Cliquez Parcourir la machine, sous le champ Chemins.
3. Ouvrez un dossier pour voir son contenu. Le panneau lit un seul niveau à la fois.
4. Cochez chaque dossier et chaque fichier à sauvegarder.
5. Pour exclure un élément d'un dossier déjà coché, placez le pointeur sur sa ligne, puis cliquez Exclure. Le portail écrit l'étiquette Exclu sur la ligne.
6. Lisez le résumé en bas du panneau : il compte les chemins et les exclusions ajoutés et retirés.
7. Cliquez Mettre dans le formulaire.
8. Vérifiez les champs Chemins et Exclus. Vous pouvez encore les corriger à la main.
9. Cliquez Créer la politique ou Enregistrer.

Le panneau n'enregistre rien par lui-même : il remplit les deux champs de texte. La politique est enregistrée à l'étape 9.

Sur une machine Windows, la racine / donne la liste des lecteurs. Ouvrez un lecteur pour voir ses dossiers.

Le bouton Parcourir la machine est grisé quand l'agent est hors ligne. Le portail écrit alors « Machine hors ligne : parcours impossible. Tapez les chemins, un par ligne. »

Les dossiers du système et ceux de l'agent ne sont pas listés. Sur Linux, ce sont /proc, /sys, /dev, /run, et les dossiers de l'agent. Sur Windows, ce sont les dossiers de l'agent, System Volume Information et les dossiers de travail des restaurations, à la racine de chaque lecteur.

Poser les exclusions

Le champ Exclus prend un motif par ligne, dans l'ordre. Un motif suit la syntaxe des motifs d'exclusion de restic.

Motif	Ce qu'il laisse de côté
/var/cache	Le dossier /var/cache et son contenu. Un / au début ancre le motif à la racine.
*.tmp	Tous les fichiers dont le nom finit par .tmp.
node_modules	Tous les dossiers node_modules, à n'importe quelle profondeur.
/home/user/repos/**/target	Les dossiers target à n'importe quelle profondeur sous /home/user/repos.
!/var/cache/important	Reprend un élément qu'une ligne plus haut a laissé de côté.

Règles à retenir :

• Un motif porte sur des composants entiers du chemin. Le motif foo laisse de côté /dir/foo, mais pas /dir/foobar.
• Un * ne traverse pas le séparateur /. Pour traverser des sous-dossiers, écrivez ** comme composant entier du chemin, par exemple foo/**/bar.
• Une ligne qui commence par ! reprend ce qu'une ligne plus haut a laissé de côté. Quand un dossier entier est laissé de côté, vous ne reprenez plus un fichier à l'intérieur.
• Une exclusion ne porte pas sur un chemin de la liste Chemins. Un chemin de cette liste est toujours sauvegardé. Retirez-le de la liste pour ne plus le sauvegarder.

Deux options du formulaire posent des exclusions à votre place, dans Options avancées :

• Ignorer les dossiers de cache laisse de côté le contenu d'un dossier qui porte un fichier CACHEDIR.TAG, comme les caches des navigateurs. Cette option est active sur une nouvelle politique.
• Rester sur un seul système de fichiers arrête la lecture à la limite du système de fichiers. Les autres disques et les dossiers réseau montés dans un chemin ne sont pas lus. Cette option est inactive sur une nouvelle politique.

Changer les chemins, les exclusions ou les options

1. Ouvrez l'onglet Politiques de la machine.
2. Cliquez Modifier sur la politique.
3. Changez les champs Chemins ou Exclus, ou les options de Options avancées.
4. Cliquez Enregistrer.

Ces changements s'appliquent tout de suite :

• un ajout de chemin ;
• un retrait d'exclusion, quand c'est le seul changement de la liste Exclus ;
• la désactivation de Ignorer les dossiers de cache ou de Rester sur un seul système de fichiers.

Ces changements s'appliquent 72 heures plus tard :

• un retrait de chemin ;
• un ajout d'exclusion ;
• le retrait d'une ligne qui commence par ! ;
• un nouvel ordre des lignes de la liste Exclus ;
• l'activation de Ignorer les dossiers de cache ou de Rester sur un seul système de fichiers.

Jusque-là, la politique garde ses valeurs actuelles, et vous pouvez annuler le changement. Voir Annuler une action différée.

Le portail écrit l'avertissement « Retrait de chemins sources en attente » ou « Modification des filtres en attente », avec la date d'application.

Après un changement de la liste des chemins, la sauvegarde suivante relit tous les fichiers. Elle ne les renvoie pas : les données déjà dans le dépôt ne repartent pas sur le réseau.

Limites et précautions

• Une politique de fichiers ne protège pas une base de données qui tourne. Une copie des fichiers de données prise pendant que la base tourne ne peut pas être restaurée. Pour SQL Server, créez une politique SQL Server. Quand un chemin de la politique contient des fichiers de données SQL Server, le portail écrit un avertissement et nomme ces chemins.
• L'agent lit les fichiers avec les droits les plus élevés du système. Tout chemin de la machine est donc lisible. Choisissez les chemins avec soin : tout ce qui est dans un chemin part dans le dépôt.
• Sur une machine Windows, l'agent lit les fichiers dans un instantané VSS. Quand l'instantané échoue, l'agent lit les fichiers en direct et la tâche porte un avertissement.
• Le chemin /run/baastide est réservé à l'agent. Le portail refuse une politique qui le contient.
• Le portail ne vérifie pas qu'un chemin existe sur la machine. Parcourez la machine, ou relisez les chemins avant d'enregistrer.
• Les partages réseau demandent un agent 0.5.0 ou plus récent. Un agent Linux lit les partages SMB et NFS. Un agent Windows lit les partages SMB seulement.
• Parcourir la machine demande un agent 0.4.0 ou plus récent. La plateforme n'accepte aucun agent plus ancien que 0.6.1 : tous les agents acceptés savent parcourir.
• Un administrateur de la machine peut couper le parcours dans le fichier de configuration de l'agent. Le portail écrit alors « Parcours désactivé sur cette machine ». Tapez les chemins à la main.
• Le panneau de parcours lit au plus 100 000 éléments par dossier, et il attend la machine pendant 10 secondes. Au-delà, il demande de taper le chemin voulu.
• Une politique désactivée ou supprimée garde ses points de restauration. Sa dernière rétention s'applique toujours à eux.

Référence

Les routes de l'API pour les politiques et pour le parcours d'une machine sont dans la référence de l'API : Backups et Endpoints.