From 6ed70a8924bbc426a708caff6e038759667bf07f Mon Sep 17 00:00:00 2001 From: Mengjiao Liu Date: Tue, 10 May 2022 11:58:53 +0800 Subject: [PATCH] [zh] Sync concepts-2: storage-capacity.md and volume-snapshots.md --- .../docs/concepts/storage/storage-capacity.md | 65 +++++++---------- .../docs/concepts/storage/volume-snapshots.md | 69 +++++++++++++++++++ 2 files changed, 94 insertions(+), 40 deletions(-) diff --git a/content/zh/docs/concepts/storage/storage-capacity.md b/content/zh/docs/concepts/storage/storage-capacity.md index 10089b428d..7cf604cf56 100644 --- a/content/zh/docs/concepts/storage/storage-capacity.md +++ b/content/zh/docs/concepts/storage/storage-capacity.md @@ -10,58 +10,66 @@ Storage capacity is limited and may vary depending on the node on which a pod runs: network-attached storage might not be accessible by all nodes, or storage is local to a node to begin with. -{{< feature-state for_k8s_version="v1.21" state="beta" >}} +{{< feature-state for_k8s_version="v1.24" state="stable" >}} This page describes how Kubernetes keeps track of storage capacity and -how the scheduler uses that information to schedule Pods onto nodes +how the scheduler uses that information to [schedule Pods](/docs/concepts/scheduling-eviction/) onto nodes that have access to enough storage capacity for the remaining missing volumes. Without storage capacity tracking, the scheduler may choose a node that doesn't have enough capacity to provision a volume and multiple scheduling retries will be needed. - -Tracking storage capacity is supported for {{< glossary_tooltip -text="Container Storage Interface" term_id="csi" >}} (CSI) drivers and -[needs to be enabled](#enabling-storage-capacity-tracking) when installing a CSI driver. --> 存储容量是有限的，并且会因为运行 Pod 的节点不同而变化： 网络存储可能并非所有节点都能够访问，或者对于某个节点存储是本地的。 -{{< feature-state for_k8s_version="v1.21" state="beta" >}} +{{< feature-state for_k8s_version="v1.24" state="stable" >}} 本页面描述了 Kubernetes 如何跟踪存储容量以及调度程序如何为了余下的尚未挂载的卷使用该信息将 -Pod 调度到能够访问到足够存储容量的节点上。 +[Pod 调度](/zh/docs/concepts/scheduling-eviction/)到能够访问到足够存储容量的节点上。 如果没有跟踪存储容量，调度程序可能会选择一个没有足够容量来提供卷的节点，并且需要多次调度重试。 -{{< glossary_tooltip text="容器存储接口" term_id="csi" >}}（CSI）驱动程序支持跟踪存储容量， -并且在安装 CSI 驱动程序时[需要启用](#enabling-storage-capacity-tracking)该功能。 +## {{% heading "prerequisites" %}} + + +Kubernetes v{{< skew currentVersion >}} 包含了对存储容量跟踪的集群级 API 支持。 +要使用它，你还必须使用支持容量跟踪的 CSI 驱动程序。请查阅你使用的 CSI 驱动程序的文档， +以了解此支持是否可用，如果可用，该如何使用它。如果你运行的不是 +Kubernetes v{{< skew currentVersion >}}，请查看对应版本的 Kubernetes 文档。 ## API 这个特性有两个 API 扩展接口： -- CSIStorageCapacity 对象：这些对象由 CSI 驱动程序在安装驱动程序的命名空间中产生。 +- [CSIStorageCapacity](/docs/reference/kubernetes-api/config-and-storage-resources/csi-storage-capacity-v1/) 对象：这些对象由 + CSI 驱动程序在安装驱动程序的命名空间中产生。 每个对象都包含一个存储类的容量信息，并定义哪些节点可以访问该存储。 -- [`CSIDriverSpec.StorageCapacity` 字段](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#csidriverspec-v1-storage-k8s-io)： +- [`CSIDriverSpec.StorageCapacity` 字段](/docs/reference/kubernetes-api/config-and-storage-resources/csi-driver-v1/#CSIDriverSpec)： 设置为 true 时，Kubernetes 调度程序将考虑使用 CSI 驱动程序的卷的存储容量。 ## 限制 @@ -151,32 +156,12 @@ to handle this automatically. 当 Pod 使用多个卷时，调度可能会永久失败：一个卷可能已经在拓扑段中创建，而该卷又没有足够的容量来创建另一个卷， 要想从中恢复，必须要进行手动干预，比如通过增加存储容量或者删除已经创建的卷。 -需要[进一步工作](https://github.com/kubernetes/enhancements/pull/1703)来自动处理此问题。 - - -## 开启存储容量跟踪 - -存储容量跟踪是一个 Beta 特性，从 Kubernetes 1.21 版本起在 Kubernetes 集群 -中默认被启用。除了在集群中启用此功能特性之外，还要求 CSI 驱动支持此特性。 -请参阅驱动的文档了解详细信息。 ## {{% heading "whatsnext" %}} - 想要获得更多该设计的信息，查看 [Storage Capacity Constraints for Pod Scheduling KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-storage/1472-storage-capacity-tracking/README.md)。 -- 有关此功能的下一步开发信息，查看 - [enhancement tracking issue #1472](https://github.com/kubernetes/enhancements/issues/1472)。 -- 学习 [Kubernetes 调度器](/zh/docs/concepts/scheduling-eviction/kube-scheduler/)。 diff --git a/content/zh/docs/concepts/storage/volume-snapshots.md b/content/zh/docs/concepts/storage/volume-snapshots.md index f4ded9d560..d556faafea 100644 --- a/content/zh/docs/concepts/storage/volume-snapshots.md +++ b/content/zh/docs/concepts/storage/volume-snapshots.md @@ -233,6 +233,7 @@ spec: driver: hostpath.csi.k8s.io source: volumeHandle: ee0cfb94-f8d4-11e9-b2d8-0242ac110002 + sourceVolumeMode: Filesystem volumeSnapshotClassName: csi-hostpath-snapclass volumeSnapshotRef: name: new-snapshot-test @@ -259,6 +260,7 @@ spec: driver: hostpath.csi.k8s.io source: snapshotHandle: 7bdd0de3-aaeb-11e8-9aae-0242ac110002 + sourceVolumeMode: Filesystem volumeSnapshotRef: name: new-snapshot-test namespace: default @@ -268,6 +270,73 @@ spec: --> `snapshotHandle` 是存储后端创建卷的唯一标识符。对于预设置快照，这个字段是必须的。它指定此 `VolumeSnapshotContent` 表示的存储系统上的 CSI 快照 id。 + +`sourceVolumeMode` 是创建快照的卷的模式。`sourceVolumeMode` 字段的值可以是 +`Filesystem` 或 `Block`。如果没有指定源卷模式，Kubernetes 会将快照视为未知的源卷模式。 + + +## 转换快照的卷模式 {#convert-volume-mode} + +如果在你的集群上安装的 `VolumeSnapshots` API 支持 `sourceVolumeMode` +字段，则该 API 可以防止未经授权的用户转换卷的模式。 + +要检查你的集群是否具有此特性的能力，可以运行如下命令： + +```yaml +$ kubectl get crd volumesnapshotcontent -o yaml +``` + + +如果你希望允许用户从现有的 `VolumeSnapshot` 创建 `PersistentVolumeClaim`， +但是使用与源卷不同的卷模式，则需要添加注解 +`snapshot.storage.kubernetes.io/allowVolumeModeChange: "true"` +到对应 `VolumeSnapshot` 的 `VolumeSnapshotContent` 中。 + +对于预配置的快照，`Spec.SourceVolumeMode` 需要由集群管理员填充。 + +启用此特性的 `VolumeSnapshotContent` 资源示例如下所示： + +```yaml +apiVersion: snapshot.storage.k8s.io/v1 +kind: VolumeSnapshotContent +metadata: + name: new-snapshot-content-test + annotations: + - snapshot.storage.kubernetes.io/allowVolumeModeChange: "true" +spec: + deletionPolicy: Delete + driver: hostpath.csi.k8s.io + source: + snapshotHandle: 7bdd0de3-aaeb-11e8-9aae-0242ac110002 + sourceVolumeMode: Filesystem + volumeSnapshotRef: + name: new-snapshot-test + namespace: default +``` +