19.9. Subscription [operators.coreos.com/v1alpha1]


描述
订阅通过跟踪目录的更改来保持 operator 最新。
类型
对象
必填
  • metadata
  • spec

19.9.1. 规格

Expand
属性类型描述

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta_v2

标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

SubscriptionSpec 定义了一个可安装的应用程序

status

对象

 

19.9.1.1. .spec

描述
SubscriptionSpec 定义了一个可安装的应用程序
类型
对象
必填
  • name
  • source
  • sourceNamespace
Expand
属性类型描述

channel

字符串

 

config

对象

subscriptionConfig 包含为订阅指定的配置。

installPlanApproval

字符串

approval 是 InstallPlan 的用户批准策略。它必须是"自动"或"Manual"之一。

name

字符串

 

source

字符串

 

sourceNamespace

字符串

 

startingCSV

字符串

 

19.9.1.2. .spec.config

描述
subscriptionConfig 包含为订阅指定的配置。
类型
对象
Expand
属性类型描述

env

array

env 是容器中要设置的环境变量列表。无法更新。

env[]

对象

EnvVar 代表容器中存在的环境变量。

envFrom

array

envFrom 是在容器中填充环境变量的源列表。源中定义的密钥必须是 C_IDENTIFIER。容器启动时,所有无效密钥都会报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。不可变。

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

nodeSelector

对象(字符串)

nodeSelector 是一个选择器,必须为 true 才能使 pod 适合某个节点。选择器必须与节点的标签匹配,以便 pod 调度到该节点上。更多信息: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

资源

对象

资源代表此容器所需的计算资源。不可变。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

selector

对象

selector 是要配置的 pod 的标签选择器。现有由此 pod 选择的 ReplicaSet 将成为受此部署影响的现有 ReplicaSet。它必须与 pod 模板的标签匹配。

容限(tolerations)

array

容限(toleration)是 pod 的容限。

tolerations[]

对象

附加此 Toleration 的 pod,以使用匹配的 operator <operator> 来容许与 triple <key,value,effect> 匹配的任何污点。

volumeMounts

array

要在容器中设置的 VolumeMounts 列表。

volumeMounts[]

对象

VolumeMount 描述了容器内卷的挂载。

array

要在 podSpec 中设置的卷列表。

volumes[]

对象

卷代表 pod 中可以被 pod 中任何容器访问的命名卷。

19.9.1.3. .spec.config.env

描述
env 是容器中要设置的环境变量列表。无法更新。
类型
array

19.9.1.4. .spec.config.env[]

描述
EnvVar 代表容器中存在的环境变量。
类型
对象
必填
  • name
Expand
属性类型描述

name

字符串

环境变量的名称。必须是 C_IDENTIFIER。

value

字符串

变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量,则输入字符串中的引用不会改变。双击单个 $,它允许转义 $(VAR_NAME)语法:例如 " (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会扩展,无论变量是否存在。默认值为 ""。

valueFrom

对象

环境变量值的源。如果值不为空,则无法使用。

19.9.1.5. .spec.config.env[].valueFrom

描述
环境变量值的源。如果值不为空,则无法使用。
类型
对象
Expand
属性类型描述

configMapKeyRef

对象

选择 ConfigMap 的键。

fieldRef

对象

选择 pod 的字段:支持 metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs。

resourceFieldRef

对象

选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。

secretKeyRef

对象

在 pod 命名空间中选择一个 secret 的密钥

19.9.1.6. .spec.config.env[].valueFrom.configMapKeyRef

描述
选择 ConfigMap 的键。
类型
对象
必填
  • key
Expand
属性类型描述

key

字符串

要选择的键。

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 ConfigMap 还是其密钥

19.9.1.7. .spec.config.env[].valueFrom.fieldRef

描述
选择 pod 的字段:支持 metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs。
类型
对象
必填
  • fieldPath
Expand
属性类型描述

apiVersion

字符串

FieldPath 编写的模式版本,默认为 "v1"。

fieldPath

字符串

要在指定 API 版本中选择的字段路径。

19.9.1.8. .spec.config.env[].valueFrom.resourceFieldRef

描述
选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。
类型
对象
必填
  • resource
Expand
属性类型描述

containerName

字符串

容器名称:卷需要,对于 env vars 是可选的

divisor

integer-or-string

指定公开资源的输出格式,默认为 "1"

resource

字符串

必需:要选择的资源

19.9.1.9. .spec.config.env[].valueFrom.secretKeyRef

描述
在 pod 命名空间中选择一个 secret 的密钥
类型
对象
必填
  • key
Expand
属性类型描述

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 Secret 还是其密钥

19.9.1.10. .spec.config.envFrom

描述
envFrom 是在容器中填充环境变量的源列表。源中定义的密钥必须是 C_IDENTIFIER。容器启动时,所有无效密钥都会报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。不可变。
类型
array

19.9.1.11. .spec.config.envFrom[]

描述
EnvFromSource 代表一组 ConfigMap 的源
类型
对象
Expand
属性类型描述

configMapRef

对象

要从中选择的 ConfigMap

prefix

字符串

ConfigMap 中每个键的可选标识符。必须是 C_IDENTIFIER。

secretRef

对象

要从中选择的 Secret

19.9.1.12. .spec.config.envFrom[].configMapRef

描述
要从中选择的 ConfigMap
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 ConfigMap

19.9.1.13. .spec.config.envFrom[].secretRef

描述
要从中选择的 Secret
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 Secret

19.9.1.14. .spec.config.resources

描述
资源代表此容器所需的计算资源。不可变。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
类型
对象
Expand
属性类型描述

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

19.9.1.15. .spec.config.selector

描述
selector 是要配置的 pod 的标签选择器。现有由此 pod 选择的 ReplicaSet 将成为受此部署影响的现有 ReplicaSet。它必须与 pod 模板的标签匹配。
类型
对象
Expand
属性类型描述

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。

matchLabels

对象(字符串)

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。

19.9.1.16. .spec.config.selector.matchExpressions

描述
matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
类型
array

