gcsfuse CLI

--anonymous-access

--app-name

--billing-project

--cache-dir

ファイル キャッシュを有効にして、ファイル キャッシュ データを格納するディレクトリを指定します。

--client-protocol

• http1: HTTP/1.1
• http2: HTTP/2
• grpc: gRPCCloud Storage FUSE で gRPC を使用するには、Cloud Storage FUSE バージョン 2.10.0 以降を使用することをおすすめします。

--cloud-metrics-export-interval-secs

指定した間隔で指標を Cloud Monitoring にエクスポートします。

--config-file

--custom-endpoint

--debug_fuse（非推奨）

--debug_gcs（非推奨）

--debug_invariants

--debug_mutex

--dir-mode

--enable-nonexistent-type-cache

--enable-streaming-writes

--file-cache-max-size-mb

ファイル キャッシュで使用できる最大サイズ（MiB 単位）を指定し、ファイル キャッシュがマウントされたディレクトリ内で使用できる合計容量を制限できます。

• 整数
• -1: cache-dir に指定したディレクトリのキャッシュで使用可能な容量をすべて使用するように指定します。これは、cache-dir が渡された場合にのみデフォルトになります。
• 0: ファイル キャッシュを無効にします。

--file-cache-cache-file-for-range-read

--file-cache-download-chunk-size-mb

--file-cache-enable-parallel-downloads

ファイル キャッシュ ディレクトリをプリフェッチ バッファとして使用し、複数のワーカーを使用してファイルの複数の部分を並列でダウンロードすることで、サイズの大きいファイルの読み取りを高速化します。

ファイル キャッシュを有効にすると、並列ダウンロードが自動的に有効になります。ファイル キャッシュの詳細については、Cloud Storage FUSE ファイル キャッシュを使用するをご覧ください。

並列ダウンロードと、そのサポート プロパティの構成方法について詳しくは、並列ダウンロードをご覧ください。

--file-cache-max-parallel-downloads

• 整数
• -1: 無制限の並列ダウンロードを指定します。
• 0: 並列ダウンロードを無効にします。--enable-parallel-downloads が渡されていない場合、または false として渡された場合にのみ使用できます。
• 0: 上限を指定しません。Cloud Storage FUSE は、マシンの構成で指定された、生成できる goroutine の最大数に基づいて、内部で値を制限します。

--file-cache-parallel-downloads-per-file

--file-mode

--foreground

--gid

• GID を表す整数。
• -1: 呼び出し元の GID が使用されます。

--help

--version

--http-client-timeout

--ignore-interrupts

--implicit-dirs

--kernel-list-cache-ttl-secs

• 秒を表す整数（例: 10（10 秒））。
• 0: リスト キャッシュ保存を無効にします。
• -1: エントリの有効期限をバイパスし、キャッシュから利用可能な場合に常にキャッシュからリスト レスポンスを返します。

--key-file

--limit-bytes-per-sec

--limit-ops-per-sec

--log-file

--log-format

• text
• json

--log-rotate-backup-file-count

• 整数
• 0: ローテーションされたすべてのログファイルを保持します。

--log-rotate-compress

--log-rotate-max-file-size-mb

--log-severity

Cloud Storage FUSE でログを生成する重大度。重大度は、低いものから高いものの順に並べられています。たとえば、warning を指定すると、Cloud Storage FUSE は警告とエラーのログを生成します。通常は、重大度 info を使用することをおすすめします。

