Interfaccia a riga di comando gcsfuse

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

Trama

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Dove:

  • GLOBAL_OPTIONS sono le opzioni che controllano il modo in cui viene configurato il montaggio e il comportamento di Cloud Storage FUSE.

  • BUCKET_NAME è il nome del bucket da montare. Ad esempio, my-mount-bucket. Facoltativo. Escludi il nome di un 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.

Descrizione

L'interfaccia a riga di comando gcsfuse viene utilizzata per montare i bucket Cloud Storage come file system su una macchina locale.

Opzioni globali

Opzione Descrizione Valore valido Valore predefinito
--anonymous-access Disattiva 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
--app-name Il nome dell'applicazione del montaggio. Valore stringa, ad esempio: my-bucket-mount. ""
--billing-project Specifica un progetto da utilizzare per la fatturazione quando si accede al bucket montato. Questa opzione è spesso obbligatoria quando si monta un bucket abilitato con pagamenti a carico del richiedente. Valore di stringa che rappresenta un ID progetto. ""
--cache-dir

Specifica la directory per l'archiviazione dei dati della cache dei file.

Per scoprire come attivare la memorizzazione nella cache dei file, consulta Utilizzare la memorizzazione nella cache dei file.

 Un percorso, ad esempio: /tmp/gcsfuse-cache-path. ""
--client-protocol Specifica il protocollo utilizzato per la comunicazione con il backend Cloud Storage.
  • http1 per HTTP/1.1
  • http2 per HTTP/2
  • grpc per gRPC
 http1
--config-file 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. ""
--custom-endpoint Specifica un endpoint personalizzato alternativo per il recupero dei dati. L'endpoint personalizzato deve supportare le risorse e le operazioni equivalenti dell'endpoint JSON di Cloud Storage,https://storage.googleapis.com/storage/v1. Se non viene specificato un endpoint personalizzato, Cloud Storage FUSE utilizza l'endpoint globale dell'API JSON Cloud Storage,https://storage.googleapis.com/storage/v1. Se l'autenticazione non è supportata nell'endpoint personalizzato specificato, imposta il flag --anonymous-access su true per ignorare l'autenticazione. Un endpoint, ad esempio: http://localhost:443/storage/v1. ""
--debug_fuse (deprecato) 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 i log di traccia, debug, informazioni, avviso ed errore. Valore booleano: true, false. false
--debug_gcs (deprecato) Stampa la richiesta di Cloud Storage e le informazioni sui tempi. Questa opzione è stata sostituita dall'opzione --log-severity. Per attivare l'output di debug, imposta l'opzione --log-severity su trace, che include i log di traccia, debug, informazioni, avviso ed errore. Valore booleano: true, false. false
--debug_invariants Esce dal programma quando vengono rilevate violazioni di invarianti interne. Valore booleano: true, false. false
--debug_mutex Stampa messaggi di debug quando un mutex viene trattenuto per troppo tempo. Se viene specificata questa opzione, 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
--dir-mode Bit di autorizzazione per le directory, in octal. Numero intero compreso tra 000 e 777 (inclusi). 755
--enable-nonexistent-type-cache Crea una voce della cache del tipo con il tipo NonexistentType se un file non viene trovato in Cloud Storage. Se il file viene creato in Cloud Storage, ma la voce NonexistentType per il file è memorizzata nella cache, Cloud Storage FUSE non può richiederlo finché la voce NonexistentType non viene rimossa dalla cache dei tipi. Valore booleano: true, false. false
--file-cache-cache-file-for-range-read Determina se l'oggetto completo deve essere scaricato in modo asincrono e archiviato nella directory della cache FUSE di Cloud Storage quando viene completata la prima lettura da un offset diverso da zero. Questa opzione deve essere impostata su true se prevedi di eseguire più letture casuali o letture parziali.

Nota: se esegui una lettura parziale a partire dall'offset0, Cloud Storage FUSE scarica e memorizza nella cache in modo asincrono l'oggetto completo.

 Valore booleano: true, false. false
--file-cache-download-chunk-size-mb Specifica le dimensioni in MiB di ogni richiesta di lettura inviata da ogni goroutine a Cloud Storage durante il download dell'oggetto nella cache dei file. Numero intero 50
--file-cache-enable-parallel-downloads