19.9.1.17. .spec.config.selector.matchExpressions[]

描述
标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
类型
对象
必填
  • key
  • operator
Expand
属性类型描述

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

数组(字符串)

值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。

19.9.1.18. .spec.config.tolerations

描述
容限(toleration)是 pod 的容限。
类型
array

19.9.1.19. .spec.config.tolerations[]

描述
附加此 Toleration 的 pod,以使用匹配的 operator <operator> 来容许与 triple <key,value,effect> 匹配的任何污点。
类型
对象
Expand
属性类型描述

effect

字符串

effect 表示污点效果要匹配的污点。空意味着匹配所有污点效果。指定后,允许的值为 NoSchedule、PreferNoSchedule 和 NoExecute。

key

字符串

key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空,运算符必须是 Exists;此组合意味着匹配所有值和所有键。

operator

字符串

运算符表示键与值的关系。有效的运算符为 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符,以便 pod 可以容忍特定类别的所有污点。

tolerationSeconds

整数

tolerationSeconds 代表容限(必须具有 NoExecute effect,否则此字段将被忽略)容许污点的时间周期。默认情况下,它没有被设置,这意味着容许污点(不要驱除)。零值和负值将被视为系统 0 (立即撤离)。

value

字符串

value 是容限匹配的污点值。如果运算符是 Exists,则该值应该为空,否则仅是一个常规字符串。

19.9.1.20. .spec.config.volumeMounts

描述
要在容器中设置的 VolumeMounts 列表。
类型
array

19.9.1.21. .spec.config.volumeMounts[]

描述
VolumeMount 描述了容器内卷的挂载。
类型
对象
必填
  • mountPath
  • name
Expand
属性类型描述

mountPath

字符串

应该挂载卷的容器内的路径。不得包含 ':'。

mountPropagation

字符串

mountPropagation 决定如何将挂载从主机传播到容器,以及传输的其他方式。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。

name

字符串

这必须与卷的名称匹配。

readOnly

布尔值

如果为 true,则以只读形式挂载,否则为读写(false 或未指定)。默认为false。

subPath

字符串

应该从中挂载容器卷的卷内的路径。默认为 "" (卷的 root)。

subPathExpr

字符串

在卷中应该挂载容器的卷的扩展路径。的行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。

19.9.1.22. .spec.config.volumes

描述
要在 podSpec 中设置的卷列表。
类型
array

19.9.1.23. .spec.config.volumes[]

描述
卷代表 pod 中可以被 pod 中任何容器访问的命名卷。
类型
对象
必填
  • name
Expand
属性类型描述

awsElasticBlockStore

对象

awsElasticBlockStore 代表附加到 kubelet 主机机器的 AWS Disk 资源,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

对象

azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。

azureFile

对象

azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。

cephfs

对象

CephFS 代表共享 pod 生命周期的主机上 Ceph FS 挂载

cinder

对象

Cinder 代表在 kubelet 主机上附加并挂载的 cinder 卷。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md

configMap

对象

ConfigMap 代表应该填充这个卷的 configMap

csi

对象

CSI (容器存储接口)代表某些外部 CSI 驱动程序(Beta 功能)处理的临时存储。

downwardAPI

对象

downwardAPI 代表有关应该填充此卷的 pod 的 Downward API

emptyDir

对象

emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

ephemeral

对象

ephemeral 代表由集群存储驱动程序处理的卷。卷的生命周期与定义它的 pod 关联 - 在 pod 启动前会创建,并在 pod 被删除时删除。如果为:只有 pod 运行、如从快照或容量跟踪中恢复等普通卷时,才需要使用这个卷,c)存储驱动程序通过存储类指定,以及 d)存储驱动程序支持通过 PersistentVolumeClaim (请参阅 EphemeralVolumeSource)进行动态卷置备(请参阅 EphemeralVolumeSource 以了解有关此卷类型和 PersistentVolumeClaim 连接的更多信息)。对于保留的时间超过单个 pod 的生命周期,使用 PersistentVolumeClaim 或特定于供应商的 API。如果 CSI 驱动程序旨在以这种方式使用 CSI 驱动程序,请将 CSI 用于轻量级本地临时卷 - 如需更多信息,请参阅驱动程序的文档。pod 可以同时同时使用临时卷和持久性卷。这是一个 beta 功能,只有在启用了 GenericEphemeralVolume 功能门时才可用。

fc

对象

FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。

flexVolume

对象

FlexVolume 代表一个通用卷资源,它使用基于 exec 的插件置备/附加。

flocker

对象

flocker 代表附加到 kubelet 主机的 Flocker 卷。这取决于 Flocker 控制服务正在运行

gcePersistentDisk

对象

gcePersistentDisk 代表一个 GCE Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

gitRepo

对象

gitRepo 代表特定修订版本上的 git 存储库。DEPRECATED: GitRepo 已被弃用。要使用 git 仓库置备容器,请将 EmptyDir 挂载到 InitContainer 中,以使用 git 克隆存储库,然后将 EmptyDir 挂载到 Pod 的容器中。

glusterfs

对象

GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

对象

hostpath 代表主机上直接公开给容器的机器上已存在的文件或目录。这通常用于系统代理或允许查看主机的其他特权操作。大多数容器都不需要此操作。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath ---ö(jonesdl)需要限制谁可以使用主机目录挂载,以及谁可以以读/写形式挂载主机目录。

iscsi

对象

ISCSI 代表附加到 kubelet 主机机器的 ISCSI 磁盘资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md

name

字符串

卷的名称。必须是 pod 中的 DNS_LABEL 和 unique。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

对象

NFS 代表共享 pod 生命周期的主机上的 NFS 挂载: https://kubernetes.io/docs/concepts/storage/volumes#nfs

persistentVolumeClaim

对象

PersistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

photonPersistentDisk

对象

PhotnPersistentDisk 代表附加并挂载到 kubelet 主机上的 PhotonController 持久磁盘

portworxVolume

对象

portworxVolume 代表附加并挂载到 kubelet 主机上的 portworx 卷

projected

对象

