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 im lokalen Dateisystem in der Google Kubernetes Engine bereitzustellen, lesen Sie den Hilfeartikel Bereitstellungs-Flags für den Cloud Storage FUSE CSI-Treiber.

Zusammenfassung

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Dabei gilt:

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

Beschreibung

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

Globale Optionen

Option Beschreibung Gültiger Wert Standardwert
--anonymous-access 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
--app-name Der Anwendungsname der Bereitstellung. Stringwert, z. B. my-bucket-mount. ""
--billing-project 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. ""
--cache-dir

Gibt das Verzeichnis für das Speichern von Dateicache-Daten an.

Informationen zum Aktivieren des Datei-Cachings finden Sie unter Datei-Caching verwenden.

 Ein Pfad, z. B. /tmp/gcsfuse-cache-path. ""
--client-protocol Gibt das Protokoll an, das für die Kommunikation mit dem Cloud Storage-Backend verwendet wird.
  • http1 für HTTP/1.1
  • http2 für HTTP/2
  • grpc für gRPC
 http1
--config-file 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. ""
--custom-endpoint 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 --anonymous-access-Flag auf true, um die Authentifizierung zu umgehen. Einen Endpunkt, z. B. http://localhost:443/storage/v1. ""
--debug_fuse (verworfen) Aktiviert die FUSE-bezogene Debugging-Ausgabe. Diese Option wurde durch die Option --log-severity ersetzt. Wenn Sie die Debugausgabe aktivieren möchten, legen Sie die Option --log-severity auf trace fest. Dies umfasst Trace-, Debug-, Info-, Warn- und Fehlerprotokolle. Boolescher Wert: true, false. false
--debug_gcs (verworfen) Gibt Informationen zu Cloud Storage-Anfragen und Zeitangaben aus. Diese Option wurde durch die Option --log-severity ersetzt. Wenn Sie die Debugausgabe aktivieren möchten, legen Sie die Option --log-severity auf trace fest. Dies umfasst Trace-, Debug-, Info-, Warn- und Fehlerprotokolle. Boolescher Wert: true, false. false
--debug_invariants Beendet das Programm, wenn interne Invarianten verletzt werden. Boolescher Wert: true, false. false
--debug_mutex 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
--dir-mode Berechtigungs-Bits für Verzeichnisse in Oktal. Ganzzahl zwischen 000 und 777 (einschließlich). 755
--enable-nonexistent-type-cache 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
--file-cache-cache-file-for-range-read Bestimmt, ob das vollständige Objekt asynchron heruntergeladen und im Cloud Storage FUSE-Cacheverzeichnis gespeichert werden soll, wenn die erste Leseoperation von einem nicht nullwertigen Offset abgeschlossen wird. Diese Option sollte auf true festgelegt sein, wenn Sie mehrere zufällige oder teilweise Lesevorgänge ausführen möchten.

Hinweis: Wenn Sie einen Teillesevorgang ab dem Offset 0 ausführen, lädt Cloud Storage FUSE das vollständige Objekt asynchron herunter und speichert es im Cache.

 Boolescher Wert: true, false. false
--file-cache-download-chunk-size-mb 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 50
--file-cache-enable-parallel-downloads

Beschleunigt das Lesen großer Dateien, indem das Dateicache-Verzeichnis als Prefetch-Puffer verwendet wird und große Dateien mithilfe mehrerer Worker parallel heruntergeladen werden. Weitere Informationen zu parallelen Downloads und zur Konfiguration der zugehörigen Eigenschaften finden Sie unter Leseleistung durch parallele Downloads verbessern.

Wenn Sie parallele Downloads verwenden möchten, müssen Sie zuerst das Datei-Caching aktivieren.

 Boolescher Wert: true, false. false
--file-cache-max-parallel-downloads 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 Oberlimit angegeben. Cloud Storage FUSE begrenzt den Wert intern auf die maximale Anzahl von Go-Routines, die gemäß der Konfiguration Ihres Computers gestartet werden können.
 Die doppelte Anzahl der CPU-Kerne auf Ihrem Computer oder 16, je nachdem, welcher Wert höher ist.
--file-mode Gibt Berechtigungs-Bits für Dateien in Oktal an. Ganzzahl zwischen 000 und 777 (einschließlich). 644
--foreground Führt den Befehl gcsfuse im Vordergrund aus. Boolescher Wert: true, false. false
--gid Gibt den Gruppen-ID-Inhaber (GID) aller Inodes an.
  • Ganzzahl, die eine GID darstellt.
  • -1: Die GID des Anrufers wird verwendet.
 -1
--help Zeigt Hilfe zu Cloud Storage FUSE an. Keine Keine
--version Zeigt die von Ihnen installierte Cloud Storage FUSE-Version an. Keine Keine
--http-client-timeout 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
--ignore-interrupts Cloud Storage FUSE wird angewiesen, Systemunterbrechungssignale wie SIGINT zu ignorieren, die von Control+C ausgelöst werden. So wird verhindert, dass Signale laufende Vorgänge beenden. Boolescher Wert: true, false. true
--implicit-dirs Umfasst implizit Ordner und verwaltete Ordner. Weitere Informationen finden Sie in der Dokumentation zu Dateien und Verzeichnissen in GitHub. Boolescher Wert: true, false. false
--kernel-list-cache-ttl-secs Hiermit wird der Listencache aktiviert und die Gültigkeitsdauer (Time to Live, TTL) in Sekunden für im Cache gespeicherte Listeneinträge definiert. Der Listen-Cache wird im Arbeitsspeicher des Seitencache gespeichert. Dieser wird vom Kernel basierend auf dem verfügbaren Arbeitsspeicher 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
--key-file 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.
--limit-bytes-per-sec Gibt das Bandbreitenlimit an, bei dem Cloud Storage FUSE Daten aus Cloud Storage lesen kann, gemessen über ein 30-Sekunden-Fenster. Gleitkommazahl. -1 gibt kein Limit an. -1
--limit-ops-per-sec Gibt ein Limit für Vorgänge pro Sekunde an, die über ein 30-Sekunden-Fenster gemessen werden. Gleitkommazahl. -1 gibt kein Limit an. -1
--log-file 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
--log-format Gibt das Format der Protokolldatei an.
  • text
  • json
 json
