Migrar de AlloyDB Omni versión 15.5.2 y anteriores a la versión más reciente

Si ya tienes una instalación de AlloyDB Omni, sigue las instrucciones de esta página para migrar a la nueva instalación de una sola imagen.

Requisitos previos

Antes de empezar a actualizar a la versión más reciente de AlloyDB Omni, completa los siguientes requisitos previos (si aún no lo has hecho).

Actualizar a AlloyDB Omni 15.5.2

La versión más reciente de AlloyDB Omni que admite la CLI de AlloyDB Omni es la 15.5.2. Para comprobar la versión de AlloyDB Omni, ejecuta el siguiente comando:

sudo alloydb version

El resultado es similar al siguiente:

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

Si el resultado muestra una versión de la base de datos anterior a la 15.5.2, ejecuta el siguiente comando para actualizarla:

sudo alloydb database-server upgrade

Recopilar información sobre tu instalación

1. Ejecuta el siguiente comando:

   cat /var/alloydb/config/dataplane.conf

2. En la salida del comando cat, anota los valores de las siguientes variables para consultarlos:

   • DATADIR_PATH, por ejemplo, /var/alloydb/main
   • ENABLE_ALLOYDB_AI, por ejemplo, FALSE
   • PGPORT, por ejemplo, 5432
   • INSTANCE_TYPE, por ejemplo, PRIMARY/READ_REPLICA

Realizar una actualización en contexto

1. Detén la base de datos:

   sudo alloydb database-server stop

2. Inicia la nueva imagen única de AlloyDB Omni y monta el directorio de datos que tenías antes:

   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

   Haz los cambios siguientes:

   • CONTAINER_NAME: el nombre que se asignará a este nuevo contenedor de AlloyDB Omni en el registro de contenedores de tu máquina host. Por ejemplo, my-omni.

   • PASSWORD: la contraseña asignada al usuario postgres del nuevo contenedor después de su creación.

   • PGPORT: la dirección IP del puerto en el que se ejecuta AlloyDB Omni. Este es el valor que anotó en el paso 2 de Recoger información sobre la instalación actual.

   Los argumentos de docker run son los que se usaban en versiones anteriores de AlloyDB Omni, pero puedes personalizarlos aún más. Para obtener más información, consulta Personalizar la instalación de AlloyDB Omni.

3. Si el tipo de instancia de base de datos es PRIMARY, ejecuta el siguiente comando para crear los usuarios que se indican a continuación. Se trata de nombres de usuario que no se están usando en este momento, pero que se han reservado para futuras extensiones.

   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á configurado como TRUE, sigue las instrucciones de Instalar AlloyDB Omni con AlloyDB AI para configurar AlloyDB AI.

5. Conéctate a la base de datos para verificar que los datos no han cambiado:

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

6. Desinstala la CLI de AlloyDB Omni:

   sudo alloydb database-server uninstall

   La desinstalación de la CLI de AlloyDB Omni no afecta a los datos almacenados en AlloyDB Omni.