极速文件存储卷（SFS Turbo）

使用限制

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

导入极速文件存储

云容器实例目前仅支持通过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方式创建负载。