在一个资源 secret、configmaps 和 Downward API 中所有的项目

quobyte

对象

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

rbd

对象

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

scaleIO

对象

scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。

secret

对象

Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret

storageos

对象

Storageos 代表在 Kubernetes 节点上附加并挂载的 StorageOS 卷。

vsphereVolume

对象

vsphereVolume 代表附加并挂载到 kubelet 主机上的 vSphere 卷

19.9.1.24. .spec.config.volumes[].awsElasticBlockStore

描述
awsElasticBlockStore 代表附加到 kubelet 主机机器的 AWS Disk 资源,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
类型
对象
必填
  • volumeID
Expand
属性类型描述

fsType

字符串

要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore 114: 如何阻止文件系统中的错误破坏机器

分区

整数

要挂载的卷中的分区。如果省略,则默认由卷名称挂载。示例:对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷快照是"0" (或者您可以将属性留空)。

readOnly

布尔值

指定 "true" 来强制并将 VolumeMounts 中的 ReadOnly 属性设置为 "true"。如果省略,则默认为 "false"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

字符串

AWS (Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

19.9.1.25. .spec.config.volumes[].azureDisk

描述
azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。
类型
对象
必填
  • diskName
  • diskURI
Expand
属性类型描述

cachingMode

字符串

主机缓存模式:无、只读、读写。

diskName

字符串

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

diskURI

字符串

blob 存储中的数据磁盘的 URI

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。

kind

字符串

预期值 Shared: 每个存储帐户 Dedicated 多个 blob 磁盘:每个存储帐户 Managed: azure managed data disk (仅限受管可用性集中)。默认为 shared

readOnly

布尔值

默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

19.9.1.26. .spec.config.volumes[].azureFile

描述
azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。
类型
对象
必填
  • secretName
  • shareName
Expand
属性类型描述

readOnly

布尔值

默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretName

字符串

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

shareName

字符串

共享名称

19.9.1.27. .spec.config.volumes[].cephfs

描述
CephFS 代表共享 pod 生命周期的主机上 Ceph FS 挂载
类型
对象
必填
  • monitor
Expand
属性类型描述

monitor

数组(字符串)

必需: monitor 是 Ceph 监视器更多信息的集合: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

字符串

可选:用作挂载的 root,而不是完整的 Ceph 树,默认为 /

readOnly

布尔值

可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

字符串

可选: SecretFile 是用户密钥环的路径,默认为 /etc/ceph/user.secret more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

对象

可选: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

字符串

可选: User 是 rados 用户名,默认为 admin more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

19.9.1.28. .spec.config.volumes[].cephfs.secretRef

描述
可选: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.29. .spec.config.volumes[].cinder

描述
Cinder 代表在 kubelet 主机上附加并挂载的 cinder 卷。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md
类型
对象
必填
  • volumeID
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

对象

可选:指向包含用于连接 OpenStack 的参数的 secret 对象。

volumeID

字符串

用于识别 cinder 中卷的卷 ID。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md

19.9.1.30. .spec.config.volumes[].cinder.secretRef

描述
可选:指向包含用于连接 OpenStack 的参数的 secret 对象。
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.31. .spec.config.volumes[].configMap

描述
ConfigMap 代表应该填充这个卷的 configMap
类型
对象
Expand
属性类型描述

defaultMode

整数

可选:默认用于创建文件的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

items

array

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

items[]

对象

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

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 ConfigMap 还是其密钥

19.9.1.32. .spec.config.volumes[].configMap.items

描述
如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
类型
array

19.9.1.33. .spec.config.volumes[].configMap.items[]

描述
将字符串键映射到卷内的路径。
类型
对象
必填
  • key
  • path
Expand
属性类型描述

key

字符串

项目的密钥。

模式

整数

可选:用于在此文件上设置权限的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。

19.9.1.34. .spec.config.volumes[].csi

描述
CSI (容器存储接口)代表某些外部 CSI 驱动程序(Beta 功能)处理的临时存储。
类型
对象
必填
  • driver
Expand
属性类型描述

driver

字符串

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

fsType

字符串

要挂载的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果没有提供,空值会被传递给相关的 CSI 驱动程序,该驱动程序将决定要应用的默认文件系统。

nodePublishSecretRef

对象

NodePublishSecretRef 是对包含敏感信息的 secret 对象的引用,用于传递给 CSI 驱动程序来完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果没有 secret,则可能为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。

readOnly

布尔值

为卷指定只读配置。默认为 false (读/写)。

volumeAttributes

对象(字符串)

volumeAttributes 存储传递给 CSI 驱动程序的特定于驱动程序的属性。如需支持的值,请参考您的驱动程序文档。

19.9.1.35. .spec.config.volumes[].csi.nodePublishSecretRef

描述
NodePublishSecretRef 是对包含敏感信息的 secret 对象的引用,用于传递给 CSI 驱动程序来完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果没有 secret,则可能为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.36. .spec.config.volumes[].downwardAPI

描述
downwardAPI 代表有关应该填充此卷的 pod 的 Downward API
类型
对象
Expand
属性类型描述

defaultMode

整数

可选:默认在创建的文件中使用模式位。必须是可选:用于设置创建文件的权限的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

items

array

items 是 Downward API 卷文件列表

items[]

对象

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

19.9.1.37. .spec.config.volumes[].downwardAPI.items

描述
items 是 Downward API 卷文件列表
类型
array

19.9.1.38. .spec.config.volumes[].downwardAPI.items[]

描述
DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
类型
对象
必填
  • path
Expand
属性类型描述

fieldRef

对象

必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。

模式

整数

可选:用于在此文件上设置权限的模式位,必须是 0000 到 0777 之间的数值,也可以是 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

必需:path 是要创建的文件的相对路径名称。不得是绝对的,或包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不得以 '.' 开头

resourceFieldRef

对象

选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。

描述
必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。
类型
对象
必填
  • fieldPath
Expand
属性类型描述

apiVersion

字符串

FieldPath 编写的模式版本,默认为 "v1"。

fieldPath

字符串

要在指定 API 版本中选择的字段路径。

描述
选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。
类型
对象
必填
  • resource
Expand
属性类型描述

containerName

字符串

容器名称:卷需要,对于 env vars 是可选的

divisor

integer-or-string

指定公开资源的输出格式,默认为 "1"

resource

字符串

必需:要选择的资源

19.9.1.41. .spec.config.volumes[].emptyDir

描述
emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
类型
对象
Expand
属性类型描述

字符串

哪个类型的存储介质应该支持此目录。默认值为 "",这意味着使用节点的默认介质。必须是空字符串(默认)或内存。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

integer-or-string

此 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存介质 EmptyDir 的最大使用量是此处指定的 SizeLimit 和 pod 中所有容器的总和之间的最小值。默认值为 nil,这意味着限制未定义。更多信息: http://kubernetes.io/docs/user-guide/volumes#emptydir

19.9.1.42. .spec.config.volumes[].ephemeral

描述
ephemeral 代表由集群存储驱动程序处理的卷。卷的生命周期与定义它的 pod 关联 - 在 pod 启动前会创建,并在 pod 被删除时删除。如果为:只有 pod 运行、如从快照或容量跟踪中恢复等普通卷时,才需要使用这个卷,c)存储驱动程序通过存储类指定,以及 d)存储驱动程序支持通过 PersistentVolumeClaim (请参阅 EphemeralVolumeSource)进行动态卷置备(请参阅 EphemeralVolumeSource 以了解有关此卷类型和 PersistentVolumeClaim 连接的更多信息)。对于保留的时间超过单个 pod 的生命周期,使用 PersistentVolumeClaim 或特定于供应商的 API。如果 CSI 驱动程序旨在以这种方式使用 CSI 驱动程序,请将 CSI 用于轻量级本地临时卷 - 如需更多信息,请参阅驱动程序的文档。pod 可以同时同时使用临时卷和持久性卷。这是一个 beta 功能,只有在启用了 GenericEphemeralVolume 功能门时才可用。
类型
对象
Expand
属性类型描述

