הגדרת משאב מותאם אישית של שכפול v1.4.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 שאליו שייך ה-Replication הזה.
dbcluster.name
string
אופציונלי
שם הגורם המקשר. מידע נוסף זמין במאמר שמות.
downstream
object
אופציונלי
‫Downstream מכיל מפרטים לשכפול מסד נתונים במורד הזרם.
downstream.control
string
חובה
הפקד מציין את פעולת הרפליקציה שתתבצע במסד הנתונים הזה. הערכים המותרים הם setup,‏ promote ו-rewind.
downstream.host
string
חובה
המארח הוא נקודת הקצה של החיבור של מסד הנתונים במעלה הזרם, שמסד הנתונים הזה יכול לגשת אליה לצורך שכפול.
downstream.password
object
חובה
הסיסמה היא ההפניה לסוד שבו מאוחסנת סיסמת המשתמש לשכפול של מסד הנתונים במעלה הזרם.
downstream.password.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להפנות למשאב סודי.
downstream.password.namespace
string
אופציונלי
‫namespace מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
downstream.port
integer
אופציונלי
היציאה היא היציאה של מסד הנתונים במעלה הזרם, שמסד הנתונים הזה יכול לגשת אליה לצורך שכפול. ברירת המחדל היא 5432.
downstream.replicationslotname
string
חובה
‫ReplicationSlotName הוא השם של משבצת הרפליקציה שנוצרה במסד הנתונים במעלה הזרם. מסד הנתונים הזה משתמש בו לשכפול.
downstream.username
string
חובה
‫Username הוא השם של משתמש הרפליקציה שנוצר במסד הנתונים במעלה הזרם. מסד הנתונים הזה משתמש בו כדי להתחבר למעלה לצורך שכפול.
upstream
object
אופציונלי
השדה Upstream מכיל מפרט לשכפול מסד נתונים במעלה הזרם.
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
אופציונלי
‫namespace מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
upstream.replicationslotname
string
אופציונלי
‫ReplicationSlotName הוא השם של משבצת הרפליקציה שמשמשת לרפליקציה. אם לא מציינים שם, נוצר שם למשבצת הרפליקציה והוא מוצג בסטטוס.
upstream.synchronous
string
אופציונלי
הערך Synchronous מציין אם צריך להגדיר את משבצת הרפליקציה לרפליקציה סינכרונית. אם הערך הוא True, המאפיין applicationName מתווסף לרשימת הגיבויים הסינכרוניים. ברירת המחדל היא 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:
    passwordResourceVersion: string
    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[].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).
criticalIncidents[]
object
חובה
‫CriticalIncidents היא רשימה של כל האירועים הקריטיים הפעילים.
criticalIncidents[].code
string
חובה
הקוד הוא קוד השגיאה של השגיאה הספציפית הזו. קודי השגיאה הם מחרוזות של DBSE+numeric, כמו DBSE1012.
criticalIncidents[].createTime
string
חובה
‫CreateTime היא חותמת הזמן שבה האירוע נוצר במקור.
criticalIncidents[].message
string
אופציונלי
ההודעה מתארת את האירוע או את השגיאה שהתרחשה.
criticalIncidents[].messageTemplateParams
object
אופציונלי
‫MessageTemplateParams מכיל צמדי מפתח/ערך שנדרשים כדי ליצור גרסה ידידותית למשתמש של ההודעה בממשק המשתמש, שמבוססת על נתונים.
criticalIncidents[].resource
object
חובה
המשאב מכיל מידע על רכיב Database Service שדיווח על האירוע, וגם מידע על המשאב ב-Kubernetes.
criticalIncidents[].resource.component
string
חובה
הרכיב הוא מזהה פנימי של תת-המערכת של Database Service שדיווחה על האירוע.
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.passwordResourceVersion
string
אופציונלי
‫PasswordResourceVersion היא גרסת המשאב של הסיסמה הסודית. הגרסה הזו מייצגת את הפעם האחרונה שבה הסיסמה עודכנה במסד הנתונים.
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
חובה
"שיטה" הוא השם של סוג השיטה שהסטטוס הזה מתייחס אליה.
downstream.physicalDownstream.state
object
אופציונלי
השדה State הוא מצב הרפליקציה כפי שמופיע בטבלה pg_stat_wal_receiver של שרת מסד הנתונים במורד הזרם.
observedgeneration
integer
אופציונלי
פנימי: הדור שנצפה על ידי הבקר.
reconciled
boolean
אופציונלי
פנימי: אם המשאב הותאם על ידי הבקר.
upstream
object
אופציונלי
השדה Upstream מכיל את המצב שנצפה במסד הנתונים של הרפליקציה במעלה הזרם.
upstream.host
string
אופציונלי
המארח הוא נקודת הקצה של החיבור של מסד הנתונים הזה, שמסדי הנתונים במורד הזרם יכולים לגשת אליה לצורך שכפול.
upstream.password
object
אופציונלי
הסיסמה היא ההפניה לסוד שבו מאוחסנת סיסמת המשתמש לשכפול של מסד הנתונים הזה.
upstream.password.name
string
אופציונלי
השם הוא ייחודי במרחב שמות כדי להפנות למשאב סודי.
upstream.password.namespace
string
אופציונלי
‫namespace מגדיר את המרחב שבו שם הסוד חייב להיות ייחודי.
upstream.port
integer
אופציונלי
היציאה היא היציאה של מסד הנתונים הזה, שמסדי נתונים במורד הזרם יכולים לגשת אליה לצורך שכפול.
upstream.replicationslotname
string
אופציונלי
‫ReplicationSlotName הוא השם של משבצת השכפול שנוצרה במסד הנתונים הזה. מסדי נתונים במורד הזרם יכולים להשתמש במשבצת השכפול הזו לשכפול.
upstream.username
string
אופציונלי
שם המשתמש הוא השם של משתמש הרפליקציה במסד הנתונים הזה. מסדי נתונים במורד הזרם יכולים להשתמש במשתמש הזה כדי להתחבר למסד הנתונים הזה לצורך שכפול.