Skip to content

Commit ec1978a

Browse files
author
zhenghao.zhu
committed
[zh] resync page persistent-volume-v1
1 parent 29ac509 commit ec1978a

File tree

2 files changed

+93
-17
lines changed

2 files changed

+93
-17
lines changed

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

Lines changed: 70 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -650,7 +650,7 @@ PersistentVolumeSpec 是持久卷的规约。
650650
<!--
651651
- **csi.controllerExpandSecretRef** (SecretReference)
652652
653-
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.
653+
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.
654654
655655
<a name="SecretReference"></a>
656656
*SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*
@@ -668,7 +668,6 @@ PersistentVolumeSpec 是持久卷的规约。
668668

669669
controllerExpandSecretRef 是对包含敏感信息的 Secret 对象的引用,
670670
该 Secret 会被传递到 CSI 驱动以完成 CSI ControllerExpandVolume 调用。
671-
这是一个 Beta 字段,需要启用 ExpandCSIVolumes 特性门控。
672671
此字段是可选的,且如果不需要 Secret,则此字段可以为空。
673672
如果 Secret 对象包含多个 Secret,则所有 Secret 被传递。
674673

@@ -723,7 +722,7 @@ PersistentVolumeSpec 是持久卷的规约。
723722
724723
- **csi.nodeExpandSecretRef** (SecretReference)
725724
726-
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.
725+
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.
727726
728727
<a name="SecretReference"></a>
729728
*SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*
@@ -745,7 +744,7 @@ PersistentVolumeSpec 是持久卷的规约。
745744

746745
nodeExpandSecretRef 是对包含敏感信息的 Secret 对象的引用,
747746
从而传递到 CSI 驱动以完成 CSI NodeExpandVolume 和 NodeUnpublishVolume 调用。
748-
这是一个 Beta 字段,需要启用 CSINodeExpandSecret 特性门控
747+
这是一个 Beta 字段,通过 CSINodeExpandSecret 特性门控默认启用
749748
此字段是可选的,且如果不需要 Secret,则此字段可以为空。
750749
如果 Secret 对象包含多个 Secret,则所有 Secret 被传递。
751750

@@ -1034,6 +1033,7 @@ PersistentVolumeSpec 是持久卷的规约。
10341033
https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk
10351034

10361035
<a name="GCEPersistentDiskVolumeSource"></a>
1036+
10371037
**表示 Google 计算引擎中的 Persistent Disk 资源。挂载到一个容器之前 GCE PD 必须存在。
10381038
该磁盘还必须与 kubelet 位于相同的 GCE 项目和区域中。GCE PD 只能挂载为读/写一次或只读多次。
10391039
GCE PD 支持所有权管理和 SELinux 重新打标签。**
@@ -1050,7 +1050,7 @@ PersistentVolumeSpec 是持久卷的规约。
10501050
10511051
- **gcePersistentDisk.readOnly** (boolean)
10521052
readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
1053-
-->
1053+
-->
10541054

10551055
- **gcePersistentDisk.pdName** (string),必需
10561056

@@ -1074,6 +1074,63 @@ PersistentVolumeSpec 是持久卷的规约。
10741074
此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。默认为 false。更多信息:
10751075
https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk
10761076

1077+
<!--
1078+
- **glusterfs** (GlusterfsPersistentVolumeSource)
1079+
1080+
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
1081+
-->
1082+
1083+
- **glusterfs** (GlusterfsPersistentVolumeSource)
1084+
1085+
glusterfs 表示关联到主机并暴露给 Pod 的 Glusterfs 卷。由管理员配置。
1086+
更多信息:https://examples.k8s.io/volumes/glusterfs/README.md
1087+
1088+
<a name="GlusterfsPersistentVolumeSource"></a>
1089+
<!--
1090+
*Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.*
1091+
-->
1092+
**表示在 Pod 生命周期内一直存在的 Glusterfs 挂载卷。Glusterfs 卷不支持属主管理或 SELinux 重标记。**
1093+
1094+
<!--
1095+
- **glusterfs.endpoints** (string), required
1096+
1097+
endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1098+
1099+
- **glusterfs.path** (string), required
1100+
1101+
path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1102+
1103+
- **glusterfs.endpointsNamespace** (string)
1104+
1105+
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
1106+
1107+
- **glusterfs.readOnly** (boolean)
1108+
1109+
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
1110+
-->
1111+
1112+
- **glusterfs.endpoints** (string),必需
1113+
1114+
endpoints 是详细给出 Glusterfs 拓扑结构的端点的名称。
1115+
更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1116+
1117+
- **glusterfs.path** (string),必需
1118+
1119+
path 是 Glusterfs 卷的路径。
1120+
更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1121+
1122+
- **glusterfs.endpointsNamespace** (string)
1123+
1124+
endpointsNamespace 是 Glusterfs 端点所在的命名空间。
1125+
如果 endpointNamespace 为空,则默认值与所绑定的 PVC 的命名空间相同。
1126+
更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1127+
1128+
- **glusterfs.readOnly** (boolean)
1129+
1130+
此处的 readOnly 将强制以只读权限挂载 Glusterfs 卷。
1131+
默认为 false。
1132+
更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
1133+
10771134
<!--
10781135
- **iscsi** (ISCSIPersistentVolumeSource)
10791136
@@ -1886,6 +1943,10 @@ GET /api/v1/persistentvolumes
18861943

