Skip to main content
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

将卷组快照与 Trident Protect 结合使用

贡献者 netapp-shwetav

使用卷组快照在同一时间点捕获相关的持久卷声明(PVC)。这对于写入多个卷的应用程序非常有用,包括具有多个磁盘的虚拟机(VM)。

关于此任务

您可以在 `spec.volumeGroups`自定义资源 (CR) 的 `Application`字段中定义卷组。创建应用程序快照时,Trident Protect 使用 ONTAP 一致性组在同一时刻对卷组中的所有 PVC 执行快照。它为卷组中的每个命名空间创建一个一致性组。组中的每个卷也会获得其自己的快照,因此您可以单独还原卷。

Trident Protect 创建不在卷组中的 PVC 的单独快照。这些快照是逐个创建的,因此无法保证它们反映的是同一时间点。

卷组快照适用于按需快照、计划快照以及 Trident Protect 作为备份的一部分创建的快照。如果备份现有快照,Trident Protect 将使用该快照,不会创建新的组快照。复制也不会创建其他组快照。它使用组快照已创建的每卷快照。

Trident Protect 仅在满足以下所有条件时才会在同一时间点捕获卷:

  • 它们位于同一个卷组中。

  • 它们位于同一个命名空间中。

  • 它们位于同一存储虚拟机(SVM)上。

  • 此卷组在该命名空间中的卷数不超过 80 个。

如果 Trident Protect 无法创建组快照(例如,由于不满足要求),它会向 `status.warnings`添加警告,并为该组的 PVC 创建单独的快照。这些快照是逐个创建的,因此它们可能无法反映相同的时间点。应用程序快照仍会完成。

下表介绍了在常见情况下会发生的情况。

情形 结果

卷组在多个命名空间中选择 PVC

组快照属于一个命名空间,因此 Trident Protect 会在每个命名空间中创建一个单独的组快照。这些组快照并非在同一时刻创建。一个可能成功,而另一个仍在运行、失败或回退到单个快照。例如,在 `payments-a`和 `payments-b`中标记为 `app: payments-db`的 PVC 将成为两个单独的组快照。请勿将来自不同命名空间的组快照视为同一个还原点。

命名空间中的 PVC 位于多个 SVM 上

Trident Protect 不会按 SVM 或 Trident 后端拆分卷。ONTAP 一致性组不能包含来自多个 SVM 的卷,因此整个命名空间(包括共享一个 SVM 的卷)的组快照将失败。Trident Protect 会添加一条警告,删除组快照,并为每个卷创建单独的快照。要将卷一起捕获,请将它们放在同一个 SVM 上。

一个命名空间包含 80 多个匹配的 PVC

Trident Protect 仅跳过该命名空间并创建其 PVC 的单个快照。同一个卷组中的其他命名空间仍会获取组快照。

PVC 与多个 `volumeGroups`条目匹配

Trident Protect 将 PVC 添加到两个卷组,其中一个组快照可能会失败。失败的组快照将回退到单个快照。确保每个 PVC 仅匹配一个条目。

卷组包括使用不支持卷组快照的驱动程序或协议的 PVC

组快照失败,Trident Protect 会为这些 PVC 创建单独的快照。

开始之前
  • PVC 必须使用支持卷组快照的存储驱动程序和协议。有关支持的驱动程序和协议,请参阅 "使用 Trident 卷组快照"。

  • 集群必须运行 Kubernetes 1.36 或更高版本。

  • Kubernetes 快照控制器必须为 8.5.0 或更高版本,并启用 `CSIVolumeGroupSnapshot`功能门控。

  • 必须安装 v1`的 CRD,适用于 `VolumeGroupSnapshot、 VolumeGroupSnapshotClass`和 `VolumeGroupSnapshotContent。

  • 您必须将 Trident 26.10 或更高版本与在线后端配合使用。 CSIVolumeGroupSnapshot 功能门控也必须在 Trident csi-snapshotter 容器上启用。

  • 必须定义一个使用 csi.trident.netapp.io`驱动程序的 A `VolumeGroupSnapshotClass。如果只定义了一个类,Trident Protect 将使用该类。如果定义了多个类,请使用 snapshot.storage.kubernetes.io/is-default-class: "true"`注释 Trident Protect 应使用的类。否则,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 仅匹配一个条目。

开始之前

定义要保护的应用程序。请参阅 "使用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 虚拟机列表,每个虚拟机都带有 namespace`和 `name。Trident Protect 包含每个虚拟机挂载的 PVC。

      以下示例定义了两个卷组。第一组包括带有 `volume-group: my-volume-group`标签的 PVC。第二组包括 `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 包含卷组。应用程序的下一个快照将使用它们。

创建快照

为应用程序创建按需快照、按需备份或数据保护计划。您无需添加任何字段。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 字段对每个组快照都有一个条目。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 的前八个字符、 `spec.volumeGroups`条目的索引(从 `0`开始)和命名空间,截断为 12 个字符。

  • ready: true 表示组快照成功。组成该组的快照也列在 `status.volumeSnapshots`下方。这些是组的成员快照,而不是相同卷的其他快照。

  • skipped: true 表示 Trident Protect 未尝试创建组快照,因为该卷组在该命名空间中的 PVC 超过 80 个。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 或 VM,而无需还原组中的每个 PVC。请参阅"从快照还原到其他命名空间"或"从快照还原到原始命名空间"。