Merge pull request #50507 from windsonsea/csidri

[zh] Sync csi-driver-v1, csi-node-v1, csi-storage-capacity-v1, secret-v1

Author: k8s-ci-robot

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

@@ -125,6 +125,7 @@ CSIDriverSpec 是 CSIDriver 的规约。
   The following VolumeContext will be passed if podInfoOnMount is set to true. This list might grow, but the prefix will be used. "csi.storage.k8s.io/pod.name": pod.Name "csi.storage.k8s.io/pod.namespace": pod.Namespace "csi.storage.k8s.io/pod.uid": string(pod.UID) "csi.storage.k8s.io/ephemeral": "true" if the volume is an ephemeral inline volume
                                   defined by a CSIVolumeSource, otherwise "false"
   -->
+
   CSI 驱动将 podInfoOnMount 指定为驱动部署的一部分。
   如果为 true，Kubelet 将在 CSI NodePublishVolume() 调用中作为 VolumeContext 传递 Pod 信息。
   CSI 驱动负责解析和校验作为 VolumeContext 传递进来的信息。
@@ -143,6 +144,7 @@ CSIDriverSpec 是 CSIDriver 的规约。
   
   This field was immutable in Kubernetes \< 1.29 and now is mutable.
   -->
+
   “csi.storage.k8s.io/ephemeral” 是 Kubernetes 1.16 中一个新的功能特性。
   只有同时支持 “Persistent” 和 “Ephemeral” VolumeLifecycleMode 的驱动，此字段才是必需的。
   其他驱动可以保持禁用 Pod 信息或忽略此字段。
@@ -189,6 +191,7 @@ CSIDriverSpec 是 CSIDriver 的规约。
   
   Default is "false".
   -->
+
   当值为 “false” 时，Kubernetes 不会将任何特殊的 SELinux 挂载选项传递给驱动。
   这通常用于代表更大共享文件系统的子目录的卷。
 
