Interfaccia a riga di comando gcsfuse

Questa pagina descrive le opzioni della riga di comando gcsfuse utilizzate per interagire con Cloud Storage FUSE. Se utilizzi il driver CSI di Cloud Storage FUSE per montare i bucket nel file system locale in Google Kubernetes Engine, consulta Opzioni di montaggio per il driver CSI di Cloud Storage FUSE.

Panoramica della CLI gcsfuse

La CLI gcsfuse viene utilizzata per montare i bucket Cloud Storage come file system su una macchina locale.

Struttura del comando delle opzioni dell'interfaccia a riga di comando Cloud Storage FUSE

L'esempio seguente mostra la struttura del comando gcsfuse, inclusi gli argomenti obbligatori e le opzioni globali facoltative.

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Dove:

  • GLOBAL_OPTIONS sono le opzioni che controllano la configurazione del montaggio e il comportamento di Cloud Storage FUSE.

  • BUCKET_NAME è il nome del bucket da montare. Ad esempio, my-mount-bucket. Facoltativo. Escludi un nome bucket da questo comando per eseguire il montaggio dinamico.

  • MOUNT_POINT è la directory locale in cui verrà montato il bucket. Ad esempio, /path/to/mount/point.

Opzioni globali

Opzione Descrizione Valore valido Valore predefinito
Disabilita l'autenticazione per le richieste. Questa opzione deve essere impostata se utilizzi un endpoint personalizzato che non supporta l'autenticazione. Questa opzione deve essere impostata anche se utilizzi Cloud Storage FUSE con bucket pubblici. Valore booleano: true, false. false
Il nome dell'applicazione del punto di montaggio. Valore stringa, ad esempio: my-bucket-mount. ""
Specifica un progetto da utilizzare per la fatturazione quando si accede al bucket montato. Questa opzione è spesso richiesta quando viene montato un bucket abilitato con pagamenti a carico del richiedente. Valore stringa che rappresenta un ID progetto. ""

Attiva la cache dei file e specifica la directory per l'archiviazione dei dati della cache dei file.

 Un percorso, ad esempio: /tmp/gcsfuse-cache-path. Un valore vuoto indica che questa opzione è disattivata. Questa opzione è deselezionata per impostazione predefinita. ""
Specifica il protocollo utilizzato per comunicare con il backend Cloud Storage. http1

Esporta le metriche in Cloud Monitoring con l'intervallo specificato.

 Numero intero che rappresenta un valore in secondi, ad esempio: 10 (10 secondi). 0 specifica che non è prevista alcuna esportazione. 0
Specifica il percorso del file di configurazione che vuoi utilizzare per configurare i comportamenti di Cloud Storage FUSE. Un percorso, ad esempio: /etc/gcsfuse.yaml. ""
Specifica un endpoint personalizzato alternativo per il recupero dei dati. L'endpoint personalizzato deve supportare le risorse e le operazioni equivalenti all'endpoint JSON Cloud Storage, https://storage.googleapis.com/storage/v1. Se non viene specificato un endpoint personalizzato, Cloud Storage FUSE utilizza l'endpoint globale dell'API Cloud Storage JSON, https://storage.googleapis.com/storage/v1. Se l'autenticazione non è supportata sull'endpoint personalizzato specificato, imposta il flag --anonymous-access su true per ignorare l'autenticazione. Un endpoint, ad esempio: http://localhost:443/storage/v1. ""
Attiva l'output di debug relativo a FUSE. Questa opzione è stata sostituita dall'opzione --log-severity. Per attivare l'output di debug, imposta l'opzione --log-severity su trace, che include log di traccia, debug, informazioni, avviso ed errore. Valore booleano: true, false. false
Stampa le informazioni su richiesta e tempistiche di Cloud Storage. Questa opzione è stata sostituita dall'opzione --log-severity. Per attivare l'output di debug, imposta l'opzione --log-severity su trace, che include log di traccia, debug, informazioni, avviso ed errore. Valore booleano: true, false. false
Esce dal programma quando vengono rilevate violazioni invarianti interne. Valore booleano: true, false. false
Stampa messaggi di debug quando un mutex viene mantenuto troppo a lungo. Se questa opzione è specificata, il livello di gravità dei log viene impostato automaticamente su trace, che include i log di traccia, debug, informazioni, avviso ed errore. Valore booleano: true, false. false
Bit di autorizzazione per le directory, in formato ottale. Numero intero compreso tra 000 e 777 (inclusi). 755
Crea una voce della cache dei tipi con il tipo NonexistentType se non viene trovato un file in Cloud Storage. Se il file viene creato in Cloud Storage, ma la voce NonexistentType per il file viene memorizzata nella cache, Cloud Storage FUSE non può richiedere il file finché la voce NonexistentType non viene rimossa dalla cache dei tipi. Valore booleano: true, false. false
Controlla il flusso del percorso di scrittura in modo che i dati vengano caricati direttamente in Cloud Storage man mano che vengono scritti anziché eseguirne completamente lo staging in locale e caricarli al momento di close() o fsync(). Per maggiori informazioni sulle scritture in streaming, consulta la documentazione di GitHub di Cloud Storage FUSE. Valore booleano: true, false. true

