gcsfuse-Befehlszeile

Auf dieser Seite werden die gcsfuse-Befehlszeilenoptionen beschrieben, die zur Interaktion mit Cloud Storage FUSE verwendet werden. Wenn Sie den Cloud Storage FUSE CSI-Treiber verwenden, um Ihre Buckets in Ihrem lokalen Dateisystem in Google Kubernetes Engine bereitzustellen, lesen Sie Bereitstellungsoptionen für den Cloud Storage FUSE CSI-Treiber.

Übersicht über die gcsfuse-Befehlszeile

Die gcsfuse-Befehlszeile wird verwendet, um Cloud Storage-Buckets als Dateisysteme auf einem lokalen Computer bereitzustellen.

Befehlsstruktur für Optionen der Cloud Storage FUSE-Befehlszeile

Das folgende Beispiel zeigt die Struktur des Befehls gcsfuse, einschließlich erforderlicher Argumente und optionaler globaler Optionen.

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Wobei:

  • GLOBAL_OPTIONS sind die Optionen, mit denen gesteuert wird, wie die Bereitstellung eingerichtet wird und wie sich Cloud Storage FUSE verhält.

  • BUCKET_NAME ist der Name des Buckets, der bereitgestellt werden soll. Beispiel: my-mount-bucket. Optional. Schließen Sie einen Bucket-Namen aus diesem Befehl aus, um eine dynamische Bereitstellung durchzuführen.

  • MOUNT_POINT ist das lokale Verzeichnis, in dem der Bucket bereitgestellt wird. Beispiel: /path/to/mount/point.

Globale Optionen

Option Beschreibung Gültiger Wert Standardwert
Deaktiviert die Authentifizierung für Anfragen. Diese Option sollte festgelegt werden, wenn Sie einen benutzerdefinierten Endpunkt verwenden, der keine Authentifizierung unterstützt. Diese Option sollte auch festgelegt werden, wenn Sie Cloud Storage FUSE mit öffentlichen Buckets verwenden. Boolescher Wert: true, false. false
Der Anwendungsname der Bereitstellung. Stringwert, z. B. my-bucket-mount. ""
Gibt ein Projekt an, das für die Abrechnung verwendet werden soll, wenn auf den bereitgestellten Bucket zugegriffen wird. Diese Option ist häufig erforderlich, wenn Sie einen Bucket bereitstellen, für den Anforderer bezahlt aktiviert ist. Stringwert, der eine Projekt-ID darstellt. ""

Aktiviert den Dateicache und gibt das Verzeichnis zum Speichern von Dateicache-Daten an.

 Ein Pfad, z. B. /tmp/gcsfuse-cache-path. Ein leerer Wert bedeutet, dass diese Option deaktiviert ist. Diese Option ist standardmäßig deaktiviert. ""
Gibt das Protokoll an, das für die Kommunikation mit dem Cloud Storage-Backend verwendet wird. http1

Exportiert Messwerte nach Cloud Monitoring mit dem angegebenen Intervall.

 Ganzzahl, die einen Wert in Sekunden darstellt, z. B. 10 (10 Sekunden). 0 gibt an, dass kein Export erfolgt. 0
