Cette page présente la documentation de la version 15.5.4 d'AlloyDB Omni.
Consultez la dernière documentation AlloyDB Omni.

Cette page a été traduite par l'API Cloud Translation.

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

À partir d'AlloyDB Omni 15.5.4, vous pouvez contrôler AlloyDB Omni à l'aide d'outils de gestion de paquets courants.

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 commencer à passer à la dernière version d'AlloyDB Omni, vérifiez que vous remplissez les conditions préalables suivantes, si ce n'est pas déjà fait.

Mettre à niveau vers AlloyDB Omni 15.5.2

La dernière version d'AlloyDB Omni compatible avec la CLI 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 la version de la base de données affichée est antérieure à 15.5.2, exécutez la commande suivante pour la mettre à niveau:

sudo alloydb database-server upgrade

Rassembler des informations sur votre installation existante

Exécutez la commande suivante :
```
cat /var/alloydb/config/dataplane.conf
```
À partir de la sortie 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

Arrêtez la base de données existante:
```
sudo alloydb database-server stop
```
Démarrez la nouvelle image AlloyDB Omni, en montant votre ancien répertoire de données:
```
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 d'AlloyDB Omni.

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'utilisateurs inutilisés pour le moment, mais réservés à 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

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.
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
```
Désinstallez la CLI AlloyDB Omni:
```
sudo alloydb database-server uninstall
```
La désinstallation de la CLI AlloyDB Omni n'affecte pas vos données stockées dans AlloyDB Omni.