Interfaccia a riga di comando gcsfuse

Questa pagina descrive le opzioni a riga di comando gcsfuse utilizzate per interagire con Cloud Storage FUSE.

Synopsis

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

Opzioni globali Descrizione
--anonymous-access BOOLEAN Disattiva l'autenticazione per le richieste. Questo flag deve essere impostato se utilizzi un endpoint personalizzato che non supporta l'autenticazione. Questo flag deve essere impostato anche se utilizzi Cloud Storage FUSE con bucket pubblici. Il valore predefinito è false.
--app-name VALUE Il nome dell'applicazione del montaggio.
--billing-project VALUE Specifica un progetto da utilizzare per la fatturazione quando si accede al bucket montato. Questo flag è spesso obbligatorio quando si monta un bucket abilitato con Pagamenti a carico del richiedente. Il progetto predefinito è nessuno.
--cache-dir VALUE Specifica la directory per l'archiviazione dei dati della cache dei file.

Nota: per abilitare la memorizzazione nella cache dei file, devi specificare una directory utilizzando --cache-dir e utilizzare il flag --file-cache-max-size-mb per specificare un numero intero positivo che indichi un limite specifico della dimensione massima della cache dei file in mebibyte (MiB) oppure utilizzare un valore -1 per specificare nessun limite.
--client-protocol VALUE Specifica il protocollo utilizzato per la comunicazione con il backend Cloud Storage. Il valore deve essere http1 per HTTP/1.1 o http2 per HTTP/2. Il valore predefinito è http1.
--config-file VALUE Specifica il percorso del file di configurazione che vuoi utilizzare per configurare i comportamenti di Cloud Storage FUSE. Ad esempio: --config-file /etc/gcsfuse.yaml
--custom-endpoint VALUE 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 di 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 eseguire il bypass dell'autenticazione.
--debug_fuse BOOLEAN 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.
--debug_gcs BOOLEAN 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.
--debug_invariants BOOLEAN Esce dal programma quando vengono rilevate violazioni di invarianti interne. Il valore predefinito è false.
--debug_mutex BOOLEAN Stampa messaggi di debug quando un mutex viene trattenuto per troppo tempo. 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. Il valore predefinito è false.
--dir-mode VALUE Bit di autorizzazione per le directory, in octal. Il valore minimo è 000 e il valore massimo è 777. Il valore predefinito è 755.
--enable-nonexistent-type-cache BOOLEAN Crea una voce della cache dei tipi 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. Il valore predefinito è false.
--file-cache-cache-file-for-range-read BOOLEAN

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. Questo flag deve essere impostato su true se prevedi di eseguire più letture casuali o letture parziali. Se questo campo non è specificato, il valore predefinito è false.

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

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. Il valore predefinito è 50.
--file-cache-enable-parallel-downloads BOOLEAN

Accelera le letture di file di grandi dimensioni utilizzando la directory della cache dei file come buffer di prefetch con più worker per scaricare file di grandi dimensioni in parallelo. Il valore predefinito è false.


Per utilizzare i download paralleli, devi attivare la memorizzazione nella cache dei file. Per scoprire di più sui download paralleli e configurare le relative proprietà di supporto, consulta Migliorare il rendimento della lettura utilizzando i download paralleli.
--file-cache-max-parallel-downloads VALUE

Il numero massimo di goroutine che possono essere generate in un determinato momento in tutti i job di download dei file. Il valore predefinito è il doppio del numero di core della CPU della macchina o 16, a seconda del valore più alto. Per specificare nessun limite, inserisci un valore di -1.
--file-mode VALUE Specifica i bit di autorizzazione per i file in octal. Il valore minimo è 000 e il valore massimo è 777. Il valore predefinito è 644.
--foreground BOOLEAN Esegue il comando gcsfuse in primo piano. Il valore predefinito è false.
--gid VALUE Specifica il proprietario dell'identificatore di gruppo (GID) di tutti gli inode. Il valore deve essere un numero intero. Il valore predefinito è -1.
--help o -h Mostra la guida di Cloud Storage FUSE.
version o -v Mostra la versione di Cloud Storage FUSE che hai installato.
--http-client-timeout VALUE Specifica per quanto tempo il client HTTP FUSE di Cloud Storage può attendere una risposta dal server prima del timeout. Il valore deve essere una durata. Ad esempio, 1h10m10s. Il valore predefinito è 0s, che indica che non è impostato alcun timeout.
--ignore-interrupts VALUE Indica a Cloud Storage FUSE di ignorare gli indicatori di interruzione di sistema, come SIGINT attivato da Control+C. In questo modo, i segnali non interromperanno le operazioni in corso. I valori sono true o false. Il valore predefinito è true.
--implicit-dirs BOOLEAN