Gibt den Pfad zur Konfigurationsdatei an, die Sie zum Konfigurieren des Verhaltens von Cloud Storage FUSE verwenden möchten. Ein Pfad, z. B. /etc/gcsfuse.yaml. ""
Gibt einen alternativen benutzerdefinierten Endpunkt zum Abrufen von Daten an. Der benutzerdefinierte Endpunkt muss die entsprechenden Ressourcen und Vorgänge als Cloud Storage-JSON-Endpunkt https://storage.googleapis.com/storage/v1 unterstützen. Wenn kein benutzerdefinierter Endpunkt angegeben ist, nutzt Cloud Storage FUSE den globalen Cloud Storage JSON API-Endpunkt https://storage.googleapis.com/storage/v1. Wenn die Authentifizierung für den angegebenen benutzerdefinierten Endpunkt nicht unterstützt wird, setzen Sie das Flag --anonymous-access auf true, um die Authentifizierung zu umgehen. Ein Endpunkt, z. B. http://localhost:443/storage/v1. ""
Aktiviert die FUSE-bezogene Debugging-Ausgabe. Diese Option wurde durch die Option --log-severity ersetzt. Wenn Sie die Debugging-Ausgabe aktivieren möchten, legen Sie die Option --log-severity auf trace fest. Dies umfasst Trace-, Debug-, Info-, Warn- und Fehlerlogs. Boolescher Wert: true, false. false
Gibt Informationen zu Cloud Storage-Anfragen und Zeitangaben aus. Diese Option wurde durch die Option --log-severity ersetzt. Wenn Sie die Debugging-Ausgabe aktivieren möchten, legen Sie die Option --log-severity auf trace fest. Dies umfasst Trace-, Debug-, Info-, Warn- und Fehlerlogs. Boolescher Wert: true, false. false
Beendet das Programm, wenn interne Invariantenverstöße erkannt werden. Boolescher Wert: true, false. false
Gibt Debug-Nachrichten aus, wenn ein Mutex zu lange gehalten wird. Wenn diese Option angegeben ist, wird der Schweregrad der Logs automatisch auf trace gesetzt, einschließlich Trace-, Debug-, Info-, Warn- und Fehler-Logs. Boolescher Wert: true, false. false
Berechtigungs-Bits für Verzeichnisse in Oktal. Ganzzahl zwischen 000 und 777 (einschließlich). 755
Erstellt einen Typ-Cache-Eintrag mit dem Typ NonexistentType, wenn eine Datei in Cloud Storage nicht gefunden wird. Wenn die Datei in Cloud Storage erstellt wird, der Eintrag NonexistentType für die Datei jedoch im Cache gespeichert wird, kann Cloud Storage FUSE diese Datei erst anfordern, wenn der Eintrag NonexistentType aus dem Typ-Cache entfernt wurde. Boolescher Wert: true, false. false
Steuert den Schreibpfadfluss, sodass Daten direkt in Cloud Storage hochgeladen werden, während sie geschrieben werden, anstatt den Schreibvorgang vollständig lokal zu inszenieren und ihn bei close() oder fsync() hochzuladen. Weitere Informationen zu Streaming-Schreibvorgängen finden Sie in der GitHub-Dokumentation zu Cloud Storage FUSE. Boolescher Wert: true, false. true

Gibt die maximale Größe in MiB an, die der Datei-Cache verwenden kann. Damit können Sie die Gesamtkapazität begrenzen, die der Datei-Cache in seinem eingebundenen Verzeichnis verwenden kann.
  • Ganzzahl
  • -1: Gibt an, dass die gesamte verfügbare Kapazität des Cache in dem Verzeichnis verwendet wird, das Sie für cache-dir angeben. Dies ist nur dann die Standardeinstellung, wenn cache-dir übergeben wird.
  • 0: Deaktiviert den Dateicache.
 -1
Gibt an, ob das vollständige Objekt asynchron heruntergeladen und im Cloud Storage FUSE-Cacheverzeichnis gespeichert werden soll, wenn der erste Lesevorgang von einem Offset ungleich null abgeschlossen wird. Diese Option sollte auf true gesetzt werden, wenn Sie mehrere zufällige oder partielle Lesevorgänge ausführen möchten. Boolescher Wert: true, false. false
Gibt die Größe jeder Leseanfrage in MiB an, die jeder Goroutine an Cloud Storage sendet, wenn sie das Objekt in den Dateicache herunterlädt. Ganzzahl 200

Beschleunigt das Lesen großer Dateien, indem das Dateicache-Verzeichnis als Prefetch-Puffer verwendet wird. Dabei werden mehrere Worker eingesetzt, um mehrere Teile einer Datei parallel herunterzuladen.

Parallele Downloads werden automatisch aktiviert, wenn Sie das Dateicaching aktivieren. Weitere Informationen zum Dateicaching finden Sie unter Dateicaching mit Cloud Storage FUSE verwenden.

Weitere Informationen zu parallelen Downloads und zum Konfigurieren unterstützender Properties

 Boolescher Wert: true, false. true
