diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-driver-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-driver-v1.md index d5e64c1d81..9e14495770 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-driver-v1.md +++ b/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": { "": { - "token": , - "expirationTimestamp": , + "token": <令牌>, + "expirationTimestamp": <格式为 RFC3339 的过期时间戳>, }, ... } @@ -256,6 +259,7 @@ CSIDriverSpec 是 CSIDriver 的规约。 *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**: }}">DeleteOptions - **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} }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **pretty** (**查询参数**): string }}">pretty @@ -761,6 +772,10 @@ DELETE /apis/storage.k8s.io/v1/csidrivers }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **labelSelector** (*in query*): string }}">labelSelector @@ -813,6 +828,10 @@ DELETE /apis/storage.k8s.io/v1/csidrivers }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **labelSelector** (**查询参数**): string }}">labelSelector diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md index a615229aa2..13a5d6c956 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md +++ b/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} + @@ -56,6 +57,7 @@ CSINode 包含指向相应节点对象的 OwnerReference。 spec 是 CSINode 的规约。 ## CSINodeSpec {#CSINodeSpec} + @@ -119,11 +121,11 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息 - **drivers.allocatable** (VolumeNodeResources) - allocatable 表示一个节点上可供调度的卷资源。此字段处于 beta 阶段。 + allocatable 表示一个节点上可供调度的卷资源。此字段处于 Beta 阶段。 - **VolumeNodeResources 是调度卷时所用的一组资源限制。** + @@ -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 (}}">CSINode): 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 }}">allowWatchBookmarks @@ -296,6 +303,7 @@ GET /apis/storage.k8s.io/v1/csinodes #### Response --> #### 响应 + 200 (}}">CSINodeList): 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 (}}">CSINode): OK 201 (}}">CSINode): Created @@ -373,7 +383,7 @@ PUT /apis/storage.k8s.io/v1/csinodes/{name} - **name** (**路径参数**): string，必需 - CSINode 的名称 + CSINode 的名称。 - **body**: }}">CSINode，必需 @@ -429,7 +439,7 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name} - **name** (**路径参数**): string，必需 - CSINode 的名称 + CSINode 的名称。 - **body**: }}">Patch，必需 @@ -481,13 +491,15 @@ DELETE /apis/storage.k8s.io/v1/csinodes/{name} - **body**: }}">DeleteOptions - **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**: }}">DeleteOptions @@ -499,6 +511,10 @@ DELETE /apis/storage.k8s.io/v1/csinodes/{name} }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **pretty** (**查询参数**): string }}">pretty @@ -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 }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **labelSelector** (**查询参数**): string }}">labelSelector diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-storage-capacity-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-storage-capacity-v1.md index 5d85977245..0aaa93485d 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-storage-capacity-v1.md +++ b/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** (}}">ListMeta) - 标准的列表元数据。 - 更多信息： + 标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **items** ([]}}">CSIStorageCapacity)，必需 @@ -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,6 +575,7 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name - **body**: }}">DeleteOptions - **dryRun** (*in query*): string - **gracePeriodSeconds** (*in query*): integer +- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean - **pretty** (*in query*): string - **propagationPolicy** (*in query*): string --> @@ -584,7 +583,7 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name - **name** (**路径参数**): string，必需 - CSIStorageCapacity 的名称 + CSIStorageCapacity 的名称。 - **namespace** (**路径参数**): string，必需 @@ -600,6 +599,10 @@ DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **pretty** (**查询参数**): string }}">pretty @@ -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 }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **labelSelector** (**查询参数**): string }}">labelSelector diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md index 5b02916de8..db47413d9a 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md @@ -38,15 +38,16 @@ data 字段值的总字节必须小于 MaxSecretSize 字节。 - **metadata** (}}">ObjectMeta) - 标准的对象元数据。 - 更多信息： + 标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **data** (map[string][]byte) @@ -58,12 +59,15 @@ data 字段值的总字节必须小于 MaxSecretSize 字节。 - **immutable** (boolean) @@ -81,8 +85,7 @@ data 字段值的总字节必须小于 MaxSecretSize 字节。 - **type** (string) - 用于满足程序化方式处理秘密数据。 - 更多信息： + 用于满足程序化方式处理秘密数据。更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/secret/#secret-types ## SecretList {#SecretList} @@ -109,14 +112,12 @@ SecretList 是 Secret 的列表。 --> - **metadata** (}}">ListMeta) - 标准的列表元数据。 - 更多信息： + 标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]}}">Secret)，必需 - items 是 Secret 对象的列表。 - 更多信息： + items 是 Secret 对象的列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/secret -### `list` 列出或观测类别为 Secret 的对象 +### `list` 列举或观测类别为 Secret 的对象 #### HTTP 请求 @@ -257,7 +258,7 @@ GET /api/v1/namespaces/{namespace}/secrets #### HTTP Request --> -### `list` 列出或观测类别为 Secret 的对象 +### `list` 列举或观测类别为 Secret 的对象 #### HTTP 请求 @@ -414,7 +415,7 @@ PUT /api/v1/namespaces/{namespace}/secrets/{name} - **name** (**路径参数**): string，必需 - Secret 的名称 + Secret 的名称。 - **namespace** (**路径参数**): string，必需 @@ -476,7 +477,7 @@ PATCH /api/v1/namespaces/{namespace}/secrets/{name} - **name** (**路径参数**): string，必需 - Secret 的名称 + Secret 的名称。 - **namespace** (**路径参数**): string，必需 @@ -534,6 +535,7 @@ DELETE /api/v1/namespaces/{namespace}/secrets/{name} - **body**: }}">DeleteOptions - **dryRun** (*in query*): string - **gracePeriodSeconds** (*in query*): integer +- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean - **pretty** (*in query*): string - **propagationPolicy** (*in query*): string --> @@ -541,7 +543,7 @@ DELETE /api/v1/namespaces/{namespace}/secrets/{name} - **name** (**路径参数**): string，必需 - Secret 的名称 + Secret 的名称。 - **namespace** (**路径参数**): string，必需 @@ -557,6 +559,10 @@ DELETE /api/v1/namespaces/{namespace}/secrets/{name} }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **pretty** (**查询参数**): string }}">pretty @@ -595,6 +601,7 @@ DELETE /api/v1/namespaces/{namespace}/secrets - **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 @@ -627,6 +634,10 @@ DELETE /api/v1/namespaces/{namespace}/secrets }}">gracePeriodSeconds +- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean + + }}">ignoreStoreReadErrorWithClusterBreakingPotential + - **labelSelector** (**查询参数**): string }}">labelSelector