gcsfuse-Befehlszeile

Auf dieser Seite werden die gcsfuse-Befehlszeilenoptionen beschrieben, die zur Interaktion mit Cloud Storage FUSE verwendet werden.

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

Globale Optionen Beschreibung
--anonymous-access BOOLEAN Deaktiviert die Authentifizierung für Anfragen. Dieses Flag sollte festgelegt werden, wenn Sie einen benutzerdefinierten Endpunkt verwenden, der keine Authentifizierung unterstützt. Dieses Flag sollte auch festgelegt werden, wenn Sie Cloud Storage FUSE mit öffentlichen Buckets verwenden. Der Standardwert ist false.
--app-name VALUE Der Anwendungsname der Bereitstellung.
--billing-project VALUE Gibt ein Projekt an, das für die Abrechnung verwendet werden soll, wenn auf den bereitgestellten Bucket zugegriffen wird. Dieses Flag ist häufig erforderlich, wenn Sie einen Bucket bereitstellen, für den Anforderer bezahlt aktiviert ist. Das Standardprojekt ist „kein“.
--cache-dir VALUE Gibt das Verzeichnis für das Speichern von Dateicache-Daten an.

Hinweis: Wenn Sie das Datei-Caching aktivieren möchten, müssen Sie mit --cache-dir ein Verzeichnis angeben und mit dem Flag --file-cache-max-size-mb entweder eine positive Ganzzahl für die maximale Datei-Cache-Größe in Mebibyte (MiB) oder den Wert -1 für keine Begrenzung angeben.
--client-protocol VALUE Gibt das Protokoll an, das für die Kommunikation mit dem Cloud Storage-Backend verwendet wird. Der Wert muss http1 für HTTP/1.1 oder http2 für HTTP/2 sein. Der Standardwert ist http1.
--config-file VALUE Gibt den Pfad zur Konfigurationsdatei an, die Sie zum Konfigurieren des Verhaltens von Cloud Storage FUSE verwenden möchten. Beispiel:--config-file /etc/gcsfuse.yaml
--custom-endpoint VALUE 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.
--debug_fuse BOOLEAN Eingestellt. 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.
--debug_gcs BOOLEAN Eingestellt. 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.
--debug_invariants BOOLEAN Beendet das Programm, wenn interne Invarianten verletzt werden. Der Standardwert ist false.
--debug_mutex BOOLEAN 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. Der Standardwert ist false.
--dir-mode VALUE Berechtigungs-Bits für Verzeichnisse in Oktal. Der Wert muss zwischen 000 und dem maximalen Wert 777 liegen. Der Standardwert ist 755.
--enable-nonexistent-type-cache BOOLEAN 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. Der Standardwert ist false.
--file-cache-cache-file-for-range-read BOOLEAN

Bestimmt, ob das vollständige Objekt asynchron heruntergeladen und im Cloud Storage FUSE-Cacheverzeichnis gespeichert werden soll, wenn der erste Lesevorgang von einem nicht nullwertigen Offset aus abgeschlossen wird. Dieses Flag sollte auf true festgelegt sein, wenn Sie mehrere zufällige oder teilweise Lesevorgänge ausführen möchten. Wenn dieses Feld nicht angegeben ist, wird standardmäßig false verwendet.

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.
--file-cache-download-chunk-size-mb VALUE

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. Der Standardwert ist 50.
--file-cache-enable-parallel-downloads BOOLEAN

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. Der Standardwert ist false.


Wenn Sie parallele Downloads verwenden möchten, müssen Sie das Datei-Caching aktivieren. Weitere Informationen zu parallelen Downloads und zur Konfiguration der zugehörigen Eigenschaften finden Sie unter Leseleistung durch parallele Downloads verbessern.
--file-cache-max-parallel-downloads VALUE

