שחזור אשכול AlloyDB Omni באמצעות Barman

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

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

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

מידע נוסף על הגדרת Barman לעבודה עם AlloyDB Omni זמין במאמר בנושא הגדרת Barman ל-AlloyDB Omni.

לפני שמתחילים

לפני שמשחזרים את הנתונים של AlloyDB Omni, צריך לוודא שיש לכם את הדברים הבאים:

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

    שרת היעד יכול להיות אותה מכונה כמו שרת המקור.

  • כלי השירות rsync, שמותקן בשרת היעד.

  • שרת גיבוי של Barman, עם גיבוי תקין אחד לפחות של Barman של מסד הנתונים המקורי של AlloyDB Omni.

  • קישוריות SSH בין שרת הגיבוי של Barman לבין שרת היעד.

  • מפתחות SSH מוגדרים כך שמשתמש barman בשרת Barman יוכל לעבור אימות בשרת היעד בתור משתמש postgres שלו בלי סיסמה.

  • מספיק מקום פנוי בדיסק בשרת היעד כדי להכיל את מסד הנתונים המשוחזר.

שחזור באמצעות גיבוי ספציפי

  1. בשרת היעד, עוצרים את AlloyDB Omni.

    Docker

     docker stop CONTAINER_NAME

    מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר AlloyDB Omni כשהתקנתם אותו – לדוגמה, my-omni.

    Podman

     podman stop CONTAINER_NAME

    מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר AlloyDB Omni כשהתקנתם אותו – לדוגמה, my-omni.

  2. בשרת Barman, בוחרים גיבוי לשחזור. כדי לראות את הגיבויים הזמינים, מריצים את הפקודה barman list-backups. כדי לראות פרטים על גיבוי מסוים, מריצים את הפקודה barman show-backup.

  3. כדי לשחזר את הגיבוי שנבחר לשרת היעד של AlloyDB Omni, מריצים את הפקודה barman recover.

    כשמריצים את הפקודה, צריך לכלול את הפרטים הבאים:

    בדוגמה הבאה מוצג שימוש בפקודה barman recover עם AlloyDB Omni:

    barman recover --remote-ssh-command "ssh postgres@TARGET_IP" TARGET_LABEL BACKUP_ID DATA_PATH

    מחליפים את מה שכתוב בשדות הבאים:

    • TARGET_IP: כתובת ה-IP של שרת היעד.

    • TARGET_LABEL: התווית שהקציתם לשרת בקובץ התצורה של Barman.

    • BACKUP_ID: המזהה של הגיבוי שממנו רוצים לשחזר, שזוהה בשלב הקודם. לדוגמה: 20230810T210200.

    • DATA_PATH: הנתיב לספריית המשנה data של ספריית הנתונים של שרת היעד, לדוגמה /home/your-username/alloydb-data/data.

  4. בשרת מסד הנתונים של היעד AlloyDB Omni, מפעילים את השירות:

    Docker

    docker start CONTAINER_NAME

    Podman

    podman start CONTAINER_NAME

אחרי שהשירות יופעל מחדש, מתחברים לשרת AlloyDB Omni. אמורות להופיע מסדי הנתונים והנתונים ששוחזרו.

שחזור לנקודה ספציפית בזמן

כדי לבצע שחזור מערכת מנקודה מסוימת בזמן (PITR), פועלים לפי אותם השלבים שמפורטים בקטע הקודם, עם שינוי אחד. כשמריצים את הפקודה barman recover, צריך לציין גם אחת מאפשרויות שחזור מערכת מנקודה מסוימת בזמן (PITR) של Barman.

הפקודה הבאה מדגימה שימוש ב-barman recover עם AlloyDB Omni עם אפשרות לשחזור מערכת מנקודה מסוימת בזמן (PITR):

barman recover --remote-ssh-command "ssh postgres@TARGET_IP" TARGET_LABEL BACKUP_ID --target-time="RESTORE_TIMESTAMP" DATA_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • TARGET_IP: כתובת ה-IP של שרת היעד.

  • TARGET_LABEL: התווית שהקציתם לשרת בקובץ התצורה של Barman.

  • BACKUP_ID: המזהה של הגיבוי שממנו רוצים לשחזר, שזוהה בשלב הקודם. לדוגמה: 20230810T210200.

  • TARGET_TIMESTAMP: השעה לשחזור, בכל פורמט של PostgreSQL timestamp שמציין גם תאריך וגם שעה – לדוגמה, 2024-02-06 00:00:00.

  • DATA_PATH: הנתיב לספריית המשנה data של ספריית הנתונים של שרת היעד, לדוגמה /home/your-username/alloydb-data/data.