ossfs 2.0 の設定ファイルを作成する際に、さまざまなパラメーターを設定して、特定のマウント要件を満たすことができます。このファイルを使用すると、さまざまなビジネスニーズに合わせて、OSS バケットをファイルシステムとしてさまざまな方法でマウントできます。
基本的な設定項目
カテゴリ | 設定項目 | 必須 | 説明 | デフォルト値 | サポートされているバージョン |
バケットの基本設定 | oss_endpoint | はい | バケットへのアクセスに使用するエンドポイント。 | なし | v2.0.0 以降 |
oss_bucket | はい | バケットの名前。 | なし | v2.0.0 以降 | |
アクセス資格情報の設定 | oss_access_key_id | 条件付き必須 | AccessKey ID です。AccessKey 認証を使用する場合、このパラメーターは必須です。 | なし | v2.0.0 以降 |
oss_access_key_secret | 条件付き必須 | AccessKey Secret です。AccessKey 認証を使用する場合、このパラメーターは必須です。 | なし | v2.0.0 以降 | |
ram_role | 条件付き必須 | ECS RAM ロール。このパラメーターは、ECS RAM ロール認証に必要です。 | なし | v2.0.2 以降 | |
credential_process | 条件付き必須 | 外部プロセスを実行してアクセス認証情報を取得するためのコマンド。 このパラメーターは外部プロセス認証に必須です。 | なし | v2.0.5 以降 |
一般的な設定項目
カテゴリ | 設定項目 | 必須 | 説明 | デフォルト値 | サポートされているバージョン |
バケット設定 | oss_bucket_prefix | いいえ | バケット内の特定のフォルダをマウントします。 | 空 | v2.0.0 以降 |
oss_region | いいえ | バケットのリージョン ID。これは OSS V4 署名アルゴリズムに使用されます。このパラメーターを指定しない場合、OSS V1 署名アルゴリズムが使用されます。 | 空 | v2.0.0 以降 | |
キャッシュ設定 | attr_timeout | いいえ | ファイルメタデータキャッシュの生存時間 (TTL) (秒単位)。 | 60 | v2.0.0 以降 |
negative_timeout | いいえ | 無効なディレクトリエントリキャッシュの TTL (秒単位)。 | 0 | v2.0.0 以降 | |
readdirplus | いいえ | readdirplus 機能を有効にします。有効にすると、readdir 操作中にファイルメタデータキャッシュが同期的に構築されます。これにより、より多くのメモリが消費されます。 | true | v2.0.0 以降 | |
ログ設定 | log_level | いいえ | ログレベル。有効な値は info と debug です。 | info | v2.0.0 以降 |
log_dir | いいえ | ログファイルを保存するフォルダ。 | /tmp/ossfs2 | v2.0.0 以降 | |
log_file_max_size | いいえ | 単一のログファイルの最大サイズ (バイト単位)。 | 67108864 | v2.0.3 以降 | |
log_file_max_count | いいえ | 保持するログファイルの最大数。 | 8 | v2.0.3 以降 | |
実行モード | f | いいえ | フォアグラウンドで実行するかどうかを指定します。 | false | v2.0.0 以降 |
d | いいえ | フォアグラウンドで実行し、FUSE デバッグログを有効にするかどうかを指定します。 | false | v2.0.0 以降 | |
マウント モード | ro | いいえ | ファイルシステムを読み取り専用モードでマウントします。 | false | v2.0.0 以降 |
権限設定 | gid | いいえ | 設定した場合、マウントポイント配下のすべてのファイルとフォルダの GID プロパティがこの値に設定されます。 | ファイルシステムをマウントするユーザーの GID | v2.0.1 以降 |
uid | いいえ | 設定した場合、マウントポイント配下のすべてのファイルとフォルダの UID プロパティがこの値に設定されます。 | ファイルシステムをマウントするユーザーの UID | v2.0.1 以降 | |
file_mode | いいえ | 設定した場合、マウントポイント配下のすべてのファイルの権限プロパティがこの値に設定されます。 | 0777 | v2.0.1 以降 | |
dir_mode | いいえ | 設定した場合、マウントポイント配下のすべてのフォルダの権限プロパティがこの値に設定されます。 | 0777 | v2.0.1 以降 | |
allow_other | いいえ | `allow_other` を `true` に設定すると、root 以外のユーザーがマウントポイント配下のファイルにアクセスできます。アクセスはファイル権限に基づいて検証されます。 | true | v2.0.1 以降 |
詳細設定
カテゴリ | 設定項目 | 必須 | 説明 | デフォルト値 | サポートされているバージョン |
ネットワーク設定 | bind_ips | いいえ | 指定された IP アドレスのリストを OSS にアクセスするための送信元 IP としてバインドします。IP アドレスはカンマで区切ります。例：192.168.0.1,192.168.0.2。IP アドレスのリストを指定することで、OSS へのアクセスに使用するネットワークインターフェイスカード (NIC) を制御できます。これにより、マルチ NIC 環境での総スループットを向上させることができます。 | 空 | v2.0.3 以降 |
アップロード設定 | upload_buffer_size | いいえ | マルチパートアップロードバッファーのサイズ (単位：バイト)。これはパートサイズでもあります。このパラメーターは、書き込み可能なファイルの最大サイズを決定します。最大ファイルサイズは `upload_buffer_size` × 10,000 として計算されます。 | 8388608 | v2.0.0 以降 |
upload_concurrency | いいえ | マルチパートアップロードの同時実行数。 | 64 | v2.0.0 以降 | |
sync_upload | いいえ | 有効にすると、ファイルが閉じられたときに、システムはファイルが完全にアップロードされるのを待ってから戻ります。 | true | v2.0.0 以降 | |
ダウンロード/プリフェッチ設定 | prefetch_concurrency | いいえ | ダウンロードプリフェッチのグローバルな同時実行数。 | 256 | v2.0.0 以降 |
prefetch_concurrency_per_file | いいえ | ファイルハンドルごとのダウンロードプリフェッチの同時実行数。 | 64 | v2.0.0 以降 | |
prefetch_chunk_size | いいえ | プリフェッチチャンクのサイズ (単位：バイト)。 | 8388608 | v2.0.0 以降 | |
prefetch_chunks | いいえ | プリフェッチチャンクの数。設定しない場合、デフォルト値は `prefetch_concurrency` の値の 3 倍になります。-1 に設定すると、プリフェッチメモリは制限されません。各ファイルハンドルは、プリフェッチに十分なメモリを取得できます。 | 0 (prefetch_concurrency に基づいて自動的に設定) | v2.0.0 以降 | |
メモリ管理設定 | total_mem_limit | いいえ | 合計メモリ制限 (単位：バイト)。設定すると、アップロードとプリフェッチの同時実行数はこの制限に基づいて自動的に調整されます。 このオプションを設定しない場合、データ読み取りプリフェッチには 16 GB 以下のメモリを搭載した環境では、`total_mem_limit` のデフォルト値はシステムメモリの半分です。16 GB を超えるメモリを搭載した環境では、制限はありません。 | 0 | v2.0.0 以降 |
max_inode_cache_count | いいえ | キャッシュされたメタデータエントリの数をアクティブに制御します。
| 0 | v2.0.4 以降 | |
ファイル検証/メタデータ設定 | enable_crc64 | いいえ | ファイルの書き込みに対して巡回冗長検査 (CRC) を有効にするかどうかを指定します。 | true | v2.0.0 以降 |
close_to_open | いいえ | close-to-open セマンティクスをサポートします。このオプションを有効にすると、ファイルを開くときに GetObjectMeta リクエストが送信され、OSS からファイル情報が取得されます。これにより、リアルタイムのメタデータが保証されます。 デフォルトでは、このオプションは無効です。ファイルを開くとき、システムはメタデータキャッシュの TTL に基づいて、最新のファイルプロパティを取得するために OSS にリクエストを送信するかどうかを決定します。このオプションを有効にすると、ファイルを開くときに常に OSS にリクエストが送信されます。これにより、多数の小さなファイルを読み取る際のアクセスレイテンシが大幅に増加します。 | false | v2.0.0 以降 | |
ファイル操作設定 | rename_dir_limit | いいえ | 1 回の rename 操作における、ソースフォルダ内の子孫ファイルおよびフォルダの合計最大数。実際の数がこの上限を超えると、rename 操作は失敗します。 | 2000000 | v2.0.0 以降 |
enable_appendable_object | いいえ | 有効にすると、ファイル書き込みに AppendObject 操作が使用されます。このモードは、書き込み中のファイルの読み取りをサポートします。 | false | v2.0.0 以降 | |
appendable_object_autoswitch_threshold | いいえ | `enable_appendable_object` が有効な場合、このサイズ (単位：バイト) 以下の OSS 内の追加不可能なオブジェクトは、データが追加されると自動的に追加可能なオブジェクトに変換されます。 | 0 | v2.0.5 以降 | |
リクエストタイムアウト設定 | oss_request_timeout_ms | いいえ | OSS に送信されるリクエストのタイムアウト期間 (ミリ秒単位)。 | 60000 | v2.0.0 以降 |
キャッシュ設定 | oss_negative_cache_timeout | いいえ | キャッシュされた OSS 404 リクエスト項目の TTL (秒単位)。 | 0 | v2.0.2 以降 |
oss_negative_cache_size | いいえ | キャッシュされた OSS 404 リクエスト項目の数。 | 10000 | v2.0.2 以降 | |
memory_data_cache_size | いいえ | このモードでは、読み取りキャッシュ用に一定量のメモリが事前に割り当てられます。これは主に、ファイルを同時に読み取る際のプリフェッチ増幅の問題を解決するために使用されます。複数の GPU で大規模モデルを読み込む際のパフォーマンスを効果的に向上させることができます。 | 0 | v2.0.5 以降 |
参照
一般的な ossfs 2.0 シナリオの設定ファイルの例については、「ossfs 2.0 の設定」をご参照ください。
詳細については、「ossfs 2.0 を使用してバケットをローカルファイルシステムにマウントする」をご参照ください。