Die maximale Anzahl von Goroutinen, die zu einem bestimmten Zeitpunkt für alle Downloadjobs von Dateien erstellt werden können.
  • Ganzzahl
  • -1: Gibt unbegrenzte parallele Downloads an.
  • 0: Deaktiviert parallele Downloads. Kann nur verwendet werden, wenn --enable-parallel-downloads nicht übergeben wird oder als false übergeben wird.
  • 0: Es wird kein oberes Limit angegeben. Cloud Storage FUSE begrenzt den Wert intern basierend auf der maximalen Anzahl von Goroutines, die gemäß der Konfiguration Ihres Computers erstellt werden können.
 Die doppelte Anzahl der CPU-Kerne auf Ihrem Computer oder 16, je nachdem, welcher Wert höher ist.
Die Anzahl der gleichzeitigen Downloadanfragen pro Datei. Ganzzahl 16
Gibt Berechtigungs-Bits für Dateien in Oktal an. Ganzzahl zwischen 000 und 777 (einschließlich). 644
Führt den Befehl gcsfuse im Vordergrund aus. Boolescher Wert: true, false. false
Gibt den Gruppen-ID-Inhaber (GID) aller Inodes an.
  • Ganzzahl, die eine Gruppen-ID darstellt.
  • -1: Die GID des Anrufers wird verwendet.
 -1
Zeigt Hilfe zu Cloud Storage FUSE an. Keine Keine
Zeigt die von Ihnen installierte Cloud Storage FUSE-Version an. Keine Keine
Gibt an, wie lange der Cloud Storage FUSE-HTTP-Client auf die Antwort vom Server warten kann, bevor eine Zeitüberschreitung auftritt. Dauer, z. B. 1h10m10s für 1 Stunde, 10 Minuten und 10 Sekunden. 0s gibt kein Zeitlimit an. 0s
Weist Cloud Storage FUSE an, Systemunterbrechungssignale wie SIGINT zu ignorieren, die durch Control+C ausgelöst werden. So wird verhindert, dass Signale laufende Vorgänge beenden. Boolescher Wert: true, false. true
Umfasst implizit Ordner und verwaltete Ordner. Weitere Informationen finden Sie in der Dokumentation zu Dateien und Verzeichnissen in GitHub. Boolescher Wert: true, false. false
Aktiviert den Listencache und definiert die Gültigkeitsdauer (Time to Live, TTL) in Sekunden von im Cache gespeicherten Listeneinträgen. Der Listen-Cache wird im Arbeitsspeicher des Seitencache gespeichert. Dieser wird vom Kernel basierend auf der Arbeitsspeicherverfügbarkeit gesteuert.
  • Ganzzahl, die Sekunden darstellt, z. B. 10 (10 Sekunden).
  • 0: Deaktiviert das Listen-Caching.
  • -1: Umgeht den Ablauf von Einträgen und gibt immer die Listenantwort aus dem Cache zurück, wenn sie verfügbar ist.
 0
Gibt einen absoluten Pfad zur JSON-Schlüsseldatei für Anmeldedaten zur Authentifizierung von Anfragen an Cloud Storage an. Standardmäßig verwendet Cloud Storage FUSE Standardanmeldedaten für Anwendungen zur Authentifizierung von Anfragen. Ein Pfad, z. B. /home/example_user/gcloud-key.json. Wenn diese Option nicht festgelegt ist, werden die Standardanmeldedaten für Anwendungen verwendet.
Gibt das Bandbreitenlimit an, bei dem Cloud Storage FUSE Daten aus Cloud Storage lesen kann, gemessen über ein 30-Sekunden-Fenster. Gleitkommazahl. -1 bedeutet, dass es kein Limit gibt. -1
Gibt ein Limit für Vorgänge pro Sekunde an, die über ein 30-Sekunden-Fenster gemessen werden. Gleitkommazahl. -1 bedeutet, dass es kein Limit gibt. -1
Gibt die Datei zum Speichern von Logs an, die von Fluentd geparst werden können. Ein Pfad, z. B. /tmp/user-example-bucket-gcsfuse-logs.txt. stdout, wenn Cloud Storage FUSE im Vordergrund ausgeführt wird, oder syslog, wenn Cloud Storage FUSE im Hintergrund ausgeführt wird
Gibt das Format der Protokolldatei an.
  • text
  • json
 json
