Migrar da versão 15.5.2 e anteriores do AlloyDB Omni para a versão mais recente

Se você já tiver uma instalação do AlloyDB Omni, siga as instruções nesta página para migrar para a nova instalação de imagem única.

Pré-requisitos

Antes de começar a fazer upgrade para a versão mais recente do AlloyDB Omni, conclua os pré-requisitos a seguir, se ainda não tiver feito isso.

Fazer upgrade para o AlloyDB Omni 15.5.2

A versão mais recente do AlloyDB Omni que oferece suporte à CLI do AlloyDB Omni é a 15.5.2. Para verificar a versão do AlloyDB Omni, execute o seguinte comando:

sudo alloydb version

A saída será assim:

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

Se a saída mostrar uma versão do banco de dados anterior a 15.5.2, execute o seguinte comando para fazer upgrade:

sudo alloydb database-server upgrade

Reúna informações sobre sua instalação atual

1. Execute este comando:

   cat /var/alloydb/config/dataplane.conf

2. Na saída do comando cat, anote os valores das seguintes variáveis para sua referência:

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

Fazer um upgrade no local

1. Pare o banco de dados atual:

   sudo alloydb database-server stop

2. Inicie o novo AlloyDB Omni de imagem única, montando o diretório de dados atual de 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

   Substitua:

   • CONTAINER_NAME: o nome a ser atribuído a esse novo contêiner do AlloyDB Omni no registro de contêineres da máquina host. Por exemplo, my-omni.

   • PASSWORD: a senha atribuída ao usuário postgres do novo contêiner após a criação.

   • PGPORT: o endereço IP da porta em que o AlloyDB Omni é executado. Esse é o valor que você anotou na etapa 2 de Reunir informações sobre sua instalação atual.

   Os argumentos de docker run são os usados em versões anteriores do AlloyDB Omni, mas você pode personalizá-los ainda mais. Consulte Personalizar a instalação do AlloyDB Omni para mais detalhes.

3. Se o tipo de instância do banco de dados for PRIMARY, execute o comando a seguir para criar os usuários. São nomes de usuário que não estão sendo usados no momento, mas estão reservados para extensões 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. Se ENABLE_ALLOYDB_AI estiver definido como TRUE, siga as instruções em Instalar o AlloyDB Omni com o AlloyDB AI para configurar o AlloyDB AI.

5. Conecte-se ao banco de dados para verificar se os dados não foram alterados:

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

6. Desinstale a CLI do AlloyDB Omni:

   sudo alloydb database-server uninstall

   A desinstalação da CLI do AlloyDB Omni não afeta os dados armazenados no AlloyDB Omni.