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

通常情况下，在工作负载容器中挂载SFS类型的存储卷时，默认会将根目录挂载到容器中。为了更加经济合理地利用存储容量，CCE支持在创建PVC时动态创建SFS子目录，实现不同工作负载共享使用SFS。

仅通用文件系统（SFS 3.0）支持动态创建子目录。

前提条件

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

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

登录CCE控制台，单击集群名称进入集群。

在左侧导航栏选择“存储”，在右侧选择“存储卷声明”页签。单击右上角“创建存储卷声明”，在弹出的窗口中填写存储卷声明参数。

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

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

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

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

使用kubectl连接集群。

创建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。