Container Service for Kubernetes：使用ossfs 1.0動態儲存裝置卷掛載OSS Bucket

1、建立儲存類StorageClass

1. 建立Secret，該Secret選擇的Namespace需要和應用所在的Namespace一致。

   替換以下akId和akSecret為此前擷取的AccessKey ID和AccessKey Secret。

   kubectl create secret generic oss-secret --from-literal='akId=<yourAccessKey ID>' --from-literal='akSecret=<yourAccessKey Secret>'

2. 建立儲存類。

   1. 建立sc-oss.yaml。

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: sc-oss
      parameters:
        # 替換為實際Bucket名稱
        bucket: bucket
        # 掛載Bucket的根目錄或指定子目錄
        path: /
        # Bucket所在地區的Endpoint
        url: "http://oss-cn-hangzhou-internal.aliyuncs.com" 
        # 儲存AccessKey資訊的Secret名稱
        csi.storage.k8s.io/node-publish-secret-name: oss-secret
        # 儲存AccessKey資訊的Secret所在的命名空間
        csi.storage.k8s.io/node-publish-secret-namespace: default
        # 定製化參數
        otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
      # 使用阿里雲OSS CSI外掛程式時固定為此值
      provisioner: ossplugin.csi.alibabacloud.com
      # 動態建立的PV的回收策略
      reclaimPolicy: Retain
      # 繫結模式
      volumeBindingMode: Immediate
      

      參數	說明
      name	儲存類名稱。
      bucket	待掛載的OSS Bucket。
      path	CSI組件版本需為v1.14.8.32-c77e277b-aliyun及以上。 指定掛載點相對於 Bucket 根目錄的路徑。預設為 /，即掛載整個 Bucket。 ossfs版本小於1.91時，指定的 path 必須在 OSS Bucket 中預先存在。詳見ossfs 1.91及以上版本新增功能說明
      url	待掛載OSS的訪問網域名稱（Endpoint）。 掛載節點和Bucket處於相同地區，或已打通VPC網路時，使用內網地址。 掛載節點和Bucket不同地區時，使用外網地址。 不同訪問連接埠的常見填寫格式如下： 內網格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 內網訪問連接埠格式vpc100-oss-{{regionName}}.aliyuncs.com已廢棄，請及時切換。 外網格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。
      csi.storage.k8s.io/node-publish-secret-name	儲存AccessKey資訊的Secret名稱。
      csi.storage.k8s.io/node-publish-secret-namespace	儲存AccessKey資訊的Secret所在的命名空間。
      otherOpts	為OSS儲存卷輸入定製化參數，格式為-o *** -o ***，例如-o umask=022 -o max_stat_cache_size=100000 -o allow_other。 展開查看說明 umask：更改ossfs讀檔案的許可權。 例如，umask=022可將ossfs檔案的許可權變更為755，解決通過SDK、OSS控制台等其他方式上傳的檔案（預設許可權為640）在掛載點內許可權不足的問題。推薦在讀寫分離或多使用者訪問時配置。 max_stat_cache_size：設定中繼資料快取的條目上限（例如100000），在記憶體中快取檔案元資訊來提升 ls、stat 等操作的效能。 但該緩衝無法及時感知通過OSS控制台、SDK、ossutil等方式對檔案的修改，可能導致應用讀取資料不一致。在對資料一致性有強要求時可將其設為0（禁用緩衝），或通過stat_cache_expire參數調低緩衝的失效時間，但會犧牲讀取效能。 allow_other：允許除掛載使用者外的其他使用者訪問掛載點中的檔案和目錄，適用於需要讓非掛載使用者也能訪問資料的多使用者共用環境。 更多選擇性參數，請參見掛載選項說明、ossfs 1.0配置最佳實務。
      provisioner	驅動類型。使用阿里雲OSS CSI外掛程式時固定為ossplugin.csi.alibabacloud.com。
      reclaimPolicy	動態建立的PV的回收策略。當前OSS儲存卷僅支援Retain，即刪除PVC時，PV和OSS Bucket中的資料不會隨之刪除。
      volumeBindingMode	繫結模式。 OSS儲存卷無需考慮可用性區域間節點親和，使用預設值Immediate即可。
      volumeAs	儲存卷訪問模式。預設為sharepath模式。取值： sharepath：即共用方式掛載，所有儲存卷共用掛載路徑，即資料存放區於<bucket>:<path>/下。 subpath：即子目錄方式掛載。PVC使用此StorageClass請求儲存資源時，CSI會使用自動建立的PV名稱作為子目錄名稱，實現資料隔離。資料存放區路徑格式為<bucket>:<path>/<pv-name>/。 此參數僅在CSI組件為1.31.3及以上版本時生效。
      sigVersion	請求OSS服務端的請求籤名版本。 "v1"（預設）：使用OSS簽名版本1。 "v4"：使用OSS簽名版本4（推薦）。

   2. 建立StorageClass。

      kubectl apply -f sc-oss.yaml

