הגדרת משאב מותאם אישית של BackupPlan v1.2.0

בוחרים גרסת תיעוד:

סכימת המפרט

‫BackupPlanSpec מגדיר את המצב הרצוי של 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

שדה

סוג
חובה או אופציונלי

 

תיאור
backupLocation
object
אופציונלי
‫BackupLocation מציין את מיקום האחסון של האובייקט המרוחק שבו מאוחסנים הגיבויים. לדוגמה, מפרטים לקטגוריות של Cloud Storage. השדה הזה הוא אופציונלי. כברירת מחדל, הגיבויים מאוחסנים בדיסק הגיבוי.
backupLocation.gcsOptions
object
אופציונלי
‫gcsOptions הוא הפניה לאפשרויות שתלויות ב-Cloud Storage.
backupLocation.gcsOptions.bucket
string
חובה
השדה Bucket הוא שדה חובה (לדוגמה: dbs-dump-bucket). המשתמש צריך לוודא שיש לו גישת כתיבה מתאימה לקטגוריית האחסון מתוך המפעיל.
backupLocation.gcsOptions.key
string
חובה
מפתח האובייקט של קובצי ה-dump. (לדוגמה: ods-dump/scottschema.dmp).
backupLocation.gcsOptions.secretRef
object
אופציונלי
‫SecretRef הוא הפניה לסוד שבו מאוחסנים פרטי הגישה ל-GCS.
backupLocation.gcsOptions.secretRef.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להפנות למשאב סודי.
backupLocation.gcsOptions.secretRef.namespace
string
אופציונלי
‫namespace מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
backupLocation.type
string
חובה

ערכים אפשריים: GCS, ‏ S3.

סוג המאגר (S3 ל-Amazon S3,‏ GCS ל-Cloud Storage של Google), שמציין לסוכן באיזו מערכת אחסון או API להשתמש.
backupRetainDays
integer
אופציונלי

ברירת המחדל: 14, מינימום: 1, מקסימום: 90.

מספר הימים שאחריהם השירות ימחק גיבוי. אם צוין, גיבוי שנוצר במסגרת BackupPlan יימחק באופן אוטומטי אחרי שהגיל שלו יגיע ל-create_time + backup_retain_days. הערכים התקינים הם בין יום אחד ל-90 ימים. אם לא מציינים ערך, ברירת המחדל היא 14 ימי שמירה.
backupSchedules
object
אופציונלי
מגדירה את לוחות הזמנים לסוגים שונים של גיבויים. יש תמיכה בסוגי הגיבויים הבאים: מלא, דיפרנציאלי ומצטבר: https://pgbackrest.org/user-guide.html#concept/backup השדה הזה אופציונלי. כברירת מחדל, המערכת מבצעת גיבוי מלא אחד בכל יום בחצות.
backupSchedules.differential
string
אופציונלי
מגדירה את לוח הזמנים של Cron לגיבוי דיפרנציאלי של pgBackRest. בהתאם לתחביר הרגיל של תזמון Cron: ‏https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.full
string
אופציונלי
מגדיר את לוח הזמנים של Cron לגיבוי מלא של pgBackRest. בהתאם לתחביר הרגיל של תזמון Cron: ‏https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
backupSchedules.incremental
string
אופציונלי
מגדיר את לוח הזמנים של Cron לגיבוי מלא של pgBackRest. בהתאם לתחביר הרגיל של תזמון Cron: ‏https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax
dbclusterRef
string
אופציונלי
שם ה-DBCluster שמוגדר ב-backupplan הזה. זהו שדה חובה שלא ניתן לשינוי.
paused
boolean
אופציונלי

ברירת המחדל: false.

דגל שמציין אם יצירת הגיבוי ב-BackupPlan הזה מושהית. אם הערך הוא true, השירות ישהה את התזמון של גיבויים חדשים ב-BackupPlan הזה. ערך ברירת המחדל הוא False.

סכימת סטטוס

‫BackupPlanStatus מגדיר את המצב הנצפה של 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

שדה

סוג
חובה או אופציונלי

 

