diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md index 9ddbc12cc0..bd98f0cf85 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md @@ -76,6 +76,7 @@ PersistentVolumeSpec 是持久卷的规约。 accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes - **capacity** (map[string]}}">Quantity) + capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity --> - **accessModes** ([]string) @@ -90,6 +91,7 @@ PersistentVolumeSpec 是持久卷的规约。 - - **nodeAffinity.required** (NodeSelector) required 指定必须满足的硬性节点约束。 - - + + **节点选择器表示在一组节点上一个或多个标签查询结果的并集; 也就是说,它表示由节点选择器条件表示的选择器的逻辑或计算结果。** - + - **nodeAffinity.required.nodeSelectorTerms** ([]NodeSelectorTerm),必需 必需。节点选择器条件的列表。这些条件是逻辑或的计算结果。 - + **一个 null 或空的节点选择器条件不会与任何对象匹配。这些条件会按逻辑与的关系来计算。 TopologySelectorTerm 类别实现了 NodeSelectorTerm 的子集。** - + - **nodeAffinity.required.nodeSelectorTerms.matchExpressions** ([]}}">NodeSelectorRequirement) 基于节点标签所设置的节点选择器要求的列表。 - + - **nodeAffinity.required.nodeSelectorTerms.matchFields** ([]}}">NodeSelectorRequirement) 基于节点字段所设置的节点选择器要求的列表。 @@ -210,6 +215,7 @@ PersistentVolumeSpec 是持久卷的规约。 path of the directory on the host. If the path is a symlink, it will follow the link to the real path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath - **hostPath.type** (string) + type for HostPath Volume Defaults to "" More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath --> @@ -218,15 +224,15 @@ PersistentVolumeSpec 是持久卷的规约。 hostPath 表示主机上的目录,由开发或测试人员进行制备。hostPath 仅对单节点开发和测试有用! 不会以任何方式支持主机存储(On-host storage),并且**不能用于**多节点集群中。 更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#hostpath - - + + **表示映射到 Pod 中的主机路径。主机路径卷不支持所有权管理或 SELinux 重新打标签。** - + - **hostPath.path** (string),必需 目录在主机上的路径。如果该路径是一个符号链接,则它将沿着链接指向真实路径。 更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#hostpath - + - **hostPath.type** (string) HostPath 卷的类型。默认为 ""。更多信息: @@ -234,6 +240,7 @@ PersistentVolumeSpec 是持久卷的规约。 - **local** (LocalVolumeSource) local 表示具有节点亲和性的直连式存储。 - - + + **local 表示具有节点亲和性的直连式存储(Beta 特性)。** - + - **local.path** (string),必需 指向节点上卷的完整路径。它可以是一个目录或块设备(磁盘、分区...)。 - + - **local.fsType** (string) fsType 是要挂载的文件系统类型。它仅适用于 path 是一个块设备的情况。 @@ -265,20 +273,23 @@ PersistentVolumeSpec 是持久卷的规约。 ### 持久卷 {#persistent-volumes} + - **awsElasticBlockStore** (AWSElasticBlockStoreVolumeSource) - + awsElasticBlockStore 表示挂接到 kubelet 的主机随后暴露给 Pod 的一个 AWS Disk 资源。 更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#awselasticblockstore - + **表示 AWS 上的 Persistent Disk 资源。挂载到一个容器之前 AWS EBS 磁盘必须存在。 该磁盘还必须与 kubelet 位于相同的 AWS 区域中。AWS EBS 磁盘只能以读/写一次进行挂载。 @@ -286,15 +297,19 @@ PersistentVolumeSpec 是持久卷的规约。 @@ -302,19 +317,19 @@ PersistentVolumeSpec 是持久卷的规约。 volumeID 是 AWS(Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#awselasticblockstore - + - **awsElasticBlockStore.fsType** (string) fsType 是你要挂载的卷的文件系统类型。提示:确保主机操作系统支持此文件系统类型。 例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#awselasticblockstore - + - **awsElasticBlockStore.partition** (int32) partition 是你要挂载的卷中的分区。如果省略,则默认为按卷名称进行挂载。 例如:对于卷 /dev/sda1,将分区指定为 “1”。 类似地,/dev/sda 的卷分区为 “0”(或可以将属性留空)。 - + - **awsElasticBlockStore.readOnly** (boolean) readOnly 值为 true 将在 VolumeMounts 中强制设置 readOnly。更多信息: @@ -322,6 +337,7 @@ PersistentVolumeSpec 是持久卷的规约。 - **azureDisk.diskName** (string),必需 diskName 是 Blob 存储中数据盘的名称。 - + - **azureDisk.diskURI** (string),必需 diskURI 是 Blob 存储中数据盘的 URI。 - + - **azureDisk.cachingMode** (string) cachingMode 是主机缓存(Host Caching)模式:None、Read Only、Read Write。 - + - **azureDisk.fsType** (string) fsType 是要挂载的文件系统类型。必须是主机操作系统所支持的文件系统类型之一。 例如 “ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为 “ext4”。 - + - **azureDisk.kind** (string) kind 预期值包括: @@ -379,13 +399,14 @@ PersistentVolumeSpec 是持久卷的规约。 - Dedicated:每个存储帐户单个 Blob 磁盘; - Managed:azure 托管的数据盘(仅托管的可用性集合中)。 默认为 Shared。 - + - **azureDisk.readOnly** (boolean) readOnly 默认为 false(读/写)。此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。 - **azureFile** (AzureFilePersistentVolumeSource) azureDisk 表示主机上挂载的 Azure File Service 并绑定挂载到 Pod 上。 - - + + **azureFile 表示主机上挂载的 Azure File Service 并绑定挂载到 Pod 上。** - + - **azureFile.secretName** (string),必需 secretName 是包含 Azure 存储账号名称和主键的 Secret 的名称。 - + - **azureFile.shareName** (string),必需 shareName 是 azure Share Name。 - + - **azureFile.readOnly** (boolean) readOnly 默认为 false(读/写)。此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。 - + - **azureFile.secretNamespace** (string) secretNamespace 是包含 Azure 存储账号名称和主键的 Secret 的名字空间,默认与 Pod 相同。 @@ -459,16 +485,16 @@ PersistentVolumeSpec 是持久卷的规约。 monitors 是必需的。monitors 是 Ceph 监测的集合。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it - + - **cephfs.path** (string) path 是可选的。用作挂载的根,而不是完整的 Ceph 树,默认为 /。 - + - **cephfs.readOnly** (boolean) readOnly 是可选的。默认为 false(读/写)。此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。 更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it - + - **cephfs.secretFile** (string) secretFile 是可选的。secretFile 是 user 对应的密钥环的路径,默认为 /etc/ceph/user.secret。 @@ -476,6 +502,7 @@ PersistentVolumeSpec 是持久卷的规约。 @@ -495,18 +523,18 @@ PersistentVolumeSpec 是持久卷的规约。 secretRef 是可选的。secretRef 是针对用户到身份认证 Secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **cephfs.secretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **cephfs.secretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 - + - **cephfs.user** (string) user 是可选的。user 是 rados 用户名,默认为 admin。更多信息: @@ -514,6 +542,7 @@ PersistentVolumeSpec 是持久卷的规约。 - **cinder.secretRef** (SecretReference) secretRef 是可选的。指向 Secret 对象,内含的参数用于连接到 OpenStack。 - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **cinder.secretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **cinder.secretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 @@ -597,38 +628,42 @@ PersistentVolumeSpec 是持久卷的规约。 driver is the name of the driver to use for this volume. Required. - **csi.volumeHandle** (string), required + volumeHandle is the unique volume name returned by the CSI volume plugin’s CreateVolume to refer to the volume on all subsequent calls. Required. --> - **csi** (CSIPersistentVolumeSource) csi 表示由一个外部 CSI 驱动处理的存储(Beta 特性)。 - - + + **表示由一个外部 CSI 卷驱动管理的存储(Beta 特性)。** - + - **csi.driver** (string),必需 driver 是此卷所使用的驱动的名称。必需。 - + - **csi.volumeHandle** (string),必需 volumeHandle 是 CSI 卷插件的 CreateVolume 所返回的唯一卷名称,用于在所有后续调用中引用此卷。必需。 - + - **csi.controllerExpandSecretRef** (SecretReference) controllerExpandSecretRef 是对包含敏感信息的 Secret 对象的引用, @@ -636,20 +671,21 @@ PersistentVolumeSpec 是持久卷的规约。 这是一个 Beta 字段,需要启用 ExpandCSIVolumes 特性门控。 此字段是可选的,且如果不需要 Secret,则此字段可以为空。 如果 Secret 对象包含多个 Secret,则所有 Secret 被传递。 - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **csi.controllerExpandSecretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **csi.controllerExpandSecretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 @@ -842,20 +884,20 @@ PersistentVolumeSpec 是持久卷的规约。 fsType 是要挂载的文件系统类型。必须是主机操作系统所支持的文件系统类型之一。 例如 “ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为 “ext4”。 - + - **fc.lun** (int32) lun 是可选的。FC 目标 lun 编号。 - + - **fc.readOnly** (boolean) readOnly 是可选的。默认为 false(读/写)。 此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。 - + - **fc.targetWWNs** ([]string) targetWWNs 是可选的。FC 目标全球名称(WWN)。 - + - **fc.wwids** ([]string) wwids 是可选的。FC 卷全球识别号(wwids)。 @@ -863,6 +905,7 @@ PersistentVolumeSpec 是持久卷的规约。 - **flexVolume.driver** (string),必需 driver 是此卷所使用的驱动的名称。 - + - **flexVolume.fsType** (string) fsType 是要挂载的文件系统类型。必须是主机操作系统所支持的文件系统类型之一。 例如 “ext4”、“xfs”、“ntfs”。默认的文件系统取决于 flexVolume 脚本。 - + - **flexVolume.options** (map[string]string) options 是可选的。此字段包含额外的命令选项(如果有)。 - + - **flexVolume.readOnly** (boolean) readOnly 是可选的。默认为 false(读/写)。 @@ -910,6 +955,7 @@ PersistentVolumeSpec 是持久卷的规约。 @@ -926,14 +973,14 @@ PersistentVolumeSpec 是持久卷的规约。 secretRef 是可选的。secretRef 是对包含敏感信息的 Secret 对象的引用,从而传递到插件脚本。 如果未指定 Secret 对象,则此字段可以为空。如果 Secret 对象包含多个 Secret,则所有 Secret 被传递到插件脚本。 - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **flexVolume.secretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **flexVolume.secretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 @@ -949,6 +996,7 @@ PersistentVolumeSpec 是持久卷的规约。 datasetName is Name of the dataset stored as metadata -> name on the dataset for Flocker should be considered as deprecated - **flocker.datasetUUID** (string) + datasetUUID is the UUID of the dataset. This is unique identifier of a Flocker dataset --> @@ -956,15 +1004,15 @@ PersistentVolumeSpec 是持久卷的规约。 flocker 表示挂接到 kubelet 的主机并暴露给 Pod 供其使用的 Flocker 卷。 这取决于所运行的 Flocker 控制服务。 - - + + **表示 Flocker 代理挂载的 Flocker 卷。应设置且仅设置 datasetName 和 datasetUUID 中的一个。 Flocker 卷不支持所有权管理或 SELinux 重新打标签。** - + - **flocker.datasetName** (string) datasetName 是存储为元数据的数据集的名称。针对 Flocker 有关数据集的名称应视为已弃用。 - + - **flocker.datasetUUID** (string) datasetUUID 是数据集的 UUID。这是 Flocker 数据集的唯一标识符。 @@ -975,7 +1023,7 @@ PersistentVolumeSpec 是持久卷的规约。 *Represents a Persistent Disk resource in Google Compute Engine. - + A GCE PD must exist before mounting to a container. The disk must also be in the same GCE project and zone as the kubelet. A GCE PD can only be mounted as read/write once or read-only many times. GCE PDs support ownership management and SELinux relabeling.* --> @@ -984,8 +1032,8 @@ PersistentVolumeSpec 是持久卷的规约。 gcePersistentDisk 表示挂接到 kubelet 的主机随后暴露给 Pod 的一个 GCE Disk 资源。 由管理员进行制备。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk - - + + **表示 Google 计算引擎中的 Persistent Disk 资源。挂载到一个容器之前 GCE PD 必须存在。 该磁盘还必须与 kubelet 位于相同的 GCE 项目和区域中。GCE PD 只能挂载为读/写一次或只读多次。 GCE PD 支持所有权管理和 SELinux 重新打标签。** @@ -1002,25 +1050,25 @@ 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),必需 pdName 是 GCE 中 PD 资源的唯一名称。用于标识 GCE 中的磁盘。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk - + - **gcePersistentDisk.fsType** (string) fsType 是你要挂载的卷的文件系统类型。提示:确保主机操作系统支持此文件系统类型。 例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为 “ext4”。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk - + - **gcePersistentDisk.partition** (int32) partition 是你要挂载的卷中的分区。如果省略,则默认为按卷名称进行挂载。 例如:对于卷 /dev/sda1,将分区指定为 “1”。类似地,/dev/sda 的卷分区为 “0”(或可以将属性留空)。 更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#gcepersistentdisk - + - **gcePersistentDisk.readOnly** (boolean) 此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。默认为 false。更多信息: @@ -1028,16 +1076,18 @@ PersistentVolumeSpec 是持久卷的规约。 - **iscsi** (ISCSIPersistentVolumeSource) iscsi 表示挂接到 kubelet 的主机随后暴露给 Pod 的一个 ISCSI Disk 资源。由管理员进行制备。 - + **ISCSIPersistentVolumeSource 表示一个 ISCSI 磁盘。ISCSI 卷只能以读/写一次进行挂载。ISCSI 卷支持所有权管理和 SELinux 重新打标签。** @@ -1055,11 +1105,11 @@ PersistentVolumeSpec 是持久卷的规约。 - **iscsi.iqn** (string),必需 iqn 是目标 iSCSI 限定名称(Target iSCSI Qualified Name)。 - + - **iscsi.lun** (int32),必需 lun 是 iSCSI 目标逻辑单元号(iSCSI Target Lun)。 - + - **iscsi.targetPortal** (string),必需 targetPortal 是 iSCSI 目标门户(iSCSI Target Portal)。 @@ -1067,9 +1117,11 @@ PersistentVolumeSpec 是持久卷的规约。 @@ -1108,22 +1163,23 @@ PersistentVolumeSpec 是持久卷的规约。 initiatorName 是自定义的 iSCSI 发起程序名称(iSCSI Initiator Name)。 如果同时用 iscsiInterface 指定 initiatorName,将为连接创建新的 iSCSI 接口 \<目标门户>:\<卷名称>。 - + - **iscsi.iscsiInterface** (string) iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 “default”(tcp)。 - + - **iscsi.portals** ([]string) portals 是 iSCSI 目标门户列表(iSCSI Target Portal List)。 如果不是默认端口(通常是 TCP 端口 860 和 3260),则 Portal 为 IP 或 ip_addr:port。 - + - **iscsi.readOnly** (boolean) 此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。默认为 false。 - **iscsi.secretRef** (SecretReference) secretRef 是 iSCSI 目标和发起程序身份认证所用的 CHAP Secret。 - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **iscsi.secretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **iscsi.secretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 @@ -1165,6 +1222,7 @@ PersistentVolumeSpec 是持久卷的规约。 server is the hostname or IP address of the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs - **nfs.readOnly** (boolean) + readOnly here will force the NFS export to be mounted with read-only permissions. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs --> @@ -1172,20 +1230,20 @@ PersistentVolumeSpec 是持久卷的规约。 nfs 表示主机上挂载的 NFS。由管理员进行制备。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#nfs - - + + **表示 Pod 的生命周期内持续的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新打标签。** - + - **nfs.path** (string),必需 path 是由 NFS 服务器导出的路径。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#nfs - + - **nfs.server** (string),必需 server 是 NFS 服务器的主机名或 IP 地址。更多信息: https://kubernetes.io/zh-cn/docs/concepts/storage/volumes#nfs - + - **nfs.readOnly** (boolean) 此处 readOnly 将强制使用只读权限挂载 NFS 导出。默认为 false。更多信息: @@ -1208,14 +1266,14 @@ PersistentVolumeSpec 是持久卷的规约。 - **photonPersistentDisk** (PhotonPersistentDiskVolumeSource) photonPersistentDisk 表示 kubelet 主机上挂接和挂载的 PhotonController 持久磁盘。 - + **表示 Photon Controller 持久磁盘资源。** - + - **photonPersistentDisk.pdID** (string),必需 pdID 是标识 Photon Controller 持久磁盘的 ID。 - + - **photonPersistentDisk.fsType** (string) fsType 是要挂载的文件系统类型。必须是主机操作系统所支持的文件系统类型之一。 @@ -1241,25 +1299,26 @@ PersistentVolumeSpec 是持久卷的规约。 - **portworxVolume** (PortworxVolumeSource) portworxVolume 表示 kubelet 主机上挂接和挂载的 portworx 卷。 - + **PortworxVolumeSource 表示 Portworx 卷资源。** - + - **portworxVolume.volumeID** (string),必需 volumeID 唯一标识 Portworx 卷。 - + - **portworxVolume.fsType** (string) fSType 表示要挂载的文件系统类型。必须是主机操作系统所支持的文件系统类型之一。 例如 “ext4”、“xfs”。如果未指定,则隐式推断为 “ext4”。 - + - **portworxVolume.readOnly** (boolean) readOnly 默认为 false(读/写)。此处 readOnly 将在 VolumeMounts 中强制设置 readOnly。 @@ -1406,18 +1467,18 @@ PersistentVolumeSpec 是持久卷的规约。 secretRef 是针对 RBDUser 的身份认证 Secret 的名称。如果提供,则重载 keyring。默认为 nil。 更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it - - + + **SecretReference 表示对某 Secret 的引用,其中包含足够的信息来访问任何名字空间中的 Secret。** - + - **rbd.secretRef.name** (string) name 在名字空间内是唯一的,以引用一个 Secret 资源。 - + - **rbd.secretRef.namespace** (string) namespace 指定一个名字空间,Secret 名称在该名字空间中必须唯一。 - + - **rbd.user** (string) user 是 rados 用户名。默认为 admin。更多信息: @@ -1425,6 +1486,7 @@ PersistentVolumeSpec 是持久卷的规约。 @@ -1652,7 +1715,7 @@ PersistentVolumeStatus 是持久卷的当前状态。 - **phase** (string) phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase - + - **reason** (string) reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI. --> @@ -1717,6 +1780,7 @@ GET /api/v1/persistentvolumes/{name} #### Parameters - **name** (*in path*): string, required name of the PersistentVolume + - **pretty** (*in query*): string --> #### 参数 @@ -1748,6 +1812,7 @@ GET /api/v1/persistentvolumes/{name}/status #### Parameters - **name** (*in path*): string, required name of the PersistentVolume + - **pretty** (*in query*): string --> #### 参数