שדרוג ל-AlloyDB Omni גרסה 18.1.0 ב-1.7.0

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

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

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

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

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

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

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

שדרוג גרסת AlloyDB Omni

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

ביצוע שדרוג באמצעות סקריפט

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

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

./MVU.sh 18.1.0 1.7.0 NAME NAMESPACE OS_TYPE

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

  • NAME: השם של אשכול מסד הנתונים.
  • NAMESPACE: מרחב השמות של אשכול מסד הנתונים.
  • OS_TYPE: מערכת ההפעלה הבסיסית של תמונת מסד הנתונים. הערכים התקינים הם Debian ו-UBI9. אם לא מציינים את האופרטור, ברירת המחדל היא UBI9 לגרסאות מסד נתונים 16.9.0 ואילך.

ביצוע שלבי שדרוג ידניים

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

שדרוג מגרסה 17.x.x לגרסה 18.1.0

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

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

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

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

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

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

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

    kubectl exec -ti POD_NAME -- /bin/Bash
    # Shut down postgres
    postgres@POD_NAME:~$ supervisorctl.par stop postgres
    
    postgres@POD_NAME:~$ mkdir /mnt/disks/pgsql/17; mv /mnt/disks/pgsql/data /mnt/disks/pgsql/17/data; cp -r /usr/lib/postgresql/17/bin /mnt/disks/pgsql/17/.; cp -r /usr/lib/postgresql/17/lib /mnt/disks/pgsql/17/.; cp -r /usr/share/postgresql/17 /mnt/disks/pgsql/17/share; rm /mnt/disks/pgsql/17/share/postgresql.conf.sample; cp /usr/share/postgresql/postgresql.conf.sample /mnt/disks/pgsql/17/share/postgresql.conf.sample; chmod 2740 /mnt/disks/pgsql/17/data
    

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

    • POD_NAME: השם של ה-Pod.
  6. צריך להחיל תיקון על אשכול מסד הנתונים לגרסה 18.1.0 ועל סוכני מישור הבקרה (CPA) לגרסה 1.7.0.

    kubectl patch dbclusters.alloydbomni.dbadmin.goog NAME --type=merge -p '{"spec":{"databaseVersion":"18.1.0","controlPlaneAgentsVersion":"1.7.0","databaseImageOSType":"UBI9"}}'
    

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

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

    kubectl 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 pg17 cluster
    postgres@POD_NAME:~$ cp /mnt/disks/pgsql/17/data/pg_hba.conf /mnt/disks/pgsql/17/data/pg_hba.conf.bak
    
    # Update pg17 configurations
    postgres@POD_NAME:~$ echo "local      all           all                      trust" >> /mnt/disks/pgsql/17/data/pg_hba.conf; echo "host       all           all      127.0.0.1/32    trust" >> /mnt/disks/pgsql/17/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/17/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/17/bin -B /usr/lib/postgresql/18/bin -d /mnt/disks/pgsql/17/data -D /mnt/disks/pgsql/data --link -v
    
    postgres@POD_NAME:~$ pg_upgrade -U alloydbadmin -b /mnt/disks/pgsql/17/bin -B /usr/lib/postgresql/18/bin -d /mnt/disks/pgsql/17/data -D /mnt/disks/pgsql/data --link -v
    
    # Recover pg17 configurations
    postgres@POD_NAME:~$ cp /mnt/disks/pgsql/17/data/pg_hba.conf.bak /mnt/disks/pgsql/data/pg_hba.conf; cp -r /mnt/disks/pgsql/17/data/postgresql.conf /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/17/data/postgresql.conf.d /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/17/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/17/
    

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

    • POD_NAME: השם של ה-Pod.
  11. אחרי שדרוג מוצלח, מסירים את הערת השדרוג הידני מאשכול מסד הנתונים.

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

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

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

