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

Selecione uma versão da documentação:

A partir do AlloyDB Omni 15.5.4, controla o AlloyDB Omni com ferramentas comuns de gestão de pacotes.

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

Pré-requisitos

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

Atualize para o AlloyDB Omni 15.5.2

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

sudo alloydb version

O resultado tem um aspeto semelhante ao seguinte:

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

Se a saída apresentar uma versão da base de dados anterior a 15.5.2, execute o seguinte comando para atualizar:

sudo alloydb database-server upgrade

Recolha informações sobre a instalação existente

  1. Execute o seguinte comando:

    cat /var/alloydb/config/dataplane.conf

  2. A partir da saída do comando cat, tome nota dos 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

Faça uma atualização no local

  1. Parar a base de dados existente:

    sudo alloydb database-server stop

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

    • CONTAINER_NAME: o nome a atribuir a este novo contentor do AlloyDB Omni no registo de contentores da sua máquina anfitriã, por exemplo, my-omni.

    • PASSWORD: a palavra-passe atribuída ao utilizador postgres do novo contentor após a respetiva criação.

    • PGPORT: o endereço IP da porta em que o AlloyDB Omni é executado. Este é o valor que anotou no passo 2 de Recolha informações sobre a sua instalação existente.

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

  3. Se o tipo de instância da base de dados for PRIMARY, execute o seguinte comando para criar os seguintes utilizadores. Estes são nomes de utilizador que não estão a ser usados de 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 Instale o AlloyDB Omni com o AlloyDB AI para configurar o AlloyDB AI.

  5. Associe à base de dados para verificar se os dados permanecem inalterados:

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

  6. Desinstale a CLI AlloyDB Omni:

    sudo alloydb database-server uninstall

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