すべてのプロダクト
Search
ドキュメントセンター

Cloud Parallel File Storage:ECS または EGS への CPFS for AI ファイルシステムのマウント

最終更新日:Aug 22, 2026

Elastic Compute Service (ECS) および Elastic GPU Service (EGS) インスタンスは、Virtual Private Cloud (VPC) マウントターゲットを介して CPFS for AI ファイルシステムにアクセスします。このアプローチは、データ前処理、データ移行、小規模トレーニングに適しており、同一ゾーンアクセスとクロスゾーンアクセスの両方をサポートします。

前提条件

  • ファイルシステムを作成済みであること。

  • CPFS ファイルシステムに VPC マウントターゲットを追加済みであり、ECS または EGS インスタンスがマウントターゲットと同じ VPC 内にあること。

  • ECS または EGS インスタンスのオペレーティングシステムは、以下の要件を満たす必要があります。

    オペレーティングシステム

    サポート状況

    Alibaba Cloud Linux 3 (カーネル 5.10.134-13 以降)

    サポート対象 (x86_64、ARM)

    Alibaba Cloud Linux 4 (カーネル 6.6.102-5.3 以降)

    サポート対象 (x86_64、ARM)

    Ubuntu 24.04 (カーネル 6.8.0-60 以降)

    サポート対象 (x86_64)

    説明

    ECS コンソールで利用可能な最新の Alibaba Cloud Linux 3 イメージには、デフォルトで必要なカーネルバージョンが含まれています。

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

ステップ 1:kmod-fuse のインストール

Elastic File Client (EFC) には、拡張 FUSE カーネルモジュールが必要です。続行する前にインストールしてください。

Alibaba Cloud Linux 4

# インスタンスに最新の fuse kmod RPM パッケージをダウンロードしてインストールします。
sudo bash -c "yum install -y http://mirrors.cloud.aliyuncs.com/alinux/aiext/2.0/alinux-4/$(uname -m)/Packages/alinux-aiext-repo-2.0-2.0-1.alnx4.noarch.rpm"
sudo bash -c "yum install kmod-fuse-$(uname -r)"

# fuse ctl が存在する場合はアンマウントします。
sudo umount /sys/fs/fuse/connections

# 古い fuse モジュールをアンロードします。
# 注:rmmod fuse コマンドでモジュールが存在しないと報告された場合、次のステップに進むことができます。「busy」エラーが返された場合は、インスタンスを再起動してください。再起動後、rmmod および modprobe コマンドをスキップし、直接バージョン整合性チェックに進んでください。
sudo rmmod fuse
lsmod | grep fuse

# 新しい fuse モジュールをロードします。
sudo modprobe fuse

# バージョンの整合性を確認します。コマンドが成功すると「same」(一致) と出力されます。
diff -q <(cat /lib/modules/$(uname -r)/extra/fs/fuse/fuse.srcversion) <(cat /sys/module/fuse/srcversion) >/dev/null && echo "same" || echo "not same"

Alibaba Cloud Linux 3

# kmod-fuse をインストールします。
sudo bash -c "yum install -y http://mirrors.cloud.aliyuncs.com/alinux/aiext/0.5/alinux-3/$(uname -m)/Packages/alinux-aiext-repo-0.5-0.5-1.al8.noarch.rpm"
sudo bash -c "yum install -y kmod-fuse-$(uname -r)"

# fuse ctl が存在する場合はアンマウントします。
sudo umount /sys/fs/fuse/connections

# 古い fuse モジュールをアンロードします。
# 注:rmmod fuse コマンドでモジュールが存在しないと報告された場合、次のステップに進むことができます。「busy」エラーが返された場合は、インスタンスを再起動してください。再起動後、rmmod および modprobe コマンドをスキップし、直接バージョン整合性チェックに進んでください。
sudo rmmod fuse
lsmod | grep fuse

# 新しい fuse モジュールをロードします。
sudo modprobe fuse

# バージョンの整合性を確認します。コマンドが成功すると「same」(一致) と出力されます。
diff -q <(cat /lib/modules/$(uname -r)/extra/fs/fuse/fuse.srcversion) <(cat /sys/module/fuse/srcversion) >/dev/null && echo "same" || echo "not same"

Ubuntu 24.04 (x86_64)

# AIExt deb ソースを追加します。
echo "deb [trusted=yes] http://mirrors.cloud.aliyuncs.com/alinux/aiext/1.0/ubuntu-24.04/x86_64/ /" > /etc/apt/sources.list.d/aliyun-aiext.list
apt update

apt -y install ubuntu-aiext-repo
apt update

# kmod-fuse をインストールします。
apt -y install kmod-fuse=$(uname -r)*

# kmod-fuse モジュールが確実にロードされるように、Ubuntu カーネルに組み込まれている fuse モジュールを無効にします。
cp /etc/default/grub /etc/default/grub.bak.$(date +%Y%m%d-%H%M%S)
sed -i 's#^\(GRUB_CMDLINE_LINUX=\".*\)\"#\1 initcall_blacklist=fuse_init\"#g' /etc/default/grub
update-grub

# 変更を反映させるため、インスタンスを再起動します。
reboot

ステップ 2:EFC クライアントのインストール

注:EFC クライアントをインストールする前に、ステップ 1 を完了している必要があります。
重要

EFC クライアントに主要な機能更新やバグ修正があった場合は、ECS インスタンス上の EFC プロセスをアップグレードする必要があります。アップグレードによって I/O エラーや中断が発生することはありませんが、数秒間の短い I/O ジッターが発生する場合があります。インスタンスにログインし、アップグレードスクリプトを実行してください。

