MachineConfigPool [machineconfiguration.openshift.io/v1]

configuration

对象

机器配置池的目标 MachineConfig 对象。

machineConfigSelector

对象

machineConfigSelector 指定 MachineConfig 的标签选择器。有关标签和选择器的工作方式，请参阅https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/labels/。

maxUnavailable

整数或字符串

maxUnavailable 定义池中在更新期间可能变得不可用的节点的整数或百分比。这包括由于任何原因而不可用的节点，包括用户发起的隔离、故障节点等。默认值为 1。大于 1 的值表示在更新期间多个节点将不可用，这可能会影响您对剩余节点的工作负载压力。您不能将此值设置为 0 以停止更新（它将恢复为默认值 1）；要停止更新，请改用“paused”属性。即使 maxUnavailable 大于 1，排水也会尊重 Pod Disruption Budgets (PDB)，例如 etcd 仲裁保护。

nodeSelector

对象

nodeSelector 指定机器的标签选择器。

paused

布尔值

paused 指定是否应停止对该机器配置池的更改。这包括生成新的 desiredMachineConfig 和机器的更新。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象，则此字符串应包含有效的 JSON/Go 字段访问语句，例如 desiredState.manifest.containers[2]。例如，如果对象引用是指 Pod 中的容器，则其值将类似于：“spec.containers{name}”（其中“name”是指触发事件的容器的名称）或者如果未指定容器名称，则为“spec.containers[2]”（此 Pod 中索引为 2 的容器）。选择此语法只是为了有一种明确定义的方法来引用对象的一部分。待办事项：此设计并非最终设计，此字段将来可能会更改。

kind

字符串

引用的 Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion（如果存在）。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

source

数组

source 是用于生成content中指定的单个 MachineConfig 对象的 MachineConfig 对象列表。

source[]

对象

ObjectReference 包含足够的信息，允许您检查或修改引用的对象。--- 不鼓励使用这种类型的新用途，因为在嵌入 API 时难以描述其用法。1. 被忽略的字段。它包含许多通常不被尊重的字段。例如，ResourceVersion 和 FieldPath 在实际使用中很少有效。2. 无效的用法帮助。无法为单个用法添加具体的帮助。在大多数嵌入式用法中，存在特定的限制，例如“必须仅引用类型 A 和 B”或“UID 不被尊重”或“名称必须受限”。这些在嵌入时无法得到很好的描述。3. 不一致的验证。由于用法不同，验证规则因用法而异，这使得用户难以预测会发生什么。4. 字段既不精确又过于精确。Kind 不是对 URL 的精确映射。这可能会在解释过程中产生歧义，并需要 REST 映射。在大多数情况下，依赖于 group，resource 元组，并且实际结构的版本无关紧要。5. 我们无法轻松更改它。由于此类型嵌入在许多位置，因此对此类型的更新将影响许多模式。不要让新的 API 嵌入它们无法控制的未充分指定的 API 类型。不要使用此类型，而是创建一个在本地提供和使用的类型，该类型专注于您的引用。例如，用于准入注册的 ServiceReferences：https://github.com/kubernetes/api/blob/release-1.17/admissionregistration/v1/types.go#L533。

uid

字符串

引用的 UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象，则此字符串应包含有效的 JSON/Go 字段访问语句，例如 desiredState.manifest.containers[2]。例如，如果对象引用是指 Pod 中的容器，则其值将类似于：“spec.containers{name}”（其中“name”是指触发事件的容器的名称）或者如果未指定容器名称，则为“spec.containers[2]”（此 Pod 中索引为 2 的容器）。选择此语法只是为了有一种明确定义的方法来引用对象的一部分。待办事项：此设计并非最终设计，此字段将来可能会更改。

kind

字符串

引用的 Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion（如果存在）。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

matchExpressions

数组

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

matchExpressions[]

对象

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

matchLabels

对象 (字符串)

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

key

字符串

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

operator

字符串

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

values

数组 (字符串)

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

matchExpressions

数组

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

matchExpressions[]

对象

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

matchLabels

对象 (字符串)

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

key

字符串

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

operator

字符串

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

values

数组 (字符串)

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

certExpirys

数组

certExpirys 用于跟踪重要的证书过期数据。

certExpirys[]

对象

ceryExpiry 包含包名称和过期日期。

conditions

数组

conditions 表示当前状态的最新可用观察结果。

conditions[]

对象

MachineConfigPoolCondition 包含 MachineConfigPool 的条件信息。

configuration

对象

configuration 代表机器配置池的当前 MachineConfig 对象。

degradedMachineCount

整数

degradedMachineCount 表示标记为已降级（或无法协调）的机器总数。如果应用配置失败，则节点将被标记为已降级。

machineCount

整数

machineCount 表示机器配置池中机器的总数。

observedGeneration

整数

observedGeneration 表示控制器观察到的世代。

readyMachineCount

整数