1. 將步驟一擷取的AccessKey儲存為Secret，供PV使用。

   1. 在ACK叢集列表頁面，單擊目的地組群名稱，在叢集詳情頁左側導覽列，選擇配置管理 > 保密字典。

   2. 單擊使用YAML建立資源，按照頁面提示，完成Secret的建立。

      apiVersion: v1
      kind: Secret
      metadata:
        name: oss-secret
        # 需與應用所在的命令空間保持一致
        namespace: default
      stringData:
        # 替換為此前擷取的AccessKey ID
        akId: <your AccessKey ID>
        # 替換為此前擷取的AccessKey Secret
        akSecret: <your AccessKey Secret>

2. 在叢集列表頁面，單擊目的地組群名稱，然後在左側導覽列，選擇儲存 > 儲存類。

3. 在儲存類頁面，單擊建立，選擇儲存卷類型為OSS，按照頁面提示配置StorageClass。

   配置項	說明
   訪問認證	配置訪問OSS所需的保密字典，即此前擷取的AccessKey ID和AccessKey Secret。
   Bucket ID	待使用的OSS Bucket。 此處僅展示配置AccessKey後可擷取到的Bucket。
   OSS Path	CSI組件版本需為v1.14.8.32-c77e277b-aliyun及以上。 指定掛載點相對於 Bucket 根目錄的路徑。預設為 /，即掛載整個 Bucket。 ossfs版本小於1.91時，指定的 path 必須在 OSS Bucket 中預先存在。詳見ossfs 1.91及以上版本新增功能說明
   儲存卷模式	儲存卷訪問模式。預設為共用目錄模式。取值： 子目錄模式僅在CSI組件為1.31.3及以上版本時生效。否則均為共用目錄模式。 共用目錄（sharepath）：所有儲存卷共用掛載路徑，即資料存放區於<bucket>:<path>/下。 子目錄（subpath）：建立儲存卷時在掛載路徑下自動建立子目錄，即資料存放區於<bucket>:<path>/<pv-name>/下。
   訪問網域名稱	待掛載OSS的訪問網域名稱（Endpoint）。 掛載節點和Bucket處於相同地區，或已打通VPC網路時，使用內網地址。 掛載節點和Bucket不同地區時，使用外網地址。 不同訪問連接埠的常見填寫格式如下： 內網格式：http://oss-{{regionName}}-internal.aliyuncs.com或https://oss-{{regionName}}-internal.aliyuncs.com。 內網訪問連接埠格式vpc100-oss-{{regionName}}.aliyuncs.com已廢棄，請及時切換。 外網格式：http://oss-{{regionName}}.aliyuncs.com或https://oss-{{regionName}}.aliyuncs.com。 通過私網訪問時預設使用HTTP協議。如需使用HTTPS，請使用kubectl方式。
   回收策略	動態建立的PV的回收策略。當前OSS儲存卷僅支援Retain，即刪除PVC時，PV和OSS Bucket中的資料不會隨之刪除。
   選擇性參數	為OSS儲存卷輸入定製化參數，格式為-o *** -o ***，例如-o umask=022 -o max_stat_cache_size=100000 -o allow_other。 展開查看說明 umask：更改ossfs讀檔案的許可權。 例如，umask=022可將ossfs檔案的許可權變更為755，解決通過SDK、OSS控制台等其他方式上傳的檔案（預設許可權為640）在掛載點內許可權不足的問題。推薦在讀寫分離或多使用者訪問時配置。 max_stat_cache_size：設定中繼資料快取的條目上限（例如100000），在記憶體中快取檔案元資訊來提升 ls、stat 等操作的效能。 但該緩衝無法及時感知通過OSS控制台、SDK、ossutil等方式對檔案的修改，可能導致應用讀取資料不一致。在對資料一致性有強要求時可將其設為0（禁用緩衝），或通過stat_cache_expire參數調低緩衝的失效時間，但會犧牲讀取效能。 allow_other：允許除掛載使用者外的其他使用者訪問掛載點中的檔案和目錄，適用於需要讓非掛載使用者也能訪問資料的多使用者共用環境。 更多選擇性參數，請參見掛載選項說明、ossfs 1.0配置最佳實務。