Alibaba Cloud Linux 3/4 (x86_64)

# 現在のインスタンスのリージョンを取得します。
region=$(curl -s http://100.100.100.200/latest/meta-data/region-id)

# EFC クライアント RPM パッケージをダウンロードします。
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/aliyun-alinas-utils-latest.noarch.rpm"
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/alinas-efc-latest.x86_64.rpm"

# RPM パッケージをインストールします。2 つのパッケージには依存関係があり、一緒にインストールする必要があります。
sudo yum install -y ./aliyun-alinas-utils-latest.noarch.rpm ./alinas-efc-latest.x86_64.rpm

# インストールを確認します。出力には 2 つのパッケージがリストされます。
rpm -qa | grep alinas
注:インストール中に ERROR または WARNING メッセージが表示されても、プロセスが正常に完了した場合は無視してかまいません。

Alibaba Cloud Linux 3/4 (ARM/aarch64)

# リージョンを設定します。 を実際のリージョン (例:cn-wulanchabu) に置き換えてください。
region=

# EFC クライアント RPM パッケージをダウンロードします。
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/alinas-efc-latest.aarch64.rpm"
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/aliyun-alinas-utils-latest.noarch.rpm"

# RPM パッケージをインストールします。
sudo yum install -y ./aliyun-alinas-utils-latest.noarch.rpm ./alinas-efc-latest.aarch64.rpm

# インストールを確認します。
rpm -qa | grep alinas

Ubuntu 24.04 (x86_64)

# リージョンを設定します。 を実際のリージョン (例:cn-wulanchabu) に置き換えてください。
region=

# EFC クライアント .deb パッケージをダウンロードします。
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/alinas-efc-latest.amd64.deb"
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/aliyun-alinas-utils-latest.noarch.deb"

# .deb パッケージをインストールします。
sudo dpkg -i ./aliyun-alinas-utils-latest.noarch.deb ./alinas-efc-latest.amd64.deb

# インストールを確認します。
apt list --installed | grep alinas

ステップ 3:ファイルシステムのマウント

手動マウント

# マウントディレクトリを作成します。
sudo mkdir -p /mnt/cpfs

# ファイルシステムをマウントします。
sudo mount -t alinas -o efc,protocol=efc,net=tcp,fstype=cpfs :/ /mnt/cpfs

# マウントを確認します。
df -h | grep cpfs

パラメータの説明

パラメータ

説明

-t alinas

ファイルシステムのタイプです。

-o efc,protocol=efc,net=tcp,fstype=cpfs

EFC クライアント、TCP プロトコル、CPFS ファイルシステムタイプを使用します。

VPC マウントターゲットのドメイン名です。CPFS コンソールの [Mount and Use] タブで確認できます。

:/

ファイルシステムのルートディレクトリをマウントします。

/mnt/cpfs

ローカルのマウントディレクトリです。このパスはカスタマイズできます。

起動時の自動マウント

インスタンスの起動時にファイルシステムを自動的にマウントするには、/etc/fstab にマウント設定を追加します。

# /etc/fstab に以下の行を追加します。
#  を実際の VPC マウントターゲットのドメイン名に置き換えてください。
# /mnt/cpfs を実際のローカルマウントディレクトリに置き換えてください。ディレクトリは存在している必要があります。
echo ":/ /mnt/cpfs alinas _netdev,efc,protocol=efc,net=tcp,fstype=cpfs 0 0" | sudo tee -a /etc/fstab

# 設定を確認し、ファイルシステムをマウントします。
sudo mount -a
df -h | grep cpfs
_netdev パラメータを指定すると、システムはネットワークの準備が整った後にのみファイルシステムをマウントするようになります。

ステップ 4:アクセスの確認

マウント後、マウントディレクトリに読み書きできることを確認します。

# ディレクトリ内のファイルをリスト表示します。
ls /mnt/cpfs

# テストファイルにデータを書き込みます。
echo "test" > /mnt/cpfs/test.txt

# テストファイルからデータを読み取ります。
cat /mnt/cpfs/test.txt

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

  1. マウントディレクトリにアクセスしているプロセスがないことを確認します。

    fuser -m /mnt/cpfs
  2. ファイルシステムをアンマウントします。

    sudo umount /mnt/cpfs
  3. 起動時の自動マウントを設定した場合は、/etc/fstab から対応するエントリを削除して、再起動後にファイルシステムが自動的にマウントされないようにします。

    sudo vi /etc/fstab
    # CPFS マウントターゲットを含む行を見つけて削除します。例:
    # :/ /mnt/cpfs alinas _netdev,efc,protocol=efc,net=tcp,fstype=cpfs 0 0

アベイラビリティーゾーン間のアクセス

ECS および EGS インスタンスは、VPC マウントターゲットを介してアベイラビリティーゾーンをまたいで CPFS for AI ファイルシステムにアクセスできます。マウントコマンドは、同一ゾーンアクセスとクロスゾーンアクセスの両方で同じです。同一ゾーンとクロスゾーンの違いを含む VPC アクセスのパフォーマンスの詳細については、製品仕様をご参照ください。

よくある質問

マウント失敗:「mount command not found」

EFC クライアントが正しくインストールされていません。ステップ 2 の手順に従って、EFC クライアントを再インストールしてください。

マウント失敗:「connection timed out」

以下の設定を確認してください。

  1. ECS または EGS インスタンスがマウントターゲットと同じ VPC 内にあること。

  2. セキュリティグループのルールで、ECS または EGS インスタンスからマウントターゲットへのアクセスが許可されていること。

  3. VPC マウントターゲットのステータスが [Available] であること。