Container Service for Kubernetes:Migrasi aplikasi stateful dengan cloud disk lintas zona

Kasus penggunaan

NAS dan OSS mendukung lintas zona dan multi-mount. Disk bersifat terikat zona—tidak dapat berpindah lintas zona atau menggunakan kembali Persistent Volume Claim (PVC) dan Persistent Volume (PV) yang ada. Buat disk baru di zona target dari Snapshot.

Batasan utama

Tinjau batasan berikut sebelum migrasi:

• Diperlukan gangguan bisnis: Untuk memastikan konsistensi data, migrasi menskalakan StatefulSet ke 0 replika, lalu memulihkan semuanya sekaligus setelah migrasi disk—bukan pembaruan bergulir (rolling update). Rencanakan downtime. Durasi tergantung pada jumlah replika, waktu startup kontainer, dan kapasitas disk.

• Disk ESSD wajib digunakan: Semua penyimpanan yang digunakan oleh StatefulSet harus berupa disk ESSD. Migrasi menggunakan snapshot akses instan, yang hanya mendukung disk ESSD.

• Persyaratan zona target: Zona target harus mendukung disk ESSD, dan kluster harus memiliki node di zona tersebut yang tersedia untuk penjadwalan.

Jika aplikasi Anda menggunakan disk non-ESSD, lakukan salah satu hal berikut sebelum migrasi:

• Ubah tipe disk menjadi ESSD.

• Secara manual buat snapshot untuk satu volume disk dan bangun ulang disk lintas zona.

Cara kerja

Migrasi lintas zona membuat Snapshot dari disk sumber dan menggunakan akses instan untuk meminimalkan waktu pembuatan. Lihat penagihan Snapshot.

storage-operator menjalankan langkah-langkah berikut:

1. Pemeriksaan Awal (Precheck): Memverifikasi bahwa aplikasi sedang berjalan dan mengidentifikasi disk yang akan dimigrasikan. Berhenti jika precheck gagal.

2. Skalakan ke nol: Menskalakan StatefulSet ke 0 replika, sehingga menjeda aplikasi.

3. Buat snapshot: Membuat snapshot akses instan untuk semua disk yang dipasang. Snapshot bersifat agnostik terhadap zona.

4. Provisi disk baru: Setelah memastikan snapshot tersedia, membuat disk baru di zona target dengan data yang sama.

5. Bangun ulang PVC dan PV: Membangun ulang PVC dengan nama yang sama dan PV-nya yang sesuai, terikat ke disk baru.

6. Pulihkan replika: Memulihkan jumlah replika semula. Replika terikat ke PVC yang telah dibangun ulang dan memasang disk baru.

7. (Opsional) Hapus sumber daya asli: Setelah memastikan kesehatan aplikasi, hapus PV dan disk asli. Lihat penagihan block storage.

Prasyarat

Pastikan hal-hal berikut:

• Kluster yang menjalankan Kubernetes 1.20 atau lebih baru dengan driver Container Storage Interface (CSI) terinstal

• storage-operator v1.26.2-1de13b6-aliyun atau lebih baru terinstal

• csi-plugin dan csi-provisioner terinstal, dengan csi-provisioner menggunakan versi non-managed

  Jika versi managed terinstal, beralihlah ke versi non-managed. Lalu restart kontroler penyimpanan: kubectl delete pod -n kube-system <storage-controller-pod-name>

• (Hanya untuk cluster khusus ACK) Peran RAM worker dan master memiliki izin ModifyDiskSpec pada API ECS. Lihat Buat kebijakan kustom. Lihat kebijakan RAM yang diperlukan:

  Kluster ACK yang dikelola tidak memerlukan izin ModifyDiskSpec.

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

  </details>

Migrasi StatefulSet lintas zona

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

Contoh

Contoh berikut menggunakan kluster ACK Pro dengan node di tiga zona:

• 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

FAQ

Jika tugas migrasi mengembalikan status FAILED, ambil pesan error-nya:

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

Contoh output:

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

Komponen tidak dapat menemukan PVC untuk dimigrasikan. Penyebab umum:

• StatefulSet tidak memiliki penyimpanan yang dipasang.

• Semua disk sudah berada di zona target—migrasi tidak diperlukan.

• Komponen tidak dapat mengambil informasi PVC.

Atasi masalah berdasarkan pesan error, lalu terapkan ulang tugas migrasi.