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

Selecciona una versión de la documentación:

A partir de la versión 15.5.4 de AlloyDB Omni, puedes controlar AlloyDB Omni con herramientas comunes de administración de paquetes.

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 comenzar a actualizar a la versión más reciente de AlloyDB Omni, completa los siguientes requisitos previos, si aún no lo hiciste.

Actualiza 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 verificar 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

Recopila información sobre tu instalación existente

  1. Ejecuta el siguiente comando:

    cat /var/alloydb/config/dataplane.conf

  2. En el resultado 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

Realiza una actualización in situ

  1. Detén la base de datos existente:

    sudo alloydb database-server stop

  2. Inicia el nuevo AlloyDB Omni de una sola imagen y, luego, activa tu directorio de datos existente:

    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

    Reemplaza lo siguiente:

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

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

    • PGPORT: Es la dirección IP del puerto en el que se ejecuta AlloyDB Omni. Este es el valor que anotaste en el paso 2 de Recopila información sobre tu instalación existente.

    Los argumentos para docker run son los que se usaron en versiones anteriores de AlloyDB Omni, pero puedes personalizarlos aún más. Consulta Cómo personalizar tu instalación de AlloyDB Omni para obtener más detalles.

  3. Si el tipo de instancia de tu base de datos es PRIMARY, ejecuta el siguiente comando para crear los usuarios que se indican a continuación. Estos son nombres de usuario que no se usan en este momento, pero que están reservados para extensiones futuras.

    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 que se indican en Instala AlloyDB Omni con AlloyDB AI para configurar AlloyDB AI.

  5. Conéctate a la base de datos para verificar que los datos no hayan 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 los datos almacenados en AlloyDB Omni.