שדרוג ל-AlloyDB Omni גרסה 16.9.0 ב-Kubernetes

בוחרים גרסה של מאמר העזרה:

בדף הזה מוסבר איך לשדרג ל-AlloyDB Omni גרסה 16.9.0 ב-Kubernetes.

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

  • מוודאים שגרסת האופרטור של AlloyDB Omni Kubernetes היא 1.6.3. כדי לשדרג את הגרסה של AlloyDB Omni Operator, אפשר לעיין במאמר מעבר לגרסה העדכנית ביותר של AlloyDB Omni Kubernetes Operator.

  • מוודאים שיש לכם לפחות 5GB של שטח פנוי בדיסק.

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

  • בסביבות של זמינות גבוהה (HA) ועמידות נתונים (DR), צריך לבטל את ההתאמה בין אשכולות מסדי הנתונים לפני שמשדרגים אותם.

שדרוג גרסת AlloyDB Omni

כדי לשדרג את הגרסה של AlloyDB Omni באמצעות pg_upgrade, מבצעים אחת מהפעולות הבאות:

שדרוג סקריפט

אפשר למצוא סקריפט שמבצע את שלבי השדרוג הידני בדוגמאות של AlloyDB Omni ב-GitHub.

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

./MVU.sh 16.9.0 1.6.3 NAME NAMESPACE

מחליפים את המשתנים הבאים:

  • ‫NAME: השם של אשכול מסד הנתונים.
  • ‫NAMESPACE: מרחב השמות של אשכול מסד הנתונים.

שלבי השדרוג הידני

  1. מגבים את הנתונים כדי למנוע אובדן נתונים.

  2. הסרת תוכנית הגיבוי

  3. סיום כל תהליכי השכפול. זה כולל שכפול פיזי שמשמש לזמינות גבוהה (HA) ולעמידות נתונים (DR), וגם את כל הזרמים של שכפול לוגי.

  4. מוסיפים הערה לאשכול מסד הנתונים כדי לציין שדרוג גרסה ידני.

    kubectl annotate dbclusters.alloydbomni.dbadmin.goog NAME dbs.dbadmin.goog.com/manualmvu=true

    מחליפים את המשתנה הבא:

    • ‫NAME: השם של אשכול מסד הנתונים.

  5. מפסיקים את התהליך של PostgreSQL כדי שאפשר יהיה להעביר נתונים לצורך השדרוג.

    k exec -ti POD_NAME -- /bin/Bash
# Shut down postgres
postgres@POD_NAME:~$ supervisorctl.par stop postgres

postgres@POD_NAME:~$ mkdir /mnt/disks/pgsql/15; mv /mnt/disks/pgsql/data /mnt/disks/pgsql/15/data; cp -r /usr/lib/postgresql/15/bin /mnt/disks/pgsql/15/.; cp -r /usr/lib/postgresql/15/lib /mnt/disks/pgsql/15/.; cp -r /usr/share/postgresql/15 /mnt/disks/pgsql/15/share; rm /mnt/disks/pgsql/15/share/postgresql.conf.sample; cp /usr/share/postgresql/postgresql.conf.sample /mnt/disks/pgsql/15/share/postgresql.conf.sample; chmod 2740 /mnt/disks/pgsql/15/data

    מחליפים את המשתנה הבא:

    • ‫POD_NAME: השם של ה-Pod.

  6. צריך להחיל תיקון על אשכול מסד הנתונים לגרסה 16.9.0 ועל סוכני מישור הבקרה (CPA) לגרסה 1.6.3.

    kubectl patch dbclusters.alloydbomni.dbadmin.goog NAME --type=merge -p '{"spec":{"databaseVersion":"16.9.0","controlPlaneAgentsVersion":"omni_control_plane_agents_version"}}'

    מחליפים את המשתנה הבא:

    • ‫NAME: השם של אשכול מסד הנתונים.

  7. יוצרים אשכול מסדי נתונים ריק לגרסה החדשה של AlloyDB Omni.

    k exec -ti POD_NAME -- /bin/Bash