Include implicitamente cartelle e cartelle gestite.

Per ulteriori informazioni, consulta la documentazione relativa a file e directory su GitHub. Il valore predefinito è false.
--kernel-list-cache-ttl-secs VALUE 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. Il valore predefinito è 0, che disattiva la memorizzazione nella cache dell'elenco.

Per impostare il flag --kernel-list-cache-ttl-secs, specifica un valore intero positivo in secondi per mantenere la risposta dell'elenco di directory nella cache della pagina del kernel. Per ignorare la scadenza della voce e restituire sempre la risposta dell'elenco dalla cache quando è disponibile, specifica un valore di -1.
--key-file VALUE 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.
--limit-bytes-per-sec VALUE 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. Il valore deve essere un numero a virgola mobile. Il valore predefinito è -1, che non specifica alcun limite.
--limit-ops-per-sec VALUE Specifica un limite per le operazioni eseguite al secondo, misurato su un intervallo di 30 secondi. Il valore deve essere un numero con virgola mobile. Il valore predefinito è -1, che non specifica alcun limite.
--log-file VALUE Specifica il file per l'archiviazione dei log che possono essere analizzati da Fluentd. Se non viene fornito, i log in testo normale vengono stampati su stdout quando Cloud Storage FUSE viene eseguito in primo piano o su syslog quando viene eseguito in background.
--log-format VALUE Specifica il formato del file di log. Il valore deve essere text o json. Il valore predefinito è json.
--log-rotate-backup-file-count VALUE Il numero massimo di file di log sottoposti a rotazione da conservare, escluso il file attivo in cui vengono scritti i log. Quando il valore è impostato su 0, tutti i file di log ruotati vengono conservati. Se questo campo non è specificato, il valore predefinito è 10.
--log-rotate-compress BOOLEAN Un valore booleano che specifica se i file di log ruotati vengono compressi utilizzando gzip. Se questo flag non è specificato, il valore predefinito è true.
--log-rotate-max-file-size-mb VALUE La dimensione massima in megabyte (MB) che i file di log possono raggiungere prima di essere girati. Il valore minimo è 1. Se questo campo non è specificato, il valore predefinito è 512.
--log-severity ENUM

La gravità dei log che vuoi che Cloud Storage FUSE generi, espressa come enumerazione. I livelli di gravità sono ordinati dalla gravità più bassa alla gravità più alta:

  • trace
  • debug
  • info
  • warning
  • error

Quando specifichi un livello di gravità, Cloud Storage FUSE genera log con gravità uguale o superiore. Ad esempio, quando specifichi warning, Cloud Storage FUSE genera log per avvisi ed errori. In genere, consigliamo di utilizzare il livello di gravità info. Puoi anche specificare off per disattivare tutto il logging. Se specifichi --debug_mutex come parte del comando, il livello di gravità viene impostato automaticamente su trace e sostituisce log-severity.

Se questo campo non è specificato, il valore predefinito è info.

Nota: l'utilizzo dei livelli di gravità trace o debug quando la memorizzazione nella cache dei file è attivata può comportare un calo delle prestazioni a causa del sovraccarico di log e deve essere utilizzato solo temporaneamente, ad esempio durante la risoluzione dei problemi.
--max-conns-per-host VALUE Specifica il numero massimo di connessioni TCP consentite per server. Questa impostazione diventa effettiva quando --client-protocol è impostato su http1. Il valore deve essere compreso tra 0 e 2147483647. Il valore predefinito è 0, che specifica che non esiste un limite per le connessioni TCP, ad eccezione delle limitazioni impostate dalle specifiche della macchina.
--max-idle-conns-per-host VALUE Specifica il numero massimo di connessioni inattive consentite per server. Il valore deve essere compreso tra 0 e 2147483647. Il valore predefinito è 100.
--max-retry-sleep VALUE Specifica la durata massima in cui Cloud Storage FUSE può rimanere inattivo in un loop di ripetizione con backoff esponenziale. Il valore deve essere un valore di durata temporale. Ad esempio, 1h5m50s (1 ora, 5 minuti e 50 secondi) o 60s (60 secondi). Una volta che la durata del tempo di attesa supera la durata massima specificata, il nuovo tentativo continua con la durata massima specificata. Il valore predefinito è 30s.
--metadata-cache-ttl-secs VALUE

Definisce la durata (TTL) in secondi delle voci dei metadati memorizzati nella cache.

  • Per ignorare la scadenza del TTL e pubblicare il file dalla cache ogni volta che è disponibile, specifica un valore -1.
  • Per utilizzare il file più aggiornato, specifica un valore 0. 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 la pagina sulla configurazione dell'invalidazione della cache.

