Benutzerdefinierte Ressourcendefinition für BackupPlan v1.4.0

Wählen Sie eine Dokumentationsversion aus:

Spezifikationsschema

BackupPlanSpec definiert den gewünschten Status von BackupPlan.

backupLocation:
  gcsOptions:
    bucket: string
    key: string
    secretRef:
      name: string
      namespace: string
  s3Options:
    bucket: string
    caBundle: []string
    endpoint: string
    key: string
    region: 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
BackupLocation gibt den Remote-Objektspeicherort an, an dem Sicherungen gespeichert werden sollen. z. B. Spezifikationen für Cloud Storage-Buckets. Dieses Feld ist optional. Sicherungen werden standardmäßig auf der Sicherungsfestplatte gespeichert.
backupLocation.gcsOptions
object
Optional
gcsOptions ist ein Verweis auf abhängige Optionen für Cloud Storage.
backupLocation.gcsOptions.bucket
string
Erforderlich
„Bucket“ ist ein Pflichtfeld (z. B. dbs-dump-bucket). Ein Nutzer muss dafür sorgen, dass der Operator Schreibzugriff auf den Speicher-Bucket hat.
backupLocation.gcsOptions.key
string
Erforderlich
Objektschlüssel für die Dump-Dateien. (z. B. ods-dump/scottschema.dmp).
backupLocation.gcsOptions.secretRef
object
Optional
SecretRef ist ein Verweis auf das Secret, in dem die GCS-Zugriffsinformationen gespeichert sind.
backupLocation.gcsOptions.secretRef.name
string
Optional
Der Name ist innerhalb eines Namespace eindeutig und dient zum Verweisen auf eine Secret-Ressource.
backupLocation.gcsOptions.secretRef.namespace
string
Optional
Der Namespace definiert den Bereich, in dem der Secret-Name eindeutig sein muss.
backupLocation.s3Options
object
Optional
s3Options ist ein Verweis auf Cloud Storage-abhängige Optionen.
backupLocation.s3Options.bucket
string
Erforderlich
„Bucket“ ist ein Pflichtfeld (z. B. dbs-dump-bucket). Ein Nutzer muss dafür sorgen, dass der Operator Schreibzugriff auf den Speicher-Bucket hat.
backupLocation.s3Options.caBundle
string
Optional
CABundle ist ein Pool von PEM-codierten CA-Zertifikaten, die zum Validieren des Serverzertifikats von StorageGRID verwendet werden.
backupLocation.s3Options.endpoint
string
Optional
Der Endpunkt ist ein S3-Endpunkt.
backupLocation.s3Options.key
string
Erforderlich
Ein Objektschlüssel für die Dump-Dateien. (Zum Beispiel: ods-dump/scottschema.dmp)
backupLocation.s3Options.secretRef
object
Optional
SecretRef ist ein Verweis auf das Kubernetes-Secret, in dem Anmeldedaten für den Zugriff auf den Cloud Storage-Bucket gespeichert sind.
backupLocation.s3Options.secretRef.name
string
Optional
Der Name ist innerhalb eines Namespace eindeutig und dient zum Verweisen auf eine Secret-Ressource.
backupLocation.s3Options.secretRef.namespace
string
Optional
Der Namespace definiert den Bereich, in dem der Secret-Name eindeutig sein muss.
backupLocation.type
string
Erforderlich

Gültige Werte: GCS, S3.

Typ des Repositorys (S3 für Amazon S3, GCS für Google Cloud Storage), der dem Agent mitteilt, welches Speichersystem bzw. welche API verwendet werden soll.
backupRetainDays
integer
Optional

Standard: 14; Minimum: 1, Maximum: 90.

Anzahl der Tage, nach denen der Dienst eine Sicherung löscht. Falls angegeben, wird eine Sicherung, die im Rahmen dieses BackupPlans erstellt wurde, automatisch gelöscht, wenn ihr Alter „create_time + backup_retain_days“ erreicht. Gültige Werte liegen zwischen 1 und 90 Tagen. Wenn keine Angabe erfolgt, beträgt die Standardeinstellung 14 Tage.
backupSchedules
object
Optional
Definiert die Zeitpläne für verschiedene Arten von Sicherungen. Die Sicherungstypen „Vollständig“, „Differenziell“ und „Inkrementell“ werden 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. Entspricht der standardmäßigen Cron-Planer-Syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.full
string
Optional
Definiert den Cron-Zeitplan für eine vollständige pgBackRest-Sicherung. Entspricht der standardmäßigen Cron-Planer-Syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.incremental
string
Optional
Definiert den Cron-Zeitplan für eine vollständige pgBackRest-Sicherung. Entspricht der standardmäßigen Cron-Planer-Syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
dbclusterRef
string
Optional
Der Name des DBCluster, der durch diese Backupplan-Konfiguration konfiguriert wird. Dieses Feld ist erforderlich und unveränderlich.
paused
boolean
Optional

Standardeinstellung: false.

Ein Flag, das angibt, ob die Sicherungserstellung im Rahmen dieses BackupPlans pausiert ist. Wenn „true“ festgelegt ist, wird die Planung neuer Sicherungen im Rahmen dieses BackupPlans pausiert. Die Standardeinstellung ist „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
„Bedingungen“ entspricht den neuesten verfügbaren Beobachtungen zum aktuellen Status der Entität.
conditions[]
object
OPTIONALITÄT
Die Bedingung enthält Details zu einem Aspekt des Stroms.
conditions[].lastTransactionTime
string
Erforderlich
Die letzte Statusänderung des Zustands. Das sollte der Zeitpunkt sein, an dem sich die zugrunde liegende Bedingung geändert hat. Wenn diese Zeit nicht bekannt ist, kann die Zeit verwendet werden, 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. Produzenten bestimmter Bedingungstypen können erwartete Werte und Bedeutungen für dieses Feld definieren und festlegen, ob die Werte als garantierte API gelten. Der Wert sollte 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
Maximale Länge: 316 Art der Bedingung in CamelCase oder in foo.example.com/CamelCase.
criticalIncidents
object
Erforderlich
Eine flache 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-Strings mit einer Zahl, z. B. „DBSE1012“.
criticalIncidents[].createTime
string
Erforderlich
Der Zeitstempel für den Zeitpunkt, zu dem dieser Vorfall am Ursprungsort erstellt wurde.
criticalIncidents[].message
string
Optional
Der Vorfall/Fehler, der aufgetreten ist.
criticalIncidents[].messageTemplateParams
object
Optional
Enthält Schlüssel/Wert-Paare, die zum Generieren einer nutzerfreundlichen, datengesteuerten Version der Mitteilung in der Benutzeroberfläche erforderlich sind.
criticalIncidents[].resource
object
Erforderlich
Enthält Informationen zur Database Service-Komponente, die den Vorfall gemeldet hat, sowie zur Kubernetes-Ressource.
criticalIncidents[].resource.component
string
Erforderlich
Eine interne Kennung des Database Service-Subsystems, 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
Wenn „TransientUntil“ vorhanden ist, gibt dies an, dass das Problem bis zum angegebenen Zeitpunkt als vorübergehend betrachtet werden sollte.
lastBackupTime
string
Optional
Der Zeitstempel der letzten 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 BackupPlan.
reconciled
boolean
Optional
Intern: Gibt an, ob die Ressource vom Controller abgeglichen wurde.
recoveryWindow
object
Optional
Der derzeit verfügbare Zeitraum für die Wiederherstellung.
recoveryWindow.begin
string
Optional
Beginn.
recoveryWindow.end
string
Optional
Ende.