Benutzerdefinierte Ressourcendefinition für BackupPlan v1.1.1

Spezifikationsschema

BackupPlanSpec definiert den gewünschten Status von BackupPlan.

backupLocation:
  gcsOptions:
    bucket: string
    key: string
    secretRef:
      name: string
      namespace: string
  type: string
backupRetainDays: integer
backupSchedules:
  differential: string
  full: string
  incremental: string
dbclusterRef: string
paused: boolean

Feld Typ Erforderlich oder optional	Beschreibung
backupLocation
object Optional	Mit BackupLocation wird der Speicherort für Remote-Objekte angegeben, an dem Sicherungen gespeichert werden. z. B. Spezifikationen für Cloud Storage-Buckets. Dieses Feld ist optional. Sicherungen werden standardmäßig auf dem Sicherungslaufwerk gespeichert.
backupLocation.gcsOptions
object Optional	gcsOptions ist ein Verweis auf Cloud Storage-abhängige Optionen.
backupLocation.gcsOptions.bucket
string Erforderlich	Bucket ist ein Pflichtfeld (z. B. dbs-dump-bucket). Ein Nutzer muss für einen ordnungsgemäßen Schreibzugriff auf den Speicher-Bucket innerhalb des Operators sorgen.
backupLocation.gcsOptions.key
string Erforderlich	Objektschlüssel für die Dumpdateien. (z. B. ods-dump/scottschema.dmp).
backupLocation.gcsOptions.secretRef
object Optional	SecretRef ist ein Verweis auf das Secret, in dem GCS-Zugriffsinformationen gespeichert sind.
backupLocation.gcsOptions.secretRef.name
string Optional	Der Name ist innerhalb eines Namespace eindeutig, um auf eine Secret-Ressource zu verweisen.
backupLocation.gcsOptions.secretRef.namespace
string Optional	Der Namespace definiert den Bereich, in dem der Name des Secrets eindeutig sein muss.
backupLocation.type
string Erforderlich	Gültige Werte: GCS, S3. Repository-Typ (S3 für Amazon S3, GCS für Google Cloud Storage), der dem Agenten mitteilt, welches Speichersystem/welche API verwendet werden soll.
backupRetainDays
integer Optional	Standard: 14; Mindestwert: 1, Höchstwert: 90. Anzahl der Tage, nach denen der Dienst eine Sicherung löscht. Wenn angegeben, wird eine Sicherung, die gemäß diesem Sicherungsplan erstellt wurde, automatisch gelöscht, wenn ihr Alter create_time + backup_retain_days erreicht. Gültige Werte sind 1 bis 90 Tage. Wenn keine Angabe gemacht wird, ist der Standardwert 14 Tage.
backupSchedules
object Optional	Hier werden die Zeitpläne für verschiedene Arten von Sicherungen definiert. Es werden vollständige, differenzielle und inkrementelle Sicherungstypen unterstützt: https://pgbackrest.org/user-guide.html#concept/backup Dieses Feld ist optional. Standardmäßig wird jeden Tag um Mitternacht eine vollständige Sicherung erstellt.
backupSchedules.differential
string Optional	Definiert den Cron-Zeitplan für eine differenzielle pgBackRest-Sicherung. Sie folgt der Standardsyntax für Cron-Zeitpläne: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.full
string Optional	Hiermit wird der Cron-Zeitplan für eine vollständige pgBackRest-Sicherung definiert. Sie folgt der Standardsyntax für Cron-Zeitpläne: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.incremental
string Optional	Hiermit wird der Cron-Zeitplan für eine vollständige pgBackRest-Sicherung definiert. Sie folgt der Standardsyntax für Cron-Zeitpläne: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
dbclusterRef
string Optional	Der Name des DBClusters, der mit diesem Sicherungsplan konfiguriert wird. Dieses Feld ist ein Pflichtfeld und unveränderlich.
paused
boolean Optional	Standardeinstellung: false. Ein Flag, das angibt, ob die Sicherungserstellung für diesen Sicherungsplan pausiert ist. Wenn diese Option auf „true“ gesetzt ist, wird die Planung neuer Sicherungen unter diesem Sicherungsplan pausiert. Standardeinstellung: „False“.

