Container Service for Kubernetes:Migrate stateful applications with cloud disks across zones

Casos de uso

NAS y OSS admiten operaciones entre zonas y montajes múltiples. Los discos están vinculados a una zona específica; no pueden moverse entre zonas ni reutilizar solicitudes de volumen persistente (PVC) ni volúmenes persistentes (PV) existentes. Cree nuevos discos en la zona de destino a partir de instantáneas.

Restricciones clave

Revise estas restricciones antes de iniciar la migración:

• Interrupción del servicio requerida: Para garantizar la consistencia de los datos, la migración escala el StatefulSet a 0 réplicas y luego las restaura todas al mismo tiempo tras completar la migración del disco; no se trata de una actualización continua. Planifique el tiempo de inactividad. La duración depende del número de réplicas, el tiempo de inicio del contenedor y la capacidad del disco.

• Discos ESSD obligatorios: Todo el almacenamiento utilizado por el StatefulSet debe ser discos ESSD. La migración utiliza instant access snapshots, que solo admiten discos ESSD.

• Requisitos de la zona de destino: La zona de destino debe admitir discos ESSD y el clúster debe tener nodos disponibles en dicha zona para la programación.

Si su aplicación utiliza discos que no son ESSD, realice una de las siguientes acciones antes de migrar:

• Change the disk type to ESSD.

• Realice manualmente create a snapshot for a single disk volume y reconstruya el disco entre zonas.

Funcionamiento

La migración entre zonas crea instantáneas de los discos de origen y utiliza acceso instantáneo para minimizar el tiempo de creación. Consulte Snapshot billing.

storage-operator ejecuta los siguientes pasos:

1. Verificación previa: Comprueba que la aplicación se esté ejecutando e identifica los discos por migrar. Se detiene si la verificación falla.

2. Escalado a cero: Escala el StatefulSet a 0 réplicas y pausa la aplicación.

3. Creación de instantáneas: Genera instantáneas de acceso instantáneo para todos los discos montados. Las instantáneas son independientes de la zona.

4. Aprovisionamiento de nuevos discos: Tras confirmar que las instantáneas están disponibles, crea nuevos discos en la zona de destino con los mismos datos.

5. Reconstrucción de PVC y PV: Reconstruye los PVC con los mismos nombres y sus PV correspondientes, vinculados a los nuevos discos.

6. Restauración de réplicas: Restablece el recuento original de réplicas. Estas se vinculan a los PVC reconstruidos y montan los nuevos discos.

7. (Opcional) Eliminación de recursos originales: Tras confirmar el estado correcto de la aplicación, elimine los PV y discos originales. Consulte Block storage billing.

Requisitos previos

Asegúrese de cumplir con lo siguiente:

• Un clúster que ejecute Kubernetes 1.20 o posterior con el controlador Container Storage Interface (CSI) instalado

• storage-operator v1.26.2-1de13b6-aliyun o posterior instalado

• csi-plugin y csi-provisioner instalados, con csi-provisioner usando la versión no administrada

  Si tiene instalada la versión administrada, cambie a la no administrada. Luego reinicie el controlador de almacenamiento: kubectl delete pod -n kube-system <storage-controller-pod-name>

• (Solo para clústeres dedicados ACK) Los roles RAM de worker y master tienen el permiso ModifyDiskSpec en la API de ECS. Consulte Crear una directiva personalizada. Visualice la directiva RAM requerida:

  Los clústeres administrados ACK no requieren el permiso ModifyDiskSpec .

  {
      "Version": "1",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ecs:CreateSnapshot",
                  "ecs:DescribeSnapshot",
                  "ecs:DeleteSnapshot",
                  "ecs:ModifyDiskSpec",
                  "ecs:DescribeTaskAttribute"
              ],
              "Resource": "*"
          }
      ]
  }

  </details>

Migrar un StatefulSet entre zonas

kubectl patch configmap/storage-operator \
  -n kube-system \
  --type merge \
  -p '{"data":{"storage-controller":"{\"imageRep\":\"acs/storage-controller\",\"imageTag\":\"\",\"install\":\"true\",\"template\":\"/acs/templates/storage-controller/install.yaml\",\"type\":\"deployment\"}"}}'

cat <<EOF | kubectl apply -f -
apiVersion: storage.alibabacloud.com/v1beta1
kind: ContainerStorageOperator
metadata:
  name: default
spec:
  operationType: APPMIGRATE
  operationParams:
    stsName: web
    stsNamespace: default
    stsType: kube
    targetZone: cn-beijing-h,cn-beijing-j
    checkWaitingMinutes: "1"
    healthDurationMinutes: "1"
    snapshotRetentionDays: "2"
    retainSourcePV: "true"
EOF

Ejemplos

Los siguientes ejemplos utilizan un clúster ACK Pro con nodos en tres zonas:

• Zona B: cn-shanghai.192.168.5.245

• Zona G: cn-shanghai.192.168.2.214

• Zona M: cn-shanghai.192.168.3.236, cn-shanghai.192.168.3.237

Preguntas frecuentes

Si una tarea de migración devuelve el estado FAILED, obtenga el mensaje de error:

kubectl describe cso <ContainerStorageOperator-name> | grep Message -A 1

Ejemplo de salida:

  Message:
    Consume: failed to get target pvc, err: no pvc mounted in statefulset or no pvc need to migrated web

El componente no pudo encontrar un PVC para migrar. Causas comunes:

• El StatefulSet no tiene almacenamiento montado.

• Todos los discos ya se encuentran en la zona de destino, por lo que no se requiere migración.

• El componente no pudo recuperar la información del PVC.

Resuelva el problema basándose en el mensaje de error y vuelva a aplicar la tarea de migración.