Package google.cloud.gkehub.clusterupgrade.v1

索引

FleetSpec

ClusterUpgrade: フリートレベルの ClusterUpgrade 機能の構成。

フィールド
upstream_fleets[]

string

このフリートは、アップストリーム フリートでステータス コードが COMPLETE のアップグレードを使用します。コードの定義については、UpgradeStatus.Code をご覧ください。

フリート名は、フリート プロジェクトの番号または ID にする必要があります。

これは、将来の証明のために繰り返されるものとして定義されています。最初の実装では、最大で 1 つのアップストリーム フリートが適用されます。

post_conditions

PostConditions

必須。アップグレードを COMPLETE としてマークするために評価する後処理条件。必須。

gke_upgrade_overrides[]

GKEUpgradeOverride

ユーザーが GKE アップグレードの一部のプロパティをオーバーライドできるようにします。

FleetState

ClusterUpgrade: フリートレベルの ClusterUpgrade 機能の状態。

フィールド
downstream_fleets[]

string

upstream_fleets に現在のフリートが含まれているフリート。

フリート名は、フリート プロジェクトの番号または 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 アップグレードのプロパティ。たとえば、soaking を 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

アップグレードのステータス コード。

列挙型
CODE_UNSPECIFIED https://linter.aip.dev/126/unspecified で必須。
INELIGIBLE アップグレードは対象外です。スコープレベルでは、スコープ内のすべてのクラスタでアップグレードが無効になります。
PENDING アップグレードが保留中です。スコープレベルでは、スコープ内のすべてのクラスタでアップグレードが保留中であることを意味します。
IN_PROGRESS アップグレードが進行中です。スコープレベルでは、スコープ内の少なくとも 1 つのクラスタでアップグレードが進行中であることを意味します。
SOAKING アップグレードが完了し、ソーク時間が経過するまでソーク処理が行われます。スコープレベルでは、少なくとも 1 つのクラスタがソーク処理中の状態にあり、残りのクラスタの状態はソーク処理中または完了していることを意味します。
FORCED_SOAKING 実際のステータスにかかわらず、アップグレードが一定の制限内に完了しない場合、クラスタは強制的にソーク処理に入ります。
COMPLETE アップグレードがすべての後処理条件(ソーク処理条件)を満たしました。スコープレベルでは、対象となるすべてのクラスタが COMPLETE ステータスであることを意味します。