הגדרה של pgBackRest ל-AlloyDB Omni

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

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

במאמר גיבוי ושחזור ב-Kubernetes מוסבר על מידע שמבוסס על Kubernetes.

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

‫pgBackRest כותב את נתוני הגיבוי למאגרים מקומיים, מרוחקים או מבוססי-ענן. אחרי שיוצרים לפחות מאגר אחד, אפשר להשתמש ב-pgBackRest כדי לשחזר את הנתונים ב-AlloyDB Omni באמצעות שיטות שונות, כולל שחזור לנקודת זמן מסוימת (PITR).

‫AlloyDB Omni כולל את pgBackRest בקונטיינר Docker שלו. זה אומר שאתם יכולים להשתמש ב-pgBackRest כדי לגבות ולשחזר את הנתונים של AlloyDB Omni בלי להתקין תוכנה נוספת.

מידע נוסף על pgBackRest זמין במדריך למשתמש.

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

לפני שמגדירים את AlloyDB Omni לעבודה עם pgBackRest, צריך לוודא שAlloyDB Omni מותקן ופועל בשרת שאתם שולטים בו.

הערה לגבי נתיבים של מערכת קבצים

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

רבות מהפקודות והדוגמאות בדף הזה מתייחסות לספריית הנתונים בתור /var/lib/postgresql/data, בלי קשר למיקום של ספריית הנתונים במערכת המארחת. הסיבה לכך היא ש-AlloyDB Omni טוען את ספריית הנתונים אל /var/lib/postgresql/data במערכת הקבצים של הקונטיינר. כתוצאה מכך, אתם יכולים להשתמש בספריית הנתונים כמיקום לאחסון ההגדרות האישיות והמאגרים של pgBackRest בלי הגדרה נוספת.

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

הגדרה בסיסית עם גיבויים מקומיים

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

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

הגדרת אימות מהימן של שקע Unix

מאפשרים למחשב המארח של AlloyDB Omni לאמת את המשתמש postgres של שרת מסד הנתונים בלי לדרוש סיסמה. כך השלבים הבאים יהיו פשוטים יותר.

  1. מוסיפים את השורה הבאה לקובץ DATA_DIR/pg_hba.conf:

    local       all      postgres       trust
    

    מחליפים את DATA_DIR בנתיב של מערכת הקבצים לספריית הנתונים – לדוגמה, /home/$USER/alloydb-data.

  2. מפעילים מחדש את AlloyDB Omni:

    docker restart CONTAINER_NAME

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

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

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

  1. יוצרים ספריית משנה בשם backups בספריית הנתונים של AlloyDB Omni:

    mkdir DATA_DIR/backups
  2. יוצרים קובץ בשם pgbackrest.conf בספריית הנתונים ומעתיקים אליו את התוכן הבא:

    [global]
    
    # Paths (all mandatory):
    repo1-path=/var/lib/postgresql/data/backups
    spool-path=/var/lib/postgresql/data
    lock-path=/var/lib/postgresql/data
    
    # Retention details:
    repo1-retention-full=3
    repo1-retention-full-type=count
    repo1-retention-diff=16
    
    # Force a checkpoint to start backup immediately:
    start-fast=y
    
    # Logging parameters:
    log-path=/var/lib/postgresql/data/backups
    log-level-console=info
    log-level-file=info
    
    # Recommended ZSTD compression:
    compress-type=zst
    
    # Other performance parameters:
    archive-async=y
    archive-push-queue-max=1024MB
    archive-get-queue-max=256MB
    archive-missing-retry=y
    
    [global:archive-push]
    process-max=2
    
    [global:archive-get]
    process-max=2
    
    [omni]
    pg1-user=postgres
    pg1-socket-path=/var/lib/postgresql/data
    pg1-path=/var/lib/postgresql/data/data
    
  3. מאתחלים את מיקום הגיבוי באמצעות הפקודה pgbackrest stanza-create:

    docker exec CONTAINER_NAME pgbackrest --config-path=/var/lib/postgresql/data/backups --stanza=omni stanza-create

