ACS挂载CPFS智算版文件系统

更新时间:
复制 MD 格式

容器计算服务 ACS 支持挂载 CPFS 智算版文件系统,多个 Pod 可同时挂载实现数据共享。

前提条件

  • 已创建 ACS 集群。

    ACS 场景下 CSI 组件(bmcpfs-csi-controller、bmcpfs-csi-node、cnfs-nas-daemon)由 ACS 平台托管,用户无需关心组件版本与升级。
  • 已创建 CPFS 智算版文件系统,并记录文件系统 ID。具体操作,请参见创建文件系统

  • Pod 调度到不支持 RDMA 的节点或跨存算亲和域场景时,需预先创建 VPC 挂载点,并记录挂载点域名(格式为 cpfs-***-vpc-***.<Region>.cpfs.aliyuncs.com)。VPC 挂载点所属 VPC 必须与 ACS 集群 VPC 一致。具体操作,参见管理VPC挂载点

步骤一:创建PVPVC

根据 Pod 类型选择对应模板:

  • 灵骏 GPU Pod + 同存算亲和域:使用「方式 A:RDMA」。

  • CPU Pod、灵骏跨存算亲和域访问:使用「方式 B:VPC 挂载点」。

ACS 灵骏 Pod 与 CPFS 处于同一存算亲和域时通过 VSC + RDMA 直挂访问,性能最优;CPU Pod或灵骏跨存算亲和域访问场景则通过 VPC 挂载点访问。存算亲和域的概念与判断方法参见挂载访问概述

RDMA网络

kubectl命令行

  1. 创建cpfs-pv-pvc.yaml文件,定义PVPVC:

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: cpfs-test
      labels:
        alicloud-pvname: cpfs-test
    spec:
      accessModes:
      - ReadWriteMany
      capacity:
        storage: 10Ti
      csi:
        driver: bmcpfsplugin.csi.alibabacloud.com
        volumeAttributes:
          filesystemId: bmcpfs-*****
          path: /
        volumeHandle: bmcpfs-*****
    ---
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: cpfs-test
    spec:
      accessModes:
      - ReadWriteMany
      selector:
        matchLabels:
          alicloud-pvname: cpfs-test
      resources:
        requests:
          storage: 10Ti

    参数说明:

    • PV参数

      参数

      说明

      labels

      设置Label,以便PVC使用selector进行匹配绑定。

      accessModes

      PV的访问模式。

      capacity.storage

      声明存储卷容量。

      csi.driver

      驱动类型,设置为bmcpfsplugin.csi.alibabacloud.com

      csi.volumeAttributes

      CPFS存储卷的属性。

      • filesystemId:CPFS智算版文件系统ID。

      • path:默认为/表示挂载CPFS文件系统的根目录,支持设置为子目录,如/dir。如果子目录不存在,会在挂载时被自动创建。

      csi.volumeHandle

      CPFS智算版文件系统ID。

    • PVC参数

      参数

      说明

      accessModes

      PVC请求PV的访问模式。

      selector

      使用PV上的Label进行匹配绑定。

      resources.requests.storage

      分配给Pod的存储容量。不大于PV容量即可。

  2. 执行创建命令:

    kubectl create -f cpfs-pv-pvc.yaml
  3. 确认PVC已绑定PV。

    kubectl get pvc cpfs-test

    返回示例如下(STATUS显示Bound表示成功):

    NAME        STATUS   VOLUME           CAPACITY   ACCESS MODES   STORAGECLASS    VOLUMEATTRIBUTESCLASS   AGE
    cpfs-test   Bound    cpfs-test        10Ti       RWX            <unset>         <unset>                 10s

控制台

  1. 登录容器计算服务控制台

  2. 集群列表页面,单击目标集群名称,进入该集群的管理页面。

  3. 在左侧导航栏选择存储 > 存储声明,单击创建,完成以下配置:

    参数

    说明

    示例

    存储声明类型

    选择CPFS

    CPFS

    名称

    PVC名称,自定义输入。格式要求请参考界面提示。

    cpfs-pvc

    分配模式

    根据需要选择已有存储卷创建存储卷

    创建存储卷

    CPFS类型

    选择CPFS智算版

    CPFS智算版

    访问模式

    支持ReadWriteManyReadWriteOnce

    ReadWriteMany

    文件系统ID

    配置要挂载的CPFS智算版文件系统ID。

    bmcpfs-0115******13q5

  4. 查看创建的PVPVC。

    存储声明页面和存储卷页面,可以看到新创建的PVPVC,确认两者已绑定。

VPC网络

