Container Service for Kubernetes:ゾーン間でのクラウドディスクを用いたステートフルアプリケーションの移行

適用範囲

NAS および OSS はゾーン間およびマルチマウント利用をサポートしています。一方、ディスクはゾーンにバインドされており、ゾーン間で浮動したり、既存の永続ボリューム要求 (PVC) や永続ボリューム (PV) を再利用することはできません。StatefulSet がディスクボリュームを使用している場合、スナップショットからターゲットゾーンに新しいディスクを作成する必要があります。

制限事項

開始前に、以下の制限事項をご確認ください。

• 業務停止が必要： ゾーン間移行では、移行前に StatefulSet を 0 レプリカにスケールダウンし、ディスク移行完了後にすべてのレプリカを一度に復元します（ローリングアップデートではありません）。ダウンタイムを計画してください。その持続時間は、レプリカ数、コンテナの起動時間、および使用中のディスク容量によって異なります。

• ESSD ディスクのみ対応： StatefulSet で使用されるすべてのストレージは ESSD ディスクである必要があります。この移行機能では、スナップショット作成時間を最小限に抑えるための即時アクセススナップショットが使用されますが、これは ESSD ディスクのみをサポートします。詳細については、「スナップショットの即時アクセス」をご参照ください。

• ターゲットゾーンの要件： ターゲットゾーンは ESSD ディスクをサポートしている必要があり、また、クラスターにはそのゾーン内でスケジューリング可能なノードが存在している必要があります。

アプリケーションが非 ESSD ディスクを使用している場合は、移行前に以下のいずれかの操作を行ってください。

• ディスクタイプを ESSD に変更

• 手動で 単一のディスクボリュームのスナップショットを作成し、ゾーン間でディスクを再構築します。

仕組み

ゾーン間移行はディスクスナップショットに依存しており、スナップショット作成時間を最小限に抑えるためにインスタントアクセススナップショットを使用します。詳細については、「スナップショットの概要」および「スナップショットの課金」をご参照ください。

storage-operator コンポーネントは、以下の手順を実行します。

1. 事前チェック： アプリケーションが正常に実行されていることを検証し、移行対象のディスクを特定します。事前チェックに失敗した場合、移行は中止されます。

2. ゼロスケール： StatefulSet を 0 レプリカにスケールダウンし、アプリケーションを一時停止します。

3. スナップショットの作成： マウント済みのすべてのディスクに対して即時アクセススナップショットを作成します。スナップショットはゾーン非依存であり、任意のゾーンで使用できます。

4. 新規ディスクのプロビジョニング： スナップショットが利用可能であることを確認後、同じデータでターゲットゾーンに新規ディスクを作成します。

5. PVC および PV の再構築： 同じ名前の PVC およびそれに対応する PV を再構築し、新規ディスクにバインドします。

6. レプリカの復元： StatefulSet を元のレプリカ数に復元します。レプリカは自動的に再構築された PVC にバインドされ、新規ディスクをマウントします。

7. （任意）元のリソースの削除： アプリケーションが正常に動作していることを確認後、元の PV およびディスクを削除します。ディスクの課金に関する詳細は、「ブロックストレージの課金」をご参照ください。

前提条件

開始する前に、以下の条件を満たしていることをご確認ください。

• Kubernetes 1.20 以降を実行するクラスター（Container Storage Interface (CSI) ドライバーがインストール済み）

• クラスター内に storage-operator v1.26.2-1de13b6-aliyun 以降がインストール済みであること。インストール手順については、「storage-operator コンポーネントの管理」をご参照ください。

• csi-plugin および csi-provisioner コンポーネントがインストール済みであること。また、csi-provisioner は 非マネージド バージョンを使用している必要があります。

  現在マネージド版の csi-provisioner がインストールされている場合は、アンインストールして非マネージド版をインストールしてください。切り替え後、ストレージコントローラを再起動します：kubectl delete pod -n kube-system <storage-controller-pod-name>

• (ACK 専用クラスターのみ) クラスターのワーカー RAM ロールとマスター RAM ロールには、Elastic Compute Service (ECS) API の ModifyDiskSpec 操作を呼び出す権限が必要です。詳細については、「カスタムポリシーを作成する」をご参照ください。 <details> <summary>必要な RAM ポリシーの表示</summary>

  ACK マネージドクラスターでは、ModifyDiskSpec 権限は必要ありません。

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

  </details>

StatefulSet のゾーン間移行

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

例

以下の例では、3 つのゾーンにノードを持つ ACK Pro マネージドクラスターを使用します。

• ゾーン B： cn-shanghai.192.168.5.245

• ゾーン G： cn-shanghai.192.168.2.214

• ゾーン M： cn-shanghai.192.168.3.236、cn-shanghai.192.168.3.237

よくある質問

移行タスクのステータスが FAILED となった場合、以下のコマンドを実行してエラーメッセージを取得します。

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

出力例：

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

このエラーは、コンポーネントが移行対象の PVC を検出できなかったことを意味します。主な原因は以下のとおりです。

• StatefulSet にマウントされたストレージがありません。

• すべてのディスクがすでにターゲットゾーンに存在しており、移行の必要がありません。

• コンポーネントが PVC 情報を取得できませんでした。

エラーメッセージに基づいて問題を解決し、再度移行タスクを適用してください。