@@ -243,8 +246,8 @@ CSIDriverSpec 是 CSIDriver 的规约。
   ```
   "csi.storage.k8s.io/serviceAccount.tokens": {
     "<audience>": {
-      "token": <token>,
-      "expirationTimestamp": <expiration timestamp in RFC3339>,
+      "token": <令牌>,
+      "expirationTimestamp": <格式为 RFC3339 的过期时间戳>,
     },
     ...
   }
@@ -256,6 +259,7 @@ CSIDriverSpec 是 CSIDriver 的规约。
   <a name="TokenRequest"></a>
   *TokenRequest contains parameters of a service account token.*
   -->
+
   注：每个 tokenRequest 中的受众应该不同，且最多有一个令牌是空字符串。
   要在令牌过期后接收一个新的令牌，requiresRepublish 可用于周期性地触发 NodePublishVolume。
 
@@ -270,14 +274,15 @@ CSIDriverSpec 是 CSIDriver 的规约。
   - **tokenRequests.expirationSeconds** (int64)
 
     expirationSeconds is the duration of validity of the token in "TokenRequestSpec". It has the same default value of "ExpirationSeconds" in "TokenRequestSpec".
-  -->  
+  -->
+
   - **tokenRequests.audience** (string)，必需
-    
+
     audience 是 “TokenRequestSpec” 中令牌的目标受众。
     它默认为 kube apiserver 的受众。
 
   - **tokenRequests.expirationSeconds** (int64)
-    
+
     expirationSeconds 是 “TokenRequestSpec” 中令牌的有效期。
     它具有与 “TokenRequestSpec” 中 “expirationSeconds” 相同的默认值。
 
@@ -303,6 +308,7 @@ CSIDriverSpec 是 CSIDriver 的规约。
   
   This field is beta. This field is immutable.
   -->
+
   另一种模式是 “Ephemeral”。
   在这种模式下，在 Pod 规约中用 CSIVolumeSource 以内联方式定义卷，其生命周期与该 Pod 的生命周期相关联。
   驱动必须感知到这一点，因为只有针对这种卷才会接收到 NodePublishVolume 调用。
@@ -691,6 +697,7 @@ DELETE /apis/storage.k8s.io/v1/csidrivers/{name}
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 - **dryRun** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **pretty** (*in query*): string
 - **propagationPolicy** (*in query*): string
 -->
@@ -710,6 +717,10 @@ DELETE /apis/storage.k8s.io/v1/csidrivers/{name}
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@@ -761,6 +772,10 @@ DELETE /apis/storage.k8s.io/v1/csidrivers
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (*in query*): string
 
   <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
@@ -813,6 +828,10 @@ DELETE /apis/storage.k8s.io/v1/csidrivers
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>

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

@@ -24,6 +24,7 @@ weight: 4
 `import "k8s.io/api/storage/v1"`
 
 ## CSINode {#CSINode}
+
 <!--
 CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.
 -->
@@ -56,6 +57,7 @@ CSINode 包含指向相应节点对象的 OwnerReference。
   spec 是 CSINode 的规约。
 
 ## CSINodeSpec {#CSINodeSpec}
+
 <!--
 CSINodeSpec holds information about the specification of all CSI drivers installed on a node
 -->
@@ -119,11 +121,11 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息
 
   - **drivers.allocatable** (VolumeNodeResources)
 
-    allocatable 表示一个节点上可供调度的卷资源。此字段处于 beta 阶段。
+    allocatable 表示一个节点上可供调度的卷资源。此字段处于 Beta 阶段。
 
     <a name="VolumeNodeResources"></a>
-
     **VolumeNodeResources 是调度卷时所用的一组资源限制。**
+
     <!--
     - **drivers.allocatable.count** (int32)
 
@@ -159,6 +161,7 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息
     如果驱动不支持拓扑，则此字段可以为空。
 
 ## CSINodeList {#CSINodeList}
+
 <!--
 CSINodeList is a collection of CSINode objects.
 -->
@@ -209,9 +212,10 @@ GET /apis/storage.k8s.io/v1/csinodes/{name}
 - **pretty** (*in query*): string
 -->
 #### 参数
+
 - **name** (**路径参数**): string，必需
 
-  CSINode 的名称
+  CSINode 的名称。
 
 - **pretty** (**查询参数**): string
 
@@ -221,6 +225,7 @@ GET /apis/storage.k8s.io/v1/csinodes/{name}
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>): OK
 
 401: Unauthorized
@@ -229,7 +234,8 @@ GET /apis/storage.k8s.io/v1/csinodes/{name}
 ### `list` list or watch objects of kind CSINode
 #### HTTP Request
 -->
-### `list` 列出或观测类别为 CSINode 的对象
+### `list` 列举或观测类别为 CSINode 的对象
+
 #### HTTP 请求
 
 GET /apis/storage.k8s.io/v1/csinodes
@@ -248,6 +254,7 @@ GET /apis/storage.k8s.io/v1/csinodes
 - **watch** (*in query*): boolean
 -->
 #### 参数
+
 - **allowWatchBookmarks** (**查询参数**): boolean
 
   <a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks</a>
@@ -296,6 +303,7 @@ GET /apis/storage.k8s.io/v1/csinodes
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINodeList" >}}">CSINodeList</a>): OK
 
 401: Unauthorized
@@ -305,6 +313,7 @@ GET /apis/storage.k8s.io/v1/csinodes
 #### HTTP Request
 -->
 ### `create` 创建 CSINode
+
 #### HTTP 请求
 
 POST /apis/storage.k8s.io/v1/csinodes
@@ -341,6 +350,7 @@ POST /apis/storage.k8s.io/v1/csinodes
 #### Response
 -->
 #### 响应
+
 200 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>): OK
 
 201 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>): Created
@@ -373,7 +383,7 @@ PUT /apis/storage.k8s.io/v1/csinodes/{name}
 
 - **name** (**路径参数**): string，必需
 
-  CSINode 的名称
+  CSINode 的名称。
 
 - **body**: <a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>，必需
 
@@ -429,7 +439,7 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name}
 
 - **name** (**路径参数**): string，必需
 
-  CSINode 的名称
+  CSINode 的名称。
 
 - **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>，必需
 
@@ -481,13 +491,15 @@ DELETE /apis/storage.k8s.io/v1/csinodes/{name}
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 - **dryRun** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **pretty** (*in query*): string
 - **propagationPolicy** (*in query*): string
 -->
 #### 参数
+
 - **name** (**路径参数**): string，必需
 
-  CSINode 的名称
+  CSINode 的名称。
 
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 
@@ -499,6 +511,10 @@ DELETE /apis/storage.k8s.io/v1/csinodes/{name}
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@@ -535,6 +551,7 @@ DELETE /apis/storage.k8s.io/v1/csinodes
 - **dryRun** (*in query*): string
 - **fieldSelector** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **labelSelector** (*in query*): string
 - **limit** (*in query*): integer
 - **pretty** (*in query*): string
@@ -563,6 +580,10 @@ DELETE /apis/storage.k8s.io/v1/csinodes
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>

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

@@ -98,7 +98,6 @@ They are consumed by the kube-scheduler when a CSI driver opts into capacity-awa
 
   The semantic is currently (CSI spec 1.2) defined as: The available capacity, in bytes, of the storage that can be used to provision volumes. If not set, that information is currently unavailable.
 -->
-
 - **storageClassName** (string)，必需
 
   storageClassName 是已报告容量所对应的 StorageClass 的名称。
@@ -163,8 +162,7 @@ CSIStorageCapacityList 是 CSIStorageCapacity 对象的集合。
 -->
 - **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
 
-  标准的列表元数据。
-  更多信息：
+  标准的列表元数据。更多信息：
   https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **items** ([]<a href="{{< ref "../config-and-storage-resources/csi-storage-capacity-v1#CSIStorageCapacity" >}}">CSIStorageCapacity</a>)，必需
@@ -198,7 +196,7 @@ GET /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}
 
 - **name** (**路径参数**): string，必需
 
-  CSIStorageCapacity 的名称
+  CSIStorageCapacity 的名称。
 
 - **namespace** (**路径参数**): string，必需
 
@@ -459,7 +457,7 @@ PUT /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}
 
 - **name** (**路径参数**): string，必需
 
-  CSIStorageCapacity 的名称
+  CSIStorageCapacity 的名称。
 
 - **namespace** (**路径参数**): string，必需
 
@@ -520,7 +518,7 @@ PATCH /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}
 
 - **name** (**路径参数**): string，必需
 
-  CSIStorageCapacity 的名称
+  CSIStorageCapacity 的名称。
 
 - **namespace** (**路径参数**): string，必需
 
@@ -577,14 +575,15 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 - **dryRun** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **pretty** (*in query*): string
 - **propagationPolicy** (*in query*): string
 -->
 #### 参数
 
 - **name** (**路径参数**): string，必需
 
-  CSIStorageCapacity 的名称
+  CSIStorageCapacity 的名称。
 
 - **namespace** (**路径参数**): string，必需
 
@@ -600,6 +599,10 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@@ -637,6 +640,7 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities
 - **dryRun** (*in query*): string
 - **fieldSelector** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **labelSelector** (*in query*): string
 - **limit** (*in query*): integer
 - **pretty** (*in query*): string
@@ -669,6 +673,10 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities
 
   <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>
 
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string
 
   <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>