Object Storage Service:ossfs 2.0 のマウントオプション

カテゴリ

設定項目

必須

説明

デフォルト値

対応バージョン

バケットの基本設定

oss_endpoint

はい

バケットにアクセスするためのエンドポイントです。

なし

v2.0.0 以降

oss_bucket

はい

バケットの名前です。

なし

v2.0.0 以降

アクセス認証情報の設定

oss_access_key_id

条件付きで必須

AccessKey 認証に必須の AccessKey ID です。

なし

v2.0.0 以降

oss_access_key_secret

条件付きで必須

AccessKey 認証に必須の 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

いいえ

ファイルメタデータキャッシュの有効期限 (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 にアライメントされます。キャッシュディレクトリが存在するディスクまたはパーティションの利用可能なスペースを超えることはできません。disk_data_cache_dir は空にすることができます。disk_data_cache_dir が指定されている場合、このパラメーターに有効な値を設定する必要があります。

空

v2.0.8 以降

disk_data_cache_io_engine

いいえ

ディスクキャッシュの I/O エンジンです。有効な値：psync および libaio。

psync

v2.0.8 以降

書き込みモード設定

temp_dir

いいえ

ローカル一時ディレクトリのパスです。絶対パスである必要があります。空でない値を設定すると、ローカル一時ディレクトリに基づくランダム書き込みモードが有効になり、任意のオフセットでの書き込みや任意のサイズへの切り捨てなど、完全な POSIX 書き込みセマンティクスがサポートされます。この機能を無効にするには、空のままにしてください。詳細については、「ランダム書き込みをサポートするためのローカル一時ディレクトリの設定」をご参照ください。

空

v2.0.9 以降

temp_dir_free_bytes

いいえ

一時ディレクトリが存在するディスクに予約される最小空きディスク容量 (バイト単位) です (K、M、G などの単位も使用できます)。空きディスク容量がこのしきい値を下回ると、新しい書き込みでは ENOSPC が返されます。マウント時に空きディスク容量がすでにこの値を下回っている場合、マウントは失敗します。最小値：64 MiB。

1 GiB

v2.0.9 以降

random_write_max_file_size

いいえ

ランダム書き込みモードにおける単一オブジェクトの最大論理サイズ (バイト単位) です (K、M、G などの単位も使用できます)。この制限を超える書き込みや切り捨てでは EFBIG が返されます。物理的な上限は、OSS マルチパートアップロード容量 (10,000 パート × 5 GiB、約 48.8 TiB) です。

100 GiB

v2.0.9 以降

ログ設定

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

いいえ

ossfs2 をフォアグラウンドで実行します。

false

v2.0.0 以降

d

いいえ

FUSE デバッグログを有効にして、ossfs2 をフォアグラウンドで実行します。

false

v2.0.0 以降

マウントモード

ro

いいえ

ファイルシステムを読み取り専用モードでマウントします。

false

v2.0.0 以降

権限設定

gid

いいえ

マウントポイント配下のすべてのファイルとディレクトリの GID を設定します。

ファイルシステムをマウントするユーザーの GID

v2.0.1 以降

uid

いいえ

マウントポイント配下のすべてのファイルとディレクトリの UID を設定します。

ファイルシステムをマウントするユーザーの UID

v2.0.1 以降

file_mode

いいえ

マウントポイント配下のすべてのファイルの権限モードを設定します。

0644

v2.0.1 以降

dir_mode

いいえ

マウントポイント配下のすべてのディレクトリの権限モードを設定します。

0755

v2.0.1 以降

allow_other

いいえ

非 root ユーザーがマウントポイント配下のファイルにアクセスすることを許可します。アクセスはファイル権限によって検証されます。

false

v2.0.1 以降

カテゴリ

設定項目

必須

説明

デフォルト値

対応バージョン

ネットワーク設定

bind_ips

いいえ

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

いいえ

プリフェッチチャンクの数です。デフォルトは 3 × prefetch_concurrency です。ファイルハンドルあたりのプリフェッチメモリを無制限にするには、-1 に設定します。

0 (prefetch_concurrency に基づいて自動的に設定)

v2.0.0 以降

メモリ管理設定

total_mem_limit

いいえ

メモリの合計上限 (バイト単位) です。アップロードとプリフェッチの同時実行数は、この上限に合わせて自動的に調整されます。

このオプションが指定されていない場合、読み取りプリフェッチは prefetch_chunk_size * prefetch_chunks のバッファーを、書き込みは upload_buffer_size * upload_concurrency を使用します。これにより、合計で最大約 8 GB が割り当てられます。OOM を避けるために十分なメモリを確保してください。

デフォルト値の 0 は、16 GB 以下のシステムではシステムメモリの半分が上限として設定されることを意味します。16 GB を超えるシステムでは制限はありません。

0

v2.0.0 以降

max_inode_cache_count

いいえ

キャッシュされるメタデータエントリの数を制御します。

• 0 (デフォルト)：明示的な制御は行われません。OS が自動的にメタデータを破棄します。

• 正の整数：キャッシュ数がこの値を超えると、ossfs 2.0 が超過分のエントリを破棄します。

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 操作を使用することで、同じファイルに対する同時読み取りおよび書き込みを可能にします。

false

v2.0.0 以降

appendable_object_autoswitch_threshold

いいえ

enable_appendable_object が有効な場合、このサイズ (バイト単位) 以下の追加不可能オブジェクトは、追記時に自動的に追加可能オブジェクトに変換されます。

0

v2.0.5 以降

enable_symlink

いいえ

シンボリックリンク機能を有効にします。シンボリックリンクは、マウントポイント内で相対パスでのみ作成できます。

false

v2.0.6 以降

リクエストタイムアウト設定

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 以降