容錯移轉 v1.5.0 自訂資源定義

選取說明文件版本:

規格結構定義

FailoverSpec 代表單一容錯移轉作業的參數。

dbclusterRef: string
newPrimary: string

欄位

類型
必要或選填

 

說明
dbclusterRef
string
必填
DBClusterRef 是啟動容錯移轉的 DBCluster 名稱。Failover 物件必須與其參照的 DBCluster 建立在相同的命名空間。
newPrimary
string
選填
NewPrimary 是要升級為新主要執行個體的待命執行個體。如果留空,系統會自動選取最佳執行個體來進行容錯移轉。

狀態結構定義

FailoverStatus 代表容錯移轉的目前狀態。

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

欄位

類型
必要或選填

 

說明
conditions[]
object
選填
條件代表實體目前狀態的最新可用觀察結果。
conditions[].lastTransitionTime
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。
conditions[].type
string
必填
條件類型,格式為 CamelCase 或 foo.example.com/CamelCase。許多 .condition.type 值在資源之間保持一致,例如 Available。任意條件可能很有用,例如 .node.status.conditions,因此解除衝突的能力很重要。與其相符的規則運算式為 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
createTime
string
選填
CreateTime 是指建立內部容錯移轉工作流程機制的時間。
criticalIncidents[]
object
必填
CriticalIncidents 是所有有效重大事件的平面清單。
criticalIncidents[].code
string
必填
「代碼」是這項特定錯誤的錯誤代碼。錯誤代碼是 DBSE+numeric 字串,例如 DBSE1012
criticalIncidents[].createTime
string
必填
CreateTime 是指在來源建立這個事件的時間戳記。
criticalIncidents[].message
string
選填
訊息會說明發生的事件或錯誤。
criticalIncidents[].messageTemplateParams
object
選填
MessageTemplateParams 包含產生訊息資料導向版本的必要鍵/值組合,方便使用者在使用者介面中查看。
criticalIncidents[].resource
object
必填
資源包含回報事件的資料庫服務元件相關資訊,以及 Kubernetes 資源的相關資訊。
criticalIncidents[].resource.component
string
必填
Component 是回報事件的資料庫服務子系統內部 ID。
criticalIncidents[].resource.location
object
選填
地點。
criticalIncidents[].resource.location.cluster
string
選填
受影響 Kubernetes 資源的叢集名稱。
criticalIncidents[].resource.location.group
string
選填
Kubernetes 資源的群組名稱。
criticalIncidents[].resource.location.kind
string
選填
Kubernetes 資源的種類。
criticalIncidents[].resource.location.name
string
選填
受影響的 Kubernetes 資源名稱。
criticalIncidents[].resource.location.namespace
string
選填
受影響 Kubernetes 資源的命名空間。
criticalIncidents[].resource.location.version
string
選填
Kubernetes 資源的版本。
criticalIncidents[].stackTrace[]
object
選填
堆疊追蹤記錄中的非結構化訊息清單。
criticalIncidents[].stackTrace[].component
string
選填
記錄訊息的資料庫服務元件名稱。
criticalIncidents[].stackTrace.message
string
選填
記錄的訊息。
criticalIncidents[].transientUntil
string
選填
如有 TransientUntil,表示問題必須視為暫時性問題,直到指定時間為止。
endTime
string
選填
EndTime 是指容錯移轉達到最終狀態的時間。
internal
object
選填
系統控制器會使用 Internal。請勿依據本節資訊。
internal.attempt
integer
必填
嘗試用於重試邏輯。
internal.lastPhaseChangeTime
string
選填
LastPhaseChangeTime 是 L1 容錯移轉上次變更為新階段的時間。這會用於逾時邏輯。
internal.newPrimary
string
必填
NewPrimary 是您嘗試容錯移轉的執行個體。
internal.newPrimaryZone
string
選填
NewPrimaryZone 是我們嘗試容錯移轉的區域。
internal.oldPrimary
string
必填
OldPrimary 是容錯移轉開始時的主要執行個體。
internal.phase
string
選填
階段用於追蹤容錯移轉的目前狀態。
observedGeneration
integer
選填
內部:控制器觀察到的世代。
reconciled
boolean
選填
內部:資源是否已由控制器調解。
startTime
string
選填
StartTime 是指容錯移轉作業的開始時間。
state
string
選填
狀態是容錯移轉作業的目前狀態。值包括 InProgress、Success、Failed_RollbackInProgress、Failed_RollbackSuccess 和 Failed_RollbackFailed。
  • InProgress 表示容錯移轉作業仍在進行中。
  • 「成功」表示容錯移轉已完成。當新的主要執行個體升級成功,即表示作業完成。
  • Failed_RollbackInProgress 表示運算子無法升級新的主要執行個體,且正在嘗試重新啟動舊的主要執行個體。
  • Failed_RollbackSuccess 表示運算子無法升級新的主要執行個體,但已成功重新啟動舊的主要執行個體。
  • Failed_RollbackFailed 表示運算子無法升級新的主要執行個體,也無法重新啟動舊的主要執行個體。DBCluster 可能需要手動修復。