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

Jika Anda telah menginstal AlloyDB Omni, ikuti petunjuk di halaman ini untuk bermigrasi ke penginstalan satu image yang 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 untuk 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 gambar tunggal yang baru, dengan memasang direktori data yang ada dari 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 yang akan ditetapkan ke container AlloyDB Omni baru ini di registry container mesin host Anda—misalnya, my-omni.

   • PASSWORD: Sandi yang ditetapkan untuk 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 dalam versi AlloyDB Omni 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 disetel 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 CLI AlloyDB Omni:

   sudo alloydb database-server uninstall

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