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：CPFS-NFS クライアントを使用したファイルシステムのマウント

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	<mount_path> <local_path_to_mount_on_the_server> を表します。必要に応じて置き換えてください。 マウントパス：エクスポートディレクトリのマウントパス。File Storage NAS コンソールで、ファイルシステムリストページに移動し、対象のファイルシステムの横にある [管理] をクリックします。[プロトコルサービス] ページで、[操作] 列の [エクスポートディレクトリ] をクリックします。表示される [エクスポートディレクトリ] パネルで、マウントパスを取得します。 例: cpfs-196f91a8e58b****-195ceeac7b6ac****.cn-chengdu.cpfs.aliyuncs.com:/share/fileset サーバー上のマウント先ローカルパス：Linux ECS インスタンスのルートディレクトリ (/) または任意のサブディレクトリ (例：/mnt)。サブディレクトリの場合は、そのサブディレクトリが存在することを確認してください。
   vers	ファイルシステムバージョン。CPFS は NFSv3 プロトコルでのみファイルシステムのマウントをサポートします。
   マウントオプション	複数のマウントオプションを選択できます。カンマ (,) で区切ります。各オプションの説明は以下の通りです： rsize：クライアントとファイルシステム間でデータを読み取る際のデータブロックのサイズを定義します。推奨値：1048576。 wsize：クライアントとファイルシステム間でデータを書き込む際のデータブロックのサイズを定義します。推奨値：1048576。 説明 I/O サイズパラメーター (rsize および wsize) を変更する場合は、パフォーマンスの低下を避けるために、可能な限り最大値 (1048576) を使用してください。 hard：CPFS ファイルシステムが一時的に利用できなくなった場合、ファイルシステム上のファイルを使用しているローカルアプリケーションは停止し、ファイルシステムがオンラインに戻るまで待機します。このパラメーターを有効にすることを推奨します。 timeo：CPFS-NFS クライアントがファイルシステムへのリクエストを再試行する前に応答を待つ時間 (10 分の 1 秒単位)。推奨値：600 (60 秒)。 説明 タイムアウトパラメーター (timeo) を変更する必要がある場合は、150 以上の値を使用してください。timeo パラメーターの単位は 10 分の 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.nas.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.nas.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 データフロー

• データモニタリング

• アクセス制御

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