readyMachineCount 表示池目标的已准备就绪机器总数。

unavailableMachineCount

整数

unavailableMachineCount 表示池目标的不可用（非就绪）机器总数。如果节点处于更新状态或 NodeReady 条件为 false，则该节点将被标记为不可用。

updatedMachineCount

整数

updatedMachineCount 表示池目标的具有 CurrentMachineConfig 作为其配置的机器总数。

bundle

字符串

bundle 是包含主题证书的包的名称。

expiry

字符串

expiry 是证书不再有效后的日期。

subject

字符串

subject 是证书的主题。

lastTransitionTime

``

lastTransitionTime 是与此条件的最后状态更改相对应的的时间戳。

message

字符串

message 是对最后转换详细信息的人类可读描述，补充了 reason。

reason

字符串

reason 是对条件最后转换的简短机器可读解释。

status

字符串

条件的状态，其中之一（'True'、'False'、'Unknown'）。

type

字符串

条件的类型，当前为（'Done'、'Updating'、'Failed'）。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象，则此字符串应包含有效的 JSON/Go 字段访问语句，例如 desiredState.manifest.containers[2]。例如，如果对象引用是指 Pod 中的容器，则其值将类似于：“spec.containers{name}”（其中“name”是指触发事件的容器的名称）或者如果未指定容器名称，则为“spec.containers[2]”（此 Pod 中索引为 2 的容器）。选择此语法只是为了有一种明确定义的方法来引用对象的一部分。待办事项：此设计并非最终设计，此字段将来可能会更改。

kind

字符串

引用的 Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion（如果存在）。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

source

数组

source 是用于生成content中指定的单个 MachineConfig 对象的 MachineConfig 对象列表。

source[]

对象

ObjectReference 包含足够的信息，允许您检查或修改引用的对象。--- 不鼓励使用这种类型的新用途，因为在嵌入 API 时难以描述其用法。1. 被忽略的字段。它包含许多通常不被尊重的字段。例如，ResourceVersion 和 FieldPath 在实际使用中很少有效。2. 无效的用法帮助。无法为单个用法添加具体的帮助。在大多数嵌入式用法中，存在特定的限制，例如“必须仅引用类型 A 和 B”或“UID 不被尊重”或“名称必须受限”。这些在嵌入时无法得到很好的描述。3. 不一致的验证。由于用法不同，验证规则因用法而异，这使得用户难以预测会发生什么。4. 字段既不精确又过于精确。Kind 不是对 URL 的精确映射。这可能会在解释过程中产生歧义，并需要 REST 映射。在大多数情况下，依赖于 group，resource 元组，并且实际结构的版本无关紧要。5. 我们无法轻松更改它。由于此类型嵌入在许多位置，因此对此类型的更新将影响许多模式。不要让新的 API 嵌入它们无法控制的未充分指定的 API 类型。不要使用此类型，而是创建一个在本地提供和使用的类型，该类型专注于您的引用。例如，用于准入注册的 ServiceReferences：https://github.com/kubernetes/api/blob/release-1.17/admissionregistration/v1/types.go#L533。

uid

字符串

引用的 UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象，则此字符串应包含有效的 JSON/Go 字段访问语句，例如 desiredState.manifest.containers[2]。例如，如果对象引用是指 Pod 中的容器，则其值将类似于：“spec.containers{name}”（其中“name”是指触发事件的容器的名称）或者如果未指定容器名称，则为“spec.containers[2]”（此 Pod 中索引为 2 的容器）。选择此语法只是为了有一种明确定义的方法来引用对象的一部分。待办事项：此设计并非最终设计，此字段将来可能会更改。

kind

字符串

引用的 Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion（如果存在）。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

200 - OK

Status 模式

401 - 未授权

空

200 - OK

MachineConfigPoolList 模式

401 - 未授权

空

dryRun

字符串

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

fieldValidation

字符串

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

body

MachineConfigPool 模式

200 - OK

MachineConfigPool 模式

201 - 已创建

MachineConfigPool 模式

202 - 已接受

MachineConfigPool 模式

401 - 未授权

空

name

字符串

MachineConfigPool 的名称

dryRun

字符串

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

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空

200 - OK

MachineConfigPool 模式

401 - 未授权

空

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

MachineConfigPool 模式

401 - 未授权

空

dryRun

字符串

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

fieldValidation

字符串

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

body

MachineConfigPool 模式

200 - OK

MachineConfigPool 模式

201 - 已创建

MachineConfigPool 模式

401 - 未授权

空

name

字符串

MachineConfigPool 的名称

200 - OK

MachineConfigPool 模式

401 - 未授权

空

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

MachineConfigPool 模式

401 - 未授权

空

dryRun

字符串

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

fieldValidation

字符串

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

body

MachineConfigPool 模式

200 - OK

MachineConfigPool 模式

201 - 已创建

MachineConfigPool 模式

401 - 未授权

空