切換至 v1.1.1 自訂資源定義

選取說明文件版本：

規格結構定義

SwitchoverSpec 會定義 Switchover 的所選狀態。

dbclusterRef: string
newPrimary: string
newPrimaryInstance: string
primaryHost: string

欄位類型必要或選填	說明
`dbclusterRef`
`string` 選填	DBClusterRef 是要啟動切換的 DBCluster 名稱。 `Switchover` 物件必須與參照的 DBCluster 建立在相同的命名空間。這是切換作業的必填欄位。
`newPrimary`
`string` 選填	NewPrimary 是待命執行個體，可與目前的主要執行個體切換。
`newPrimaryInstance`
`string` 選填	NewPrimaryInstance 是要與目前主要執行個體切換的待命執行個體。已淘汰：請改用 NewPrimary 欄位。
`primaryHost`
`string` 選填	PrimaryHost 是 IP，一律指向主要執行個體。

狀態結構定義

SwitchoverStatus 定義 Switchover 的觀察狀態。

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
createTime: string
critcalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams:
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
endTime: string
internal:
  newPrimary: string
  oldPrimary: string
  phase: string
observedGeneration: integer
reconciled: boolean
startTime: string
state: string

欄位類型必要或選填	說明
`conditions`
`list (object)` 選填	「條件」代表實體目前狀態的最新可用觀察結果。
`conditions[]`
`object` 選填	Condition 包含這個 API 資源目前狀態某個層面的詳細資料。--- This struct is intended for direct use as an array at the field path .status.conditions. 舉例來說：\n type FooStatus struct{ // Represents the observations of a\n foo's current state. // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"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\"` \n // other fields }
`conditions[].lastTransactionTime`
`string` 必填	lastTransitionTime 是指條件最近一次從一個狀態轉變為另一個狀態的時間。這應該是基礎條件變更時。如果不知道，可以使用 API 欄位變更的時間。
`conditions[].message`
`string` 必填	message 是使用者可理解的訊息，指出轉換的詳細資料。這可能是空字串。
`conditions[].observedGeneration`
`integer` 選填	observedGeneration 代表條件設定依據的 .metadata.generation。舉例來說，如果 .metadata.generation 為 12，但 .status.conditions[x].observedGeneration 為 9，則條件相對於執行個體的目前狀態已過時。
`conditions[].reason`
`string` 必填	reason 包含程式化 ID，指出條件上次轉換的原因。特定條件類型的產生者可能會定義這個欄位的預期值和意義，以及這些值是否視為有保障的 API。值應為 CamelCase 字串。這個欄位不得留空。
`conditions[].status`
`string` 必填	有效值：`"True"`、`"False"`、`Unknown` 條件狀態，可以是 True、False 或 Unknown。
`conditions[].type`
`string` 必填	駝峰式大小寫的條件類型，或 foo.example.com/CamelCase。 --- 許多 .condition.type 值在資源間是一致的，例如 Available，但由於任意條件可能很有用 (請參閱 .node.status.conditions)，因此解除衝突的能力很重要。比對的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)
`createTime`
`string` 選填	CreateTime 是指內部切換工作流程機制建立的時間。
`criticalIncidents`
`list (object)` 選填	CriticalIncidents 是所有有效 Critical 事件的平面清單。
`criticalIncidents[]`
`object` 選填	CriticalIncident 包含持續發生的重大事件的所有資訊。
`criticalIncidents[].code`
`string` 必填	Code 是這項特定錯誤的錯誤代碼。錯誤代碼為 DBSE+數字字串，例如「DBSE1012」。
`criticalIncidents[].createTime`
`string` 必填	CreateTime 是指在來源建立這起事件的時間戳記。
`criticalIncidents[].message`
`string` 選填	訊息會說明發生的事件/錯誤。
`criticalIncidents[].messageTemplateParams`
`object` 選填	MessageTemplateParams 包含鍵/值組合，可產生使用者友善的資料驅動型 Message 版本，並顯示在 UI 中。
`criticalIncidents[].resource`
`object` 必填	資源包含回報事件的資料庫服務元件，以及 Kubernetes 資源的相關資訊。
`criticalIncidents[].resource.component`
`string` 必填	元件是回報事件的資料庫服務子系統內部 ID。
`criticalIncidents[].resource.location`
`object` 選填	Location
`criticalIncidents[].resource.location.cluster`
`string` 選填	Cluster 是受影響 Kubernetes 資源的叢集名稱。
`criticalIncidents[].resource.location.group`
`string` 選填	Group 是 Kubernetes 資源的群組名稱。
`criticalIncidents[].resource.location.kind`
`string` 選填	Kind 是 Kubernetes 資源的種類。
`criticalIncidents[].resource.location.name`
`string` 選填	名稱是受影響的 Kubernetes 資源名稱。
`criticalIncidents[].resource.location.namespace`
`string` 選填	命名空間是受影響 Kubernetes 資源的命名空間。
`criticalIncidents[].resource.location.version`
`TYPE` 選填	Group 是 Kubernetes 資源的版本。
`criticalIncidents[].stackTrace`
`list (object)` 選填	StackTrace 包含來自堆疊追蹤的非結構化訊息清單。
`criticalIncidents[].stackTrace[]`
`object` 選填	CriticalIncidentStackTraceMessage 包含事件的堆疊追蹤資訊。
`criticalIncidents[].stackTrace[].component`
`string` 選填	「元件」是記錄訊息的資料庫服務元件名稱。
`criticalIncidents[].stackTrace[].message`
`string` 選填	記錄的訊息。
`criticalIncidents[].stackTrace[].message`
`string` 選填	如果存在 TransientUntil，表示問題應視為暫時性問題，直到指定時間為止。
`endTime`
`string` 選填	EndTime 是指切換作業達到最終狀態的時間。
`internal`
`object` 選填	系統控制器會使用「Internal」。請勿依賴本節中的資訊。
`internal.newPrimary`
`string` 必填	NewPrimary 是我們嘗試切換的執行個體。
`internal.oldPrimary`
`string` 必填	OldPrimary 是在切換開始時為主要執行個體的執行個體。
`internal.phase`
`string` 選填	有效值：`UpdateDbcluster`、`StopPrimary`、`PromoteStandby`、`ValidateNewPrimary`、`UpdateOldPrimaryResources`、`UpdateNewPrimaryResources`、`UpdateOldPrimaryConfigs`、`Complete`、`SyncOldPrimary`、`StartOldPrimary`、`PreSuccess`、`RepointStandbys`、`RollbackPrimary`、`RollbackStandbys` 階段用於追蹤切換作業的目前狀態
`observedGeneration`
`integer` 選填	內部：控制器觀察到的世代。
`reconciled`
`boolean` 選填	內部：資源是否已由控制器協調。
`startTime`
`string` 選填	StartTime 是指切換作業的開始時間。
`state`
`string` 選填	有效值：`InProgress`、`Success`、`Failed_RollbackInProgress`、`Failed_RollbackSuccess`、`Failed_RollbackFailed` 狀態是切換作業的目前狀態。值為 `InProgress`、`Success`、`Failed_RollbackInProgress`、`Failed_RollbackSuccess`、`Failed_RollbackFailed`。`InProgress` 表示切換作業仍在進行中。`Success` 表示切換作業已完成。`Failed_RollbackInProgress` 表示運算子無法升級新的主要執行個體，並嘗試重新啟動舊的主要執行個體。`Failed_RollbackSuccess` 表示運算子無法升級新的主要執行個體，但已成功重新啟動舊的主要執行個體。`Failed_RollbackFailed` 表示運算子無法升級新的主要執行個體，也無法重新啟動舊的主要執行個體。DBCluster 可能需要手動修復。