Container Service for Kubernetes:複数のクラウドディスクボリュームのグループスナップショットの作成

VolumeGroupSnapshotClass の作成

クラスターには、alibabacloud-disk-group-snapshot という名前のデフォルトの VolumeGroupSnapshotClass がすでに利用可能です。カスタムクラスを使用するには、group-snapshot-class-demo.yaml を作成します：

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

deletionPolicy フィールドは、VolumeGroupSnapshot を削除したときに、基盤となる ECS スナップショット整合性グループがどうなるかを制御します：

クラスを適用します：

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

VolumeGroupSnapshot の作成

MySQL アプリケーションにマウントされた両方の PVC のスナップショットを作成するために、group-snapshot-demo.yaml を作成します：

apiVersion: groupsnapshot.storage.k8s.io/v1alpha1
kind: VolumeGroupSnapshot
metadata:
  name: group-snapshot-demo
  namespace: default
spec:
  source:
    selector:
      matchLabels:
        app: mysql           # このラベルを持つすべての PVC を選択します
  volumeGroupSnapshotClassName: group-snapshot-class-demo

source.selector フィールドは、ラベルセレクターを使用してバックアップする PVC を識別します。StatefulSet の volumeClaimTemplates から作成された PVC には、StatefulSet の Pod ラベルが自動的に付与されます。PVC を手動で作成した場合は、このステップを実行する前に対応するラベルを追加してください。

VolumeGroupSnapshot を適用します：

kubectl apply -f group-snapshot-demo.yaml

オプション 1：単一ボリュームの復元

次の例では、disk-mysql-0 Pod にアタッチされたディスクボリュームを復元します。

disk-mysql-0-copy.yaml を作成します。dataSource フィールドは、指定された VolumeSnapshot から新しいディスクをプロビジョニングするように CSI に指示します：

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]

• [1] disk-mysql-0 をバックアップする VolumeSnapshot の名前 (上記の kubectl describe vgs の出力から)。

• [2] リソースの種類 — スナップショットから復元する場合は常に VolumeSnapshot です。

• [3] CSI スナップショットリソースの API グループ。

PVC を適用します：

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

PVC がバインドされていることを確認します：

kubectl get pvc disk-mysql-0-copy

期待される出力：

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

ディスクがスナップショットから作成されたことを確認するには、ECS コンソールに移動し、左側のナビゲーションウィンドウで [ストレージとスナップショット] > [ブロックストレージ] を選択し、[クラウドディスク] タブをクリックして、d-2ze0iwwqg0s6b0xxxxxx を検索します。ディスク詳細ページを開くと、スナップショットから作成されたことがわかります。

オプション 2：すべてのボリュームを一度にバッチで復元

generate_pvc.sh スクリプトを使用して、VolumeGroupSnapshot から PVC マニフェストを自動的に生成し、一度にすべて適用します。

1. jq コマンドラインツールをインストールします：

   • CentOS: yum install jq

   • Ubuntu: apt-get install jq

2. MySQL StatefulSet のレプリカ数を 0 にスケールダウンして、復元前にすべての書き込みを停止します：

   kubectl scale sts mysql --replicas=0

3. 既存の PVC を削除します：

   kubectl delete pvc data-mysql-0 data-mysql-1

4. 次の内容で generate_pvc.sh を作成します：<details><summary>generate_pvc.sh</summary>

   パラメーター	説明	例
   1	VolumeGroupSnapshot の名前空間	default
   2	VolumeGroupSnapshot の名前	group-snapshot-demo
   3	復元された PVC の StorageClass 名	alicloud-disk-essd
   4	ディスク容量	20Gi
   5	kubeconfig ファイルへのパス	.kube/config
   6	生成された PVC YAML の出力パス	./output.yaml

   #!/bin/bash
   
   # 入力パラメーター
   NAMESPACE=$1           # VolumeGroupSnapshot の名前空間
   VGS_NAME=$2            # VolumeGroupSnapshot の名前
   STORAGE_CLASS_NAME=$3  # 復元された PVC の StorageClass
   CAPACITY=$4            # ディスク容量 (例：20Gi)
   KUBECONFIG_PATH=$5     # kubeconfig ファイルへのパス
   OUTPUT_FILE=$6         # 生成された YAML の出力パス
   
   # VolumeGroupSnapshot の詳細を取得
   VGS_INFO=$(kubectl --kubeconfig=${KUBECONFIG_PATH} -n ${NAMESPACE} get vgs ${VGS_NAME} -o json)
   
   # PVC とスナップショットのマッピングが存在することを確認
   if ! echo ${VGS_INFO} | jq -e '.status.pvcVolumeSnapshotRefList' &>/dev/null; then
     echo "エラー: .status.pvcVolumeSnapshotRefList が VolumeGroupSnapshot に見つかりません。"
     exit 1
   fi
   
   # PVC 名とそれに対応するスナップショット名を取得
   PVCS=($(echo ${VGS_INFO} | jq -r '.status.pvcVolumeSnapshotRefList[].persistentVolumeClaimRef.name'))
   SNAPSHOTS=($(echo ${VGS_INFO} | jq -r '.status.pvcVolumeSnapshotRefList[].volumeSnapshotRef.name'))
   
   # 出力ファイルをクリア
   > ${OUTPUT_FILE}
   
   # ディスクごとに 1 つの PVC マニフェストを生成
   for i in "${!PVCS[@]}"; do
     PVC_NAME=${PVCS[$i]}
     SNAPSHOT_NAME=${SNAPSHOTS[$i]}
   
     cat <<EOF >> ${OUTPUT_FILE}
   ---
   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: ${PVC_NAME}
   spec:
     volumeMode: Filesystem
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: ${CAPACITY}
     storageClassName: "${STORAGE_CLASS_NAME}"
     dataSource:
       name: ${SNAPSHOT_NAME}
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io
   EOF
   done
   
   echo "PVC YAML ファイルが ${OUTPUT_FILE} に書き込まれました"

   </details> このスクリプトは、6 つの位置パラメーターを受け取ります：

5. スクリプトを実行して PVC マニフェストを生成します：

   bash generate_pvc.sh default group-snapshot-demo alicloud-disk-essd 20Gi .kube/config ./output.yaml

   生成された output.yaml は次のようになります：

   ---
   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: disk-mysql-0
   spec:
     volumeMode: Filesystem
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 20Gi
     storageClassName: "alicloud-disk-essd"
     dataSource:
       name: snapshot-1c2c5bcaf47ee2bffcc5b2f52dff65a4aacaaea38032c05d75acd536f7adb850-2024-11-27-6.4.7
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io
   ---
   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: disk-mysql-1
   spec:
     volumeMode: Filesystem
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 20Gi
     storageClassName: "alicloud-disk-essd"
     dataSource:
       name: snapshot-37a2fbf634d68cd2103f261313c2ed781fbd2bd52b5a0d0e0c0ef7c3396fea1c-2024-11-27-6.4.9
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io

   必要に応じて output.yaml を編集し、適用します：

   kubectl apply -f output.yaml

6. StatefulSet のレプリカ数を 2 に戻します：

   kubectl scale sts mysql --replicas=2

7. Pod が再起動した後、データが復元されたことを確認します：

   kubectl exec -it mysql-0 -- bash   # Pod 内でシェルを開く
   mysql -uroot -p123456              # MySQL に接続する
   use test;
   select * from scores;

   期待される出力：

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