Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Trident Protectでボリュームグループのスナップショットを使用する

共同作成者 netapp-shwetav

ボリュームグループのスナップショットを使用して、関連する永続ボリューム要求(PVC)を同じ時点でキャプチャします。これは、複数のボリュームに書き込むアプリケーション、例えば複数のディスクを持つ仮想マシン(VM)などに役立ちます。

このタスクについて

ボリューム グループは、 spec.volumeGroups カスタム リソース(CR)の Application フィールドで定義します。アプリケーションのスナップショットを作成すると、Trident Protect は ONTAP 整合グループを使用して、ボリューム グループ内のすべての PVC を同時にスナップショットします。ボリューム グループ内のネームスペースごとに 1 つの整合グループが作成されます。グループ内の各ボリュームにも個別のスナップショットが作成されるため、ボリュームを個別にリストアできます。

Trident Protectは、ボリュームグループに属していないPVCの個別のスナップショットを作成します。これらのスナップショットは連続して取得されるため、必ずしも同じ時点の状況を反映しているとは限りません。

ボリュームグループのスナップショットは、オンデマンドスナップショット、スケジュールされたスナップショット、およびTrident Protectがバックアップの一部として取得するスナップショットに適用されます。既存のスナップショットをバックアップする場合、Trident Protectはそのスナップショットを使用し、新しいグループスナップショットは作成しません。レプリケーションでも、別のグループスナップショットは作成されません。グループスナップショットがすでに作成したボリュームごとのスナップショットを使用します。

Trident Protectは、以下のすべての条件を満たす場合にのみ、同じ時点のボリュームをキャプチャします:

  • それらは同じボリュームグループに属しています。

  • これらは同じネームスペースにあります。

  • それらは同じストレージ仮想マシン(SVM)上にあります。

  • ボリュームグループには、そのネームスペース内に80個以下のボリュームが含まれます。

Trident Protectが、要件を満たしていないなどの理由でグループスナップショットを作成できない場合、 `status.warnings`に警告を追加し、そのグループのPVCの個別のスナップショットを作成します。これらのスナップショットは次々に作成されるため、同じ時点の状態を反映していない可能性があります。アプリケーションのスナップショットは引き続き完了します。

以下の表は、一般的な状況で何が起こるかを説明しています。

状況 結果

ボリュームグループは複数のネームスペース内のPVCを選択します

グループスナップショットは1つのネームスペースに属するため、Trident Protect は各ネームスペースに個別のグループスナップショットを作成します。これらのグループスナップショットは同時に作成されるわけではありません。1つが成功する一方で、別のグループスナップショットがまだ実行中であったり、失敗したり、または個別のスナップショットにフォールバックしたりする場合があります。たとえば、 `app: payments-db`のラベルが付いた PVC は、 `payments-a`と `payments-b`において2つの個別のグループスナップショットになります。異なるネームスペースのグループスナップショットを1つのリストアポイントとして扱わないでください。

ネームスペース内のPVCが複数のSVM上に存在する

Trident Protectは、SVMやTridentバックエンドごとにボリュームを分割しません。ONTAPの整合性グループには複数のSVMのボリュームを含めることができないため、SVMを共有するボリュームを含め、そのネームスペース全体のグループスナップショットが失敗します。Trident Protectは警告を追加し、グループスナップショットを削除して、各ボリュームの個別のスナップショットを作成します。ボリュームをまとめてキャプチャするには、同じSVMに配置してください。

ネームスペースに80を超える一致するPVCがあります

Trident Protectはそのネームスペースのみをスキップし、そのPVCの個々のスナップショットを作成します。同じボリュームグループ内の他のネームスペースでは、引き続きグループスナップショットが作成されます。

PVCが複数の `volumeGroups`エントリに一致する

Trident Protectは両方のボリュームグループにPVCを追加しますが、グループスナップショットのいずれかが失敗する可能性があります。失敗したグループスナップショットは、個別のスナップショットにフォールバックします。各PVCが1つのエントリのみに一致することを確認してください。

ボリュームグループには、ボリュームグループのスナップショットをサポートしないドライバまたはプロトコルを使用するPVCが含まれます。

グループスナップショットが失敗し、Trident ProtectはそれらのPVCの個別のスナップショットを作成します。

