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_OPTIONSsono 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 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 |
Disabilita 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 i bucket pubblici.
Il valore predefinito è false. |
--app-name VALUE |
Il nome dell'applicazione della piastra da muro. |
--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 Requester Pays. 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 da 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 sull'endpoint personalizzato specificato, imposta il flag --anonymous-access su true per bypassare l'autenticazione.
|
--debug_fuse_errors |
Se escluso, restituisce False e impedisce agli
errori di FUSE
di essere registrati nella console (se viene utilizzato --foreground) o nel file di log (se è utilizzato --log-file). |
--debug_fuse |
Attiva l'output di debug relativo a FUSE. 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 delle informazioni, log degli avvisi e log degli errori. |
--debug_gcs |
Stampa la richiesta e le informazioni 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 |
Panico in caso di violazione degli elementi invarianti interni. |
--debug_mutex |
Stampa i messaggi di debug quando un mutex viene tenuto troppo a lungo. 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 delle informazioni, log degli avvisi e log degli errori. |
--dir-mode VALUE |
Bit di autorizzazioni per le directory, in ottale. Il valore predefinito è 755. |
--enable-nonexistent-type-cache |
Crea una voce di cache di tipo di tipo NonexistentType
se non viene trovato un file in Cloud Storage. Se il file viene creato in Cloud Storage, ma la voce NonexistentType relativa al file viene 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 di 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 in OpenTelemetry Collector all'indirizzo specificato. Sperimentale. |
--file-mode VALUE |
Specifica i bit delle autorizzazioni per i file, in ottale. Il valore predefinito è 644. |
--foreground |
Esegue il comando gcsfuse in primo piano. |
--gid VALUE |
Specifica il proprietario dell'identificatore del gruppo (GID) di tutti gli inode. Il valore predefinito del GID è -1. |
--help o -h |
Visualizza la guida per Cloud Storage FUSE. |
--http-client-timeout VALUE |
Specifica quanto tempo il client HTTP Cloud Storage FUSE può attendere per ricevere una risposta dal server prima del timeout. Il valore predefinito è 0s, che indica nessun 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 possono terminare le operazioni in corso. I valori sono true
o false. Il valore predefinito è true. |
--implicit-dirs |
Include implicitamente cartelle e cartelle gestite. Per maggiori informazioni, consulta la documentazione relativa a file e directory in GitHub. |
--kernel-list-cache-ttl-secs VALUE |
Abilita la cache dell'elenco e definisce la durata (TTL) in secondi di voci dell'elenco memorizzate nella cache. La cache dell'elenco viene mantenuta nella cache della pagina, che è controllata dal kernel in base alla disponibilità di memoria. Il valore predefinito è 0, che specifica che la memorizzazione nella cache degli elenchi è disabilitata.
Per impostare il flag --kernel-list-cache-ttl-secs, specifica un
valore positivo in secondi per mantenere la risposta dell'elenco di directory nella
cache della pagina del kernel. Per bypassare la scadenza della voce e restituire sempre la risposta dell'elenco dalla cache quando è disponibile, inserisci il valore -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 al quale Cloud Storage FUSE può leggere i dati da Cloud Storage, misurato in una finestra di 30 secondi. Il valore limite predefinito è -1 e 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 e
non specifica alcun limite. |
--log-file VALUE |
Specifica il file per l'archiviazione dei log che possono essere analizzati da Fluentd. Se non vengono forniti, i log in testo normale vengono stampati in stdout quando Cloud Storage FUSE viene eseguito in primo piano o in 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 impostazione diventa effettiva quando il criterio --client-protocol viene impostato su http1. Il valore predefinito è 0 e specifica che non sono previsti limiti 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 predefinito è 100. |
--max-retry-sleep VALUE |
Specifica la durata massima consentita per la sospensione di Cloud Storage FUSE in un ciclo di nuovi tentativi con backoff esponenziale. Quando la durata del 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 (come |
-o ro |
Monta un bucket in sola lettura. |
--only-dir VALUE |
Monta solo una directory specifica all'interno di un bucket. |
--rename-dir-limit VALUE |
Consente di rinominare le directory contenenti meno discendenti rispetto al limite specificato. Il valore limite predefinito è 0. |
--retry-multiplier VALUE |
Specifica il tempo di attesa tra due nuovi tentativi consecutivi. |
--reuse-token-from-url |
Se incluso, restituisce True e specifica che deve essere 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 la dimensione 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 e non specifica l'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.
Al posto di questo flag, usa il campo metadata-cache: stat-cache max-size
in un file di configurazione
per impostare la dimensione massima della cache delle statistiche. Per maggiori informazioni, consulta il file di configurazione di Cloud Storage FUSE.
|
--stat-cache-ttl VALUE |
Deprecato. Specifica per quanto tempo memorizzare nella cache i risultati e gli attributi inode di StatObject. Il valore predefinito è 60s.
Al posto di questo flag, usa il campo metadata-cache: ttl-secs
in un file di configurazione per specificare la
durata (TTL) delle voci di metadati sia delle cache stat che di quelle dei tipi. Per
ulteriori informazioni, consulta il file di configurazione di Cloud Storage FUSE. |
--type-cache-ttl VALUE |
Deprecato. Specifica per quanto tempo memorizzare nella cache il mapping tra nomi e file o directory negli inode di directory. Il valore predefinito è 60s.
Utilizza invece il campo metadata-cache: ttl-secs per specificare la
durata (TTL) delle voci di metadati sia delle cache stat che di quelle dei tipi. Per
maggiori informazioni, consulta il
file di configurazione di Cloud Storage FUSE. |
--temp-dir value VALUE |
Specifica un percorso della directory temporanea in cui vengono temporanee le scritture prima di essere caricate in Cloud Storage. Il valore predefinito è quello 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 inode. Il valore predefinito dell'UID è -1. |
--version o -v |
Visualizza la versione di Cloud Storage FUSE che hai installato. |