Se questo campo non è specificato, il valore predefinito è 60 (60 secondi).
-o VALUE

Specifica opzioni di montaggio aggiuntive specifiche per il sistema.

La maggior parte delle opzioni di montaggio generiche in FUSE, come suid, è supportata da Cloud Storage FUSE e può essere passata con il flag -o.

Di seguito sono riportate alcune opzioni di montaggio di uso comune disponibili con il flag -o:

  • rw: monta come lettura/scrittura.
  • ro: monta come di sola lettura.

Per ulteriori informazioni sulle altre opzioni di montaggio supportate, consulta la documentazione di Linux FUSE.
--only-dir VALUE Monta solo una directory specifica all'interno di un bucket.
--rename-dir-limit VALUE Consente la ridenominazione delle directory contenenti meno elementi secondari rispetto al limite specificato. Il valore deve essere compreso tra 0 e 2147483647. Il valore limite predefinito è 0.
--retry-multiplier VALUE Specifica il moltiplicatore per il backoff esponenziale tra i tentativi consecutivi. Il valore deve essere un numero con virgola mobile. Il valore predefinito è 2.
--reuse-token-from-url Specifica se riutilizzare il token acquisito da --token-url. Il valore predefinito è true.
--sequential-read-size-mb VALUE Specifica la dimensione del chunk dei dati da scaricare da Cloud Storage, in megabyte (MB). Il valore deve essere compreso tra 1 e 1024. Il valore predefinito è 200.
--stackdriver-export-interval VALUE Esporta le metriche in Stackdriver con l'intervallo specificato. Il valore deve essere una durata. Ad esempio, 1h10m10s. Il valore predefinito è 0s, che specifica nessuna esportazione.
--stat-cache-capacity VALUE Deprecato. Specifica il numero di voci che la cache delle statistiche può contenere. Ciò influisce sul consumo di memoria. Il valore deve essere un numero intero. Il valore predefinito è 4096.

Questo flag è stato sostituito da --stat-cache-max-size-mb. Per specificare le dimensioni massime in mebibyte (MiB) che la cache delle statistiche può utilizzare, utilizza il flag --stat-cache-max-size-mb.
--stat-cache-max-size-mb VALUE

La dimensione massima in mebibyte (MiB) che la cache delle statistiche può utilizzare. La cache delle statistiche viene sempre conservata interamente in memoria.

  • Specifica un valore 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.
  • Per consentire alla cache delle statistiche di utilizzare tutta la memoria necessaria, ovvero per non impostare alcun limite, specifica un valore -1.
  • Per disattivare la cache delle statistiche, specifica un valore pari a 0.

Se questo campo non è specificato, il valore predefinito è 32.
--stat-cache-ttl VALUE Deprecato. Specifica per quanto tempo memorizzare nella cache i risultati e gli attributi inode di StatObject. Il valore predefinito è 60s (60 secondi).

Questo flag è stato sostituito da --metadata-cache-ttl-secs. Per specificare la durata (TTL) in secondi per le voci dei metadati memorizzati nella cache, utilizza il flag --metadata-cache-ttl-secs.
--temp-dir VALUE Specifica un percorso alla directory temporanea in cui vengono messe in scena le scritture prima di essere caricate su Cloud Storage. Il valore predefinito è quello predefinito del sistema, molto probabilmente /tmp.
--token-url VALUE Specifica un URL per ottenere un token di accesso quando --key-file non è presente.
--type-cache-ttl VALUE Deprecato. Specifica per quanto tempo memorizzare nella cache la mappatura tra nomi e file o directory negli inode di directory. Questa opzione è stata sostituita dall'opzione --metadata-cache-ttl-secs. Per specificare il periodo di tempo da impostare per la cache di tipo, utilizza l'opzione --metadata-cache-ttl-secs, che specifica il durata (TTL) delle voci dei metadati sia delle cache di tipo sia delle cache di stato. Il valore predefinito per --metadata-cache-ttl-secs è 60s (60 secondi).
--type-cache-max-size-mb VALUE

La dimensione massima in MiB per directory che la cache dei tipi può utilizzare. La cache dei tipi viene sempre mantenuta interamente in memoria.

  • Specifica un valore 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.
  • Per consentire alla cache dei tipi di utilizzare tutta la memoria necessaria, in altre parole per non specificare alcun limite, specifica un valore -1.
  • Per disattivare la cache dei tipi, specifica un valore di 0.

Se questo campo non è specificato, il valore predefinito è 4.
--uid VALUE Specifica il proprietario dell'identificatore utente (UID) di tutti gli inode. Il valore deve essere un numero intero. Il valore UID predefinito è -1.