Container Service for Kubernetes:Create a group snapshot for multiple Cloud Disk volumes

Funcionamiento

Las instantáneas de grupo se basan en los grupos consistentes de instantáneas de ECS. ACK proporciona las siguientes definiciones de recursos personalizados (CRD) que puede utilizar para gestionar las instantáneas de grupo:

Al crear un VolumeGroupSnapshot, el plugin de Container Storage Interface (CSI) crea un grupo consistente de instantáneas de ECS y genera automáticamente un VolumeSnapshot y un VolumeSnapshotContent para cada disco seleccionado. Si un disco falla, restáurelo desde el VolumeSnapshot correspondiente.

Facturación

Los grupos consistentes de instantáneas son gratuitos. Las instantáneas dentro del grupo se facturan según el almacenamiento consumido. Para más detalles, consulte Snapshot billing.

Límites

• Las instantáneas de grupo están sujetas a los mismos límites que las instantáneas de ECS. Consulte Limits.

• Los tiempos de caducidad no son compatibles con los grupos consistentes de instantáneas de ECS. Elimine las instantáneas de grupo manualmente cuando ya no las necesite.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

• Un clúster administrado de ACK que ejecute Kubernetes 1.28 o posterior. Consulte Create an ACK managed cluster.

• El plugin de CSI instalado en la versión 1.31.4 o posterior. Para actualizar csi-plugin y csi-provisioner, consulte Update csi-plugin and csi-provisioner.

• El servicio de instantáneas de Elastic Compute Service (ECS) activado (la activación es gratuita). Consulte Activate ECS Snapshot.

• Un cliente kubectl conectado al clúster.

Paso 1: Habilitar la compuerta de función

Habilite la compuerta de función EnableVolumeGroupSnapshots en csi-provisioner antes de crear instantáneas de grupo.

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre del clúster. En el panel de navegación izquierdo, seleccione Operations > Add-ons.

3. En la página Add-ons, busque la tarjeta de csi-provisioner y haga clic en Configuration en la esquina inferior derecha.

4. En el cuadro de diálogo csi-provisioner Parameters, establezca el campo FeatureGate en EnableVolumeGroupSnapshots=true y haga clic en OK. Si ya hay otras compuertas de función habilitadas, agregue la nueva al final: xxxxxx=true,yyyyyy=false,EnableVolumeGroupSnapshots=true.

Paso 2: Desplegar un StatefulSet de MySQL

Este ejemplo utiliza un StatefulSet de MySQL con dos réplicas. Cada réplica monta un disco ESSD de 20 GiB como PVC, lo que le proporciona dos discos para crear una instantánea de grupo.

1. Cree el archivo mysql.yaml con el siguiente contenido: <details><summary>mysql.yaml</summary>

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: mysql
   spec:
     selector:
       matchLabels:
         app: mysql
     serviceName: "mysql"
     replicas: 2
     template:
       metadata:
         labels:
           app: mysql
       spec:
         containers:
         - name: mysql
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/mysql:8.0.30-8.6
           env:
           - name: MYSQL_ROOT_PASSWORD
             valueFrom:
               secretKeyRef:
                 name: mysql-pass
                 key: password
           imagePullPolicy: IfNotPresent
           volumeMounts:
           - name: data
             mountPath: /var/lib/mysql   # MySQL data directory
             subPath: mysql
     volumeClaimTemplates:
     - metadata:
         name: data
       spec:
         accessModes: [ "ReadWriteOnce" ]
         storageClassName: "alicloud-disk-essd"
         resources:
           requests:
             storage: 20Gi
   ---
   apiVersion: v1
   kind: Secret
   metadata:
     name: mysql-pass
   type: Opaque
   data:
     password: MTIzNDU2   # Base64-encoded value of "123456"
     username: cm9vdA==   # Base64-encoded value of "root"

   </details>

2. Despliegue el StatefulSet:

   kubectl apply -f mysql.yaml

3. Escriba datos de prueba en ambas réplicas de pod. Inicie sesión en el pod mysql-0 e inserte una fila:

   kubectl exec -it mysql-0 -- bash   # Open a shell in the pod
   mysql -uroot -p123456              # Connect to MySQL

   CREATE DATABASE test;
   USE test;
   CREATE TABLE scores ( name VARCHAR(50) NOT NULL, score INT AUTO_INCREMENT PRIMARY KEY );
   INSERT INTO scores(name, score) VALUES ("Amy", 95);
   SELECT * FROM scores;

   Salida esperada:

   +------+-------+
   | name | score |
   +------+-------+
   | Amy  |    95 |
   +------+-------+

   Repita los mismos pasos para el pod mysql-1.

