极速文件存储卷（SFS Turbo）

使用限制

• 待挂载的极速文件存储必须是按需付费。更多信息，请参见极速文件存储计费。
• 极速文件存储和负载必须在同一个VPC下，否则负载无法使用极速文件存储卷。
• 使用极速文件存储期间，不能修改极速文件存储关联的VPC配置信息，否则CCI中容器无法访问极速文件存储。
• 请谨慎执行极速文件存储的删除操作，以避免造成CCI中容器不可用。
• SFS Turbo文件系统无可用区概念，SFS Turbo PV不支持配置可用区亲和。
• CCI 2.0当前仅支持在西南-贵阳一和华东-上海一局点使用SFS Turbo。

通过控制台创建极速文件存储

存储卷声明（PVC）是工作负载申请底层存储资源的凭证。通过 CCI 控制台，您可以可视化的方式快速创建 PVC。在创建过程中，您可以选择现有的空闲存储卷（PV），也可以为了简化操作，在创建 PVC 的同时一并“新建存储卷 PV”。

1. 登录云容器实例 CCI 2.0控制台。
2. 左侧导航栏中选择“存储管理 > 存储卷声明”，单击“创建存储卷声明 PVC”。
3. 在弹出的创建页面中，配置PVC的基础信息：

   PVC名称：为您的存储卷声明自定义一个名称。

4. 选择创建方式，并完善相关挂载配置。根据您的实际需求，分为以下两种情况：
   • 情况一：已有存储卷PV

     选择“已有存储卷 PV”后，系统会自动筛选出存储类型匹配且处于未绑定状态的 PV。您只需在下拉菜单中选择目标 PV 即可。

   • 情况二：新建存储卷PV
     选择“新建存储卷 PV”后，界面下方会展开对应存储类型的 PV 配置参数。以挂载极速文件存储（SFS Turbo）为例，您需要继续填写以下信息：

     • 存储资源：在下拉列表中选择您已购买的SFS Turbo实例。

     • 子目录：选填。指定极速文件存储根路径下的子路径，该路径必须为相对路径；如果该子目录在底层存储中不存在，系统会自动创建。
     • PV 名称：系统会默认提供前缀（如 pv-efs-），请补充完整的PV 名称以便于区分。
     • 访问模式：极速文件存储支持多节点共享访问，默认且必须为 ReadWriteMany（多读多写）。
     • 回收策略：极速文件存储当前只支持 Retain（保留）策略。当您在 CCI 中删除 PVC 后，PV 资源与底层的真实存储数据均不会被自动删除，保障数据安全。PVC 删除后 PV 状态会变为“已释放（Released）”，如需清理请手动删除。
     • 挂载参数：您可以单击“添加挂载参数”添加相关键和值，便于后续的资源分类与成本管理。

5. 信息确认无误后，单击“确定”完成创建。

   在列表中可查看已创建的PVC。

通过YAML创建极速文件存储

极速文件存储在CCI中依赖静态绑定机制，即PVC需要绑定一个已存在的PV。 如果已经提前创建好了PV，您可以跳过3，直接创建PVC即可。

1. 登录云容器实例 CCI 2.0控制台。
2. 左侧导航栏中选择“存储管理”。
3. 通过YAML创建PV。
   1. 单击“存储卷”页签。
   2. 单击“YAML 创建”。
   3. 导入或者添加YAML，单击“确定”。在列表中可查看已创建的PV。

      示例如下：

      apiVersion: cci/v2    
      kind: PersistentVolume
      metadata:
        name: pv-efs-123     # 您的PV名称
      spec:
        capacity:
          storage: 40Gi      # 存储容量：与SFS Turbo的实际大小保持一致
        csi:
          driver: sfsturbo.csi.everest.io  # 挂载依赖的存储驱动：必须为该值
          volumeHandle: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # 极速文件存储的ID
          fsType: nfs                      # 存储实例类型
          volumeAttributes:
            everest.io/share-export-location: xxxxxxxxxxx:/ # SFS Turbo的共享路径
        accessModes:
          - ReadWriteMany    # 访问模式：极速文件存储必须为ReadWriteMany
        persistentVolumeReclaimPolicy: Retain # 回收策略：目前只支持Retain
        storageClassName: csi-sfsturbo        # 存储类名称：必须配置为csi-sfsturbo
        volumeMode: Filesystem                # 存储卷模式：文件系统

4. 通过YAML创建PVC。
   1. 单击“存储卷声明”页签。
   2. 单击“YAML 创建”。
   3. 导入或者添加YAML，单击“确定”。在列表中可查看已创建的PVC。
      示例如下：

      apiVersion: cci/v2           
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfsturbo-test     # 您的 PVC 名称
        namespace: test # 您的命名空间（如果不填默认创建在 default 下）
      spec:
        accessModes:
          - ReadWriteMany      # 极速文件存储卷必须为 ReadWriteMany
        resources:
          requests:
            storage: 40Gi      # 申请容量：与您要绑定的已有 PV 的容量完全一致
        volumeName: pv-efs-xxxxx # 【关键字段】PV的名称：必须与您已经创建好的已有 PV 名称一致，以实现静态绑定
        storageClassName: csi-sfsturbo # 存储类名称：极速文件存储必须为 csi-sfsturbo

通过API创建极速文件存储

云容器实例目前仅支持通过PVC静态绑定的方式使用极速文件存储。