Die maximale Anzahl von Goroutinen, die zu einem bestimmten Zeitpunkt für alle Downloadjobs von Dateien erstellt werden können. Der Standardwert ist doppelt so hoch wie die Anzahl der CPU-Kerne auf Ihrem Computer oder 16, je nachdem, welcher Wert höher ist. Wenn Sie kein Limit angeben möchten, geben Sie den Wert -1 ein.
--file-mode VALUE Gibt Berechtigungs-Bits für Dateien in Oktal an. Der Wert muss zwischen 000 und dem maximalen Wert 777 liegen. Der Standardwert ist 644.
--foreground BOOLEAN Führt den Befehl gcsfuse im Vordergrund aus. Der Standardwert ist false.
--gid VALUE Gibt den Gruppen-ID-Inhaber (GID) aller Inodes an. Der Wert muss eine Ganzzahl sein. Der Standardwert ist -1.
--help oder -h Zeigt Hilfe zu Cloud Storage FUSE an.
version oder -v Zeigt die von Ihnen installierte Cloud Storage FUSE-Version an.
--http-client-timeout VALUE Gibt an, wie lange der Cloud Storage FUSE-HTTP-Client auf die Antwort vom Server warten kann, bevor eine Zeitüberschreitung auftritt. Der Wert muss eine Zeitdauer sein. Beispiel: 1h10m10s. Der Standardwert ist 0s, d. h. kein Zeitlimit.
--ignore-interrupts VALUE 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. Mögliche Werte sind true und false. Der Standardwert ist true.
--implicit-dirs BOOLEAN

Umfasst implizit Ordner und verwaltete Ordner.

Weitere Informationen finden Sie in der Dokumentation zu Dateien und Verzeichnissen in GitHub. Der Standardwert ist false.
--kernel-list-cache-ttl-secs VALUE 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. Der Standardwert ist 0, wodurch das Listen-Caching deaktiviert wird.

Um das Flag --kernel-list-cache-ttl-secs festzulegen, geben Sie eine positive Ganzzahl in Sekunden an, damit die Verzeichnislistenantwort im Seiten-Cache des Kernels bleibt. Um den Ablauf von Einträgen zu umgehen und immer die Listenaantwort aus dem Cache zurückzugeben, wenn sie verfügbar ist, geben Sie den Wert -1 ein.
--key-file VALUE 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.
--limit-bytes-per-sec VALUE Gibt das Bandbreitenlimit an, bei dem Cloud Storage FUSE Daten aus Cloud Storage lesen kann, gemessen über ein 30-Sekunden-Fenster. Der Wert muss eine Gleitkommazahl sein. Der Standardwert ist -1, d. h. kein Limit angegeben.
--limit-ops-per-sec VALUE Gibt ein Limit für Vorgänge pro Sekunde an, die über ein 30-Sekunden-Fenster gemessen werden. Der Wert muss eine Gleitkommazahl sein. Der Standardwert ist -1, d. h. kein Limit angegeben.
--log-file VALUE Gibt die Datei zum Speichern von Logs an, die von Fluentd geparst werden können. Wenn nicht angegeben, werden Nur-Text-Logs in stdout ausgegeben, wenn Cloud Storage FUSE im Vordergrund ausgeführt wird, oder in syslog, wenn Cloud Storage FUSE im Hintergrund ausgeführt wird.
--log-format VALUE Gibt das Format der Protokolldatei an. Der Wert muss entweder text oder json sein. Der Standardwert ist json.
--log-rotate-backup-file-count VALUE Die maximale Anzahl der rotierten Logdateien, die beibehalten werden sollen, ausgenommen die aktive Datei, in die Logs geschrieben werden. Wenn der Wert auf 0 festgelegt ist, werden alle gewechselten Protokolldateien beibehalten. Wenn dieses Feld nicht angegeben ist, wird standardmäßig 10 verwendet.
--log-rotate-compress BOOLEAN Ein boolescher Wert, der angibt, ob gedrehte Protokolldateien mit gzip komprimiert werden. Wenn dieses Flag nicht angegeben ist, wird standardmäßig true verwendet.
--log-rotate-max-file-size-mb VALUE Die maximale Größe in Megabyte (MB), die Logdateien erreichen können, bevor sie rotiert werden. Der Mindestwert beträgt 1. Wenn dieses Feld nicht angegeben ist, wird standardmäßig 512 verwendet.
--log-severity ENUM