Specifica la dimensione massima in MiB che la cache dei file può utilizzare e ti consente di limitare la capacità totale che la cache dei file può utilizzare all'interno della directory montata.
  • Numero intero
  • -1: specifica l'utilizzo dell'intera capacità disponibile della cache nella directory specificata per cache-dir. Questa è l'impostazione predefinita solo se viene passato cache-dir.
  • 0: disattiva la cache dei file.
 -1
Determina se l'intero oggetto deve essere scaricato in modo asincrono e archiviato nella directory della cache FUSE di Cloud Storage al termine della prima lettura da un offset diverso da zero. Questa opzione deve essere impostata su true se prevedi di eseguire diverse letture casuali o letture parziali. Valore booleano: true, false. false
Specifica le dimensioni di ogni richiesta di lettura in MiB che ogni goroutine effettua a Cloud Storage durante il download dell'oggetto nella cache dei file. Numero intero 200

Accelera le letture di file di grandi dimensioni utilizzando la directory della cache dei file come buffer di precaricamento utilizzando più worker per scaricare più parti di un file in parallelo.

I download paralleli vengono attivati automaticamente quando attivi la memorizzazione nella cache dei file. Per saperne di più sulla memorizzazione nella cache dei file, consulta Utilizzare la memorizzazione nella cache dei file di Cloud Storage FUSE.

Per saperne di più sui download paralleli e su come configurare le proprietà di supporto, Download paralleli.

 Valore booleano: true, false. true
Il numero massimo di goroutine che possono essere generate in un dato momento in tutti i job di download dei file.
  • Numero intero
  • -1: specifica download paralleli illimitati.
  • 0: disattiva i download paralleli. Può essere utilizzato solo se --enable-parallel-downloads non viene passato o viene passato come false.
  • 0: non specifica un limite superiore. Cloud Storage FUSE limita internamente il valore in base al numero massimo di goroutine che possono essere generate specificato dalla configurazione della macchina.
 Il doppio del numero di core CPU sulla tua macchina o 16, a seconda di quale valore è maggiore.
Il numero di richieste di download simultanee per file. Numero intero 16
Specifica i bit di autorizzazione per i file, in formato ottale. Numero intero compreso tra 000 e 777 (inclusi). 644
Esegue il comando gcsfuse in primo piano. Valore booleano: true, false. false
Specifica il proprietario dell'identificatore di gruppo (GID) di tutti gli inode.
  • Numero intero che rappresenta un ID gruppo.
  • -1: viene utilizzato il GID del chiamante.
 -1
Visualizza la guida su Cloud Storage FUSE. Nessuno Nessuno
Mostra la versione di Cloud Storage FUSE che hai installato. Nessuno Nessuno
Specifica per quanto tempo il client HTTP FUSE di Cloud Storage può attendere una risposta dal server prima del timeout. Durata, ad esempio: 1h10m10s per 1 ora, 10 minuti e 10 secondi. 0s specifica nessun timeout. 0s
Indica a Cloud Storage FUSE di ignorare i segnali di interruzione del sistema, come SIGINT attivato da Control+C. In questo modo, i segnali non interrompono le operazioni in volo. Valore booleano: true, false. true
Include implicitamente cartelle e cartelle gestite. Per maggiori informazioni, consulta la documentazione su file e directory in GitHub. Valore booleano: true, false. false
Attiva la cache degli elenchi e definisce la durata (TTL) in secondi delle voci degli elenchi memorizzate nella cache. La cache dell'elenco viene mantenuta in memoria nella cache della pagina, che è controllata dal kernel in base alla memoria disponibile.
  • Numero intero che rappresenta i secondi, ad esempio: 10 (10 secondi).
  • 0: disabilita la memorizzazione nella cache degli elenchi.
  • -1: ignora la scadenza della voce e restituisce sempre la risposta dell'elenco dalla cache quando è disponibile.
 0
