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

コマンドフォーマット

./ossfs -h

このコマンドは、ossfs 実行可能ファイルが含まれているディレクトリから実行できます。デフォルトのディレクトリは /usr/local/bin/ です。ご利用の環境における実際のインストールパスを使用してください。

一般的なオプション

-o option_name[=option_value]  or  -ooption_name[=option_value]

ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

# キーを /etc/passwd-ossfs ファイルに書き込み、権限を 640 に設定します。
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# キーを /passwd-path/passwd-ossfs ファイルに書き込み、権限を 600 に設定します。
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# opasswd_file 変数を定義し、その値を /passwd-path/passwd-ossfs に設定します。
-opasswd_file=/passwd-path/passwd-ossfs

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

オプション一覧

ほとんどの場合、オプションのフォーマットは -ooption_name=option_value または -o option_name=option_value です。

• ossfs オプション

  オプション名	説明
  retries	リクエストが失敗した後のリトライ回数を指定します。デフォルト値は 2 です。
  storage_class	OSS に書き込まれるファイルのストレージクラスを指定します。有効な値は次のとおりです。 Standard (デフォルト): 標準 IA: 低頻度アクセス Archive: アーカイブストレージ ストレージクラスの詳細については、「ストレージクラス」をご参照ください。
  public_bucket	バケットに匿名でアクセスするかどうかを指定します。このオプションは、アクセス制御リスト (ACL) が公開読み書きのバケットに対してのみ有効です。有効な値は次のとおりです。 0 (デフォルト): バケットに匿名でアクセスしません。 1: バケットに匿名でアクセスします。
  passwd_file	バケットの AccessKey ペアを格納するファイルを指定します。デフォルトのファイルは /etc/passwd-ossfs です。
  connect_timeout	接続タイムアウト期間を秒単位で指定します。デフォルト値は 300 秒です。
  readwrite_timeout	読み取りまたは書き込みリクエストのタイムアウト期間を秒単位で指定します。デフォルト値は 120 秒です。
  max_stat_cache_size	キャッシュするファイルメタデータエントリの数を指定します。デフォルト値は 100,000 で、約 40 MB の追加領域を消費します。
  readdir_optimize	キャッシュを使用してパフォーマンスを最適化するかどうかを制御します。デフォルトでは、このオプションは無効になっています。 このオプションを有効にすると、ossfs は ls 操作中に gid や uid などのファイルメタデータを取得するために HeadObject リクエストを送信しません。ossfs は、ファイルサイズが 0 の場合にのみ HeadObject リクエストを送信します。ただし、権限チェックなどの理由で一部の HeadObject リクエストが発生する場合があります。このオプションは、アプリケーションの属性に基づいて選択してください。有効にするには、バケットをマウントするときに -oreaddir_optimize を追加します。
  stat_cache_expire	ファイルメタデータキャッシュの有効期限を秒単位で指定します。デフォルト値は 900 秒です。
  no_check_certificate	サーバー側の証明書検証を無効にします。このオプションは、HTTPS プロトコルを使用する場合にのみ有効です。デフォルトでは、証明書検証は有効になっています。このオプションには値がありません。使用するには、-ono_check_certificate オプションを追加するだけです。
  multireq_max	ファイルをリスト表示するときにファイルメタデータにアクセスするための同時リクエストの最大数を指定します。デフォルト値は 20 です。
  parallel_count	マルチパートアップロードモードで大きなファイルをアップロードするときの同時パート数を指定します。デフォルト値は 5 です。
  multipart_size	マルチパートアップロードの各パートのサイズを MB 単位で指定します。このパラメーターは、サポートされる最大ファイルサイズに影響します。マルチパートアップロードの最大パート数は 10,000 です。デフォルト値では、サポートされる最大ファイルサイズは 100 GB です。より大きなファイルをサポートするには、必要に応じてこの値を調整してください。
  url	バケットのエンドポイントを指定します。
  umask	マウントポイント内のファイルとフォルダの権限マスクを設定します。 たとえば、マウントポイント内のファイルとフォルダの権限を 770 に設定するには、-oumask=007 を追加します。権限を 700 に設定するには、-oumask=077 を追加します。 説明 バージョン 1.91.*: ファイルのデフォルト権限は 0640、フォルダのデフォルト権限は 0750 です。 バージョン 1.80.*: ファイルとフォルダの両方のデフォルト権限は 0777 です。
  enable_content_md5	アップロード操作中に CONTENT_MD5 を設定するかどうかを指定します。デフォルトでは、これは設定されません。Content-MD5 を設定するには、-oenable_content_md5 オプションを追加します。
  ram_role	RAM ロールを使用して OSS にアクセスします。このメソッドを使用して OSS にアクセスする場合、キーファイル内の AccessKey ID と AccessKey Secret は無視されます。
  listobjectsv2	バケットでバージョン管理が有効になっている場合は、-olistobjectsv2 オプションを使用してファイルをリスト表示します。
  notsup_compat_dir	非互換のディレクトリタイプを制限します。デフォルトでは、ossfs は dir/、dir、および dir_$folder$ をディレクトリとして認識します。 ossfs が dir/ のみをディレクトリとして認識するように制限し、ossfs とサーバー間のやり取りを減らすには、-onotsup_compat_dir オプションを使用します。
  direct_read	ローカルディスクにキャッシュせずに OSS から直接データを読み取れるようにします。デフォルトでは、ossfs はローカルの一時ディレクトリを使用します。このモードを有効にするには、-odirect_read を使用します。 説明 ダイレクトリード中にファイルで書き込み、名前の変更、または切り捨て操作が検出された場合、ファイルは再度開かれるまでダイレクトリードモードを終了します。
  direct_read_chunk_size	ダイレクトリードモードで、1 回の読み取りリクエストで OSS から読み取るデータ量を指定します。単位は MB です。デフォルト値は 4 です。値の範囲は 1 から 32 です。 このオプションは、-odirect_read が有効な場合にのみ適用されます。
  direct_read_prefetch_thread	ダイレクトリードモードでは、ossfs はバックグラウンドの非同期タスクとしてプリリードを実行します。このオプションは、同時にプリフェッチリクエストを行うための最大スレッド数を指定します。デフォルト値は 64 です。 このオプションは、-odirect_read が有効な場合にのみ適用されます。
  direct_read_prefetch_chunks	ダイレクトリードモードで、メモリにプリフェッチするチャンクの数を指定します。これにより、シーケンシャルリードのシナリオで ossfs のパフォーマンスが向上します。デフォルト値は 32 です。 このオプションは、-odirect_read が有効な場合にのみ適用されます。
  direct_read_prefetch_limit	ダイレクトリードモードでは、ossfs はメモリを使用して OSS からプリフェッチされたデータをキャッシュします。このオプションは、ossfs がプリフェッチできるデータの総量を制限します。単位は MB です。デフォルト値は 1024 です。 このオプションは、-odirect_read が有効な場合にのみ適用されます。
  dbglevel	ログレベルを設定します。サポートされているログレベルは次のとおりです。 critical error (デフォルト) warn info debug
  logfile	ログファイルパスを指定します。このオプションを指定しない場合、ログはシステムログに書き込まれます。CentOS では、システムログはデフォルトで /var/log/messages に保存されます。Ubuntu では、システムログはデフォルトで /var/log/syslog に保存されます。 重要 ログファイルパスを指定した後、ログは自動的にローテーションされません。ログファイルのディスク領域の使用状況を監視してください。
  curldbg	libcurl のロギングを有効にします。デフォルトでは無効になっています。libcurl のログを出力するには、-ocurldbg オプションを追加します。

