Cloud Parallel File Storage:CPFS-NFS クライアント経由でのファイルシステムのマウント（推奨）

使用方法

手順 1：CPFS-NFS クライアントのダウンロードとインストール

このクライアントはオープンソースです。ソースコードや手動でのコンパイル方法については、GitHub リポジトリをご覧ください。

1. CPFS ファイルシステムをマウントする ECS インスタンスにログインします。ECS インスタンスへの接続方法の詳細については、「接続方法」をご参照ください。

2. CPFS-NFS クライアントをダウンロードしてインストールします。

   Alibaba Cloud Linux

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.al.noarch.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo yum install aliyun-alinas-utils-*.rpm

   CentOS

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.el.noarch.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo yum install aliyun-alinas-utils-*.rpm

   Ubuntu

   1. CPFS-NFS クライアントをダウンロードします。

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb

   2. CPFS-NFS クライアントをインストールします。

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

   Debian

   1. CPFS-NFS クライアントをダウンロードします。

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb

   2. CPFS-NFS クライアントをインストールします。

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

   SUSE

   1. CPFS-NFS クライアントをダウンロードします。

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.lp15.x86_64.rpm

   2. CPFS-NFS クライアントをインストールします。

      sudo zypper --no-gpg-checks install -y aliyun-alinas-utils-*.rpm

3. インストールを確認します。

   which mount.cpfs-nfs

   インストールが成功すると、次の出力が返されます。

   /usr/sbin/mount.cpfs-nfs

手順 2：クライアントを使用したファイルシステムのマウント

1. CPFS ファイルシステムをマウントします。

   1. シナリオ 1：一般的なマウント（デフォルトパス）

      このシナリオは、AppArmor や SELinux などの特別なパスアクセス制限が有効になっていないほとんどの環境に適用されます。

      sudo mount -t cpfs-nfs -o vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt

   2. シナリオ 2：高セキュリティ環境でのマウント（例：SELinux または AppArmor が有効なシステム）

      オペレーティングシステムで AppArmor や SELinux などのセキュリティ強化ポリシーが有効になっている場合、デフォルトのマウントではアクセスエラーが発生する可能性があります。この場合、hp_config_dir オプションを使用してパスを指定します。コマンドを実行する際は、<custom_directory> を、システムのセキュリティポリシーが許可するパスに置き換えてください。

      sudo mount -t cpfs-nfs -o vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport,hp_config_dir=<custom_directory> file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt

2. マウントコマンドのパラメーター

   パラメーター	説明
   file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt	マウントパスおよびローカルパスを指定します。実際の値に置き換えてください。 マウントパス：エクスポートディレクトリのマウントパスです。File Storage NAS コンソールのファイルシステム一覧ページで、対象のファイルシステムの 管理 をクリックして プロトコルサービス ページに移動します。操作 列で エクスポートディレクトリ をクリックして エクスポートディレクトリ パネルを開き、マウントパスを取得します。 例： cpfs-196f91a8e58b****-195ceeac7b6ac****.cn-chengdu.cpfs.aliyuncs.com:/share/fileset ローカルパス：ファイルシステムをマウントする ECS インスタンス上のパスです。ルートディレクトリ (/) または /mnt などのサブディレクトリを指定できます。サブディレクトリを指定する場合は、事前にそのディレクトリが存在することを確認してください。
   vers	NFS のバージョンです。CPFS は NFSv3 のみをサポートしています。
   マウントオプション	複数のマウントオプションをカンマ (,) で区切って指定できます。利用可能なオプションは次のとおりです。 rsize：クライアントとファイルシステム間でデータを読み取る際に使用するデータブロックのサイズ（バイト単位）です。推奨値：1048576。 wsize：クライアントとファイルシステム間でデータを書き込む際に使用するデータブロックのサイズ（バイト単位）です。推奨値：1048576。 説明 I/O サイズパラメーター（rsize および wsize）を変更する必要がある場合は、パフォーマンスの低下を回避するために最大値（1048576）を使用することを推奨します。 hard：CPFS ファイルシステムが一時的に利用できなくなった場合、ファイルシステム上のファイルを使用しているローカルアプリケーションは停止し、ファイルシステムがオンラインに戻るまで待ちます。このオプションを推奨します。 timeo：CPFS-NFS クライアントがファイルシステムへのリクエストに対する応答を待つ時間（0.1 秒単位）です。推奨値：600（60 秒）。 説明 タイムアウトパラメーター（timeo）を変更する必要がある場合は、0.1 秒単位であることに注意し、150（15 秒）以上を使用することを推奨します。 retrans：CPFS-NFS クライアントがリクエストを再試行する回数です。推奨値：2。 noresvport：ネットワーク再接続時に新しい TCP ポートを使用し、ネットワーク障害復旧中に接続が中断されないようにします。このオプションを推奨します。 重要 soft オプションは、データ整合性にリスクがあるため推奨されません。soft オプションを使用する場合は、関連するすべてのリスクを承知の上で使用してください。 読み取りまたは書き込みバッファサイズの変更、属性キャッシュの無効化など、推奨値とは異なる値に他のマウントオプションを設定することは避けてください。これらはパフォーマンスを低下させる可能性があります。 hp_config_dir：（オプション） haproxy 設定ファイルを含むディレクトリを指定します。オペレーティングシステムに セキュリティ強化 ポリシー（AppArmor や SELinux など）またはプロセスが特定のパスでのみ構成を読み取ったり実行したりすることを制限するその他の高セキュリティポリシーが適用されている場合に、このパラメーターを設定します。 パス選択の推奨事項：システムのセキュリティポリシーの許可リストから適切なディレクトリを選択し、そのパスがセキュリティモジュールによって認可されていることを確認してください。 ロジック：CPFS クライアントはまず、このパラメーターで指定されたディレクトリを使用しようとします。このパラメーターを指定しない場合、クライアントはセキュリティポリシーの許可リストを自動的に解析しようとします。解析に失敗した場合は、デフォルトパス /var/run/cpfs にフォールバックします。

