使用kubectl对接已有文件存储

操作场景

CCE支持使用已有的文件存储来创建PersistentVolume，创建成功后，通过创建相应的PersistentVolumeClaim来绑定当前的PersistentVolume使用。

前提条件

您已经创建好一个CCE集群，并且在该集群中安装CSI插件（Everest）。

约束与限制

如下配置示例适用于Kubernetes 1.15及以上版本的集群。
如需配置挂载参数，Everest插件版本要求1.2.8及以上版本。
支持多个PV挂载同一个SFS，但有如下限制：
- 多个不同的PVC/PV使用同一个底层SFS卷时，且被同一Pod使用会出现问题，需要避免这么使用。
- PV中persistentVolumeReclaimPolicy参数需设置为Retain，否则可能存在一个PV删除时，级联删除底层卷，其他关联这个底层卷的PV会由于底层存储不在了，使用出现异常。
- 重复用底层存储时，建议在应用层做好多读多写的隔离保护，防止产生的数据覆盖和丢失。

操作步骤

登录SFS控制台，创建一个文件存储，记录文件存储的ID、共享路径和容量。
请参见通过kubectl连接集群，使用kubectl连接集群。

新建两个yaml文件，用于创建PersistentVolume（PV）、PersistentVolumeClaim（PVC）。假设文件名分别为pv-sfs-example.yaml、pvc-sfs-example.yaml。

touch pv-sfs-example.yaml pvc-sfs-example.yaml

vi pv-sfs-example.yaml

PV yaml文件配置示例：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv-sfs-example
  annotations:
    pv.kubernetes.io/provisioned-by: everest-csi-provisioner
spec:
  mountOptions:
  - hard
  - timeo=600
  - nolock
  accessModes:
  - ReadWriteMany
  capacity:
    storage: 10Gi
  claimRef:
    apiVersion: v1
    kind: PersistentVolumeClaim
    name: pvc-sfs-example
    namespace: default
  csi:
    driver: nas.csi.everest.io
    fsType: nfs
    volumeAttributes:
      everest.io/share-export-location: sfs-nas01.cn-north-4.myhuaweicloud.com:/share-436304e8 
      storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
    volumeHandle: 682f00bb-ace0-41d8-9b3e-913c9aa6b695
  persistentVolumeReclaimPolicy: Delete
  storageClassName: csi-nas

表1 关键参数说明
参数	描述
driver	挂载依赖的存储驱动，文件存储配置为“nas.csi.everest.io”。
everest.io/share-export-location	文件存储的共享路径。获取方法：在CCE控制台，单击顶部的“服务列表 > 存储 > 弹性文件服务”，在弹性文件服务列表中可以看到“挂载地址”列，即为文件存储的共享路径，如图1。
volumeHandle	文件存储的ID。获取方法：在CCE控制台，单击顶部的“服务列表 > 存储 > 弹性文件服务”，在弹性文件服务列表中单击对应的弹性文件服务名称，在详情页中复制“ID”后的内容即可。
storage	文件存储的大小。
storageClassName	k8s storage class名称；需配置为"csi-nas"。
spec.mountOptions	挂载参数。不设置时默认配置为如下配置，具体说明请参见文件存储挂载参数。如需配置挂载参数，Everest插件版本要求1.2.8及以上版本。 mountOptions: - vers=3 - timeo=600 - nolock - hard
spec.claimRef.apiVersion	固定值"v1"。
spec.claimRef.kind	固定值"PersistentVolumeClaim"。
spec.claimRef.name	pvc名称；与下一步创建的pvc的name一致。
spec.claimRef.namespace	pvc的namespace；与下一步创建的pvc的namespace一致。

vi pvc-sfs-example.yaml

PVC yaml文件配置示例：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  annotations:
    volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
  name: pvc-sfs-example
  namespace: default
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: csi-nas
  volumeName: pv-sfs-example

表2 关键参数说明
参数	描述
storageClassName	需配置为"csi-nas"。必须和已有PV保持一致。
storage	存储容量，单位Gi，必须和已有pv的storage大小保持一致。
volumeName	PV的名称。