×
描述

MachineConfiguration 提供信息来配置一个操作符以管理机器配置。兼容性级别 1:在主要版本中稳定至少 12 个月或 3 个次要版本(以较长者为准)。

类型

对象

必需
  • spec

规范

属性 类型 描述

apiVersion

字符串

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

kind

字符串

Kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不可更新。使用驼峰式命名法。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

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

spec

对象

spec 是机器配置操作符所需行为的规范

status

对象

status 是机器配置操作符最近观察到的状态

.spec

描述

spec 是机器配置操作符所需行为的规范

类型

对象

属性 类型 描述

failedRevisionLimit

整数

failedRevisionLimit 是要保留在磁盘和 api 上的失败静态 pod 安装程序修订版数量 -1 = 无限,0 或未设置 = 5(默认)

forceRedeploymentReason

字符串

forceRedeploymentReason 可用于通过提供唯一的字符串来强制重新部署操作数。这提供了一种机制来启动之前失败的部署,并说明为什么您认为这次会成功,而不是在相同的配置上再次失败。

logLevel

字符串

logLevel 是基于意图的整体组件日志记录。它不提供细粒度的控制,但它是一种简单的方法来管理操作符必须为其操作数解释的粗粒度日志记录选择。有效值为:“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。

managedBootImages

对象

managedBootImages 允许配置集群中机器资源的引导映像管理。此配置允许用户选择在集群升级期间应更新为最新引导映像的资源,确保新机器始终使用当前集群版本的引导映像启动。省略时,不会更新任何引导映像。

managementState

字符串

managementState 指示操作符是否以及如何管理组件

nodeDisruptionPolicy

对象

nodeDisruptionPolicy 允许管理员为基于 MachineConfig 的更新设置细粒度的节点中断操作,例如 drain、服务重新加载等。指定此项可以在对集群进行小型配置更新时减少停机时间。此配置对集群升级没有影响,集群升级仍然会在需要时造成节点中断。

observedConfig

``

observedConfig 包含控制器从集群状态观察到的稀疏配置。它存在于 spec 中,因为它是对操作符级别的输入

operatorLogLevel

字符串

operatorLogLevel 是操作符本身的基于意图的日志记录。它不提供细粒度的控制,但它是一种简单的方法来管理操作符必须为自己解释的粗粒度日志记录选择。有效值为:“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。

succeededRevisionLimit

整数

succeededRevisionLimit 是要保留在磁盘和 api 上的成功静态 pod 安装程序修订版数量 -1 = 无限,0 或未设置 = 5(默认)

unsupportedConfigOverrides

``

unsupportedConfigOverrides 覆盖由操作符计算的最终配置。Red Hat 不支持使用此字段。误用此字段可能导致意外行为或与其他配置选项冲突。在使用此字段之前,请寻求 Red Hat 支持的指导。使用此属性会阻止集群升级,必须在升级集群之前将其删除。

.spec.managedBootImages

描述

managedBootImages 允许配置集群中机器资源的引导映像管理。此配置允许用户选择在集群升级期间应更新为最新引导映像的资源,确保新机器始终使用当前集群版本的引导映像启动。省略时,不会更新任何引导映像。

类型

对象

属性 类型 描述

machineManagers

数组

machineManagers 可用于注册用于引导映像更新的机器管理资源。机器配置操作符将监视此列表的变化。每种类型的机器管理资源只允许一个条目。

machineManagers[]

对象

MachineManager 描述一个为引导映像更新注册的目标机器资源。它存储标识信息,例如资源类型和资源的 API 组。它还通过选择字段提供细粒度控制。

.spec.managedBootImages.machineManagers

描述

machineManagers 可用于注册用于引导映像更新的机器管理资源。机器配置操作符将监视此列表的变化。每种类型的机器管理资源只允许一个条目。

类型

数组

.spec.managedBootImages.machineManagers[]

描述

MachineManager 描述一个为引导映像更新注册的目标机器资源。它存储标识信息,例如资源类型和资源的 API 组。它还通过选择字段提供细粒度控制。

类型

对象

必需
  • apiGroup

  • 资源

  • 选择

属性 类型 描述

apiGroup

字符串

apiGroup 是机器管理资源所属的 APIGroup 的名称。当前唯一有效的值是 machine.openshift.io。machine.openshift.io 表示机器管理器将只注册属于 OpenShift 机器 API 组的资源。

资源

字符串

resource 是机器管理资源的类型。当前唯一有效的值是 machinesets。machinesets 表示机器管理器将只注册 kind 为 MachineSet 的资源。