Die maximale Anzahl der rotierten Logdateien, die beibehalten werden sollen, ausgenommen die aktive Datei, in die Logs geschrieben werden.
  • Ganzzahl
  • 0: Alle rotierten Logdateien werden beibehalten.
 10
Gibt an, ob rotierte Logdateien mit gzip komprimiert werden. Boolescher Wert: true, false. true
Die maximale Größe in Megabyte (MB), die Protokolldateien erreichen können, bevor sie rotiert werden. Integer. Der Mindestwert beträgt 1. 512

Der Schweregrad, für den Cloud Storage FUSE Logs generieren soll. Die Schweregrade werden vom niedrigsten zum höchsten Schweregrad sortiert. Wenn Sie beispielsweise warning angeben, generiert Cloud Storage FUSE Logs für Warnungen und Fehler. Im Allgemeinen empfehlen wir die Verwendung des Schweregrads info.
  • trace
  • debug
  • info
  • warning
  • error
  • off: Deaktiviert das gesamte Logging.
 info
Gibt die maximal zulässige Anzahl von TCP-Verbindungen pro Server an. Dies wird wirksam, wenn --client-protocol auf http1 festgelegt ist. Ganzzahl zwischen 0 und 2147483647. 0 gibt an, dass es kein Limit für TCP-Verbindungen gibt. 0
Gibt die maximal zulässige Anzahl inaktiver Verbindungen pro Server an. Dies wird wirksam, wenn --client-protocol auf http1 festgelegt ist. Ganzzahl zwischen 0 und 2147483647. 0 gibt an, dass es kein Limit für inaktive Verbindungen gibt. 0
Gibt die maximale Dauer an, die Cloud Storage FUSE in einer Wiederholungsschleife mit exponentiellem Backoff warten darf. Wenn die Backoff-Dauer die angegebene maximale Dauer überschreitet, wird der Wiederholungsversuch mit der angegebenen maximalen Dauer fortgesetzt. Dauer, z. B. 1h5m50s (1 Stunde, 5 Minuten und 50 Sekunden) oder 60s (60 Sekunden). 30s

Definiert die Gültigkeitsdauer (Time to Live, TTL) in Sekunden von Cache-Einträgen für negative Statistiken, in denen Ergebnisse für nicht vorhandene Dateien im Cache gespeichert werden.
  • Ganzzahl, die Sekunden darstellt, z. B. 10 (10 Sekunden).
  • 0: Deaktiviert das negative Stat-Caching.
  • -1: Ermöglicht unbegrenztes negatives Statistik-Caching und deaktiviert den TTL-Ablauf.
 5
Definiert die Gültigkeitsdauer (TTL) von im Cache gespeicherten Metadateneinträgen in Sekunden.
  • Ganzzahl, die Sekunden darstellt, z. B. 30 (30 Sekunden).
  • -1: Ein TTL-Ablauf wird umgangen und die Datei wird aus dem Cache bereitgestellt, wann immer sie verfügbar ist.
  • 0: Verwenden Sie die aktuelle Datei. Mit diesem Wert wird ein Get-Metadatenaufruf ausgeführt, um sicherzustellen, dass die Objektgeneration für die Datei im Cache mit der in Cloud Storage gespeicherten Generation übereinstimmt. Weitere Informationen finden Sie unter Cache-Entwertung konfigurieren.
 60
Gibt zusätzliche systemspezifische Bereitstellungsoptionen an. Die meisten generischen Bereitstellungsoptionen in FUSE, z. B. suid, werden von Cloud Storage FUSE unterstützt und können zusammen mit der Option -o übergeben werden. Bereitstellungsoptionen in FUSE, z. B.:
  • rw: Als Lese-/Schreibzugriff bereitstellen.
  • ro: Als schreibgeschützt bereitstellen.
 ""
Stellt nur ein bestimmtes Verzeichnis in einem Bucket bereit. Ein Pfad, z. B. /etc/gcsfuse.yaml. ""

Stellt den Prometheus-Messwert-Endpunkt am angegebenen Port und Pfad /metrics bereit.

 Ganzzahl, die den Port angibt, den Sie festlegen möchten. 0
