הגדרת משאב מותאם אישית של שכפול גרסה 1.3.0

בחירת גרסה של מאמר העזרה:

סכימת המפרט

‫ReplicationSpec מגדיר את המצב הרצוי של השכפול.

dbcluster:
  name: string
downstream:
  control: string
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string
upstream:
  applicationName: string
  logicalReplication:
    databaseName: string
    pluginName: string
  password:
    name: string
    namespace: string
  replicationSlotName: string
  synchronous: string
  username: string

שדה

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

 

תיאור
dbcluster
object
אופציונלי
‫DBCluster הוא ה-DBCluster שאליו שייך השכפול הזה.
dbcluster.name
string
אופציונלי
שם הגורם המפנה. מידע נוסף זמין במאמר שמות.
downstream
object
אופציונלי
המאפיין downstream מכיל מפרטים לשכפול מסד נתונים במורד הזרם.
downstream.control
string
חובה
הפקד מציין את פעולת השכפול שתתבצע במסד הנתונים הזה. הערכים המותרים הם setup,‏ promote ו-rewind.
downstream.host
string
חובה
המאפיין Host הוא נקודת הקצה של החיבור למסד הנתונים במעלה הזרם, שמסד הנתונים הזה יכול לגשת אליה לצורך שכפול.
downstream.password
object
חובה
הסיסמה היא ההפניה לסוד שמאוחסן במסד הנתונים של המקור, והיא הסיסמה של משתמש השכפול.
downstream.password.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להתייחס למשאב סודי.
downstream.password.namespace
string
אופציונלי
מרחב השמות מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
downstream.port
integer
אופציונלי
היציאה היא היציאה של מסד הנתונים במעלה הזרם שאליה מסד הנתונים הזה יכול לגשת לצורך שכפול. ברירת המחדל היא 5432.
downstream.replicationslotname
string
חובה
‫ReplicationSlotName הוא השם של משבצת השכפול שנוצרה במסד הנתונים במעלה הזרם. הוא משמש את מסד הנתונים הזה לשכפול.
downstream.username
string
חובה
שם המשתמש הוא השם של משתמש השכפול שנוצר במסד הנתונים של המקור. הוא משמש את מסד הנתונים הזה כדי להתחבר למעלה לצורך שכפול.
upstream
object
אופציונלי
המאגר במעלה הזרם מכיל מפרט לשכפול מסד הנתונים במעלה הזרם.
upstream.applicationName
string
אופציונלי
‫applicationName הוא המזהה של חיבור השכפול הסינכרוני. הערך הזה נדרש אם Synchronous מוגדר כ-true.
upstream.logicalReplication
object
אופציונלי
‫LogicalReplication מציין את הגדרת השכפול הלוגי עבור משבצת השכפול. אם השדה ריק, משבצת הרפליקציה מוגדרת כמשבצת רפליקציה פיזית.
upstream.logicalReplication.databaseName
string
אופציונלי
‫DatabaseName הוא מסד הנתונים שמשויך למשבצת הזו. רק שינויים ממסד הנתונים הזה מועברים בסטרימינג דרך המשבצת.
upstream.logicalReplication.pluginName
string
אופציונלי
PluginName הוא פלאגין הפענוח שמשויך למשבצת הזו. פרטים נוספים זמינים במאמר הסבר על פענוח לוגי.
upstream.password
object
חובה
הסיסמה היא ההפניה לסוד שבו מאוחסנת הסיסמה של משתמש השכפול. אם לא מספקים סיסמה, נוצרת סיסמה והיא נשמרת בסוד שמוצג בסטטוס.
upstream.password.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להתייחס למשאב סודי.
upstream.password.namespace
string
אופציונלי
מרחב השמות מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
upstream.replicationslotname
string
אופציונלי
‫ReplicationSlotName הוא השם של משבצת השכפול שתשמש לשכפול. אם לא מספקים את השם, נוצר שם למשבצת השכפול והוא מוצג בסטטוס.
upstream.synchronous
string
אופציונלי
ההגדרה Synchronous מציינת אם צריך להגדיר את משבצת השכפול לשכפול סינכרוני. אם הערך הוא true, שם האפליקציה מתווסף לרשימת הגיבויים הסינכרוניים. ברירת המחדל היא false.
הערה: יכול להיות שהפעולה הזו תשפיע לרעה על הביצועים.
upstream.username
string
אופציונלי
שם המשתמש הוא השם של משתמש השכפול שישמש לשכפול. אם לא מספקים שם משתמש, המערכת יוצרת שם משתמש ומציגה אותו בסטטוס.

סכימת סטטוס

‫ReplicationStatus מגדיר את המצב שנצפה של השכפול.

conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
downstream:
  physicalDownstream:
    setupStrategies:
      endedAt: string
      message: string
      retries: integer
      startedAt: string
      state: string
      strategy: string
    state: string
observedGeneration: integer
reconciled: boolean
upstream:
  host: string
  password:
    name: string
    namespace: string
  port: integer
  replicationSlotName: string
  username: string

שדה

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

 

