第 7 章 MachineConfigNode [machineconfiguration.openshift.io/v1alpha1]
- 描述
- MachineConfigNode 描述了系统兼容性级别 4 中的机器健康状况:不提供兼容性,API 可能会因为任何原因而改变。这些功能不应由需要长期支持的应用程序使用。
- 类型
-
object
- 必填
-
spec
-
7.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 | |
|
| spec 描述了机器配置节点的配置。 |
|
| status 描述了此机器配置节点的最后观察到的状态。 |
7.1.1. .spec
- 描述
- spec 描述了机器配置节点的配置。
- 类型
-
object
- 必填
-
configVersion
-
node
-
pool
-
属性 | 类型 | 描述 |
---|---|---|
|
| configVersion 包含此机器配置节点资源的目标节点所需的配置版本。所需的版本代表节点要升级到的机器配置。这会在机器配置 Operator 根据当前机器配置验证新机器配置前设置。 |
|
| 节点包含对此机器配置节点的引用。 |
|
| 池包含此机器配置节点所属机器配置池的引用。 |
7.1.2. .spec.configVersion
- 描述
- configVersion 包含此机器配置节点资源的目标节点所需的配置版本。所需的版本代表节点要升级到的机器配置。这会在机器配置 Operator 根据当前机器配置验证新机器配置前设置。
- 类型
-
object
- 必填
-
所需
-
属性 | 类型 | 描述 |
---|---|---|
|
| 所需是节点应升级到的机器配置名称。当机器配置池生成其渲染配置的新版本时,会设置这个值。当此值改变时,机器配置守护进程会启动节点升级过程。当机器配置被升级时,并在验证前,这个值会在机器配置规格中设置。必须是小写的 RFC-1123 主机名(https://tools.ietf.org/html/rfc1123),它只能包含字母数字字符、连字符(-)和句点(.),且长度最多 253 个字符。 |
7.1.3. .spec.node
- 描述
- 节点包含对此机器配置节点的引用。
- 类型
-
object
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| name 是对象名称。必须是小写的 RFC-1123 主机名(https://tools.ietf.org/html/rfc1123),它只能包含字母数字字符、连字符(-)和句点(.),且长度最多 253 个字符。 |
7.1.4. .spec.pool
- 描述
- 池包含此机器配置节点所属机器配置池的引用。
- 类型
-
object
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| name 是对象名称。必须是小写的 RFC-1123 主机名(https://tools.ietf.org/html/rfc1123),它只能包含字母数字字符、连字符(-)和句点(.),且长度最多 253 个字符。 |
7.1.5. .status
- 描述
- status 描述了此机器配置节点的最后观察到的状态。
- 类型
-
object
- 必填
-
configVersion
-
属性 | 类型 | 描述 |
---|---|---|
|
| 条件代表机器配置节点当前状态的观察。 |
|
|
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如,输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition |
|
| configVersion 描述了此节点的当前和所需的机器配置。当前版本代表节点的当前机器配置,并在成功更新后更新。所需的版本代表节点要升级到的机器配置。此所需的机器配置已与当前的机器配置进行比较,并由机器配置 Operator 验证为有效且存在的。 |
|
| observedGeneration 代表控制器观察到的生成。当控制器观察机器配置节点 spec 中的 configVersion 中的所需Config 更改时,会更新此字段。 |
7.1.6. .status.conditions
- 描述
- 条件代表机器配置节点当前状态的观察。
- 类型
-
array
7.1.7. .status.conditions[]
- 描述
-
条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如,输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition
json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"
// other fields } - 类型
-
object
- 必填
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
| lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知,则使用 API 字段更改的时间是可以接受的。 |
|
| Message 是人类可读的消息,指示有关转换的详细信息。这可能是一个空字符串。 |
|
| observedGeneration 代表 .metadata.generation,这是条件设置所基于的条件。例如,如果 .metadata.generation 目前为 12,但 .status.conditions[x].observedGeneration 是 9,则代表条件与实例的当前状态已不匹配。 |
|
| reason 包含程序标识符,指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义,以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。 |
|
| 条件的状态,True, False, Unknown 之一。 |
|
| CamelCase 或 foo.example.com/CamelCase 中的条件类型。-- Many .condition.type 值在资源间是一致的,但因为任意条件可能很有用(请参阅 .node.status.conditions),deconflict 的能力非常重要。它匹配的正则表达式是 (dns1123SubdomainFmt/)? (qualifiedNameFmt) |
7.1.8. .status.configVersion
- 描述
- configVersion 描述了此节点的当前和所需的机器配置。当前版本代表节点的当前机器配置,并在成功更新后更新。所需的版本代表节点要升级到的机器配置。此所需的机器配置已与当前的机器配置进行比较,并由机器配置 Operator 验证为有效且存在的。
- 类型
-
object
- 必填
-
所需
-
属性 | 类型 | 描述 |
---|---|---|
|
| current 是节点上当前正在使用的机器配置的名称。机器配置守护进程完成节点的配置更新后,会更新这个值。这个值应该与所需的版本匹配,除非升级正在进行。必须是小写的 RFC-1123 主机名(https://tools.ietf.org/html/rfc1123),它只能包含字母数字字符、连字符(-)和句点(.),且长度最多 253 个字符。 |
|
| 所需是节点要升级到的 MachineConfig。当机器配置针对当前机器配置验证后,这个值会在机器配置中设置。必须是小写的 RFC-1123 主机名(https://tools.ietf.org/html/rfc1123),它只能包含字母数字字符、连字符(-)和句点(.),且长度最多 253 个字符。 |