适用于 CPU Pod、普通 GPU(T4、A10 等),以及灵骏 GPU 跨存算亲和域访问场景。

  1. 创建cpfs-pv-pvc.yaml文件,定义PVPVC:

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: cpfs-test
      labels:
        alicloud-pvname: cpfs-test   # [PV标签] PVC通过此绑定
    spec:
      accessModes:
      - ReadWriteMany
      capacity:
        storage: 10Ti
      csi:
        driver: nasplugin.csi.alibabacloud.com
        volumeAttributes:
          mountProtocol: efc
          server: cpfs-***-vpc-***.cn-wulanchabu.cpfs.aliyuncs.com  # 替换为VPC挂载点域名
          path: /
          autoSwitch: "true"    # 可选,启用VSC/VPC自动切换(灵骏跨AZ场景建议开启)
        volumeHandle: bmcpfs-*****   # 替换为您的CPFS智算版文件系统ID
    ---
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: cpfs-test      # [PVC名称] Deployment通过此引用
    spec:
      accessModes:
      - ReadWriteMany
      selector:
        matchLabels:
          alicloud-pvname: cpfs-test    # [PVC选择器] 需与PV标签一致
      resources:
        requests:
          storage: 10Ti

    参数说明:

    • PV参数

      参数

      说明

      labels

      设置Label,以便PVC使用selector进行匹配绑定。

      accessModes

      访问模式。

      capacity.storage

      声明存储卷容量。

      csi.driver

      驱动类型,设置为nasplugin.csi.alibabacloud.com

      csi.volumeAttributes

      CPFS存储卷的属性。

      • mountProtocol:挂载协议,设置为efc

      • server:CPFS文件系统的VPC挂载点域名。

      • path:默认为/表示挂载CPFS文件系统的根目录,支持设置为子目录,如/dir

      csi.volumeHandle

      CPFS智算版文件系统ID。

    • PVC参数

      参数

      说明

      accessModes

      PVC请求PV的访问模式。

      selector

      使用PV上的Label进行匹配绑定。

      resources.requests.storage

      分配给Pod的存储容量。不大于PV容量即可。

    • autoSwitch:可选参数,设置为 "true" 时启用 VSC/VPC 自动切换。灵骏 GPU 跨 AZ 访问时,系统会自动从 RDMA 切换为 VPC 通道。

    说明

    VPC 通道的吞吐性能受网络带宽限制,最高约 3.2 GB/s(25 Gbps),低于 RDMA 直连性能。对性能敏感的场景,建议优先选择同存算亲和域的 CPFS 实例。

  2. 执行创建命令:

    kubectl create -f cpfs-pv-pvc.yaml
  3. 确认PVC已绑定PV。

    kubectl get pvc cpfs-test

    返回示例如下(STATUS显示Bound表示成功):

    NAME        STATUS   VOLUME           CAPACITY   ACCESS MODES   STORAGECLASS    VOLUMEATTRIBUTESCLASS   AGE
    cpfs-test   Bound    cpfs-test        10Ti       RWX            <unset>         <unset>                 10s

步骤二:创建应用并挂载CPFS

创建 Deployment 应用,通过引用 PVC 将存储挂载到容器指定目录。根据操作习惯选择命令行或控制台方式。

kubectl

  1. 使用以下YAML内容,创建cpfs-test.yaml文件。

    GPU应用

    以下YAML示例可以创建包含2PodDeployment,2Pod均通过alibabacloud.com/compute-class: gpu标签声明要使用GPU型算力,并且通过名为cpfs-testPVC申请存储资源,挂载路径均为/data

    说明

    关于GPU卡具体型号,请参见ACS GPU Pod指定GPU型号和驱动版本

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: cpfs-test
      labels:
        app: cpfs-test
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: cpfs-test
      template:
        metadata:
          labels:
            app: cpfs-test
            # 指定计算类型为GPU型
            alibabacloud.com/compute-class: gpu
            # 指定GPU型号,请按实际情况填写,如T4
            alibabacloud.com/gpu-model-series: T4
            alibabacloud.com/compute-qos: default
        spec:
          containers:
          - name: nginx
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
            ports:
            - containerPort: 80
            volumeMounts:
              - name: pvc-cpfs
                mountPath: /data
          volumes:
            - name: pvc-cpfs
              persistentVolumeClaim:
                claimName: cpfs-test

    CPU应用

    以下YAML示例可以创建包含2PodDeployment,通过名为cpfs-testPVC申请存储资源,挂载路径均为/data

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: cpfs-test
      labels:
        app: cpfs-test
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: cpfs-test
      template:
        metadata:
          labels:
            app: cpfs-test
        spec:
          containers:
          - name: nginx
            image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
            ports:
            - containerPort: 80
            volumeMounts:
              - name: pvc-cpfs
                mountPath: /data
          volumes:
            - name: pvc-cpfs
              persistentVolumeClaim:
                claimName: cpfs-test
  2. 创建Deployment并挂载CPFS。

    kubectl create -f cpfs-test.yaml
  3. 查看DeploymentPod的部署情况。

    kubectl get pod | grep cpfs-test

    返回示例如下,已创建2Pod。

    cpfs-test-****-***a   1/1     Running   0          45s
    cpfs-test-****-***b   1/1     Running   0          45s
  4. 查看挂载路径。

    命令示例如下,预期会返回CPFS智算版文件系统挂载目录下的数据。默认为空。

    kubectl exec cpfs-test-****-***a -- ls /data