1. 创建SFS Turbo文件系统，详见创建SFS Turbo文件系统。
2. 创建PV。
   1. 获取IAM token

       curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -X POST -d '{"auth": {"identity":{"methods": ["password"],"password":{"user": {"name": "$username","password": "$password","domain": {"name": "$domain"}}}},"scope": {"project":{"name": "$project"}}}}' https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens | grep "X-Subject-Token"|awk -F ": " '{print $2}'|sed "s/\r//"

      

   2. 调用接口创建PV

       curl -H "X-Auth-Token:$token" -H 'Content-Type: application/json' -X POST -d @pv.json  -k -v https://cci.cn-north-4.myhuaweicloud.com/apis/cci/v2/persistentvolumes

      其中$token为2.a中获取的IAM token，pv.json为您要创建的PV信息，示例json如下：

      {
              "apiVersion": "cci/v2",
              "kind": "PersistentVolume",
              "metadata": {
                  "annotations": {
                  },
                  "name": "pv-sfs-test"
              },
              "spec": {
                  "accessModes": [
                      "ReadWriteMany"
                  ],
                  "capacity": {
                      "storage": "500Gi"
                  },
                  "csi": {
                      "driver": "sfsturbo.csi.everest.io",
                      "fsType": "nfs",
                      "volumeHandle": "**************", 
                      "volumeAttributes": {
                          "everest.io/share-export-location": "*******"
                      }
                  },
                  "persistentVolumeReclaimPolicy": "Retain",
                  "storageClassName": "csi-sfsturbo",
                  "mountOptions": [
                  ]
              }
          }

      表1 关键参数说明

      参数	是否必选	参数类型	描述
      accessModes	是	List	参数解释：存储访问模式。 约束限制：极速文件存储卷必须为ReadWriteMany。
      driver	是	String	参数解释：挂载依赖的存储驱动。 约束限制：极速文件存储卷必须为sfsturbo.csi.everest.io。
      fsType	是	String	参数解释：存储实例类型。 约束限制：支持“nfs”，nfs为文件存储卷。
      volumeHandle	是	String	参数解释：极速文件存储的ID。 约束限制：必须为已创建的极速文件存储的ID。
      persistentVolumeReclaimPolicy	是	String	参数解释：PV卷回收策略。 约束限制：目前只支持Retain回收策略。 Retain：删除PVC，PV资源与底层存储资源均不会被删除，需要手动删除回收。PVC删除后PV资源状态为“已释放（Released）”，不能直接再次被PVC绑定使用。
      storage	是	String	参数解释：存储容量，单位为Gi。 约束限制：设置为极速文件存储的大小。
      storageClassName	是	String	参数解释：极速文件存储卷对应的存储类名称。 约束限制：极速文件存储卷对应的存储类名称为csi-sfsturbo。

      其中volumeHandle为您在1创建的SFS Turbo的ID，everest.io/share-export-location为您在1创建的SFS Turbo的共享路径。

      

      创建PV请求响应如下。

      

3. 创建PVC。
   1. 获取IAM token，参见2.a。
   2. 调用接口创建PVC绑定创建的PV。

      curl -H "X-Auth-Token:$token" -H 'Content-Type: application/json' X POST -d @pvc.json  -k -v https://cci.cn-north-4.myhuaweicloud.com/apis/cci/v2/namespaces/${namespace}/persistentvolumeclaims

      其中pvc.json为您要创建的PVC信息，示例json如下：

      {
              "apiVersion": "cci/v2",
              "kind": "PersistentVolumeClaim",
              "metadata": {
                  "name": "pvc-sfs",
                  "annotations": {
                  }
              },
              "spec": {
                  "accessModes": [
                      "ReadWriteMany"
                  ],
                  "resources": {
                      "requests": {
                          "storage": "500Gi"
                      }
                  },
                  "storageClassName": "csi-sfsturbo",
                  "volumeName": "pv-sfs-test"
              }
          }

      表2 关键参数说明

      参数	是否必填	参数类型	描述
      storage	是	String	参数解释：PVC申请容量，单位为Gi。 约束限制： 设置为极速文件存储的大小。 与表1中PV设置的容量值相同。
      storageClassName	是	String	参数解释：存储类名称。 约束限制：必须与表1中PV的存储类一致，对应极速文件存储卷的存储类名称为csi-sfsturbo。
      volumeName	是	String	参数解释：PV的名称。 约束限制：必须与表1中PV名称一致。

      其中volumeName为您在3创建的PV名称。

      创建PVC请求响应如下，可以看到PVC已经绑定到PV。

      

使用极速文件存储卷

请参考4.1-无状态负载。在负载YAML中增加volume相关配置。

kind: Deployment
apiVersion: cci/v2
metadata:
  name: nginx
  namespace: test-ns
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      volumes:
        - name: my-storage
          persistentVolumeClaim:
            claimName: PVC名称
      containers:
        - name: nginx
          image: nginx:latest
          resources:
            limits:
              cpu: 500m
              memory: 1Gi
            requests:
              cpu: 500m
              memory: 1Gi
          volumeMounts:
            - name: my-storage
              mountPath: 容器内挂载路径
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
      restartPolicy: Always
      terminationGracePeriodSeconds: 30
      dnsPolicy: Default
      securityContext: {}
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 25%
      maxSurge: 25%

• 创建极速文件存储过程中需要创建单独的虚拟机，耗时较长。因此当前仅支持使用已有的极速文件存储卷。
• 挂载子路径为极速文件存储根路径下的子路径，如果不存在会自动在文件存储中创建。该路径必须为相对路径。
• 使用极速文件存储卷，只支持通过YAML或者ccictl方式创建负载。

相关操作

您还可以根据实际需求执行表3中的其他操作。