ClusterVersion [config.openshift.io/v1]

capabilities

对象

capabilities 配置可选核心集群组件的安装。此处的空值与空对象相同；有关默认语义，请参见子属性。

channel

字符串

channel 是一个标识符，用于明确请求将一组非默认更新应用于此集群。默认通道将包含适用于生产集群的稳定更新。

clusterID

字符串

clusterID 唯一标识此集群。这应为 RFC4122 UUID 值（十六进制值中的 xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）。这是必填字段。

desiredUpdate

对象

desiredUpdate 是一个可选字段，指示集群版本的期望值。设置此值将触发升级（如果当前版本与期望版本不匹配）。推荐的更新值集合列在 status 中的可用更新中，设置超出该范围的值可能会导致升级失败。某些字段与此处描述的限制和含义相互关联。1. 指定 image，指定 version，指定 architecture。API 验证错误。2. 指定 image，指定 version，未指定 architecture。你不应该这样做。version 将被静默忽略，并使用 image。3. 指定 image，未指定 version，指定 architecture。API 验证错误。4. 指定 image，未指定 version，未指定 architecture。使用 image。5. 未指定 image，指定 version，指定 architecture。使用 version 和期望的 architecture 来选择 image。6. 未指定 image，指定 version，未指定 architecture。使用 version 和当前 architecture 来选择 image。7. 未指定 image，未指定 version，指定 architecture。API 验证错误。8. 未指定 image，未指定 version，未指定 architecture。API 验证错误。如果升级失败，运营商将停止并报告有关失败组件的状态。将期望更新值设置为先前版本将导致尝试回滚。并非所有回滚都会成功。

overrides

数组

overrides 是集群版本运营商管理的组件的覆盖列表。将组件标记为非托管将阻止运营商创建或更新对象。

overrides[]

对象

ComponentOverride 允许覆盖集群版本运营商对组件的行为。

upstream

字符串

upstream 可用于指定首选更新服务器。默认情况下，它将使用适合集群和区域的更新服务器。

additionalEnabledCapabilities

数组（字符串）

additionalEnabledCapabilities 将托管功能集扩展到 baselineCapabilitySet 中定义的基线之外。默认为空集。

baselineCapabilitySet

字符串

baselineCapabilitySet 选择一组要启用的初始可选功能，可以通过 additionalEnabledCapabilities 扩展。如果未设置，集群将选择一个默认值，并且默认值可能会随着时间的推移而改变。当前默认值为 vCurrent。

architecture

字符串

architecture 是一个可选字段，指示集群架构的期望值。在此上下文中，集群架构表示单个架构或多架构。architecture 只能设置为 Multi，从而仅允许从单架构到多架构的更新。如果设置了 architecture，则不能设置 image，并且必须设置 version。有效值为“Multi”和空。

force

布尔值

force 允许管理员更新为已失败验证或可升级检查的镜像。仅当已在带外验证提供的镜像的真实性时，才应使用此选项，因为提供的镜像将以对集群的完全管理访问权限运行。不要将此标志与来自未知或潜在恶意来源的镜像一起使用。

image

字符串

image 是包含更新的容器镜像位置。如果期望版本不存在于 availableUpdates 或 history 中，则应使用 image。如果设置了 image，则忽略 version。如果设置了 image，则 version 应为空。如果设置了 image，则不能指定 architecture。

version

字符串

version 是标识更新版本的语义版本。如果指定了 image，则忽略 version；如果指定了 architecture，则需要 version。

group

字符串

group 标识 kind 所在的 API 组。

kind

字符串

kind 标识要覆盖的对象。

name

字符串

name 是组件的名称。

namespace

字符串

namespace 是组件的命名空间。如果资源是集群范围的，则命名空间应为空。

unmanaged

布尔值

unmanaged 控制集群版本运营商是否应停止管理此集群中的资源。默认值：false

availableUpdates

``

availableUpdates 包含推荐用于此集群的更新。出现在 conditionalUpdates 中但未出现在 availableUpdates 中的更新可能会使此集群面临已知问题。如果未推荐任何更新，如果更新服务不可用，或者如果指定了无效通道，则此列表可能为空。

