Todos os produtos
Search

Este produto

    Cloud Parallel File Storage:Monte um sistema de arquivos CPFS for AI em instâncias ECS ou EGS

    Central de documentação

    Cloud Parallel File Storage:Monte um sistema de arquivos CPFS for AI em instâncias ECS ou EGS

    Última atualização: Aug 21, 2026

    Instâncias ECS e EGS acessam um sistema de arquivos CPFS for AI por meio de um ponto de montagem VPC. Essa abordagem é adequada para pré-processamento de dados, migração de dados e treinamento em pequena escala, com suporte a acesso tanto na mesma zona quanto entre zonas diferentes.

    Pré-requisitos

    • Você possui created a file system.

    • Você possui added a VPC mount target para o sistema de arquivos CPFS, e a instância ECS ou EGS está na mesma VPC do ponto de montagem.

    • O sistema operacional da sua instância ECS ou EGS deve atender aos seguintes requisitos:

      Sistema operacional

      Status de suporte

      Alibaba Cloud Linux 3 (kernel 5.10.134-13 ou posterior)

      Suportado (x86_64, ARM)

      Alibaba Cloud Linux 4 (kernel 6.6.102-5.3 ou posterior)

      Suportado (x86_64, ARM)

      Ubuntu 24.04 (kernel 6.8.0-60 ou posterior)

      Suportado (x86_64)
      Nota

      A imagem mais recente do Alibaba Cloud Linux 3 disponível no console ECS já inclui a versão necessária do kernel por padrão.

    Monte o sistema de arquivos

    Etapa 1: Instale o kmod-fuse

    O Elastic File Client (EFC) requer o módulo de kernel FUSE aprimorado. Instale-o antes de prosseguir.

    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

    Etapa 2: Instale o cliente EFC

    Nota : É obrigatório concluir a Etapa 1 antes de instalar o cliente EFC.
    Importante

    Quando o cliente EFC recebe atualizações importantes de recursos ou correções de bugs, você deve atualizar o processo do EFC na sua instância ECS. A atualização não causa erros de I/O ou interrupções, mas pode gerar uma breve oscilação de I/O com duração de alguns segundos. Faça login na instância e execute o script de atualização.

    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
    Nota : Ignore quaisquer mensagens de ERROR ou WARNING exibidas durante a instalação, desde que o processo seja concluído com sucesso.

    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

    Etapa 3: Monte o sistema de arquivos

    Montagem manual

    # 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

    Descrição dos parâmetros

    Parâmetro

    Descrição

    -t alinas

    Tipo do sistema de arquivos.

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

    Utiliza o cliente EFC, protocolo TCP e tipo de sistema de arquivos CPFS.

    <mount-target-domain-name>

    Nome de domínio do ponto de montagem VPC. Disponível na aba Mounting and Using no console CPFS.

    :/

    Monta o diretório raiz do sistema de arquivos.

    /mnt/cpfs

    Diretório de montagem local. Este caminho pode ser personalizado.

    Montagem automática na inicialização

    Para montar o sistema de arquivos automaticamente quando a instância for iniciada, adicione a configuração de montagem ao arquivo /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
    O parâmetro _netdev garante que o sistema monte o sistema de arquivos somente após a rede estar pronta.

    Etapa 4: Verifique o acesso

    Após a montagem, confirme se é possível ler e gravar no diretório de montagem:

    # 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

    Desmonte o sistema de arquivos

    1. Confirme se nenhum processo está acessando o diretório de montagem.

      fuser -m /mnt/cpfs

    2. Desmonte o sistema de arquivos.

      sudo umount /mnt/cpfs

    3. Caso tenha configurado a montagem automática na inicialização, remova a entrada correspondente do arquivo /etc/fstab para evitar que o sistema de arquivos seja montado automaticamente após uma reinicialização.

      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

    Acesso entre zonas de disponibilidade

    Instâncias ECS e EGS podem acessar um sistema de arquivos CPFS for AI entre zonas de disponibilidade por meio de um ponto de montagem VPC. O comando de montagem é o mesmo para acesso na mesma zona e entre zonas diferentes. Para detalhes sobre o desempenho de acesso via VPC, incluindo diferenças entre acesso na mesma zona e entre zonas, consulte product specifications.

    Perguntas frequentes

    Falha na montagem: "mount command not found"

    O cliente EFC não foi instalado corretamente. Siga as instruções da Etapa 2 para reinstalar o cliente EFC.

    Falha na montagem: "connection timed out"

    Verifique as seguintes configurações:

    1. Confirme se a instância ECS ou EGS está na mesma VPC do ponto de montagem.

    2. Verifique se as regras do grupo de segurança permitem que a instância ECS ou EGS acesse o ponto de montagem.

    3. Certifique-se de que o status do ponto de montagem VPC seja Available.