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

AccessKey

ossfs 2.0.1 以降では、環境変数を使用して Resource Access Management (RAM) ユーザーの AccessKey ペアを設定し、OSS バケットをマウントできます。この方法はより安全で便利です。すでに環境変数を使用して AccessKey ペアを設定している場合は、設定ファイルで再度設定しないでください。

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*************************

ECS インスタンス 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>] です。-- はマウントオプションのプレフィックスです。<option> はオプション名です。[=<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**********************

バケットのマウントとアクセス権限の設定

• バケット全体のすべてのフォルダをローカルパスにマウントし、root 以外のユーザーの読み取りおよび書き込みアクセスを制限できます。

  # バケットが配置されているリージョンのエンドポイント。
  --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
  
  # バケット名。
  --oss_bucket=bucketName
  
  # root 以外のユーザー (バケットをマウントしたユーザー) からのアクセスを拒否します。
  --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**********************

• バケット全体のすべてのフォルダをローカルパスにマウントできます。root ユーザーと特定のユーザーのみに読み取りおよび書き込みアクセスを許可し、他のユーザーには読み取り専用アクセスを許可できます。

  # バケットが配置されているリージョンのエンドポイント。
  --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**********************