Volume

Volume 代表 Pod 中的命名卷，Pod 中的任何容器都可以访问它。

import "k8s.io/api/core/v1"

Volume

Volume 代表 Pod 中的命名卷，Pod 中的任何容器都可以访问它。

公开的持久卷

投影

  • configMap (ConfigMapVolumeSource)

    configMap 代表一个应该填充此卷的 configMap

    *将 ConfigMap 调整为卷。

    目标 ConfigMap 的 Data 字段的内容将作为文件显示在卷中，使用 Data 字段中的键作为文件名，除非 items 元素填充了键到路径的特定映射。ConfigMap 卷支持所有权管理和 SELinux 重新标记。*

    • configMap.name (string)

      被引用对象的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

    • configMap.optional (boolean)

      optional 指定 ConfigMap 或其键是否必须定义

    • configMap.defaultMode (int32)

      defaultMode 是可选的：用于默认情况下设置创建文件的权限的模式位。必须是介于 0000 和 0777 之间的八进制值，或介于 0 和 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位使用十进制值。默认为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

    • configMap.items ([]KeyToPath)

      items 如果未指定，则引用 ConfigMap 的 Data 字段中的每个键值对将被投影到卷中，作为名为键且内容为值的 文件。如果指定，则列出的键将被投影到指定的路径中，未列出的键将不存在。如果指定了 ConfigMap 中不存在的键，则卷设置将出错，除非它被标记为可选。路径必须是相对的，并且不能包含“..”路径或以“..”开头。

  • secret (SecretVolumeSource)

    secret 代表一个应该填充此卷的 secret。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#secret

    *将 Secret 调整为卷。

    目标 Secret 的 Data 字段的内容将作为文件显示在卷中，使用 Data 字段中的键作为文件名。Secret 卷支持所有权管理和 SELinux 重新标记。*

    • secret.secretName (string)

      secretName 是要使用的 Pod 命名空间中的 secret 的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#secret

    • secret.optional (boolean)

      optional 字段指定 Secret 或其键是否必须定义

    • secret.defaultMode (int32)

      defaultMode 是可选的：用于默认情况下设置创建文件的权限的模式位。必须是介于 0000 和 0777 之间的八进制值，或介于 0 和 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位使用十进制值。默认为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

    • secret.items ([]KeyToPath)

      items 如果未指定，则引用 Secret 的 Data 字段中的每个键值对将被投影到卷中，作为名为键且内容为值的 文件。如果指定，则列出的键将被投影到指定的路径中，未列出的键将不存在。如果指定了 Secret 中不存在的键，则卷设置将出错，除非它被标记为可选。路径必须是相对的，并且不能包含“..”路径或以“..”开头。

  • downwardAPI (DownwardAPIVolumeSource)

    downwardAPI 代表应该填充此卷的关于 Pod 的向下 API

    DownwardAPIVolumeSource 代表包含向下 API 信息的卷。向下 API 卷支持所有权管理和 SELinux 重新标记。

    • downwardAPI.defaultMode (int32)

      可选：用于默认情况下设置创建文件的权限的模式位。必须是可选：用于默认情况下设置创建文件的权限的模式位。必须是介于 0000 和 0777 之间的八进制值，或介于 0 和 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位使用十进制值。默认为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

    • downwardAPI.items ([]DownwardAPIVolumeFile)

      Items 是向下 API 卷文件的列表

  • projected (ProjectedVolumeSource)

    projected 项目适用于所有一体化资源 secret、configmap 和向下 API

    代表投影的卷源

    • projected.defaultMode (int32)

      defaultMode 是用于默认情况下设置创建文件的权限的模式位。必须是介于 0000 和 0777 之间的八进制值，或介于 0 和 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位使用十进制值。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

    • projected.sources ([]VolumeProjection)

      sources 是卷投影的列表

      可以与其他支持的卷类型一起投影的投影

      • projected.sources.configMap (ConfigMapProjection)

        configMap 关于要投影的 configMap 数据的信息

        *将 ConfigMap 调整为投影的卷。

        目标 ConfigMap 的 Data 字段的内容将作为文件显示在投影的卷中，使用 Data 字段中的键作为文件名，除非 items 元素填充了键到路径的特定映射。请注意，这与没有默认模式的 configmap 卷源相同。*

        • projected.sources.configMap.name (string)

          被引用对象的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

        • projected.sources.configMap.optional (boolean)

          optional 指定 ConfigMap 或其键是否必须定义

        • projected.sources.configMap.items ([]KeyToPath)

          items 如果未指定，则引用 ConfigMap 的 Data 字段中的每个键值对将被投影到卷中，作为名为键且内容为值的 文件。如果指定，则列出的键将被投影到指定的路径中，未列出的键将不存在。如果指定了 ConfigMap 中不存在的键，则卷设置将出错，除非它被标记为可选。路径必须是相对的，并且不能包含“..”路径或以“..”开头。

      • projected.sources.downwardAPI (DownwardAPIProjection)

        downwardAPI 关于要投影的向下 API 数据的信息

        代表向下 API 信息，用于投影到投影的卷中。请注意，这与没有默认模式的向下 API 卷源相同。

      • projected.sources.secret (SecretProjection)

        secret 关于要投影的 secret 数据的信息

        *将 secret 调整为投影的卷。

        目标 Secret 的 Data 字段的内容将作为文件显示在投影的卷中，使用 Data 字段中的键作为文件名。请注意，这与没有默认模式的 secret 卷源相同。*

        • projected.sources.secret.name (string)

          被引用对象的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

        • projected.sources.secret.optional (boolean)

          optional 字段指定 Secret 或其键是否必须定义

        • projected.sources.secret.items ([]KeyToPath)

          items 如果未指定，则引用 Secret 的 Data 字段中的每个键值对将被投影到卷中，作为名为键且内容为值的 文件。如果指定，则列出的键将被投影到指定的路径中，未列出的键将不存在。如果指定了 Secret 中不存在的键，则卷设置将出错，除非它被标记为可选。路径必须是相对的，并且不能包含“..”路径或以“..”开头。

      • projected.sources.serviceAccountToken (ServiceAccountTokenProjection)

        serviceAccountToken 是关于要投影的 serviceAccountToken 数据的信息

        ServiceAccountTokenProjection 表示一个投影的服务帐户令牌卷。此投影可用于将服务帐户令牌插入到 Pod 的运行时文件系统中，以便针对 API（Kubernetes API 服务器或其他）使用。

        • projected.sources.serviceAccountToken.path (字符串)，必需

          path 是相对于挂载点的文件路径，用于将令牌投影到该路径。

        • projected.sources.serviceAccountToken.audience (字符串)

          audience 是令牌的预期受众。令牌的接收者必须使用令牌的受众中指定的标识符来标识自己，否则应拒绝该令牌。受众默认为 apiserver 的标识符。

        • projected.sources.serviceAccountToken.expirationSeconds (int64)

          expirationSeconds 是请求的服务帐户令牌有效期。当令牌接近过期时，kubelet 卷插件将主动轮换服务帐户令牌。如果令牌的剩余有效期少于其有效期的 80%，或者令牌的年龄超过 24 小时，kubelet 将开始尝试轮换令牌。默认值为 1 小时，必须至少为 10 分钟。

