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 リクエストを送信しません。 HeadObject リクエストは、アクセスされたファイルのサイズが 0 の場合にのみ送信されます。 ただし、権限チェックやその他の理由により、一定数の HeadObject リクエストが生成される場合があります。 アプリケーションの属性に基づいてこのパラメーターを選択します。 この機能を有効にするには、バケットをマウントするときに -oreaddir_optimize を追加します。
  stat_cache_expire	ファイルメタデータキャッシュの有効期限を指定します。 単位: 秒。 デフォルト値: 900。
  no_check_certificate	サーバー証明書の検証を無効にします。 このオプションは、HTTPS プロトコルを使用する場合にのみ有効です。 デフォルトでは、証明書の検証は有効になっています。 このオプションには値がありません。 使用するには、-ono_check_certificate オプションを追加するだけです。
  multireq_max	ファイルを一覧表示するときにファイルメタデータにアクセスするための同時リクエストの最大数。 デフォルト値: 20。
  parallel_count	マルチパートアップロードモードで大きなファイルをアップロードするときの同時シャード数。 デフォルト値: 5。
  multipart_size	マルチパートアップロードの各パートのサイズ。 単位: MB。 デフォルト値: 10。 このパラメーターは、アップロードできるファイルの最大サイズに影響します。 マルチパートアップロードモードでは、パートの最大数は 10,000 です。 デフォルト値では、最大ファイルサイズは 100 GB です。 より大きなファイルをサポートするには、必要に応じてこの値を調整します。
  url	バケットのエンドポイントを指定します。
  umask	マウントポイント内のファイルとフォルダの権限マスクを設定します。 たとえば、マウントポイント内のファイルとフォルダの権限を 770 に設定するには、-oumask=007 を追加します。 権限を 700 に設定するには、-oumask=077 を追加します。 説明 ossfs 1.91.* バージョン: ファイルのデフォルト権限は 0640、フォルダのデフォルト権限は 0750 です。 ossfs 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 オプションを使用します。
  ensure_diskfree	ossfs 用に予約する利用可能なディスク領域の量を設定します。 パフォーマンスを向上させるために、ossfs はデフォルトでディスク領域を使用してアップロードまたはダウンロード用の一時データを保存します。 このオプションを使用して、予約する利用可能なディスク領域の量を設定できます。 単位: MB。 たとえば、ossfs 用に 1024 MB の利用可能なディスク領域を予約するには、-oensure_diskfree=1024 を使用します。
  direct_read	デフォルトでは、ossfs はディスク領域を使用してアップロードまたはダウンロード用の一時データを保存します。 このオプションを設定すると、ローカルディスク領域を使用せずに OSS から直接データを読み取ります。 このオプションはデフォルトでは設定されていません。 -odirect_read を使用してダイレクトリードモードを有効にします。 説明 ダイレクトリードモードのファイルで `write`、`rename`、または `truncate` 操作が検出されると、ファイルは再オープンされるまでダイレクトリードモードを終了します。
  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
  curldbg	libcurl ログ情報を有効にします。 デフォルトでは、これは無効になっています。 libcurl ログを出力するには、-ocurldbg オプションを追加します。

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

  説明

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

  オプション名	説明
  use_cache	データキャッシュを有効にし、データキャッシュパスを指定します。 デフォルトでは、この機能は無効になっています。 このオプションを指定して、キャッシュパスを設定できます。 たとえば、マウント中に -ouse_cache=path を追加できます。 これにより、データキャッシュが有効になり、データキャッシュパスが path に設定されます。 path を /tmp/your_foldername などの実際のパスに置き換えます。
  ensure_diskfree	予約ディスク領域の量を制御します。 デフォルトでは、スペースは予約されていません。 このオプションを使用して、ディスクがいっぱいになって他のアプリケーションに影響を与えないように、予約する利用可能なディスク領域の量を設定できます。 単位: MB。 たとえば、ossfs 用に 1024 MB の利用可能なディスク領域を予約するには、マウント中に -oensure_diskfree=1024 を追加します。
  del_cache	ローカルキャッシュの削除を制御します。 デフォルトでは、キャッシュは削除されません。 このオプションを設定して、ossfs がローカルデータキャッシュをクリアするように設定できます。 たとえば、マウント中に -odel_cache オプションを追加できます。 ossfs は、マウントおよびアンマウント操作中に 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) を指定します。