postgres@POD_NAME:~$ supervisorctl.par stop postgres

# Initialize a new, empty database cluster for the new version.
postgres@POD_NAME:~$ rm -fr /mnt/disks/pgsql/data; initdb -D /mnt/disks/pgsql/data -U alloydbadmin --data-checksums --encoding=UTF8 --locale=C --locale-provider=icu --icu-locale=und-x-icu --auth-host=trust --auth-local=reject; cd ~

    מחליפים את המשתנה הבא:

    • ‫POD_NAME: השם של ה-Pod.

  8. משנים את pg_hba.conf באשכול מסדי הנתונים הקיים כדי לתת לתהליך השדרוג את ההרשאות והחיבורים שהוא צריך.

    # Backup pg_hba.conf of the pg15 cluster
postgres@POD_NAME:~$ cp /mnt/disks/pgsql/15/data/pg_hba.conf /mnt/disks/pgsql/15/data/pg_hba.conf.bak

# Update pg15 configurations
postgres@POD_NAME:~$ echo "local      all           all                      trust" >> /mnt/disks/pgsql/15/data/pg_hba.conf; echo "host       all           all      127.0.0.1/32    trust" >> /mnt/disks/pgsql/15/data/pg_hba.conf

    מחליפים את המשתנה הבא:

    • ‫POD_NAME: השם של ה-Pod.

  9. משנים את pg_hba.conf באשכול מסד הנתונים החדש כדי לתת לתהליך השדרוג את ההרשאות והחיבורים שהוא צריך.

    postgres@POD_NAME:~$ rm /mnt/disks/pgsql/data/pg_hba.conf; echo "local      all           all                      trust" >> /mnt/disks/pgsql/data/pg_hba.conf; echo "host       all           all      127.0.0.1/32    trust" >> /mnt/disks/pgsql/data/pg_hba.conf; chmod 2740 /mnt/disks/pgsql/15/data

    מחליפים את המשתנה הבא:

    • ‫POD_NAME: השם של ה-Pod.

  10. שדרוג אשכול מסד הנתונים.

    # (optional) Make sure postgres is stopped
postgres@POD_NAME:~$ supervisorctl.par stop postgres

# (optional) Check to verify that data can be upgraded.
postgres@POD_NAME:~$ pg_upgrade -U alloydbadmin --check -b /mnt/disks/pgsql/15/bin -B /usr/lib/postgresql/16/bin -d /mnt/disks/pgsql/15/data -D /mnt/disks/pgsql/data --link -v

postgres@POD_NAME:~$ pg_upgrade -U alloydbadmin -b /mnt/disks/pgsql/15/bin -B /usr/lib/postgresql/16/bin -d /mnt/disks/pgsql/15/data -D /mnt/disks/pgsql/data --link -v

# Need to recover pg15 configurations
postgres@POD_NAME:~$ cp /mnt/disks/pgsql/15/data/pg_hba.conf.bak /mnt/disks/pgsql/data/pg_hba.conf; cp -r /mnt/disks/pgsql/15/data/postgresql.conf /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/15/data/postgresql.conf.d /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/15/data/parambackup /mnt/disks/pgsql/data/.

# Start postgres
postgres@POD_NAME:~$ supervisorctl.par start postgres

# Clean up backup data
postgres@POD_NAME:~$ rm -fr /mnt/disks/pgsql/15/

    מחליפים את המשתנה הבא:

    • ‫POD_NAME: השם של ה-Pod.

  11. מסירים את הערת השדרוג הידני של הגרסה מאשכול מסד הנתונים.

    kubectl annotate dbclusters.alloydbomni.dbadmin.goog NAME dbs.dbadmin.goog.com/manualmvu-

    מחליפים את המשתנה הבא:

    • ‫NAME: השם של אשכול מסד הנתונים.

  12. להמשיך את הפעולות הרגילות ולהפעיל מחדש את הגיבויים, תוכניות הגיבוי או תהליכי השכפול שהושבתו בשלבים אחד עד שלוש.