[zh] resync page persistent-volume-v1

content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md

@@ -650,7 +650,7 @@ PersistentVolumeSpec 是持久卷的规约。
   <!--
   - **csi.controllerExpandSecretRef** (SecretReference)
 
-    controllerExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerExpandVolume call. This is an beta field and requires enabling ExpandCSIVolumes feature gate. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.
+    controllerExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerExpandVolume call. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.
 
     <a name="SecretReference"></a>
     *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*
@@ -668,7 +668,6 @@ PersistentVolumeSpec 是持久卷的规约。
 
     controllerExpandSecretRef 是对包含敏感信息的 Secret 对象的引用，
     该 Secret 会被传递到 CSI 驱动以完成 CSI ControllerExpandVolume 调用。
-    这是一个 Beta 字段，需要启用 ExpandCSIVolumes 特性门控。
     此字段是可选的，且如果不需要 Secret，则此字段可以为空。
     如果 Secret 对象包含多个 Secret，则所有 Secret 被传递。
 
@@ -723,7 +722,7 @@ PersistentVolumeSpec 是持久卷的规约。
 
   - **csi.nodeExpandSecretRef** (SecretReference)
 
-    nodeExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeExpandVolume call. This is an beta field and requires enabling CSINodeExpandSecret feature gate. This field is optional, may be omitted if no secret is required. If the secret object contains more than one secret, all secrets are passed.
+    nodeExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeExpandVolume call. This is a beta field which is enabled default by CSINodeExpandSecret feature gate. This field is optional, may be omitted if no secret is required. If the secret object contains more than one secret, all secrets are passed.
 
     <a name="SecretReference"></a>
     *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*
@@ -745,7 +744,7 @@ PersistentVolumeSpec 是持久卷的规约。
 
     nodeExpandSecretRef 是对包含敏感信息的 Secret 对象的引用，
     从而传递到 CSI 驱动以完成 CSI NodeExpandVolume 和 NodeUnpublishVolume 调用。
-    这是一个 Beta 字段，需要启用 CSINodeExpandSecret 特性门控。
+    这是一个 Beta 字段，通过 CSINodeExpandSecret 特性门控默认启用。
     此字段是可选的，且如果不需要 Secret，则此字段可以为空。
     如果 Secret 对象包含多个 Secret，则所有 Secret 被传递。
 
@@ -1034,6 +1033,7 @@ PersistentVolumeSpec 是持久卷的规约。
   https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk
 
   <a name="GCEPersistentDiskVolumeSource"></a>
+
   **表示 Google 计算引擎中的 Persistent Disk 资源。挂载到一个容器之前 GCE PD 必须存在。
   该磁盘还必须与 kubelet 位于相同的 GCE 项目和区域中。GCE PD 只能挂载为读/写一次或只读多次。
   GCE PD 支持所有权管理和 SELinux 重新打标签。**
@@ -1050,7 +1050,7 @@ PersistentVolumeSpec 是持久卷的规约。
 
   - **gcePersistentDisk.readOnly** (boolean)
     readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
--->
+  -->
 
   - **gcePersistentDisk.pdName** (string)，必需
 
@@ -1074,6 +1074,63 @@ PersistentVolumeSpec 是持久卷的规约。
     此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。默认为 false。更多信息：
     https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk
 
+<!--
+- **glusterfs** (GlusterfsPersistentVolumeSource)
+
+  glusterfs represents a Glusterfs volume that is attached to a host and exposed to the pod. Provisioned by an admin. More info: https://examples.k8s.io/volumes/glusterfs/README.md
+-->
+
+- **glusterfs** （GlusterfsPersistentVolumeSource）
+
+  glusterfs 表示关联到主机并暴露给 Pod 的 Glusterfs 卷。由管理员配置。
+  更多信息：https://examples.k8s.io/volumes/glusterfs/README.md
+
+  <a name="GlusterfsPersistentVolumeSource"></a>
+  <!--
+  *Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.*
+  -->
+  **表示在 Pod 生命周期内一直存在的 Glusterfs 挂载卷。Glusterfs 卷不支持属主管理或 SELinux 重标记。**
+
+  <!--
+  - **glusterfs.endpoints** (string), required
+
+    endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.path** (string), required
+
+    path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.endpointsNamespace** (string)
+
+    endpointsNamespace is the namespace that contains Glusterfs endpoint. If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.readOnly** (boolean)
+
+    readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+  -->
+
+  - **glusterfs.endpoints** (string)，必需
+
+    endpoints 是详细给出 Glusterfs 拓扑结构的端点的名称。
+    更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.path** (string)，必需
+
+    path 是 Glusterfs 卷的路径。
+    更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.endpointsNamespace** (string)
+
+    endpointsNamespace 是 Glusterfs 端点所在的命名空间。
+    如果 endpointNamespace 为空，则默认值与所绑定的 PVC 的命名空间相同。
+    更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
+  - **glusterfs.readOnly** (boolean)
+
+    此处的 readOnly 将强制以只读权限挂载 Glusterfs 卷。
+    默认为 false。
+    更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
+
 <!--
 - **iscsi** (ISCSIPersistentVolumeSource)
 