作業を開始する前に
  • PVCは、ボリュームグループのスナップショットをサポートするストレージドライバとプロトコルを使用する必要があります。サポートされているドライバとプロトコルについては、"Tridentボリュームグループのスナップショットの操作"を参照してください。

  • クラスターはKubernetes 1.36以降で動作している必要があります。

  • Kubernetesスナップショットコントローラはバージョン8.5.0以降であり、 `CSIVolumeGroupSnapshot`機能ゲートが有効になっている必要があります。

  • v1、 VolumeGroupSnapshot、 VolumeGroupSnapshotClass、および `VolumeGroupSnapshotContent`の CRD をインストールする必要があります。

  • オンラインバックエンドには Trident 26.10 以降を使用する必要があります。 `CSIVolumeGroupSnapshot`機能ゲートは、Trident `csi-snapshotter`コンテナでも有効にする必要があります。

  • VolumeGroupSnapshotClass`ドライバーを使用する `csi.trident.netapp.io`を定義する必要があります。クラスが1つだけ定義されている場合、Trident Protect はそのクラスを使用します。複数のクラスが定義されている場合は、Trident Protect が使用するクラスに `snapshot.storage.kubernetes.io/is-default-class: "true"`で注釈を付けます。それ以外の場合、Trident Protect はアルファベット順で最初のクラスを使用します。 `Application`または `Snapshot CR でクラスを選択することはできません。詳細については、"ボリュームグループスナップショットクラス"を参照してください。

  • TridentバックエンドのONTAPアカウントには、整合性グループの作成、取得、削除、およびスナップショットの作成が許可されている必要があります。"アプリケーションの一貫性グループを管理する"および"アプリケーションの一貫性グループのスナップショットを管理する"を参照してください。デフォルトのSVM管理者ロール(vsadmin)には、これらの権限は含まれていません。

ボリュームグループを定義する

Trident Protect は、ボリュームグループに属するボリュームに対してのみグループスナップショットを作成します。グループを定義するには、 spec.volumeGroups を Application CR に追加します。各エントリは個別のグループです。ラベル、VM、またはその両方でボリュームを選択します。

このタスクについて
  • ボリュームグループは、 Application CRでのみ定義できます。 tridentctl-protect CLIにはボリュームグループオプションはありません。

  • Trident Protectは、ボリュームグループ内のバインドされたPVCのみを含め、バインドされていないPVCの個別のスナップショットを作成します。エントリでバインドされたPVCが選択されていない場合、Trident Protectはそのエントリのグループスナップショットを作成しません。

  • 各PVCが1つのエントリのみに対応するようにしてください。

作業を開始する前に

保護するアプリケーションを定義します。"Trident Protectで管理するアプリケーションを定義する"を参照してください。

手順
  1. ラベルでボリュームを選択する場合は、グループ化したいPVCにラベルを付けてください。ラベルのキーと値は任意に使用できます。このページの例では `volume-group=my-volume-group`を使用しています。

    kubectl label pvc <pvc_name_1> <pvc_name_2> volume-group=my-volume-group -n <application_namespace>
  2. spec.volumeGroups`を既存の `Application`CRファイルに追加します。各エントリには、 `labelSelector、 vmSelector、またはその両方を含める必要があります。エントリに両方のフィールドが含まれている場合、ボリュームグループには、いずれかのフィールドで選択されたすべてのボリュームが含まれます。

    • spec.volumeGroups[].labelSelector:アプリケーション内のPVCを選択するKubernetesラベルセレクタ(matchLabels`または `matchExpressions)です。空のセレクタは無効です。

    • spec.volumeGroups[].vmSelector:KubeVirt VMのリスト。それぞれに `namespace`と `name`があります。Trident Protectには、各VMがマウントするPVCが含まれます。

      以下の例では、2つのボリュームグループを定義しています。最初のグループには、 `volume-group: my-volume-group`というラベルが付いたPVCが含まれます。2番目のグループには、 `my-vm-1`と `my-vm-2`がマウントするPVCが含まれます。

    apiVersion: protect.trident.netapp.io/v1
    kind: Application
    metadata:
      name: my-app-name
      namespace: my-namespace
    spec:
      includedNamespaces:
        - namespace: my-namespace
      volumeGroups:
        - labelSelector:
            matchLabels:
              volume-group: my-volume-group
        - vmSelector:
            - namespace: my-namespace
              name: my-vm-1
            - namespace: my-namespace
              name: my-vm-2

    +

    メモ お客様の Application CR にすでに含まれている他のフィールド( `spec.resourceFilter`など)はそのまま保持してください。適用するファイルからフィールドを省略すると、 `kubectl apply`はそのフィールドを CR から削除します。
  3. 更新されたCRを適用します:

    kubectl apply -f <application_cr_file>.yaml
