הגדרה של משאב מותאם אישית של Failover v1.9.0

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

• הגרסה הנוכחית (18.4.0)
• 18.4.0
• 17.10.0
• 16.14.0
• 15.18.0

סכמת המפרט

‫FailoverSpec מייצג את הפרמטרים של פעולת מעבר לגיבוי (failover) אחת.

dbclusterRef: string
newPrimary: string

שדה סוג חובה או אופציונלי	תיאור
dbclusterRef
string חובה	‫DBClusterRef הוא שם ה-DBCluster שמשמש להפעלת מעבר לגיבוי בעת כשל. צריך ליצור את האובייקט Failover באותו מרחב שמות של DBCluster שאליו הוא מפנה.
newPrimary
string אופציונלי	‫NewPrimary הוא מכונה במצב המתנה שיועלה כחדש. אם לא בוחרים מכונה, המערכת בוחרת באופן אוטומטי את המכונה הטובה ביותר למעבר במקרה של כשל.

סכימת סטטוס

‫FailoverStatus מייצג את המצב הנוכחי של יתירות כשל.

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

שדה סוג חובה או אופציונלי	תיאור
conditions[]
object אופציונלי	התנאים מייצגים את התצפיות האחרונות שזמינות לגבי המצב הנוכחי של הישות.
conditions[].lastTransitionTime
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.
conditions[].type
string חובה	סוג התנאי ב-CamelCase או בפורמט foo.example.com/CamelCase. ערכים רבים של ‎.condition.type עקביים במשאבים כמו Available. תנאים שרירותיים יכולים להיות שימושיים, למשל .node.status.conditions, ולכן חשוב לפתור את הבעיה. הביטוי הרגולרי שתואם לו הוא (dns1123SubdomainFmt/)?(qualifiedNameFmt).
createTime
string אופציונלי	‫CreateTime הוא הזמן שבו נוצר מנגנון פנימי של תהליך העבודה למעבר לגיבוי בעת כשל.
criticalIncidents[]
object חובה	‫CriticalIncidents היא רשימה של כל האירועים הקריטיים הפעילים.
criticalIncidents[].code
string חובה	הקוד הוא קוד השגיאה של השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות של DBSE+numeric, כמו DBSE1012.
criticalIncidents[].createTime
string חובה	‫CreateTime היא חותמת הזמן שבה האירוע נוצר במקור.
criticalIncidents[].message
string אופציונלי	ההודעה מתארת את האירוע או השגיאה שהתרחשו.
criticalIncidents[].messageTemplateParams
object אופציונלי	‫MessageTemplateParams מכיל צמדי מפתח/ערך שנדרשים ליצירת גרסה ידידותית למשתמש של Message בממשק המשתמש, שמבוססת על נתונים.
criticalIncidents[].resource
object חובה	המשאב מכיל מידע על רכיב שירות מסד הנתונים שדיווח על האירוע, וגם מידע על משאב ב-Kubernetes.
criticalIncidents[].resource.component
string חובה	הרכיב הוא מזהה פנימי של תת-המערכת של שירות מסד הנתונים שדיווחה על האירוע.
criticalIncidents[].resource.location
object אופציונלי	מיקום.
criticalIncidents[].resource.location.cluster
string אופציונלי	שם האשכול של המשאב המושפע ב-Kubernetes.
criticalIncidents[].resource.location.group
string אופציונלי	שם הקבוצה של המשאב ב-Kubernetes.
criticalIncidents[].resource.location.kind
string אופציונלי	הסוג של המשאב ב-Kubernetes.
criticalIncidents[].resource.location.name
string אופציונלי	השם של המשאב המושפע ב-Kubernetes.
criticalIncidents[].resource.location.namespace
string אופציונלי	מרחב השמות של המשאב המושפע ב-Kubernetes.
criticalIncidents[].resource.location.version
string אופציונלי	הגרסה של משאב ב-Kubernetes.
criticalIncidents[].stackTrace[]
object אופציונלי	רשימה לא מובנית של הודעות מדוח קריסות.
criticalIncidents[].stackTrace[].component
string אופציונלי	השם של רכיב Database Service שתיעד את ההודעה ביומן.
criticalIncidents[].stackTrace.message
string אופציונלי	הודעה ביומן.
criticalIncidents[].transientUntil
string אופציונלי	אם המאפיין TransientUntil קיים, המשמעות היא שצריך להתייחס לבעיה כאל בעיה חולפת עד למועד שצוין.
endTime
string אופציונלי	EndTime הוא הזמן שבו יתירות כשל הגיעה למצב הסופי שלה.
internal
object אופציונלי	האפשרות Internal משמשת את בקרי המערכת. אל תסתמכו על המידע בקטע הזה.
internal.attempt
integer חובה	המאפיין attempt משמש ללוגיקה של ניסיונות חוזרים.
internal.lastPhaseChangeTime
string אופציונלי	‫LastPhaseChangeTime הוא הזמן האחרון שבו יתירות הכשל ברמה 1 עברה לשלב חדש. הוא משמש ללוגיקה של זמן קצוב לתפוגה.
internal.newPrimary
string חובה	‫NewPrimary היא המכונה שאליה מנסים לבצע מעבר לגיבוי.
internal.newPrimaryZone
string אופציונלי	‫NewPrimaryZone הוא האזור שאנחנו מנסים להעביר אליו את יתירות הכשל.
internal.oldPrimary
string חובה	‫OldPrimary הוא המופע שהיה ראשי בתחילת המעבר לגיבוי.
internal.phase
string אופציונלי	ערכים חוקיים: StopPrimary, PromoteStandby, ValidateNewPrimary, UpdateOldPrimaryResources, UpdateNewPrimaryResources, Cleanup, Complete, UpdateStandbys, Recreate, PreComplete, RollbackDemoteNewPrimary, RollbackPromoteOldPrimary, RollbackFailed, RollbackSucceeded השלב משמש למעקב אחרי המצב הנוכחי של יתירות הכשל.
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 מציין שהאופרטור לא הצליח לקדם את המופע הראשי החדש, ושהאופרטור לא הצליח להפעיל מחדש את המופע הראשי הישן. יכול להיות שצריך לתקן את DBCluster באופן ידני.