Von AlloyDB Omni-Version 15.5.2 und niedriger zur neuesten Version migrieren

Wenn Sie bereits eine Installation von AlloyDB Omni haben, folgen Sie der Anleitung auf dieser Seite, um zur neuen Installation mit einem einzelnen Image zu migrieren.

Vorbereitung

Bevor Sie mit dem Upgrade auf die neueste Version von AlloyDB Omni beginnen können, müssen Sie die folgenden Voraussetzungen erfüllen, sofern Sie dies noch nicht getan haben.

Upgrade auf AlloyDB Omni 15.5.2

Die neueste AlloyDB Omni-Version, die die AlloyDB Omni CLI unterstützt, ist 15.5.2. Führen Sie den folgenden Befehl aus, um die Version von AlloyDB Omni zu prüfen:

sudo alloydb version

Die Ausgabe sieht dann ungefähr so aus:

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

Wenn in der Ausgabe eine Datenbankversion vor 15.5.2 angezeigt wird, führen Sie den folgenden Befehl aus, um ein Upgrade durchzuführen:

sudo alloydb database-server upgrade

Informationen zu Ihrer bestehenden Installation sammeln

1. Führen Sie dazu diesen Befehl aus:

   cat /var/alloydb/config/dataplane.conf

2. Notieren Sie sich aus der Ausgabe des cat-Befehls die Werte der folgenden Variablen:

   • DATADIR_PATH, z. B. /var/alloydb/main
   • ENABLE_ALLOYDB_AI, z. B. FALSE
   • PGPORT, z. B. 5432
   • INSTANCE_TYPE, z. B. PRIMARY/READ_REPLICA

Direktes Upgrade durchführen

1. Beenden Sie die vorhandene Datenbank:

   sudo alloydb database-server stop

2. Starten Sie das neue Einzelbild-AlloyDB Omni und hängen Sie Ihr vorhandenes Datenverzeichnis ein:

   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

   Ersetzen Sie Folgendes:

   • CONTAINER_NAME: Der Name, der diesem neuen AlloyDB Omni-Container in der Container-Registry Ihres Hostcomputers zugewiesen werden soll, z. B. my-omni.

   • PASSWORD: Das Passwort, das dem postgres-Nutzer des neuen Containers nach der Erstellung zugewiesen wurde.

   • PGPORT: Die IP-Adresse des Ports, auf dem AlloyDB Omni ausgeführt wird. Das ist der Wert, den Sie in Schritt 2 von Informationen zu Ihrer bestehenden Installation erfassen notiert haben.

   Die Argumente für docker run sind die, die in früheren Versionen von AlloyDB Omni verwendet wurden. Sie können sie aber weiter anpassen. Weitere Informationen finden Sie unter AlloyDB Omni-Installation anpassen.

3. Wenn der Typ Ihrer Datenbankinstanz PRIMARY ist, führen Sie den folgenden Befehl aus, um die folgenden Nutzer zu erstellen. Das sind Nutzernamen, die derzeit nicht verwendet werden, aber für zukünftige Erweiterungen reserviert sind.

   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. Wenn ENABLE_ALLOYDB_AI auf TRUE festgelegt ist, folgen Sie der Anleitung unter AlloyDB Omni mit AlloyDB AI installieren, um AlloyDB AI einzurichten.

5. Stellen Sie eine Verbindung zur Datenbank her, um zu prüfen, ob die Daten unverändert sind:

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

6. So deinstallieren Sie die AlloyDB Omni-CLI:

   sudo alloydb database-server uninstall

   Die Deinstallation der AlloyDB Omni-Befehlszeile hat keine Auswirkungen auf Ihre in AlloyDB Omni gespeicherten Daten.