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 署名アルゴリズムで使用されます。指定しない場合は V1 にフォールバックします。 |
空 |
v2.0.0 以降 |
|
|
キャッシュ設定 |
attr_timeout |
いいえ |
ファイルメタデータキャッシュの Time-to-Live (TTL) です (単位：秒)。 |
60 |
v2.0.0 以降 |
|
negative_timeout |
いいえ |
無効なディレクトリエントリのキャッシュの TTL です (単位：秒)。 |
0 |
v2.0.0 以降 |
|
|
readdirplus |
いいえ |
readdirplus を有効にします。メモリ使用量は増加しますが、readdir の実行中にファイルメタデータキャッシュを同期的に構築します。 |
true |
v2.0.0 以降 |
|
disk_data_cache_dir | いいえ | ローカルキャッシュディレクトリのパス。空以外の値を設定すると、データキャッシュが有効になります。詳細については、「ローカルデータキャッシュ」をご参照ください。 | 空 | v2.0.8 以降 | |
disk_data_cache_size | いいえ | GiB 単位の最大キャッシュ容量です。キャッシュディレクトリが存在するディスクまたはパーティションの使用可能容量を超える値は指定できません。 | 空 | v2.0.8 以降 | |
disk_data_cache_io_engine | いいえ | ディスクキャッシュの I/O エンジンです。有効な値は | psync | v2.0.8 以降 | |
|
ログ設定 |
log_level |
いいえ |
ログレベルです。有効な値は |
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 |
いいえ |
ossfs をフォアグラウンドで実行します。 |
false |
v2.0.0 以降 |
|
d |
いいえ |
FUSE のデバッグログを有効にした状態で、ossfs をフォアグラウンドで実行します。 |
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 |
いいえ |
非 root ユーザーがマウントポイント配下のファイルにアクセスできるようにします。アクセスはファイルパーミッションで検証されます。 |
true |
v2.0.1 以降 |
高度な設定
|
カテゴリ |
設定項目 |
必須 |
説明 |
デフォルト値 |
対応バージョン |
|
ネットワーク設定 |
bind_ips |
いいえ |
Object Storage Service (OSS) へのアクセスに使用する送信元 IP アドレスのカンマ区切りリストです。例：192.168.0.1,192.168.0.2。マルチ NIC 環境で使用する NIC を制御し、スループットを向上させます。 |
空 |
v2.0.3 以降 |
http_proxy | いいえ | OSS リクエストの転送に使用する HTTP プロキシサーバーです。 | 空 | v2.0.8 以降 | |
|
アップロード設定 |
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 以下の場合、その半分が上限となります。システムメモリが 16 GB を超える場合、上限はありません。 |
0 |
v2.0.0 以降 |
|
max_inode_cache_count |
いいえ |
キャッシュされるメタデータエントリの数を制御します。
|
0 |
v2.0.4 以降 |
|
|
ファイル検証/メタデータ設定 |
enable_crc64 |
いいえ |
ファイル書き込み時の CRC64 検証を有効にします。 |
true |
v2.0.0 以降 |
|
close_to_open |
いいえ |
close-to-open セマンティクスを有効にします。ファイルをオープンする際に GetObjectMeta リクエストを送信し、リアルタイムのメタデータを取得します。 デフォルトでは無効です。この場合、ファイルのオープン時にメタデータキャッシュの TTL を確認し、OSS にクエリするかどうかを決定します。有効にすると、ファイルをオープンするたびに常に OSS にクエリするため、多数の小さなファイルではレイテンシが大幅に増加します。 |
false |
v2.0.0 以降 |
|
|
ファイル操作設定 |
rename_dir_limit |
いいえ |
リネーム操作の対象となる、ソースフォルダー配下のファイルおよびディレクトリの最大数です。この上限を超えると、リネームは失敗します。 |
2000000 |
v2.0.0 以降 |
|
enable_appendable_object |
いいえ |
ファイル書き込みで AppendObject API を使用し、同一ファイルへの読み取りと書き込みの同時実行を可能にします。 |
false |
v2.0.0 以降 |
|
|
appendable_object_autoswitch_threshold |
いいえ |
enable_appendable_object が有効な場合、追記時に、このサイズ (バイト) 以下の非追記可能オブジェクトは自動的に追記可能オブジェクトへ変換されます。 |
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 以降 |
|
|
kernel_readdir_cache_timeout |
いいえ |
カーネルのディレクトリキャッシュの TTL (秒) です。Linux カーネル 4.20 以降が必要です。 |
0 |
v2.0.7 以降 |
リファレンス
-
一般的なシナリオ向け設定ファイルの例： ossfs 2.0 の設定