Ermöglicht das Umbenennen von Verzeichnissen, die weniger Nachfolgerelemente als das angegebene Limit enthalten. Ganzzahl zwischen 0 und 2147483647. 0
Gibt den Multiplikator für den exponentiellen Backoff zwischen aufeinanderfolgenden Wiederholungsversuchen an. Gleitkommazahl. 2
Gibt an, ob das von --token-url abgerufene Token wiederverwendet werden soll. Boolescher Wert: true, false. true
Gibt die Blockgröße der aus Cloud Storage herunterzuladenden Daten in Megabyte (MB) an. Ganzzahl zwischen 1 und 1024. 200
Gibt die Anzahl der Einträge an, die der Statistik-Cache enthalten kann. Diese Option wurde durch die Option --stat-cache-max-size-mb ersetzt. Ganzzahl 4096
Die maximale Größe des Arbeitsspeichers, den der Statistik-Cache verwenden kann, in MiB. Der Statistikcache wird immer vollständig im Arbeitsspeicher gespeichert.
  • Integer. Wir empfehlen Folgendes:
    • 32,wenn Ihre Arbeitslast bis zu 20.000 Dateien umfasst.
    • Wenn Ihre Arbeitslast mehr als 20.000 Dateien enthält, erhöhen Sie die Größe um Werte von 10 pro weitere 6.000 Dateien. Der Stat-Cache verwendet durchschnittlich 1.500 MiB pro Datei.
  • -1: Es wird kein Limit festgelegt. Der Statistik-Cache kann so viel Speicherplatz belegen, wie erforderlich ist.
  • 0: Deaktiviert den Statistik-Cache.
 32
Gibt an, wie lange StatObject-Ergebnisse und Inode-Attribute im Cache gespeichert werden sollen. Diese Option wurde durch die Option --metadata-cache-ttl-secs ersetzt. Dauer, z. B. 20s (20 Sekunden). 60s
Gibt einen Pfad zum temporären Verzeichnis an, in dem Schreibvorgänge vor dem Hochladen in Cloud Storage bereitgestellt werden. Ein Pfad, z. B. /mnt/ssd/example-user-gcsfuse-temp-dir. /tmp
Gibt eine URL zum Abrufen eines Zugriffstokens an, wenn --key-file nicht vorhanden ist. Eine URL. ""
Gibt an, wie lange die Zuordnung zwischen Namen und Dateien oder Verzeichnissen in Verzeichnis-Inodes im Cache gespeichert werden soll (in Sekunden). Diese Option wurde durch die Option --metadata-cache-ttl-secs ersetzt. Dauer in Sekunden, z. B. 20s (20 Sekunden). 60s
Die maximale Größe in MiB pro Verzeichnis, die der Typcache verwenden kann. Der Typ-Cache wird immer vollständig im Arbeitsspeicher gehalten.
  • Integer. Wir empfehlen Folgendes:
    • 4,wenn die maximale Anzahl von Dateien in einem einzelnen Verzeichnis des bereitgestellten Buckets 20.000 Dateien oder weniger beträgt.
    • Wenn die maximale Anzahl von Dateien in einem einzelnen Verzeichnis,das Sie bereitstellen, mehr als 20.000 Dateien enthält,erhöhen Sie den Wert um 1 pro 5.000 Dateien, also durchschnittlich ca. 200 Byte pro Datei.
  • -1: Gibt kein Limit an und ermöglicht es dem Typ-Cache, so viel Speicher wie nötig zu verwenden.
  • 0: Deaktiviert den Typ-Cache.
 4
Gibt den Inhaber der User Identifier (UID) aller Inodes an.
  • Ganzzahl, die eine UID darstellt.
  • -1: Die UID des Anrufers wird verwendet.
 -1

Gibt die maximale Anzahl von Datenblöcken an, die für Streaming-Schreibvorgänge in allen Dateien verfügbar sind. Für jede Datei wird standardmäßig ein 32 MiB großer Datenblock verwendet.
  • Ganzzahl
  • 0: Deaktiviert Streaming-Schreibvorgänge.
  • -1: Legt den Wert auf eine unbegrenzte Anzahl von Blöcken fest.
  • Standardwert für Geräte mit geringen Spezifikationen und begrenzten Ressourcen: 4
  • Standardwert für Maschinen mit hoher Spezifikation und einer großen Menge an Ressourcen: 1600

Nach oben