הגדרת משאב מותאם אישית של BackupPlan v1.3.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
חובה
שדה חובה (לדוגמה: 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
אופציונלי
מרחב השמות מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
backupLocation.type
string
חובה

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

סוג המאגר (S3 ל-Amazon S3,‏ GCS ל-Google Cloud Storage), שמציין לסוכן באיזו מערכת אחסון או באיזה 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 שהגדרת הגיבוי הזו מגדירה. חובה למלא את השדה הזה, ואי אפשר לשנות אותו.
paused
boolean
אופציונלי

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

דגל שמציין אם יצירת הגיבוי במסגרת BackupPlan מושהית. אם המדיניות מוגדרת כ-true, השירות ישהה את התזמון של גיבויים חדשים במסגרת תוכנית הגיבוי הזו. ברירת המחדל היא 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)
OPTIONALITY
התנאים מייצגים את התצפיות העדכניות ביותר לגבי המצב הנוכחי של הישות.
conditions[]
object
OPTIONALITY
התג Condition מכיל פרטים על היבט אחד של המצב הנוכחי
conditions[].lastTransactionTime
string
חובה
הפעם האחרונה שבה התנאי עבר מסטטוס אחד לסטטוס אחר. התאריך הזה צריך להיות התאריך שבו התנאי הבסיסי השתנה. אם לא ידוע, אפשר להשתמש בזמן שבו השתנה שדה ה-API.
conditions[].message
string
חובה
הודעה קריאה לאנשים שמציינת פרטים על המעבר. יכול להיות שמדובר במחרוזת ריקה.
conditions[].observedGeneration
integer
אופציונלי
מייצג את הערך של ‎ .metadata.generation שעליו מבוסס התנאי. לדוגמה, אם הערך של ‎ .metadata.generation הוא 12 אבל הערך של ‎ .status.conditions[x].observedGeneration הוא 9, התנאי לא עדכני ביחס למצב הנוכחי של המכונה.
conditions[].reason
string
חובה
אורך מקסימלי: 1,024, אורך מינימלי: 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
חובה
מכיל מידע על רכיב שירות מסד הנתונים שדיווח על האירוע, וגם על משאב 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
אופציונלי
שעת הסיום.