Specifica un percorso assoluto al file della chiave JSON delle credenziali per autenticare le richieste a Cloud Storage. Per impostazione predefinita, Cloud Storage FUSE utilizza le Credenziali predefinite dell'applicazione per autenticare le richieste. Un percorso, ad esempio: /home/example_user/gcloud-key.json. Se questa opzione non è impostata, vengono utilizzate le Credenziali predefinite dell'applicazione.
Specifica il limite di larghezza di banda a cui Cloud Storage FUSE può leggere i dati da Cloud Storage, misurato in un intervallo di 30 secondi. Numero in virgola mobile. -1 non specifica alcun limite. -1
Specifica un limite per le operazioni eseguite al secondo, misurato in un intervallo di 30 secondi. Numero in virgola mobile. -1 non specifica alcun limite. -1
Specifica il file per l'archiviazione dei log che possono essere analizzati da Fluentd. Un percorso, ad esempio: /tmp/user-example-bucket-gcsfuse-logs.txt. stdout quando Cloud Storage FUSE viene eseguito in primo piano o syslog quando Cloud Storage FUSE viene eseguito in background
Specifica il formato del file di log.
  • text
  • json
 json
Il numero massimo di file di log ruotati da conservare, escluso il file attivo in cui vengono scritti i log.
  • Numero intero
  • 0: conserva tutti i file di log ruotati
 10
Specifica se i file di log ruotati vengono compressi utilizzando gzip. Valore booleano: true, false. true
La dimensione massima in megabyte (MB) che i file di log possono raggiungere prima di essere ruotati. Numero intero. Il valore minimo è 1. 512

Il livello di gravità per cui vuoi che Cloud Storage FUSE generi log. I livelli di gravità sono ordinati dal più basso al più alto. Ad esempio, quando specifichi warning, Cloud Storage FUSE genera log per avvisi ed errori. In genere, consigliamo di utilizzare il livello di gravità info.
  • trace
  • debug
  • info
  • warning
  • error
  • off: disattiva tutti i log.
 info
Specifica il numero massimo di connessioni TCP consentite per server. Questa impostazione diventa effettiva quando --client-protocol è impostato su http1. Numero intero compreso tra 0 e 2147483647. 0 non specifica alcun limite per le connessioni TCP. 0
Specifica il numero massimo di connessioni inattive consentite per server. Questa impostazione diventa effettiva quando --client-protocol è impostato su http1. Numero intero compreso tra 0 e 2147483647. 0 non specifica alcun limite per le connessioni inattive. 0
Specifica la durata massima in cui Cloud Storage FUSE può rimanere inattivo in un ciclo di tentativi con exponential backoff. Una volta che la durata del backoff supera la durata massima specificata, il tentativo continua con la durata massima specificata. Durata, ad esempio: 1h5m50s (1 ora, 5 minuti e 50 secondi) o 60s (60 secondi). 30s

Definisce la durata (TTL) in secondi delle voci della cache delle statistiche negative, che memorizzano i risultati per i file inesistenti nella cache.
  • Numero intero che rappresenta i secondi, ad esempio: 10 (10 secondi).
  • 0: disattiva la memorizzazione nella cache delle statistiche negative.
  • -1: Consente la memorizzazione nella cache illimitata delle statistiche negative e disattiva la scadenza del TTL.
 5
Definisce la durata (TTL) in secondi delle voci dei metadati memorizzate nella cache.
  • Numero intero che rappresenta i secondi, ad esempio: 30 (30 secondi).
  • -1: ignora la scadenza del TTL e pubblica i file dalla cache ogni volta che sono disponibili.
  • 0: utilizza il file più aggiornato. L'utilizzo di questo valore genera una chiamata ai metadati Get per assicurarsi che la generazione dell'oggetto per il file nella cache corrisponda a ciò che è archiviato in Cloud Storage. Per saperne di più, consulta Configurare l'invalidazione della cache.
 60
