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

カテゴリ

設定項目

必須

説明

デフォルト値

サポートバージョン

バケットの基本設定

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

いいえ

ファイルメタデータキャッシュの有効期限 (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

いいえ

マウントポイント配下のすべてのファイルに対してパーミッションモードを設定します。

0777

v2.0.1 以降

dir_mode

いいえ

マウントポイント配下のすべてのディレクトリに対してパーミッションモードを設定します。

0777

v2.0.1 以降

allow_other

いいえ

非ルートユーザーがマウントポイント配下のファイルにアクセスできるようにします。アクセスはファイルのパーミッションで検証されます。

true

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

path_style

いいえ

このオプションを有効にすると、PrivateLink ドメインを使用してバケットをマウントできます。

false

v2.0.10 以降

enable_ipv6

いいえ

IPv6 アドレスを使用して OSS にアクセスするかどうかを指定します。

true

v2.0.10 以降

アップロード設定

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

いいえ

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

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

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