הגדרה של משאב בהתאמה אישית ב-Switchover בגרסה 1.9.0

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

סכימת המפרט

‫SwitchoverSpec מגדיר את המצב שנבחר של Switchover.

dbclusterRef: string
newPrimary: string
primaryHost: string

שדה

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

 

תיאור
dbclusterRef
string
אופציונלי
‫DBClusterRef הוא שם ה-DBCluster שמשמש להפעלת מעבר הגיבוי לשחזור. צריך ליצור את האובייקט Switchover באותו מרחב שמות כמו ה-DBCluster שאליו הוא מפנה. חובה למלא את השדה הזה כדי לבצע מעבר.
newPrimary
string
אופציונלי
‫NewPrimary הוא מופע ההמתנה שאליו מתבצעת ההחלפה עם המופע הראשי הנוכחי.
primaryHost
string
אופציונלי
‫PrimaryHost היא כתובת ה-IP שתמיד מצביעה על המכונה הראשית.

סכימת סטטוס

הסטטוס של המעבר מגדיר את המצב שנצפה של המעבר.

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
createTime: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams:
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
endTime: string
internal:
  attempt: integer
  newPrimary: string
  oldPrimary: string
  phase: string
observedGeneration: integer
reconciled: boolean
startTime: string
state: string

שדה

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

 

