MachineConfiguration 提供信息来配置一个操作符以管理机器配置。兼容性级别 1:在主要版本中稳定至少 12 个月或 3 个次要版本(以较长者为准)。
MachineConfiguration 提供信息来配置一个操作符以管理机器配置。兼容性级别 1:在主要版本中稳定至少 12 个月或 3 个次要版本(以较长者为准)。
对象
spec
属性 | 类型 | 描述 |
---|---|---|
|
|
APIVersion 定义此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
Kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不可更新。使用驼峰式命名法。更多信息: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 是机器配置操作符最近观察到的状态 |
spec 是机器配置操作符所需行为的规范
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
failedRevisionLimit 是要保留在磁盘和 api 上的失败静态 pod 安装程序修订版数量 -1 = 无限,0 或未设置 = 5(默认) |
|
|
forceRedeploymentReason 可用于通过提供唯一的字符串来强制重新部署操作数。这提供了一种机制来启动之前失败的部署,并说明为什么您认为这次会成功,而不是在相同的配置上再次失败。 |
|
|
logLevel 是基于意图的整体组件日志记录。它不提供细粒度的控制,但它是一种简单的方法来管理操作符必须为其操作数解释的粗粒度日志记录选择。有效值为:“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。 |
|
|
managedBootImages 允许配置集群中机器资源的引导映像管理。此配置允许用户选择在集群升级期间应更新为最新引导映像的资源,确保新机器始终使用当前集群版本的引导映像启动。省略时,不会更新任何引导映像。 |
|
|
managementState 指示操作符是否以及如何管理组件 |
|
|
nodeDisruptionPolicy 允许管理员为基于 MachineConfig 的更新设置细粒度的节点中断操作,例如 drain、服务重新加载等。指定此项可以在对集群进行小型配置更新时减少停机时间。此配置对集群升级没有影响,集群升级仍然会在需要时造成节点中断。 |
|
`` |
observedConfig 包含控制器从集群状态观察到的稀疏配置。它存在于 spec 中,因为它是对操作符级别的输入 |
|
|
operatorLogLevel 是操作符本身的基于意图的日志记录。它不提供细粒度的控制,但它是一种简单的方法来管理操作符必须为自己解释的粗粒度日志记录选择。有效值为:“Normal”、“Debug”、“Trace”、“TraceAll”。默认为“Normal”。 |
|
|
succeededRevisionLimit 是要保留在磁盘和 api 上的成功静态 pod 安装程序修订版数量 -1 = 无限,0 或未设置 = 5(默认) |
|
`` |
unsupportedConfigOverrides 覆盖由操作符计算的最终配置。Red Hat 不支持使用此字段。误用此字段可能导致意外行为或与其他配置选项冲突。在使用此字段之前,请寻求 Red Hat 支持的指导。使用此属性会阻止集群升级,必须在升级集群之前将其删除。 |
managedBootImages 允许配置集群中机器资源的引导映像管理。此配置允许用户选择在集群升级期间应更新为最新引导映像的资源,确保新机器始终使用当前集群版本的引导映像启动。省略时,不会更新任何引导映像。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
machineManagers 可用于注册用于引导映像更新的机器管理资源。机器配置操作符将监视此列表的变化。每种类型的机器管理资源只允许一个条目。 |
|
|
MachineManager 描述一个为引导映像更新注册的目标机器资源。它存储标识信息,例如资源类型和资源的 API 组。它还通过选择字段提供细粒度控制。 |
machineManagers 可用于注册用于引导映像更新的机器管理资源。机器配置操作符将监视此列表的变化。每种类型的机器管理资源只允许一个条目。
数组
MachineManager 描述一个为引导映像更新注册的目标机器资源。它存储标识信息,例如资源类型和资源的 API 组。它还通过选择字段提供细粒度控制。
对象
apiGroup
资源
选择
属性 | 类型 | 描述 |
---|---|---|
|
|
apiGroup 是机器管理资源所属的 APIGroup 的名称。当前唯一有效的值是 machine.openshift.io。machine.openshift.io 表示机器管理器将只注册属于 OpenShift 机器 API 组的资源。 |
|
|
resource 是机器管理资源的类型。当前唯一有效的值是 machinesets。machinesets 表示机器管理器将只注册 kind 为 MachineSet 的资源。 |
|
|
selection 允许对将注册用于引导映像更新的机器管理资源进行细粒度控制。 |
selection 允许对将注册用于引导映像更新的机器管理资源进行细粒度控制。
对象
mode
属性 | 类型 | 描述 |
---|---|---|
|
|
mode 确定如何选择机器管理器进行更新。有效值为 All 和 Partial。All 表示将更新机器管理器匹配的每个资源。Partial 需要指定的 selector(s),并允许自定义将更新哪些机器管理器匹配的资源。 |
|
|
partial 提供可用于匹配机器管理资源的标签选择器(s)。仅当 mode 设置为“Partial”时才允许。 |
partial 提供可用于匹配机器管理资源的标签选择器(s)。仅当 mode 设置为“Partial”时才允许。
对象
machineResourceSelector
属性 | 类型 | 描述 |
---|---|---|
|
|
machineResourceSelector 是一个标签选择器,可用于选择诸如 MachineSet 之类的机器资源。 |
machineResourceSelector 是一个标签选择器,可用于选择诸如 MachineSet 之类的机器资源。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
matchExpressions 是标签选择器要求的列表。这些要求是 ANDed 的。 |
|
|
标签选择器要求是一个包含值、键和将键和值关联起来的操作符的选择器。 |
|
|
matchLabels 是 {key,value} 对的映射。matchLabels 映射中的单个 {key,value} 等效于 matchExpressions 的一个元素,其 key 字段为“key”,操作符为“In”,而 values 数组仅包含“value”。这些要求是 ANDed 的。 |
matchExpressions 是标签选择器要求的列表。这些要求是 ANDed 的。
数组
标签选择器要求是一个包含值、键和将键和值关联起来的操作符的选择器。
对象
key
operator
属性 | 类型 | 描述 |
---|---|---|
|
|
key 是选择器应用到的标签键。 |
|
|
operator 表示键与一组值的关系。有效操作符为 In、NotIn、Exists 和 DoesNotExist。 |
|
|
values 是字符串值的数组。如果操作符是 In 或 NotIn,则 values 数组必须非空。如果操作符是 Exists 或 DoesNotExist,则 values 数组必须为空。此数组在策略性合并补丁期间会被替换。 |
nodeDisruptionPolicy 允许管理员为基于 MachineConfig 的更新设置细粒度的节点中断操作,例如 drain、服务重新加载等。指定此项可以在对集群进行小型配置更新时减少停机时间。此配置对集群升级没有影响,集群升级仍然会在需要时造成节点中断。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。此列表最多支持 50 个条目。 |
|
|
NodeDisruptionPolicySpecFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。 |
|
|
sshkey 映射到 MachineConfig 对象中的 ignition.sshkeys 字段,对此的定义和操作将应用于集群中的所有 sshkey 更改。 |
|
|
units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。此列表最多支持 50 个条目。 |
|
|
NodeDisruptionPolicySpecUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。 |
files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。此列表最多支持 50 个条目。
数组
NodeDisruptionPolicySpecFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。
对象
actions
path
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
|
|
|
path 是通过 MachineConfig 管理的文件的位置。策略中的操作将应用于此路径下文件的更改。 |
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
sshkey 映射到 MachineConfig 对象中的 ignition.sshkeys 字段,对此的定义和操作将应用于集群中的所有 sshkey 更改。
对象
actions
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。此列表最多支持 50 个条目。
数组
NodeDisruptionPolicySpecUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyConfig 对象。
对象
actions
name
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
|
|
|
name 表示通过 MachineConfig 管理的 systemd 服务的服务名称。将为指定名称的服务更改应用指定的操作。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 表示如果执行此 NodeDisruptionPolicySpecActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload 和 None。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值不需要进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
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 |
|
|
nodeDisruptionPolicyStatus 状态反映最新的集群验证策略,将在未来的节点更新期间由 Machine Config Daemon 使用。 |
|
|
observedGeneration 是您处理的最后一代更改。 |
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 是条件从一种状态转换到另一种状态的最后时间。这应该是底层条件发生变化的时间。如果不知道,则可以使用 API 字段更改的时间。 |
|
|
message 是一个易于理解的消息,指示有关转换的详细信息。这可能是空字符串。 |
|
|
observedGeneration 表示基于其设置条件的 .metadata.generation。例如,如果 .metadata.generation 当前为 12,但 .status.conditions[x].observedGeneration 为 9,则该条件相对于实例的当前状态已过期。 |
|
|
reason 包含一个编程标识符,指示条件最后转换的原因。特定条件类型的生产者可以为此字段定义预期的值和含义,以及是否将这些值视为保证的 API。该值应为驼峰式字符串。此字段不能为空。 |
|
|
条件的状态,True、False、Unknown 之一。 |
|
|
条件的类型,驼峰式或 foo.example.com/CamelCase。--- 许多 .condition.type 值在资源(如 Available)中是一致的,但由于任意条件可能很有用(参见 .node.status.conditions),因此取消冲突的能力非常重要。它匹配的正则表达式为 (dns1123SubdomainFmt/)?(qualifiedNameFmt) |
nodeDisruptionPolicyStatus 状态反映最新的集群验证策略,将在未来的节点更新期间由 Machine Config Daemon 使用。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
clusterPolicies 是集群默认节点中断策略和用户提供的节点中断策略的合并。 |
clusterPolicies 是集群默认节点中断策略和用户提供的节点中断策略的合并。
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。 |
|
|
NodeDisruptionPolicyStatusFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。 |
|
|
sshkey 是整体 sshkey MachineConfig 定义。 |
|
|
units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。 |
|
|
NodeDisruptionPolicyStatusUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。 |
files 是 MachineConfig 文件定义列表以及对这些路径更改所采取的操作。
数组
NodeDisruptionPolicyStatusFile 是一个文件条目以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。
对象
actions
path
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
|
|
|
path 是通过 MachineConfig 管理的文件的位置。策略中的操作将应用于此路径下文件的更改。 |
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
sshkey 是整体 sshkey MachineConfig 定义。
对象
actions
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
units 是 MachineConfig 单元定义列表以及对这些服务更改所采取的操作。
数组
NodeDisruptionPolicyStatusUnit 是一个 systemd 单元名称以及相应要采取的操作,用于 NodeDisruptionPolicyClusterStatus 对象。
对象
actions
name
属性 | 类型 | 描述 |
---|---|---|
|
|
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。 |
|
|
|
|
|
name 表示通过 MachineConfig 管理的 systemd 服务的服务名称。将为指定名称的服务更改应用指定的操作。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
actions 表示对相应文件路径下的文件更改要执行的一系列命令。操作将按照在此列表中设置的顺序应用。如果在同一更新中对其他 MachineConfig 条目的其他传入更改需要重新启动,则重新启动将优先于这些操作。有效的操作包括 Reboot、Drain、Reload、DaemonReload 和 None。Reboot 操作和 None 操作不能与任何其他操作一起使用。此列表最多支持 10 个条目。
数组
对象
type
属性 | 类型 | 描述 |
---|---|---|
|
|
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。 |
|
|
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。 |
|
|
type 代表如果执行此 NodeDisruptionPolicyStatusActionType 将执行的命令。有效值为 Reboot、Drain、Reload、Restart、DaemonReload、None 和 Special。reload/restart 需要在 reload/restart 字段中指定相应的服务目标。其他值无需进一步配置。 |
reload 指定要重新加载的服务,仅在 type 为 reload 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新加载的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
restart 指定要重新启动的服务,仅在 type 为 restart 时有效。
对象
serviceName
属性 | 类型 | 描述 |
---|---|---|
|
|
serviceName 是要重新启动的服务的完整名称(例如 crio.service)。服务名称应采用 ${NAME}${SERVICETYPE} 格式,最多可包含 255 个字符。${NAME} 必须至少包含 1 个字符,并且只能包含字母、数字、“:”、“-”、“_”、“.” 和“\”。${SERVICETYPE} 必须是“.service”、“.socket”、“.device”、“.mount”、“.automount”、“.swap”、“.target”、“.path”、“.timer”、“.snapshot”、“.slice” 或“.scope” 之一。 |
以下 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 的状态
DELETE
删除 MachineConfiguration 集合
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
GET
列出 MachineConfiguration 对象
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
POST
创建 MachineConfiguration
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
201 - 已创建 |
|
202 - 已接受 |
|
401 - 未授权 |
空 |
参数 | 类型 | 描述 |
---|---|---|
|
|
MachineConfiguration 的名称 |
DELETE
删除 MachineConfiguration
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
202 - 已接受 |
|
401 - 未授权 |
空 |
GET
读取指定的 MachineConfiguration
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PATCH
部分更新指定的 MachineConfiguration
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。 |
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PUT
替换指定的 MachineConfiguration
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
201 - 已创建 |
|
401 - 未授权 |
空 |
参数 | 类型 | 描述 |
---|---|---|
|
|
MachineConfiguration 的名称 |
GET
读取指定 MachineConfiguration 的状态
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PATCH
部分更新指定 MachineConfiguration 的状态
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。 |
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
401 - 未授权 |
空 |
PUT
替换指定 MachineConfiguration 的状态
参数 | 类型 | 描述 |
---|---|---|
|
|
如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段 |
|
|
fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这将通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应体 |
---|---|
200 - OK |
|
201 - 已创建 |
|
401 - 未授权 |
空 |