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

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.

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“.
--client-protocol VALUE Gibt das Protokoll an, das für die Kommunikation mit dem Cloud Storage-Backend verwendet wird. Der Wert kann 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 an dem von Ihnen angegebenen benutzerdefinierten Endpunkt nicht unterstützt wird, setzen Sie das Flag --anonymous-access auf true, um die Authentifizierung zu umgehen.
--debug_fuse_errors Wenn er ausgeschlossen wird, wird der Wert als "Falsch" ausgewertet und verhindert, dass FUSE-Fehler in der Konsole (falls--foreground wird verwendet) oder der Logdatei (falls --log-file verwendet wird) protokolliert werden.
--debug_fuse Aktiviert die FUSE-bezogene Debugging-Ausgabe. Wenn diese Option angegeben ist, wird der Schweregrad der Logs automatisch auf trace gesetzt, einschließlich Trace-Logs, Debug-Logs, Informationslogs, Warnlogs und Fehlerlogs.
--debug_gcs Gibt Informationen zu Cloud Storage-Anfragen und Zeitangaben aus. Wenn diese Option angegeben ist, wird der Schweregrad der Logs automatisch auf trace gesetzt, einschließlich Trace-Logs, Debug-Logs, Info-Logs, Warn-Logs und Fehler-Logs.
--debug-invariants Fehler, wenn interne Invarianten verletzt werden.
--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-Logs, Debug-Logs, Info-Logs, Warn-Logs und Fehler-Logs.
--dir-mode VALUE Berechtigungs-Bits für Verzeichnisse in Oktal. Der Standardwert ist 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.
--experimental-enable-json-read Gibt Cloud Storage FUSE an, um die Cloud Storage JSON API für Lesevorgänge zu verwenden. Standardmäßig werden Lesevorgänge mit der Cloud Storage XML API ausgeführt.
--experimental-opentelemetry-collector-address VALUE Exportiert Messwerte in den OpenTelemetry Collector unter der angegebenen Adresse. Experimentell.
--file-mode VALUE Gibt Berechtigungs-Bits für Dateien in Oktal an. Der Standardwert ist 644.
--foreground Führt den Befehl gcsfuse im Vordergrund aus.
--gid VALUE Gibt den Gruppen-ID-Inhaber (GID) aller Inodes an. Der GID-Standardwert ist -1.
--help oder -h Zeigt Hilfe zu Cloud Storage FUSE 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 Standardwert ist 0s, d. h. kein Zeitlimit.
--implicit-dirs

Umfasst implizit Ordner und verwaltete Ordner.

Weitere Informationen finden Sie in der Dokumentation zu Dateien und Verzeichnissen in GitHub.
--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 Standardlimitwert ist -1, d. h. kein Limit.
--limit-ops-per-sec VALUE Gibt ein Limit für Vorgänge pro Sekunde an, die über ein 30-Sekunden-Fenster gemessen werden. Der Standardlimitwert 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 kann text oder json sein. Der Standardwert ist json.
--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 Standardwert ist 0. Damit wird angegeben, dass für TCP-Verbindungen keine Begrenzung gilt, mit Ausnahme der Einschränkungen, die in den Spezifikationen Ihres Computers festgelegt sind.
--max-idle-conns-per-host VALUE Gibt die maximal zulässige Anzahl inaktiver Verbindungen pro Server an. 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. Wenn die Backoff-Dauer die angegebene maximale Dauer überschreitet, wird der Wiederholungsversuch mit der angegebenen maximalen Dauer fortgesetzt. Der Standardlimitwert ist 30s (30 Sekunden).
-o VALUE

Gibt zusätzliche systemspezifische Bereitstellungsoptionen an.

Die meisten generischen Bereitstellungsoptionen in FUSE (z. B. rw und suid) werden von Cloud Storage FUSE unterstützt und zusammen mit dem Flag -o übergeben. Weitere Informationen finden Sie in der Linux FUSE-Dokumentation.

-o ro Stellt einen Bucket als schreibgeschützt bereit.
--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 Standardwert ist 0.
--retry-multiplier VALUE Gibt die Wartezeit zwischen zwei aufeinanderfolgenden Wiederholungsversuchen an.
--reuse-token-from-url Wenn dieses Flag angegeben ist, wird "True" ausgewertet und es wird angegeben, dass das von --token-url abgerufene Token verwendet wird. Wird es ausgeschlossen, wird "False" ausgewertet und es wird angegeben, dass das von --token-url abgerufene Token nicht wiederverwendet werden soll.
--sequential-read-size-mb VALUE Gibt die Blockgröße der aus Cloud Storage herunterzuladenden Daten in Megabyte (MB) an.
--stackdriver-export-interval VALUE Exportiert Messwerte nach Stackdriver mit dem angegebenen Intervall. 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 Standardwert ist 4096.

Anstelle dieses Flags verwenden Sie das Feld metadata-cache: stat-cache max-size in einer Konfigurationsdatei, um die maximale Größe des Statistik-Cache festzulegen. Weitere Informationen finden Sie in der Cloud Storage FUSE-Konfigurationsdatei.
--stat-cache-ttl VALUE Eingestellt. Gibt an, wie lange StatObject-Ergebnisse und Inode-Attribute im Cache gespeichert werden sollen. Der Standardwert ist 60s.

Anstelle dieses Flags verwenden Sie das Feld metadata-cache: ttl-secs in einer Konfigurationsdatei, um die Gültigkeitsdauer (TTL) von Metadateneinträgen von Statistik- und Typ-Caches anzugeben. Weitere Informationen finden Sie in der Cloud Storage FUSE-Konfigurationsdatei.
--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. Der Standardwert ist 60s.

Verwenden Sie stattdessen das Feld metadata-cache: ttl-secs, um die Gültigkeitsdauer (TTL) von Metadateneinträgen von Statistik- und Typ-Caches anzugeben. Weitere Informationen finden Sie in der Cloud Storage FUSE-Konfigurationsdatei.
--temp-dir value 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.
--uid VALUE Gibt den Inhaber der User Identifier (UID) aller Inodes an. Der UID-Standardwert ist -1.
--version oder -v Zeigt die von Ihnen installierte Cloud Storage FUSE-Version an.