הגדרה מותאמת אישית של משאב Switchover v1.7.0

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

סכמת המפרט

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

dbclusterRef: string
newPrimary: string
primaryHost: string

שדה

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

 

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

סכימת סטטוס

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

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:
  newPrimary: string
  oldPrimary: string
  phase: string
observedGeneration: integer
reconciled: boolean
startTime: string
state: string

שדה

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

 

תיאור
conditions
list (object)
אופציונלי
התנאים מייצגים את התצפיות האחרונות הזמינות של המצב הנוכחי של הישות.
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
חובה
‫message הוא הודעה קריאה לאנשים שמציינת פרטים על המעבר. יכול להיות שמדובר במחרוזת ריקה.
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 מכיל צמדי מפתח/ערך שנדרשים ליצירת גרסה ידידותית למשתמש של ההודעה שמבוססת על נתונים בממשק המשתמש.
criticalIncidents[].resource
object
חובה
המשאב מכיל מידע על רכיב שירות מסד הנתונים שדיווח על האירוע, וגם על משאב ב-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
אופציונלי
‫Group הוא הגרסה של משאב ב-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 משמשת את בקרי המערכת. אל תסתמכו על המידע שבקטע הזה.
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

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