Object Storage Service:ossfs 2.0 の一般的な設定例

アクセスキーペア

ossfs 2.0.1 以降では、環境変数を使用して Resource Access Management (RAM) ユーザーのアクセスキーペアを設定して、OSS バケットをマウントできます。この方法は、より安全で便利です。環境変数で設定した認証情報は、設定ファイルで再度指定する必要はありません。

export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************

--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

インスタンス RAM ロール

ossfs 2.0.2 以降では、設定ファイルでインスタンス RAM ロールを使用してアクセス認証情報を設定できます。

--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--ram_role=EcsRamRoleOssTest

外部プロセス

ossfs 2.0.5 以降では、コマンドを使用して独立した外部プロセスを起動できます。このプロセスは、標準出力を通じて結果を ossfs に返します。

{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk"
}

{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk",
  "Expiration" : "2025-12-29T07:45:02Z",
  "SecurityToken" : "token"
}

外部プロセスを設定するには、次の形式を使用します。

--credential_process=user-cmd

use-cmd は、ユースケースに応じて設定してください。設定要件は次のとおりです。

• パラメーターまたはファイル名にスペースが含まれる場合は、その文字列を二重引用符 ("") で囲んでください。

• 実行可能ファイルのフルパスを指定してください。例： /bin/bash、/bin/echo、/bin/curl

• コマンドに環境変数 ($HOME など) を含めないでください。

一般的な例は次のとおりです。

• /etc/creds.txt などの一時ファイルから認証情報を取得するには、次の設定を使用します： --credential_process=/bin/cat /etc/creds.txt

• カスタムサービスからアクセス認証情報を取得するには、次の設定を使用します： --credential_process=/bin/curl <custom_service_endpoint>

形式

-- 接頭辞はマウントオプションを示します。<option> はオプション名、[=<value>] の value は対応する値です。角括弧 [] は、値がオプションであることを示します。

--<option>[=<value>]    

例

# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# バケット名
--oss_bucket=bucketName
# AccessKey ID と AccessKey Secret。(オプション) ossfs 2.0.1 以降では、設定ファイルに記述する代わりに、環境変数を使用してアクセス認証情報を設定できます。
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

バケット全体のマウント

バケット内のすべてのディレクトリとファイルをローカルディレクトリにマウントします。

# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# バケット名
--oss_bucket=bucketName
# AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

特定のディレクトリのマウント

バケットをマウントする際に、バケット内の特定のディレクトリのみをローカルディレクトリにマウントします。

# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# バケット名
--oss_bucket=bucketName
# OSS バケット内のディレクトリのパス (オプション)
--oss_bucket_prefix=folder-test/folder-prefix/
# AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

メモリ制限付きでのマウント

バケットをマウントする際に、ossfs 2.0 プロセスに特定量のメモリを割り当てることができます。

# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# バケット名
--oss_bucket=bucketName
# メモリ制限 (バイト単位、オプション)
--total_mem_limit=4294967296
# AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

デバッグログ付きでのマウント

ログレベルを debug に設定し、ログを保存するカスタムパスを指定します。

# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# バケット名
--oss_bucket=bucketName
# ログを保存するディレクトリ (オプション)。/tmp/log ディレクトリが存在することを確認してください。
--log_dir=/tmp/log/ossfs2
# ログレベル (オプション)
--log_level=debug
# AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

アクセス権限付きでのマウント

• バケット内のすべてのディレクトリをローカルディレクトリにマウントし、マウントを実行したユーザー以外のアクセスを拒否します。

  # バケットが配置されているリージョンのエンドポイント
  --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
  # バケット名
  --oss_bucket=bucketName
  # マウントユーザー以外のユーザーのアクセスを拒否
  --allow_other=false
  # グローバルディレクトリ権限
  --dir_mode=0755
  # グローバルファイル権限
  --file_mode=0644
  # AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
  --oss_access_key_id=LTAI******************
  --oss_access_key_secret=8CE4**********************

• バケット内のすべてのディレクトリをマウントし、特定のユーザー (uid と gid で定義) に読み取りおよび書き込み権限を付与し、他のユーザーには読み取り専用権限を付与します。

  # バケットが配置されているリージョンのエンドポイント
  --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
  # バケット名
  --oss_bucket=bucketName
  # グローバルディレクトリ権限
  --dir_mode=0755
  # グローバルファイル権限
  --file_mode=0644
  # 特定のユーザーの UID と GID (id コマンドを使用してユーザーの UID と GID を取得)
  --uid=1000
  --gid=1000
  # AccessKey ID と AccessKey Secret (ossfs 2.0.1 以降ではオプション)
  --oss_access_key_id=LTAI******************
  --oss_access_key_secret=8CE4**********************