持久卷 (PV) 是由管理员预配的存储资源。它类似于节点。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes
持久卷 (PV) 是由管理员预配的存储资源。它类似于节点。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
APIVersion 定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
Kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从此客户端提交请求的端点推断出这一点。不能更新。使用驼峰命名法。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
|
|
|
PersistentVolumeSpec 是持久卷的规范。 |
|
|
PersistentVolumeStatus 是持久卷的当前状态。 |
PersistentVolumeSpec 是持久卷的规范。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
accessModes 包含卷可以挂载的所有方式。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#access-modes |
|
|
表示 AWS 中的持久磁盘资源。 在挂载到容器之前必须存在 AWS EBS 磁盘。磁盘还必须与 kubelet 位于同一个 AWS 区域。AWS EBS 磁盘只能一次以读写方式挂载。AWS EBS 卷支持所有权管理和 SELinux 重新标记。 |
|
|
AzureDisk 表示主机上的 Azure 数据磁盘挂载以及到 Pod 的绑定挂载。 |
|
|
AzureFile 表示主机上的 Azure 文件服务挂载以及到 Pod 的绑定挂载。 |
|
capacity 是持久卷的资源和容量的描述。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#capacity |
|
|
|
表示持续 Pod 寿命的 Ceph 文件系统挂载。Cephfs 卷不支持所有权管理或 SELinux 重新标记。 |
|
|
表示 Openstack 中的 cinder 卷资源。在挂载到容器之前必须存在 Cinder 卷。该卷还必须与 kubelet 位于同一区域。Cinder 卷支持所有权管理和 SELinux 重新标记。 |
|
|
ObjectReference 包含足够的信息,可让您检查或修改引用的对象。 |
|
|
表示由外部 CSI 卷驱动程序管理的存储(测试功能) |
|
|
表示光纤通道卷。光纤通道卷只能以读写方式挂载一次。光纤通道卷支持所有权管理和 SELinux 重新标记。 |
|
|
FlexPersistentVolumeSource 表示使用基于 exec 的插件进行预配/附加的通用持久卷资源。 |
|
|
表示由 Flocker 代理挂载的 Flocker 卷。datasetName 和 datasetUUID 中只有一个应该设置。Flocker 卷不支持所有权管理或 SELinux 重新标记。 |
|
|
表示 Google Compute Engine 中的持久磁盘资源。 必须在挂载到容器之前存在 GCE PD。磁盘还必须与 kubelet 位于同一 GCE 项目和区域中。GCE PD 只能以读写方式挂载一次或以只读方式挂载多次。GCE PD 支持所有权管理和 SELinux 重新标记。 |
|
|
表示持续整个 Pod 生命周期 的 Glusterfs 挂载。Glusterfs 卷不支持所有权管理或 SELinux 重新标记。 |
|
|
表示映射到 Pod 的主机路径。主机路径卷不支持所有权管理或 SELinux 重新标记。 |
|
|
ISCSIPersistentVolumeSource 表示一个 iSCSI 磁盘。iSCSI 卷只能以读写方式挂载一次。iSCSI 卷支持所有权管理和 SELinux 重新标记。 |
|
|
Local 表示具有节点亲和性的直接连接存储(测试功能) |
|
|
mountOptions 是挂载选项的列表,例如 ["ro", "soft"]。未经验证 - 如果一个选项无效,挂载将简单地失败。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes/#mount-options |
|
|
表示持续整个 Pod 生命周期 的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新标记。 |
|
|
VolumeNodeAffinity 定义了限制此卷可以从中访问的节点的约束。 |
|
|
persistentVolumeReclaimPolicy 定义了从其声明中释放持久卷时会发生的情况。有效选项包括 Retain(手动创建的 PersistentVolume 的默认值)、Delete(动态预配的 PersistentVolume 的默认值)和 Recycle(已弃用)。Recycle 必须由此 PersistentVolume 的底层卷插件支持。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#reclaiming 可能的枚举值:- |
|
|
表示 Photon Controller 持久磁盘资源。 |
|
|
PortworxVolumeSource 表示 Portworx 卷资源。 |
|
|
表示持续整个 Pod 生命周期 的 Quobyte 挂载。Quobyte 卷不支持所有权管理或 SELinux 重新标记。 |
|
|
表示持续整个 Pod 生命周期 的 Rados 块设备挂载。RBD 卷支持所有权管理和 SELinux 重新标记。 |
|
|
ScaleIOPersistentVolumeSource 表示持久性 ScaleIO 卷 |
|
|
storageClassName 是此持久卷所属的 StorageClass 的名称。空值表示此卷不属于任何 StorageClass。 |
|
|
表示 StorageOS 持久卷资源。 |
|
|
此持久卷所属的 VolumeAttributesClass 的名称。不允许为空值。当此字段未设置时,表示此卷不属于任何 VolumeAttributesClass。此字段是可变的,可以在卷成功更新到新类后由 CSI 驱动程序更改。对于未绑定的 PersistentVolume,在绑定过程中,volumeAttributesClassName 将与未绑定的 PersistentVolumeClaims 匹配。这是一个 alpha 字段,需要启用 VolumeAttributesClass 功能。 |
|
|
volumeMode 定义卷是否打算与已格式化的文件系统一起使用或保持原始块状态。如果未包含在规范中,则隐含 Filesystem 值。 可能的枚举值:- |
|
|
表示 vSphere 卷资源。 |
表示 AWS 中的持久磁盘资源。
在挂载到容器之前必须存在 AWS EBS 磁盘。磁盘还必须与 kubelet 位于同一个 AWS 区域。AWS EBS 磁盘只能一次以读写方式挂载。AWS EBS 卷支持所有权管理和 SELinux 重新标记。
对象
volumeID
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的卷的文件系统类型。提示:确保主机操作系统支持文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore |
|
|
partition 是要挂载的卷中的分区。如果省略,则默认为按卷名挂载。示例:对于卷 /dev/sda1,您将分区指定为“1”。类似地,/dev/sda 的卷分区为“0”(或者您可以保留该属性为空)。 |
|
|
readOnly 值 true 将强制 VolumeMounts 中的 readOnly 设置。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore |
|
|
volumeID 是 AWS(Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore |
AzureDisk 表示主机上的 Azure 数据磁盘挂载以及到 Pod 的绑定挂载。
对象
diskName
diskURI
属性 | 类型 | 描述 |
---|---|---|
|
|
cachingMode 是主机缓存模式:无、只读、读写。 可能的枚举值:- |
|
|
diskName 是 blob 存储中数据磁盘的名称 |
|
|
diskURI 是 blob 存储中数据磁盘的 URI |
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
kind 预期值为 Shared:每个存储帐户多个 blob 磁盘 Dedicated:每个存储帐户单个 blob 磁盘 Managed:azure 托管数据磁盘(仅在托管可用性集中)。默认为 shared 可能的枚举值:- |
|
|
readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。 |
AzureFile 表示主机上的 Azure 文件服务挂载以及到 Pod 的绑定挂载。
对象
secretName
shareName
属性 | 类型 | 描述 |
---|---|---|
|
|
readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。 |
|
|
secretName 是包含 Azure 存储帐户名称和密钥的密钥的名称 |
|
|
secretNamespace 是包含 Azure 存储帐户名称和密钥的密钥的命名空间,默认为与 Pod 相同 |
|
|
shareName 是 azure 共享名称 |
表示持续 Pod 寿命的 Ceph 文件系统挂载。Cephfs 卷不支持所有权管理或 SELinux 重新标记。
对象
monitors
属性 | 类型 | 描述 |
---|---|---|
|
|
monitors 是必需的:Monitors 是 Ceph monitors 的集合 更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
path 是可选的:用作已挂载的根目录,而不是完整的 Ceph 树,默认为 / |
|
|
readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
secretFile 可选:SecretFile 是用户密钥环的路径,默认为 /etc/ceph/user.secret。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
user 可选:User 是 rados 用户名,默认为 admin。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
表示 Openstack 中的 cinder 卷资源。在挂载到容器之前必须存在 Cinder 卷。该卷还必须与 kubelet 位于同一区域。Cinder 卷支持所有权管理和 SELinux 重新标记。
对象
volumeID
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md |
|
|
readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
volumeID 用于在 cinder 中标识卷。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
ObjectReference 包含足够的信息,可让您检查或修改引用的对象。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
引用的 API 版本。 |
|
|
如果引用的是对象的一部分而不是整个对象,则此字符串应包含有效的 JSON/Go 字段访问语句,例如 desiredState.manifest.containers[2]。例如,如果对象引用指向 Pod 中的容器,则其值将类似于:“spec.containers{name}”(其中“name”指的是触发事件的容器的名称)或者如果没有指定容器名称,则为“spec.containers[2]”(此 Pod 中索引为 2 的容器)。选择此语法只是为了有一种明确定义的方式来引用对象的一部分。 |
|
|
引用的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names |
|
|
引用的命名空间。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
此引用的特定 resourceVersion(如果存在)。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
引用的 UID。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids |
表示由外部 CSI 卷驱动程序管理的存储(测试功能)
对象
driver
volumeHandle
属性 | 类型 | 描述 |
---|---|---|
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
driver 是此卷要使用的驱动程序的名称。必需。 |
|
|
要挂载的 fsType。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
要传递给 ControllerPublishVolumeRequest 的 readOnly 值。默认为 false(读写)。 |
|
|
要发布的卷的 volumeAttributes。 |
|
|
volumeHandle 是 CSI 卷插件的 CreateVolume 返回的唯一卷名称,用于在所有后续调用中引用卷。必需。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
表示光纤通道卷。光纤通道卷只能以读写方式挂载一次。光纤通道卷支持所有权管理和 SELinux 重新标记。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
lun 可选:FC 目标 LUN 号码 |
|
|
readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。 |
|
|
targetWWNs 可选:FC 目标全球名称 (WWNs) |
|
|
wwids 可选:FC 卷全球标识符 (wwids) 必须设置 wwids 或 targetWWNs 和 lun 的组合,但不能同时设置两者。 |
FlexPersistentVolumeSource 表示使用基于 exec 的插件进行预配/附加的通用持久卷资源。
对象
driver
属性 | 类型 | 描述 |
---|---|---|
|
|
driver 是要为此卷使用的驱动程序的名称。 |
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。默认文件系统取决于 FlexVolume 脚本。 |
|
|
options 可选:此字段包含任何额外的命令选项。 |
|
|
readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
表示由 Flocker 代理挂载的 Flocker 卷。datasetName 和 datasetUUID 中只有一个应该设置。Flocker 卷不支持所有权管理或 SELinux 重新标记。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
datasetName 是数据集的名称,存储为数据集上的元数据→名称,Flocker 的数据集名称应视为已弃用。 |
|
|
datasetUUID 是数据集的 UUID。这是 Flocker 数据集的唯一标识符。 |
表示 Google Compute Engine 中的持久磁盘资源。
必须在挂载到容器之前存在 GCE PD。磁盘还必须与 kubelet 位于同一 GCE 项目和区域中。GCE PD 只能以读写方式挂载一次或以只读方式挂载多次。GCE PD 支持所有权管理和 SELinux 重新标记。
对象
pdName
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
partition 是您要挂载的卷中的分区。如果省略,则默认按卷名称挂载。例如:对于卷 /dev/sda1,您将分区指定为“1”。类似地,/dev/sda 的卷分区为“0”(或者您可以留空该属性)。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
pdName 是 GCE 中 PD 资源的唯一名称。用于在 GCE 中标识磁盘。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
此处的 readOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。默认为 false。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk |
表示持续整个 Pod 生命周期 的 Glusterfs 挂载。Glusterfs 卷不支持所有权管理或 SELinux 重新标记。
对象
endpoints
path
属性 | 类型 | 描述 |
---|---|---|
|
|
endpoints 是详细说明 Glusterfs 拓扑的端点名称。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
|
endpointsNamespace 是包含 Glusterfs 端点的命名空间。如果此字段为空,则 EndpointNamespace 默认与绑定的 PVC 的命名空间相同。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
|
path 是 Glusterfs 卷的路径。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
|
readOnly 将强制 Glusterfs 卷以只读权限挂载。默认为 false。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
表示映射到 Pod 的主机路径。主机路径卷不支持所有权管理或 SELinux 重新标记。
对象
path
属性 | 类型 | 描述 |
---|---|---|
|
|
主机上目录的路径。如果路径是符号链接,它将跟随链接到实际路径。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#hostpath |
|
|
HostPath 卷的类型,默认为 ""。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#hostpath 可能的枚举值:- |
ISCSIPersistentVolumeSource 表示一个 iSCSI 磁盘。iSCSI 卷只能以读写方式挂载一次。iSCSI 卷支持所有权管理和 SELinux 重新标记。
对象
目标Portal
iqn
lun
属性 | 类型 | 描述 |
---|---|---|
|
|
chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证 |
|
|
chapAuthSession 定义是否支持 iSCSI Session CHAP 身份验证 |
|
|
fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#iscsi |
|
|
initiatorName 是自定义的 iSCSI 发起程序名称。如果同时指定了 initiatorName 和 iscsiInterface,则将为连接创建新的 iSCSI 接口 <目标门户>:<卷名称>。 |
|
|
iqn 是目标 iSCSI 限定名称。 |
|
|
iscsiInterface 是使用 iSCSI 传输的接口名称。默认为“default”(tcp)。 |
|
|
lun 是 iSCSI 目标 LUN 号。 |
|
|
portals 是 iSCSI 目标门户列表。门户是 IP 或 ip_addr:port(如果端口不是默认端口(通常是 TCP 端口 860 和 3260))。 |
|
|
readOnly 将强制在 VolumeMounts 中设置 ReadOnly。默认为 false。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
targetPortal 是 iSCSI 目标门户。门户是 IP 或 ip_addr:port(如果端口不是默认端口(通常是 TCP 端口 860 和 3260))。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
Local 表示具有节点亲和性的直接连接存储(测试功能)
对象
path
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。仅当 Path 是块设备时才适用。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则默认为自动选择文件系统。 |
|
|
节点上卷的完整路径。它可以是目录或块设备(磁盘、分区……)。 |
表示持续整个 Pod 生命周期 的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新标记。
对象
服务器
path
属性 | 类型 | 描述 |
---|---|---|
|
|
NFS 服务器导出的路径。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs |
|
|
readOnly 将强制 NFS 导出以只读权限挂载。默认为 false。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs |
|
|
server 是 NFS 服务器的主机名或 IP 地址。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs |
VolumeNodeAffinity 定义了限制此卷可以从中访问的节点的约束。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
节点选择器表示对一组节点进行的一个或多个标签查询结果的并集;也就是说,它表示节点选择器术语所表示的选择器的 OR。 |
节点选择器表示对一组节点进行的一个或多个标签查询结果的并集;也就是说,它表示节点选择器术语所表示的选择器的 OR。
对象
nodeSelectorTerms
属性 | 类型 | 描述 |
---|---|---|
|
|
必需。节点选择器术语列表。这些术语是 ORed 的。 |
|
|
空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 ANDed 的。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。 |
空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 ANDed 的。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
根据节点的标签列出节点选择器要求。 |
|
|
节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。 |
|
|
根据节点的字段列出节点选择器要求。 |
|
|
节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。 |
节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。
对象
键
运算符
属性 | 类型 | 描述 |
---|---|---|
|
|
选择器应用到的标签键。 |
|
|
表示键与一组值的关系。有效的运算符是 In、NotIn、Exists、DoesNotExist、Gt 和 Lt。 可能的枚举值:- |
|
|
字符串值数组。如果运算符是 In 或 NotIn,则 values 数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则 values 数组必须为空。如果运算符是 Gt 或 Lt,则 values 数组必须只有一个元素,该元素将被解释为整数。此数组在策略性合并修补程序期间被替换。 |
节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。
对象
键
运算符
属性 | 类型 | 描述 |
---|---|---|
|
|
选择器应用到的标签键。 |
|
|
表示键与一组值的关系。有效的运算符是 In、NotIn、Exists、DoesNotExist、Gt 和 Lt。 可能的枚举值:- |
|
|
字符串值数组。如果运算符是 In 或 NotIn,则 values 数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则 values 数组必须为空。如果运算符是 Gt 或 Lt,则 values 数组必须只有一个元素,该元素将被解释为整数。此数组在策略性合并修补程序期间被替换。 |
表示 Photon Controller 持久磁盘资源。
对象
pdID
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
pdID 是标识 Photon Controller 持久磁盘的 ID |
PortworxVolumeSource 表示 Portworx 卷资源。
对象
volumeID
属性 | 类型 | 描述 |
---|---|---|
|
|
fSType 表示要挂载的文件系统类型,必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。 |
|
|
volumeID 唯一标识 Portworx 卷 |
表示持续整个 Pod 生命周期 的 Quobyte 挂载。Quobyte 卷不支持所有权管理或 SELinux 重新标记。
对象
注册表
卷
属性 | 类型 | 描述 |
---|---|---|
|
|
将卷访问映射到的组,默认为无组 |
|
|
readOnly 将强制 Quobyte 卷以只读权限挂载。默认为 false。 |
|
|
registry 表示一个或多个 Quobyte 注册表服务,指定为字符串,例如 host:port 对(多个条目用逗号分隔),它充当卷的中央注册表 |
|
|
在使用动态配置的 Quobyte 卷的后端中拥有给定 Quobyte 卷的租户,该值由插件设置。 |
|
|
用户将卷访问映射到,默认为 service account 用户。 |
|
|
卷是一个字符串,它通过名称引用一个已创建的 Quobyte 卷。 |
表示持续整个 Pod 生命周期 的 Rados 块设备挂载。RBD 卷支持所有权管理和 SELinux 重新标记。
对象
monitors
镜像
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#rbd |
|
|
image 是 rados 镜像名称。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
keyring 是 RBDUser 的密钥环路径。默认为 /etc/ceph/keyring。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
monitors 是 Ceph 监控器的集合。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
pool 是 rados 池名称。默认为 rbd。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
readOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。默认为 false。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
user 是 rados 用户名。默认为 admin。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
ScaleIOPersistentVolumeSource 表示持久性 ScaleIO 卷
对象
网关
系统
secretRef
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。默认为“xfs”。 |
|
|
gateway 是 ScaleIO API 网关的主机地址。 |
|
|
protectionDomain 是为配置的存储指定的 ScaleIO 保护域的名称。 |
|
|
readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。 |
|
|
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。 |
|
|
sslEnabled 是启用/禁用与网关的 SSL 通信的标志,默认为 false。 |
|
|
storageMode 指示卷的存储应该是 ThickProvisioned 还是 ThinProvisioned。默认为 ThinProvisioned。 |
|
|
storagePool 是与保护域关联的 ScaleIO 存储池。 |
|
|
system 是在 ScaleIO 中配置的存储系统的名称。 |
|
|
volumeName 是已在与该卷源关联的 ScaleIO 系统中创建的卷的名称。 |
SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
name 在命名空间内是唯一的,用于引用 secret 资源。 |
|
|
namespace 定义 secret 名称必须唯一的空间。 |
表示 StorageOS 持久卷资源。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。 |
|
|
ObjectReference 包含足够的信息,可让您检查或修改引用的对象。 |
|
|
volumeName 是 StorageOS 卷的可读名称。卷名仅在一个命名空间内唯一。 |
|
|
volumeNamespace 指定 StorageOS 中卷的范围。如果未指定命名空间,则将使用 Pod 的命名空间。这允许在 StorageOS 中镜像 Kubernetes 名称范围,以实现更紧密的集成。将 VolumeName 设置为任何名称以覆盖默认行为。如果您没有在 StorageOS 中使用命名空间,则设置为“default”。StorageOS 中不存在的命名空间将被创建。 |
ObjectReference 包含足够的信息,可让您检查或修改引用的对象。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
引用的 API 版本。 |
|
|
如果引用的是对象的一部分而不是整个对象,则此字符串应包含有效的 JSON/Go 字段访问语句,例如 desiredState.manifest.containers[2]。例如,如果对象引用指向 Pod 中的容器,则其值将类似于:“spec.containers{name}”(其中“name”指的是触发事件的容器的名称)或者如果没有指定容器名称,则为“spec.containers[2]”(此 Pod 中索引为 2 的容器)。选择此语法只是为了有一种明确定义的方式来引用对象的一部分。 |
|
|
引用的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names |
|
|
引用的命名空间。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
此引用的特定 resourceVersion(如果存在)。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
引用的 UID。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids |
表示 vSphere 卷资源。
对象
卷路径
属性 | 类型 | 描述 |
---|---|---|
|
|
fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。 |
|
|
storagePolicyID 是与 StoragePolicyName 关联的基于存储策略的管理 (SPBM) 配置文件 ID。 |
|
|
storagePolicyName 是基于存储策略的管理 (SPBM) 配置文件名称。 |
|
|
volumePath 是标识 vSphere 卷 vmdk 的路径。 |
PersistentVolumeStatus 是持久卷的当前状态。
对象
属性 | 类型 | 描述 |
---|---|---|
|
lastPhaseTransitionTime 是阶段从一个阶段转换到另一个阶段的时间,并且每次卷阶段转换时都会自动重置为当前时间。这是一个测试版字段,需要启用 PersistentVolumeLastPhaseTransitionTime 功能(默认情况下启用)。 |
|
|
|
message 是一个易于理解的消息,指示有关卷处于此状态的原因的详细信息。 |
|
|
phase 指示卷是可用、绑定到声明还是由声明释放。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#phase 可能的枚举值:- `“Available”` 用于尚未绑定的 PersistentVolumes。可用卷由绑定器持有并与 PersistentVolumeClaims 匹配 - `“Bound”` 用于已绑定的 PersistentVolumes - `“Failed”` 用于在从声明中释放后未能正确回收或删除的 PersistentVolumes - `“Pending”` 用于不可用的 PersistentVolumes - `“Released”` 用于已删除绑定 PersistentVolumeClaim 的 PersistentVolumes。释放的卷必须在再次可用之前进行回收。此阶段由持久卷声明绑定器用于向另一个进程发出信号以回收资源。 |
|
|
reason 是一个简短的驼峰式字符串,描述任何故障,旨在用于机器解析和在 CLI 中整齐显示。 |
提供以下 API 端点
/api/v1/persistentvolumes
DELETE
:删除 PersistentVolume 集合
GET
:列出或监视 PersistentVolume 类型对象
POST
:创建 PersistentVolume
/api/v1/watch/persistentvolumes
GET
:监视 PersistentVolume 列表的单个更改。已弃用:改为使用列表操作的“watch”参数。
/api/v1/persistentvolumes/{name}
DELETE
:删除 PersistentVolume
GET
:读取指定的 PersistentVolume
PATCH
:部分更新指定的 PersistentVolume
PUT
:替换指定的 PersistentVolume
/api/v1/watch/persistentvolumes/{name}
GET
:监视 PersistentVolume 类型对象的更改。已弃用:改为使用列表操作的“watch”参数,并使用“fieldSelector”参数过滤为单个项目。
/api/v1/persistentvolumes/{name}/status
GET
:读取指定的 PersistentVolume 的状态
PATCH
:部分更新指定的 PersistentVolume 的状态
PUT
:替换指定的 PersistentVolume 的状态
DELETE
删除 PersistentVolume 集合
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
GET
列出或监视 PersistentVolume 类型对象
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
POST
创建 PersistentVolume
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - 创建成功 |
|
202 - 已接受 |
|
401 - 未授权 |
空 |
GET
监控 PersistentVolume 列表的单个更改。已弃用:请改用列表操作中的“watch”参数。
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
参数 | 类型 | 描述 |
---|---|---|
|
|
PersistentVolume 的名称 |
DELETE
删除 PersistentVolume
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
202 - 已接受 |
|
401 - 未授权 |
空 |
GET
读取指定的 PersistentVolume
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PATCH
部分更新指定的 PersistentVolume
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - 创建成功 |
|
401 - 未授权 |
空 |
PUT
替换指定的 PersistentVolume
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - 创建成功 |
|
401 - 未授权 |
空 |
参数 | 类型 | 描述 |
---|---|---|
|
|
PersistentVolume 的名称 |
GET
监控 PersistentVolume 对象的更改。已弃用:请改用列表操作中的“watch”参数,并使用“fieldSelector”参数过滤为单个项目。
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
参数 | 类型 | 描述 |
---|---|---|
|
|
PersistentVolume 的名称 |
GET
读取指定的 PersistentVolume 的状态
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PATCH
部分更新指定的 PersistentVolume 的状态
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - 创建成功 |
|
401 - 未授权 |
空 |
PUT
替换指定的 PersistentVolume 的状态
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - 创建成功 |
|
401 - 未授权 |
空 |