Bermigrasi dari AlloyDB Omni versi 15.5.2 dan yang lebih lama ke versi terbaru

Mulai AlloyDB Omni 15.5.4, Anda dapat mengontrol AlloyDB Omni dengan alat pengelolaan paket umum.

Jika Anda sudah menginstal AlloyDB Omni, ikuti petunjuk di halaman ini untuk bermigrasi ke penginstalan satu image baru.

Prasyarat

Sebelum Anda dapat mulai mengupgrade ke AlloyDB Omni versi terbaru, selesaikan prasyarat berikut, jika Anda belum melakukannya.

Mengupgrade ke AlloyDB Omni 15.5.2

Versi AlloyDB Omni terbaru yang mendukung AlloyDB Omni CLI adalah 15.5.2. Untuk memeriksa versi AlloyDB Omni, jalankan perintah berikut:

sudo alloydb version

Outputnya terlihat mirip dengan yang berikut ini:

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

Jika output menampilkan versi database yang lebih lama dari 15.5.2, jalankan perintah berikut untuk mengupgrade:

sudo alloydb database-server upgrade

Mengumpulkan informasi tentang penginstalan yang ada

1. Jalankan perintah berikut:

   cat /var/alloydb/config/dataplane.conf

2. Dari output perintah cat, catat nilai variabel berikut sebagai referensi Anda:

   • DATADIR_PATH—misalnya, /var/alloydb/main
   • ENABLE_ALLOYDB_AI—misalnya, FALSE
   • PGPORT—misalnya, 5432
   • INSTANCE_TYPE—misalnya, PRIMARY/READ_REPLICA

Melakukan upgrade di tempat

1. Hentikan database yang ada:

   sudo alloydb database-server stop

2. Mulai AlloyDB Omni satu gambar baru, dengan memasang direktori data yang ada sebelumnya:

   docker run --name CONTAINER_NAME \
       -e POSTGRES_PASSWORD=PASSWORD \
       -e PGDATA=/var/lib/postgresql/data \
       -v /var/alloydb/main/data:/var/lib/postgresql/data \
       -v /dev/shm:/dev/shm \
       -p PGPORT:5432 \
       --network=host \
       --ulimit=nice=-20:-20 \
       --ulimit=core=-1:-1 \
       --log-driver=journald \
       -d google/alloydbomni:15.5.4

   Ganti kode berikut:

   • CONTAINER_NAME: Nama untuk menetapkan penampung AlloyDB Omni baru ini di registry penampung mesin host Anda—misalnya, my-omni.

   • PASSWORD: Sandi yang menetapkan pengguna postgres penampung baru setelah pembuatannya.

   • PGPORT: Alamat IP port tempat AlloyDB Omni berjalan. Ini adalah nilai yang Anda catat di langkah 2 Mengumpulkan informasi tentang penginstalan yang ada.

   Argumen untuk docker run adalah argumen yang digunakan di AlloyDB Omni versi sebelumnya, tetapi Anda dapat menyesuaikannya lebih lanjut. Lihat Menyesuaikan penginstalan AlloyDB Omni untuk mengetahui detailnya.

3. Jika jenis instance database Anda adalah PRIMARY, jalankan perintah berikut untuk membuat pengguna berikut. Ini adalah nama pengguna yang saat ini tidak digunakan, tetapi dicadangkan untuk ekstensi mendatang.

   for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
     echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
       -c "CREATE ROLE ${name} NOLOGIN;" \
       -c "CREATE TABLE ${name}_table();" \
       -c "ALTER TABLE ${name}_table OWNER TO ${name};"
   done

4. Jika ENABLE_ALLOYDB_AI ditetapkan ke TRUE, ikuti petunjuk di Menginstal AlloyDB Omni dengan AlloyDB AI untuk menyiapkan AlloyDB AI.

5. Hubungkan ke database untuk memverifikasi bahwa data tidak berubah:

   docker exec -it CONTAINER_NAME psql -h localhost -U postgres

6. Uninstal AlloyDB Omni CLI:

   sudo alloydb database-server uninstall

   Penguninstalan CLI AlloyDB Omni tidak memengaruhi data Anda yang disimpan di AlloyDB Omni.