Aller au contenu principal

Paramètres de configuration

Paramètres généraux

ParamètreTypeValeur par défautUtilisation / DescriptionValeurs possibles
LogLevelstring"info"Niveau de verbosité des logs. Contrôle le niveau de sortie des logs.debug, info, warn, error
IndexCacheDirstring"$CONFIG_DIR/index_cache"Répertoire de stockage des fichiers de cache d'index.Tout chemin valide
TmpFileLocationstringRépertoire temporaire de l'OSRépertoire pour les fichiers temporaires.Tout chemin valide
TmpFileThresholdint6410485760 (10 Mo)Seuil (en octets) pour l'utilisation de fichiers temporaires.Tout entier positif
BlockFileThresholdint644194304 (4 Mo)Seuil (en octets) pour le découpage des fichiers en blocs.Tout entier positif
EncryptionKeyFilestring"$CONFIG_DIR/.encryption_key"Chemin du fichier contenant la clé de chiffrement.Tout chemin valide
EncryptionKeystring""La clé de chiffrement elle-même (lue depuis le fichier).Toute chaîne de caractères
EnableCompressionbooltrueActive la compression ZSTD pour les uploads/downloads.true, false
EnableMD5ChecksumboolfalseActive le calcul de la somme de contrôle MD5 pour les fichiers.true, false
ConcurrentWorkersint10Nombre de workers concurrents pour les opérations de sauvegarde/restauration.Tout entier positif
ManageCrontabsbooltruePermet à Snaper de gérer les crontabs système pour les sauvegardes planifiées.true, false

Paramètres S3

ParamètreTypeValeur par défautUtilisation / DescriptionValeurs possibles
Bucketstring""Nom du bucket S3. Peut $etre définie via la variable d'env DATASHELTER_BUCKET.Toute chaîne de caractères
AccessKeystring""Clé d'accès S3. Peut être définie via la variable d'env AWS_ACCESS_KEY_ID.Toute chaîne de caractères
SecretKeystring""Clé secrète S3. Peut être définie via la variable d'env AWS_SECRET_ACCESS_KEY.Toute chaîne de caractères
Endpointstring"https://s3.datashelter.cloud"URL de l'endpoint S3. Pour fournisseurs S3 personnalisés (ex : Scaleway).Toute URL valide
Regionstring"eu-west-1"Région S3. Peut être définie via la variable d'env AWS_REGION.eu-west-1
DisableSSLboolfalseDésactive SSL pour les connexions S3 (mettre à true si endpoint en http).true, false
StorageClassstring"STANDARD"Classe de stockage S3 pour les objets uploadés.STANDARD, STANDARD_IA, ONEZONE_IA
MaxRetriesint10Nombre maximal de tentatives pour les opérations S3.Tout entier positif
MultipartPartSizestring"5GB"Taille des parties pour les uploads S3 multipart (ex : "5GB" ou "100MB").Toute taille valide (ex : 100MB, 5GB)
MultipartConcurrencyint5Nombre de parties concurrentes pour les uploads S3 multipart.Tout entier positif

Backups.Files (Sauvegarde de fichiers)

ParamètreTypeDéfautUtilisation / DescriptionValeurs possibles
Namestring""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
FollowSymlinksboolfalseSuivre ou non les liens symboliques lors de la sauvegarde.true, false

Backups.Databases (Sauvegarde de bases de données)

ParamètreTypeDéfautUtilisation / DescriptionValeurs possibles
Namestring""Nom de la sauvegarde de la base de données.Toute chaîne
Typestring""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.