ביצוע שדרוג של גרסה ראשית מ-AlloyDB Omni גרסה 15.x.x ב-Kubernetes

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

• Current (18.1.0)
• 18.1.0
• 17.7.0
• 17.5.0
• 16.11.0
• 16.9.0
• 16.8.0
• 16.3.0
• 15.15.0
• 15.13.0
• 15.12.0
• 15.7.1

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

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

חשוב:

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

נתיבי השדרוג הבאים לא נתמכים:

• מגרסה 15.12.0 ומטה לגרסה 17.5.0 או 16.9.0
• מגרסה 16.8.0 ומטה עד גרסה 17.5.0

כדי לשדרג מהגרסאות האלה, צריך לבצע שדרוג של גרסה משנית כשלב ביניים:

• אם אתם משתמשים בגרסה 15.12.0 ומטה, אתם צריכים לשדרג קודם ל-15.13.0.
• אם אתם משתמשים בגרסה 16.8.0 ומטה, אתם צריכים לשדרג קודם ל-16.9.0.

לדוגמה, כדי לשדרג מגרסה 15.12.0 לגרסה 17.5.0, צריך לפעול לפי הנתיב הבא: 15.12.0 > 15.13.0 > 17.5.0

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

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

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

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

שדרוג הגרסה של AlloyDB Omni

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

• מריצים את סקריפט Bash שמבצע את השדרוג בשבילכם.

• הפעלת הוראות השדרוג באופן ידני

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

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

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

./MVU.sh TO_VERSION OPERATOR_VERSION NAME NAMESPACE

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

• ‫TO_VERSION: הגרסה שאליה משדרגים. לדוגמה: 16.8.0 או 17.5.0.
• ‫OPERATOR_VERSION: הגרסה של אופרטור AlloyDB Omni, לדוגמה 1.5.0 או 1.6.0.
• ‫NAME: השם של אשכול מסד הנתונים.
• ‫NAMESPACE: מרחב השמות של אשכול מסד הנתונים.

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

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

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

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.8.0 ועל סוכני מישור הבקרה (CPA) לגרסה 1.5.0.

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

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

   • ‫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
    
    # Change to the pgsql directory before running pg_upgrade postgres@POD_NAME:~$ cd /mnt/disks/pgsql
    
    # (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
    
    # 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. ממשיכים בפעולות הרגילות ומפעילים מחדש את הגיבויים, תוכניות הגיבוי או תהליכי השכפול שהשבתתם בשלבים אחד עד שלוש.

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

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

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

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

   • ‫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
    
    # Change to the pgsql directory before running pg_upgrade postgres@POD_NAME:~$ cd /mnt/disks/pgsql
    
    # (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. ממשיכים בפעולות הרגילות ומפעילים מחדש את הגיבויים, תוכניות הגיבוי או תהליכי השכפול שהשבתתם בשלבים אחד עד שלוש.