Statusschema

BackupPlanStatus definiert den beobachteten Status von BackupPlan.

conditions:
- lastTransactionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
lastBackupTime: string
nextBackupTime: string
observedGeneration: integer
phase: string
reconciled: boolean
recoveryWindow:
  begin: string
  end: string

Feld Typ Erforderlich oder optional	Beschreibung
conditions
list (object) OPTIONALITÄT	„Zustände“ entspricht den neuesten verfügbaren Beobachtungen zum aktuellen Status der Entität.
conditions[]
object OPTIONALITÄT	Die Bedingung enthält Details zu einem Aspekt der aktuellen
conditions[].lastTransactionTime
string Erforderlich	Die letzte Statusänderung des Zustands. Dies sollte der Zeitpunkt sein, zu dem sich die zugrunde liegende Bedingung geändert hat. Wenn das nicht bekannt ist, ist es in Ordnung, die Uhrzeit zu verwenden, zu der sich das API-Feld geändert hat.
conditions[].message
string Erforderlich	Eine menschenlesbare Nachricht mit Details zur Umstellung. Dies kann auch ein leerer String sein.
conditions[].observedGeneration
integer Optional	Stellt die .metadata.generation dar, anhand derer die Bedingung festgelegt wurde. 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	Maximale Länge: 1.024, minimale Länge: 1 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 angeben, ob die Werte als garantierte API betrachtet werden. Der Wert sollte ein CamelCase-String sein. Dieses Feld darf nicht leer sein.
conditions[].status
string Erforderlich	Status der Bedingung, entweder „Wahr“, „Falsch“ oder „Unbekannt“.
conditions[].type
string Erforderlich	Maximale Länge: 316 Art der Bedingung in CamelCase oder in foo.beispiel.de/CamelCase.
criticalIncidents
object Erforderlich	Eine Liste aller aktiven kritischen Vorfälle. „CriticalIncident“ enthält alle Informationen zu einem laufenden kritischen Vorfall.
criticalIncidents[].code
string Erforderlich	Der Fehlercode dieses bestimmten Fehlers. Fehlercodes sind DBSE-Nummernstrings wie „DBSE1012“.
criticalIncidents[].createTime
string Erforderlich	Der Zeitstempel, zu dem dieser Vorfall an der Quelle erstellt wurde.
criticalIncidents[].message
string Optional	Den aufgetretenen Vorfall/Fehler.
criticalIncidents[].messageTemplateParams
object Optional	Enthält Schlüssel/Wert-Paare, die zum Generieren einer nutzerfreundlichen, datengestützten Version der Mitteilung in der Benutzeroberfläche erforderlich sind.
criticalIncidents[].resource
object Erforderlich	Enthält Informationen zur Datenbankdienstkomponente, über die der Vorfall gemeldet wurde, sowie zur Kubernetes-Ressource.
criticalIncidents[].resource.component
string Erforderlich	Eine interne Kennung des Datenbankdienst-Subsystems, über das das Problem gemeldet wurde.
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 Stack-Trace.
criticalIncidents[].stackTrace.component
string Optional	Der Name einer Datenbankdienstkomponente, die die Meldung protokolliert hat.
criticalIncidents[].stackTrace.message
string Optional	Geloggte Nachricht.
criticalIncidents[].transientUntil
string Optional	Wenn „TransientUntil“ vorhanden ist, wird damit angegeben, dass das Problem bis zum angegebenen Zeitpunkt als vorübergehend betrachtet werden sollte.
lastBackupTime
string Optional	Der Zeitstempel der letzten ausgeführten Sicherung.
nextBackupTime
string Optional	Der Zeitstempel für die nächste geplante Sicherung.
observedGeneration
integer Optional	Intern: Die vom Controller beobachtete Generation.
phase
string Optional	Die Phase eines Sicherungsplans.
reconciled
boolean Optional	„Intern“: Gibt an, ob die Ressource vom Controller abgeglichen wurde.
recoveryWindow
object Optional	Der derzeit verfügbare Wiederherstellungszeitraum.
recoveryWindow.begin
string Optional	Beginn.
recoveryWindow.end
string Optional	Endzeit.