Cette page explique comment utiliser le fichier de configuration Cloud Storage FUSE pour configurer le comportement de Cloud Storage FUSE de manière persistante. Pour utiliser le fichier de configuration, spécifiez le chemin d'accès au fichier de configuration dans l'option --config-file
lors de votre commande d'installation.
Le fichier de configuration est un fichier YAML qui utilise le format et les champs suivants. Certains champs peuvent également être spécifiés à l'aide d'options de ligne de commande.
write: create-empty-file: CREATE_EMPTY_FILE logging: file-path: "FILE_PATH" format: FORMAT severity: SEVERITY log-rotate: max-file-size-mb: MAX_FILE_SIZE backup-file-count: BACKUP_FILE_COUNT compress: COMPRESS file-cache: max-size-mb: MAX_SIZE cache-file-for-range-read: CACHE_FILE_FOR_RANGE_READ enable-parallel-downloads: ENABLE_PARALLEL_DOWNLOADS parallel-downloads-per-file: PARALLEL_DOWNLOADS_PER_FILE max-parallel-downloads: MAX_PARALLEL_DOWNLOADS download-chunk-size-mb: DOWNLOAD_CHUNK_SIZE metadata-cache: stat-cache-max-size-mb: STAT_CACHE_MAX_SIZE ttl-secs: TTL_SECS type-cache-max-size-mb: TYPE_CACHE_MAX_SIZE cache-dir: "CACHE_DIR" gcs-auth: anonymous-access: ANONYMOUS_ACCESS file-system: kernel-list-cache-ttl-secs: KERNEL_LIST_CACHE_TTL_SECS ignore-interrupts: IGNORE_INTERRUPTS
Champs de configuration
Le tableau suivant décrit les champs que vous pouvez spécifier dans votre fichier de configuration. Sauf indication contraire, tous les champs sont facultatifs.
Champ | Description |
---|---|
create-empty-file |
Valeur booléenne qui indique s'il faut créer un fichier de zéro octet dans Cloud Storage lorsque vous commencez à écrire dans un nouveau fichier, sur le bucket installé. Si ce champ n'est pas spécifié, la valeur par défaut est false . |
file-path |
Chemin d'accès au fichier journal dans lequel les journaux seront écrits, spécifié sous forme de chaîne. Par exemple, /var/log . Si ce champ n'est pas spécifié, les journaux sont acheminés vers stdout lorsque Cloud Storage FUSE s'exécute en mode premier plan et vers syslogs lorsque Cloud Storage FUSE s'exécute en mode arrière-plan. |
format |
Format dans lequel les journaux sont générés, exprimé sous la forme d'une énumération.
Les valeurs sont : text ou json . Si ce champ n'est pas spécifié, la valeur par défaut est json . |
severity |
Gravité des journaux que Cloud Storage FUSE doit générer, exprimée sous forme d'énumération. Les niveaux de gravité ci-après sont classés du moins grave au plus grave :
Lorsque vous spécifiez un niveau de gravité, Cloud Storage FUSE génère les journaux présentant une gravité égale à ce niveau, ou supérieure. Par exemple, lorsque vous spécifiez
Si ce champ n'est pas spécifié, la valeur par défaut est |
max-file-size-mb |
Taille maximale en mégaoctets (Mo) que les fichiers journaux peuvent atteindre avant d'être alternés. La valeur minimale est 1 . Si ce champ n'est pas spécifié, la valeur par défaut est 512 . |
backup-file-count |
Nombre maximal de fichiers journaux alternés à conserver, à l'exclusion du fichier actif dans lequel les journaux sont écrits. Lorsque la valeur est définie sur 0 , tous les fichiers journaux alternés sont conservés. Si ce champ n'est pas spécifié, la valeur par défaut est 10 . |
compress |
Valeur booléenne qui indique si les fichiers journaux alternés sont compressés à l'aide de gzip. Si ce champ n'est pas spécifié, la valeur par défaut est true . |
max-size-mb |
Taille maximale en Mio que le cache de fichiers peut utiliser. Si cette option est présente,
Si ce champ n'est pas spécifié, la valeur par défaut est |
cache-file-for-range-read |
Valeur booléenne qui détermine si l'objet complet doit être téléchargé de manière asynchrone et stocké dans le répertoire de cache Cloud Storage FUSE lorsque la première lecture est effectuée à partir d'un décalage différent de zéro. Cette valeur doit être définie sur Notez que si vous effectuez une lecture partielle commençant au décalage |
enable-parallel-downloads |
Accélère les lectures de fichiers volumineux en utilisant le répertoire de cache de fichiers comme tampon de préchargement utilisant plusieurs nœuds de calcul afin de télécharger des fichiers volumineux en parallèle. La valeur par défaut est Pour utiliser les téléchargements parallèles, vous devez activer la mise en cache de fichiers. Pour en savoir plus sur les téléchargements parallèles et configurer les propriétés de compatibilité, consultez la page Améliorer les performances de lecture en utilisant les téléchargements parallèles. |
parallel-downloads-per-file |
Spécifie le nombre maximal de goroutines à générer par fichier pour télécharger l'objet de Cloud Storage vers le cache de fichiers.
La valeur par défaut est |
max-parallel-downloads |
Nombre maximal de goroutines pouvant être lancées à un même moment pour tous les jobs de téléchargement de fichiers. La valeur par défaut est le double du nombre de cœurs de processeur de la machine. Pour contourner une limite, spécifiez la valeur |
download-chunk-size-mb |
Spécifie la taille en Mio de chaque requête de lecture que chaque goroutine envoie à Cloud Storage lors du téléchargement de l'objet dans le cache de fichiers.
La valeur par défaut est |
stat-cache-max-size-mb |
Taille maximale en Mio que le cache de statistiques peut utiliser. Le cache de statistiques est toujours entièrement conservé en mémoire.
Si ce champ n'est pas spécifié, la valeur par défaut est |
ttl-secs |
Définit la valeur TTL (Time To Live) des entrées de métadonnées mises en cache, exprimée en secondes.
Si ce champ n'est pas spécifié, la valeur par défaut est |
type-cache-max-size-mb |
Taille maximale en Mio par répertoire que le cache de types peut utiliser. Le cache de types est toujours entièrement conservé en mémoire.
Si ce champ n'est pas spécifié, la valeur par défaut est |
cache-dir |
Spécifie le répertoire où stocker les données du cache de fichiers. Ce champ doit être spécifié pour activer la mise en cache des fichiers. |
anonymous-access |
Désactive l'authentification pour les requêtes. Définissez ce champ si vous utilisez un point de terminaison personnalisé qui n'est pas compatible avec l'authentification ou si vous utilisez Cloud Storage FUSE pour installer des buckets publics. La valeur par défaut est "false". |
kernel-list-cache-ttl-secs |
Active le cache de liste et définit la valeur TTL (Time To Live) en secondes des entrées de liste mises en cache.
L'allocation de mémoire pour le cache de liste est contrôlée par le noyau en fonction de la mémoire disponible. La valeur par défaut est 0 , ce qui désactive la mise en cache des listes.
Pour définir le champ --kernel-list-cache-ttl-secs , spécifiez une valeur positive en secondes afin de conserver la réponse de la liste d'annuaires dans le cache de page du noyau. Pour contourner l'expiration de l'entrée et toujours renvoyer la réponse de la liste à partir du cache lorsqu'elle est disponible, spécifiez la valeur -1 . |
ignore-interrupts |
Indique à Cloud Storage FUSE d'ignorer les signaux d'interruption système, tels que les signaux SIGINT déclenchés par Control+C . Cela empêche les signaux d'arrêter les opérations en cours. Les valeurs sont true ou false . La valeur par défaut est true . |