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

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

סכמת המפרט

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

dbclusterRef: string
newPrimary: string
newPrimaryInstance: string
primaryHost: string

שדה

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

 

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

סכימת סטטוס

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

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
createTime: string
critcalIncidents:
- 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
חובה 		ההודעה היא הודעה קריאה (לבני אדם) שמציינת פרטים על המעבר. הערך יכול להיות מחרוזת ריקה.
conditions[].observedGeneration
integer
אופציונלי 		‫observedGeneration מייצג את הערך של ‎ .metadata.generation שעליו התבססה הגדרת התנאי. לדוגמה, אם הערך של ‎ .metadata.generation הוא 12, אבל הערך של ‎ .status.conditions[x].observedGeneration הוא 9, התנאי לא מעודכן ביחס למצב הנוכחי של המכונה.
conditions[].reason
string
חובה 		הסיבה מכילה מזהה פרוגרמטי שמציין את הסיבה למעבר האחרון של התנאי. יצרנים של סוגי תנאים ספציפיים יכולים להגדיר ערכים ומשמעויות צפויים לשדה הזה, וגם אם הערכים נחשבים ל-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
חובה 		המשאב מכיל מידע על רכיב שירות מסד הנתונים שדיווח על האירוע, וגם על משאב ב-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
אופציונלי 		‫Namespace הוא מרחב השמות של המשאב המושפע ב-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.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 באופן ידני.