@@ -1886,6 +1943,10 @@ GET /api/v1/persistentvolumes
 
   <a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
 
+- **sendInitialEvents** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -2279,6 +2340,10 @@ DELETE /api/v1/persistentvolumes
 
   <a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
 
+- **sendInitialEvents** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md

@@ -44,10 +44,10 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
   Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **provisioner** (string), required
-  Provisioner indicates the type of the provisioner.
+  provisioner indicates the type of the provisioner.
 
 - **allowVolumeExpansion** (boolean)
-  AllowVolumeExpansion shows whether the storage class allow volume expand
+  allowVolumeExpansion shows whether the storage class allow volume expand
 -->
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
@@ -65,17 +65,17 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 <!--
 - **allowedTopologies** ([]TopologySelectorTerm)
   *Atomic: will be replaced during a merge*
-
-  Restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
   
+  allowedTopologies restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.
+
   <a name="TopologySelectorTerm"></a>
   *A topology selector term represents the result of label queries. A null or empty topology selector term matches no objects. The requirements of them are ANDed. It provides a subset of functionality as NodeSelectorTerm. This is an alpha feature and may change in the future.*
 -->
 - **allowedTopologies** ([]TopologySelectorTerm)
 
   **原子性：将在合并期间被替换**
 
-  限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
+  allowedTopologies 限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
   空的 TopologySelectorTerm 列表意味着没有拓扑限制。
   只有启用 VolumeScheduling 功能特性的服务器才能使用此字段。
 
@@ -112,14 +112,16 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 
 <!--
 - **mountOptions** ([]string)
-  Dynamically provisioned PersistentVolumes of this storage class are created with these mountOptions, e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
+
+  mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class. e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
 
 - **parameters** (map[string]string)
-  Parameters holds the parameters for the provisioner that should create volumes of this storage class.
+  parameters holds the parameters for the provisioner that should create volumes of this storage class.
 -->
 - **mountOptions** ([]string)
 
-  此存储类动态制备的 PersistentVolume 用这些 mountOptions（例如 ["ro", "soft"]）进行创建。
+  mountOptions 控制此存储类动态制备的 PersistentVolume 的挂载配置。
+  （例如 ["ro", "soft"]）。
   系统对选项作检查——如果有一个选项无效，则这些 PV 的挂载将失败。
 
 - **parameters** (map[string]string)
@@ -128,14 +130,15 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 
 <!--
 - **reclaimPolicy** (string)
-  Dynamically provisioned PersistentVolumes of this storage class are created with this reclaimPolicy. Defaults to Delete.
+
+  reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.
 
 - **volumeBindingMode** (string)
-  VolumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+  volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
 -->
 - **reclaimPolicy** (string)
 
-  此存储类动态制备的 PersistentVolume 用这个 reclaimPolicy 进行创建。默认为 Delete。
+  reclaimPolicy 控制此存储类动态制备的 PersistentVolume 的 reclaimPolicy。默认为 Delete。
 
 - **volumeBindingMode** (string)
 
@@ -160,7 +163,7 @@ StorageClassList 是存储类的集合。
   Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **items** ([]<a href="{{< ref "../config-and-storage-resources/storage-class-v1#StorageClass" >}}">StorageClass</a>), required
-  Items is the list of StorageClasses
+  items is the list of StorageClasses
 -->
 - **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
 
@@ -261,6 +264,10 @@ GET /apis/storage.k8s.io/v1/storageclasses
 
   <a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
 
+- **sendInitialEvents** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -548,6 +555,10 @@ DELETE /apis/storage.k8s.io/v1/storageclasses
 
   <a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
 
+- **sendInitialEvents** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>