Benutzerdefinierte Ressourcendefinition für Failover v1.5.0

Wählen Sie eine Dokumentationsversion aus:

Spezifikationsschema

FailoverSpec stellt die Parameter eines einzelnen Failover-Vorgangs dar.

dbclusterRef: string
newPrimary: string

Feld

Typ
Erforderlich oder optional

 

Beschreibung
dbclusterRef
string
Erforderlich 		DBClusterRef ist der DBCluster-Name, mit dem ein Failover initiiert wird. Das Failover-Objekt muss im selben Namespace wie der DBCluster erstellt werden, auf den es verweist.
newPrimary
string
Optional 		„NewPrimary“ ist die Stand-by-Instanz, die zur neuen primären Instanz hochgestuft werden soll. Wenn das Feld leer gelassen wird, wählt das System automatisch die beste Instanz für das Failover aus.

Statusschema

FailoverStatus stellt den aktuellen Status eines Failovers dar.

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

Feld

Typ
Erforderlich oder optional

 

Beschreibung
conditions[]
object
Optional 		„Bedingungen“ entspricht den neuesten verfügbaren Beobachtungen zum aktuellen Status der Entität.
conditions[].lastTransitionTime
string
Erforderlich 		lastTransitionTime ist der Zeitpunkt, zu dem der Zustand zuletzt von einem Status zu einem anderen Status geändert wurde. Dies geschieht, wenn sich der zugrunde liegende Zustand geändert hat. Wenn der Zeitpunkt, zu dem sich die zugrunde liegende Bedingung geändert hat, nicht bekannt ist, verwenden Sie den Zeitpunkt, zu dem sich das API-Feld geändert hat.
conditions[].message
string
Erforderlich 		„message“ ist eine menschenlesbare Nachricht mit Details zur Umstellung. Das kann ein leerer String sein.
conditions[].observedGeneration
integer
Optional 		observedGeneration stellt die .metadata.generation dar, auf der die Bedingung basiert. Wenn beispielsweise .metadata.generation 12 ist, .status.conditions[x].observedGeneration aber 9, ist die Bedingung im Hinblick auf den aktuellen Status der Instanz nicht mehr aktuell.
conditions[].reason
string
Erforderlich 		„reason“ enthält eine programmatische Kennung, die den Grund für die letzte Statusänderung der Bedingung angibt. Anbieter bestimmter Bedingungstypen können erwartete Werte und Bedeutungen für dieses Feld definieren und festlegen, ob die Werte als garantierte API gelten. Der Wert muss ein String im CamelCase-Format sein. Dieses Feld darf nicht leer sein.
conditions[].status
string
Erforderlich 		Status der Bedingung, entweder „Wahr“, „Falsch“ oder „Unbekannt“.
conditions[].type
string
Erforderlich 		Bedingungstyp in CamelCase oder in foo.example.com/CamelCase. Viele .condition.type-Werte sind ressourcenübergreifend konsistent, z. B. „Available“. Da beliebige Bedingungen nützlich sein können, z. B. .node.status.conditions, ist die Möglichkeit zur Konfliktlösung wichtig. Der reguläre Ausdruck, mit dem er übereinstimmt, ist (dns1123SubdomainFmt/)?(qualifiedNameFmt).
createTime
string
Optional 		„CreateTime“ ist der Zeitpunkt, zu dem der interne Failover-Workflow-Mechanismus erstellt wurde.
criticalIncidents[]
object
Erforderlich 		„CriticalIncidents“ ist eine einfache Liste aller aktiven kritischen Vorfälle.
criticalIncidents[].code
string
Erforderlich 		„Code“ ist der Fehlercode dieses bestimmten Fehlers. Fehlercodes sind DBSE+numeric-Strings wie DBSE1012.
criticalIncidents[].createTime
string
Erforderlich 		„CreateTime“ ist der Zeitstempel, der angibt, wann dieser Vorfall am Ursprungsort erstellt wurde.
criticalIncidents[].message
string
Optional 		Die Nachricht beschreibt den Vorfall oder Fehler, der aufgetreten ist.
criticalIncidents[].messageTemplateParams
object
Optional 		„MessageTemplateParams“ enthält Schlüssel/Wert-Paare, die zum Generieren einer nutzerfreundlichen datengesteuerten Version von „Message“ in der Benutzeroberfläche erforderlich sind.
criticalIncidents[].resource
object
Erforderlich 		Die Ressource enthält Informationen zur Database Service-Komponente, die den Vorfall gemeldet hat, sowie Informationen zur Kubernetes-Ressource.
criticalIncidents[].resource.component
string
Erforderlich 		„Component“ ist eine interne Kennung des Subsystems des Datenbankdienstes, das den Vorfall gemeldet hat.
criticalIncidents[].resource.location
object
Optional 		Standort
criticalIncidents[].resource.location.cluster
string
Optional 		Der Name des Clusters der betroffenen Kubernetes-Ressource.
criticalIncidents[].resource.location.group
string
Optional 		Der Gruppenname der Kubernetes-Ressource.
criticalIncidents[].resource.location.kind
string
Optional 		Die Art der Kubernetes-Ressource.
criticalIncidents[].resource.location.name
string
Optional 		Der Name der betroffenen Kubernetes-Ressource.
criticalIncidents[].resource.location.namespace
string
Optional 		Der Namespace der betroffenen Kubernetes-Ressource.
criticalIncidents[].resource.location.version
string
Optional 		Die Version der Kubernetes-Ressource.
criticalIncidents[].stackTrace[]
object
Optional 		Eine unstrukturierte Liste von Meldungen aus dem Stacktrace.
criticalIncidents[].stackTrace[].component
string
Optional 		Der Name einer Database Service-Komponente, die die Nachricht protokolliert hat.
criticalIncidents[].stackTrace.message
string
Optional 		Protokollierte Nachricht.
criticalIncidents[].transientUntil
string
Optional 		„TransientUntil“ gibt an, dass das Problem bis zum angegebenen Zeitpunkt als vorübergehend betrachtet werden muss.
endTime
string
Optional 		EndTime ist der Zeitpunkt, zu dem das Failover den endgültigen Status erreicht hat.
internal
object
Optional 		„Intern“ wird von den Systemcontrollern verwendet. Verlassen Sie sich nicht auf die Informationen in diesem Abschnitt.
internal.attempt
integer
Erforderlich 		„Attempt“ wird für die Wiederholungslogik verwendet.
internal.lastPhaseChangeTime
string
Optional 		LastPhaseChangeTime ist der Zeitpunkt, zu dem das L1-Failover zuletzt in eine neue Phase gewechselt ist. Dies wird für die Zeitüberschreitungslogik verwendet.
internal.newPrimary
string
Erforderlich 		„NewPrimary“ ist die Instanz, auf die Sie ein Failover durchführen möchten.
internal.newPrimaryZone
string
Optional 		„NewPrimaryZone“ ist die Zone, zu der wir ein Failover durchführen möchten.
internal.oldPrimary
string
Erforderlich 		„OldPrimary“ ist die Instanz, die zu Beginn des Failovers die primäre Instanz war.
internal.phase
string
Optional 		Die Phase wird verwendet, um den aktuellen Status des Failovers zu verfolgen.
observedGeneration
integer
Optional 		Intern: Die vom Controller beobachtete Generation.
reconciled
boolean
Optional 		Intern: Gibt an, ob die Ressource vom Controller abgeglichen wurde.
startTime
string
Optional 		StartTime ist der Zeitpunkt, zu dem der Failover-Vorgang gestartet wurde.
state
string
Optional 		„State“ ist der aktuelle Status des Failover-Vorgangs. Die Werte sind „InProgress“, „Success“, „Failed_RollbackInProgress“, „Failed_RollbackSuccess“ und „Failed_RollbackFailed“.
  • „InProgress“ bedeutet, dass das Failover noch läuft.
  • „Erfolg“ bedeutet, dass der Failover abgeschlossen wurde. Der Vorgang ist abgeschlossen, wenn die neue primäre Instanz erfolgreich hochgestuft wurde.
  • Failed_RollbackInProgress bedeutet, dass der Operator die neue primäre Instanz nicht hochstufen konnte und versucht, die alte primäre Instanz neu zu starten.
  • Failed_RollbackSuccess bedeutet, dass der Operator die neue primäre Instanz nicht hochstufen konnte und die alte primäre Instanz erfolgreich neu gestartet hat.
  • „Failed_RollbackFailed“ bedeutet, dass der Operator die neue primäre Instanz nicht hochstufen und die alte primäre Instanz nicht neu starten konnte. Der DBCluster muss möglicherweise manuell repariert werden.