Questa pagina mostra la documentazione della versione 15.5.4 di AlloyDB Omni.
Consulta la documentazione più recente di AlloyDB Omni.

Questa pagina è stata tradotta dall'API Cloud Translation.

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

A partire da AlloyDB Omni 15.5.4, puoi controllare AlloyDB Omni con gli strumenti di gestione dei pacchetti comuni.

Se hai già installato AlloyDB Omni, segui le istruzioni riportate in questa pagina per eseguire la migrazione alla nuova installazione con un'unica immagine.

Prerequisiti

Prima di poter iniziare l'upgrade alla versione più recente di AlloyDB Omni, completa i seguenti prerequisiti, se non l'hai già fatto.

Eseguire l'upgrade ad AlloyDB Omni 15.5.2

La versione più recente di AlloyDB Omni che supporta la CLI di AlloyDB Omni è 15.5.2. Per controllare la versione di AlloyDB Omni, esegui il seguente 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 il seguente comando per eseguire l'upgrade:

sudo alloydb database-server upgrade

Raccogliere informazioni sull'installazione esistente

Esegui questo comando:
```
cat /var/alloydb/config/dataplane.conf
```
Dall'output del comando cat, prendi nota dei valori delle seguenti variabili per riferimento futuro:
- DATADIR_PATH, ad esempio /var/alloydb/main
- ENABLE_ALLOYDB_AI, ad esempio FALSE
- PGPORT, ad esempio 5432
- INSTANCE_TYPE, ad esempio PRIMARY/READ_REPLICA

Eseguire un upgrade in loco

Arresta il database esistente:
```
sudo alloydb database-server stop
```
Avvia il nuovo AlloyDB Omni con un'immagine singola, montando la directory di 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 registry 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. Si tratta del valore che hai annotato nel passaggio 2 della sezione Raccogliere informazioni sull'installazione esistente.
Gli argomenti di docker run sono quelli utilizzati nelle versioni precedenti di AlloyDB Omni, ma puoi personalizzarli ulteriormente. Per informazioni dettagliate, consulta Personalizzare l'installazione di AlloyDB Omni.

Se il tipo di istanza del database è PRIMARY, esegui il seguente comando per creare gli utenti indicati di seguito. Si tratta di nomi utente non utilizzati al momento, 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

Se ENABLE_ALLOYDB_AI è impostato su TRUE, segui le istruzioni riportate in Install AlloyDB Omni with AlloyDB AI per configurare AlloyDB AI.
Connettiti al database per verificare che i dati non siano stati modificati:
```
docker exec -it CONTAINER_NAME psql -h localhost -U postgres
```
Disinstalla l'interfaccia a riga di comando AlloyDB Omni:
```
sudo alloydb database-server uninstall
```
La disinstallazione della CLI di AlloyDB Omni non influisce sui dati archiviati in AlloyDB Omni.