volumeClaimTemplate

对象

将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,例如 PVC 将与 pod 一起删除。PVC 的名称将是 < pod name>-<volume name>,其中 <volume name> 是 PodSpec.Volumes 数组条目的名称。如果串联的名称对 PVC 无效(例如,太长),则 Pod 验证将拒绝 pod。具有 pod 不属于该名称的现有 PVC 将 不会用于 pod,以避免错误地使用不相关的卷。启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用预先创建的 PVC,则 PVC 必须在 pod 存在后使用所有者引用来更新。通常,这不应该是必需的,但在手动重建有问题的集群时可能很有用。此字段是只读的,在创建后不会对 PVC 进行任何更改。必需,不能是 nil。

描述
将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,例如 PVC 将与 pod 一起删除。PVC 的名称将是 < pod name>-<volume name>,其中 <volume name> 是 PodSpec.Volumes 数组条目的名称。如果串联的名称对 PVC 无效(例如,太长),则 Pod 验证将拒绝 pod。具有 pod 不属于该名称的现有 PVC 将 不会用于 pod,以避免错误地使用不相关的卷。启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用预先创建的 PVC,则 PVC 必须在 pod 存在后使用所有者引用来更新。通常,这不应该是必需的,但在手动重建有问题的集群时可能很有用。此字段是只读的,在创建后不会对 PVC 进行任何更改。必需,不能是 nil。
类型
对象
必填
  • spec
Expand
属性类型描述

metadata

对象

可能包含在创建 PVC 时将复制到 PVC 中的标签和注解。不允许其他字段,并在验证过程中被拒绝。

spec

对象

PersistentVolumeClaim 的规格。整个内容保持不变到从该模板创建的 PVC 中。与 PersistentVolumeClaim 中相同的字段也有效。

描述
可能包含在创建 PVC 时将复制到 PVC 中的标签和注解。不允许其他字段,并在验证过程中被拒绝。
类型
对象
描述
PersistentVolumeClaim 的规格。整个内容保持不变到从该模板创建的 PVC 中。与 PersistentVolumeClaim 中相同的字段也有效。
类型
对象
Expand
属性类型描述

accessModes

数组(字符串)

accessModes 包含卷应具有所需的访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

对象

此字段可以用来指定现有 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot) VirtualMachine An existing PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将根据指定数据源的内容创建新卷。如果启用了 AnyVolumeDataSource 功能门,此字段始终与 DataSourceRef 字段相同。

dataSourceRef

对象

如果需要非空卷,请指定卷使用数据填充的对象。这可以是非空 API 组(非内核对象)或 PersistentVolumeClaim 对象的任何本地对象。当指定此字段时,只有在指定对象类型与某些已安装的卷填充器或动态置备程序匹配时,卷绑定才会成功。此字段将替换 DataSource 字段的功能,如果两个字段都为空,它们必须具有相同的值。为向后兼容,如果其中一个字段为空且另一个为空,则字段(DataSource 和 DataSourceRef)将自动设置为相同的值。DataSource 和 DataSourceRef 有两个重要区别:ChSource While DataSource 只允许两种类型的对象,DataSourceRef 允许任何非核心对象和 PersistentVolumeClaim 对象。在 DataSource 时会忽略禁止的值(dropping 值),DataSourceRef 保留所有值,并在指定了 disallowed 值时生成错误。(示例)使用此字段需要启用 AnyVolumeDataSource 功能门。

资源

对象

resources 代表卷应具有的最小资源。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

对象

要考虑绑定的卷的标签查询。

storageClassName

字符串

声明所需的 StorageClass 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

字符串

volumeMode 定义声明需要哪些卷类型。如果没有包含在 claim spec 中,则 Filesystem 的值会被表示。

volumeName

字符串

volumeName 是支持此声明的 PersistentVolume 的绑定引用。

描述
此字段可以用来指定现有 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot) VirtualMachine An existing PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将根据指定数据源的内容创建新卷。如果启用了 AnyVolumeDataSource 功能门,此字段始终与 DataSourceRef 字段相同。
类型
对象
必填
  • kind
  • name
