Esegui la migrazione dalla versione 15.5.2 e precedenti di AlloyDB Omni alla versione più recente

Se hai un'installazione esistente di AlloyDB Omni, segui le istruzioni riportate in questa pagina per eseguire la migrazione alla nuova installazione a immagine singola.

Prerequisiti

Prima di poter iniziare l'upgrade all'ultima versione di AlloyDB Omni, completa i seguenti prerequisiti, se non l'hai già fatto.

Esegui l'upgrade ad AlloyDB Omni 15.5.2

L'ultima versione di AlloyDB Omni che supporta la CLI AlloyDB Omni è la 15.5.2. Per controllare la versione di AlloyDB Omni, esegui questo comando:

sudo alloydb version

L'output è simile al seguente:

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

Se l'output mostra una versione del database precedente alla 15.5.2, esegui questo comando per l'upgrade:

sudo alloydb database-server upgrade

Raccogliere informazioni sull'installazione esistente

1. Esegui questo comando:

   cat /var/alloydb/config/dataplane.conf

2. Dall'output del comando cat, prendi nota dei valori delle seguenti variabili per riferimento:

   • DATADIR_PATH, ad esempio /var/alloydb/main
   • ENABLE_ALLOYDB_AI, ad esempio FALSE
   • PGPORT, ad esempio 5432
   • INSTANCE_TYPE, ad esempio PRIMARY/READ_REPLICA

Esegui un upgrade in loco

1. Arresta il database esistente:

   sudo alloydb database-server stop

2. Avvia la nuova immagine singola di AlloyDB Omni, montando la directory dei dati esistente:

   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

   Sostituisci quanto segue:

   • CONTAINER_NAME: il nome da assegnare a questo nuovo contenitore AlloyDB Omni nel registro dei contenitori della macchina host, ad esempio my-omni.

   • PASSWORD: la password assegnata all'utente postgres del nuovo contenitore dopo la sua creazione.

   • PGPORT: l'indirizzo IP della porta su cui viene eseguito AlloyDB Omni. Questo è il valore che hai annotato nel passaggio 2 di Raccogli informazioni sull'installazione esistente.

   Gli argomenti di docker run sono quelli utilizzati nelle versioni precedenti di AlloyDB Omni, ma puoi personalizzarli ulteriormente. Per maggiori dettagli, consulta Personalizzare l'installazione di AlloyDB Omni.

3. Se il tipo di istanza del database è PRIMARY, esegui il seguente comando per creare gli utenti seguenti. Questi sono nomi utente attualmente inutilizzati, ma riservati per estensioni future.

   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. Se ENABLE_ALLOYDB_AI è impostato su TRUE, segui le istruzioni riportate in Installare AlloyDB Omni con AlloyDB AI per configurare AlloyDB AI.

5. Connettiti al database per verificare che i dati siano invariati:

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

6. Disinstalla la CLI AlloyDB Omni:

   sudo alloydb database-server uninstall

   La disinstallazione della CLI AlloyDB Omni non influisce sui dati archiviati in AlloyDB Omni.