第 21 章 MachineConfiguration [operator.openshift.io/v1]

failedRevisionLimit

整数

failedRevisionLimit 是要保留在磁盘上的失败静态 pod 安装程序修订的数量，在 api -1 = unlimited, 0 或 unset = 5 (default)

forceRedeploymentReason

字符串

forceRedeploymentReason 可用于通过提供唯一字符串来强制重新部署操作对象。这提供了一种机制来启动之前失败的部署，并提供一个原因，您认为它将在此时间工作，而不是在同一配置中再次失败。

logLevel

字符串

Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。

managedBootImages

object

managedBootImages 允许为集群中的机器资源配置引导镜像。此配置允许用户在集群安装过程中选择应更新为最新引导镜像的资源，确保新机器始终使用当前集群版本的引导镜像引导。如果省略，则不会更新引导镜像。

managementState

字符串

managementState 指明 Operator 是否应该管理组件

nodeDisruptionPolicy

object

nodeDisruptionPolicy 允许管理员为基于 MachineConfig 的更新（如排空、服务重新加载等）设置粒度节点中断操作。在对集群进行小的配置更新时，指定这将可以缩短停机时间。此配置对集群升级没有影响，这些升级仍将在需要时造成节点中断。

observedConfig

``

observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入

operatorLogLevel

字符串

operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。

succeededRevisionLimit

整数

succeededRevisionLimit 是要在磁盘上保留的成功静态 pod 安装程序修订的数量，在 api -1 = unlimited, 0 或 unset = 5 (default)

unsupportedConfigOverrides

``

unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。

machineManagers

数组

machineManager 可用于注册机器管理资源以进行引导镜像更新。Machine Config Operator 将监视此列表的更改。每个机器管理资源都只允许一个条目。

machineManagers[]

object

MachineManager 描述了注册用于引导镜像更新的目标机器资源。它存储标识信息，如资源类型和资源的 API 组。它还通过选择字段提供精细的控制。

apiGroup

string

APIGroup 是机器管理资源所属的 APIGroup 的名称。当前的有效值为 machine.openshift.io. machine.openshift.io，机器管理器将仅注册属于 OpenShift 机器 API 组的资源。

resource

string

resource 是机器管理资源的类型。当前的有效值为 machinesets. machinesets，这意味着机器管理器将只注册类型为 MachineSet 的资源。

选择

object

选择可以精细控制将注册用于引导镜像更新的机器管理资源。

模式

string

模式决定了如何为更新选择机器管理器。有效值为 All 和 Partial。all 表示与机器管理器匹配的每个资源都会被更新。部分需要指定选择器，并允许自定义与机器管理器匹配的资源。

partial

object

部分提供可用于匹配机器管理资源的标签选择器。仅在将 mode 设置为"Partial"时允许。

machineResourceSelector

object

machineResourceSelector 是一个标签选择器，可用于选择 MachineSets 等机器资源。

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

files

数组

文件是 MachineConfig 文件定义列表，以及对这些路径的更改执行的操作列表。

files[]

object

NodeDisruptionPolicySpecFile 是一个文件条目，以及要执行的操作，并在 NodeDisruptionPolicyConfig 对象中使用

sshkey

object

sshKey 映射到 MachineConfig 对象中的 ignition.sshkeys 字段，为此定义一个操作将应用到集群中的所有 sshkey 更改

units

数组

unit 是 MachineConfig 单元定义列表，以及对这些服务的更改执行的操作。此列表支持最多 50 个条目。

units[]

object

NodeDisruptionPolicySpecUnit 是一个 systemd 单元名称和相应的操作，用于 NodeDisruptionPolicyConfig 对象

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

path

string

path 是通过 MachineConfig 管理的文件的位置。策略中的 Actions 将应用到此路径上的文件更改。

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicySpecActionType 为 Reboot, Drain, Reload, Restart, DaemonReload 和 None. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicySpecActionType 为 Reboot, Drain, Reload, Restart, DaemonReload 和 None. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

名称

string

name 代表通过指定的 MachineConfig Actions 管理的 systemd 服务的服务名称。服务名称的格式应为 ${NAME}${SERVICETYPE}，最多可包括 255 个字符。${NAME} 必须为最早的 1 个字符，且只能包含字母、数字、":"、"-"、"_"、"_"、""." 和 "\". ${SERVICETYPE} 必须是 ".service" 之一，".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicySpecActionType 为 Reboot, Drain, Reload, Restart, DaemonReload 和 None. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