結果
`Application` CRにはボリュームグループが含まれます。アプリケーションの次のスナップショットでは、それらが使用されます。

Snapshot を作成します

アプリケーションのオンデマンドスナップショット、オンデマンドバックアップ、またはデータ保護スケジュールを作成します。フィールドを追加する必要はありません。Trident Protectは、 Application CRで定義したボリュームグループを使用します。手順については、"Trident Protectを使用してアプリケーションを保護する"を参照してください。

メモ デフォルトでは、Trident Protectは、VMファイルシステムをフリーズする前にグループスナップショットを作成します。ボリュームグループ内のボリュームはフリーズせずにキャプチャされるため、VMがまだディスクに書き込んでいないデータは含まれません。ボリュームグループに含まれていないディスクは、Trident ProtectがVMをフリーズした後に個別のスナップショットを作成する際に、後でキャプチャされます。VMのすべてのディスクを同時にキャプチャするには、すべてのディスクをボリュームグループに含めます。VMファイルシステムのフリーズの詳細については、"KubeVirt VMによるデータ保護"を参照してください。

結果を確認する

スナップショットが完了したら、ステータスを確認して、Trident Protectがグループスナップショットを作成したことを確認します。

メモ アプリケーションのスナップショットが完了したからといって、そのグループのスナップショットが成功したとは限りません。すべてのグループスナップショットがスキップされたり失敗したりした場合でも、 VolumeGroupSnapshotsCreated`条件は `true`になり、Trident ProtectはKubernetesイベントやメトリックを作成しません。これを検出するには、 `status.warnings、および `skipped`と `failed`のフィールドを監視します。
手順
  1. スナップショットの名前を取得します。アプリケーションのスナップショットを一覧表示するには、次のコマンドを実行します:

    kubectl get snapshots -n <application_namespace>
  2. スナップショットの状態を確認してください:

    kubectl get snapshots <snapshot_name> -n <application_namespace> -o yaml
結果
`status.volumeGroupSnapshots` フィールドには、グループスナップショットごとに1つのエントリがあります。Trident Protectは、ボリュームグループ内のネームスペースごとに個別のグループスナップショットを作成します。以下の例は省略されています:
status:
  volumeGroupSnapshots:
    - name: vgs-<snapshot_uid_prefix>-<group_index>-<namespace>
      namespace: <namespace>
      ready: true
      memberPVCs:
        - pvcName: <pvc_name_1>
          pvcNamespace: <namespace>
        - pvcName: <pvc_name_2>
          pvcNamespace: <namespace>

グループスナップショット名には、 Snapshot UIDの最初の8文字、 spec.volumeGroups エントリのインデックス( 0 から開始)、および12文字に切り詰められたネームスペースが含まれます。

  • ready: true は、グループスナップショットが成功したことを意味します。グループを構成するスナップショットは、 status.volumeSnapshots にも表示されます。これらはグループのメンバースナップショットであり、同じボリュームの追加スナップショットではありません。

  • skipped: true は、ボリュームグループのそのネームスペース内の PVC が 80 個を超えているため、Trident Protect がグループスナップショットの作成を試みなかったことを意味します。Trident Protect はグループのボリュームの個別スナップショットを作成し、 skipReason テキストを `status.warnings`に追加します。

  • failed: true は、Trident Protect がグループスナップショットの作成を試みたが失敗したことを意味します。Trident Protect はグループのボリュームの個別のスナップショットを代わりに作成し、 error テキストを `status.warnings`に追加します。

一時的なPVCラベルとクリーンアップ

Trident Protectは、グループスナップショット内の各PVCにラベルを追加します(例: protect.trident.netapp.io/vgs-group-673c0189-0=true)。お客様独自のラベルは変更されません。アプリケーションスナップショットを削除するまで、ラベルはPVCに残ります。アプリケーションスナップショットを削除すると、Trident Protectはボリュームグループスナップショットとメンバースナップショットも削除し、PVCからラベルを削除します。これは、スナップショットの `reclaimPolicy`が `Delete`であるか `Retain`であるかにかかわらず発生します。

次の手順

他のスナップショットと同様の方法で、スナップショットからアプリケーションをリストアします。ボリュームグループのスナップショットには、個別のリストアはありません。Trident Protectはメンバースナップショットからリストアするため、グループ内のすべてのPVCをリストアすることなく、個々のPVCまたはVMをリストアできます。"Snapshotから別のネームスペースへのリストア" または "Snapshotから元のネームスペースへのリストア" を参照してください。