תיאור
conditions[]
object
אופציונלי
המאפיין Conditions מייצג את התצפיות העדכניות ביותר על המצב הנוכחי של הישות.
conditions[].lastTransitionTime
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.
conditions[].type
string
חובה
סוג התנאי בפורמט CamelCase או בפורמט foo.example.com/CamelCase. הרבה ערכים של ‎.condition.type עקביים בין משאבים, כמו Available. מכיוון שתנאים שרירותיים יכולים להיות שימושיים (ראו .node.status.conditions), היכולת לפתור קונפליקטים היא חשובה. הביטוי הרגולרי שתואם לו הוא (dns1123SubdomainFmt/)?(qualifiedNameFmt).
criticalIncidents[]
object
חובה
‫CriticalIncidents היא רשימה שטוחה של כל האירועים הקריטיים הפעילים.
criticalIncidents[].code
string
חובה
‫Code הוא קוד השגיאה של השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות 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, המשמעות היא שהבעיה נחשבת לחולפת עד למועד שצוין.
downstream
object
אופציונלי
המאפיין Downstream מכיל את המצב שנצפה במסד הנתונים של השכפול במורד הזרם.
downstream.physicalDownstream
object
אופציונלי
downstream.physicalDownstream.setupStrategies
object
אופציונלי
‫SetupStrategies מכיל מידע על הביצוע של כל שיטת הגדרה שניסיתם להשתמש בה. הם מופיעים ברשימה הזו באותו סדר שבו הוגדרו האסטרטגיות במפרט.
downstream.physicalDownstream.setupStrategies.endedAt
string
אופציונלי
השדה EndedAt מציין את השעה שבה הסתיים הניסיון האחרון של האסטרטגיה הזו.
downstream.physicalDownstream.setupStrategies.message
string
אופציונלי
ההודעה היא תיאור של הסיבה לכך שניסיון ההגדרה נמצא במצב הנוכחי.
downstream.physicalDownstream.setupStrategies.retries
integer
אופציונלי
‫Retries (ניסיונות חוזרים) הוא מספר הפעמים שהאסטרטגיה הזו נוסתה מחדש.
downstream.physicalDownstream.setupStrategies.startedAt
string
אופציונלי
הערך StartedAt הוא הזמן שבו התחיל הניסיון האחרון להשתמש באסטרטגיה הזו.
downstream.physicalDownstream.setupStrategies.state
string
חובה
המאפיין 'מצב' מתאר את המצב הנוכחי של אסטרטגיית ההגדרה הזו. אפשר להזין בו את הערכים הבאים:
InProgress: האסטרטגיה פועלת כרגע.‫
Success: שיטת הבידינג הושלמה בהצלחה ולא יבוצעו ניסיונות נוספים להגדרת שיטות בידינג.
Error: השיטה נכשלה, אבל המערכת תנסה שוב. בשדה 'ניסיונות חוזרים' יופיע מספר הפעמים שבהן נעשה ניסיון חוזר להשתמש בשיטה הזו.
Fallback: השיטה נכשלה ולא תהיה אפשרות לנסות שוב. במקום זאת, המערכת תעבור לאסטרטגיית הבידינג הבאה שזמינה, אם קיימת כזו.
Unknown
downstream.physicalDownstream.setupStrategies.strategy
string
חובה
הערך Strategy הוא השם של סוג השיטה שאליה מתייחס הסטטוס הזה.
downstream.physicalDownstream.state
object
אופציונלי
הסטטוס הוא סטטוס השכפול כפי שמופיע בטבלה pg_stat_wal_receiver של שרת מסד הנתונים במורד הזרם.
observedgeneration
integer
אופציונלי
פנימי: הדור שנצפה על ידי הבקר.
reconciled
boolean
אופציונלי
פנימי: האם המשאב הותאם על ידי בקר.
upstream
object
אופציונלי
ה-upstream מכיל את המצב שנצפה של מסד הנתונים של השכפול upstream.
upstream.host
string
אופציונלי
המארח הוא נקודת הקצה של החיבור למסד הנתונים הזה, שמסדי הנתונים במורד הזרם יכולים לגשת אליה לצורך שכפול.
upstream.password
object
אופציונלי
הסיסמה היא ההפניה לסוד שבו מאוחסנת הסיסמה של משתמש השכפול במסד הנתונים הזה.
upstream.password.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להתייחס למשאב סודי.
upstream.password.namespace
string
אופציונלי
מרחב השמות מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
upstream.port
integer
אופציונלי
היציאה היא היציאה של מסד הנתונים הזה שאליה מסדי נתונים במורד הזרם יכולים לגשת לצורך שכפול.
upstream.replicationslotname
string
אופציונלי
‫ReplicationSlotName הוא השם של משבצת השכפול שנוצרה במסד הנתונים הזה. מסדי נתונים במורד הזרם יכולים להשתמש במשבצת השכפול הזו לשכפול.
upstream.username
string
אופציונלי
שם המשתמש הוא השם של משתמש השכפול במסד הנתונים הזה. מסדי נתונים במורד הזרם יכולים להשתמש במשתמש הזה כדי להתחבר למסד הנתונים הזה לצורך שכפול.