Merge pull request #42382 from windsonsea/storcl

[zh] sync volumes.md

Author: k8s-ci-robot

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

@@ -117,184 +117,69 @@ Kubernetes supports several types of volumes.
 Kubernetes 支持下列类型的卷：
 
 <!--
-### awsElasticBlockStore (deprecated) {#awselasticblockstore}
-
-An `awsElasticBlockStore` volume mounts an Amazon Web Services (AWS)
-[EBS volume](https://aws.amazon.com/ebs/) into your pod. Unlike
-`emptyDir`, which is erased when a pod is removed, the contents of an EBS
-volume are persisted and the volume is unmounted. This means that an
-EBS volume can be pre-populated with data, and that data can be shared between pods.
--->
-### awsElasticBlockStore （已弃用）   {#awselasticblockstore}
-
-{{< feature-state for_k8s_version="v1.17" state="deprecated" >}}
-
-`awsElasticBlockStore` 卷将 Amazon Web 服务（AWS）[EBS 卷](https://aws.amazon.com/ebs/)挂载到你的
-Pod 中。`emptyDir` 在 Pod 被删除时也会一起被删除，但 EBS 卷的内容在删除
-Pod 时会被保留，卷只是被卸载掉了。
-这意味着 EBS 卷可以预先填充数据，并且该数据可以在 Pod 之间共享。
-
-{{< note >}}
-<!--
-You must create an EBS volume by using `aws ec2 create-volume` or the AWS API before you can use it.
+### awsElasticBlockStore (removed) {#awselasticblockstore}
 -->
-你在使用 EBS 卷之前必须使用 `aws ec2 create-volume` 命令或者 AWS API 创建该卷。
-{{< /note >}}
-
-<!--
-There are some restrictions when using an `awsElasticBlockStore` volume:
-
-* the nodes on which pods are running must be AWS EC2 instances
-* those instances need to be in the same region and availability zone as the EBS volume
-* EBS only supports a single
--->
-使用 `awsElasticBlockStore` 卷时有一些限制：
-
-* Pod 运行所在的节点必须是 AWS EC2 实例。
-* 这些实例需要与 EBS 卷在相同的地域（Region）和可用区（Availability-Zone）。
-* EBS 卷只支持被挂载到单个 EC2 实例上。
-
-<!--
-#### Creating an AWS EBS volume
+### awsElasticBlockStore （已移除）   {#awselasticblockstore}
 
-Before you can use an EBS volume with a pod, you need to create it.
--->
-#### 创建 AWS EBS 卷
-
-在将 EBS 卷用到 Pod 上之前，你首先要创建它。
-
-```shell
-aws ec2 create-volume --availability-zone=eu-west-1a --size=10 --volume-type=gp2
-```
-
-<!--
-Make sure the zone matches the zone you brought up your cluster in. Check that the size and EBS volume
-type are suitable for your use.
--->
-确保该区域与你的集群所在的区域相匹配。还要检查卷的大小和 EBS 卷类型都适合你的用途。
+<!-- maintenance note: OK to remove all mention of awsElasticBlockStore once the v1.27 release of
+Kubernetes has gone out of support -->
 
 <!--
-#### AWS EBS configuration example
--->
-#### AWS EBS 配置示例
+Kubernetes {{< skew currentVersion >}} does not include a `awsElasticBlockStore` volume type.
 
-```yaml
-apiVersion: v1
-kind: Pod
-metadata:
-  name: test-ebs
-spec:
-  containers:
-  - image: registry.k8s.io/test-webserver
-    name: test-container
-    volumeMounts:
-    - mountPath: /test-ebs
-      name: test-volume
-  volumes:
-  - name: test-volume
-    # 此 AWS EBS 卷必须已经存在
-    awsElasticBlockStore:
-      volumeID: "<volume id>"
-      fsType: ext4
-```
-<!--
-If the EBS volume is partitioned, you can supply the optional field `partition: "<partition number>"` to specify which partition to mount on.
--->
-如果 EBS 卷是分区的，你可以提供可选的字段 `partition: "<partition number>"` 来指定要挂载到哪个分区上。
+The AWSElasticBlockStore in-tree storage driver was deprecated in the Kubernetes v1.19 release
+and then removed entirely in the v1.27 release.
 
-<!--
-#### AWS EBS CSI migration
+The Kubernetes project suggests that you use the [AWS EBS](https://github.com/kubernetes-sigs/aws-ebs-csi-driver) third party
+storage driver instead.
 -->
-#### AWS EBS CSI 卷迁移
+Kubernetes {{< skew currentVersion >}} 不包含 `awsElasticBlockStore` 卷类型。
 
-{{< feature-state for_k8s_version="v1.25" state="stable" >}}
+AWSElasticBlockStore 树内存储驱动已在 Kubernetes v1.19 版本中废弃，
+并在 v1.27 版本中被完全移除。
 
-<!--
-The `CSIMigration` feature for `awsElasticBlockStore`, when enabled, redirects
-all plugin operations from the existing in-tree plugin to the `ebs.csi.aws.com` Container
-Storage Interface (CSI) driver. In order to use this feature, the [AWS EBS CSI
-driver](https://github.com/kubernetes-sigs/aws-ebs-csi-driver)
-must be installed on the cluster.
--->
-启用 `awsElasticBlockStore` 的 `CSIMigration` 特性后，所有插件操作将从现有的树内插件重定向到
-`ebs.csi.aws.com` 容器存储接口（CSI）驱动程序。
-为了使用此特性，必须在集群中安装
-[AWS EBS CSI 驱动](https://github.com/kubernetes-sigs/aws-ebs-csi-driver)。
+Kubernetes 项目建议你转为使用 [AWS EBS](https://github.com/kubernetes-sigs/aws-ebs-csi-driver)
+第三方存储驱动。
 
 <!--
-#### AWS EBS CSI migration complete
+### azureDisk (removed) {#azuredisk}
 -->
-#### AWS EBS CSI 迁移结束
+### azureDisk （已移除）   {#azuredisk}
 
-{{< feature-state for_k8s_version="v1.17" state="alpha" >}}
-
-<!--
-To disable the `awsElasticBlockStore` storage plugin from being loaded by the controller manager
-and the kubelet, set the `InTreePluginAWSUnregister` flag to `true`.
--->
-要禁止控制器管理器和 kubelet 加载 `awsElasticBlockStore` 存储插件，
-请将 `InTreePluginAWSUnregister` 标志设置为 `true`。
+<!-- maintenance note: OK to remove all mention of azureDisk once the v1.27 release of
+Kubernetes has gone out of support -->
 
 <!--
-### azureDisk (deprecated) {#azuredisk}
+Kubernetes {{< skew currentVersion >}} does not include a `azureDisk` volume type.
 
-The `azureDisk` volume type mounts a Microsoft Azure [Data Disk](https://docs.microsoft.com/en-us/azure/aks/csi-storage-drivers) into a pod.
+The AzureDisk in-tree storage driver was deprecated in the Kubernetes v1.19 release
+and then removed entirely in the v1.27 release.
 
-For more details, see the [`azureDisk` volume plugin](https://github.com/kubernetes/examples/tree/master/staging/volumes/azure_disk/README.md).
+The Kubernetes project suggests that you use the [Azure Disk](https://github.com/kubernetes-sigs/azuredisk-csi-driver) third party
+storage driver instead.
 -->
-### azureDisk （已弃用）   {#azuredisk}
+Kubernetes {{< skew currentVersion >}} 不包含 `azureDisk` 卷类型。
 
-{{< feature-state for_k8s_version="v1.19" state="deprecated" >}}
-
-`azureDisk` 卷类型用来在 Pod 上挂载 Microsoft Azure
-[数据盘（Data Disk）](https://azure.microsoft.com/en-us/documentation/articles/virtual-machines-linux-about-disks-vhds/) 。
-若需了解更多详情，请参考 [`azureDisk` 卷插件](https://github.com/kubernetes/examples/tree/master/staging/volumes/azure_disk/README.md)。
-
-<!--
-#### azureDisk CSI migration
--->
-#### azureDisk 的 CSI 迁移  {#azuredisk-csi-migration}
+AzureDisk 树内存储驱动已在 Kubernetes v1.19 版本中废弃，并在 v1.27 版本中被完全移除。
 
-{{< feature-state for_k8s_version="v1.24" state="stable" >}}
+Kubernetes 项目建议你转为使用 [Azure Disk](https://github.com/kubernetes-sigs/azuredisk-csi-driver)
+第三方存储驱动。
 
 <!--
-The `CSIMigration` feature for `azureDisk`, when enabled, redirects all plugin operations
-from the existing in-tree plugin to the `disk.csi.azure.com` Container
-Storage Interface (CSI) Driver. In order to use this feature, the
-[Azure Disk CSI Driver](https://github.com/kubernetes-sigs/azuredisk-csi-driver)
-must be installed on the cluster.
--->
-启用 `azureDisk` 的 `CSIMigration` 特性后，所有插件操作从现有的树内插件重定向到
-`disk.csi.azure.com` 容器存储接口（CSI）驱动程序。
-为了使用此特性，必须在集群中安装
-[Azure 磁盘 CSI 驱动程序](https://github.com/kubernetes-sigs/azuredisk-csi-driver)。
-
-<!--
-#### azureDisk CSI migration complete
-
-To disable the `azureDisk` storage plugin from being loaded by the controller manager
-and the kubelet, set the `InTreePluginAzureDiskUnregister` flag to `true`.
+### azureFile (deprecated) {#azurefile}
 -->
-#### azureDisk CSI 迁移完成
-
-{{< feature-state for_k8s_version="v1.21" state="alpha" >}}
+### azureFile （已弃用）    {#azurefile}
 
-要禁止控制器管理器和 kubelet 加载 `azureDisk` 存储插件，
-请将 `InTreePluginAzureDiskUnregister` 标志设置为 `true`。
+{{< feature-state for_k8s_version="v1.21" state="deprecated" >}}
 
 <!--
-### azureFile (deprecated) {#azurefile}
-
 The `azureFile` volume type mounts a Microsoft Azure File volume (SMB 2.1 and 3.0)
 into a pod.
 
 For more details, see the [`azureFile` volume plugin](https://github.com/kubernetes/examples/tree/master/staging/volumes/azure_file/README.md).
 -->
-### azureFile （已弃用）    {#azurefile}
-
-{{< feature-state for_k8s_version="v1.21" state="deprecated" >}}
-
 `azureFile` 卷类型用来在 Pod 上挂载 Microsoft Azure 文件卷（File Volume）（SMB 2.1 和 3.0）。
+
 更多详情请参考 [`azureFile` 卷插件](https://github.com/kubernetes/examples/tree/master/staging/volumes/azure_file/README.md)。
 
 <!--
@@ -328,19 +213,30 @@ Azure 文件 CSI 驱动尚不支持为同一卷设置不同的 fsgroup。
 
 <!--
 #### azureFile CSI migration complete
-
-To disable the `azureFile` storage plugin from being loaded by the controller manager
-and the kubelet, set the `InTreePluginAzureFileUnregister` flag to `true`.
 -->
 #### azureFile CSI 迁移完成
 
 {{< feature-state for_k8s_version="v1.21" state="alpha" >}}
 
+<!--
+To disable the `azureFile` storage plugin from being loaded by the controller manager
+and the kubelet, set the `InTreePluginAzureFileUnregister` flag to `true`.
+-->
 要禁止控制器管理器和 kubelet 加载 `azureFile` 存储插件，
 请将 `InTreePluginAzureFileUnregister` 标志设置为 `true`。
 
 ### cephfs {#cephfs}
 
+{{< feature-state for_k8s_version="v1.28" state="deprecated" >}}
+
+{{< note >}}
+<!--
+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) 第三方存储驱动。
+{{< /note >}}
+
 <!--
 A `cephfs` volume allows an existing CephFS volume to be
 mounted into your Pod. Unlike `emptyDir`, which is erased when a pod is
@@ -368,79 +264,31 @@ See the [CephFS example](https://github.com/kubernetes/examples/tree/master/volu
 更多信息请参考 [CephFS 示例](https://github.com/kubernetes/examples/tree/master/volumes/cephfs/)。
 
 <!--
-### cinder (deprecated) {#cinder}
+### cinder (removed) {#cinder}
 -->
-### cinder （已弃用）   {#cinder}
-
-{{< feature-state for_k8s_version="v1.18" state="deprecated" >}}
+### cinder（已移除）   {#cinder}
 
-{{< note >}}
-<!--
-Kubernetes must be configured with the OpenStack cloud provider.
--->
-Kubernetes 必须配置了 OpenStack Cloud Provider。
-{{< /note >}}
-
-<!--
-The `cinder` volume type is used to mount the OpenStack Cinder volume into your pod.
--->
-`cinder` 卷类型用于将 OpenStack Cinder 卷挂载到 Pod 中。
+<!-- maintenance note: OK to remove all mention of cinder once the v1.26 release of
+Kubernetes has gone out of support -->
 
 <!--
-#### Cinder volume configuration example
--->
-#### Cinder 卷示例配置  {#cinder-volume-example-configuration}
+Kubernetes {{< skew currentVersion >}} does not include a `cinder` volume type.
 
-```yaml
-apiVersion: v1
-kind: Pod
-metadata:
-  name: test-cinder
-spec:
-  containers:
-  - image: registry.k8s.io/test-webserver
-    name: test-cinder-container
-    volumeMounts:
-    - mountPath: /test-cinder
-      name: test-volume
-  volumes:
-  - name: test-volume
-    # 此 OpenStack 卷必须已经存在
-    cinder:
-      volumeID: "<volume id>"
-      fsType: ext4
-```
+The OpenStack Cinder in-tree storage driver was deprecated in the Kubernetes v1.11 release
+and then removed entirely in the v1.26 release.
 
-<!--
-#### OpenStack CSI migration
+The Kubernetes project suggests that you use the 
+[OpenStack Cinder](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md)
+third party storage driver instead.
 -->
-#### OpenStack CSI 迁移
+Kubernetes {{< skew currentVersion >}} 不包含 `cinder` 卷类型。
 
-{{< feature-state for_k8s_version="v1.24" state="stable" >}}
+OpenStack Cinder 树内存储驱动已在 Kubernetes v1.11 版本中废弃，
+并在 v1.26 版本中被完全移除。
 
-<!--
-The `CSIMigration` feature for Cinder is enabled by default since Kubernetes 1.21.
-It redirects all plugin operations from the existing in-tree plugin to the
-`cinder.csi.openstack.org` Container Storage Interface (CSI) Driver.
-[OpenStack Cinder CSI Driver](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md)
-must be installed on the cluster.
--->
-自 Kubernetes 1.21 版本起，Cinder 的 `CSIMigration` 特性是默认被启用的。
-此特性会将插件的所有操作从现有的树内插件重定向到
-`cinder.csi.openstack.org` 容器存储接口（CSI）驱动程序。
-为了使用此特性，必须在集群中安装
-[OpenStack Cinder CSI 驱动程序](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md)，
-你可以通过设置 `CSIMigrationOpenStack`
-[特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)
-为 `false` 来禁止 Cinder CSI 迁移。
-
-<!--
-To disable the in-tree Cinder plugin from being loaded by the controller manager
-and the kubelet, you can enable the `InTreePluginOpenStackUnregister`
-[feature gate](/docs/reference/command-line-tools-reference/feature-gates/).
--->
-要禁止控制器管理器和 kubelet 加载树内 Cinder 插件，你可以启用
-`InTreePluginOpenStackUnregister` [特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)。
+Kubernetes 项目建议你转为使用
+[OpenStack Cinder](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md)
+第三方存储驱动。
 
 ### configMap
 
@@ -1411,6 +1259,16 @@ directory. For more details, see [projected volumes](/docs/concepts/storage/proj
 
 ### rbd
 
+{{< feature-state for_k8s_version="v1.28" state="deprecated" >}}
+
+{{< note >}}
+<!--
+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) 第三方存储驱动。
+{{< /note >}}
+
 <!--
 An `rbd` volume allows a
 [Rados Block Device](https://docs.ceph.com/en/latest/rbd/) (RBD) volume to mount
@@ -1452,7 +1310,7 @@ RBD 的一个特性是它可以同时被多个用户以只读方式挂载。
 -->
 #### RBD CSI 迁移 {#rbd-csi-migration}
 
-{{< feature-state for_k8s_version="v1.23" state="alpha" >}}
+{{< feature-state for_k8s_version="v1.28" state="deprecated" >}}
 
 <!--
 The `CSIMigration` feature for `RBD`, when enabled, redirects all plugin
@@ -1541,9 +1399,11 @@ For more details, see [Configuring Secrets](/docs/concepts/configuration/secret/
 
 {{< note >}}
 <!--
-We recommend to use vSphere CSI out-of-tree driver instead.
+The Kubernetes project recommends using the [vSphere CSI](https://github.com/kubernetes-sigs/vsphere-csi-driver)
+out-of-tree storage driver instead.
 -->
-建议你改用 vSphere CSI 树外驱动程序。
+Kubernetes 项目建议转为使用 [vSphere CSI](https://github.com/kubernetes-sigs/vsphere-csi-driver)
+树外存储驱动。
 {{< /note >}}
 
 <!--
@@ -2094,8 +1954,6 @@ The following in-tree plugins support persistent storage on Windows nodes:
 
 下面是支持 Windows 节点上持久性存储的树内插件：
 
-* [`awsElasticBlockStore`](#awselasticblockstore)
-* [`azureDisk`](#azuredisk)
 * [`azureFile`](#azurefile)
 * [`gcePersistentDisk`](#gcepersistentdisk)
 * [`vsphereVolume`](#vspherevolume)