Accelera le letture di file di grandi dimensioni utilizzando la directory della cache dei file come buffer di prefetch utilizzando più worker per scaricare file di grandi dimensioni in parallelo. Per scoprire di più sui download paralleli e configurare le relative proprietà di supporto, consulta Migliorare il rendimento della lettura utilizzando i download paralleli.

Per utilizzare i download in parallelo, devi prima abilitare la memorizzazione nella cache dei file.

 Valore booleano: true, false. false
--file-cache-max-parallel-downloads Il numero massimo di goroutine che possono essere generate in un determinato 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 della CPU della tua macchina o 16, a seconda del valore più alto.
--file-mode Specifica i bit di autorizzazione per i file in octal. Numero intero compreso tra 000 e 777 (inclusi). 644
--foreground Esegue il comando gcsfuse in primo piano. Valore booleano: true, false. false
--gid Specifica il proprietario dell'identificatore di gruppo (GID) di tutti gli inode.
  • Numero intero che rappresenta un GID.
  • -1: viene utilizzato il GID del chiamante.
 -1
--help Mostra la guida di Cloud Storage FUSE. Nessuno Nessuno
--version Mostra la versione di Cloud Storage FUSE che hai installato. Nessuno Nessuno
--http-client-timeout 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 non specifica alcun timeout. 0s
--ignore-interrupts Indica a Cloud Storage FUSE di ignorare gli indicatori di interruzione di sistema, come SIGINT attivato da Control+C. In questo modo, gli indicatori non interromperanno le operazioni in corso. Valore booleano: true, false. true
--implicit-dirs Include implicitamente cartelle e cartelle gestite. Per maggiori informazioni, consulta la documentazione relativa a file e directory su GitHub. Valore booleano: true, false. false
--kernel-list-cache-ttl-secs Attiva la cache dell'elenco e definisce la durata (TTL) in secondi delle voci dell'elenco memorizzate nella cache. La cache dell'elenco viene mantenuta in memoria nella cache della pagina, che viene controllata dal kernel in base alla memoria disponibile.
  • Numero intero che rappresenta i secondi, ad esempio: 10 (10 secondi).
  • 0: disattiva la memorizzazione nella cache dell'elenco.
  • -1: ignora la scadenza della voce e restituisce sempre la risposta dell'elenco dalla cache quando è disponibile.
 0
--key-file 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.
--limit-bytes-per-sec 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 con virgola mobile. -1 non specifica alcun limite. -1
--limit-ops-per-sec Specifica un limite per le operazioni eseguite al secondo, misurato su un intervallo di 30 secondi. Numero con virgola mobile. -1 non specifica alcun limite. -1
--log-file 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
--log-format Specifica il formato del file di log.
  • text
  • json
 json
--log-rotate-backup-file-count Il numero massimo di file di log sottoposti a rotazione da conservare, escluso il file attivo su cui vengono scritti i log.
  • Numero intero
  • 0: vengono conservati tutti i file di log ruotati
 10
--log-rotate-compress Specifica se i file log ruotati vengono compressi utilizzando gzip. Valore booleano: true, false. true
--log-rotate-max-file-size-mb La dimensione massima in megabyte (MB) che i file di log possono raggiungere prima di essere girati. Numero intero. Il valore minimo è 1. 512
--log-severity

Il livello di gravità per cui vuoi che Cloud Storage FUSE generi log. I livelli di gravità sono ordinati dalla gravità più bassa alla gravità più alta. 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 tutto il logging.
 info
--max-conns-per-host Specifica il numero massimo di connessioni TCP consentite per server. Questa impostazione entra in vigore quando --client-protocol è impostato su http1. Numero intero compreso tra 0 e 2147483647. 0 non specifica alcun limite per le connessioni TCP. 0
--max-idle-conns-per-host Specifica il numero massimo di connessioni inattive consentite per server. Questa impostazione entra in vigore quando --client-protocol è impostato su http1. Numero intero compreso tra 0 e 2147483647. 0 non specifica alcun limite per le connessioni inattive. 0
--max-retry-sleep Specifica la durata massima in cui Cloud Storage FUSE può rimanere inattivo in un loop di ripetizione con backoff esponenziale. Una volta che la durata del backoff supera la durata massima specificata, il nuovo tentativo continua con la durata massima specificata. Durata, ad esempio: 1h5m50s (1 ora, 5 minuti e 50 secondi) o 60s (60 secondi). 30s
--metadata-cache-negative-ttl-secs

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 delle statistiche negative illimitata e disattiva la scadenza del TTL.
 5