Paso 3: Crear instantáneas de grupo

apiVersion: groupsnapshot.storage.k8s.io/v1alpha1
kind: VolumeGroupSnapshotClass
metadata:
  name: group-snapshot-class-demo
deletionPolicy: Delete
driver: diskplugin.csi.alibabacloud.com

kubectl apply -f group-snapshot-class-demo.yaml

apiVersion: groupsnapshot.storage.k8s.io/v1alpha1
kind: VolumeGroupSnapshot
metadata:
  name: group-snapshot-demo
  namespace: default
spec:
  source:
    selector:
      matchLabels:
        app: mysql           # Selects all PVCs with this label
  volumeGroupSnapshotClassName: group-snapshot-class-demo

kubectl apply -f group-snapshot-demo.yaml

Paso 4: Verificar las instantáneas de grupo

1. Monitoree el VolumeGroupSnapshot hasta que READYTOUSE cambie de false a true:

   kubectl get vgs group-snapshot-demo -w

2. Inspeccione los detalles de la instantánea para ver qué PVC corresponde a cada VolumeSnapshot:

   Campo	Descripción
   Bound Volume Group Snapshot Content Name	El VolumeGroupSnapshotContent vinculado a este VolumeGroupSnapshot
   Persistent Volume Claim Ref	El nombre del PVC respaldado
   Volume Snapshot Ref	El VolumeSnapshot creado para ese PVC

   kubectl describe vgs group-snapshot-demo

   Salida esperada (abreviada):

   Status:
     Bound Volume Group Snapshot Content Name: groupsnapcontent-adcef6ef-811a-4e9d-ba51-3927caxxxxxx
     Creation Time: 2024-11-27T06:02:56Z
     Pvc Volume Snapshot Ref List:
       Persistent Volume Claim Ref:
         Name: disk-mysql-0
       Volume Snapshot Ref:
         Name: snapshot-1c2c5bcaf47ee2bffcc5b2f52dff65a4aacaaea38032c05d75acd536f7xxxxxx-2024-11-27-6.4.7
       Persistent Volume Claim Ref:
         Name: disk-mysql-1
       Volume Snapshot Ref:
         Name: snapshot-37a2fbf634d68cd2103f261313c2ed781fbd2bd52b5a0d0e0c0ef7c339xxxxxx-2024-11-27-6.4.9

3. Confirme que ambos VolumeSnapshot estén listos:

   kubectl get volumesnapshot

   Ambas instantáneas deben mostrar READYTOUSE: true.

4. Obtenga el ID del grupo consistente de instantáneas de ECS:

   kubectl describe vgsc groupsnapcontent-adcef6ef-811a-4e9d-ba51-3927caxxxxxx

   Salida esperada (abreviada):

   Volume Group Snapshot Handle: ssg-2zeg72d1qym6vnxxxxxx

   Para ver el grupo consistente de instantáneas en la consola de ECS, vaya a la consola de ECS, seleccione Storage & Snapshots > Snapshots en el panel de navegación izquierdo, haga clic en la pestaña Snapshot-consistent Groups y busque ssg-2zeg72d1qym6vnxxxxxx.

Paso 5: Restaurar volúmenes de disco desde instantáneas

Hay dos opciones de restauración disponibles: restaurar un solo volumen manualmente o restaurar todos los volúmenes en un solo lote mediante un script.

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: disk-mysql-0-copy
spec:
  volumeMode: Filesystem
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 20Gi
  storageClassName: "alicloud-disk-essd"
  dataSource:
    name: snapshot-1c2c5bcaf47ee2bffcc5b2f52dff65a4aacaaea38032c05d75acd536f7xxxxxx-2024-11-27-6.4.7  # [1]
    kind: VolumeSnapshot                                                                                  # [2]
    apiGroup: snapshot.storage.k8s.io                                                                    # [3]

kubectl apply -f disk-mysql-0-copy.yaml

kubectl get pvc disk-mysql-0-copy

disk-mysql-0-copy   Bound    d-2ze0iwwqg0s6b0xxxxxx   20Gi   RWO   alicloud-disk-essd   <unset>   69s

Pasos siguientes

• Create a snapshot of a disk volume