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

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

סכמת המפרט

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

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
חובה 		‫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
חובה 		רכיב הוא מזהה פנימי של מערכת המשנה של שירות מסד הנתונים שדיווחה על האירוע.
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
אופציונלי 		הרכיב הוא השם של רכיב Database Service שתיעד את ההודעה.
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 באופן ידני.