18871944
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
18881945

1946+
- **sendInitialEvents** (**查询参数**): boolean
1947+
1948+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1949+
18891950
- **timeoutSeconds** (**查询参数**): integer
18901951

18911952
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -2279,6 +2340,10 @@ DELETE /api/v1/persistentvolumes
22792340

22802341
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
22812342

2343+
- **sendInitialEvents** (**查询参数**): boolean
2344+
2345+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
2346+
22822347
- **timeoutSeconds** (**查询参数**): integer
22832348

22842349
<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

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -44,10 +44,10 @@ StorageClass 是不受名字空间作用域限制的;按照 etcd 设定的存
4444
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
4545
4646
- **provisioner** (string), required
47-
Provisioner indicates the type of the provisioner.
47+
provisioner indicates the type of the provisioner.
4848
4949
- **allowVolumeExpansion** (boolean)
50-
AllowVolumeExpansion shows whether the storage class allow volume expand
50+
allowVolumeExpansion shows whether the storage class allow volume expand
5151
-->
5252
- **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
5353

@@ -65,17 +65,17 @@ StorageClass 是不受名字空间作用域限制的;按照 etcd 设定的存
6565
<!--
6666
- **allowedTopologies** ([]TopologySelectorTerm)
6767
*Atomic: will be replaced during a merge*
68-
69-
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.
7068
69+
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.
70+
7171
<a name="TopologySelectorTerm"></a>
7272
*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.*
7373
-->
7474
- **allowedTopologies** ([]TopologySelectorTerm)
7575

7676
**原子性:将在合并期间被替换**
7777

78-
限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
78+
allowedTopologies 限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
7979
空的 TopologySelectorTerm 列表意味着没有拓扑限制。
8080
只有启用 VolumeScheduling 功能特性的服务器才能使用此字段。
8181

@@ -112,14 +112,16 @@ StorageClass 是不受名字空间作用域限制的;按照 etcd 设定的存
112112

113113
<!--
114114
- **mountOptions** ([]string)
115-
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.
115+
116+
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.
116117
117118
- **parameters** (map[string]string)
118-
Parameters holds the parameters for the provisioner that should create volumes of this storage class.
119+
parameters holds the parameters for the provisioner that should create volumes of this storage class.
119120
-->
120121
- **mountOptions** ([]string)
121122

122-
此存储类动态制备的 PersistentVolume 用这些 mountOptions(例如 ["ro", "soft"])进行创建。
123+
mountOptions 控制此存储类动态制备的 PersistentVolume 的挂载配置。
124+
(例如 ["ro", "soft"])。
123125
系统对选项作检查——如果有一个选项无效,则这些 PV 的挂载将失败。
124126

125127
- **parameters** (map[string]string)
@@ -128,14 +130,15 @@ StorageClass 是不受名字空间作用域限制的;按照 etcd 设定的存
128130

129131
<!--
130132
- **reclaimPolicy** (string)
131-
Dynamically provisioned PersistentVolumes of this storage class are created with this reclaimPolicy. Defaults to Delete.
133+
134+
reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.
132135
133136
- **volumeBindingMode** (string)
134-
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.
137+
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.
135138
-->
136139
- **reclaimPolicy** (string)
137140

138-
此存储类动态制备的 PersistentVolume 用这个 reclaimPolicy 进行创建。默认为 Delete。
141+
reclaimPolicy 控制此存储类动态制备的 PersistentVolume reclaimPolicy。默认为 Delete。
139142

140143
- **volumeBindingMode** (string)
141144

@@ -160,7 +163,7 @@ StorageClassList 是存储类的集合。
160163
Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
161164
162165
- **items** ([]<a href="{{< ref "../config-and-storage-resources/storage-class-v1#StorageClass" >}}">StorageClass</a>), required
163-
Items is the list of StorageClasses
166+
items is the list of StorageClasses
164167
-->
165168
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
166169

@@ -261,6 +264,10 @@ GET /apis/storage.k8s.io/v1/storageclasses
261264

262265
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
263266

267+
- **sendInitialEvents** (**查询参数**): boolean
268+
269+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
270+
264271
- **timeoutSeconds** (**查询参数**): integer
265272

266273
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -548,6 +555,10 @@ DELETE /apis/storage.k8s.io/v1/storageclasses
548555

549556
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
550557

558+
- **sendInitialEvents** (**查询参数**): boolean
559+
560+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
561+
551562
- **timeoutSeconds** (**查询参数**): integer
552563

553564
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

0 commit comments

Comments
 (0)