使用云盤靜態存儲卷,即使用預先在云硬盤控制臺已建好的云盤實例,通過手動創建PV,創建PVC時使用已有PV的方式,實現容器內掛載云盤存儲。
該模式下需要用戶自建云盤及PV資源,一定程度上增加操作和管理復雜性,一般推薦使用動態創建存儲的方式。
前提條件
已創建容器集群
已在插件市場安裝存儲插件cstor-csi,且插件正常運行
已在云硬盤控制臺創建云盤
使用限制
參見“云硬盤概述”——“使用限制”
通過控制臺使用云盤靜態存儲卷
1、創建持久卷(PV)
登錄“云容器引擎”管理控制臺;
在集群列表頁點擊進入指定集群;
進入主菜單“存儲”——“持久卷”,單擊左上角“創建持久卷”;
在創建對話框,配置持久卷PV的相關參數。配置項說明如下:
| 配置項 | 說明 |
|---|---|
| 名稱 | PV的名稱,以pvc-開頭 |
| 持久卷類型 | 當前支持云盤、彈性文件、對象存儲、并行文件、海量文件和本地存儲,這里選擇云盤。 具體創建頁中展示的存儲類型由當前資源池支持情況決定。 |
| 存儲驅動 | 采用默認CSI驅動 |
| 訪問模式 |
說明:如果使用非共享盤存儲,訪問模式不能為ReadWriteMany。 |
| 云盤ID | 選擇已有云盤實例。單擊會彈出選擇云盤會話,會話中會展示可使用的云盤信息,可使用條件包括:
|
| 掛載類型 | 當前支持ext4、xfs |
| 卷模式 |
說明:如果使用共享盤存儲,卷模式僅支持塊設備(Block)。 |
| 掛載選項 | 掛載參數,用戶可根據自己的情況實際定制相關參數。 比如設置掛載參數為: discard:表示在掛載文件系統時指定 discard 參數,文件系統中刪除文件后會自動觸發 discard 操作,通知塊設備釋放掉未使用的 Block 。 |
| 標簽 | 用于對 PV 對象進行標記和分類的元數據屬性,可以賦予 PV 以自定義的屬性或標識。 |
說明
靜態導入場景下,回收策略均為默認Retain,cstor-csi不會刪除數據。
參數配置完成后,點擊“確定”。創建成功后,可以在持久卷列表查看,此時PV狀態為“可用”。
2、創建持久卷聲明(PVC)
進入主菜單“存儲”——“持久卷聲明”,單擊左上角“創建持久卷聲明”;
在創建對話框,配置持久卷聲明PVC的相關參數。配置項說明如下:
| 配置項 | 說明 |
|---|---|
| 名稱 | PVC的名稱 |
| 存儲聲明類型 | 當前支持云盤、彈性文件、對象存儲、并行文件、海量文件和本地存儲,這里選擇云盤。 具體創建頁中展示的存儲類型由當前資源池支持情況決定。 |
| 分配模式 | 當前支持“使用存儲類”和“已有存儲卷” 這里選擇“已有存儲卷” |
| 持久卷名稱 | 選擇上一步創建的PV名稱 |
參數配置完成后,點擊“確定”。創建成功后,可以在持久卷聲明列表查看。
進入持久卷聲明列表頁,等待PVC狀態為“已綁定” 。
3、創建工作負載
登錄“云容器引擎”管理控制臺;
在集群列表頁點擊進入指定集群;
進入主菜單“工作負載”——“有狀態”,單擊左上角“創建SatefulSet”;
在創建對話框,數據卷欄中,選擇添加數據卷,卷類型選擇“使用已有PVC”,操作欄選擇“添加已有PVC”;