Expand
属性类型描述

apiGroup

字符串

apigroup 是被引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

描述
如果需要非空卷,请指定卷使用数据填充的对象。这可以是非空 API 组(非内核对象)或 PersistentVolumeClaim 对象的任何本地对象。当指定此字段时,只有在指定对象类型与某些已安装的卷填充器或动态置备程序匹配时,卷绑定才会成功。此字段将替换 DataSource 字段的功能,如果两个字段都为空,它们必须具有相同的值。为向后兼容,如果其中一个字段为空且另一个为空,则字段(DataSource 和 DataSourceRef)将自动设置为相同的值。DataSource 和 DataSourceRef 有两个重要区别:ChSource While DataSource 只允许两种类型的对象,DataSourceRef 允许任何非核心对象和 PersistentVolumeClaim 对象。在 DataSource 时会忽略禁止的值(dropping 值),DataSourceRef 保留所有值,并在指定了 disallowed 值时生成错误。(示例)使用此字段需要启用 AnyVolumeDataSource 功能门。
类型
对象
必填
  • kind
  • name
Expand
属性类型描述

apiGroup

字符串

apigroup 是被引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

描述
resources 代表卷应具有的最小资源。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
类型
对象
Expand
属性类型描述

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

描述
要考虑绑定的卷的标签查询。
类型
对象
Expand
属性类型描述

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。

matchLabels

对象(字符串)

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。

描述
matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
类型
array
描述
标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
类型
对象
必填
  • key
  • operator
Expand
属性类型描述

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

数组(字符串)

值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。

19.9.1.52. .spec.config.volumes[].fc

描述
FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。
类型
对象
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。ado: 如何防止文件系统中的错误破坏机器

lun

整数

可选: FC 目标 lun 号

readOnly

布尔值

可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

targetWWNs

数组(字符串)

可选: FC 目标全球名称(WWN)

wwids

数组(字符串)

可选: FC 卷全局识别符(wwids) Either wwids 或 targetWWN 和 lun 的组合都必须被设置,但不能同时设置。

19.9.1.53. .spec.config.volumes[].flexVolume

描述
FlexVolume 代表一个通用卷资源,它使用基于 exec 的插件置备/附加。
类型
对象
必填
  • driver
Expand
属性类型描述

driver

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。

options

对象(字符串)

可选:额外的命令选项(若有)。

readOnly

布尔值

可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

可选: SecretRef 引用包含要传递给插件脚本的敏感信息的 secret 对象。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。

19.9.1.54. .spec.config.volumes[].flexVolume.secretRef

描述
可选: SecretRef 引用包含要传递给插件脚本的敏感信息的 secret 对象。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.55. .spec.config.volumes[].flocker

描述
flocker 代表附加到 kubelet 主机的 Flocker 卷。这取决于 Flocker 控制服务正在运行
类型
对象
Expand
属性类型描述

datasetName

字符串

在 Flocker 的 dataset 上作为 metadata name 存储的数据的名称应被视为已弃用

datasetUUID

字符串

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

19.9.1.56. .spec.config.volumes[].gcePersistentDisk

描述
gcePersistentDisk 代表一个 GCE Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
类型
对象
必填
  • pdName
Expand
属性类型描述

fsType

字符串

要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk 114: 如何阻止文件系统中的错误破坏机器

分区

整数

要挂载的卷中的分区。如果省略,则默认由卷名称挂载。示例:对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷快照是"0" (或者您可以将属性留空)。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

字符串

GCE 中 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

布尔值

此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

19.9.1.57. .spec.config.volumes[].gitRepo

描述
gitRepo 代表特定修订版本上的 git 存储库。DEPRECATED: GitRepo 已被弃用。要使用 git 仓库置备容器,请将 EmptyDir 挂载到 InitContainer 中,以使用 git 克隆存储库,然后将 EmptyDir 挂载到 Pod 的容器中。
类型
对象
必填
  • 软件仓库
Expand
属性类型描述

目录

字符串

目标目录名称。不得包含或以 '.' 开头。如果提供了 '.',则卷目录将是 git 存储库。否则,卷将在具有指定名称的子目录中包含 git 存储库。

软件仓库

字符串

仓库 URL

revision

字符串

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

19.9.1.58. .spec.config.volumes[].glusterfs

描述
GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md
类型
对象
必填
  • 端点
  • path
Expand
属性类型描述

端点

字符串

endpointName 是详细说明 Glusterfs 拓扑的端点名称。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

字符串

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

19.9.1.59. .spec.config.volumes[].hostPath

描述
hostpath 代表主机上直接公开给容器的机器上已存在的文件或目录。这通常用于系统代理或允许查看主机的其他特权操作。大多数容器都不需要此操作。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath ---ö(jonesdl)需要限制谁可以使用主机目录挂载,以及谁可以以读/写形式挂载主机目录。
类型
对象
必填
  • path
Expand
属性类型描述

path

字符串

主机上目录的路径。如果路径是符号链接,它将遵循到实际路径的链接。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

字符串

HostPath Volume Defaults 为 "" more information: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

19.9.1.60. .spec.config.volumes[].iscsi

描述
ISCSI 代表附加到 kubelet 主机机器的 ISCSI 磁盘资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md
类型
对象
必填
  • iqn
  • lun
  • targetPortal
Expand
属性类型描述

chapAuthDiscovery

布尔值

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

chapAuthSession

布尔值

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

fsType

字符串

要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#iscsi 114: 如何阻止文件系统中的错误破坏机器

initiatorName

字符串

自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName,则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

iqn

字符串

目标 iSCSI 限定名称。

iscsiInterface

字符串

使用 iSCSI 传输的 iSCSI 接口名称。默认为 'default'(tcp)。

lun

整数

iSCSI 目标 Lun 号。

门户

数组(字符串)

