Container Service for Kubernetes：使用ossfs 1.0掛載靜態OSS儲存卷

RRSA方式

AccessKey方式

RRSA方式

1. 建立 pv-oss-rrsa.yaml。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # PV名稱
     name: pv-oss   
     # PV標籤
     labels:    
       alicloud-pvname: pv-oss
   spec:
     capacity:
       # 定義儲存卷容量
       storage: 10Gi  
     # 訪問模式
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # 與PV名稱（metadata.name）一致
       volumeHandle: pv-oss  
       volumeAttributes:
         # 替換為實際Bucket名稱
         bucket: "your-bucket-name"  
         # 掛載Bucket的根目錄或指定子目錄
         path: /  
         # Bucket所在地區的Endpoint
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
         authType: "rrsa"
         # 此前建立或修改的RAM角色
         roleName: "demo-role-for-rrsa"
         # OSS請求籤名版本
         sigVersion: "v4"  

   參數	描述
   storage	定義OSS儲存卷容量。此值僅用於匹配PVC。
   accessModes	配置訪問模式，支援ReadOnlyMany和ReadWriteMany。 選擇ReadOnlyMany時，ossfs將以唯讀模式掛載OSS Bucket。
   persistentVolumeReclaimPolicy	PV回收策略。當前OSS儲存卷僅支援Retain，即刪除PVC時，PV和OSS Bucket中的資料不會隨之刪除。
   driver	定義驅動類型。使用阿里雲OSS CSI外掛程式固定為ossplugin.csi.alibabacloud.com。
   volumeHandle	需與PV名稱（metadata.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。
   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配置最佳實務。
   authType	配置為rrsa，使用RRSA方式鑒權。
   roleName	配置為此前建立或修改的RAM角色。 如需為不同PV配置不同許可權，可建立不同的RAM角色，並在PV中配置不同的roleName。
   sigVersion	請求OSS服務端的請求籤名版本。 "v1"（預設）：使用OSS簽名版本1。 "v4"：使用OSS簽名版本4（推薦）。

   若預設的RRSA鑒權不滿足需求（如使用非預設ServiceAccount或第三方OIDC），可通過修改PV配置來指定具體的ARN或ServiceAccount，詳見如何在RRSA鑒權方式中使用指定的ARNs或ServiceAccount？。

2. 建立PV。

   kubectl create -f pv-oss-rrsa.yaml

AccessKey方式

kubectl

1. 建立pvc-oss.yaml。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     # PVC 名稱
     name: pvc-oss
     namespace: default
   spec:
     # 配置訪問模式。ReadOnlyMany表明ossfs將以唯讀模式掛載OSS Bucket
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # 聲明儲存容量，不能大於儲存卷總量
         storage: 10Gi
     # 添加此行，明確指定不使用StorageClass
     storageClassName: ""   
     selector:
       matchLabels:
         # 通過PV標籤精確匹配PV
         alicloud-pvname: pv-oss

2. 建立PVC。

   kubectl create -f pvc-oss.yaml

3. 確認PVC狀態。

   kubectl get pvc pvc-oss

   輸出中，PVC已綁定（Bound）PV。

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

控制台

1. 在ACK叢集列表頁面，單擊目的地組群名稱，在叢集詳情頁左側導覽列，選擇儲存 > 儲存聲明。

2. 在儲存聲明頁面，單擊建立，選擇儲存宣告類型為OSS，按照頁面提示完成參數的配置和提交。

   關鍵參數如下。

   配置項	說明
   分配模式	選擇已有儲存卷。 若未建立儲存卷，可設定分配模式為建立儲存卷，配置建立儲存卷參數。
   總量	所建立儲存卷的容量，不超過儲存卷容量。

kubectl

1. 建立oss-workload.yaml。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-workload
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
             # 容器內的掛載路徑
             - name: pvc-oss
               mountPath: "/data"
           # 配置健全狀態檢查
           livenessProbe:
             exec:
               command:
               - ls
               - /data
             initialDelaySeconds: 30
             periodSeconds: 30
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               # 引用此前建立的PVC
               claimName: pvc-oss

2. 建立應用。

   kubectl create -f oss-workload.yaml

3. 驗證掛載結果。

   • 確認Pod處於Running狀態。

     kubectl get pod -l app=nginx

   • 進入Pod，查看掛載點。

     kubectl exec -it <pod-name> -- ls /data

     輸出中，可查看OSS掛載路徑下的資料。

控制台