A cluster admin can use StorageClass to define different storage classes for Tencent Kubernetes Engine (TKE) clusters. TKE provides the block storage StorageClass by default. You can use both StorageClass and PersistentVolumeClaim to dynamically create required storage resources.
This document describes how to create a StorageClass of the Cloud Block Storage (CBS) type by using the console and Kubectl, and how to customize the template required by CBS disks.
cbs-test
as an example.Note:The default-policy configuration provided by TKE for backup includes the date of backup execution, time point of backup execution, and backup retention period.
cbs-pvc
as an example.cbs-test
created in the step of Creating a StorageClass as an example.
Note:
- The PVC and PV will be bound to the same StorageClass.
- If you do not specify a StorageClass, the value of
StorageClass
for the corresponding PVC is empty, and the value of thestorageClassName
field in the corresponding YAML file is a null string.
Note:
- The system first searches the current cluster to see whether there are PVs that meet the binding rules. If no, the system dynamically creates a PV to be bound based on the PVC and the selected StorageClass.
- If
StorageClass
is not specified, thenPersistVolume
must be specified.- No PersistentVolume is specified. For more information, see PV and PVC Binding Rules.
Note:This step creates a StatefulSet workload as an example.
cbs-vol
as an example.cbs-pvc
, which you created in the step of Creating a PVC by using a specified StorageClass, as an example.cbs-vol
that you added in this step./cache
as an example./data
or /test.txt
.Note:If you use the PVC mount method of CBS, the volume can be mounted to only one node.
You can use the sample template in this document to create a StorageClass by using Kubectl.
The following sample YAML file is used to create a StorageClass with the default name of cbs in a cluster.
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
# annotations:
# storageclass.beta.kubernetes.io/is-default-class: "true"
# If this line is present, it will become the default-class, and if you do not specify a type when creating a PVC, this type will be used automatically.
name: cloud-premium
provisioner: cloud.tencent.com/qcloud-cbs ## The provisioner coming with the TKE cluster
parameters:
type: CLOUD_PREMIUM
# CLOUD_PREMIUM, CLOUD_SSD and CLOUD_HSSD are supported. If it is not recognized, CLOUD_PREMIUM is used by default.
# renewflag: NOTIFY_AND_AUTO_RENEW
# renewflag indicates the CBS renewal mode. NOTIFY_AND_AUTO_RENEW supports notifications upon expiration and automatic renewal by month. NOTIFY_AND_MANUAL_RENEW supports notifications upon expiration and but not automatic renewal. DISABLE_NOTIFY_AND_MANUAL_RENEW does not support notifications upon expiration or automatic renewal. If not specified, NOTIFY_AND_MANUAL_RENEW is used by default.
# paymode: PREPAID
# paymode is the billing method of the cloud disk, here the PREPAID method is selected. The default value is POSTPAID (pay-as-you-go, which supports the **Retain** and **Delete** reclaim policies. **Retain** is only available in clusters later than V1.8).
# aspid:asp-123
# You can specify a snapshot policy. After the cloud disk is created, it will be automatically bound to this policy. Binding failure does not affect the creation.
The following table lists the supported parameters.
Parameter | Description |
---|---|
type | This includes CLOUD_PREMIUM (Premium cloud disk), CLOUD_SSD (SSD cloud disk) and CLOUD_HSSD (enhanced SSD cloud disk). |
zone | Availability zone. If an availability zone is specified, the cloud disk is created in this availability zone. If no availability zone is specified, the availability zones of all nodes are obtained and one is selected at random. For the identifiers of all Tencent Cloud regions, see Regions and Availability Zones. |
paymode | The billing method of the cloud disk. The default value is POSTPAID (pay-as-you-go), which supports the **Retain** and **Delete** reclaim policies. **Retain** is only available in clusters later than V1.8. |
renewflag | CBS renewl mode. The default value is NOTIFY_AND_MANUAL_RENEW .
|
aspid | Snapshot policy ID. The created cloud disk will be automatically bound with this policy. Binding failure does not affect the creation of the cloud disk. |
You can use a cloud disk to create a multi-pod StatefulSet. The sample YAML file is as follows:
NoteThe apiVersion of the resource object varies based on the cluster Kubernetes version. You can run the command
kubectl api-versions
to view the apiVersion of the current resource object.
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: web
spec:
selector:
matchLabels:
app: nginx
serviceName: "nginx"
replicas: 3
template:
metadata:
labels:
app: nginx
spec:
terminationGracePeriodSeconds: 10
containers:
- name: nginx
image: nginx
ports:
- containerPort: 80
name: web
volumeMounts:
- name: www
mountPath: /usr/share/nginx/html
volumeClaimTemplates: # the system automatically creates a PVC and then automatically creates a PV.
- metadata:
name: www
spec:
accessModes: [ "ReadWriteOnce" ]
storageClassName: cloud-premium
resources:
requests:
storage: 10Gi
Was this page helpful?