iSCSI 目标门户列表.如果端口不是默认端口(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。

readOnly

布尔值

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

secretRef

对象

用于 iSCSI 目标和发起方身份验证的 CHAP Secret

targetPortal

字符串

iSCSI 目标门户.如果端口不是默认端口(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。

19.9.1.61. .spec.config.volumes[].iscsi.secretRef

描述
用于 iSCSI 目标和发起方身份验证的 CHAP Secret
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.62. .spec.config.volumes[].nfs

描述
NFS 代表共享 pod 生命周期的主机上的 NFS 挂载: https://kubernetes.io/docs/concepts/storage/volumes#nfs
类型
对象
必填
  • path
  • server
Expand
属性类型描述

path

字符串

NFS 服务器导出的路径。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

布尔值

此处的只读将强制使用只读权限挂载 NFS 导出。默认为false。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

字符串

server 是 NFS 服务器的主机名或 IP 地址。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs

19.9.1.63. .spec.config.volumes[].persistentVolumeClaim

描述
PersistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
类型
对象
必填
  • claimName
Expand
属性类型描述

claimName

字符串

claimName 是与使用此卷的 pod 相同的命名空间中的 PersistentVolumeClaim 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

布尔值

将强制 VolumeMount 中的 ReadOnly 设置。默认 false。

19.9.1.64. .spec.config.volumes[].photonPersistentDisk

描述
PhotnPersistentDisk 代表附加并挂载到 kubelet 主机上的 PhotonController 持久磁盘
类型
对象
必填
  • pdID
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。

pdID

字符串

标识 Photon Controller 持久磁盘的 ID

19.9.1.65. .spec.config.volumes[].portworxVolume

描述
portworxVolume 代表附加并挂载到 kubelet 主机上的 portworx 卷
类型
对象
必填
  • volumeID
Expand
属性类型描述

fsType

字符串

fstype 代表要挂载 Must 的文件系统类型,是主机操作系统支持的文件系统类型。EX. "ext4", "xfs"。如果未指定,则隐式推断为"ext4"。

readOnly

布尔值

默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

volumeID

字符串

VolumeId 唯一标识 Portworx 卷

19.9.1.66. .spec.config.volumes[].projected

描述
在一个资源 secret、configmaps 和 Downward API 中所有的项目
类型
对象
Expand
属性类型描述

defaultMode

整数

默认用于创建文件的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

sources

array

卷投射列表

sources[]

对象

可以投射与其他支持的卷类型进行投射

19.9.1.67. .spec.config.volumes[].projected.sources

描述
卷投射列表
类型
array

19.9.1.68. .spec.config.volumes[].projected.sources[]

描述
可以投射与其他支持的卷类型进行投射
类型
对象
Expand
属性类型描述

configMap

对象

有关项目的 configMap 数据的信息

downwardAPI

对象

有关项目 downwardAPI 数据的信息

secret

对象

有关项目 secret 数据的信息

serviceAccountToken

对象

有关项目的 serviceAccountToken 数据的信息

描述
有关项目的 configMap 数据的信息
类型
对象
Expand
属性类型描述

items

array

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

items[]

对象

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

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 ConfigMap 还是其密钥

描述
如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
类型
array
描述
将字符串键映射到卷内的路径。
类型
对象
必填
  • key
  • path
Expand
属性类型描述

key

字符串

项目的密钥。

模式

整数

可选:用于在此文件上设置权限的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。

描述
有关项目 downwardAPI 数据的信息
类型
对象
Expand
属性类型描述

items

array

items 是 DownwardAPIVolume 文件的列表

items[]

对象

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

描述
items 是 DownwardAPIVolume 文件的列表
类型
array
描述
DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
类型
对象
必填
  • path
Expand
属性类型描述

fieldRef

对象

必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。

模式

整数

可选:用于在此文件上设置权限的模式位,必须是 0000 到 0777 之间的数值,也可以是 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

必需:path 是要创建的文件的相对路径名称。不得是绝对的,或包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不得以 '.' 开头

resourceFieldRef

对象

选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。

描述
必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。
类型
对象
必填
  • fieldPath
Expand
属性类型描述

apiVersion

字符串

FieldPath 编写的模式版本,默认为 "v1"。

fieldPath

字符串

要在指定 API 版本中选择的字段路径。

描述
选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。
类型
对象
必填
  • resource
Expand
属性类型描述

containerName

字符串

容器名称:卷需要,对于 env vars 是可选的

divisor

integer-or-string

指定公开资源的输出格式,默认为 "1"

resource

字符串

必需:要选择的资源

描述
有关项目 secret 数据的信息
类型
对象
Expand
属性类型描述

items

array

如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。

items[]

对象

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

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

optional

布尔值

指定是否必须定义 Secret 还是其密钥

描述
如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
类型
array
描述
将字符串键映射到卷内的路径。
类型
对象
必填
  • key
  • path
Expand
属性类型描述

key

字符串

项目的密钥。

模式

整数

可选:用于在此文件上设置权限的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。

描述
有关项目的 serviceAccountToken 数据的信息
类型
对象
必填
  • path
Expand
属性类型描述

Audience

字符串

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

expirationSeconds

整数

ExpirationSeconds 是服务帐户令牌的有效持续时间。当令牌方法过期时,kubelet 卷插件会主动轮转服务帐户令牌。如果令牌存在的时间超过这个值的 80%,或者超过 24 小时,则 kubelet 将开始尝试轮转令牌,且必须至少 10 分钟。

path

字符串

path 是相对于文件挂载点的路径,用于将令牌项目到其中。

19.9.1.81. .spec.config.volumes[].quobyte

描述
quobyte 代表共享 pod 生命周期的主机上的 Quobyte 挂载
类型
对象
必填
  • registry
Expand
属性类型描述

group

字符串

将卷访问映射到 Default 的组

readOnly

布尔值

此处的只读将强制使用只读权限挂载 Quobyte 卷。默认为false。

registry

字符串

registry 代表单个或多个 Quobyte Registry 服务,指定为 host:port 对(多个条目用逗号分开),它充当卷的中央 registry

tenant

字符串

在带有动态置备的 Quobyte 卷的后端中拥有给定 Quobyte 卷的租户,值由插件设置

user

字符串

将卷访问权限映射到 Defaults 到 serivceaccount 用户

字符串

卷是一个字符串,它按名称引用已创建 Quobyte 卷。

19.9.1.82. .spec.config.volumes[].rbd

描述
rbd 代表共享 pod 生命周期的主机上 Rados 块设备挂载。更多信息: https://examples.k8s.io/volumes/rbd/README.md
类型
对象
必填
  • image
  • monitor
Expand
属性类型描述

fsType

字符串

要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#rbd 114: 如何阻止文件系统中的错误破坏机器

image

字符串

rados 镜像名称。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

keyring

字符串

keyring 是 RBDUser 的密钥环的路径。默认为 /etc/ceph/keyring。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

monitor

数组(字符串)

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

布尔值

此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

对象

secretRef 是 RBDUser 的身份验证 secret 的名称。如果提供覆盖密钥环,则提供。默认为 nil。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

user

字符串

rados 用户名。默认为 admin。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

19.9.1.83. .spec.config.volumes[].rbd.secretRef

描述
secretRef 是 RBDUser 的身份验证 secret 的名称。如果提供覆盖密钥环,则提供。默认为 nil。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.84. .spec.config.volumes[].scaleIO

描述
scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。
类型
对象
必填
  • gateway
  • secretRef
  • system
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认为 "xfs"。

gateway

字符串

ScaleIO API 网关的主机地址。

protectionDomain

字符串

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

readOnly

布尔值

默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

secretRef 引用 ScaleIO 用户和其他敏感信息的机密。如果没有提供此功能,则登录操作将失败。

sslEnabled

布尔值

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

storageMode

字符串

指明卷的存储是否应是 ThickProvisioned 或 ThinProvisioned。默认为 ThinProvisioned。

storagePool

字符串

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

system

字符串

存储系统的名称,如 ScaleIO 中配置的。

volumeName

字符串

已在与这个卷源关联的 ScaleIO 系统中创建的卷名称。

19.9.1.85. .spec.config.volumes[].scaleIO.secretRef

描述
secretRef 引用 ScaleIO 用户和其他敏感信息的机密。如果没有提供此功能,则登录操作将失败。
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.86. .spec.config.volumes[].secret

描述
Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret
类型
对象
Expand
属性类型描述

defaultMode

整数

可选:默认用于创建文件的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

items

array

如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。

items[]

对象

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

optional

布尔值

指定是否必须定义 Secret 还是其密钥

secretName

字符串

要使用的 pod 命名空间中的 secret 名称。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret

19.9.1.87. .spec.config.volumes[].secret.items

描述
如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
类型
array

19.9.1.88. .spec.config.volumes[].secret.items[]

描述
将字符串键映射到卷内的路径。
类型
对象
必填
  • key
  • path
Expand
属性类型描述

key

字符串

项目的密钥。

模式

整数

可选:用于在此文件上设置权限的模式位。必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值,JSON 需要十进制值用于模式位。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。

path

字符串

要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。

19.9.1.89. .spec.config.volumes[].storageos

描述
Storageos 代表在 Kubernetes 节点上附加并挂载的 StorageOS 卷。
类型
对象
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。

readOnly

布尔值

默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。

volumeName

字符串

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

volumeNamespace

字符串

VolumeNamespace 指定 StorageOS 中的卷范围。如果没有指定命名空间,则使用 Pod 的命名空间。这允许 Kubernetes 名称范围在 StorageOS 中进行镜像,以便更好地集成。将 VolumeName 设置为任何名称来覆盖默认行为。如果没有在 StorageOS 中使用命名空间,则设置为 "default"。将创建没有在 StorageOS 中预先存在的命名空间。

19.9.1.90. .spec.config.volumes[].storageos.secretRef

描述
secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。
类型
对象
Expand
属性类型描述

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid?

19.9.1.91. .spec.config.volumes[].vsphereVolume

描述
vsphereVolume 代表附加并挂载到 kubelet 主机上的 vSphere 卷
类型
对象
必填
  • volumePath
Expand
属性类型描述

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。

storagePolicyID

字符串

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

storagePolicyName

字符串

基于存储策略的管理(SPBM)配置集名称。

volumePath

字符串

标识 vSphere 卷 vmdk 的路径

19.9.1.92. .status

描述
类型
对象
必填
  • lastUpdated
Expand
属性类型描述

catalogHealth

array

catalogHealth 包含其相关 CatalogSource 状态的订阅视图。它用于确定与 CatalogSources 相关的 SubscriptionStatusConditions。

catalogHealth[]

对象

SubscriptionCatalogHealth 描述了 Subscription 所知的 CatalogSource 的健康状况。

conditions

array

条件是有关订阅当前状态的最新可用观察列表。

conditions[]

对象

SubscriptionCondition 代表订阅状态的最新可用影响。

currentCSV

字符串

currentCSV 是订阅正在进入的 CSV。

installPlanGeneration

整数

InstallPlanGeneration 是安装计划的当前生成

installPlanRef

对象

installPlanRef 是对包含订阅当前 CSV 的最新 InstallPlan 的引用。

installedCSV

字符串

InstalledCSV 是订阅当前安装的 CSV。

InstallPlan

对象

安装是对为订阅生成的最新 InstallPlan 的引用。DEPRECATED: InstallPlanRef

lastUpdated

字符串

lastUpdated 代表订阅状态更新最后一次的时间。

reason

字符串

原因是订阅转换为当前状态的原因。

state

字符串

State 代表订阅的当前状态

19.9.1.93. .status.catalogHealth

描述
catalogHealth 包含其相关 CatalogSource 状态的订阅视图。它用于确定与 CatalogSources 相关的 SubscriptionStatusConditions。
类型
array

19.9.1.94. .status.catalogHealth[]

描述
SubscriptionCatalogHealth 描述了 Subscription 所知的 CatalogSource 的健康状况。
类型
对象
必填
  • catalogSourceRef
  • healthy
  • lastUpdated
Expand
属性类型描述

catalogSourceRef

对象

catalogSourceRef 是 CatalogSource 的引用。

healthy

布尔值

如果 CatalogSource 处于健康状态,则为 true;否则为 false。

lastUpdated

字符串

lastUpdated 代表 CatalogSourceHealth 最后一次更改的时间

19.9.1.95. .status.catalogHealth[].catalogSourceRef

描述
catalogSourceRef 是 CatalogSource 的引用。
类型
对象
Expand
属性类型描述

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象,则该字符串应包含有效的 JSON/Go 字段访问声明,如 desiredState.manifest.containers[2]。例如,如果对象引用是一个 pod 中的容器,它应该还以下类似: "spec.containers{name}"(其中 "name" 是指触发事件的容器的名称),如果不使用容器名称,则应类似于 "spec.containers[2]"(使用此 pod 中索引值为 2 的容器)。选择这个语法的原因是,为了有一些指向对象部分的正确定义方法。Todo: 这个设计不是最终设计的,且该字段在将来会有所改变。

kind

字符串

引用的类型。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

指定构成这个引用的 resourceVersion(如果存在)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

19.9.1.96. .status.conditions

描述
条件是有关订阅当前状态的最新可用观察列表。
类型
array

19.9.1.97. .status.conditions[]

描述
SubscriptionCondition 代表订阅状态的最新可用影响。
类型
对象
必填
  • status
  • type
Expand
属性类型描述

lastHeartbeatTime

字符串

LastHeartbeatTime 是我们最后一次对给定条件进行更新的时间

lastTransitionTime

字符串

lastTransitionTime 是条件从一个状态传输到另一个状态最后一次的时间

message

字符串

Message 是人类可读的消息,指示最后一次转换的详细信息。

reason

字符串

原因是条件最后一次转换的一次性 CamelCase 原因。

status

字符串

status 是条件的状态,True, False, Unknown 之一。

type

字符串

type 是 Subscription 条件的类型。

19.9.1.98. .status.installPlanRef

描述
installPlanRef 是对包含订阅当前 CSV 的最新 InstallPlan 的引用。
类型
对象
Expand
属性类型描述

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象,则该字符串应包含有效的 JSON/Go 字段访问声明,如 desiredState.manifest.containers[2]。例如,如果对象引用是一个 pod 中的容器,它应该还以下类似: "spec.containers{name}"(其中 "name" 是指触发事件的容器的名称),如果不使用容器名称,则应类似于 "spec.containers[2]"(使用此 pod 中索引值为 2 的容器)。选择这个语法的原因是,为了有一些指向对象部分的正确定义方法。Todo: 这个设计不是最终设计的,且该字段在将来会有所改变。

kind

字符串

引用的类型。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

指定构成这个引用的 resourceVersion(如果存在)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

19.9.1.99. .status.installplan

描述
安装是对为订阅生成的最新 InstallPlan 的引用。DEPRECATED: InstallPlanRef
类型
对象
必填
  • apiVersion
  • kind
  • name
  • uuid
Expand
属性类型描述

apiVersion

字符串

 

kind

字符串

 

name

字符串

 

uuid

字符串

UID 是包含唯一 ID 值的类型,包括 UUID。因为我们不仅仅是使用 UUID,因此这是字符串的别名。作为一个类型捕获目的,有助于确保 UID 和名称不会被混淆。

19.9.2. API 端点

可用的 API 端点如下:

  • /apis/operators.coreos.com/v1alpha1/subscriptions

    • GET: 列出 Subscription 类型的对象
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions

    • DELETE :删除订阅的集合
    • GET: 列出 Subscription 类型的对象
    • POST :创建一个订阅
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}

    • DELETE :删除订阅
    • GET :读取指定的订阅
    • PATCH :部分更新指定的订阅
    • PUT :替换指定的订阅
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}/status

    • GET: 指定订阅的读取状态
    • PATCH :部分更新指定订阅的状态
    • PUT: 替换指定订阅的状态

