使用OSS静态存储卷

步骤一：创建PV

1. 将以下YAML内容保存为oss-pv.yaml。

   apiVersion: v1
   kind: Secret
   metadata:
     name: oss-secret
     namespace: default
   stringData:
     akId: <your AccessKey ID>
     akSecret: <your AccessKey Secret>
   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: oss-pv
     labels:
       alicloud-pvname: oss-pv
   spec:
     storageClassName: test 
     capacity:
       storage: 20Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       volumeHandle: oss-pv
       nodePublishSecretRef:
         name: oss-secret
         namespace: default
       volumeAttributes:
         fuseType: ossfs2 # 显式声明使用ossfs 2.0客户端
         bucket: "<your OSS Bucket Name>"
         url: "<your OSS Bucket Endpoint>"
         otherOpts: "-o close_to_open=false" # 注意：支持的挂载参数与ossfs 1.0客户端不兼容

   说明

   以上YAML可以创建一个Secret和一个PV。Secret用于保存AccessKey，以便在PV中可以安全使用。请使用实际的AccessKey ID和AccessKey Secret替换akId和akSecret的取值。

   PV的相关参数说明如下：

   参数	说明
   alicloud-pvname	PV的标签。用于绑定PVC。
   storageClassName	该配置仅用于绑定PVC，无需关联实际的StorageClass。
   storage	OSS存储卷的容量大小。 说明 OSS静态卷的容量仅起声明效果，实际容量不受限制，可使用量以OSS控制台显示为准。
   accessModes	访问模式。
   persistentVolumeReclaimPolicy	回收策略。
   driver	驱动类型。此处配置为ossplugin.csi.alibabacloud.com，表示使用阿里云OSS CSI插件。
   volumeHandle	PV的唯一标识符，与metadata.name保持一致。
   nodePublishSecretRef	从指定的Secret中获取AccessKey，用于授权认证。
   fuseType	使用ossfs 2.0客户端时，固定为ossfs2。
   bucket	OSS Bucket的名称。请使用实际的OSS Bucket名称替换bucket的取值。
   url	OSS Bucket的接入域名（Endpoint）。请使用实际的OSS Bucket的Endpoint替换url的取值。 OSS Bucket和ACS集群属于相同地域时，使用VPC内网的Endpoint。例如oss-cn-shanghai-internal.aliyuncs.com。 OSS Bucket没有地域属性，或者和ACS集群属于不同地域时，使用外网的Endpoint。例如oss-cn-shanghai.aliyuncs.com。
   otherOpts	为OSS存储卷输入定制化参数，格式为-o *** -o ***，例如-o close_to_open=false。 close_to_open：默认为关闭。开启后，每次打开文件时，系统会主动向OSS发送GetObjectMeta请求，以获取文件在OSS中的最新元数据信息，从而确保元数据的实时性。但在需要大量读取小文件的场景下，频繁的元数据查询会显著增加访问延迟。 更多可选参数，请参见ossfs 2.0挂载选项说明。

2. 创建Secret和PV。

   kubectl create -f oss-pv.yaml

3. 查看PV。

   kubectl get pv

   预期返回：

   NAME     CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   oss-pv   20Gi       RWX            Retain           Available           test           <unset>                          9s

步骤二：创建PVC

1. 将以下YAML内容保存为oss-pvc.yaml。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: oss-pvc
   spec:
     storageClassName: test
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 20Gi
     selector:
       matchLabels:
         alicloud-pvname: oss-pv

   相关参数说明如下：

   参数	说明
   storageClassName	该配置仅用于绑定PV，无需关联实际的StorageClass。与PV的spec.storageClassName保持一致。
   accessModes	访问模式。
   storage	分配给Pod的存储容量。不能高于OSS存储卷的容量。
   alicloud-pvname	要绑定的PV的标签。与PV的metadata.labels.alicloud-pvname保持一致。

2. 创建PVC。

   kubectl create -f oss-pvc.yaml

3. 查看PVC。

   kubectl get pvc

   预期返回如下，此时PVC已绑定步骤一创建的PV。

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

步骤三：创建应用并挂载OSS

1. 使用以下YAML内容，创建oss-test.yaml文件。

   以下YAML示例可以创建包含2个Pod的Deployment，2个Pod均通过名为oss-pvc的PVC申请存储资源，挂载路径均为/data。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-test
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
           ports:
           - containerPort: 80
           volumeMounts:
             - name: pvc-oss
               mountPath: /data
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               claimName: oss-pvc

2. 创建Deployment并挂载OSS。

   kubectl create -f oss-test.yaml

3. 查看Deployment中Pod的部署情况。

   kubectl get pod | grep oss-test

   返回示例如下，已创建2个Pod。

   oss-test-****-***a   1/1     Running   0          28s
   oss-test-****-***b   1/1     Running   0          28s

4. 查看挂载路径。

   命令示例如下，预期会返回OSS Bucket挂载目录下的数据,默认为空。

   kubectl exec oss-test-****-***a -- ls /data