Object Storage Service:ossfs 1.0 を使用した Linux ローカルファイルシステムへのバケットのマウント

設定ファイルを使用したマウント

1. マウントディレクトリを作成します。

   次のコマンドを実行して、バケットのマウントポイントとして空のディレクトリ /tmp/ossfs-1 と /tmp/ossfs-2 を作成します。

   mkdir /tmp/ossfs-1 /tmp/ossfs-2

2. マウント例。

   次のコマンドを実行して、デフォルトの設定ファイルで設定された bucket-test-1 と bucket-test-2 を、それぞれ /tmp/ossfs-1 と /tmp/ossfs-2 ディレクトリにマウントします。

   ossfs bucket-test-1 /tmp/ossfs-1/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
   ossfs bucket-test-2 /tmp/ossfs-2/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

3. 出力は次のようになります。

   root@i-xxx:~# ossfs xxx /tmp/ossfs-1 -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
   [NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
       ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
   root@i-xxx:~#
   root@i-xxx                :~# df -h /tmp/ossfs-1
   Filesystem      Size  Used Avail Use% Mounted on
   ossfs            16E     0   16E   0% /tmp/ossfs-1

ECS RAM ロールを使用したマウント

1. マウントディレクトリを作成します。

   次のコマンドを実行して、バケットのマウントポイントとして使用する空のディレクトリ /tmp/ossfs を作成します。

   mkdir /tmp/ossfs

2. マウント例。

   説明

   インスタンスメタデータ URL を使用して ossfs をマウントする場合、サポートされているのは 通常 アクセスモードのみです。メタデータアクセスモードの詳細については、「インスタンスメタデータ」をご参照ください。

   次のコマンドを実行して、bucket1 という名前のバケットをローカルの /tmp/ossfs ディレクトリにマウントします。

   注：ECS RAM ロールを使用してバケットをマウントする場合は、 ram_role パラメーターでインスタンスメタデータ URL を指定する必要があります。IP アドレス 100.100.100.200 は、Alibaba Cloud ECS の インスタンスメタデータ サービスのデフォルト値であり、変更しないでください。EcsRamRoleOssTest を、ECS インスタンスにアタッチされているロールの名前に置き換えてください。他の情報は変更しないでください。

   ossfs bucket1 /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleOssTest -o sigv4 -o region=cn-hangzhou

3. 出力は次のようになります。

   root@xxx         xxx:~# ossfs  xxx  /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/xxx  -o sigv4 -o region=cn-hangzhou
   [NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
           ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
   root@xxx         xxx:~#
   root@xxx         xxx:~# df -h /tmp/ossfs
   Filesystem  Size  Used  Avail Use% Mounted on
   ossfs       16E   0     16E   0%   /tmp/ossfs

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

次のコマンドを実行して、bucket-ossfs-test バケット内の folder ディレクトリをローカルの /tmp/ossfs-folder ディレクトリにマウントします。

ossfs bucket-ossfs-test:/folder /tmp/ossfs-folder -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

指定した設定ファイルを使用したマウント

• マウントオプション： passwd_file マウントオプションを使用して、デフォルト以外の ossfs 1.0 設定ファイルのパスを指定します。ファイルの権限を 600 に設定します。

• マウント例

  次のコマンドを実行して、指定した設定ファイルで設定されている bucket-test-3 をローカルの /tmp/ossfs-3 ディレクトリにマウントします。

  ossfs bucket-test-3 /tmp/ossfs-3 -o url=http://oss-cn-hangzhou.aliyuncs.com -o passwd_file=/etc/passwd-ossfs-3 -o sigv4 -o region=cn-hangzhou

マウント時のデバッグログの有効化

• マウントオプション: dbglevel マウントオプションでログレベルを設定します。 サポートされているログレベルは critical、error、warn、info および debug です。 デフォルト値は critical です。 デフォルトでは、ログは CentOS システムでは /var/log/messages に、Ubuntu システムでは /var/log/syslog に保存されます。 また、logfile マウントオプションを使用して、ログファイルのカスタムパスを指定することもできます。

• マウント例 1

  次のコマンドを実行して、 bucket-ossfs-test-1 をローカルの /tmp/ossfs-1 ディレクトリにマウントします。このコマンドでは、 -d オプションを追加して libfuse デバッグログを有効にし、 dbglevel マウントオプションを使用してログレベルを debug に設定します。

  ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug -o sigv4 -o region=cn-hangzhou

• マウント例 2

  次のコマンドを実行して、 bucket-ossfs-test-2 をローカルの /tmp/ossfs-2 ディレクトリにマウントします。ログレベルは debug に設定され、 libfuse デバッグログが有効になります。ログメッセージは、 -f オプションを使用してフォアグラウンドのターミナルに出力されます。

  ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f -o sigv4 -o region=cn-hangzhou

マウント時のアクセス権限の設定

デフォルトでは、マウントコマンドを実行したユーザー (所有者) のみがマウントされたディレクトリにアクセスできます。他のユーザーがマウントポイントにアクセスできるようにするには、バケットをマウントする際に、以下で説明するパラメーターを設定します。

• マウント例 1

  bucket_name をローカルの mount_point ディレクトリにマウントし、 allow_other マウントオプションを使用してすべてのユーザーにアクセスを許可します。これにより、マウントディレクトリの権限が 777 に設定されます。

  ossfs bucket_name mount_point -o url=endpoint -o allow_other -o sigv4 -o region=cn-hangzhou

• マウント例 2

  bucket_name をローカルの mount_point ディレクトリにマウントし、 umask マウントオプションを使用してマウントディレクトリとその中のファイルの権限を 770 に設定します。これにより、同じグループのユーザーのみがアクセスできるようになります。

  ossfs bucket_name mount_point -o url=endpoint -o umask=007 -o sigv4 -o region=cn-hangzhou

• マウント例 3

  1. 次のコマンドを実行して、特定のユーザーの UID、GID、およびグループを取得します。この例では www ユーザーを使用します。

     id www

     コマンドの出力は次のようになります。

     root@iZbp1325rf1sja6ye4kbm2Z:~# id www
     uid=xxx(www) gid=xxx(www) groups=xxx(www)

  2. bucket_name をローカルの mount_point ディレクトリにマウントし、 uid および gid マウントオプションを使用してユーザーとグループを指定します。この設定により、同じグループのユーザーのみにアクセスが許可され、権限が 770 に設定されます。この例では、 uid と gid は 1000 です。マウントコマンドを実行する前に、これらの値をターゲットユーザーの uid と gid に置き換えてください。

     ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007 -o sigv4 -o region=cn-hangzhou