3. mount -l コマンドを実行してマウント情報を表示します。

   ファイルシステムをマウントした後、df -h コマンドを実行してファイルシステムの容量情報を表示できます。

4. （オプション）起動時の自動マウントを設定します。

   ECS インスタンスの再起動後にマウント情報が失われないようにするには、/etc/fstab ファイルを設定する必要があります。手動マウント時に hp_config_dir パラメーターを使用した場合は、ここでも同様に設定する必要があります。

   1. /etc/fstab 設定ファイルを開き、マウント設定を追加します。

      • 一般的な環境向けの設定：

        file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt cpfs-nfs vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,_netdev,noresvport 0 0

      • 高セキュリティ環境向けの設定例：

        <custom_directory> を、システムのセキュリティポリシーが許可するパスに置き換えてください。

        file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt cpfs-nfs vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,_netdev,noresvport,hp_config_dir=<custom_directory> 0 0

      • 次の表は、その他のパラメーターについて説明しています。

        パラメーター	説明
        _netdev	ネットワークが準備完了する前にクライアントがファイルシステムのマウントを試行しないようにします。
        0（noresvport の後の最初の項目）	ゼロ以外の値は、dump コマンドがファイルシステムをバックアップすることを示します。CPFS ファイルシステムでは、この値は 0 です。
        0（noresvport の後の 2 番目の項目）	起動時に fsck コマンドがファイルシステムをチェックする順序を示します。CPFS ファイルシステムでは、この値は 0 であり、起動時に fsck が実行されないようにします。

   2. reboot コマンドを実行して ECS インスタンスを再起動します。

      ECS インスタンスを再起動する前に、手動マウントが成功していることを確認してください。これにより、インスタンスの再起動失敗を防げます。自動マウントが正しく設定されている場合、ECS インスタンスの再起動後に df -h コマンドを実行してマウントされた CPFS ファイルシステムを確認できます。

クライアント設定

設定ファイル

[DEFAULT]
logging_level = INFO
logging_max_bytes = 1048576
logging_file_count = 10

[mount]
stunnel_debug_enabled = false

# マウント時に証明書のホスト名を検証します。このオプションは一部の stunnel バージョンではサポートされていません。
stunnel_check_cert_hostname = false

# OCSP を使用して証明書の有効性をチェックします。このオプションは一部の stunnel バージョンではサポートされていません。
stunnel_check_cert_validity = false
proxy_port = 12049

cpfs_proxy_addr = 127.0.1.255
cpfs_proxy_port_min = 30000
cpfs_proxy_port_max = 60000

[mount-watchdog]
poll_interval_sec = 1
unmount_grace_period_sec = 30
dns_refresh_interval = 60

[client-tool]

Haproxy 設定

global
    maxconn 4096

defaults
    mode    tcp
    balance leastconn
    timeout client      60s
    timeout server      60s
    timeout connect     3s
    retries 3

frontend cpfs2049
    bind 127.0.1.255:30000
    default_backend bk2049

backend bk2049
    server cpfs_primary 172.27.1.189:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 on-marked-up shutdown-backup-sessions
    server cpfs_backup  172.27.0.214:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 backup

よくある質問

• CPFS ファイルシステムをマウントする際に「Failed to resolve domain: file-system-id.region.cpfs.aliyuncs.com」というエラーが表示された場合はどうすればよいですか？

• CPFS-POSIX クライアントと CPFS-NFS クライアントの違いは何ですか？

• ECS インスタンスから残留しているクライアント設定を削除するにはどうすればよいですか？

• CPFS ファイルシステムをマウントする際に「[FATAL] B: Could not connect to B via ssh」というエラーが表示された場合はどうすればよいですか？

関連トピック

• CPFS データフロー

• データモニタリング

• アクセス制御

• ファイルシステムのアンマウント