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

סכימת המפרט

ההגדרה BackupPlan Spec מגדירה את המצב שנבחר של BackupPlan.

BackupPlan:
  metadata:
    name: string
  spec:
    backupLocation:
      gcsOptions:
        bucket: string
        key: string
        secretRef:
          name: string
      s3Options:
        bucket: string
        caBundle: []string
        endpoint: string
        key: string
        region: string
        secretRef:
          name: string
      type: string
    backupRetainDays: integer
    backupSchedules:
      differential: string
      full: string
      incremental: string
    dbclusterRef: string
    paused: boolean

שדה

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

 

תיאור
name
string
חובה
השם של משאב BackupPlan.
backupLocation
object
חובה
מציין את המיקום של מאגר האובייקטים המרוחק לאחסון הגיבויים.
backupLocation.gcsOptions
object
אופציונלי
אפשרויות ההגדרה של מאגר Cloud Storage.
backupLocation.gcsOptions.bucket
string
חובה
שם הקטגוריה של Cloud Storage – לדוגמה, dbs-dump-bucket. המשתמש צריך לוודא שיש לו גישת כתיבה לקטגוריית האחסון.
backupLocation.gcsOptions.key
string
חובה
קידומת של מפתח אובייקט לקובצי dump של גיבוי – לדוגמה, ods-dump/scottschema.dmp.
backupLocation.gcsOptions.secretRef
object
אופציונלי
הפניה למשאב Secret שבו מאוחסן מידע הגישה ל-Cloud Storage.
backupLocation.gcsOptions.secretRef.name
string
חובה
השם של משאב Secret.
backupLocation.s3Options
object
אופציונלי
אפשרויות ההגדרה של מאגר אובייקטים תואם ל-Amazon S3 או S3.
backupLocation.s3Options.bucket
string
חובה
שם הקטגוריה ב-S3 – לדוגמה, dbs-dump-bucket. המשתמש צריך לוודא שיש לו גישת כתיבה לקטגוריית האחסון.
backupLocation.s3Options.caBundle
list (string)
אופציונלי
מאגר של אישורי CA בקידוד PEM שמשמשים לאימות אישור שרת האחסון S3.
backupLocation.s3Options.endpoint
string
אופציונלי
כתובת ה-URL של נקודת הקצה של S3 – לדוגמה, https://s3.amazonaws.com.
backupLocation.s3Options.key
string
חובה
קידומת של מפתח אובייקט לקובצי dump של גיבוי – לדוגמה, ods-dump/scottschema.dmp.
backupLocation.s3Options.region
string
חובה
האזור ב-AWS S3 שבו נמצאת הקטגוריה – לדוגמה, us-west-2.
backupLocation.s3Options.secretRef
object
אופציונלי
הפניה אל Secret שמכיל פרטי גישה לאחסון S3.
backupLocation.s3Options.secretRef.name
string
חובה
השם של משאב Secret.
backupLocation.type
string
חובה

ערכים תקינים: GCS, ‏ S3.

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

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

מספר הימים שאחריהם השירות מוחק באופן אוטומטי Backup. אם מציינים ערך, גיבוי Backup שנוצר במסגרת BackupPlan הזה נמחק אוטומטית אחרי שהגיל שלו מגיע ל-createTime + backupRetainDays.
backupSchedules
object
אופציונלי
ההגדרה הזו מגדירה את לוחות הזמנים לסוגים שונים של גיבויים אוטומטיים. יש תמיכה בסוגי הגיבוי הבאים: מלא, דיפרנציאלי ומצטבר. אם לא מציינים אחרת, גיבוי מלא אחד מתבצע כל יום בחצות (0 0 * * *).
backupSchedules.differential
string
אופציונלי
ביטוי cron רגיל שמגדיר את לוח הזמנים לגיבויים דיפרנציאליים אוטומטיים.
backupSchedules.full
string
אופציונלי
ביטוי cron רגיל שמגדיר את התזמון של גיבויים אוטומטיים מלאים (לדוגמה, 0 0 * * *).
backupSchedules.incremental
string
אופציונלי
ביטוי cron רגיל שמגדיר את לוח הזמנים לגיבויים מצטברים אוטומטיים.
dbclusterRef
string
חובה
השם של DBCluster המשאב המותאם אישית שמוגדר בתוכנית הגיבוי הזו. חובה למלא את השדה הזה, ואי אפשר לשנות אותו.
paused
boolean
אופציונלי

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