הגדרת מסד הנתונים לגיבויים רציפים

  1. כדי להפעיל גיבויים רציפים, מריצים את הפקודה הבאה כדי להגדיר כמה פרמטרים של PostgreSQL:

    docker exec CONTAINER_NAME psql -h localhost -U postgres \
    -c "ALTER SYSTEM SET archive_command='pgbackrest --config-path=/var/lib/postgresql/data/backups --stanza=omni archive-push %p';" \
    -c "ALTER SYSTEM SET archive_mode=on;" \
    -c "ALTER SYSTEM SET max_wal_senders=10;" \
    -c "ALTER SYSTEM SET wal_level=replica;"
  2. מפעילים מחדש את AlloyDB Omni:

    docker restart CONTAINER_NAME

הרצת פקודות pgBackRest

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

השיטה המומלצת היא להריץ פקודות pgBackRest ישירות מהמכונה המארחת שבה מותקן מאגר AlloyDB Omni, באמצעות הפקודה docker exec. לדוגמה, כדי ליצור גיבוי ידני, משתמשים בפקודה pgbackrest backup. משנים אותו כך שיפעל בתוך פקודת docker exec, ויפנה לקובץ התצורה שיצרתם קודם:

docker exec CONTAINER_NAME pgbackrest --config-path=/var/lib/postgresql/data/backups --stanza=omni --type=full backup

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

הגדרת גיבויים מתוזמנים

כדי להגדיר גיבויים מתוזמנים, יוצרים משימת cron שמריצה את הפקודה pgbackrest backup בתדירות הנדרשת. מידע נוסף זמין במאמר בנושא תזמון גיבוי.

הגדרות בהתאמה אישית וגיבויים מרחוק

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

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

לדוגמה, pgBackRest תומך בשימוש בקטגוריה של Cloud Storage כמאגר גיבויים, עם מספר אפשרויות הגדרה קשורות. בקטע הבא מוצגת דרך אחת להשתמש באפשרויות האלה.

דוגמה להגדרה באמצעות Cloud Storage

השלבים בקטע הזה מבוססים על קובץ התצורה שהוצג בקטע הגדרות אישיות בסיסיות עם גיבויים מקומיים. השינויים האלה בקובץ מגדירים מאגר גיבויים שני בקטגוריה של Cloud Storage, שאפשר לגשת אליו דרך ניהול זהויות והרשאות גישה (IAM).

סגנון האימות האוטומטי בדוגמה הזו מחייב שאשכול AlloyDB Omni יפעל במכונה וירטואלית של Compute Engine. אם אתם לא מריצים את AlloyDB Omni במכונה וירטואלית של Compute Engine, אתם עדיין יכולים לגבות לקטגוריה של Cloud Storage באמצעות שיטת אימות אחרת, כמו Google Cloud מפתח של חשבון שירות שנשמר במערכת הקבצים המקומית.

כדי להרחיב את קובץ התצורה הקודם ולהגדיר מאגר pgBackRest שמבוסס על Cloud Storage, מבצעים את השלבים הבאים:

  1. מגדירים את ההרשאות של הקטגוריה כדי לאפשר לחשבון השירות שמצורף למכונה הווירטואלית לכתוב לקטגוריה. לשם כך, צריך להגדיר בחשבון השירות את התפקיד Storage Object User ב-IAM.

  2. מוסיפים את השורות הבאות לקובץ pgbackrest.conf:

    # Cloud Storage access details:
    repo2-type=gcs
    repo2-gcs-key-type=auto
    repo2-storage-verify-tls=n
    
    # Cloud Storage bucket and path details:
    repo2-gcs-bucket=BUCKET_NAME
    repo2-path=/pgbackrest
    
    # Cloud Storage backup retention parameters:
    repo2-retention-full=8
    repo2-retention-full-type=count
    

    מחליפים את BUCKET_NAME בשם של הקטגוריה ב-Cloud Storage שבה רוצים ש-pgBackRest יאחסן את הגיבויים.

  3. מאתחלים את מיקום הגיבוי בענן באמצעות הפקודה pgbackrest stanza-create:

    docker exec CONTAINER_NAME pgbackrest --config-path=/var/lib/postgresql/data/backups --stanza=omni stanza-create

אחרי שמאתחלים את מאגר הגיבויים בקטגוריה של Cloud Storage באמצעות הפקודה pgbackrest stanza-create, הכלי pgBackRest מגבה בשני מיקומים:

  • המיקום במערכת הקבצים המקומית, שמוגדר במקום אחר בקובץ התצורה כ-repo1-path.

  • הקטגוריה של Cloud Storage, שמוגדרת באמצעות הוראות ההגדרה של repo2- שמופיעות בדוגמה הזו.

המאמרים הבאים