Specifica opzioni di montaggio aggiuntive specifiche del sistema. La maggior parte delle opzioni di montaggio generiche in FUSE, ad esempio suid, sono supportate da Cloud Storage FUSE e possono essere trasmesse con l'opzione -o. Opzioni di montaggio in FUSE, ad esempio:
  • rw: montaggio in modalità di lettura/scrittura.
  • ro: monta come sola lettura.
 ""
Monta solo una directory specifica all'interno di un bucket. Un percorso, ad esempio: /etc/gcsfuse.yaml. ""

Espone l'endpoint delle metriche di Prometheus sulla porta specificata e sul percorso /metrics.

 Numero intero che rappresenta la porta che vuoi specificare. 0
Consente di rinominare le directory che contengono un numero di elementi secondari inferiore al limite specificato. Numero intero compreso tra 0 e 2147483647. 0
Specifica il moltiplicatore per il backoff esponenziale tra tentativi consecutivi. Numero in virgola mobile. 2
Specifica se riutilizzare il token acquisito da --token-url. Valore booleano: true, false. true
Specifica le dimensioni del blocco di dati da scaricare da Cloud Storage, in megabyte (MB). Numero intero compreso tra 1 e 1024. 200
Specifica il numero di voci che la cache delle statistiche può contenere. Questa opzione è stata sostituita dall'opzione --stat-cache-max-size-mb. Numero intero 4096
La memoria massima che la cache delle statistiche può utilizzare, in MiB. La cache delle statistiche viene sempre mantenuta interamente in memoria.
  • Numero intero. Ti consigliamo quanto segue:
    • 32 se il tuo carico di lavoro prevede fino a 20.000 file.
    • Se il carico di lavoro è superiore a 20.000 file, aumenta le dimensioni di 10 per ogni 6000 file aggiuntivi, dove la cache delle statistiche utilizza una media di 1500 MiB per file.
  • -1: non imposta alcun limite, in modo che la cache delle statistiche utilizzi tutta la memoria necessaria.
  • 0: disattiva la cache delle statistiche.
 32
Specifica per quanto tempo memorizzare nella cache i risultati StatObject e gli attributi inode. Questa opzione è stata sostituita dall'opzione --metadata-cache-ttl-secs. Durata, ad esempio: 20s (20 secondi). 60s
Specifica un percorso della directory temporanea in cui vengono preparate le scritture prima di essere caricate in Cloud Storage. Un percorso, ad esempio: /mnt/ssd/example-user-gcsfuse-temp-dir. /tmp
Specifica un URL per ottenere un token di accesso quando --key-file è assente. Un URL. ""
Specifica per quanto tempo memorizzare nella cache la mappatura tra nomi e file o directory negli inode della directory, in secondi. Questa opzione è stata sostituita dall'opzione --metadata-cache-ttl-secs. Durata in secondi, ad esempio: 20s (20 secondi). 60s
La dimensione massima in MiB per directory che la cache dei tipi può utilizzare. La cache dei tipi viene sempre mantenuta interamente in memoria.
  • Numero intero. Ti consigliamo di procedere come segue:
    • 4 se il numero massimo di file all'interno di una singola directory del bucket che stai montando contiene 20.000 file o meno.
    • Se il numero massimo di file all'interno di una singola directory che stai montando contiene più di 20.000 file, aumenta il valore di 1 per ogni 5000 file, ovvero una media di circa 200 byte per file.
  • -1: specifica nessun limite e consente alla cache dei tipi di utilizzare tutta la memoria necessaria.
  • 0: disattiva la cache dei tipi.
 4
Specifica il proprietario dell'identificatore utente (UID) di tutti gli inode.
  • Numero intero che rappresenta un UID.
  • -1: viene utilizzato l'UID del chiamante.
 -1

Specifica il numero massimo di blocchi di dati disponibili per le scritture di streaming in tutti i file. Per impostazione predefinita, ogni file utilizza un blocco di dati di 32 MiB.
  • Numero intero
  • 0: disattiva le scritture di streaming.
  • -1: imposta il valore su un numero illimitato di segmenti.
  • Valore predefinito per le macchine con specifiche basse e risorse limitate: 4
  • Valore predefinito per le macchine con specifiche elevate e una grande quantità di risorse: 1600

Torna all'inizio