控制台

  1. 在集群管理页面的左侧导航栏,选择工作负载 > 无状态

  2. 无状态页面,单击使用镜像创建

  3. 完成Deployment的参数配置,单击创建

    需要注意的参数如下,其他参数保持默认即可。更多信息,请参见创建无状态工作负载Deployment

    GPU应用

    配置页

    参数

    说明

    示例

    应用基本信息

    应用名称

    Deployment名称,自定义输入。格式要求请参考界面提示。

    cpfs-test

    副本数量

    配置Deployment的副本数量。

    2

    实例类型

    选择Pod的计算类型。

    说明

    关于GPU卡具体型号,请参见ACS GPU Pod指定GPU型号和驱动版本

    GPU,T4

    容器配置

    镜像名称

    输入用于部署应用的镜像地址。

    registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest

    所需资源

    设置所需的GPU、vCPU和内存资源。

    • GPU:1

    • CPU:2 vCPU

    • 内存:2 GiB

    数据卷

    单击增加云存储声明(PersistentVolumeClaim),然后完成参数配置。

    • 挂载源:选择之前创建的PVC。

    • 容器路径:输入CPFS文件系统要挂载到的容器路径。

    • 挂载源:pvc-cpfs

    • 容器路径:/data

    CPU应用

    配置页

    参数

    说明

    示例

    应用基本信息

    应用名称

    Deployment名称,自定义输入。格式要求请参考界面提示。

    cpfs-test

    副本数量

    配置Deployment的副本数量。

    2

    实例类型

    选择Pod的计算类型。

    CPU,通用型

    容器配置

    镜像名称

    输入用于部署应用的镜像地址。

    registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest

    所需资源

    设置所需的vCPU和内存资源。

    • CPU:0.25 vCPU

    • 内存:0.5 GiB

    数据卷

    单击增加云存储声明(PersistentVolumeClaim),然后完成参数配置。

    • 挂载源:选择之前创建的PVC。

    • 容器路径:输入CPFS文件系统要挂载到的容器路径。

    • 挂载源:pvc-cpfs

    • 容器路径:/data

  4. 查看应用部署情况。

    1. 无状态页面,单击应用名称。

    2. 容器组页签下,确认Pod已正常运行(状态为Running)。

步骤三:验证挂载结果

按照上文示例创建的Deployment中含有2Pod,2Pod同时挂载了同一CPFS文件系统。您可以通过以下方式进行验证:

重建Deployment,然后在新创建的Pod中查看文件系统中的数据是否存在,以此来验证持久化存储。

  1. 查看Pod信息。

    kubectl get pod | grep cpfs-test

    返回示例如下:

    cpfs-test-****-***a   1/1     Running   0          45s
    cpfs-test-****-***b   1/1     Running   0          45s
  2. 验证共享存储。

    1. 在一个Pod中创建文件。

      以名为cpfs-test-****-***aPod作为示例:

      kubectl exec cpfs-test-****-***a -- touch /data/test.txt
    2. 在另一个Pod中查看文件。

      以名为cpfs-test-****-***bPod作为示例:

      kubectl exec cpfs-test-****-***b -- ls /data

      预期返回如下,可以看到已共享新建的文件test.txt

      test.txt
  3. 验证持久化存储。

    1. 重建Deployment。

      kubectl rollout restart deploy cpfs-test
    2. 查看Pod,等待新Pod创建成功。

      kubectl get pod | grep cpfs-test

      返回示例如下:

      cpfs-test-****-***c   1/1     Running   0          78s
      cpfs-test-****-***d   1/1     Running   0          52s
    3. 在新Pod中查看文件系统中的数据是否存在。

      以名为cpfs-test-c***Pod作为示例:

      kubectl exec cpfs-test-****-***c -- ls /data

      预期返回如下,可以看到CPFS文件系统中的数据依然存在,在新Pod的挂载目录下可以重新获取。

      test.txt