选择

对象

selection 允许对将注册用于引导映像更新的机器管理资源进行细粒度控制。

.spec.managedBootImages.machineManagers[].selection

描述

selection 允许对将注册用于引导映像更新的机器管理资源进行细粒度控制。

类型

对象

必需
  • mode

属性 类型 描述

mode

字符串

mode 确定如何选择机器管理器进行更新。有效值为 All 和 Partial。All 表示将更新机器管理器匹配的每个资源。Partial 需要指定的 selector(s),并允许自定义将更新哪些机器管理器匹配的资源。

partial

对象

partial 提供可用于匹配机器管理资源的标签选择器(s)。仅当 mode 设置为“Partial”时才允许。

.spec.managedBootImages.machineManagers[].selection.partial

描述

partial 提供可用于匹配机器管理资源的标签选择器(s)。仅当 mode 设置为“Partial”时才允许。

类型

对象

必需
  • machineResourceSelector

属性 类型 描述

machineResourceSelector

对象

machineResourceSelector 是一个标签选择器,可用于选择诸如 MachineSet 之类的机器资源。

.spec.managedBootImages.machineManagers[].selection.partial.machineResourceSelector

描述

machineResourceSelector 是一个标签选择器,可用于选择诸如 MachineSet 之类的机器资源。

类型

对象

属性 类型 描述

matchExpressions

数组

matchExpressions 是标签选择器要求的列表。这些要求是 ANDed 的。

matchExpressions[]

对象

标签选择器要求是一个包含值、键和将键和值关联起来的操作符的选择器。

matchLabels

对象(字符串)

matchLabels 是 {key,value} 对的映射。matchLabels 映射中的单个 {key,value} 等效于 matchExpressions 的一个元素,其 key 字段为“key”,操作符为“In”,而 values 数组仅包含“value”。这些要求是 ANDed 的。

.spec.managedBootImages.machineManagers[].selection.partial.machineResourceSelector.matchExpressions

描述

matchExpressions 是标签选择器要求的列表。这些要求是 ANDed 的。

类型

数组

.spec.managedBootImages.machineManagers[].selection.partial.machineResourceSelector.matchExpressions[]

描述

标签选择器要求是一个包含值、键和将键和值关联起来的操作符的选择器。

类型

对象

必需
  • key

  • operator

属性 类型 描述

key

字符串

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

operator

字符串

operator 表示键与一组值的关系。有效操作符为 In、NotIn、Exists 和 DoesNotExist。

values

数组(字符串)

values 是字符串值的数组。如果操作符是 In 或 NotIn,则 values 数组必须非空。如果操作符是 Exists 或 DoesNotExist,则 values 数组必须为空。此数组在策略性合并补丁期间会被替换。

.spec.nodeDisruptionPolicy

描述

nodeDisruptionPolicy 允许管理员为基于 MachineConfig 的更新设置细粒度的节点中断操作,例如 drain、服务重新加载等。指定此项可以在对集群进行小型配置更新时减少停机时间。此配置对集群升级没有影响,集群升级仍然会在需要时造成节点中断。

类型

对象

属性 类型 描述

文件

数组

files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。此列表最多支持 50 个条目。

files[]

对象

NodeDisruptionPolicySpecFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。

sshkey

对象

sshkey 映射到 MachineConfig 对象中的 ignition.sshkeys 字段,对此的定义和操作将应用于集群中的所有 sshkey 更改。

units

数组

units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。此列表最多支持 50 个条目。

units[]

对象

NodeDisruptionPolicySpecUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。

.spec.nodeDisruptionPolicy.files

描述

files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。此列表最多支持 50 个条目。

类型

数组

.spec.nodeDisruptionPolicy.files[]

描述

NodeDisruptionPolicySpecFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。

类型

对象

必需
  • actions

  • path

属性 类型 描述

actions

数组

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

actions[]

对象

path

字符串

path 是通过 MachineConfig 管理的文件的位置。策略中的操作将应用于此路径下文件的更改。

.spec.nodeDisruptionPolicy.files[].actions

描述

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

类型

数组

.spec.nodeDisruptionPolicy.files[].actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。

.spec.nodeDisruptionPolicy.files[].actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.files[].actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.sshkey

描述

sshkey 映射到 MachineConfig 对象中的 ignition.sshkeys 字段,对此的定义和操作将应用于集群中的所有 sshkey 更改。

类型

对象

必需
  • actions

属性 类型 描述

actions

数组

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

actions[]

对象

