Mengupgrade ke AlloyDB Omni versi 16.8.0 di Kubernetes

Pilih versi dokumentasi:

Halaman ini menjelaskan cara melakukan upgrade versi utama ke AlloyDB Omni versi 16.8.0 di Kubernetes.

Sebelum memulai

  • Pastikan versi operator Kubernetes AlloyDB Omni Anda adalah 1.5.0. Untuk mengupgrade versi operator AlloyDB Omni, lihat Bermigrasi ke versi operator Kubernetes AlloyDB Omni terbaru.

  • Pastikan Anda memiliki ruang disk kosong minimal 5 GB.

  • Jika Anda menjalankan sistem pencadangan eksternal atau jarak jauh, lakukan pencadangan penuh dan jeda semua pencadangan terjadwal untuk menghindari pencadangan selama proses upgrade.

  • Untuk lingkungan ketersediaan tinggi (HA) dan pemulihan data (DR), pisahkan cluster database Anda sebelum mengupgradenya.

Mengupgrade versi AlloyDB Omni

Untuk mengupgrade versi AlloyDB Omni menggunakan pg_upgrade, lakukan salah satu hal berikut:

Melakukan upgrade dengan skrip

Anda dapat menemukan skrip yang melakukan langkah-langkah upgrade manual di Contoh AlloyDB Omni di GitHub.

Untuk menggunakan skrip upgrade, download skrip dan jalankan perintah berikut:

./MVU.sh 16.8.0 1.5.0 NAME NAMESPACE

Ganti variabel berikut:

  • NAME: nama cluster database Anda.
  • NAMESPACE: namespace untuk cluster database Anda.

Melakukan langkah-langkah upgrade manual

  1. Cadangkan data Anda untuk menghindari kehilangan data.

  2. Hapus rencana cadangan Anda.

  3. Hentikan semua proses replikasi. Hal ini mencakup replikasi fisik yang digunakan untuk ketersediaan tinggi (HA) dan ketahanan data (DR) serta semua aliran replikasi logis.

  4. Anotasikan cluster database Anda untuk menentukan upgrade versi manual.

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

    Ganti variabel berikut:

    • NAME: nama cluster database Anda.

  5. Hentikan proses PostgreSQL agar data dapat dipindahkan untuk upgrade.

    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

    Ganti variabel berikut:

    • POD_NAME: nama pod Anda.

  6. Patch cluster database Anda ke versi 16.8.0 dan agen bidang kontrol (CPA) Anda ke 1.5.0.

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

    Ganti variabel berikut:

    • NAME: nama cluster database Anda.

  7. Buat cluster database kosong untuk versi AlloyDB Omni yang diupgrade.

    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 ~

    Ganti variabel berikut:

    • POD_NAME: nama pod Anda.

  8. Ubah pg_hba.conf di cluster database yang sudah ada untuk memberikan izin dan koneksi yang diperlukan proses upgrade.

    # 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

    Ganti variabel berikut:

    • POD_NAME: nama pod Anda.

  9. Ubah pg_hba.conf di cluster database baru untuk memberikan izin dan koneksi yang diperlukan proses upgrade.

    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

    Ganti variabel berikut:

    • POD_NAME: nama pod Anda.

  10. Upgrade cluster database Anda.

    # (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

# 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/

    Ganti variabel berikut:

    • POD_NAME: nama pod Anda.

  11. Setelah upgrade berhasil, hapus anotasi upgrade versi manual dari cluster database Anda.

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

    Ganti variabel berikut:

    • NAME: nama cluster database Anda.

  12. Lanjutkan operasi normal dan aktifkan kembali pencadangan, rencana pencadangan, atau proses replikasi yang Anda nonaktifkan pada langkah satu hingga tiga.