Paramètres de configuration
Paramètres généraux
| Paramètre | Type | Valeur par défaut | Utilisation / Description | Valeurs possibles |
|---|---|---|---|---|
| LogLevel | string | "info" | Niveau de verbosité des logs. Contrôle le niveau de sortie des logs. | debug, info, warn, error |
| IndexCacheDir | string | "$CONFIG_DIR/index_cache" | Répertoire de stockage des fichiers de cache d'index. | Tout chemin valide |
| TmpFileLocation | string | Répertoire temporaire de l'OS | Répertoire pour les fichiers temporaires. | Tout chemin valide |
| TmpFileThreshold | int64 | 10485760 (10 Mo) | Seuil (en octets) pour l'utilisation de fichiers temporaires. | Tout entier positif |
| BlockFileThreshold | int64 | 4194304 (4 Mo) | Seuil (en octets) pour le découpage des fichiers en blocs. | Tout entier positif |
| EncryptionKeyFile | string | "$CONFIG_DIR/.encryption_key" | Chemin du fichier contenant la clé de chiffrement. | Tout chemin valide |
| EncryptionKey | string | "" | La clé de chiffrement elle-même (lue depuis le fichier). | Toute chaîne de caractères |
| EnableCompression | bool | true | Active la compression ZSTD pour les uploads/downloads. | true, false |
| EnableMD5Checksum | bool | false | Active le calcul de la somme de contrôle MD5 pour les fichiers. | true, false |
| ConcurrentWorkers | int | 10 | Nombre de workers concurrents pour les opérations de sauvegarde/restauration. | Tout entier positif |
| ManageCrontabs | bool | true | Permet à Snaper de gérer les crontabs système pour les sauvegardes planifiées. | true, false |
Paramètres S3
| Paramètre | Type | Valeur par défaut | Utilisation / Description | Valeurs possibles |
|---|---|---|---|---|
| Bucket | string | "" | Nom du bucket S3. Peut $etre définie via la variable d'env DATASHELTER_BUCKET. | Toute chaîne de caractères |
| AccessKey | string | "" | Clé d'accès S3. Peut être définie via la variable d'env AWS_ACCESS_KEY_ID. | Toute chaîne de caractères |
| SecretKey | string | "" | Clé secrète S3. Peut être définie via la variable d'env AWS_SECRET_ACCESS_KEY. | Toute chaîne de caractères |
| Endpoint | string | "https://s3.datashelter.cloud" | URL de l'endpoint S3. Pour fournisseurs S3 personnalisés (ex : Scaleway). | Toute URL valide |
| Region | string | "eu-west-1" | Région S3. Peut être définie via la variable d'env AWS_REGION. | eu-west-1 |
| DisableSSL | bool | false | Désactive SSL pour les connexions S3 (mettre à true si endpoint en http). | true, false |
| StorageClass | string | "STANDARD" | Classe de stockage S3 pour les objets uploadés. | STANDARD, STANDARD_IA, ONEZONE_IA |
| MaxRetries | int | 10 | Nombre maximal de tentatives pour les opérations S3. | Tout entier positif |
| MultipartPartSize | string | "5GB" | Taille des parties pour les uploads S3 multipart (ex : "5GB" ou "100MB"). | Toute taille valide (ex : 100MB, 5GB) |
| MultipartConcurrency | int | 5 | Nombre de parties concurrentes pour les uploads S3 multipart. | Tout entier positif |
Backups.Files (Sauvegarde de fichiers)
| Paramètre | Type | Défaut | Utilisation / Description | Valeurs possibles |
|---|---|---|---|---|
| Name | string | "" | Nom de l'ensemble de sauvegarde. Sert de référence à la sauvegarde. | Toute chaîne |
| IncludedPaths | []string | [] | Liste des chemins à inclure dans la sauvegarde. | Tout chemin valide |
| ExcludedPaths | []string | [] | Liste des chemins à exclure de la sauvegarde. | Tout chemin valide |
| FollowSymlinks | bool | false | Suivre ou non les liens symboliques lors de la sauvegarde. | true, false |
Backups.Databases (Sauvegarde de bases de données)
| Paramètre | Type | Défaut | Utilisation / Description | Valeurs possibles |
|---|---|---|---|---|
| Name | string | "" | Nom de la sauvegarde de la base de données. | Toute chaîne |
| Type | string | "" | Type de base de données (ex : mysql, postgres). | mysql, postgres, ... |
| DBLaunchOpts | []string | [] | Options supplémentaires pour lancer la commande de sauvegarde. | Tout tableau de chaînes |
Notes
- Surcharges par variables d'environnement : Certains paramètres S3 (AccessKey, SecretKey, Bucket, Region) peuvent être surchargés par des variables d'environnement.
- Emplacement du fichier de configuration :
Le fichier de configuration se trouve généralement dans
~/.config/snaper/config.yaml. - Chiffrement : Si le chiffrement est activé, la clé est stockée dans un fichier référencé par EncryptionKeyFile.
- Section Backups : La section Backups est une liste d'ensembles de sauvegarde (fichiers et bases de données), chacun avec ses propres paramètres.