בדף הזה מתועדת גרסה 18.1.0 של AlloyDB Omni באמצעות אפשרות הפריסה containers. בוחרים אפשרות פריסה אחרת.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

בדיקת ההגדרה של זמינות גבוהה

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

כדי לשמור על פעילות רציפה של מסד הנתונים של AlloyDB Omni ולצמצם את זמן ההשבתה, חשוב לוודא שההגדרה של Patroni לזמינות גבוהה היא אמינה ואיכותית. בדף הזה מוסבר איך לבדוק את אשכול Patroni, כולל תרחישי כשל שונים, עקביות הרפליקציה ומנגנוני יתירות כשל.

בדיקת ההגדרה של Patroni

מתחברים לאחד ממכונות ה-Patroni‏ (alloydb-patroni1,‏ alloydb-patroni2 או alloydb-patroni3) ועוברים לתיקיית Patroni של AlloyDB Omni.
```
cd /alloydb/
```

בודקים את היומנים של Patroni.

  docker compose logs alloydbomni-patroni

הרשומות האחרונות צריכות לשקף מידע על צומת Patroni. אמורה להופיע הודעה דומה לזו שכאן למטה.

alloydbomni-patroni        | 2024-06-12 15:10:29,020 INFO: no action. I am (patroni1), the leader with the lock
alloydbomni-patroni        | 2024-06-12 15:10:39,010 INFO: no action. I am (patroni1), the leader with the lock
alloydbomni-patroni        | 2024-06-12 15:10:49,007 INFO: no action. I am (patroni1), the leader with the lock

מתחברים לכל מכונה שמריצה את Linux ויש לה קישוריות רשת למכונה הראשית של Patroni, ‏alloydb-patroni1, ומקבלים מידע על המכונה. יכול להיות שתצטרכו להתקין את הכלי jq על ידי הרצת sudo apt-get install jq -y.

curl -s http://alloydb-patroni1:8008/patroni | jq .

הפלט אמור להיראות כך:

{
  "state": "running",
  "postmaster_start_time": "2024-05-16 14:12:30.031673+00:00",
  "role": "master",
  "server_version": 150005,
  "xlog": {
    "location": 83886408
  },
  "timeline": 1,
  "replication": [
    {
      "usename": "alloydbreplica",
      "application_name": "patroni2",
      "client_addr": "10.172.0.40",
      "state": "streaming",
      "sync_state": "async",
      "sync_priority": 0
    },
    {
      "usename": "alloydbreplica",
      "application_name": "patroni3",
      "client_addr": "10.172.0.41",
      "state": "streaming",
      "sync_state": "async",
      "sync_priority": 0
    }
  ],
  "dcs_last_seen": 1715870011,
  "database_system_identifier": "7369600155531440151",
  "patroni": {
    "version": "3.3.0",
    "scope": "my-patroni-cluster",
    "name": "patroni1"
  }
}

קריאה לנקודת קצה ל-API של Patroni HTTP בצומת Patroni חושפת פרטים שונים על המצב וההגדרות של המכונה הספציפית של PostgreSQL שמנוהלת על ידי Patroni, כולל מידע על מצב האשכול, ציר הזמן, מידע על WAL ובדיקות תקינות שמציינות אם הצמתים והאשכול פועלים בצורה תקינה.

בדיקת ההגדרה של HAProxy

במכונה עם דפדפן וחיבור לרשת לצומת HAProxy, עוברים לכתובת הבאה: http://haproxy:7000. לחלופין, אפשר להשתמש בכתובת ה-IP החיצונית של מופע HAProxy במקום בשם המארח שלו.

המסך אמור להיראות כמו בצילום המסך הבא.

איור 1. דף הסטטוס של HAProxy שבו מוצגים סטטוס התקינות וזמן האחזור של צמתי Patroni.

בלוח הבקרה של HAProxy אפשר לראות את סטטוס התקינות ואת זמן האחזור של צומת Patroni הראשי, patroni1, ושל שתי הרפליקות, patroni2 ו-patroni3.
אפשר להריץ שאילתות כדי לבדוק את נתוני השכפול באשכול. מלקוח כמו pgAdmin, מתחברים לשרת מסד הנתונים הראשי דרך HAProxy ומריצים את השאילתה הבאה.
```
SELECT
      pid, usename, application_name, client_addr, state, sync_state
FROM
      pg_stat_replication;
```
אמורה להופיע דיאגרמה דומה לזו שכאן למטה, שמראה ש-patroni2 ו-patroni3 מעבירים סטרימינג מ-patroni1.

איור 2. פלט של pg_stat_replication שמציג את מצב השכפול של צמתי Patroni.

בדיקת יתירות כשל אוטומטית

בקטע הזה, באשכול של שלושה צמתים, נדמה הפסקת חשמל בצומת הראשי על ידי עצירה של קובץ ה-Patroni המצורף שפועל. אפשר לעצור את שירות Patroni בצומת הראשי כדי לדמות הפסקה, או לאכוף כמה כללי חומת אש כדי לעצור את התקשורת לצומת הזה.