本地/临时目录

持久卷

  • awsElasticBlockStore (AWSElasticBlockStoreVolumeSource)

    awsElasticBlockStore 表示附加到 kubelet 主机并随后暴露给 Pod 的 AWS 磁盘资源。有关更多信息，请参见：https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore

    *表示 AWS 中的持久磁盘资源。

    在挂载到容器之前，必须存在 AWS EBS 磁盘。磁盘还必须与 kubelet 位于同一个 AWS 区域。AWS EBS 磁盘只能以读写方式挂载一次。AWS EBS 卷支持所有权管理和 SELinux 重新标记。*

  • azureDisk (AzureDiskVolumeSource)

    azureDisk 表示主机上的 Azure 数据磁盘挂载，并绑定挂载到 Pod。

    AzureDisk 表示主机上的 Azure 数据磁盘挂载，并绑定挂载到 Pod。

    • azureDisk.diskName (字符串)，必需

      diskName 是 blob 存储中数据磁盘的名称

    • azureDisk.diskURI (字符串)，必需

      diskURI 是 blob 存储中数据磁盘的 URI

    • azureDisk.cachingMode (字符串)

      cachingMode 是主机缓存模式：None、ReadOnly、ReadWrite。

    • azureDisk.fsType (字符串)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如：“ext4”、“xfs”、“ntfs”。如果未指定，则隐式推断为“ext4”。

    • azureDisk.kind (字符串)

      kind 预期值为 Shared：每个存储帐户多个 blob 磁盘 Dedicated：每个存储帐户单个 blob 磁盘 Managed：azure 托管数据磁盘（仅在托管可用性集中）。默认为 shared

    • azureDisk.readOnly (布尔值)

      readOnly 默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

  • azureFile (AzureFileVolumeSource)

    azureFile 表示主机上的 Azure 文件服务挂载，并绑定挂载到 Pod。

    AzureFile 表示主机上的 Azure 文件服务挂载，并绑定挂载到 Pod。

    • azureFile.secretName (字符串)，必需

      secretName 是包含 Azure 存储帐户名称和密钥的密钥的名称

    • azureFile.shareName (字符串)，必需

      shareName 是 azure 共享名称

    • azureFile.readOnly (布尔值)

      readOnly 默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

  • cephfs (CephFSVolumeSource)

    cephFS 表示主机上与 Pod 生命周期共享的 Ceph FS 挂载

    表示与 Pod 生命周期持续的 Ceph 文件系统挂载。Cephfs 卷不支持所有权管理或 SELinux 重新标记。

  • cinder (CinderVolumeSource)

    cinder 表示附加到 kubelets 主机并挂载到其上的 cinder 卷。有关更多信息，请参见：https://examples.k8s.io/mysql-cinder-pd/README.md

    表示 Openstack 中的 cinder 卷资源。在挂载到容器之前，必须存在 Cinder 卷。卷还必须与 kubelet 位于同一个区域。Cinder 卷支持所有权管理和 SELinux 重新标记。

  • csi (CSIVolumeSource)

    csi（容器存储接口）表示由某些外部 CSI 驱动程序处理的短暂存储（Beta 功能）。

    表示要挂载的卷的源位置，由外部 CSI 驱动程序管理

    • csi.driver (字符串)，必需

      driver 是处理此卷的 CSI 驱动程序的名称。请咨询您的管理员以获取在集群中注册的正确名称。

    • csi.fsType (字符串)

      要挂载的 fsType。例如：“ext4”、“xfs”、“ntfs”。如果未提供，则空值将传递给关联的 CSI 驱动程序，该驱动程序将确定要应用的默认文件系统。

    • csi.nodePublishSecretRef (LocalObjectReference)

      nodePublishSecretRef 是对密钥对象的引用，该密钥对象包含敏感信息，以传递给 CSI 驱动程序以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要密钥，则可以为空。如果密钥对象包含多个密钥，则将传递所有密钥引用。

    • csi.readOnly (布尔值)

      readOnly 指定卷的只读配置。默认为 false（读写）。

    • csi.volumeAttributes (map[string]string)

      volumeAttributes 存储传递给 CSI 驱动程序的驱动程序特定属性。请咨询驱动程序的文档以了解支持的值。

  • ephemeral (EphemeralVolumeSource)

    ephemeral 表示由集群存储驱动程序处理的卷。卷的生命周期与定义它的 Pod 绑定在一起 - 它将在 Pod 启动之前创建，并在 Pod 移除时删除。

    如果满足以下条件，请使用此方法：a) 仅在 Pod 运行时需要卷，b) 需要正常卷的功能，例如从快照恢复或容量跟踪，c) 通过存储类指定存储驱动程序，以及 d) 存储驱动程序通过 PersistentVolumeClaim 支持动态卷供应（有关此卷类型与 PersistentVolumeClaim 之间关系的更多信息，请参阅 EphemeralVolumeSource）。

    对于比单个 Pod 生命周期更长的卷，请使用 PersistentVolumeClaim 或其中一个供应商特定的 API。

    如果 CSI 驱动程序旨在以这种方式使用，请使用 CSI 创建轻量级本地临时卷 - 有关更多信息，请参阅驱动程序的文档。

    Pod 可以同时使用两种类型的临时卷和持久卷。

    表示由正常存储驱动程序处理的临时卷。

    • ephemeral.volumeClaimTemplate (PersistentVolumeClaimTemplate)

      将用于创建独立的 PVC 来供应卷。嵌入此 EphemeralVolumeSource 的 Pod 将是 PVC 的所有者，即 PVC 将与 Pod 一起删除。PVC 的名称将为 \<pod name>-\<volume name>，其中 \<volume name> 是来自 PodSpec.Volumes 数组条目中的名称。如果连接的名称对于 PVC 无效（例如，太长），则 Pod 验证将拒绝 Pod。

      不会将 Pod 不拥有的具有该名称的现有 PVC 用于 Pod，以避免错误地使用无关的卷。然后，Pod 启动将被阻塞，直到无关的 PVC 被删除。如果此类预先创建的 PVC 旨在由 Pod 使用，则 PVC 必须在 Pod 存在后使用对 Pod 的所有者引用进行更新。通常，这应该没有必要，但在手动重建损坏的集群时可能有用。

      此字段是只读的，Kubernetes 在 PVC 创建后不会对其进行任何更改。

      必需，不能为空。

      PersistentVolumeClaimTemplate 用于生成 PersistentVolumeClaim 对象作为 EphemeralVolumeSource 的一部分。

      • ephemeral.volumeClaimTemplate.spec (PersistentVolumeClaimSpec)，必需

        PersistentVolumeClaim 的规范。整个内容将被复制到从该模板创建的 PVC 中，而不会进行任何更改。PersistentVolumeClaim 中的相同字段在此处也有效。

      • ephemeral.volumeClaimTemplate.metadata (ObjectMeta)

        可能包含将在创建 PVC 时复制到 PVC 中的标签和注释。不允许使用其他字段，并且将在验证期间被拒绝。

  • fc (FCVolumeSource)

    fc 表示连接到 kubelet 主机的 Fibre Channel 资源，然后公开给 Pod。

    表示 Fibre Channel 卷。Fibre Channel 卷只能以读写方式挂载一次。Fibre Channel 卷支持所有权管理和 SELinux 重新标记。

    • fc.fsType (string)

      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 卷全球标识符 (wwid) 必须设置 wwids 或 targetWWNs 和 lun 的组合，但不能同时设置两者。

  • flexVolume (FlexVolumeSource)

    flexVolume 表示使用基于 exec 的插件进行配置/附加的通用卷资源。

    FlexVolume 表示使用基于 exec 的插件进行配置/附加的通用卷资源。

    • flexVolume.driver (string)，必需

      driver 是此卷要使用的驱动程序的名称。

    • flexVolume.fsType (string)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。默认文件系统取决于 FlexVolume 脚本。

    • flexVolume.options (map[string]string)

      options 是可选的：此字段保存任何额外的命令选项。

    • flexVolume.readOnly (boolean)

      readOnly 是可选的：默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

    • flexVolume.secretRef (LocalObjectReference)

      secretRef 是可选的：secretRef 是对包含要传递给插件脚本的敏感信息的 secret 对象的引用。如果未指定 secret 对象，则此字段可能为空。如果 secret 对象包含多个 secret，则所有 secret 都将传递给插件脚本。

  • flocker (FlockerVolumeSource)

    flocker 表示连接到 kubelet 主机的 Flocker 卷。这取决于 Flocker 控制服务是否正在运行

    表示由 Flocker 代理挂载的 Flocker 卷。datasetName 和 datasetUUID 应该只设置一个。Flocker 卷不支持所有权管理或 SELinux 重新标记。

    • flocker.datasetName (string)

      datasetName 是存储为元数据 -> Flocker 数据集上的名称的名称，应被视为已弃用

    • flocker.datasetUUID (string)

      datasetUUID 是数据集的 UUID。这是 Flocker 数据集的唯一标识符

  • gcePersistentDisk (GCEPersistentDiskVolumeSource)

    gcePersistentDisk 表示连接到 kubelet 主机的 GCE 磁盘资源，然后公开给 Pod。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

    *表示 Google Compute Engine 中的持久磁盘资源。

    在挂载到容器之前，必须存在 GCE PD。磁盘还必须与 kubelet 位于同一个 GCE 项目和区域中。GCE PD 只能以读写方式挂载一次或以只读方式挂载多次。GCE PD 支持所有权管理和 SELinux 重新标记。*

  • glusterfs (GlusterfsVolumeSource)

    glusterfs 表示主机上的 Glusterfs 挂载，该挂载共享 Pod 的生命周期。更多信息：https://examples.k8s.io/volumes/glusterfs/README.md

    表示持续 Pod 生命周期的 Glusterfs 挂载。Glusterfs 卷不支持所有权管理或 SELinux 重新标记。

  • iscsi (ISCSIVolumeSource)

    iscsi 表示连接到 kubelet 主机的 ISCSI 磁盘资源，然后公开给 Pod。更多信息：https://examples.k8s.io/volumes/iscsi/README.md

    表示 ISCSI 磁盘。ISCSI 卷只能以读写方式挂载一次。ISCSI 卷支持所有权管理和 SELinux 重新标记。

    • iscsi.iqn (string)，必需

      iqn 是目标 iSCSI 限定名称。

    • iscsi.lun (int32)，必需

      lun 表示 iSCSI 目标 LUN 号码。

    • iscsi.targetPortal (string)，必需

      targetPortal 是 iSCSI 目标 Portal。Portal 是 IP 或 ip_addr:port（如果端口不是默认端口，通常是 TCP 端口 860 和 3260）。

    • iscsi.chapAuthDiscovery (boolean)

      chapAuthDiscovery 定义是否支持 iSCSI 发现 CHAP 身份验证

    • iscsi.chapAuthSession (boolean)

      chapAuthSession 定义是否支持 iSCSI 会话 CHAP 身份验证

    • iscsi.fsType (string)

      fsType 是要挂载的卷的文件系统类型。提示：确保文件系统类型受主机操作系统支持。示例：“ext4”、“xfs”、“ntfs”。如果未指定，则隐式推断为“ext4”。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#iscsi

    • iscsi.initiatorName (string)

      initiatorName 是自定义 iSCSI 发起程序名称。如果 initiatorName 与 iscsiInterface 同时指定，则将为连接创建新的 iSCSI 接口 <目标 Portal>:<卷名称>。

    • iscsi.iscsiInterface (string)

      iscsiInterface 是使用 iSCSI 传输的接口名称。默认为“default”（tcp）。

    • iscsi.portals ([]string)

      portals 是 iSCSI 目标 Portal 列表。Portal 是 IP 或 ip_addr:port（如果端口不是默认端口，通常是 TCP 端口 860 和 3260）。

    • iscsi.readOnly (boolean)

      此处的 readOnly 将强制 VolumeMounts 中的 ReadOnly 设置。默认为 false。

    • iscsi.secretRef (LocalObjectReference)

      secretRef 是用于 iSCSI 目标和发起程序身份验证的 CHAP 密钥

  • nfs (NFSVolumeSource)

    nfs 表示主机上的 NFS 挂载，该挂载共享 Pod 的生命周期 更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs

    表示持续 Pod 生命周期的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新标记。

  • photonPersistentDisk (PhotonPersistentDiskVolumeSource)

    photonPersistentDisk 表示连接到 kubelet 主机的 PhotonController 持久磁盘

    表示 Photon Controller 持久磁盘资源。

    • photonPersistentDisk.pdID (string)，必需

      pdID 是标识 Photon Controller 持久磁盘的 ID

    • photonPersistentDisk.fsType (string)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。如果未指定，则隐式推断为“ext4”。

  • portworxVolume (PortworxVolumeSource)

    portworxVolume 代表一个连接到 kubelets 主机并挂载在其上的 Portworx 卷。

    PortworxVolumeSource 代表一个 Portworx 卷资源。

    • portworxVolume.volumeID (字符串), 必需

      volumeID 唯一标识一个 Portworx 卷。

    • portworxVolume.fsType (字符串)

      fSType 代表要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”。如果未指定，则隐式推断为“ext4”。

    • portworxVolume.readOnly (布尔值)

      readOnly 默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

  • quobyte (QuobyteVolumeSource)

    quobyte 代表主机上与 Pod 生命周期共享的 Quobyte 挂载。

    代表一个与 Pod 生命周期持续的 Quobyte 挂载。Quobyte 卷不支持所有权管理或 SELinux 重新标记。

    • quobyte.registry (字符串), 必需

      registry 代表一个或多个 Quobyte 注册服务，指定为字符串，格式为主机:端口对（多个条目用逗号分隔），充当卷的中央注册中心。

    • quobyte.volume (字符串), 必需

      volume 是一个字符串，引用一个已创建的 Quobyte 卷，通过名称。

    • quobyte.group (字符串)

      将卷访问权限映射到组。默认情况下没有组。

    • quobyte.readOnly (布尔值)

      readOnly 这里将强制 Quobyte 卷以只读权限挂载。默认为 false。

    • quobyte.tenant (字符串)

      拥有后端中给定 Quobyte 卷的租户。与动态配置的 Quobyte 卷一起使用，值由插件设置。

    • quobyte.user (字符串)

      将卷访问权限映射到用户。默认为服务帐户用户。

  • rbd (RBDVolumeSource)

    rbd 代表主机上与 Pod 生命周期共享的 Rados 块设备挂载。更多信息：https://examples.k8s.io/volumes/rbd/README.md

    代表一个与 Pod 生命周期持续的 Rados 块设备挂载。RBD 卷支持所有权管理和 SELinux 重新标记。

  • scaleIO (ScaleIOVolumeSource)

    scaleIO 代表连接到 Kubernetes 节点并挂载在其上的 ScaleIO 持久卷。

    ScaleIOVolumeSource 代表一个持久 ScaleIO 卷

    • scaleIO.gateway (字符串), 必需

      gateway 是 ScaleIO API 网关的主机地址。

    • scaleIO.secretRef (LocalObjectReference), 必需

      secretRef 引用 ScaleIO 用户和其他敏感信息的密钥。如果未提供，则登录操作将失败。

    • scaleIO.system (字符串), 必需

      system 是 ScaleIO 中配置的存储系统的名称。

    • scaleIO.fsType (字符串)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。默认值为“xfs”。

    • scaleIO.protectionDomain (字符串)

      protectionDomain 是为配置的存储配置的 ScaleIO 保护域的名称。

    • scaleIO.readOnly (布尔值)

      readOnly 默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

    • scaleIO.sslEnabled (布尔值)

      sslEnabled 标志启用/禁用与网关的 SSL 通信，默认为 false。

    • scaleIO.storageMode (字符串)

      storageMode 指示卷的存储应该是厚置备还是薄置备。默认值为 ThinProvisioned。

    • scaleIO.storagePool (字符串)

      storagePool 是与保护域关联的 ScaleIO 存储池。

    • scaleIO.volumeName (字符串)

      volumeName 是 ScaleIO 系统中已创建的卷的名称，与该卷源关联。

  • storageos (StorageOSVolumeSource)

    storageOS 代表连接到 Kubernetes 节点并挂载在其上的 StorageOS 卷。

    代表一个 StorageOS 持久卷资源。

    • storageos.fsType (字符串)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。如果未指定，则隐式推断为“ext4”。

    • storageos.readOnly (布尔值)

      readOnly 默认为 false（读写）。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

    • storageos.secretRef (LocalObjectReference)

      secretRef 指定用于获取 StorageOS API 凭据的密钥。如果未指定，将尝试使用默认值。

    • storageos.volumeName (字符串)

      volumeName 是 StorageOS 卷的人类可读名称。卷名称在命名空间内是唯一的。

    • storageos.volumeNamespace (字符串)

      volumeNamespace 指定卷在 StorageOS 中的范围。如果未指定命名空间，则将使用 Pod 的命名空间。这允许 Kubernetes 命名范围在 StorageOS 中镜像，以实现更紧密的集成。将 VolumeName 设置为任何名称以覆盖默认行为。如果您在 StorageOS 中不使用命名空间，则设置为“default”。在 StorageOS 中不存在的命名空间将被创建。

  • vsphereVolume (VsphereVirtualDiskVolumeSource)

    vsphereVolume 代表连接到 kubelets 主机并挂载在其上的 vSphere 卷。

    代表一个 vSphere 卷资源。

    • vsphereVolume.volumePath (字符串), 必需

      volumePath 是标识 vSphere 卷 vmdk 的路径。

    • vsphereVolume.fsType (字符串)

      fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。如果未指定，则隐式推断为“ext4”。

    • vsphereVolume.storagePolicyID (字符串)

      storagePolicyID 是与 StoragePolicyName 关联的基于存储策略的管理 (SPBM) 配置文件 ID。

    • vsphereVolume.storagePolicyName (字符串)

      storagePolicyName 是基于存储策略的管理 (SPBM) 配置文件名称。

