File di configurazione FUSE di Cloud Storage

In questa pagina viene descritto come utilizzare un file di configurazione di Cloud Storage FUSE per configurare il comportamento di Cloud Storage FUSE in modo persistente. Per utilizzare di configurazione del file, specifica il percorso del file --config-file come parte del comando mount.

Il file di configurazione è un file YAML che utilizza il formato e i campi seguenti. Alcuni dei campi possono essere specificati anche utilizzando le opzioni della riga di comando.

write:
  create-empty-file: boolean
logging:
  file-path: "string"
  format: enum
  severity: enum
  log-rotate:
    max-file-size-mb: integer
    backup-file-count: integer
    compress: boolean
file-cache:
  max-size-mb: integer
  cache-file-for-range-read: boolean
metadata-cache:
  stat-cache-max-size-mb: integer
  ttl-secs: integer
  type-cache-max-size-mb: integer
cache-dir: integer
gcs-auth:
  anonymous-access: boolean
file-system:
  ignore-interrupts: boolean

Campi di configurazione

La tabella seguente descrive i campi che puoi specificare nella configurazione . Salvo diversa indicazione, tutti i campi sono facoltativi.

Campo	Descrizione
create-empty-file	Un valore booleano che specifica se creare o meno un file a zero byte in Cloud Storage quando inizi a scrivere su un nuovo file nella del bucket montato. Se questo campo non è specificato, il valore predefinito è false.
file-path	Il percorso del file di log in cui verranno scritti i log, specificato come stringa. Ad esempio, /var/log. Se questo campo non è specificato, i log vengono instradati a stdout quando Cloud Storage FUSE viene eseguito in modalità in primo piano e ai syslog quando Cloud Storage FUSE viene eseguito in modalità in background.
format	Il formato in cui vengono generati i log, espresso come enum. I valori sono text o json. Se questo campo è non specificato, il valore predefinito è json.
severity	La gravità dei log che vuoi che vengano generati da Cloud Storage FUSE, espressa come un'enumerazione. I livelli di gravità sono ordinati dal più basso al più alto gravità: trace debug info warning error Se specifichi un livello di gravità, Cloud Storage FUSE genera log con con gravità uguale o superiore. Ad esempio, se specifichi warning, Cloud Storage FUSE genera i log per avvisi ed errori. Puoi anche specificare off per disattivare tutto il logging. Se uno di anche le tre opzioni seguenti sono specificate nell'ambito il livello di gravità viene impostato automaticamente su trace: --debug_fuse --debug_gcs --debug_mutex Se questo campo non è specificato, il valore predefinito è info.
max-file-size-mb	La dimensione massima in megabyte (MB) che i file di log possono raggiungere prima di essere ruotato. Il valore minimo è 1. Se questo campo non è specificato, Il valore predefinito è 512.
backup-file-count	Il numero massimo di file di log ruotati da conservare, esclusi i file attivi in cui vengono scritti i log. Quando il valore è impostato su 0, i file di log ruotati vengono conservati. Se questo campo non è specificato, il valore il valore predefinito è 10.
compress	Un valore booleano che specifica se i file di log ruotati vengono compressi utilizzando gzip. Se questo campo non è specificato, il valore predefinito è true.
max-size-mb	La dimensione massima in MiB che cache del file può per gli utilizzi odierni. Se presente, max-size-mb consente la memorizzazione nella cache dei file Cloud Storage FUSE è utile se vuoi limitare la capacità totale La cache di Cloud Storage FUSE può essere utilizzata all'interno della directory montata. Specifica -1 per utilizzare il valore l'intera capacità disponibile nella directory specificata cache-dir. Specifica 0 per disattivare il file . Se questo campo non è specificato, il valore predefinito è -1.
cache-file-for-range-read	Un valore booleano che determina se l'oggetto completo deve essere scaricate in modo asincrono e archiviate nella directory della cache di Cloud Storage FUSE. quando la prima lettura viene eseguita da un offset diverso da zero. Deve essere impostato su true se prevedi di eseguire diverse letture casuali o parziali legge. Se questo campo non è specificato, il valore predefinito è false. Tieni presente che se esegui una lettura parziale che inizia dall'offset 0, Cloud Storage FUSE scarica sempre in modo asincrono e memorizza nella cache .
stat-cache-max-size-mb	La dimensione massima in MiB che la cache delle statistiche può utilizzare. Cache delle statistiche viene sempre conservata interamente in memoria. Specifica 32 se il carico di lavoro prevede fino a 20.000 file. Se il carico di lavoro supera i 20.000 file, aumenta il dimensione per valori di 10 per ogni 6.000 file aggiuntivi, una media di ~1.500 byte per file. Specifica -1 per consentire alla cache delle statistiche di utilizzare molta memoria dell'oggetto o eliminare definitivamente una versione archiviata, in base alle necessità. Specifica 0 per disattivare la cache delle statistiche. Se questo campo non è specificato, il valore predefinito è 32.
ttl-secs	Definisce la durata (TTL) delle voci di metadati memorizzati nella cache, espressa in pochi secondi. Specifica -1 per bypassare una scadenza TTL e gestire il valore dalla cache ogni volta che è disponibile. Specifica 0 per assicurarti che venga letto il file più aggiornato. L'utilizzo di questo valore invia una chiamata Get metadata per assicurare che l'oggetto del file nella cache corrisponda a quella archiviata di archiviazione ideale in Cloud Storage. Per saperne di più, vedi Configurazione dell'annullamento della convalida della cache. Se questo campo non è specificato, il valore predefinito è 60.
type-cache-max-size-mb	La dimensione massima in MiB per ogni directory che può essere utilizzata dal tipo di cache. La cache dei tipi è sempre interamente conservata in memoria. Specifica 4 se il numero massimo di file all'interno di un singolo del bucket che stai montando contiene al massimo 20.000 file. Se il numero massimo di file all'interno di una singola directory il montaggio contiene più di 20.000 file, aumenta il valore di 1 ogni 5000 file, una media di ~200 byte per . Specifica -1 per consentire al tipo di cache di utilizzare la quantità di memoria disponibile necessaria. Specifica 0 per disattivare il tipo di cache. Se questo campo non è specificato, il valore predefinito è 4.
cache-dir	Specifica la directory per l'archiviazione dei dati della cache dei file. Questo campo deve essere specificato per abilitare la memorizzazione nella cache dei file.
anonymous-access	Disabilita l'autenticazione per le richieste. Imposta questo campo se utilizzi una un endpoint personalizzato che non supporta l'autenticazione o che utilizzi Cloud Storage FUSE per montare i bucket pubblici. Il valore predefinito è false.
ignore-interrupts	Indica a Cloud Storage FUSE di ignorare i segnali di interruzione di sistema, come SIGINT attivato da Control+C. Questo impedisce agli indicatori terminando le operazioni in corso. I valori sono true o false. Il valore predefinito è true.