capabilities

对象

capabilities 描述了可选核心集群组件的状态。

conditionalUpdates

数组

conditionalUpdates 包含如果集群满足特定所需条件，则可能推荐用于此集群的更新列表。对实际推荐用于此集群的更新集感兴趣的使用者应使用 availableUpdates。如果未推荐任何更新，如果更新服务不可用，或者如果指定了空或无效通道，则此列表可能为空。

conditionalUpdates[]

对象

ConditionalUpdate 表示一个更新，该更新推荐给当前集群正在协调的版本的某些集群，但可能不推荐给当前集群。

conditions

数组

conditions 提供集群版本信息。“Available”（可用）条件在达到 desiredUpdate 后设置为 true。“Progressing”（进行中）条件在应用更新时设置为 true。“Degraded”（降级）条件在更新因临时或永久性错误被阻止时设置为 true。只有当 metadata.generation 等于 status.generation 时，条件才对当前的 desiredUpdate 有效。

conditions[]

对象

ClusterOperatorStatusCondition 表示操作符管理和监控组件的状态。

desired

对象

desired 是集群正在协调到的版本。如果集群尚未完全初始化，则 desired 将使用可用的信息设置，这可能是镜像或标签。

history

数组

history 包含应用于集群的最近版本的列表。在集群启动期间，此值可能为空，然后在应用新更新时更新。最新的更新位于列表的首位，并按最近时间排序。如果 rollout 完成，则历史记录中的更新状态为 Completed；如果更新失败或仅应用了一半，则状态为 Partial。只会保留有限数量的更新历史记录。

history[]

对象

UpdateHistory 是对集群的一次尝试性更新。

observedGeneration

整数

observedGeneration 报告正在同步的 spec 版本。如果此值与 metadata.generation 不相等，则 desired 和 conditions 字段可能表示之前的版本。

versionHash

字符串

versionHash 是集群将要更新的内容的指纹。操作符使用它来避免不必要的工作，仅供内部使用。

enabledCapabilities

数组（字符串）

enabledCapabilities 列出了当前正在管理的所有功能。

knownCapabilities

数组（字符串）

knownCapabilities 列出了当前集群已知的所有功能。

conditions

数组

conditions 表示对条件更新当前状态的观察。已知类型包括：* Recommended（推荐），表示更新是否推荐用于当前集群。

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" // 其他字段 }

版本

对象

release 是更新的目标。

风险

数组

risks 表示与更新到目标版本相关的各种问题。集群版本操作符将评估所有条目，只有当至少有一个条目且所有条目都推荐更新时，才会推荐更新。

risks[]

对象

ConditionalUpdateRisk 表示不推荐条件更新的原因和集群状态。

最后一次转换时间

字符串

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

消息

字符串

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

observedGeneration

整数

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

原因

字符串

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

status

字符串

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

类型

字符串

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

通道

数组（字符串）

channels 是该版本当前所属的 Cincinnati 通道集。

image

字符串

image 是包含更新的容器镜像位置。当此字段是 spec 的一部分时，如果指定了 version 并且 availableUpdates 字段包含匹配的版本，则 image 是可选的。

URL

字符串

url 包含有关此版本的信息。此 URL 由版本上的“url”元数据属性或更新 API 返回的元数据设置，应在用户界面中显示为链接。测试版或夜间版可能未设置 URL 字段。

version

字符串

version 是标识更新版本的语义版本。当此字段是 spec 的一部分时，如果指定了 image，则 version 是可选的。

匹配规则

数组

matchingRules 是用于决定哪些集群匹配风险以及哪些集群不匹配风险的条件切片。该切片按优先级递减排序。集群版本操作符将按顺序遍历切片，并在成功评估第一个条件后停止。如果无法成功评估任何条件，则不会推荐更新。

matchingRules[]

对象

ClusterCondition 是类型化集群条件的联合。“type”属性决定哪些类型特定的属性是相关的。在集群上进行评估时，条件可能匹配、不匹配或评估失败。

消息

字符串

message 提供有关更新风险的附加信息，如果 matchingRules 与集群状态匹配。这仅供人类使用。它可能包含换行符 (U+000A)，应将其渲染为换行符。

