Migrer d'AlloyDB Omni version 15.5.2 ou antérieure vers la dernière version

Si vous avez déjà installé AlloyDB Omni, suivez les instructions de cette page pour migrer vers la nouvelle installation à image unique.

Prérequis

Avant de pouvoir passer à la dernière version d'AlloyDB Omni, remplissez les conditions préalables suivantes, si vous ne l'avez pas déjà fait.

Mettre à niveau vers AlloyDB Omni 15.5.2

La dernière version d'AlloyDB Omni compatible avec l'interface de ligne de commande AlloyDB Omni est la version 15.5.2. Pour vérifier la version d'AlloyDB Omni, exécutez la commande suivante :

sudo alloydb version

La sortie ressemble à ceci :

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

Si le résultat affiche une version de base de données antérieure à 15.5.2, exécutez la commande suivante pour effectuer la mise à niveau :

sudo alloydb database-server upgrade

Rassemblez des informations sur votre installation existante.

1. Exécutez la commande suivante :

   cat /var/alloydb/config/dataplane.conf

2. Dans le résultat de la commande cat, notez les valeurs des variables suivantes pour référence :

   • DATADIR_PATH, par exemple /var/alloydb/main
   • ENABLE_ALLOYDB_AI, par exemple FALSE
   • PGPORT, par exemple 5432
   • INSTANCE_TYPE, par exemple PRIMARY/READ_REPLICA

Effectuer une mise à niveau sur place

1. Arrêtez la base de données existante :

   sudo alloydb database-server stop

2. Démarrez la nouvelle image unique AlloyDB Omni en montant votre répertoire de données existant :

   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

   Remplacez les éléments suivants :

   • CONTAINER_NAME : nom à attribuer à ce nouveau conteneur AlloyDB Omni dans le registre de conteneurs de votre machine hôte (par exemple, my-omni).

   • PASSWORD : mot de passe attribué à l'utilisateur postgres du nouveau conteneur après sa création.

   • PGPORT : adresse IP du port sur lequel AlloyDB Omni s'exécute. Il s'agit de la valeur que vous avez notée à l'étape 2 de la section Recueillir des informations sur votre installation existante.

   Les arguments de docker run sont ceux utilisés dans les versions antérieures d'AlloyDB Omni, mais vous pouvez les personnaliser davantage. Pour en savoir plus, consultez Personnaliser votre installation AlloyDB Omni.

3. Si le type d'instance de votre base de données est PRIMARY, exécutez la commande suivante pour créer les utilisateurs suivants. Il s'agit de noms d'utilisateur qui ne sont pas utilisés pour le moment, mais qui sont réservés pour de futures extensions.

   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. Si ENABLE_ALLOYDB_AI est défini sur TRUE, suivez les instructions de la section Installer AlloyDB Omni avec AlloyDB AI pour configurer AlloyDB AI.

5. Connectez-vous à la base de données pour vérifier que les données n'ont pas changé :

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

6. Désinstallez la CLI AlloyDB Omni :

   sudo alloydb database-server uninstall

   La désinstallation de l'interface de ligne de commande AlloyDB Omni n'affecte pas les données stockées dans AlloyDB Omni.