Der Schweregrad der Logs, die Cloud Storage FUSE generieren soll, ausgedrückt als Enum. Die Schweregrade werden vom niedrigsten zum höchsten Schweregrad sortiert:

  • trace
  • debug
  • info
  • warning
  • error

Wenn Sie einen Schweregrad angeben, generiert Cloud Storage FUSE Logs mit gleichem oder höherem Schweregrad. Wenn Sie beispielsweise warning angeben, generiert Cloud Storage FUSE Logs für Warnungen und Fehler. Sie können auch off angeben, um das gesamte Logging zu deaktivieren. Wenn Sie --debug_mutex als Teil Ihres Befehls angeben, wird die Wichtigkeitsstufe automatisch auf trace gesetzt und log-severity überschrieben.

Wenn dieses Feld nicht angegeben ist, wird standardmäßig info verwendet.
--max-conns-per-host VALUE Gibt die maximal zulässige Anzahl von TCP-Verbindungen pro Server an. Dies wird wirksam, wenn --client-protocol auf http1 festgelegt ist. Der Wert muss zwischen 0 und 2147483647 liegen. Der Standardwert ist 0, was bedeutet, dass es keine Einschränkungen für TCP-Verbindungen gibt, mit Ausnahme der Einschränkungen, die durch die Spezifikationen Ihres Computers festgelegt sind.
--max-idle-conns-per-host VALUE Gibt die maximal zulässige Anzahl inaktiver Verbindungen pro Server an. Der Wert muss zwischen 0 und 2147483647 liegen. Der Standardwert ist 100.
--max-retry-sleep VALUE Gibt die maximale Dauer an, die Cloud Storage FUSE in einer Wiederholungsschleife mit exponentiellem Backoff warten darf. Der Wert muss eine Zeitdauer sein. Beispiel: 1h5m50s (1 Stunde, 5 Minuten und 50 Sekunden) oder 60s (60 Sekunden). Wenn die Backoff-Dauer die angegebene maximale Dauer überschreitet, wird der Wiederholungsversuch mit der angegebenen maximalen Dauer fortgesetzt. Der Standardwert ist 30s.
--metadata-cache-ttl-secs VALUE

Definiert die Gültigkeitsdauer (TTL) in Sekunden der im Cache gespeicherten Metadateneinträge.

  • Wenn Sie einen TTL-Ablauf umgehen und die Datei aus dem Cache bereitstellen möchten, wann immer sie verfügbar ist, geben Sie den Wert -1 an.
  • Wenn Sie die aktuellste Datei verwenden möchten, geben Sie den Wert 0 an. 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.

Wenn dieses Feld nicht angegeben ist, wird standardmäßig 60 (60 Sekunden) verwendet.
-o VALUE

Gibt zusätzliche systemspezifische Bereitstellungsoptionen an.

Die meisten generischen Bereitstellungsoptionen in FUSE (z. B. rw, suid und ro) werden von Cloud Storage FUSE unterstützt und zusammen mit dem Flag -o übergeben. Weitere Informationen finden Sie in der Linux FUSE-Dokumentation.
--only-dir VALUE Stellt nur ein bestimmtes Verzeichnis in einem Bucket bereit.
--rename-dir-limit VALUE Ermöglicht das Umbenennen von Verzeichnissen, die weniger Nachfolgerelemente als das angegebene Limit enthalten. Der Wert muss zwischen 0 und 2147483647 liegen. Der Standardwert ist 0.
--retry-multiplier VALUE Gibt den Multiplikator für den exponentiellen Backoff zwischen aufeinanderfolgenden Wiederholungsversuchen an. Der Wert muss eine Gleitkommazahl sein. Der Standardwert ist 2.
--reuse-token-from-url Gibt an, ob das von --token-url abgerufene Token wiederverwendet werden soll. Der Standardwert ist true.
--sequential-read-size-mb VALUE Gibt die Blockgröße der aus Cloud Storage herunterzuladenden Daten in Megabyte (MB) an. Der Wert muss zwischen 1 und 1024 liegen. Der Standardwert ist 200.
--stackdriver-export-interval VALUE Exportiert Messwerte nach Stackdriver mit dem angegebenen Intervall. Der Wert muss eine Zeitdauer sein. Beispiel: 1h10m10s. Der Standardwert ist 0s. Damit wird kein Export angegeben.
--stat-cache-capacity VALUE Eingestellt. Gibt die Anzahl der Einträge an, die der Statistik-Cache enthalten kann. Dies wirkt sich auf den Arbeitsspeicherverbrauch aus. Der Wert muss eine Ganzzahl sein. Der Standardwert ist 4096.