• off: すべてのロギングを無効にします。
• error: Cloud Storage FUSE がオペレーションを完了できない、またはマウントの失敗、権限エラー、重大な入出力（I/O）のエラーなどの障害を示す深刻な問題に関するメッセージが含まれます。
• warning: 重大ではないものの、対処しないと問題につながる可能性のある問題を示すメッセージが含まれます。潜在的な問題には、非致命的な接続の問題、非推奨の警告、パフォーマンスのわずかな低下を引き起こす可能性のあるリソースの競合、一時的なエラーの再試行などがあります。この重大度レベルには、重大度レベル error で提供される情報も含まれます。
• info: 起動メッセージやシャットダウン メッセージ、マウント オペレーションの成功、進行状況の更新、構成設定などの一般的なロギング情報が含まれます。この重大度レベルには、重大度レベル warning と error に関する情報も含まれます。
• debug: 起動メッセージやシャットダウン メッセージ、マウント オペレーションの成功、進行状況の更新、構成設定などのロギング情報が含まれます。この重大度レベルには、重大度レベル info、warning、error で提供される情報も含まれます。
• trace: 各 Cloud Storage FUSE オペレーションと関数呼び出しの詳細が含まれ、カーネル FUSE ドライバと Cloud Storage との gcsFUSE のインタラクションが示されています。この重大度レベルには、重大度レベル debug、info、warning、error で提供される詳細も含まれます。

--max-conns-per-host

--max-idle-conns-per-host

--max-retry-sleep

--metadata-cache-negative-ttl-secs

ネガティブな統計情報キャッシュ エントリの有効期間（TTL）を秒単位で定義します。このエントリには、存在しないファイルの結果がキャッシュに保存されます。

• 秒を表す整数（例: 10（10 秒））。
• 0: ネガティブな統計情報キャッシュを無効にします。
• -1: 無制限のネガティブな統計情報キャッシュを許可し、TTL の有効期限を無効にします。

--metadata-cache-ttl-secs

• 秒を表す整数（例: 30（30 秒））。
• -1: TTL の有効期限をバイパスし、キャッシュから利用可能な場合にファイルを配信します。
• 0: 最新のファイルを使用します。この値を使用すると、Get メタデータ呼び出しが行われ、キャッシュ内のファイルのオブジェクトの世代が Cloud Storage に保存されているものと一致していることを確認します。詳細については、キャッシュの無効化の構成をご覧ください。

-o

• rw: 読み取り / 書き込みとしてマウントします。
• ro: 読み取り専用としてマウントします。

--only-dir

--prometheus-port

指定されたポートと /metrics パスで Prometheus 指標エンドポイントを公開します。

--rename-dir-limit

--retry-multiplier

--reuse-token-from-url

--sequential-read-size-mb

--stat-cache-capacity（非推奨）

--stat-cache-max-size-mb

• 整数。次のようにすることをおすすめします。
• ワークロードのファイル数が 20,000 以下の場合は 32 にします。
• ワークロードのファイル数が 20,000 を超える場合は、6,000 ファイルごとにサイズを 10 ずつ増やします。統計キャッシュはファイルあたり平均 1,500 MiB を使用します。
• -1: 上限を設定しません。統計情報キャッシュは必要な量のメモリを使用します。
• 0: 統計情報キャッシュを無効にします。

--stat-cache-ttl（非推奨）

--temp-dir

--token-url

--type-cache-ttl（非推奨）

--type-cache-max-size-mb

• 整数。次のようにすることをおすすめします。
  • マウントするバケットの 1 つのディレクトリ内にあるファイルの最大数が 20,000 以下の場合は 4 にします。
  • マウントする 1 つのディレクトリ内のファイルの最大数が 20,000 を超える場合は、5,000 ファイルごとに値を 1 増やします（ファイルあたり平均約 200 バイト）。
• -1: 上限を指定せず、タイプ キャッシュが必要な量のメモリを使用できるようにします。
• 0: タイプ キャッシュを無効にします。

--uid

• UID を表す整数。
• -1: 呼び出し元の UID が使用されます。

--write-global-max-blocks

すべてのファイルでストリーミング書き込みに使用できるデータチャンクの最大数を指定します。各ファイルはデフォルトで 32 MiB のデータチャンクを 1 つ使用します。

• 整数
• 0: ストリーミング書き込みを無効にします。
• -1: 値を無制限のチャンクに設定します。

• リソースが制限されている低仕様のマシンのデフォルト値: 4
• リソース量の多い高仕様マシンのデフォルト値: 1600