将卷组快照与 Trident Protect 结合使用
使用卷组快照在同一时间点捕获相关的持久卷声明(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功能门控也必须在 Tridentcsi-snapshotter容器上启用。 -
必须定义一个使用
csi.trident.netapp.io`驱动程序的 A `VolumeGroupSnapshotClass。如果只定义了一个类,Trident Protect 将使用该类。如果定义了多个类,请使用snapshot.storage.kubernetes.io/is-default-class: "true"`注释 Trident Protect 应使用的类。否则,Trident Protect 将按字母顺序使用第一个类。您不能在 `Application`或 `SnapshotCR 中选择类。有关更多信息,请参阅"卷组快照类"。 -
必须允许 Trident 后端中的 ONTAP 帐户创建、获取和删除一致性组,并对其进行快照。请参阅 "管理应用程序一致性组" 和 "管理应用程序一致性组快照"。默认 SVM 管理员角色 (
vsadmin)不包括这些权限。
定义卷组
Trident Protect 仅为属于某个卷组的卷创建组快照。将 spec.volumeGroups`添加到 `Application CR 以定义组。每个条目都是一个单独的组。按标签、VM 或两者选择卷。
-
您只能在
ApplicationCR 中定义卷组。tridentctl-protectCLI 没有卷组选项。 -
Trident Protect 仅包含卷组中绑定的 PVC,并创建未绑定的 PVC 的单个快照。如果条目未选择绑定的 PVC,Trident Protect 不会为该条目创建组快照。
-
请确保每个 PVC 仅匹配一个条目。
定义要保护的应用程序。请参阅 "使用Trident Protect 定义管理应用程序"。
-
如果按标签选择卷,请标记要分组的 PVC。您可以使用任何标签键和值。此页面上的示例使用
volume-group=my-volume-group。kubectl label pvc <pvc_name_1> <pvc_name_2> volume-group=my-volume-group -n <application_namespace> -
将
spec.volumeGroups`添加到您现有的 `ApplicationCR 文件中。每个条目必须包含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+
保留您的 ApplicationCR 已包含的其他字段,例如spec.resourceFilter。如果从应用的文件中省略某个字段,kubectl apply会将其从 CR 中删除。 -
-
应用更新的 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 字段。
|
-
获取快照的名称。要列出应用程序的快照,请运行以下命令:
kubectl get snapshots -n <application_namespace> -
检查快照的状态:
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中。
Trident Protect 会为组快照中的每个 PVC 添加一个标签,例如 protect.trident.netapp.io/vgs-group-673c0189-0=true。您自己的标签不会更改。该标签将保留在 PVC 上,直到您删除应用程序快照。当您删除应用程序快照时,Trident Protect 还会删除其卷组快照和成员快照,并从 PVC 中删除标签。无论快照的 reclaimPolicy`是 `Delete`还是 `Retain,都会发生这种情况。
以与任何其他快照相同的方式从快照还原应用程序。卷组快照没有单独的还原。Trident Protect 从成员快照还原,因此您可以还原单个 PVC 或 VM,而无需还原组中的每个 PVC。请参阅"从快照还原到其他命名空间"或"从快照还原到原始命名空间"。