Dieses Flag wurde durch --stat-cache-max-size-mb ersetzt. Verwenden Sie das Flag --stat-cache-max-size-mb, um die maximale Größe in Mebibyte (MiB) anzugeben, die der Statistik-Cache verwenden kann.
--stat-cache-max-size-mb VALUE

Die maximale Größe in Mebibyte (MiB), die der Statistik-Cache verwenden kann. Der Statistik-Cache wird immer vollständig im Arbeitsspeicher gehalten.

  • Geben Sie den Wert 32 an,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 10 MiB pro weitere 6.000 Dateien. Der Statistik-Cache belegt dann durchschnittlich 1.500 MiB pro Datei.
  • Wenn der Statistik-Cache so viel Arbeitsspeicher wie nötig verwenden soll, also kein Limit festgelegt werden soll, geben Sie den Wert -1 an.
  • Geben Sie 0 an, um den Statistik-Cache zu deaktivieren.

Wenn dieses Feld nicht angegeben ist, wird standardmäßig 32 verwendet.
--stat-cache-ttl VALUE Eingestellt. Gibt an, wie lange StatObject-Ergebnisse und Inode-Attribute im Cache gespeichert werden sollen. Der Standardwert beträgt 60s (60 Sekunden).

Dieses Flag wurde durch --metadata-cache-ttl-secs ersetzt. Verwenden Sie das Flag --metadata-cache-ttl-secs, um die Gültigkeitsdauer (TTL) in Sekunden für im Cache gespeicherte Metadateneinträge anzugeben.
--temp-dir VALUE Gibt einen Pfad zum temporären Verzeichnis an, in dem Schreibvorgänge vor dem Hochladen in Cloud Storage bereitgestellt werden. Der Standardwert ist Ihr Systemstandard, wahrscheinlich /tmp.
--token-url VALUE Gibt eine URL zum Abrufen eines Zugriffstokens an, wenn --key-file nicht vorhanden ist.
--type-cache-ttl VALUE Eingestellt. Gibt an, wie lange die Zuordnung zwischen Namen und Dateien oder Verzeichnissen in Verzeichnis-Inodes im Cache gespeichert werden soll. Diese Option wurde durch die Option --metadata-cache-ttl-secs ersetzt. Mit der Option --metadata-cache-ttl-secs können Sie die Gültigkeitsdauer (TTL) von Metadateneinträgen von Statistik- und Typ-Caches angeben. Der Standardwert für --metadata-cache-ttl-secs beträgt 60s (60 Sekunden).
--type-cache-max-size-mb VALUE

Die maximale Größe in MiB pro Verzeichnis, die der Typcache verwenden kann. Der Typ-Cache wird immer vollständig im Arbeitsspeicher gehalten.

  • Geben Sie den Wert 4 an,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.
  • Wenn der Typcache so viel Arbeitsspeicher wie nötig verwenden soll, also kein Limit festgelegt werden soll, geben Sie den Wert -1 an.
  • Wenn Sie den Typ-Cache deaktivieren möchten, geben Sie den Wert 0 an.

Wenn dieses Feld nicht angegeben ist, wird standardmäßig 4 verwendet.
--uid VALUE Gibt den Inhaber der User Identifier (UID) aller Inodes an. Der Wert muss eine Ganzzahl sein. Der UID-Standardwert ist -1.