name

字符串

name 是不推荐条件更新的原因（驼峰式命名），如果 matchingRules 与集群状态匹配。

URL

字符串

url 包含有关此风险的信息。

promql

对象

promQL 表示基于 PromQL 的集群条件。

类型

字符串

type 表示集群条件类型。这定义了任何附加属性的成员和语义。

promql

字符串

PromQL 是一个用于对集群进行分类的 PromQL 查询。此查询应在匹配情况下返回 1，在不匹配情况下返回 0。返回没有时间序列或返回 0 或 1 之外的值的查询是评估失败。

最后一次转换时间

字符串

lastTransitionTime 是上次更新当前状态属性的时间。

消息

字符串

message 提供有关当前条件的附加信息。这仅供人类使用。它可能包含换行符 (U+000A)，应将其渲染为换行符。

原因

字符串

reason 是导致条件当前状态的驼峰式命名原因。

status

字符串

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

类型

字符串

type 指定此条件报告的方面。

通道

数组（字符串）

channels 是该版本当前所属的 Cincinnati 通道集。

image

字符串

image 是包含更新的容器镜像位置。当此字段是 spec 的一部分时，如果指定了 version 并且 availableUpdates 字段包含匹配的版本，则 image 是可选的。

URL

字符串

url 包含有关此版本的信息。此 URL 由版本上的“url”元数据属性或更新 API 返回的元数据设置，应在用户界面中显示为链接。测试版或夜间版可能未设置 URL 字段。

version

字符串

version 是标识更新版本的语义版本。当此字段是 spec 的一部分时，如果指定了 image，则 version 是可选的。

acceptedRisks

字符串

acceptedRisks 记录了为启动更新而接受的风险。例如，它可能提到通过 desiredUpdate.force 覆盖的 Upgradeable=False 或缺少签名，或者是在未包含在建议更新目标的 availableUpdates 集合中时启动的更新。

completionTime

``

completionTime 如果设置，表示更新完全应用的时间。当前正在应用的更新将具有空完成时间。完成时间将始终为非当前更新的条目设置（通常设置为下一个更新的 startedTime）。

image

字符串

image 是包含更新的容器镜像位置。此值始终填充。

startedTime

字符串

startedTime 是更新启动的时间。

state

字符串

state 反映更新是否完全应用。Partial 状态表示更新未完全应用，而 Completed 状态表示更新已至少成功推出一次（更新的所有部分都已成功应用）。

verified

布尔值

verified 指示提供的更新在安装之前是否已正确验证。如果此值为 false，则可能无法信任集群。verified 不涵盖依赖于接受更新目标时集群状态的可升级检查。

version

字符串

version 是标识更新版本的语义版本。如果请求的镜像未定义版本，或者在检索镜像时发生故障，则此值可能为空。

200 - OK

Status 模式

401 - Unauthorized

空

200 - OK

ClusterVersionList 模式

401 - Unauthorized

空

dryRun

字符串

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

fieldValidation

字符串

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

body

ClusterVersion 模式

200 - OK

ClusterVersion 模式

201 - Created

ClusterVersion 模式

202 - Accepted

ClusterVersion 模式

401 - Unauthorized

空

name

字符串

ClusterVersion 的名称

dryRun

字符串

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

200 - OK

Status 模式

202 - Accepted

Status 模式

401 - Unauthorized

空

200 - OK

ClusterVersion 模式

401 - Unauthorized

空

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

ClusterVersion 模式

401 - Unauthorized

空

dryRun

字符串

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

fieldValidation

字符串

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

body

ClusterVersion 模式

200 - OK

ClusterVersion 模式

201 - Created

ClusterVersion 模式

401 - Unauthorized

空

name

字符串

ClusterVersion 的名称

200 - OK

ClusterVersion 模式

401 - Unauthorized

空

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

ClusterVersion 模式

401 - Unauthorized

空

dryRun

字符串

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

fieldValidation

字符串

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

body

ClusterVersion 模式

200 - OK

ClusterVersion 模式

201 - Created

ClusterVersion 模式

401 - Unauthorized

空