已弃用

  • gitRepo (GitRepoVolumeSource)

    gitRepo 代表特定修订版本下的 git 存储库。已弃用：GitRepo 已弃用。要配置包含 git 存储库的容器，请将 EmptyDir 挂载到 InitContainer 中，该容器使用 git 克隆存储库，然后将 EmptyDir 挂载到 Pod 的容器中。

    *代表一个用 git 存储库的内容填充的卷。Git 存储库卷不支持所有权管理。Git 存储库卷支持 SELinux 重新标记。

    已弃用：GitRepo 已弃用。要配置包含 git 存储库的容器，请将 EmptyDir 挂载到 InitContainer 中，该容器使用 git 克隆存储库，然后将 EmptyDir 挂载到 Pod 的容器中。*

    • gitRepo.repository (字符串), 必需

      repository 是 URL。

    • gitRepo.directory (字符串)

      directory 是目标目录名称。不能包含或以“..”开头。如果提供“.”，则卷目录将是 git 存储库。否则，如果指定，则卷将包含在给定名称的子目录中的 git 存储库。

    • gitRepo.revision (字符串)

      revision 是指定修订版本的提交哈希值。

DownwardAPIVolumeFile

DownwardAPIVolumeFile 代表创建包含 Pod 字段的文件的信息。

  • path (字符串), 必需

    必需：path 是要创建的文件的相对路径名。不能是绝对路径或包含“..”路径。必须是 utf-8 编码。相对路径的第一个项目不能以“..”开头。

  • fieldRef (ObjectFieldSelector)

    必需：选择 Pod 的字段：仅支持注释、标签、名称和命名空间。

  • mode (int32)

    可选：用于设置此文件权限的模式位，必须是 0000 到 0777 之间的八进制值，或 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位的十进制值。如果未指定，将使用卷 defaultMode。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

  • resourceFieldRef (ResourceFieldSelector)

    选择容器的资源：目前仅支持资源限制和请求（limits.cpu、limits.memory、requests.cpu 和 requests.memory）。

KeyToPath

将字符串键映射到卷中的路径。

  • key (字符串), 必需

    key 是要投影的键。

  • path (字符串), 必需

    path 是将键映射到的文件的相对路径。不能是绝对路径。不能包含路径元素“..” 。不能以字符串“..”开头。

  • mode (int32)

    mode 是可选的：用于设置此文件权限的模式位。必须是 0000 到 0777 之间的八进制值，或 0 到 511 之间的十进制值。YAML 接受八进制和十进制值，JSON 要求模式位的十进制值。如果未指定，将使用卷 defaultMode。这可能与影响文件模式的其他选项（如 fsGroup）冲突，结果可能是设置了其他模式位。

此页面是自动生成的。

如果您打算报告此页面的问题，请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间为 2023 年 4 月 3 日上午 8:22 PST：API Ref 多页面 v1.27 (7b39e9a9ec)