conditions

array

conditions 是条件及其状态列表

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 }

nodeDisruptionPolicyStatus

object

nodeDisruptionPolicyStatus 状态反映了最新的 cluster-validated 策略，并将供 Machine Config Daemon 在将来的节点更新过程中使用。

observedGeneration

整数

observedGeneration 是您处理的最后生成更改

lastTransitionTime

字符串

lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知，则使用 API 字段更改的时间是可以接受的。

message

字符串

Message 是人类可读的消息，指示有关转换的详细信息。这可能是一个空字符串。

observedGeneration

整数

observedGeneration 代表 .metadata.generation，这是条件设置所基于的条件。例如，如果 .metadata.generation 目前为 12，但 .status.conditions[x].observedGeneration 是 9，则代表条件与实例的当前状态已不匹配。

reason

字符串

reason 包含程序标识符，指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义，以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。

status

字符串

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

type

字符串

CamelCase 或 foo.example.com/CamelCase 中的条件类型。-- Many .condition.type 值在资源间是一致的，但因为任意条件可能很有用（请参阅 .node.status.conditions），deconflict 的能力非常重要。它匹配的正则表达式是 (dns1123SubdomainFmt/)? (qualifiedNameFmt)

clusterPolicies

object

ClusterPolicies 是集群默认和用户提供的节点中断策略合并。

files

数组

文件是 MachineConfig 文件定义列表，以及对这些路径进行修改的操作

files[]

object

NodeDisruptionPolicyStatusFile 是一个文件条目，以及要执行的操作，用于 NodeDisruptionPolicyClusterStatus 对象

sshkey

object

sshKey 是整个 sshkey MachineConfig 定义

units

数组

unit 是 MachineConfig 单元定义列表，以及对这些服务的更改执行的操作

units[]

object

NodeDisruptionPolicyStatusUnit 是一个 systemd 单元名称和相应的操作，用于 NodeDisruptionPolicyClusterStatus 对象

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

path

string

path 是通过 MachineConfig 管理的文件的位置。策略中的 Actions 将应用到此路径上的文件更改。

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicyStatusActionType is executed Valid 值为 Reboot, Drain, Reload, Restart, DaemonReload, None 和 Special. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicyStatusActionType is executed Valid 值为 Reboot, Drain, Reload, Restart, DaemonReload, None 和 Special. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

操作

数组

actions 代表要在相应文件路径中更改文件而要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果同时需要重启的更新中的其他 MachineConfig 条目有其他传入的更改，则重启会监管这些操作。有效操作包括 Reboot, Drain, Reload, DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表支持最多 10 个条目。

actions[]

object

名称

string

name 代表通过指定的 MachineConfig Actions 管理的 systemd 服务的服务名称。服务名称的格式应为 ${NAME}${SERVICETYPE}，最多可包括 255 个字符。${NAME} 必须为最早的 1 个字符，且只能包含字母、数字、":"、"-"、"_"、"_"、""." 和 "\". ${SERVICETYPE} 必须是 ".service" 之一，".socket", ".device", ".mount", ".automount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

reload

object

reload 指定要重新加载的服务，只有在类型被重新载入时才有效

restart

object

restart 指定要重启的服务，只有在类型重启时有效

type

string

Type 代表执行此 NodeDisruptionPolicyStatusActionType is executed Valid 值为 Reboot, Drain, Reload, Restart, DaemonReload, None 和 Special. reload/restart 的命令，则需要在 reload/restart 字段中指定对应的服务目标。其他值不需要进一步配置

serviceName

string

serviceName 是要重新加载的服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。

serviceName

string

serviceName 是要重启服务名称的全名（如 crio.service），其格式为 ${NAME}${SERVICETYPE}，最多可包含 255 个字符。${NAME} 长度长度为 1 个字符，且只能由字母、数字、":"、"-"、"_" 组成。".", 和 "\". ${SERVICETYPE} 必须是 ".service", ".socket", ".device", ".mount", ".swap", ".target", ".path", ".timer", ".snapshot", ".slice" 或 ".scope"。