# 极速文件存储卷（SFS Turbo）
云容器实例支持创建[弹性文件存储](https://www.huaweicloud.com/product/sfs.html)SFS Turbo（极速文件存储）并挂载到容器的某一路径下，极速文件存储具有按需申请，快速供给，弹性扩展，方便灵活等特点，适用于DevOps、容器微服务、企业办公等应用场景。
#### 使用限制
- 待挂载的极速文件存储必须是按需付费。更多信息，请参见[极速文件存储计费](https://www.huaweicloud.com/pricing/calculator.html#/sfsturbo)。
- 极速文件存储和负载必须在同一个VPC下，否则负载无法使用极速文件存储卷。
- 使用极速文件存储期间，不能修改极速文件存储关联的VPC配置信息，否则CCI中容器无法访问极速文件存储。
- 请谨慎执行极速文件存储的删除操作，以避免造成CCI中容器不可用。
- SFS Turbo文件系统无可用区概念，SFS Turbo PV不支持配置可用区亲和。
- CCI 2.0当前仅支持在西南-贵阳一和华东-上海一局点使用SFS Turbo。
 
#### 通过API创建极速文件存储
云容器实例目前仅支持通过PVC静态绑定的方式使用极速文件存储。
1. 创建SFS Turbo文件系统，详见[创建SFS Turbo文件系统](https://support.huaweicloud.com/usermanual-sfsturbo/sfsturbo_01_0359.html)。
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//"
      ```
      ![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002222901506.png "点击放大")
      
   
   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的共享路径。
      ![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002257871121.png "点击放大")
      
      创建PV请求响应如下。
      ![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002223000630.png "点击放大")
      
   
   
   
   
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。
      ![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002223017932.png "点击放大")
      
   
   
   
   
 
#### 使用极速文件存储卷
请参考[4.1-无状态负载](https://support.huaweicloud.com/usermanual-cci2/cci_01_0011.html)。在负载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%
```
![](https://support.huaweicloud.com/usermanual-cci2/public_sys-resources/note_3.0-zh-cn.png)
- 创建极速文件存储过程中需要创建单独的虚拟机，耗时较长。因此当前仅支持使用已有的极速文件存储卷。
- 挂载子路径为极速文件存储根路径下的子路径，如果不存在会自动在文件存储中创建。该路径必须为相对路径。
- 使用极速文件存储卷，只支持通过YAML或者ccictl方式创建负载。