更新时间:2022-05-19 GMT+08:00
分享

使用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会由于底层存储不在了,使用出现异常。
    • 重复用底层存储时,建议在应用层做好多读多写的隔离保护,防止产生的数据覆盖和丢失。

操作步骤

  1. 登录SFS控制台,创建一个文件存储,记录文件存储的ID、共享路径和容量。
  2. 请参见通过kubectl连接集群,使用kubectl连接集群。
  3. 新建两个yaml文件,用于创建PersistentVolume(PV)、PersistentVolumeClaim(PVC)。假设文件名分别为pv-sfs-example.yamlpvc-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的名称。

    图1 弹性文件存储-共享路径

    文件存储所在VPC必须与工作负载规划部署的ECS虚拟机的VPC保持一致。

  4. 创建PV。

    kubectl create -f pv-sfs-example.yaml

  5. 创建PVC。

    kubectl create -f pvc-sfs-example.yaml

分享:

    相关文档

    相关产品

close