תיאור
conditions
list (object)
אופציונלי
המאפיין Conditions מייצג את התצפיות האחרונות שזמינות לגבי המצב הנוכחי של הישות.
conditions[]
object
אופציונלי
התנאי מכיל פרטים על היבט אחד של המצב הנוכחי של משאב ה-API הזה. ‪--- This struct is intended for direct use as an array at the field path .status.conditions. לדוגמה, \n type FooStatus struct{ // Represents the observations of a foo's current state. // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }
conditions[].lastTransactionTime
string
חובה
‫lastTransitionTime הוא הזמן האחרון שבו התרחש מעבר של התנאי מסטטוס אחד לסטטוס אחר. התאריך הזה צריך להיות התאריך שבו המצב הבסיסי השתנה. אם לא ידוע, אפשר להשתמש בזמן שבו השדה של ה-API השתנה.
conditions[].message
string
חובה
ההודעה היא הודעה קריאה (לבני אדם) שמציינת פרטים על המעבר. יכול להיות שמדובר במחרוזת ריקה.
conditions[].observedGeneration
integer
אופציונלי
‫observedGeneration מייצג את הערך של ‎ .metadata.generation שעליו התבססה הגדרת התנאי. לדוגמה, אם הערך של ‎ .metadata.generation הוא 12, אבל הערך של ‎ .status.conditions[x].observedGeneration הוא 9, התנאי לא מעודכן ביחס למצב הנוכחי של המכונה.
conditions[].reason
string
חובה
השדה reason מכיל מזהה פרוגרמטי שמציין את הסיבה למעבר האחרון של התנאי. יוצרים של סוגי תנאים ספציפיים יכולים להגדיר ערכים ומשמעויות צפויים לשדה הזה, ולקבוע אם הערכים נחשבים ל-API יציב. הערך חייב להיות מחרוזת CamelCase. השדה הזה לא יכול להיות ריק.
conditions[].status
string
חובה

ערכים תקינים: "True", ‏ "False",‏ Unknown

סטטוס התנאי, אחד מהערכים True, ‏ False, ‏ Unknown.
conditions[].type
string
חובה
סוג התנאי ב-CamelCase או ב-foo.example.com/CamelCase. ‫--- הרבה ערכים של ‎ .condition.type עקביים בין משאבים, כמו Available, אבל מכיוון שתנאים שרירותיים יכולים להיות שימושיים (ראו ‎ .node.status.conditions), חשוב שתהיה אפשרות למנוע התנגשויות. הביטוי הרגולרי שאליו הוא מתאים הוא (dns1123SubdomainFmt/)?(qualifiedNameFmt)
createTime
string
אופציונלי
‫CreateTime היא השעה שבה נוצר מנגנון פנימי של תהליך העבודה למעבר.
criticalIncidents
list (object)
אופציונלי
‫CriticalIncidents היא רשימה של כל האירועים הקריטיים הפעילים.
criticalIncidents[]
object
אופציונלי
‫CriticalIncident מכיל את כל המידע על תקרית קריטית שמתרחשת כרגע.
criticalIncidents[].code
string
חובה
הקוד הוא קוד השגיאה של השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות אלפאנומריות שמתחילות ב-DBSE, כמו DBSE1012.
criticalIncidents[].createTime
string
חובה
‫CreateTime היא חותמת הזמן שבה האירוע הזה נוצר במקור.
criticalIncidents[].message
string
אופציונלי
ההודעה מתארת את האירוע או השגיאה שהתרחשו.
criticalIncidents[].messageTemplateParams
object
אופציונלי
‫MessageTemplateParams מכיל צמדי מפתח/ערך שנדרשים כדי ליצור גרסה ידידותית למשתמש של Message בממשק המשתמש, שמבוססת על נתונים.
criticalIncidents[].resource
object
חובה
המשאב מכיל מידע על רכיב Database Service שדיווח על האירוע, וגם על המשאב ב-Kubernetes.
criticalIncidents[].resource.component
string
חובה
הרכיב הוא מזהה פנימי של תת-המערכת של Database Service שדיווחה על האירוע.
criticalIncidents[].resource.location
object
אופציונלי
מיקום
criticalIncidents[].resource.location.cluster
string
אופציונלי
‫Cluster הוא שם האשכול של משאב ב-Kubernetes שהושפע.
criticalIncidents[].resource.location.group
string
אופציונלי
‫Group הוא שם הקבוצה של משאב ב-Kubernetes.
criticalIncidents[].resource.location.kind
string
אופציונלי
‫Kind הוא סוג המשאב ב-Kubernetes.
criticalIncidents[].resource.location.name
string
אופציונלי
‫Name הוא השם של המשאב המושפע ב-Kubernetes.
criticalIncidents[].resource.location.namespace
string
אופציונלי
מרחב השמות הוא מרחב השמות של משאב ב-Kubernetes שהושפע.
criticalIncidents[].resource.location.version
TYPE
אופציונלי
הקבוצה היא הגרסה של המשאב ב-Kubernetes.
criticalIncidents[].stackTrace
list (object)
אופציונלי
‫StackTrace מכיל רשימה לא מובנית של הודעות מדוח הקריסות.
criticalIncidents[].stackTrace[]
object
אופציונלי
‫CriticalIncidentStackTraceMessage מכיל מידע על דוח הקריסות שזמין לגבי האירוע.
criticalIncidents[].stackTrace[].component
string
אופציונלי
רכיב הוא השם של רכיב בשירות מסד נתונים שרשם את ההודעה ביומן.
criticalIncidents[].stackTrace[].message
string
אופציונלי
הודעה ביומן.
criticalIncidents[].stackTrace[].message
string
אופציונלי
אם השדה TransientUntil קיים, הוא מציין שהבעיה נחשבת זמנית עד לזמן שצוין.
endTime
string
אופציונלי
‫EndTime הוא הזמן שבו המעבר הגיע למצב הסופי שלו.
internal
object
אופציונלי
האפשרות "פנימי" משמשת את בקרי המערכת. אל תסתמכו על המידע שבקטע הזה.
internal.attempt
integer
חובה
המאפיין attempt משמש ללוגיקה של ניסיונות חוזרים. ברירת המחדל היא 0.
internal.newPrimary
string
חובה
‫NewPrimary הוא המכונה שאנחנו מנסים להעביר אליה.
internal.oldPrimary
string
חובה
‫OldPrimary הוא המכונה שהייתה הראשית בתחילת המעבר.
internal.phase
string
אופציונלי

ערכים תקינים: UpdateDbcluster, ‏ StopPrimary, PromoteStandby, ‏ ValidateNewPrimary, UpdateOldPrimaryResources, ‏ UpdateNewPrimaryResources, UpdateOldPrimaryConfigs, ‏ Complete, SyncOldPrimary, ‏ StartOldPrimary, PreSuccess, ‏ RepointStandbys, RollbackPrimary, ‏ RollbackStandbys

השלב משמש למעקב אחרי המצב הנוכחי של המעבר
observedGeneration
integer
אופציונלי
פנימי: הדור שנצפה על ידי הבקר.
reconciled
boolean
אופציונלי
פנימי: מציין אם המשאב הותאם על ידי בקר.
startTime
string
אופציונלי
‫StartTime הוא הזמן שבו התחילה פעולת המעבר.
state
string
אופציונלי

ערכים תקפים: InProgress, ‏ Success, Failed_RollbackInProgress, ‏ Failed_RollbackSuccess, Failed_RollbackFailed

המצב הוא המצב הנוכחי של פעולת המעבר. הערכים הם InProgress,‏ Success,‏ Failed_RollbackInProgress,‏ Failed_RollbackSuccess ו-Failed_RollbackFailed.
  • InProgress מציין שהמעבר עדיין מתבצע.
  • Success פירושו שהמעבר הושלם.
  • ‫Failed_RollbackInProgress מציין שהאופרטור לא הצליח לקדם את המופע הראשי החדש, והוא מנסה להפעיל מחדש את המופע הראשי הישן.
  • ‫Failed_RollbackSuccess פירושו שהאופרטור לא הצליח לקדם את המכונה הראשית החדשה, ושהוא הפעיל מחדש בהצלחה את המכונה הראשית הישנה.
  • ‫Failed_RollbackFailed מציין שהאופרטור לא הצליח לקדם את המופע הראשי החדש, ושהאופרטור לא הצליח להפעיל מחדש את המופע הראשי הישן. יכול להיות שיהיה צורך לתקן את DBCluster באופן ידני.