了解对象，对象的用途以及对象交互方式的最简单方法可能是，遵循 Kubernetes 用户的单个存储请求：

Kubernetes PersistentVolumeClaim 对象是 Kubernetes 集群用户发出的存储请求。

除了标准规范之外，如果用户要覆盖在后端配置中设置的默认值， Trident 还允许用户指定以下特定于卷的标注：

如果创建的 PV 具有 Delete reclaime 策略，则在释放 PV 时（即用户删除 PVC 时）， Trident 会同时删除 PV 和后备卷。如果删除操作失败， Trident 会将 PV 标记为相应的 PV ，并定期重试此操作，直到操作成功或 PV 手动删除为止。如果 PV 使用 ` retain` 策略， Trident 会忽略该策略，并假定管理员将从 Kubernetes 和后端清理该策略，以便在删除卷之前对其进行备份或检查。请注意，删除 PV 不会通过发生原因 Trident 删除后备卷。您应使用 REST API （tridentctl ）将其删除。

Trident 支持使用 CSI 规范创建卷快照：您可以创建卷快照并将其用作数据源来克隆现有 PVC 。这样， PV 的时间点副本就可以以快照的形式公开给 Kubernetes 。然后，可以使用快照创建新的 PV 。请查看 ` + 按需卷快照 +` 了解其工作原理。

Trident 还提供了用于创建克隆的 cloneFromPVC 和 splitOnClone 标注。您可以使用这些标注克隆 PVC ，而无需使用 CSI 实施（在 Kubernetes 1.13 及更早版本上），或者您的 Kubernetes 版本不支持测试版卷快照（ Kubernetes 1.16 及更早版本）。请注意， Trident 19.10 支持从 PVC 克隆的 CSI 工作流。

例如：如果用户已经有一个名为 mysql 的 PVC ，则用户可以使用标注创建一个名为 mysqlclone 的新 PVC ，例如 trident.netapp.io/cloneFromPVC: mysql 。设置了此标注后， Trident 将克隆与 mysql PVC 对应的卷，而不是从头开始配置卷。

请考虑以下几点：

sample-input 目录包含用于 Trident 的 PVC 定义示例。有关与 Trident 卷关联的参数和设置的完整问题描述，请参见 Trident 卷对象。

Kubernetes PersistentVolume 对象表示可供 Kubernetes 集群使用的一段存储。它的生命周期与使用它的 POD 无关。

创建引用基于 Trident 的 S存储类 的 PVC 时， Trident 会使用相应的存储类配置新卷并为该卷注册新的 PV 。在配置已配置的卷和相应的 PV 时， Trident 会遵循以下规则：

Kubernetes StorageClass 对象在 PersistentVolumeClass 中按名称指定，用于使用一组属性配置存储。存储类本身可标识要使用的配置程序，并按配置程序所了解的术语定义该属性集。

它是需要由管理员创建和管理的两个基本对象之一。另一个是 Trident 后端对象。

使用 Trident 的 Kubernetes StorageClass 对象如下所示：

这些参数是 Trident 专用的，可告诉 Trident 如何为类配置卷。

存储类参数包括：

存储属性及其可能值可以分类为存储池选择属性和 Kubernetes 属性。

Kubernetes VolumeSnapshotClass 对象类似于 StorageClasses 。它们有助于定义多个存储类，并由卷快照引用以将快照与所需的快照类关联。每个卷快照都与一个卷快照类相关联。

要创建快照，管理员应定义 VolumeSnapshotClass 。此时将使用以下定义创建卷快照类：

driver 指定给 Kubernetes ，由 Trident 处理对 csI-snapclass 类的卷快照请求。deeltionPolicy 指定必须删除快照时要执行的操作。如果将 deletionPolicy 设置为 Delete ，则在删除快照时，卷快照对象以及存储集群上的底层快照将被删除。或者，如果将其设置为 Retain ，则表示保留 VolumeSnapshotContent 和物理快照。

Kubernetes VolumeSnapshot 对象是创建卷快照的请求。就像 PVC 代表用户对卷发出的请求一样，卷快照也是用户为现有 PVC 创建快照的请求。

收到卷快照请求后， Trident 会自动管理在后端为卷创建快照的操作，并通过创建唯一的 VolumeSnapshotContent 对象公开快照。您可以从现有 PVC 创建快照，并在创建新 PVC 时将这些快照用作 DataSource 。

Kubernetes VolumeSnapshotContent 对象表示从已配置的卷创建的快照。它类似于 PersistentVolume ，表示存储集群上配置的快照。与 PersistentVolumeClaim 和 PersistentVolume 对象类似，创建快照时， VolumeSnapshotContent 对象会与请求创建快照的 VolumeSnapshot 对象保持一对一映射。