דגל שמציין אם יצירת הגיבוי במסגרת תוכנית הגיבוי הזו מושהית. אם ההגדרה היא true, השירות מפסיק את התזמון של גיבויים אוטומטיים חדשים.

סכימת סטטוס

‫BackupPlanStatus מגדיר את המצב שנצפה של BackupPlan.

conditions:
- lastTransitionTime: 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[].lastTransitionTime
string
חובה
הפעם האחרונה שבה התנאי עבר מסטטוס אחד לסטטוס אחר. זה הזמן שבו התנאי הבסיסי השתנה. אם לא ידוע מתי השדה השתנה, צריך להשתמש בשעה שבה השדה ב-API השתנה.
conditions[].message
string
חובה
הודעה שקריאה לאנשים עם פרטים על המעבר. הערך בשדה הזה יכול להיות מחרוזת ריקה.
conditions[].observedGeneration
integer
אופציונלי
מייצג את .metadata.generation שהתנאי הוגדר על פיו. לדוגמה, אם .metadata.generation הוא 12 אבל .status.conditions[x].observedGeneration הוא 9, התנאי לא עדכני ביחס למצב הנוכחי של המופע.
conditions[].reason
string
חובה
אורך מקסימלי: 1,024, אורך מינימלי: 1. מכיל מזהה פרוגרמטי שמציין את הסיבה למעבר האחרון של התנאי. יצרנים של סוגים מסוימים של תנאים עשויים להגדיר ערכים ומשמעויות צפויים לשדה הזה. הערך חייב להיות מחרוזת בפורמט CamelCase. השדה הזה לא יכול להיות ריק.
conditions[].status
string
חובה
הסטטוס של התנאי, אחד מהערכים True, False, Unknown.
conditions[].type
string
חובה
אורך מקסימלי: 316. סוג התנאי ב-CamelCase או ב-foo.example.com/CamelCase.
criticalIncidents
list (object)
חובה
רשימה שטוחה של כל האירועים הקריטיים הפעילים. כולל את כל המידע על אירוע קריטי שמתרחש כרגע.
criticalIncidents[].code
string
חובה
קוד השגיאה הספציפי הזה. קודי השגיאה מעוצבים כ-DBSE ואחריהם מספר, כמו DBSE1012.
criticalIncidents[].createTime
string
חובה
חותמת הזמן שבה האירוע הזה נוצר במקור.
criticalIncidents[].message
string
אופציונלי
האירוע או השגיאה שהתרחשו.
criticalIncidents[].messageTemplateParams
object
אופציונלי
השדה מכיל צמדי מפתח/ערך שנדרשים ליצירת גרסה ידידותית למשתמש של ההודעה בממשק המשתמש.
criticalIncidents[].resource
object
חובה
מכיל מידע על רכיב Database Service שדיווח על האירוע, וגם מידע על משאב cluster manager.
criticalIncidents[].resource.component
string
חובה
מזהה פנימי של מערכת המשנה של שירות מסד הנתונים שדיווחה על התקרית.
criticalIncidents[].resource.location
object
אופציונלי
המיקום שבו נמצא המשאב.
criticalIncidents[].resource.location.cluster
string
אופציונלי
השם של האשכול של משאב מנהל האשכול הרלוונטי.
criticalIncidents[].resource.location.group
string
אופציונלי
שם הקבוצה של משאב ניהול האשכול.
criticalIncidents[].resource.location.kind
string
אופציונלי
סוג המשאב של מנהל האשכול.
criticalIncidents[].resource.location.name
string
אופציונלי
השם של משאב ניהול האשכולות הרלוונטי.
criticalIncidents[].resource.location.namespace
string
אופציונלי
מרחב השמות של משאב ניהול האשכולות המושפע.
criticalIncidents[].resource.location.version
string
אופציונלי
הגרסה של משאב ניהול האשכול.
criticalIncidents[].stackTrace
list (object)
אופציונלי
רשימה לא מובנית של הודעות מדוח קריסות.
criticalIncidents[].stackTrace.component
string
אופציונלי
השם של רכיב בשירות מסד הנתונים שרשם את ההודעה ביומן.
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
אופציונלי
שעת הסיום.