Tous les produits
Search

Ce produit

    Cloud Parallel File Storage:Monter un système de fichiers CPFS for AI sur ECS ou EGS

    Centre de documentation

    Cloud Parallel File Storage:Monter un système de fichiers CPFS for AI sur ECS ou EGS

    Dernière mise à jour :Aug 21, 2026

    Les instances ECS et EGS accèdent à un système de fichiers CPFS for AI via un point de montage VPC. Cette approche convient au prétraitement des données, à la migration de données et à l'entraînement à petite échelle, et prend en charge l'accès intra-zone et interzone.

    Prérequis

    • Vous avez créé un système de fichiers.

    • Vous avez ajouté un point de montage VPC pour le système de fichiers CPFS, et l'instance ECS ou EGS se trouve dans le même VPC que le point de montage.

    • Le système d'exploitation de votre instance ECS ou EGS doit répondre aux exigences suivantes :

      Système d'exploitation

      Statut de prise en charge

      Alibaba Cloud Linux 3 (noyau 5.10.134-13 ou version ultérieure)

      Pris en charge (x86_64, ARM)

      Alibaba Cloud Linux 4 (noyau 6.6.102-5.3 ou version ultérieure)

      Pris en charge (x86_64, ARM)

      Ubuntu 24.04 (noyau 6.8.0-60 ou version ultérieure)

      Pris en charge (x86_64)
      Remarque

      La dernière image Alibaba Cloud Linux 3 disponible dans la console ECS inclut la version de noyau requise par défaut.

    Monter le système de fichiers

    Étape 1 : Installer kmod-fuse

    Le client Elastic File Client (EFC) nécessite le module noyau FUSE amélioré. Installez-le avant de poursuivre.

    Alibaba Cloud Linux 4

    # Download and install the latest fuse kmod RPM package on the instance.
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)"

# Unmount fuse ctl if it exists.
sudo umount /sys/fs/fuse/connections

# Unload the old fuse module.
# Note: If the rmmod fuse command reports that the module does not exist, you can proceed to the next step. If it returns a "busy" error, reboot the instance. After the reboot, skip the rmmod and modprobe commands and proceed directly to the version consistency check.
sudo rmmod fuse
lsmod | grep fuse

# Load the new fuse module.
sudo modprobe fuse

# Verify version consistency. A successful command outputs "same" (Consistent).
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

    # Install 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)"

# Unmount fuse ctl if it exists.
sudo umount /sys/fs/fuse/connections

# Unload the old fuse module.
# Note: If the rmmod fuse command reports that the module does not exist, you can proceed to the next step. If it returns a "busy" error, reboot the instance. After the reboot, skip the rmmod and modprobe commands and proceed directly to the version consistency check.
sudo rmmod fuse
lsmod | grep fuse

# Load the new fuse module.
sudo modprobe fuse

# Verify version consistency. A successful command outputs "same" (Consistent).
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)

    # Add the AIExt deb source.
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

# Install kmod-fuse.
apt -y install kmod-fuse=$(uname -r)*

# Disable the built-in fuse module in the Ubuntu kernel to ensure that the kmod-fuse module is loaded.
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 the instance for the changes to take effect.
reboot

    Étape 2 : Installer le client EFC

    Note : Vous devez terminer l'étape 1 avant d'installer le client EFC.
    Important

    Lorsque le client EFC reçoit des mises à jour majeures de fonctionnalités ou des correctifs de bogues, vous devez mettre à niveau le processus EFC sur votre instance ECS. La mise à niveau ne provoque pas d'erreurs ni d'interruptions d'E/S, mais peut entraîner une brève instabilité des E/S durant quelques secondes. Connectez-vous à l'instance et exécutez le script de mise à niveau.

    Alibaba Cloud Linux 3/4 (x86_64)

    # Get the region of the current instance.
