הגדרת משאב מותאם אישית של PgBouncer

סכימת המפרט

ההגדרה PgBouncer Spec מגדירה את המצב שנבחר של PgBouncer.

PgBouncer:
  metadata:
    name: string
  spec:
    accessMode: string
    allowSuperUserAccess: boolean
    dbclusterRef: string
    parameters: object
    port: integer
    serverTLS:
      certSecret:
        name: string

שדה סוג חובה או אופציונלי	תיאור
name
string חובה	השם של משאב PgBouncer.
accessMode
string אופציונלי	מגדיר את מצבי הגישה rw (קריאה וכתיבה) או ro (קריאה בלבד) לחיבורים של PgBouncer. ערך ברירת המחדל הוא rw.
allowSuperUserAccess
boolean אופציונלי	הערך של AllowSuperUserAccess יכול להיות true או false.
dbclusterRef
string חובה	‫DBClusterRef הוא שם ה-DBCluster ש-PgBouncer מאגד את החיבורים שלו. צריך ליצור את אובייקט PgBouncer באותו מרחב שמות שבו נמצא אובייקט DBCluster שאליו הוא מפנה. השדה הזה נדרש לשימוש ב-PgBouncer לניהול מאגר חיבורים.
parameters
object אופציונלי	מציינים צמדי מפתח/ערך להגדרות של PgBouncer. תוחמים את כל הערכים במירכאות, למשל, default_pool_size: "20". למידע נוסף על האפשרויות הזמינות, אפשר לעיין במאמרי העזרה בנושא הגדרת PgBouncer. פרמטרים נפוצים: ‫pool_mode: מציין מתי לקוחות אחרים יכולים לעשות שימוש חוזר בחיבור למסד נתונים. ‫default_pool_size: המספר המקסימלי של חיבורים למסד נתונים שמותרים לכל צמד של משתמש ומסד נתונים ‫max_client_conn: המספר המקסימלי של חיבורי לקוח ‫max_db_connections: המספר המקסימלי של חיבורים למסד הנתונים
port
integer אופציונלי	מציינים את היציאה שבה PgBouncer מאזין לחיבורים נכנסים. ערך ברירת המחדל הוא 6432.
serverTLS
object אופציונלי	הפרמטר ServerTLSSpec מגדיר את הסוד של האישור לתקשורת מוצפנת שמשמש את PgBouncer כדי להתחבר לאשכול מסדי הנתונים ולאחזר פרטי כניסה לאימות.
serverTLS.certSecret
object אופציונלי	‫CertSecret מפנה לסוד של האישור באותו מרחב שמות. הסוד צריך להכיל את הערכים ca.crt (אישור CA), tls.key (מפתח פרטי) ו-tls.crt (אישור עלים). הערכים בסוד הזה משמשים לאכלוס ההגדרות server_tls_ca_file,‏ server_tls_cert_file ו-server_tls_key_file בקובץ pgbouncer.ini. אישור ה-CA צריך להיות זהה ל-CA שחתם על אישור העלה של אשכול מסד הנתונים. אישור העלה חייב לכלול את השם הנפוץ "alloydbpgbouncer".
serverTLS.certSecret.name
string אופציונלי	שם הגורם המפנה.

סכימת סטטוס

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

endpoints:
  - name: string
    value: string
phase: string
port: integer

שדה סוג חובה או אופציונלי	תיאור
endpoints
array of objects אופציונלי	‫endpoints מכיל את כל נקודות הקצה שדרכן אפשר לגשת למופע הזה.
endpoints.name
string חובה	‫Name הוא השם של נקודת הקצה – לדוגמה, Read-Write.
endpoints.value
string חובה	הערך מכיל את פרטי נקודת הקצה להתחברות למופע ולגישה אליו.
phase
string חובה	‫phase מתאר את הסטטוס של פריסת PgBouncer. כאן מופיעים ערכים כמו WaitingForDeploymentReady,‏ Acquiring IP ו-Ready.
port
integer אופציונלי	מספר היציאה שנחשף על ידי PgBouncer לחיבורים.