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

A partir do AlloyDB Omni 15.5.4, você controla o AlloyDB Omni com ferramentas comuns de gerenciamento de pacotes.

Se você já tiver uma instalação do AlloyDB Omni, siga as instruções desta 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 à 15.5.2, execute o comando a seguir para fazer upgrade:

sudo alloydb database-server upgrade

Coletar informações sobre a 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 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 seu diretório de dados anterior:

   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 para atribuir a este 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 Coletar informações sobre a instalação atual.

   Os argumentos para 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 saber mais.

3. Se o tipo de instância do banco de dados for PRIMARY, execute o comando a seguir para criar os usuários abaixo. Esses são nomes de usuário que não estão em uso no momento, mas 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.