在實例內容器欄,為容器設置掛載點。選擇添加掛載點,選擇數據卷為上一步創建,根據需要配置容器路徑和權限;
所有的信息都配置完成后,單擊 “提交” 。
創建成功后,您就可以正常使用數據卷。
通過kubectl命令行使用云盤靜態存儲卷
1、創建持久卷(PV)
使用kubectl連接集群,創建示例yaml文件pv-example.yaml:
apiVersion: v1
kind: PersistentVolume
metadata:
annotations:
pv.kubernetes.io/provisioned-by: disk.csi.cstor.com
name: pvc-test-disk #PV的名稱,以pvc-開頭
spec:
accessModes:
- ReadWriteOnce #訪問模式
capacity:
storage: 10Gi #云盤容量
csi:
driver: disk.csi.cstor.com
fsType: ext4 #掛載類型
volumeAttributes:
diskUUID: {YOUR-DISK-UUID} #替換云盤ID
driverType: disk.csi.cstor.com
mode: VBD
shared: "false" #是否共享盤
type: SATA # 磁盤類型
volumeHandle: 0103-20-{resourceID} # 替換云盤resourceID
mountOptions:
- discard
nodeAffinity:
required:
nodeSelectorTerms:
- matchExpressions:
- key: topology.disk.csi.cstor.com/zone
operator: In
values:
- <your-node-zone-id> #替換為您待部署應用的節點所在的可用區,例如cn-huadong1-jsnj1A-public-ctcloud
volumeMode: Filesystem #卷模式執行以下命令,創建PV
kubectl apply -f pv-example.yaml查看創建的PV:登錄“云容器引擎”管理控制臺;在集群列表頁點擊進入指定集群;進入主菜單“存儲”——“持久卷”,在持久卷列表查看。
2、創建持久卷聲明(PVC)
使用kubectl連接集群,創建示例yaml文件pvc-example.yaml:
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
annotations:
volume.beta.kubernetes.io/storage-provisioner: disk.csi.cstor.com
name: cstor-pvc-disk
namespace: default
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 10Gi
volumeMode: Filesystem
volumeName: {YOUR-PV-NAME} #替換PV名稱執行以下命令,創建PVC
kubectl apply -f pvc-example.yaml查看創建的PVC:
登錄“云容器引擎”管理控制臺;在集群列表頁點擊進入指定集群;進入主菜單“存儲”——“持久卷聲明”,在列表查看。
3、創建工作負載
使用kubectl連接集群,創建示例yaml文件sts-example.yaml:
apiVersion: "apps/v1"kind: "StatefulSet"metadata:
name: "test-sts"spec:
podManagementPolicy: "OrderedReady"
replicas: 1
revisionHistoryLimit: 10
template:
spec:
containers:
- image: "nginx:1.25-alpine"
imagePullPolicy: "IfNotPresent"
name: "container1"
resources:
limits:
cpu: "100m"
memory: "256Mi"
requests:
cpu: "100m"
memory: "256Mi"
terminationMessagePath: "/dev/termination-log"
terminationMessagePolicy: "File"
volumeMounts:
- mountPath: "/tmp"
name: "volume1"
dnsPolicy: "ClusterFirst"
restartPolicy: "Always"
schedulerName: "default-scheduler"
securityContext: {}
terminationGracePeriodSeconds: 30
volumes:
- name: "volume1"
persistentVolumeClaim:
claimName: "cstor-pvc-disk"
updateStrategy:
rollingUpdate:
partition: 0
type: "RollingUpdate"執行以下命令,創建StatefulSet
kubectl apply -f sts-example.yaml查看創建的有狀態負載:
登錄“云容器引擎”管理控制臺;在集群列表頁點擊進入指定集群;進入主菜單“工作負載”——“有狀態”,在列表查看。
驗證數據持久化
登錄“云容器引擎”管理控制臺;
在集群列表頁點擊進入指定集群;
進入主菜單“工作負載”——“有狀態”,進入負載詳情;
在Pod列表頁,選擇“遠程登錄”,進入到容器內執行以下命令:
/dev/vdb 9.7G 24.0K 9.7G 0% /tmp2、向/tmp 目錄下寫一個文件,執行echo "Hello World" > /tmp/test.log
3、查看/tmp目錄下文件,執行ls /tmp,預期結果如下:
lost+found test.log退出“遠程登錄”,對上一步中的Pod執行“銷毀重建”,等待Pod重新運行正常;
對新建Pod,繼續執行“遠程登錄”,進入到容器內查看數據。執行cat /tmp/test.log,預期結果如下:
Hello World以上步驟說明,pod刪除重建后,重新掛載云盤,數據仍然存在,說明云硬盤中的數據可持久化保存。