--metadata-cache-ttl-secs Definisce la durata (TTL) in secondi delle voci dei metadati memorizzati 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 comporta una chiamata ai metadati Get per assicurarsi che la generazione di oggetti per il file nella cache corrisponda a quanto archiviato in Cloud Storage. Per scoprire di più, consulta Configurare l'invalidazione della cache.
 60
-o Specifica opzioni di montaggio aggiuntive specifiche del sistema. La maggior parte delle opzioni di montaggio generiche in FUSE, come suid, è supportata da Cloud Storage FUSE e può essere passata insieme all'opzione -o. Opzioni di montaggio in FUSE, ad esempio:
  • rw: monta come lettura/scrittura.
  • ro: monta come di sola lettura.
 ""
--only-dir Monta solo una directory specifica all'interno di un bucket. Un percorso, ad esempio: /etc/gcsfuse.yaml. ""
--rename-dir-limit Consente la ridenominazione di directory contenenti meno elementi secondari rispetto al limite specificato. Numero intero compreso tra 0 e 2147483647. 0
--retry-multiplier Specifica il moltiplicatore per il backoff esponenziale tra i tentativi consecutivi. Numero con rappresentazione in virgola mobile. 2
--reuse-token-from-url Specifica se riutilizzare il token acquisito da --token-url. Valore booleano: true, false. true
--sequential-read-size-mb Specifica la dimensione del chunk dei dati da scaricare da Cloud Storage, in megabyte (MB). Numero intero compreso tra 1 e 1024. 200
--stackdriver-export-interval Esporta le metriche in Stackdriver con l'intervallo specificato. Durata, ad esempio: 1h5m50s (1 ora, 5 minuti e 50 secondi). 0s specifica nessuna esportazione. 0s
--stat-cache-capacity (deprecato) 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
--stat-cache-max-size-mb La dimensione massima della memoria che la cache delle statistiche può utilizzare, in MiB. La cache delle statistiche viene sempre conservata interamente in memoria.
  • Numero intero. Ti consigliamo quanto segue:
    • 32 se il tuo carico di lavoro prevede fino a 20.000 file.
    • Se il tuo carico di lavoro è costituito da più di 20.000 file, aumenta le dimensioni di 10 per ogni 6000 file aggiuntivi, poiché la cache delle statistiche utilizza in media 1500 MiB per file.
  • -1: non imposta alcun limite, la cache delle statistiche utilizza quanta memoria necessaria.
  • 0: disattiva la cache delle statistiche.
 32
--stat-cache-ttl (deprecato) 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
--temp-dir Specifica un percorso alla directory temporanea in cui vengono messe in scena le scritture prima di essere caricate su Cloud Storage. Un percorso, ad esempio: /mnt/ssd/example-user-gcsfuse-temp-dir. /tmp
--token-url Specifica un URL per ottenere un token di accesso quando --key-file non è presente. Un URL. ""
--type-cache-ttl (deprecated) Specifica il tempo per cui memorizzare nella cache la mappatura tra nomi e file o directory negli inode di directory, in secondi. Questa opzione è stata sostituita dall'opzione --metadata-cache-ttl-secs. Durata in secondi, ad esempio: 20s (20 secondi). 60s
--type-cache-max-size-mb 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 quanto segue:
    • 4 se il numero massimo di file all'interno di un'unica directory del bucket che stai montando contiene al massimo 20.000 file.
    • 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 in media circa 200 byte per file.
  • -1: non specifica alcun limite e consente alla cache dei tipi di utilizzare tutta la memoria necessaria.
  • 0: disattiva la cache dei tipi.
 4
--uid 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