--log-rotate-backup-file-count Die maximale Anzahl der rotierten Logdateien, die beibehalten werden sollen, ausgenommen die aktive Datei, in die Logs geschrieben werden.
  • Ganzzahl
  • 0: Alle rotierten Protokolldateien werden beibehalten.
 10
--log-rotate-compress Gibt an, ob rotierte Logdateien mit gzip komprimiert werden. Boolescher Wert: true, false. true
--log-rotate-max-file-size-mb Die maximale Größe in Megabyte (MB), die Logdateien erreichen können, bevor sie rotiert werden. Integer. Der Mindestwert beträgt 1. 512
--log-severity

Der Schweregrad, für den Cloud Storage FUSE Protokolle 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 der Schwerestufe info.
  • trace
  • debug
  • info
  • warning
  • error
  • off: Deaktiviert das gesamte Logging.
 info
--max-conns-per-host 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. Mit 0 wird kein Limit für TCP-Verbindungen festgelegt. 0
--max-idle-conns-per-host 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 legt kein Limit für inaktive Verbindungen fest. 0
--max-retry-sleep 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
--metadata-cache-negative-ttl-secs

Definiert die Gültigkeitsdauer (Time to Live, TTL) in Sekunden von negativen Statistik-Cache-Einträgen, 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 Caching von Statistiken.
  • -1: Ermöglicht unbegrenztes negatives Caching von Status und deaktiviert den TTL-Ablauf.
 5
--metadata-cache-ttl-secs Definiert die Gültigkeitsdauer (TTL) in Sekunden der im Cache gespeicherten Metadateneinträge.
  • Ganzzahl, die Sekunden darstellt, z. B. 30 (30 Sekunden).
  • -1: TTL-Ablauf umgehen und Dateien aus dem Cache bereitstellen, wann immer sie verfügbar sind.
  • 0: Verwenden Sie die aktuellste Datei. Wenn du diesen Wert verwendest, wird ein Get-Metadatenaufruf ausgeführt, um sicherzustellen, dass die Objektgenerierung für die Datei im Cache mit den in Cloud Storage gespeicherten Daten übereinstimmt. Weitere Informationen finden Sie unter Cache-Entwertung konfigurieren.
 60
-o Gibt zusätzliche systemspezifische Bereitstellungsoptionen an. Die meisten generischen Bereitstellungsoptionen in FUSE wie suid werden von Cloud Storage FUSE unterstützt und können zusammen mit der Option -o übergeben werden. Bereitstellungsoptionen in FUSE, z. B.:
  • rw: Bereitstellung als Lese-/Schreibzugriff
  • ro: Bereitstellung als schreibgeschützt
 ""
--only-dir Stellt nur ein bestimmtes Verzeichnis in einem Bucket bereit. Ein Pfad, z. B. /etc/gcsfuse.yaml. ""
--rename-dir-limit Ermöglicht das Umbenennen von Verzeichnissen, die weniger Nachfolgerelemente als das angegebene Limit enthalten. Ganzzahl zwischen 0 und 2147483647. 0
--retry-multiplier Gibt den Multiplikator für den exponentiellen Backoff zwischen aufeinanderfolgenden Wiederholungsversuchen an. Gleitkommazahl. 2
--reuse-token-from-url Gibt an, ob das von --token-url abgerufene Token wiederverwendet werden soll. Boolescher Wert: true, false. true
--sequential-read-size-mb Gibt die Blockgröße der aus Cloud Storage herunterzuladenden Daten in Megabyte (MB) an. Ganzzahl zwischen 1 und 1024. 200
--stackdriver-export-interval Exportiert Messwerte nach Stackdriver mit dem angegebenen Intervall. Dauer, z. B. 1h5m50s (1 Stunde, 5 Minuten und 50 Sekunden) Mit 0s wird kein Export angegeben. 0s
--stat-cache-capacity (verworfen) 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
--stat-cache-max-size-mb Die maximale Arbeitsspeichergröße, die der Statistik-Cache verwenden kann, in MiB. Der Statistik-Cache wird immer vollständig im Arbeitsspeicher gehalten.
  • 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 MiB pro weitere 6.000 Dateien. Der Statistik-Cache belegt durchschnittlich 1.500 MiB pro Datei.
  • -1: Es wird kein Limit festgelegt. Der Statistik-Cache belegt dann so viel Arbeitsspeicher wie erforderlich.
  • 0: Deaktiviert den Statistik-Cache.
 32
--stat-cache-ttl (verworfen) 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
--temp-dir 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
--token-url Gibt eine URL zum Abrufen eines Zugriffstokens an, wenn --key-file nicht vorhanden ist. URL ""
--type-cache-ttl (deprecated) 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
--type-cache-max-size-mb 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 keine Begrenzung an und lässt den Typ-Cache so viel Arbeitsspeicher wie nötig verwenden.
  • 0: Deaktiviert den Typ-Cache.
 4
--uid Gibt den Inhaber der User Identifier (UID) aller Inodes an.
  • Ganzzahl, die eine UID darstellt.
  • -1: Die UID des Anrufers wird verwendet.
 -1