Container Compute Service：使用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