19.9.2.1. /apis/operators.coreos.com/v1alpha1/subscriptions

Expand
表 19.212. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
列出 Subscription 类型的对象
Expand
表 19.213. HTTP 响应
HTTP 代码响应正文

200 - OK

SubscriptionList 模式

401 - Unauthorized

Expand
表 19.214. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 19.215. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除订阅集合
Expand
表 19.216. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 19.217. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
列出 Subscription 类型的对象
Expand
表 19.218. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 19.219. HTTP 响应
HTTP 代码响应正文

200 - OK

SubscriptionList 模式

401 - Unauthorized

HTTP 方法
POST
描述
创建订阅
Expand
表 19.220. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 19.221. 主体参数
参数类型描述

正文(body)

Subscription 模式

 
Expand
表 19.222. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

201 - Created

Subscription 模式

202 - Accepted

Subscription 模式

401 - Unauthorized

Expand
表 19.223. 全局路径参数
参数类型描述

name

字符串

订阅的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 19.224. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除订阅
Expand
表 19.225. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand
表 19.226. 主体参数
参数类型描述

正文(body)

DeleteOptions_v2 schema

 
Expand
表 19.227. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

202 - Accepted

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
阅读指定的订阅
Expand
表 19.228. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 19.229. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
部分更新指定的订阅
Expand
表 19.230. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 19.231. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 19.232. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定的订阅
Expand
表 19.233. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 19.234. 主体参数
参数类型描述

正文(body)

Subscription 模式

 
Expand
表 19.235. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

201 - Created

Subscription 模式

401 - Unauthorized

Expand
表 19.236. 全局路径参数
参数类型描述

name

字符串

订阅的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 19.237. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定订阅的读取状态
Expand
表 19.238. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 19.239. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定订阅的部分更新状态
Expand
表 19.240. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 19.241. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 19.242. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定订阅的状态
Expand
表 19.243. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 19.244. 主体参数
参数类型描述

正文(body)

Subscription 模式

 
Expand
表 19.245. HTTP 响应
HTTP 代码响应正文

200 - OK

Subscription 模式

201 - Created

Subscription 模式

401 - Unauthorized

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat