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 |
-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. |