במכונה הראשית של Patroni, עוברים לתיקייה AlloyDB Omni Patroni.
```
cd /alloydb/
```
עוצרים את הקונטיינר.
```
docker compose down
```
הפלט אמור להיראות כך: כך אפשר לוודא שהקונטיינר והרשת הופסקו.
```
[+] Running 2/2
✔ Container alloydb-patroni            Removed
✔ Network alloydbomni-patroni_default  Removed
```
מרעננים את לוח הבקרה של HAProxy ורואים איך מתרחש מעבר אוטומטי למצב כשל.

איור 3. לוח הבקרה של HAProxy שבו מוצג מעבר אוטומטי מכשל מהצומת הראשי לצומת ההמתנה.

המופע patroni3 הפך למופע הראשי החדש, ו-patroni2 הוא העותק היחיד שנותר. השרת הראשי הקודם, patroni1, מושבת ובדיקות התקינות שלו נכשלות.

‫Patroni מבצע ומנהל את יתירות הכשל באמצעות שילוב של מעקב, קונצנזוס ותזמור אוטומטי. ברגע שהצומת הראשי לא מצליח לחדש את החכירה שלו בתוך פרק זמן קצוב, או אם הוא מדווח על כשל, הצמתים האחרים באשכול מזהים את המצב הזה באמצעות מערכת הקונצנזוס. הצמתים הנותרים מתואמים כדי לבחור את הרפליקה המתאימה ביותר לקידום כעותק הראשי החדש. אחרי שבוחרים רפליקה מועמדת, Patroni מקדם את הצומת הזה לראשי על ידי החלת השינויים הנדרשים, כמו עדכון ההגדרות של PostgreSQL והפעלה מחדש של רשומות WAL שנותרו. לאחר מכן, הצומת הראשי החדש מעדכן את מערכת הקונצנזוס לגבי הסטטוס שלו, והרפליקות האחרות מגדירות את עצמן מחדש כדי לעקוב אחרי הצומת הראשי החדש, כולל החלפת מקור השכפול ואולי גם השלמת פערים עם טרנזקציות חדשות. ‫HAProxy מזהה את המכונה הראשית החדשה ומפנה את החיבורים של הלקוחות בהתאם, כדי להבטיח הפרעה מינימלית.
מלקוח כמו pgAdmin, מתחברים לשרת של מסד הנתונים דרך HAProxy ובודקים את נתוני הרפליקציה באשכול אחרי יתירות כשל.
```
SELECT
      pid, usename, application_name, client_addr, state, sync_state
FROM
      pg_stat_replication;
```
אמורה להופיע דיאגרמה דומה לזו שכאן למטה, שבה רואים שרק patroni2 משדר עכשיו.

איור 4. פלט של pg_stat_replication שבו מוצג מצב הרפליקציה של צמתי Patroni אחרי יתירות כשל.
אשכול שלושת הצמתים שלכם יכול לשרוד עוד הפסקה אחת. אם תעצרו את הצומת הראשי הנוכחי, patroni3, תתבצע עוד יתירות כשל.

איור 5. לוח הבקרה של HAProxy שבו מוצג מעבר הגיבוי מהצומת הראשי, patroni3, לצומת ההמתנה, patroni2.

שיקולים לגבי חלופות

חזרה למצב ראשוני היא התהליך להחזרת צומת המקור הקודם אחרי מעבר לגיבוי. בדרך כלל לא מומלץ להשתמש במנגנון חלופי אוטומטי באשכול מסדי נתונים עם זמינות גבוהה, בגלל כמה בעיות קריטיות, כמו שחזור לא מלא, סיכון לתרחישי פיצול מוח ופיגור בשכפול.

באשכול Patroni, אם מפעילים את שני הצמתים שבהם בוצע סימול של הפסקת שירות, הם יצטרפו מחדש לאשכול כעותקים משוכפלים במצב המתנה.

לוח הבקרה של HAProxy שבו מוצג השחזור של patroni1 ו-patroni3 כצמתים במצב המתנה

איור 6. לוח הבקרה של HAProxy שמציג את השחזור של patroni1 ושל patroni3 כצמתים במצב המתנה.

עכשיו patroni1 ו-patroni3 משוכפלים מהמכונה הראשית הנוכחית patroni2.

פלט של pg_stat_replication שמציג את מצב השכפול של צומתי Patroni אחרי הגיבוי

איור 7. פלט של pg_stat_replication שמציג את מצב הרפליקציה של צומתי Patroni אחרי החזרה למצב הקודם.

אם רוצים לחזור באופן ידני לשרת הראשי המקורי, אפשר לעשות זאת באמצעות ממשק שורת הפקודה patronictl. אם תבחרו באפשרות של חזרה ידנית למצב הקודם, תוכלו להבטיח תהליך שחזור אמין, עקבי ומאומת, ולשמור על התקינות והזמינות של מערכות מסדי הנתונים.