תיאור
conditions
list (object)
אופציונליות
התנאים מייצגים את התצפיות הזמינות האחרונות של המצב הנוכחי של הישות.
conditions[]
object
אופציונליות
התנאי מכיל פרטים על היבט אחד של המצב הנוכחי
conditions[].lastTransactionTime
string
חובה
הפעם האחרונה שבה המצב השתנה מסטטוס אחד לאחר. התאריך הזה צריך להיות התאריך שבו המצב הבסיסי השתנה. אם לא ידוע, אפשר להשתמש בזמן שבו השדה של ה-API השתנה.
conditions[].message
string
חובה
הודעה קריאה לאנשים שמציינת פרטים על המעבר. הערך יכול להיות מחרוזת ריקה.
conditions[].observedGeneration
integer
אופציונלי
מייצג את ‎ .metadata.generation שעליו התנאי מבוסס. לדוגמה, אם הערך של ‎ .metadata.generation הוא 12 אבל הערך של ‎ .status.conditions[x].observedGeneration הוא 9, התנאי לא מעודכן ביחס למצב הנוכחי של המכונה.
conditions[].reason
string
חובה
אורך מקסימלי: 1024, אורך מינימלי: 1 מכיל מזהה פרוגרמטי שמציין את הסיבה למעבר האחרון של התנאי. יצרנים של סוגי תנאים ספציפיים יכולים להגדיר ערכים ומשמעויות צפויים לשדה הזה, וגם אם הערכים נחשבים ל-API מובטח. הערך צריך להיות מחרוזת CamelCase. השדה הזה לא יכול להיות ריק.
conditions[].status
string
חובה
סטטוס התנאי, אחד מהערכים True, ‏ False, ‏ Unknown.
conditions[].type
string
חובה
אורך מקסימלי: 316 סוג התנאי ב-CamelCase או ב-foo.example.com/CamelCase.
criticalIncidents
object
חובה
רשימה של כל האירועים הקריטיים הפעילים. ‫CriticalIncident מכיל את כל המידע על אירוע קריטי מתמשך.
criticalIncidents[].code
string
חובה
קוד השגיאה של השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות של DBSE+מספרים, כמו "DBSE1012".
criticalIncidents[].createTime
string
חובה
חותמת הזמן שבה האירוע נוצר במקור.
criticalIncidents[].message
string
אופציונלי
האירוע או השגיאה שהתרחשו.
criticalIncidents[].messageTemplateParams
object
אופציונלי
מכיל צמדי מפתח/ערך שנדרשים כדי ליצור גרסה מבוססת-נתונים וידידותית למשתמש של ההודעה בממשק המשתמש.
criticalIncidents[].resource
object
חובה
מכיל מידע על רכיב Database Service שדיווח על האירוע וגם על המשאב ב-Kubernetes.
criticalIncidents[].resource.component
string
חובה
מזהה פנימי של תת-המערכת של Database Service שדיווחה על האירוע.
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
אופציונלי
השם של רכיב Database Service שתיעד את ההודעה ביומן.
criticalIncidents[].stackTrace.message
string
אופציונלי
הודעה ביומן.
criticalIncidents[].transientUntil
string
אופציונלי
אם השדה TransientUntil מופיע, הוא מציין שהבעיה נחשבת זמנית עד לזמן שצוין.
lastBackupTime
string
אופציונלי
חותמת הזמן של הגיבוי האחרון שבוצע.
nextBackupTime
string
אופציונלי
חותמת הזמן של הגיבוי המתוזמן הבא.
observedGeneration
integer
אופציונלי
פנימי: הדור שנצפה על ידי הבקר.
phase
string
אופציונלי
השלב של BackupPlan.
reconciled
boolean
אופציונלי
פנימי: אם המשאב הותאם על ידי הבקר.
recoveryWindow
object
אופציונלי
חלון הזמן לשחזור שזמין כרגע.
recoveryWindow.begin
string
אופציונלי
שעת ההתחלה.
recoveryWindow.end
string
אופציונלי
שעת הסיום.