第 3 章 ControllerConfig [machineconfiguration.openshift.io/v1]
- 描述
- ControllerConfig 描述了 MachineConfigController 的配置。目前仅用于驱动 TemplateController 生成的 MachineConfig 对象。兼容性级别 1:在主发行版本中至少提供 12 个月或 3 个次版本(以更长的时间为准)。
- 类型
-
object
- 必填
-
spec
-
3.1. 规格
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: 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 | |
|
| ControllerConfigSpec 是 ControllerConfig 资源的 spec。 |
|
| ControllerConfigStatus 是 ControllerConfig 的状态 |
3.1.1. .spec
- 描述
- ControllerConfigSpec 是 ControllerConfig 资源的 spec。
- 类型
-
object
- 必填
-
baseOSContainerImage
-
cloudProviderConfig
-
clusterDNSIP
-
images
-
ipFamilies
-
kubeAPIServerServingCAData
-
releaseImage
-
rootCAData
-
属性 | 类型 | 描述 |
---|---|---|
| `` | additionalTrustBundle 是一个证书捆绑包,将添加到节点可信证书存储中。 |
|
| BaseOSContainerImage 是用于操作系统更新的 new-format 容器镜像。 |
|
| BaseOSExtensionsContainerImage 是 new-format 容器匹配的 extensions 容器 |
| `` | cloudprovider 指定云供应商 CA 数据 |
|
| cloudProviderConfig 是给定云供应商的配置 |
|
| clusterDNSIP 是集群 DNS IP 地址 |
|
| DNS 包含集群 dns 详情 |
|
| etcdDiscoveryDomain 已被弃用,使用 Infra.Status.EtcdDiscoveryDomain |
|
| imageRegistryBundleData 是 ImageRegistryData |
|
| ImageRegistryBundle 包含编写镜像 registry 证书的信息 |
|
| imageRegistryBundleUserData 是用户提供的 Image Registry 数据 |
|
| ImageRegistryBundle 包含编写镜像 registry 证书的信息 |
|
| 镜像是控制器用来在 ./templates/ 下呈现模板的镜像映射 |
|
| infra 包含基础架构详情 |
| `` | internalRegistryPullSecret 是内部 registry 的 pull secret,供 rpm-ostree 用于从内部 registry 拉取镜像(如果存在) |
|
| ipFamilies 表示集群网络使用的 IP 系列 |
|
| kubeAPIServerServingCAData managed Kubelet to API Server Cert… Rotated |
| `` | 网络包含额外网络相关信息 |
|
| NetworkType 包含集群的网络类型使用 XXX:这是临时的,并尽快丢弃,而是更好地支持以正确方式启动网络相关服务。nobody 也在集群首次启动并第一次运行时更改此设置,因此如果此更改,则不会重新生成。 |
|
| osImageURL 是包含操作系统更新有效负载的旧格式容器镜像。 |
|
| 平台已弃用,改为使用 Infra.Status.PlatformStatus.Type |
| `` | 代理包含节点的当前代理配置 |
|
| pullSecret 是所有机器上需要安装的默认 pull secret。 |
|
| releaseImage 是安装集群时使用的镜像 |
|
| rootCAData 指定 root CA 数据 |
3.1.2. .spec.dns
- 描述
- DNS 包含集群 dns 详情
- 类型
-
object
- 必填
-
spec
-
kind
-
apiVersion
-
属性 | 类型 | 描述 |
---|---|---|
|
| apiVersion 定义对象的这个表示法的版本化模式。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象的类型。采用驼峰拼写法 (CamelCase)。更多信息: 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 |
3.1.3. .spec.imageRegistryBundleData
- 描述
- imageRegistryBundleData 是 ImageRegistryData
- 类型
-
数组
3.1.4. .spec.imageRegistryBundleData[]
- 描述
- ImageRegistryBundle 包含编写镜像 registry 证书的信息
- 类型
-
object
- 必填
-
data
-
file
-
属性 | 类型 | 描述 |
---|---|---|
|
| data 包含要写入文件位置的捆绑包的内容 |
|
| file 包含将捆绑包写入磁盘的文件的名称 |
3.1.5. .spec.imageRegistryBundleUserData
- 描述
- imageRegistryBundleUserData 是用户提供的 Image Registry 数据
- 类型
-
数组
3.1.6. .spec.imageRegistryBundleUserData[]
- 描述
- ImageRegistryBundle 包含编写镜像 registry 证书的信息
- 类型
-
object
- 必填
-
data
-
file
-
属性 | 类型 | 描述 |
---|---|---|
|
| data 包含要写入文件位置的捆绑包的内容 |
|
| file 包含将捆绑包写入磁盘的文件的名称 |
3.1.7. .spec.infra
- 描述
- infra 包含基础架构详情
- 类型
-
object
- 必填
-
spec
-
kind
-
apiVersion
-
属性 | 类型 | 描述 |
---|---|---|
|
| apiVersion 定义对象的这个表示法的版本化模式。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象的类型。采用驼峰拼写法 (CamelCase)。更多信息: 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 |
3.1.8. .spec.pullSecret
- 描述
- pullSecret 是所有机器上需要安装的默认 pull secret。
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的 API 版本。 |
|
| 如果引用的是对象的一部分而非整个对象,则该字符串应包含有效的 JSON/Go 字段访问声明,如 desiredState.manifest.containers[2]。例如,如果对象引用是一个 pod 中的容器,它应该还以下类似: "spec.containers{name}"(其中 "name" 是指触发事件的容器的名称),如果不使用容器名称,则应类似于 "spec.containers[2]"(使用此 pod 中索引值为 2 的容器)。选择这个语法的原因是,为了有一些指向对象部分的正确定义方法。Todo: 这个设计不是最终设计的,且该字段在将来会有所改变。 |
|
| 引用的类型。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 引用的命名空间。更多信息: https://kubernetes.io/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.io/docs/concepts/overview/working-with-objects/names/#uids |
3.1.9. .status
- 描述
- ControllerConfigStatus 是 ControllerConfig 的状态
- 类型
-
object
属性 | 类型 | 描述 |
---|---|---|
|
| 条件代表当前状态的最新可用影响。 |
|
| ControllerConfigStatusCondition 包含 ControllerConfigStatus 的条件信息 |
|
| controllerCertificates 代表 MCO 中自动轮转证书的最新可用影响。 |
|
| ControllerCertificate 包含有关特定证书的信息。 |
|
| observedGeneration 代表控制器观察到的生成。 |
3.1.10. .status.conditions
- 描述
- 条件代表当前状态的最新可用影响。
- 类型
-
array
3.1.11. .status.conditions[]
- 描述
- ControllerConfigStatusCondition 包含 ControllerConfigStatus 的条件信息
- 类型
-
object
- 必填
-
status
-
type
-
属性 | 类型 | 描述 |
---|---|---|
| `` | lastTransitionTime 是当前状态对象最后一次更新的时间。 |
|
| Message 提供有关当前条件的附加信息。这只能被人类使用。 |
|
| reason 是条件最后一次转换的原因。原因为 PascalCase |
|
| 条件的状态,True, False, Unknown 之一。 |
|
| type 指定 Operator 协调功能的状态。 |
3.1.12. .status.controllerCertificates
- 描述
- controllerCertificates 代表 MCO 中自动轮转证书的最新可用影响。
- 类型
-
数组
3.1.13. .status.controllerCertificates[]
- 描述
- ControllerCertificate 包含有关特定证书的信息。
- 类型
-
object
- 必填
-
bundleFile
-
signer
-
subject
-
属性 | 类型 | 描述 |
---|---|---|
|
| bundleFile 是证书来自更大的捆绑包 |
|
| notAfter 是有效期的上限 |
|
| NotBefore 是有效性的低边界 |
|
| 签名者是证书发行者 |
|
| 主题是证书主题 |