Merge pull request #44130 from windsonsea/volumey

[zh] Sync /storage/volumes.md

Author: k8s-ci-robot

content/zh-cn/docs/concepts/storage/volumes.md

@@ -139,7 +139,7 @@ AWSElasticBlockStore 树内存储驱动已在 Kubernetes v1.19 版本中废弃
 并在 v1.27 版本中被完全移除。
 
 Kubernetes 项目建议你转为使用 [AWS EBS](https://github.com/kubernetes-sigs/aws-ebs-csi-driver)
-第三方存储驱动。
+第三方存储驱动插件。
 
 <!--
 ### azureDisk (removed) {#azuredisk}
@@ -163,7 +163,7 @@ Kubernetes {{< skew currentVersion >}} 不包含 `azureDisk` 卷类型。
 AzureDisk 树内存储驱动已在 Kubernetes v1.19 版本中废弃，并在 v1.27 版本中被完全移除。
 
 Kubernetes 项目建议你转为使用 [Azure Disk](https://github.com/kubernetes-sigs/azuredisk-csi-driver)
-第三方存储驱动。
+第三方存储驱动插件。
 
 <!--
 ### azureFile (deprecated) {#azurefile}
@@ -234,7 +234,8 @@ and the kubelet, set the `InTreePluginAzureFileUnregister` flag to `true`.
 The Kubernetes project suggests that you use the [CephFS CSI](https://github.com/ceph/ceph-csi) third party
 storage driver instead.
 -->
-Kubernetes 项目建议你转为使用 [CephFS CSI](https://github.com/ceph/ceph-csi) 第三方存储驱动。
+Kubernetes 项目建议你转为使用 [CephFS CSI](https://github.com/ceph/ceph-csi)
+第三方存储驱动插件。
 {{< /note >}}
 
 <!--
@@ -288,7 +289,7 @@ OpenStack Cinder 树内存储驱动已在 Kubernetes v1.11 版本中废弃，
 
 Kubernetes 项目建议你转为使用
 [OpenStack Cinder](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md)
-第三方存储驱动。
+第三方存储驱动插件。
 
 ### configMap
 
@@ -516,163 +517,27 @@ for more details.
 更多详情请参考 [FC 示例](https://github.com/kubernetes/examples/tree/master/staging/volumes/fibre_channel)。
 
 <!--
-### gcePersistentDisk (deprecated) {#gcepersistentdisk}
+### gcePersistentDisk (removed) {#gcepersistentdisk}
 
-A `gcePersistentDisk` volume mounts a Google Compute Engine (GCE)
-[persistent disk](https://cloud.google.com/compute/docs/disks) (PD) into your Pod.
-Unlike `emptyDir`, which is erased when a pod is removed, the contents of a PD are
-preserved and the volume is merely unmounted. This means that a PD can be
-pre-populated with data, and that data can be shared between pods.
+Kubernetes {{< skew currentVersion >}} does not include a `gcePersistentDisk` volume type.
 -->
-### gcePersistentDisk（已弃用） {#gcepersistentdisk}
+### gcePersistentDisk（已移除） {#gcepersistentdisk}
 
-{{< feature-state for_k8s_version="v1.17" state="deprecated" >}}
+Kubernetes {{< skew currentVersion >}} 不包含 `gcePersistentDisk` 卷类型。
 
-`gcePersistentDisk` 卷能将谷歌计算引擎 (GCE) [持久盘（PD）](http://cloud.google.com/compute/docs/disks)
-挂载到你的 Pod 中。
-不像 `emptyDir` 那样会在 Pod 被删除的同时也会被删除，持久盘卷的内容在删除 Pod
-时会被保留，卷只是被卸载了。
-这意味着持久盘卷可以被预先填充数据，并且这些数据可以在 Pod 之间共享。
-
-{{< note >}}
 <!--
-You must create a PD using `gcloud` or the GCE API or UI before you can use it.
+The `gcePersistentDisk` in-tree storage driver was deprecated in the Kubernetes v1.17 release
+and then removed entirely in the v1.28 release.
 -->
-在使用 PD 前，你必须使用 `gcloud` 或者 GCE API 或 UI 创建它。
-{{< /note >}}
+`gcePersistentDisk` 源代码树内卷存储驱动在 Kubernetes v1.17 版本中被弃用，在 v1.28 版本中被完全移除。
 
 <!--
-There are some restrictions when using a `gcePersistentDisk`:
-
-* the nodes on which Pods are running must be GCE VMs
-* those VMs need to be in the same GCE project and zone as the persistent disk
--->
-使用 `gcePersistentDisk` 时有一些限制：
-
-* 运行 Pod 的节点必须是 GCE VM
-* 这些 VM 必须和持久盘位于相同的 GCE 项目和区域（zone）
-
-<!--
-One feature of GCE persistent disk is concurrent read-only access to a persistent disk.
-A `gcePersistentDisk` volume permits multiple consumers to simultaneously
-mount a persistent disk as read-only. This means that you can pre-populate a PD with your dataset
-and then serve it in parallel from as many Pods as you need. Unfortunately,
-PDs can only be mounted by a single consumer in read-write mode. Simultaneous
-writers are not allowed.
--->
-GCE PD 的一个特点是它们可以同时被多个消费者以只读方式挂载。
-这意味着你可以用数据集预先填充 PD，然后根据需要并行地在尽可能多的 Pod 中提供该数据集。
-不幸的是，PD 只能由单个使用者以读写模式挂载，即不允许同时写入。
-
-<!--
-Using a GCE persistent disk with a Pod controlled by a ReplicaSet will fail unless
-the PD is read-only or the replica count is 0 or 1.
--->
-在由 ReplicationController 所管理的 Pod 上使用 GCE PD 将会失败，除非 PD
-是只读模式或者副本的数量是 0 或 1。
-
-<!--
-#### Creating a GCE persistent disk {#gce-create-persistent-disk}
-
-Before you can use a GCE persistent disk with a Pod, you need to create it.
--->
-#### 创建 GCE 持久盘（PD）   {#gce-create-persistent-disk}
-
-在 Pod 中使用 GCE 持久盘之前，你首先要创建它。
-
-```shell
-gcloud compute disks create --size=500GB --zone=us-central1-a my-data-disk
-```
-
-<!--
-#### Example Pod
--->
-#### GCE 持久盘配置示例 {#gce-pd-configuration-example}
-
-```yaml
-apiVersion: v1
-kind: Pod
-metadata:
-  name: test-pd
-spec:
-  containers:
-  - image: registry.k8s.io/test-webserver
-    name: test-container
-    volumeMounts:
-    - mountPath: /test-pd
-      name: test-volume
-  volumes:
-  - name: test-volume
-    # 此 GCE PD 必须已经存在
-    gcePersistentDisk:
-      pdName: my-data-disk
-      fsType: ext4
-```
-<!--
-#### Regional persistent Disks
--->
-#### 区域持久盘   {#regional-persistent-disks}
-
-<!--
-The [Regional persistent disks](https://cloud.google.com/compute/docs/disks/#repds)
-feature allows the creation of persistent disks that are available in two zones
-within the same region. In order to use this feature, the volume must be provisioned
-as a PersistentVolume; referencing the volume directly from a pod is not supported.
--->
-[区域持久盘](https://cloud.google.com/compute/docs/disks/#repds)特性允许你创建能在同一区域的两个可用区中使用的持久盘。
-要使用这个特性，必须以持久卷（PersistentVolume）的方式提供卷；直接从
-Pod 引用这种卷是不可以的。
-
-<!--
-#### Manually provisioning a Regional PD PersistentVolume
-
-Dynamic provisioning is possible using a
-[StorageClass for GCE PD](/docs/concepts/storage/storage-classes/#gce-pd).
-Before creating a PersistentVolume, you must create the persistent disk:
--->
-#### 手动制备基于区域 PD 的 PersistentVolume {#manually-provisioning-regional-pd-pv}
-
-使用[为 GCE PD 定义的存储类](/zh-cn/docs/concepts/storage/storage-classes/#gce-pd)
-可以实现动态制备。在创建 PersistentVolume 之前，你首先要创建 PD。
-
-```shell
-gcloud compute disks create --size=500GB my-data-disk
-  --region us-central1
-  --replica-zones us-central1-a,us-central1-b
-```
-
-<!--
-#### Regional persistent disk configuration example
--->
-#### 区域持久盘配置示例
-
-<!--
-# failure-domain.beta.kubernetes.io/zone should be used prior to 1.21
+The Kubernetes project suggests that you use the [Google Compute Engine Persistent Disk CSI](https://github.com/kubernetes-sigs/gcp-compute-persistent-disk-csi-driver) 
+third party storage driver instead.
 -->
-```yaml
-apiVersion: v1
-kind: PersistentVolume
-metadata:
-  name: test-volume
-spec:
-  capacity:
-    storage: 400Gi
-  accessModes:
-  - ReadWriteOnce
-  gcePersistentDisk:
-    pdName: my-data-disk
-    fsType: ext4
-  nodeAffinity:
-    required:
-      nodeSelectorTerms:
-      - matchExpressions:
-        # failure-domain.beta.kubernetes.io/zone 应在 1.21 之前使用
-        - key: topology.kubernetes.io/zone
-          operator: In
-          values:
-          - us-central1-a
-          - us-central1-b
-```
+Kubernetes 项目建议你转为使用
+[Google Compute Engine Persistent Disk CSI](https://github.com/kubernetes-sigs/gcp-compute-persistent-disk-csi-driver)
+第三方存储驱动插件。
 
 <!--
 #### GCE CSI migration
@@ -693,23 +558,9 @@ must be installed on the cluster.
 为了使用此特性，必须在集群中上安装
 [GCE PD CSI 驱动程序](https://github.com/kubernetes-sigs/gcp-compute-persistent-disk-csi-driver)。
 
-<!-- 
-#### GCE CSI migration complete
-
-To disable the `gcePersistentDisk` storage plugin from being loaded by the controller manager
-and the kubelet, set the `InTreePluginGCEUnregister` flag to `true`.
--->
-#### GCE CSI 迁移完成
-
-{{< feature-state for_k8s_version="v1.21" state="alpha" >}}
-
-要禁止控制器管理器和 kubelet 加载 `gcePersistentDisk` 存储插件，请将
-`InTreePluginGCEUnregister` 标志设置为 `true`。
-
 <!--
 ### gitRepo (deprecated) {#gitrepo}
 -->
-
 ### gitRepo (已弃用)    {#gitrepo}
 
 {{< warning >}}
@@ -1160,12 +1011,11 @@ for an example of mounting NFS volumes with PersistentVolumes.
 <!--
 A `persistentVolumeClaim` volume is used to mount a
 [PersistentVolume](/docs/concepts/storage/persistent-volumes/) into a Pod. PersistentVolumeClaims
-are a way for users to "claim" durable storage (such as a GCE PersistentDisk or an
-iSCSI volume) without knowing the details of the particular cloud environment.
+are a way for users to "claim" durable storage (such as an iSCSI volume)
+without knowing the details of the particular cloud environment.
 -->
 `persistentVolumeClaim` 卷用来将[持久卷](/zh-cn/docs/concepts/storage/persistent-volumes/)（PersistentVolume）挂载到 Pod 中。
-持久卷申领（PersistentVolumeClaim）是用户在不知道特定云环境细节的情况下“申领”持久存储（例如
-GCE PersistentDisk 或者 iSCSI 卷）的一种方法。
+持久卷申领（PersistentVolumeClaim）是用户在不知道特定云环境细节的情况下“申领”持久存储（例如 iSCSI 卷）的一种方法。
 
 <!--
 See the information about [PersistentVolumes](/docs/concepts/storage/persistent-volumes/) for more
@@ -1277,7 +1127,8 @@ directory. For more details, see [projected volumes](/docs/concepts/storage/proj
 The Kubernetes project suggests that you use the [Ceph CSI](https://github.com/ceph/ceph-csi)
 third party storage driver instead, in RBD mode.
 -->
-Kubernetes 项目建议你转为以 RBD 模式使用 [Ceph CSI](https://github.com/ceph/ceph-csi) 第三方存储驱动。
+Kubernetes 项目建议你转为以 RBD 模式使用 [Ceph CSI](https://github.com/ceph/ceph-csi)
+第三方存储驱动插件。
 {{< /note >}}
 
 <!--