通过动态存储卷创建SFS子目录

前提条件

• 您已经创建好一个集群，并且在该集群中安装2.4.41及以上版本的CCE容器存储（Everest）。
• 如果您需要通过命令行创建，需要使用kubectl连接到集群，详情请参见通过kubectl连接集群。
• 您已经创建好一个状态可用的SFS，并且SFS与集群在同一个VPC内。使用通用文件系统（SFS 3.0）时，您需要提前在集群所在VPC创建一个VPC终端节点，集群需要通过VPC终端节点访问通用文件系统。配置VPC终端节点的方法请参见配置VPC终端节点。

通过控制台动态创建SFS子目录

1. 登录CCE控制台，单击集群名称进入集群。
2. 在左侧导航栏选择“存储”，在右侧选择“存储卷声明”页签。单击右上角“创建存储卷声明”，在弹出的窗口中填写存储卷声明参数。

   参数	描述
   存储卷声明类型	本文中选择“文件存储”。
   PVC名称	输入PVC的名称，同一命名空间下的PVC名称需唯一。
   创建方式	选择“动态创建子目录”。
   存储类	选择文件存储对应的存储类为csi-sfs。 您可以自建存储类并配置回收策略和绑定模式，具体操作请参见通过控制台创建StorageClass。
   访问模式	文件存储类型的存储卷仅支持ReadWriteMany，表示存储卷可以被多个节点以读写方式挂载，详情请参见存储卷访问模式。
   文件存储	单击“选择文件存储”，您可以在新页面中勾选满足要求的文件存储，并单击“确定”。
   子目录	请填写子目录绝对路径，例如/a/b。
   子目录回收策略	删除PVC时是否保留子目录。 保留：删除PVC，PV会被删除，但PV关联的子目录会被保留。 删除：删除PVC，PV及其关联的子目录均会被删除。 说明： 删除子目录时，仅删除PVC参数中设置的子目录绝对路径，不会级联删除上层目录。

3. 单击“创建”，将同时为您创建存储卷声明和存储卷。

   您可以在左侧导航栏中选择“存储”，在“存储卷声明”和“存储卷”页签下查看已经创建的存储卷声明和存储卷。

通过kubectl命令行动态创建SFS子目录

1. 使用kubectl连接集群。
2. 创建pvc-sfs-subpath.yaml文件。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: pvc-sfs-subpath    # PVC的名称
     namespace: default
     annotations:
       everest.io/csi.volume-as: absolute-path                # 表示使用SFS子目录
       everest.io/csi.sfs30-name: <sfs_name>                    # SFS实例的名称
       everest.io/csi.path: /a                                # 自动创建的子目录，必须为绝对路径
       everest.io/csi.reclaim-policy: retain-volume-only      # 表示删除PVC时，PV会被删除，但PV关联的子目录会被保留
   spec:
     accessModes:
       - ReadWriteMany      # SFS必须为ReadWriteMany
     resources:
       requests:
         storage: 1Gi      # 对于SFS子目录类型的PVC，此处无实际意义，仅作校验需要（不能为空和0）
     storageClassName: csi-sfs     # 通用文件系统（SFS 3.0）存储类名称

   表1 关键参数说明

   参数	是否必选	描述
   everest.io/csi.volume-as	是	使用动态创建SFS 子目录时，固定取值为“absolute-path”。
   everest.io/csi.sfs30-name	是	SFS实例的名称。
   everest.io/csi.path	是	自动创建的子目录，必须为绝对路径。
   everest.io/csi.reclaim-policy	是	删除PVC时是否保留子目录，该参数需与PV回收策略配合使用。仅当PV回收策略为"Delete"时生效，取值如下： retain-volume-only：表示删除PVC时，PV会被删除，但PV关联的子目录会被保留。 delete：表示删除PVC，PV及其关联的子目录均会被删除。 说明： 删除子目录时，仅删除PVC参数中设置的子目录绝对路径，不会级联删除上层目录。
   storage	是	PVC申请容量，单位为Gi。 对SFS子目录类型的PVC来说，此处仅为校验需要（不能为空和0），设置的大小不起作用，此处可以设定为固定值1Gi。

3. 执行以下命令，创建PVC。

   kubectl apply -f pvc-sfs-subpath.yaml