.spec.nodeDisruptionPolicy.sshkey.actions

描述

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

类型

数组

.spec.nodeDisruptionPolicy.sshkey.actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。

.spec.nodeDisruptionPolicy.sshkey.actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.sshkey.actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.units

描述

units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。此列表最多支持 50 个条目。

类型

数组

.spec.nodeDisruptionPolicy.units[]

描述

NodeDisruptionPolicySpecUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。

类型

对象

必需
  • actions

  • name

属性 类型 描述

actions

数组

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

actions[]

对象

name

字符串

name 表示通过 MachineConfig 管理的 systemd 服务的服务名称。将为指定名称的服务更改应用指定的操作。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.units[].actions

描述

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

类型

数组

.spec.nodeDisruptionPolicy.units[].actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。

.spec.nodeDisruptionPolicy.units[].actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.spec.nodeDisruptionPolicy.units[].actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status

描述

status 是机器配置操作符最近观察到的状态

类型

对象

属性 类型 描述

conditions

数组

conditions 是条件及其状态的列表。

conditions[]

对象

Condition 包含此 API 资源当前状态的一个方面的详细信息。--- 此结构旨在直接用作字段路径 .status.conditions 中的数组。例如,类型 FooStatus struct{ // 表示 foo 当前状态的观察结果。 // 已知的 .status.conditions.type 为:“Available”、“Progressing”和“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" // 其他字段 }

nodeDisruptionPolicyStatus

对象

nodeDisruptionPolicyStatus 状态反映最新的集群验证策略,将在未来的节点更新期间由 Machine Config Daemon 使用。

observedGeneration

整数

observedGeneration 是您处理的最后一代更改。

.status.conditions

描述

conditions 是条件及其状态的列表。

类型

数组

.status.conditions[]

描述

Condition 包含此 API 资源当前状态的一个方面的详细信息。--- 此结构旨在直接用作字段路径 .status.conditions 中的数组。例如,类型 FooStatus struct{ // 表示 foo 当前状态的观察结果。 // 已知的 .status.conditions.type 为:“Available”、“Progressing”和“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" // 其他字段 }

类型

对象

必需
  • lastTransitionTime

  • message

  • reason

  • status

  • type

属性 类型 描述

lastTransitionTime

字符串

lastTransitionTime 是条件从一种状态转换到另一种状态的最后时间。这应该是底层条件发生变化的时间。如果不知道,则可以使用 API 字段更改的时间。

message

字符串

message 是一个易于理解的消息,指示有关转换的详细信息。这可能是空字符串。

observedGeneration

整数

observedGeneration 表示基于其设置条件的 .metadata.generation。例如,如果 .metadata.generation 当前为 12,但 .status.conditions[x].observedGeneration 为 9,则该条件相对于实例的当前状态已过期。

reason

字符串

reason 包含一个编程标识符,指示条件最后转换的原因。特定条件类型的生产者可以为此字段定义预期的值和含义,以及是否将这些值视为保证的 API。该值应为驼峰式字符串。此字段不能为空。

status

字符串

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

type

字符串

条件的类型,驼峰式或 foo.example.com/CamelCase。--- 许多 .condition.type 值在资源(如 Available)中是一致的,但由于任意条件可能很有用(参见 .node.status.conditions),因此取消冲突的能力非常重要。它匹配的正则表达式为 (dns1123SubdomainFmt/)?(qualifiedNameFmt)

.status.nodeDisruptionPolicyStatus

描述

nodeDisruptionPolicyStatus 状态反映最新的集群验证策略,将在未来的节点更新期间由 Machine Config Daemon 使用。

类型

对象

属性 类型 描述

clusterPolicies

对象

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

.status.nodeDisruptionPolicyStatus.clusterPolicies

描述

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

类型

对象

属性 类型 描述

文件

数组

files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。

files[]

对象

NodeDisruptionPolicyStatusFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。

sshkey

对象

sshkey 是整体 sshkey MachineConfig 定义。

units

数组

units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。

units[]

对象

NodeDisruptionPolicyStatusUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。

.status.nodeDisruptionPolicyStatus.clusterPolicies.files

描述

files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。

类型

数组

.status.nodeDisruptionPolicyStatus.clusterPolicies.files[]

描述

NodeDisruptionPolicyStatusFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。

类型

对象

必需
  • actions

  • path

属性 类型 描述

actions

数组

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

actions[]

对象

path

字符串

path 是通过 MachineConfig 管理的文件的位置。策略中的操作将应用于此路径下文件的更改。

.status.nodeDisruptionPolicyStatus.clusterPolicies.files[].actions

描述

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

类型

数组

.status.nodeDisruptionPolicyStatus.clusterPolicies.files[].actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。

.status.nodeDisruptionPolicyStatus.clusterPolicies.files[].actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.files[].actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.sshkey

描述

sshkey 是整体 sshkey MachineConfig 定义。

类型

对象

必需
  • actions

属性 类型 描述

actions

数组

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

actions[]

对象

.status.nodeDisruptionPolicyStatus.clusterPolicies.sshkey.actions

描述

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

类型

数组

.status.nodeDisruptionPolicyStatus.clusterPolicies.sshkey.actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。

.status.nodeDisruptionPolicyStatus.clusterPolicies.sshkey.actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.sshkey.actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.units

描述

units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。

类型

数组

.status.nodeDisruptionPolicyStatus.clusterPolicies.units[]

描述

NodeDisruptionPolicyStatusUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。

类型

对象

必需
  • actions

  • name

属性 类型 描述

actions

数组

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

actions[]

对象

name

字符串

name 表示通过 MachineConfig 管理的 systemd 服务的服务名称。将为指定名称的服务更改应用指定的操作。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.units[].actions

描述

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

类型

数组

.status.nodeDisruptionPolicyStatus.clusterPolicies.units[].actions[]

描述
类型

对象

必需
  • type

属性 类型 描述

reload

对象

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

restart

对象

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

type

字符串

type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。

.status.nodeDisruptionPolicyStatus.clusterPolicies.units[].actions[].reload

描述

reload 指定要重新加载的服务,仅在 type 为 reload 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

.status.nodeDisruptionPolicyStatus.clusterPolicies.units[].actions[].restart

描述

restart 指定要重新启动的服务,仅在 type 为 restart 时有效。

类型

对象

必需
  • serviceName

属性 类型 描述

serviceName

字符串

serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。

API 端点

以下 API 端点可用:

  • /apis/operator.openshift.io/v1/machineconfigurations

    • DELETE: 删除 MachineConfiguration 集合

    • GET: 列出 MachineConfiguration 对象

    • POST: 创建 MachineConfiguration

  • /apis/operator.openshift.io/v1/machineconfigurations/{name}

    • DELETE: 删除 MachineConfiguration

    • GET: 读取指定的 MachineConfiguration

    • PATCH: 部分更新指定的 MachineConfiguration

    • PUT: 替换指定的 MachineConfiguration

  • /apis/operator.openshift.io/v1/machineconfigurations/{name}/status

    • GET: 读取指定 MachineConfiguration 的状态

    • PATCH: 部分更新指定 MachineConfiguration 的状态

    • PUT: 替换指定 MachineConfiguration 的状态

/apis/operator.openshift.io/v1/machineconfigurations

HTTP 方法

DELETE

描述

删除 MachineConfiguration 集合

表 1. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

401 - 未授权

HTTP 方法

GET

描述

列出 MachineConfiguration 对象

表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfigurationList 模式

401 - 未授权

HTTP 方法

POST

描述

创建 MachineConfiguration

表 3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。

表 4. 请求体参数
参数 类型 描述

body

MachineConfiguration 模式

表 5. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

201 - 已创建

MachineConfiguration 模式

202 - 已接受

MachineConfiguration 模式

401 - 未授权

/apis/operator.openshift.io/v1/machineconfigurations/{name}

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

name

字符串

MachineConfiguration 的名称

HTTP 方法

DELETE

描述

删除 MachineConfiguration

表 7. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 8. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

HTTP 方法

GET

描述

读取指定的 MachineConfiguration

表 9. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 MachineConfiguration

表 10. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。

表 11. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 MachineConfiguration

表 12. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。

表 13. 请求体参数
参数 类型 描述

body

MachineConfiguration 模式

表 14. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

201 - 已创建

MachineConfiguration 模式

401 - 未授权

/apis/operator.openshift.io/v1/machineconfigurations/{name}/status

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

name

字符串

MachineConfiguration 的名称

HTTP 方法

GET

描述

读取指定 MachineConfiguration 的状态

表 16. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定 MachineConfiguration 的状态

表 17. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。

表 18. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定 MachineConfiguration 的状态

表 19. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。

表 20. 请求体参数
参数 类型 描述

body

MachineConfiguration 模式

表 21. HTTP 响应
HTTP 代码 响应体

200 - OK

MachineConfiguration 模式

201 - 已创建

MachineConfiguration 模式

401 - 未授权