שדרוג מגרסה 16.x.x לגרסה 17.5.0

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

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

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

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

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

    • NAME: השם של אשכול מסד הנתונים.
  4. מפסיקים את התהליך של PostgreSQL ומעבירים את הנתונים לשדרוג.

    kubectl exec -ti POD_NAME -- /bin/Bash
    # Shut down postgres
    postgres@POD_NAME:~$ supervisorctl.par stop postgres
    
    postgres@POD_NAME:~$ mkdir /mnt/disks/pgsql/16; mv /mnt/disks/pgsql/data /mnt/disks/pgsql/16/data; cp -r /usr/lib/postgresql/16/bin /mnt/disks/pgsql/16/.; cp -r /usr/lib/postgresql/16/lib /mnt/disks/pgsql/16/.; cp -r /usr/share/postgresql/16 /mnt/disks/pgsql/16/share; rm /mnt/disks/pgsql/16/share/postgresql.conf.sample; cp /usr/share/postgresql/postgresql.conf.sample /mnt/disks/pgsql/16/share/postgresql.conf.sample; chmod 2740 /mnt/disks/pgsql/16/data
    

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

    • POD_NAME: השם של ה-Pod.
  5. צריך להחיל תיקון על אשכול מסד הנתונים לגרסה 17.5.0 ועל סוכני מישור הבקרה (CPA) לגרסה 1.6.2.

    kubectl patch dbclusters.alloydbomni.dbadmin.goog NAME --type=merge -p '{"spec":{"databaseVersion":"17.5.0","controlPlaneAgentsVersion":"1.6.2","databaseImageOSType":"UBI9"}}'
    

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

    • NAME: השם של אשכול מסד הנתונים.
  6. יוצרים אשכול מסדי נתונים ריק לגרסה המשודרגת של AlloyDB Omni.

    kubectl 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.
  7. משנים את pg_hba.conf באשכול מסדי הנתונים הקיים כדי לתת לתהליך השדרוג את ההרשאות והחיבורים שהוא צריך.

    # Backup pg_hba.conf of the pg16 cluster
    postgres@POD_NAME:~$ cp /mnt/disks/pgsql/16/data/pg_hba.conf /mnt/disks/pgsql/16/data/pg_hba.conf.bak
    
    # Update pg16 configurations
    postgres@POD_NAME:~$ echo "local      all           all                      trust" >> /mnt/disks/pgsql/16/data/pg_hba.conf; echo "host       all           all      127.0.0.1/32    trust" >> /mnt/disks/pgsql/16/data/pg_hba.conf
    

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

    • POD_NAME: השם של ה-Pod.
  8. משנים את 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/16/data
    

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

    • POD_NAME: השם של ה-Pod.
  9. שדרוג אשכול מסד הנתונים.

    # (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/16/bin -B /usr/lib/postgresql/17/bin -d /mnt/disks/pgsql/16/data -D /mnt/disks/pgsql/data --link -v
    
    postgres@POD_NAME:~$ pg_upgrade -U alloydbadmin -b /mnt/disks/pgsql/16/bin -B /usr/lib/postgresql/17/bin -d /mnt/disks/pgsql/16/data -D /mnt/disks/pgsql/data --link -v
    
    # Recover pg16 configurations
    postgres@POD_NAME:~$ cp /mnt/disks/pgsql/16/data/pg_hba.conf.bak /mnt/disks/pgsql/data/pg_hba.conf; cp -r /mnt/disks/pgsql/16/data/postgresql.conf /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/16/data/postgresql.conf.d /mnt/disks/pgsql/data/.; cp -r /mnt/disks/pgsql/16/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/16/
    

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

    • POD_NAME: השם של ה-Pod.
  10. אחרי שדרוג מוצלח, מסירים את הערת השדרוג הידני מאשכול מסד הנתונים.

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

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

    • NAME: השם של אשכול מסד הנתונים.
  11. ממשיכים בפעולות הרגילות ומפעילים מחדש את הגיבויים, תוכניות הגיבוי או תהליכי השכפול שהשבתתם בשלבים אחד עד שלוש.

שדרוג מגרסה 15.x.x לגרסה 17.5.0

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

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

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

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

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

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

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

    kubectl 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. צריך להחיל תיקון על אשכול מסד הנתונים לגרסה 17.5.0 ועל סוכני מישור הבקרה (CPA) לגרסה 1.6.2.

    kubectl patch dbclusters.alloydbomni.dbadmin.goog NAME --type=merge -p '{"spec":{"databaseVersion":"17.5.0","controlPlaneAgentsVersion":"1.6.2","databaseImageOSType":"UBI9"}}'
    

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

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

    kubectl 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/17/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/17/bin -d /mnt/disks/pgsql/15/data -D /mnt/disks/pgsql/data --link -v
    
    # 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. ממשיכים בפעולות הרגילות ומפעילים מחדש את הגיבויים, תוכניות הגיבוי או תהליכי השכפול שהשבתתם בשלבים אחד עד שלוש.