website/content/zh/docs/concepts/storage/volume-snapshots.md

title, content_template, weight

title	content_template	weight
卷快照	templates/concept	20

{{% capture overview %}}

{{< feature-state for_k8s_version="v1.12" state="alpha" >}}

本文档描述 Kubernetes 中 VolumeSnapshots 的当前状态。建议先熟悉持久卷。

{{% /capture %}}

{{% capture body %}}

介绍

与 PersistentVolume 和 PersistentVolumeClaim 两个 API 资源用于给用户和管理员提供卷类似，VolumeSnapshotContent 和 VolumeSnapshot 两个 API 资源用于给用户和管理员创建卷快照。

VolumeSnapshotContent 是从管理员已提供的集群中的卷获取的快照。就像持久卷是集群的资源一样，它也是集群中的资源。

VolumeSnapshot 是用户对于卷的快照的请求。它类似于持久卷声明。

VolumeSnapshots 允许用户消费抽象的存储资源，集群管理员需要能够提供多种 VolumeSnapshotContents，又不会向用户暴露这些应该供应的卷快照的细节。为了实现这些需求，就需要 VolumeSnapshotClass 资源。

当使用该功能时，用户需要注意以下几点：

• API 对象 VolumeSnapshot，VolumeSnapshotContent 和 VolumeSnapshotClass 是 CRD，不是核心 API 的部分。
• VolumeSnapshot 支持仅可用于 CSI 驱动。
• 作为部署过程的一部分，Kubernetes 团队为快照控制器提供了一个名为 external-snapshotter 的 sidecar 帮助容器。它监视 VolumeSnapshot 对象然后向 CSI 端点触发 CreateSnapshot 和 DeleteSnapshot 操作。
• CSI 驱动可能实现，也可能没有实现卷快照功能。CSI 驱动可能会使用 external-snapshotter 来提供对卷快照的支持。
• 支持卷快照的 CSI 驱动将自动安装 用于定义卷快照定义的 CRD。

卷快照和卷快照内容的生命周期

VolumeSnapshotContents 是集群中的资源。VolumeSnapshots 是对于这些资源的请求。VolumeSnapshotContents 和 VolumeSnapshots 之间的交互遵循以下生命周期：

供应卷快照

快照可以通过两种方式进行供应：静态或动态。

静态的

集群管理员创建多个 VolumeSnapshotContents。它们带有实际存储的详细信息，可以供集群用户使用。它们存在于 Kubernetes API 中，并且能够被使用。

动态的

当管理员创建的静态 VolumeSnapshotContents 都不能匹配用户的 VolumeSnapshot，集群可能会尝试专门为 VolumeSnapshot 对象供应一个卷快照。此供应基于 VolumeSnapshotClasses：VolumeSnapshot 必须请求卷快照类并且管理员必须已经创建并配置了该类，才能进行动态供应。

绑定

用户创建，或在动态供应场景下已经创建了的 VolumeSnapshot 具有特定数量的存储请求和特定的访问模式。一个控制循环监视新的 VolumeSnapshots，找到匹配的 VolumeSnapshotContent（如果可能），并把它们绑定到一起。如果 VolumeSnapshotContent 是给动态供应给一个新的VolumeSnapshot，循环将依然绑定 VolumeSnapshotContent 到 VolumeSnapshot。一旦绑定，无论是如何绑定的，VolumeSnapshot 绑定都是排他的。VolumeSnapshot 到 VolumeSnapshotContent 的绑定是一对一的映射。

如果不存在匹配的 VolumeSnapshotContent，VolumeSnapshots 将永远保持未绑定状态。当匹配的 VolumeSnapshotContents 可用时，将绑定 VolumeSnapshots。

使用保护的持久性卷声明

使用保护的持久性卷声明功能的目的是确保使用中的 PVC API 对象不会从系统中被删除（因为这可能会导致数据丢失）。

如果一个 PVC 正在被快照用来作为源进行快照创建，则该 PVC 是使用中的。如果用户删除正作为快照源的 PVC API 对象，则 PVC 对象不会立即被删除掉。相反，PVC 对象的删除将推迟到任何快照不在主动使用它为止。当快照的 Status 中的 ReadyToUse值为 true 时，PVC 将不再用作快照源。

删除

删除操作会从 Kubernetes API 中删除 VolumeSnapshotContent 对象，同时删除它在外部基础架构中关联存储资产。

卷快照内容

每个 VolumeSnapshotContent 包含一个 spec，用来表示卷快照的规格。

apiVersion: snapshot.storage.k8s.io/v1alpha1
kind: VolumeSnapshotContent
metadata:
  name: new-snapshot-content-test
spec:
  snapshotClassName: csi-hostpath-snapclass
  source:
    name: pvc-test
    kind: PersistentVolumeClaim
  volumeSnapshotSource:
    csiVolumeSnapshotSource:
      creationTime:    1535478900692119403
      driver:          csi-hostpath
      restoreSize:     10Gi
      snapshotHandle:  7bdd0de3-aaeb-11e8-9aae-0242ac110002

类

VolumeSnapshotContent 可以具有一个类，该类通过设置 snapshotClassName 属性为 VolumeSnapshotClass 的名称来指定。一个特定类的 VolumeSnapshotContent 只能够绑定到请求该类的 VolumeSnapshots。没有 snapshotClassName 的 VolumeSnapshotContent 没有类，并且只能绑定到不要求特定类的 VolumeSnapshots。

VolumeSnapshots

每个 VolumeSnapshot 对象包含 spec 和 status，用来表示卷快照的规格和状态。

apiVersion: snapshot.storage.k8s.io/v1alpha1
kind: VolumeSnapshot
metadata:
  name: new-snapshot-test
spec:
  snapshotClassName: csi-hostpath-snapclass
  source:
    name: pvc-test
    kind: PersistentVolumeClaim

类

通过使用 snapshotClassName 属性来指定 VolumeSnapshotClass 的名称，卷快照可以请求特定的类。 只有所请求类（与 VolumeSnapshot 有相同的 snapshotClassName）的 VolumeSnapshotContents 才可以绑定到 VolumeSnapshot。

从快照供应卷

你可以供应一个新卷，该卷预填充了快照中的数据，在 持久卷声明 对象中使用 dataSource 字段。

更多详细信息，请参阅 卷快照和从快照还原卷。

{{% /capture %}}