ossfs 2.0 の構成ファイルを作成する際には、特定のシナリオにおけるさまざまなマウント要件に合わせて、さまざまなパラメータを柔軟に構成できます。この構成ファイルを使用すると、バケットをさまざまなローカル ファイルシステムにマウントできます。
基本オプション
カテゴリ | オプション | 必須 | 説明 | デフォルト値 |
基本的なバケット構成 | oss_endpoint | はい | バケットのドメイン名。 | なし |
oss_bucket | はい | バケットの名前。 | なし | |
アクセス認証情報構成 | oss_access_key_id | はい | AccessKey ID。 | なし |
oss_access_key_secret | はい | AccessKey シークレット。 | なし |
共通オプション
カテゴリ | オプション | 必須 | 説明 | デフォルト値 |
バケット構成 | oss_bucket_prefix | いいえ | ローカル ファイルシステムにマウントするディレクトリ。 | なし |
oss_region | いいえ | バケットが配置されているリージョンの ID。V4 署名アルゴリズムに使用されます。このオプションを指定しない場合、V1 署名アルゴリズムが使用されます。 | なし | |
キャッシュ構成 | attr_timeout | いいえ | オブジェクト メタデータ キャッシュの有効期間。単位：秒。 | 60 |
negative_timeout | いいえ | 無効なディレクトリエントリの有効期間。単位：秒。 | 0 | |
ログ構成 | log_level | いいえ | ログ出力のレベル。有効な値：info および debug。 | info |
log_dir | いいえ | ログが保存されるディレクトリ。 | /tmp/ossfs2 | |
実行モード | f | いいえ | フォアグラウンド モードを使用するかどうかを指定します。 | false |
d | いいえ | フォアグラウンド モードを使用し、fuse を有効にするかどうかを指定します。 | false | |
マウント モード | ro | いいえ | 読み取り専用モードを使用するかどうかを指定します。 | false |
権限 | gid | いいえ | 構成すると、マウント ポイント以下のすべてのオブジェクトとディレクトリの GID プロパティが構成された値に設定されます。 | マウント操作を実行するユーザーの GID。 |
uid | いいえ | 構成すると、マウント ポイント以下のすべてのオブジェクトとディレクトリの UID プロパティが構成された値に設定されます。 | マウント操作を実行するユーザーの UID。 | |
file_mode | いいえ | 構成すると、マウント ポイント以下のすべてのオブジェクトの権限プロパティが構成された値に設定されます。 | 0777 | |
dir_mode | いいえ | 構成すると、マウント ポイント以下のすべてのディレクトリの権限プロパティが構成された値に設定されます。 | 0777 | |
allow_other | いいえ | allow_other=true を設定すると、ルート以外のユーザーがマウントされたファイルシステムにアクセスできるようになります。アクセスは、オブジェクトの権限プロパティに基づく権限チェックの対象となります。 | true |
詳細オプション
カテゴリ | オプション | 必須 | 説明 | デフォルト値 |
アップロード構成 | upload_buffer_size | いいえ | パートのサイズ。単位：バイト。このオプションは、バケットにアップロードできるローカル ファイルのサイズを決定します。ローカル ファイルのサイズ = upload_buffer_size × 10000。 | 8388608 |
upload_concurrency | いいえ | 同時にアップロードできるパートの数。 | 64 | |
sync_upload | いいえ | sync_upload オプションを true に設定すると、ローカル ファイルを閉じたときに、ローカル ファイルがアップロードされた後にレスポンスが返されます。 | true | |
ダウンロード/プリフェッチ構成 | prefetch_concurrency | いいえ | ossfs 2.0 のダウンロードのプリフェッチ同時実行数。単一オブジェクトの最小プリフェッチ同時実行数は min(64, prefetch_concurrency) です。 | 256 |
prefetch_chunk_size | いいえ | プリフェッチされるチャンクのサイズ。単位：バイト。 | 8388608 | |
prefetch_chunks | いいえ | プリフェッチされるチャンクの数。このオプションを指定しない場合、prefetch_concurrency オプションの値の 3 倍が使用されます。 | 0 (prefetch_concurrency オプションの値に基づいて自動的に構成されます) | |
メモリ管理構成 | total_mem_limit | いいえ | 合計メモリ使用量制限。単位：バイト。このオプションを指定すると、upload_concurrency および prefetch_concurrency オプションの値がそれに応じて調整されます。 このオプションが構成されていない場合、 デフォルトでは、total_mep_limit は、16 GB 以下の RAM (Random Access Memory) を搭載したホストのシステム メモリの半分に設定されます。16 GB を超えるメモリを搭載したシステムの場合、デフォルトの制限は適用されません。 | 0 |
オブジェクト検証/メタデータ構成 | enable_crc64 | いいえ | CRC-64 を有効にするかどうかを指定します。 | true |
close_to_open | いいえ | close-to-open 機能を有効にするかどうかを指定します。 close_to_open オプションを true に設定すると、オブジェクトが開かれたときに、システムは GetObjectMeta リクエストを送信して OSS からリアルタイムのオブジェクト メタデータを取得します。 デフォルトでは、このオプションは false に設定されています。オブジェクトを開くときに、オブジェクト メタデータのキャッシュ有効期間に基づいて、GetObjectMeta リクエストを送信するかどうかを決定できます。 close_to_open オプションを true に設定すると、オブジェクトが開かれるたびに OSS にリクエストが強制的に送信されます。これにより、多数の小さなオブジェクトが読み取られる場合にアクセス レイテンシが大幅に増加します。 | false | |
オブジェクト操作構成 | rename_dir_limit | いいえ | 単一の名前変更操作における、ソース ディレクトリ内のすべてのオブジェクトとサブディレクトリの最大数。ソース ディレクトリ内のすべてのオブジェクトとサブディレクトリの実際の数が上限を超えると、名前変更操作はエラーを報告します。 | 2000000 |
enable_appendable_object | いいえ | enable_appendable_object オプションを true に設定した後、AppendObject 操作を呼び出してオブジェクトをアップロードする場合、オブジェクトのアップロード プロセス中にオブジェクトを読み取ることができます。 | false | |
appenable_object_autoswitch_threshold | いいえ | enable_appendable_object を有効にした後、このオプションのサイズ (バイト単位) 以下の OSS 内の追加不可オブジェクトは、追加アップロード操作中に自動的に追加可能オブジェクトに変換されます。 | 0 | |
リクエスト タイムアウト構成 | oss_request_timeout_ms | いいえ | OSS に送信されるリクエストのタイムアウト期間。単位：ミリ秒。 | 60000 |