使用ossfs 2.0存储卷

创建PV。

1. 修改以下YAML，保存为ossfs2-pv.yaml。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv-ossfs2
   spec:
     capacity:
       storage: 20Gi
     accessModes:
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       volumeHandle: pv-ossfs2 # 需要和PV名字一致。
       # 使用准备工作中创建的Secret。
       nodePublishSecretRef:
         name: oss-secret
         namespace: default
       volumeAttributes:
         fuseType: ossfs2
         bucket: cnfs-oss-test
         path: /subpath
         url: oss-cn-hangzhou-internal.aliyuncs.com
         otherOpts: "-o close_to_open=false"

   • nodePublishSecretRef参数说明

     参数	是否必选	说明
     name	必选	存储AccessKey信息的Secret名称。
     namespace	必选	存储AccessKey信息的Secret所在的命名空间。

   • volumeAttributes参数说明

     参数	是否必选	说明
     fuseType	必选	使用ossfs 2.0客户端时，固定为ossfs2。
     bucket	必选	需要挂载的OSS Bucket。
     path	可选	OSS Bucket挂载路径，表示挂载时相对Bucket根文件的目录结构。
     url	必选	挂载OSS的Endpoint，Endpoint以OSS控制台Bucket概览页为准。 挂载节点和Bucket相同地域，或已打通VPC网络时，请使用内网地址。 挂载节点和Bucket不同地域时，请使用外网地址。 不同访问端口的常见填写格式如下： 内网格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 外网格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。 重要 vpc100-oss-{{regionName}}.aliyuncs.com的内网访问端口格式已废弃，请及时切换。
     otherOpts	可选	您可以为OSS存储卷输入定制化参数，格式为-o *** -o ***，例如-o close_to_open=false。 说明 close-to-open：默认为关闭。开启后，每次打开文件时，系统会主动向OSS发送GetObjectMeta请求，以获取文件在OSS中的最新元数据信息，从而确保元数据的实时性。但在需要大量读取小文件的场景下，频繁的元数据查询会显著增加访问延迟。 更多可选参数，请参见ossfs 2.0挂载选项说明。

2. 创建PV。

   kubectl create -f ossfs2-pv.yaml

3. 确认PV状态。

   kubectl get pv pv-ossfs2

   预期返回如下，确认PV的状态为Available。

   NAME        CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   pv-ossfs2   20Gi       ROX            Retain           Available                          <unset>                          15s

创建PVC。

1. 修改以下YAML，保存为ossfs2-pvc-static.yaml。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: pvc-ossfs2
     namespace: default
   spec:
     # 以下配置需要与PV一致
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         storage: 20Gi
     volumeName: pv-ossfs2

2. 创建PVC。

   kubectl create -f ossfs2-pvc-static.yaml

3. 确认PVC状态。

   kubectl get pvc pvc-ossfs2

   预期返回如下，可以看到PVC已绑定PV。

   NAME         STATUS   VOLUME      CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-ossfs2   Bound    pv-ossfs2   20Gi       ROX                           <unset>                 6s

创建StorageClass。

1. 修改以下YAML，保存为ossfs2-sc.yaml。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: ossfs2-test
   parameters:
     # 使用准备工作中创建的Secret。
     csi.storage.k8s.io/node-publish-secret-name: oss-secret  
     csi.storage.k8s.io/node-publish-secret-namespace: default
     fuseType: ossfs2
     bucket: cnfs-oss-test 
     path: /subpath
     url: oss-cn-hangzhou-internal.aliyuncs.com 
     otherOpts: "-o close_to_open=false"
   provisioner: ossplugin.csi.alibabacloud.com
   reclaimPolicy: Retain
   volumeBindingMode: Immediate

   parameters中的相关参数说明如下：

   • 配置Secret

     参数	是否必选	说明
     csi.storage.k8s.io/node-publish-secret-name	必选	存储AccessKey信息的Secret名称。
     csi.storage.k8s.io/node-publish-secret-namespace	必选	存储AccessKey信息的Secret所在的命名空间。

   • 配置存储卷

     参数	是否必选	说明
     fuseType	必选	使用ossfs 2.0客户端时，固定为ossfs2。
     bucket	必选	需要挂载的OSS Bucket。
     path	可选	OSS Bucket挂载路径，表示挂载时相对Bucket根文件的目录结构。
     url	必选	挂载OSS的Endpoint，Endpoint以OSS控制台Bucket概览页为准。 挂载节点和Bucket相同地域，或已打通VPC网络时，请使用内网地址。 挂载节点和Bucket不同地域时，请使用外网地址。 不同访问端口的常见填写格式如下： 内网格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 外网格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。 重要 vpc100-oss-{{regionName}}.aliyuncs.com的内网访问端口格式已废弃，请及时切换。
     otherOpts	可选	您可以为OSS存储卷输入定制化参数，格式为-o *** -o ***，例如-o close_to_open=false。 说明 close-to-open：默认为关闭。开启后，每次打开文件时，系统会主动向OSS发送GetObjectMeta请求，以获取文件在OSS中的最新元数据信息，从而确保元数据的实时性。但在需要大量读取小文件的场景下，频繁的元数据查询会显著增加访问延迟。 更多可选参数，请参见ossfs 2.0挂载选项说明。

2. 创建StorageClass。

   kubectl create -f ossfs2-sc.yaml

创建PVC。

1. 修改以下YAML，保存为ossfs2-pvc-dynamic.yaml。

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: pvc-ossfs2
     namespace: default
   spec:
     # 仅支持ReadOnlyMany访问模式
     accessModes:
       - ReadOnlyMany
     # 指定StorageClass
     storageClassName: ossfs2-test
     resources:
       requests:
         storage: 20Gi

2. 创建PVC。

   kubectl create -f ossfs2-pvc-dynamic.yaml

3. 确认PVC状态。

   kubectl get pvc pvc-ossfs2

   预期返回如下，可以看到PVC已绑定CSI自动创建的PV。

   NAME         STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-ossfs2   Bound    oss-169da564-d720-4819-b765-4653d45a01dc   20Gi       ROX            ossfs2-test    <unset>                 3s