region=$(curl -s http://100.100.100.200/latest/meta-data/region-id)

# Download the EFC client RPM packages.
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/aliyun-alinas-utils-latest.al7.noarch.rpm"
wget "https://aliyun-alinas-eac-${region}.oss-${region}-internal.aliyuncs.com/alinas-efc-latest.x86_64.rpm"

# Install the RPM packages. The two packages have dependencies and must be installed together.
sudo yum install -y ./aliyun-alinas-utils-latest.al7.noarch.rpm ./alinas-efc-latest.x86_64.rpm

# Verify the installation. The output should list two packages.
rpm -qa | grep alinas
    Note : Vous pouvez ignorer les messages ERROR ou WARNING qui apparaissent lors de l'installation, à condition que le processus se termine avec succès.

    Alibaba Cloud Linux 3/4 (ARM/aarch64)

    # Set the region. Replace <YOUR-REGION> with your actual region, such as cn-wulanchabu.
region=<YOUR-REGION>

# Download the EFC client RPM packages.
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.aarch64.rpm"

# Install the RPM packages.
sudo yum install -y ./aliyun-alinas-utils-latest.aarch64.rpm ./alinas-efc-latest.aarch64.rpm

# Verify the installation.
rpm -qa | grep alinas

    Ubuntu 24.04 (x86_64)

    # Set the region. Replace <YOUR-REGION> with your actual region, such as cn-wulanchabu.
region=<YOUR-REGION>

# Download the EFC client .deb packages.
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"

# Install the .deb packages.
sudo dpkg -i ./aliyun-alinas-utils-latest.noarch.deb ./alinas-efc-latest.amd64.deb

# Verify the installation.
apt list --installed | grep alinas

    Étape 3 : Monter le système de fichiers

    Montage manuel

    # Create a mount directory.
sudo mkdir -p /mnt/cpfs

# Mount the file system.
sudo mount -t alinas -o efc,protocol=efc,net=tcp,fstype=cpfs <mount-target-domain-name>:/ /mnt/cpfs

# Verify the mount.
df -h | grep cpfs

    Description des paramètres

    Paramètre

    Description

    -t alinas

    Type de système de fichiers.

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

    Utilise le client EFC, le protocole TCP et le type de système de fichiers CPFS.

    <mount-target-domain-name>

    Nom de domaine du point de montage VPC. Vous pouvez le trouver dans l'onglet Mounting and Using de la console CPFS.

    :/

    Monte le répertoire racine du système de fichiers.

    /mnt/cpfs

    Répertoire de montage local. Vous pouvez personnaliser ce chemin.

    Montage automatique au démarrage

    Pour monter automatiquement le système de fichiers au démarrage de l'instance, ajoutez la configuration de montage au fichier /etc/fstab :

    # Append the following line to /etc/fstab.
# Replace <mount-target-domain-name> with your actual VPC mount target domain name.
# Replace /mnt/cpfs with your actual local mount directory. The directory must exist.
echo "<mount-target-domain-name>:/ /mnt/cpfs alinas _netdev,efc,protocol=efc,net=tcp,fstype=cpfs 0 0" | sudo tee -a /etc/fstab

# Verify the configuration and mount the file system.
sudo mount -a
df -h | grep cpfs
    Le paramètre _netdev garantit que le système monte le système de fichiers uniquement après que le réseau est prêt.

    Étape 4 : Vérifier l'accès

    Après le montage, vérifiez que vous pouvez lire et écrire dans le répertoire de montage :

    # List the files in the directory.
ls /mnt/cpfs

# Write data to a test file.
echo "test" > /mnt/cpfs/test.txt

# Read data from the test file.
cat /mnt/cpfs/test.txt

    Démonter le système de fichiers

    1. Confirmez qu'aucun processus n'accède au répertoire de montage.

      fuser -m /mnt/cpfs

    2. Démontez le système de fichiers.

      sudo umount /mnt/cpfs

    3. Si vous avez configuré le montage automatique au démarrage, supprimez l'entrée correspondante du fichier /etc/fstab pour empêcher le montage automatique du système de fichiers après un redémarrage.

      sudo vi /etc/fstab
# Find and delete the line that contains the CPFS mount target, for example:
# <mount-target-domain-name>:/ /mnt/cpfs alinas _netdev,efc,protocol=efc,net=tcp,fstype=cpfs 0 0

    Accès interzones de disponibilité

    Les instances ECS et EGS peuvent accéder à un système de fichiers CPFS for AI entre différentes zones de disponibilité via un point de montage VPC. La commande de montage est identique pour l'accès intra-zone et interzone. Pour plus de détails sur les performances d'accès VPC, y compris les différences entre l'accès intra-zone et interzone, consultez les spécifications du produit.

    FAQ

    Échec du montage : « mount command not found »

    Le client EFC n'est pas installé correctement. Suivez les instructions de l'étape 2 pour réinstaller le client EFC.

    Échec du montage : « connection timed out »

    Vérifiez les configurations suivantes :

    1. Confirmez que l'instance ECS ou EGS se trouve dans le même VPC que le point de montage.

    2. Confirmez que les règles du groupe de sécurité autorisent l'instance ECS ou EGS à accéder au point de montage.

    3. Confirmez que l'état du point de montage VPC est Available.