From 2136beec3e2806b7a071b7ce6c9c7f7988278b68 Mon Sep 17 00:00:00 2001 From: windsonsea Date: Wed, 14 Aug 2024 17:13:20 +0800 Subject: [PATCH] [zh] Sync storage/persistent-volumes.md --- .../concepts/storage/persistent-volumes.md | 134 ++++++++++-------- 1 file changed, 78 insertions(+), 56 deletions(-) diff --git a/content/zh-cn/docs/concepts/storage/persistent-volumes.md b/content/zh-cn/docs/concepts/storage/persistent-volumes.md index f50293adcda6d..75dcab6abb760 100644 --- a/content/zh-cn/docs/concepts/storage/persistent-volumes.md +++ b/content/zh-cn/docs/concepts/storage/persistent-volumes.md @@ -272,6 +272,7 @@ PV 对象的移除也要推迟到该 PV 不再绑定到 PVC。 ```shell kubectl describe pvc hostpath ``` + ``` Name: hostpath Namespace: default @@ -295,6 +296,7 @@ the `Finalizers` list includes `kubernetes.io/pv-protection` too: ```shell kubectl describe pv task-pv-volume ``` + ``` Name: task-pv-volume Labels: type=local @@ -445,7 +447,7 @@ However, the particular path specified in the custom recycler Pod template in th --> ### PersistentVolume 删除保护 finalizer {#persistentvolume-deletion-protection-finalizer} -{{< feature-state for_k8s_version="v1.23" state="alpha" >}} +{{< feature-state feature_gate_name="HonorPVReclaimPolicy" >}} -新引入的 `kubernetes.io/pv-controller` 和 `external-provisioner.volume.kubernetes.io/finalizer` -终结器仅会被添加到动态制备的卷上。 +（在 v1.31 中引入的）终结器 `external-provisioner.volume.kubernetes.io/finalizer` +被同时添加到动态制备和静态制备的 CSI 卷上。 -终结器 `kubernetes.io/pv-controller` 会被添加到树内插件卷上。 -下面是一个例子： +（在 v1.31 中引入的）终结器 `kubernetes.io/pv-controller` +被添加到动态制备的树内插件卷上，而对于静态制备的树内插件卷，此终结器将被忽略。 + +以下是动态制备的树内插件卷的示例： ```shell kubectl describe pv pvc-74a498d6-3929-47e8-8c02-078c1ece4d78 ``` + ```none Name: pvc-74a498d6-3929-47e8-8c02-078c1ece4d78 Labels: @@ -534,6 +542,16 @@ the `kubernetes.io/pv-controller` finalizer is replaced by the 当为特定的树内卷插件启用了 `CSIMigration{provider}` 特性标志时，`kubernetes.io/pv-controller` 终结器将被替换为 `external-provisioner.volume.kubernetes.io/finalizer` 终结器。 + +这些终结器确保只有在从存储后端删除卷后，PV 对象才会被移除， +前提是 PV 的回收策略为 `Delete`。 +这也确保了无论 PV 和 PVC 的删除顺序如何，此卷都会从存储后端被删除。 + ```yaml apiVersion: v1 kind: PersistentVolumeClaim @@ -625,13 +656,13 @@ the following types of volumes: * azureFile (deprecated) * {{< glossary_tooltip text="csi" term_id="csi" >}} * flexVolume (deprecated) -* rbd +* rbd (deprecated) * portworxVolume (deprecated) --> * azureFile（已弃用） * {{< glossary_tooltip text="csi" term_id="csi" >}} * flexVolume（已弃用） -* rbd +* rbd（已弃用） * portworxVolume（已弃用） +以下的持久卷已被弃用但仍然可用。 +如果你使用除 `flexVolume`、`cephfs` 和 `rbd` 之外的卷类型，请安装相应的 CSI 驱动程序。 + -以下的持久卷已被弃用但仍然可用。 -如果你使用除 `flexVolume`、`cephfs` 和 `rbd` 之外的卷类型，请安装相应的 CSI 驱动程序。 - -* [`awsElasticBlockStore`](/docs/concepts/storage/volumes/#awselasticblockstore) - AWS Elastic 块存储（EBS） +* [`awsElasticBlockStore`](/zh-cn/docs/concepts/storage/volumes/#awselasticblockstore) - AWS Elastic 块存储（EBS） （从 v1.23 开始**默认启用迁移**） -* [`azureDisk`](/docs/concepts/storage/volumes/#azuredisk) - Azure 磁盘 +* [`azureDisk`](/zh-cn/docs/concepts/storage/volumes/#azuredisk) - Azure 磁盘 （从 v1.23 开始**默认启用迁移**） * [`azureFile`](/zh-cn/docs/concepts/storage/volumes/#azurefile) - Azure 文件 （从 v1.24 开始**默认启用迁移**） -* [`cephfs`](/zh-cn/docs/concepts/storage/volumes/#cephfs) - CephFS 卷 - （从 v1.28 开始**弃用**，没有迁移计划，未来版本将移除支持） * [`cinder`](/zh-cn/docs/concepts/storage/volumes/#cinder) - Cinder（OpenStack 块存储） （从 v1.21 开始**默认启用迁移**） * [`flexVolume`](/zh-cn/docs/concepts/storage/volumes/#flexVolume) - FlexVolume （从 v1.23 开始**弃用**，没有迁移计划，没有移除支持的计划） -* [`gcePersistentDisk`](/docs/concepts/storage/volumes/#gcePersistentDisk) - GCE 持久磁盘 +* [`gcePersistentDisk`](/zh-cn/docs/concepts/storage/volumes/#gcePersistentDisk) - GCE 持久磁盘 （从 v1.23 开始**默认启用迁移**） * [`portworxVolume`](/zh-cn/docs/concepts/storage/volumes/#portworxvolume) - Portworx 卷 - （从 v1.25 开始**弃用**） -* [`vsphereVolume`](/zh-cn/docs/concepts/storage/volumes/#vspherevolume) - vSphere VMDK 卷 - （于 v1.19 **弃用**） -* [`cephfs`](/zh-cn/docs/concepts/storage/volumes/#cephfs) - CephFS 卷 - （于 v1.28 **弃用**） -* [`rbd`](/zh-cn/docs/concepts/storage/volumes/#rbd) - Rados Block Device（RBD）卷 - （从 v1.28 开始**弃用**，没有迁移计划，未来版本将移除支持） + （从 v1.31 开始**默认启用迁移**） * [`vsphereVolume`](/zh-cn/docs/concepts/storage/volumes/#vspherevolume) - vSphere VMDK 卷 （从 v1.25 开始**默认启用迁移**） 旧版本的 Kubernetes 仍支持这些“树内（In-Tree）”持久卷类型： -* `photonPersistentDisk` - Photon 控制器持久化盘。（从 v1.15 版本开始将**不可用**） -* `scaleIO` - ScaleIO 卷（v1.21 之后**不可用**） -* `flocker` - Flocker 存储（v1.25 之后**不可用**） -* `quobyte` - Quobyte 卷（v1.25 之后**不可用**） -* `storageos` - StorageOS 卷（v1.25 之后**不可用**） +* [`cephfs`](/zh-cn/docs/concepts/storage/volumes/#cephfs) + （v1.31 之后**不可用**） +* `flocker` - Flocker 存储。 + （v1.25 之后**不可用**） +* `photonPersistentDisk` - Photon 控制器持久化盘 + （v1.15 之后**不可用**） +* `quobyte` - Quobyte 卷。 + （v1.25 之后**不可用**） +* [`rbd`](/zh-cn/docs/concepts/storage/volumes/#rbd) - Rados 块设备 (RBD) 卷 + （v1.31 之后**不可用**） +* `scaleIO` - ScaleIO 卷 + （v1.21 之后**不可用**） +* `storageos` - StorageOS 卷 + （v1.25 之后**不可用**） 访问模式有： @@ -1125,7 +1158,6 @@ to these versions or greater: * [csi-attacher:v3.3.0+](https://github.com/kubernetes-csi/external-attacher/releases/tag/v3.3.0) * [csi-resizer:v1.3.0+](https://github.com/kubernetes-csi/external-resizer/releases/tag/v1.3.0) --> - `ReadWriteOncePod` 访问模式仅适用于 {{< glossary_tooltip text="CSI" term_id="csi" >}} 卷和 Kubernetes v1.22+。 要使用此特性，你需要将以下 [CSI 边车](https://kubernetes-csi.github.io/docs/sidecar-containers.html)更新为下列或更高版本： @@ -1377,7 +1409,7 @@ You can see the name of the PVC bound to the PV using `kubectl describe persiste --> #### 阶段转换时间戳 -{{< feature-state for_k8s_version="v1.29" state="beta" >}} +{{< feature-state feature_gate_name="PersistentVolumeLastPhaseTransitionTime" >}} -你需要启用 `PersistentVolumeLastPhaseTransitionTime` -[特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)以使用或查看 -`lastPhaseTransitionTime` 字段。 -{{< /note >}} - ## PersistentVolumeClaims