VolumeSnapshotContent 对象包含用于唯一标识快照的详细信息，例如 snapshotHandle 。此 snapshotHandle 是 PV 名称和 VolumeSnapshotContent 对象名称的唯一组合。

收到快照请求后， Trident 会在后端创建快照。创建快照后， Trident 会配置一个 VolumeSnapshotContent 对象，从而将快照公开到 Kubernetes API 。

Kubernetes 自定义资源是 Kubernetes API 中的端点，由管理员定义并用于对类似对象进行分组。Kubernetes 支持创建自定义资源以存储对象集合。您可以通过运行 kubectl get crds 来获取这些资源定义。

自定义资源定义（ CRD ）及其关联的对象元数据由 Kubernetes 存储在其元数据存储中。这样就无需为 Trident 创建单独的存储。

从 19.07 版开始， Trident 会使用许多 CustomResourceDefinition 对象来保留 Trident 对象的身份，例如 Trident 后端， Trident 存储类和 Trident 卷。这些对象由 Trident 管理。此外， CSI 卷快照框架还引入了一些定义卷快照所需的 CRD 。

CRD 是一种 Kubernetes 构造。上述资源的对象由 Trident 创建。例如，使用 tridentctl 创建后端时，会创建一个对应的 tridentbackend CRD 对象，供 Kubernetes 使用。

有关 Trident 的 CRD ，请注意以下几点：

Trident 会为 Kubernetes StorageClass 在其配置程序字段中指定 csi.trident.netapp.io/netapp.io/trident 的对象创建匹配的存储类。存储类名称与 Kubernetes StorageClass 其所代表的对象的名称匹配。

存储类包含一组卷要求。Trident 会将这些要求与每个存储池中的属性进行匹配；如果匹配，则该存储池是使用该存储类配置卷的有效目标。

您可以使用 REST API 创建存储类配置以直接定义存储类。但是，对于 Kubernetes 部署，我们希望在注册新的 Kubernetes StorageClass 对象时创建这些部署。

后端表示存储提供程序，其中 Trident 配置卷；单个 Trident 实例可以管理任意数量的后端。

有关如何构建这些对象的详细信息，请参见后端配置。

存储池表示可在每个后端配置的不同位置。对于 ONTAP ，这些聚合对应于 SVM 中的聚合。对于 NetApp HCI/SolidFire ，这些 QoS 分段对应于管理员指定的 QoS 分段。对于 Cloud Volumes Service ，这些区域对应于云提供商区域。每个存储池都有一组不同的存储属性，用于定义其性能特征和数据保护特征。

与此处的其他对象不同，存储池候选对象始终会自动发现和管理。

卷是基本配置单元，由后端端点组成，例如 NFS 共享和 iSCSI LUN 。在 Kubernetes 中，这些卷直接对应于 PersistentVolumes 。创建卷时，请确保其具有存储类，此类可确定可配置该卷的位置以及大小。

卷配置定义了配置的卷应具有的属性。

创建卷时， Trident 会生成 internalName 。这包括两个步骤。首先，它会将存储前缀（默认值 trident 或后端配置中的前缀）预先添加到卷名称中，从而使名称格式为 ` <prefix>-<volume-name>` 。然后，它将继续清理名称，替换后端不允许使用的字符。对于 ONTAP 后端，它会将连字符替换为下划线（因此，内部名称将变为 ` <prefix>_<volume-name>` ）。对于 Element 后端，它会将下划线替换为连字符。

您可以使用卷配置使用 REST API 直接配置卷，但在 Kubernetes 部署中，我们希望大多数用户使用标准的 Kubernetes PersistentVolumeClaim 方法。Trident 会在配置过程中自动创建此卷对象。

快照是卷的时间点副本，可用于配置新卷或还原状态。在 Kubernetes 中，这些对象直接对应于 VolumeSnapshotContent 对象。每个快照都与一个卷相关联，该卷是快照的数据源。

每个 Snapshot 对象包括以下属性：

创建 Kubernetes VolumeSnapshot 对象请求时， Trident 会在备用存储系统上创建 Snapshot 对象。此快照对象的 internalName 是通过将前缀 snapshot- 与 VolumeSnapshot 对象的 UID （例如， snapshot-e8d8a0ca-9826-11e9-9807-525400f3f660 ）组合而生成的。VolumeName 和 volumeInternalName 可通过获取后备卷的详细信息来填充。