• データキャッシュオプション

  説明

  データキャッシュの原則の詳細については、「データキャッシュ」をご参照ください。

  オプション名	説明
  use_cache	データキャッシュを有効にし、データキャッシュパスを指定します。デフォルトでは、この機能は無効になっています。このオプションを指定して、キャッシュパスを設定します。 たとえば、マウント時に -ouse_cache=path を追加してデータキャッシュを有効にし、データキャッシュパスを path に指定できます。path は、/tmp/your_foldername などの実際のパスに置き換えてください。
  ensure_diskfree	予約するディスク領域の量を制御します。デフォルトでは、領域は予約されません。このオプションを使用して、予約する空きディスク領域の量を MB 単位で設定します。これにより、ディスクがいっぱいになり、他のアプリケーションに影響が及ぶのを防ぎます。 たとえば、少なくとも 1024 MB の空きディスク領域を確保するには、マウント時に -oensure_diskfree=1024 を追加します。
  del_cache	ローカルキャッシュの削除を制御します。デフォルトでは、キャッシュは削除されません。このオプションを設定して、ossfs がローカルデータキャッシュをクリアするように設定します。 たとえば、-odel_cache オプションを追加すると、ossfs はマウントおよび umount 操作中に use_cache で指定されたフォルダ内のキャッシュファイルをクリアします。
  max_dirty_data	書き込み中のファイルのサイズがこの値を超えると、ファイルが閉じられる前に中間一時ファイルがアップロードされます。デフォルト値は 5120 MB です。 たとえば、ファイルのサイズが 2000 MB を超えたときにファイルをアップロードするには、マウント時に -omax_dirty_data=2000 を追加します。OSS のバージョン管理を有効にすると、大きなファイルを書き込むと複数のバージョンの中間ファイルが生成される場合があります。このオプションには大きな値を設定してください。
  tmpdir	デフォルトでは、データはシステムディスクの /tmp ディレクトリに一時的にキャッシュされます。このオプションを指定して、デフォルトの一時キャッシュパスを設定します。このオプションは use_cache オプションと併用できません。 たとえば、マウント時に -otmpdir=path を追加して、デフォルトの一時データキャッシュパスを path に設定します。path は、/data/your_foldername などの実際のパスに設定してください。
  free_space_ratio	キャッシュ後に維持する空きディスク領域の最小パーセンテージを制御します。 たとえば、ディスク領域が 50 GB で、このオプションを -ofree_space_ratio=20 に設定した場合、10 GB の領域 (50 GB × 20%) が予約されます。
  disable_noobj_cache	このオプションは ossfs 1.91.6 で追加されました。noobj メタデータキャッシュを無効または有効にします。有効にすると、ファイルが存在しない場合でも情報がキャッシュされます。デフォルト値は false (有効) です。 たとえば、マウント時に -o disable_noobj_cache を追加して、noobj メタデータキャッシュを無効にします。ossfs 1.91.6 以降では、デフォルトで noobj キャッシュが使用されます。無効にするには、このオプションを追加します。

• FUSE オプション

  オプション名	説明
  allow_other	マウントポイントの権限を変更して、すべてのユーザーがマウントディレクトリにアクセスできるようにします。これにはディレクトリ内のファイルは含まれません。ディレクトリ内のファイルの権限は個別に設定する必要があります。特定のファイルの権限を変更するには、chmod コマンドを使用します。すべてのファイルに同じ権限を設定するには、umask オプションを設定します。デフォルトでは、root ユーザーのみが -oallow_other オプションを設定できます。このオプションには値がありません。使用するには、単に -oallow_other オプションを追加します。
  uid	フォルダを所有するユーザーのユーザー ID (UID) を指定します。
  gid	フォルダを所有するユーザーのグループ ID (GID) を指定します。