Package google.cloud.gkehub.clusterupgrade.v1

索引

FleetSpec

ClusterUpgrade:舰队级 ClusterUpgrade 特征的配置。

字段
upstream_fleets[]

string

此舰队会使用上游舰队中具有 COMPLETE 状态代码的升级。有关代码定义,请参阅 UpgradeStatus.Code。

舰队名称应为舰队项目编号或 ID。

出于面向未来的原因,这被定义为重复使用。初始实现最多强制执行一个上游舰队。

post_conditions

PostConditions

必需。将升级标记为 COMPLETE 时要评估的后置条件。必填。

gke_upgrade_overrides[]

GKEUpgradeOverride

允许用户替换每次 GKE 升级的某些属性。

FleetState

ClusterUpgrade:舰队级 ClusterUpgrade 特征的状态。

字段
downstream_fleets[]

string

此舰队的上游舰队包含当前舰队。

舰队名称应为舰队项目编号或 ID。

ignored

map<string, IgnoredMembership>

特征忽略的成员资格的列表。例如,如果手动升级的集群比其发布渠道的默认版本更新,则可以忽略这些集群。成员资格资源的格式为:projects/{p}/locations/{l}/membership/{m}

gke_state

GKEUpgradeFeatureState

GKE 集群的特征状态。

GKEUpgrade

GKEUpgrade 表示 GKE 提供的升级,例如控制平面升级。

字段
name

string

升级的名称,例如:“k8s_control_plane”。它应该是有效升级名称。不能超过 99 个字符。

version

string

升级的版本,例如:“1.22.1-gke.100”。它应该是有效版本。不能超过 99 个字符。

GKEUpgradeFeatureCondition

GKEUpgradeFeatureCondition 描述 GKE 集群在特定时间点的特征条件。

字段
type

string

条件的类型,例如“ready”。

status

string

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

reason

string

特征处于此状态的原因。

update_time

Timestamp

上次更新条件时的时间戳。

GKEUpgradeFeatureState

GKEUpgradeFeatureState 包含范围内 GKE 集群的特征状态。

字段
upgrade_state[]

GKEUpgradeState

升级状态。它最终将取代 state

conditions[]

GKEUpgradeFeatureCondition

特征的当前条件。

GKEUpgradeOverride

可由用户替换的 GKE 升级属性。例如,用户可以通过将过渡替换为 0 来跳过过渡。

字段
upgrade

GKEUpgrade

必需。要替换的升级。必填。

post_conditions

PostConditions

必需。要对指定升级(名称 + 版本)替换的后置条件。必填。

GKEUpgradeState

GKEUpgradeState 是一个 GKEUpgrade 及其在范围和舰队级的状态。

字段
stats

map<string, int64>

具有每种状态代码的 GKE 集群数量。

upgrade

GKEUpgrade

要跟踪状态的升级。

status

UpgradeStatus

升级的状态。

IgnoredMembership

IgnoredMembership 表示特征忽略的成员资格。成员资格可以忽略,因为它已手动升级到比 RC 默认版本更新的版本。

字段
reason

string

成员资格被忽略的原因。

ignored_time

Timestamp

首次将成员资格设置为忽略时的时间。

MembershipGKEUpgradeState

ScopeGKEUpgradeState 是一个 GKEUpgrade 及其基于成员资格的状态。

字段
upgrade

GKEUpgrade

要跟踪状态的升级。

status

UpgradeStatus

升级的状态。

MembershipState

此特征基于成员资格的状态。

字段
upgrades[]

MembershipGKEUpgradeState

相对于所需状态的实际升级状态。

ignored

IgnoredMembership

特征是否忽略此成员资格。例如,如果手动升级的集群比其发布渠道的默认版本更新,则可以忽略这些集群。

PostConditions

对所有符合条件的集群应用升级后进行的后置条件检查。

字段
soaking

Duration

必需。在部署完成之后、标记为 COMPLETE 之前“过渡”的时间量。不能超过 30 天。 必填。

UpgradeStatus

UpgradeStatus 提供每次升级的状态信息。

字段
code

UpgradeStatus.Code

升级的状态代码。

reason

string

返回此状态的原因。

update_time

Timestamp

上次更新状态时的时间戳。

代码

升级的状态代码。

枚举
CODE_UNSPECIFIED https://linter.aip.dev/126/unspecified 需要此信息。
INELIGIBLE 升级不符合条件。在范围级,这意味着升级对于范围中的所有集群都不符合条件。
PENDING 升级待处理。在范围级,这意味着范围中的所有集群都在等待升级。
IN_PROGRESS 正在升级。在范围级,这意味着范围中的至少一个集群正在进行升级。
SOAKING 升级已完成,在进行过渡,直到过渡时间结束。在范围级,这意味着至少一个集群在进行过渡,而其余集群为过渡或完成状态。
FORCED_SOAKING 如果升级未在特定限制内完成,则集群将强制进入过渡状态,无论其实际状态如何。
COMPLETE 升级已通过所有后置条件(过渡)。在范围级,这意味着所有符合条件的集群都处于 COMPLETE 状态。