interfaccia a riga di comando gcsfuse

In questa pagina vengono descritte le opzioni della 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 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.

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
--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 installi un bucket abilitato con Pagamenti a carico del richiedente. Il progetto predefinito è nessuno.
--client-protocol VALUE Specifica il protocollo utilizzato per comunicare con il backend Cloud Storage. Il valore può 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. Deve essere utilizzato solo per i test. 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 API JSON di Cloud Storage, https://storage.googleapis.com/storage/v1. Se è specificato un endpoint personalizzato, l'autenticazione viene disattivata per l'endpoint.
--debug_fuse_errors Se escluso, restituisce False e impedisce agli errori di FUSE di essere registrati nella console (se si utilizza --foreground ) o nel file di log (se si utilizza --log-file).
--debug_fuse Abilita l'output di debug relativo a FUSE. Se questa opzione è specificata, il livello di gravità dei log viene impostato automaticamente su trace, che include log di traccia, log di debug, log di informazioni, log degli avvisi e log degli errori.
--debug_gcs Stampa le informazioni sulla richiesta e sulle tempistiche di Cloud Storage. Se questa opzione viene specificata, il livello di gravità dei log viene impostato automaticamente su trace, che include log di traccia, log di debug, log di informazioni, log degli avvisi e log degli errori.
--debug-invariants Fatti prendere dal panico in caso di violazione degli invarianti interni.
--debug_mutex Stampa i 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 log di traccia, log di debug, log di informazioni, log degli avvisi e log degli errori.
--dir-mode VALUE Bit delle autorizzazioni per le directory, in ottale. Il valore predefinito è 755.
--enable-nonexistent-type-cache Crea una voce di tipo cache di tipo NonexistentType se un file non viene trovato in Cloud Storage. Se il file viene creato in Cloud Storage, ma la voce NonexistentType relativa al file è memorizzata nella cache, Cloud Storage FUSE non può richiedere il file finché la voce NonexistentType non viene rimossa dalla cache dei tipi.
--experimental-enable-json-read Specifica Cloud Storage FUSE per utilizzare l'API JSON Cloud Storage per le operazioni di lettura. Per impostazione predefinita, le operazioni di lettura vengono eseguite utilizzando l'API XML di Cloud Storage.
--experimental-opentelemetry-collector-address VALUE Esporta le metriche nel OpenTelemetry Collector all'indirizzo specificato. Sperimentale.
--file-mode VALUE Specifica i bit di autorizzazione per i file, in ottale. Il valore predefinito è 644.
--foreground Esegue il comando gcsfuse in primo piano.
--gid VALUE Specifica il proprietario dell'identificatore di gruppo (GID) di tutti gli inodi. Il valore predefinito del GID è -1.
--help o -h Visualizza la guida di Cloud Storage FUSE.
--http-client-timeout VALUE Specifica l'intervallo di tempo in cui il client HTTP di Cloud Storage FUSE può attendere per ricevere una risposta dal server prima del timeout. Il valore predefinito è 0s e indica l'assenza di timeout.
--implicit-dirs

Include implicitamente cartelle e cartelle gestite.

Per ulteriori informazioni, consulta la documentazione relativa a file e directory in GitHub.
--key-file VALUE Specifica un percorso assoluto al file di chiavi 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 al quale Cloud Storage FUSE può leggere i dati da Cloud Storage, misurato in una finestra di 30 secondi. Il valore limite predefinito è -1, che non specifica alcun limite.
--limit-ops-per-sec VALUE Specifica un limite per le operazioni eseguite al secondo, misurato in una finestra di 30 secondi. Il valore limite 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 fornito, i log in testo normale vengono stampati su stdout quando Cloud Storage FUSE viene eseguito in primo piano o su syslog quando Cloud Storage FUSE viene eseguito in background.
--log-format VALUE Specifica il formato del file di log. Il valore può essere text o json. Il valore predefinito è json.
--max-conns-per-host VALUE Specifica il numero massimo di connessioni TCP consentite per server. Questa entra in vigore quando --client-protocol viene impostato su http1. Il valore predefinito è 100.
--max-idle-conns-per-host VALUE Specifica il numero massimo di connessioni inattive consentite per server. Il valore predefinito è 100.
--max-retry-sleep VALUE Specifica la durata massima di sospensione di Cloud Storage FUSE in un loop di nuovi tentativi con backoff esponenziale. Quando la durata di backoff supera la durata massima specificata, il nuovo tentativo continua con la durata massima specificata. Il valore limite predefinito è 30s (30 secondi).
-o VALUE

Specifica opzioni di montaggio aggiuntive specifiche del sistema.

La maggior parte delle opzioni di montaggio generiche in FUSE (ad esempio rw e suid) sono supportate da Cloud Storage FUSE e possono essere trasmesse insieme al flag -o. Per maggiori dettagli, consulta la documentazione di Linux FUSE.
-o ro Monta un bucket in modalità di sola lettura.
--only-dir VALUE Monta solo una directory specifica all'interno di un bucket.
--rename-dir-limit VALUE Consente la ridenominazione delle directory che contengono meno discendenti rispetto al limite specificato. Il valore limite predefinito è 0.
--retry-multiplier VALUE Specifica il tempo di attesa tra due tentativi consecutivi.
--reuse-token-from-url Se incluso, restituisce True e specifica che verrà utilizzato il token acquisito da --token-url. Se escluso, restituisce False e specifica che il token acquisito da --token-url non deve essere riutilizzato.
--sequential-read-size-mb VALUE Specifica le dimensioni del blocco dei dati da scaricare da Cloud Storage, in megabyte (MB).
--stackdriver-export-interval VALUE Esporta le metriche in Stackdriver con l'intervallo specificato. Il valore predefinito è 0s, che non specifica alcuna esportazione.
--stat-cache-capacity VALUE Deprecato. Specifica il numero di voci che la cache delle statistiche può contenere. Questo influisce sul consumo della memoria. Il valore predefinito è 4096.
--stat-cache-ttl VALUE Deprecato. Specifica per quanto tempo memorizzare nella cache i risultati e gli attributi inode di StatObject. Il valore predefinito è 1m0s.
--type-cache-ttl VALUE Deprecato. Specifica per quanto tempo memorizzare nella cache la mappatura tra nomi e file o directory negli inode di directory. Il valore predefinito è 60s.
--temp-dir value VALUE Specifica un percorso della directory temporanea in cui vengono impostate le scritture prima del caricamento in Cloud Storage. Il valore predefinito è il tuo valore predefinito di sistema, molto probabilmente /tmp.
--token-url VALUE Specifica un URL per ricevere un token di accesso quando --key-file non è presente.
--uid VALUE Specifica il proprietario dell'identificatore utente (UID) di tutti gli inodi. Il valore UID predefinito è -1.
--version o -v Mostra la versione di Cloud Storage FUSE che hai installato.