Migrar para a versão mais recente do operador AlloyDB Omni no Kubernetes

Esta página descreve como fazer upgrade do operador AlloyDB Omni. As etapas para fazer upgrade do AlloyDB Omni no Kubernetes dependem da versão atual do AlloyDB Omni e da versão para a qual você vai fazer upgrade.

Determinar suas versões atuais

Para verificar a versão do AlloyDB Omni usada pelo cluster de banco de dados, execute o seguinte comando:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

Faça as seguintes substituições:

  • DB_CLUSTER_NAME: o nome do cluster do banco de dados. É o mesmo nome de cluster de banco de dados que você declarou ao criar.

  • NAMESPACE: o namespace do Kubernetes do cluster de banco de dados.

Se você executar a versão 1.0.0 ou mais recente do operador AlloyDB Omni, esse comando vai imprimir a versão do AlloyDB Omni usada pelo cluster de banco de dados.

Para verificar a versão do operador AlloyDB Omni instalado no cluster do Kubernetes, execute o seguinte comando:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

Se você executar a versão 1.0.0 ou mais recente do operador AlloyDB Omni, a saída será o número da versão do operador AlloyDB Omni em execução no cluster do Kubernetes.

Se você estiver executando uma versão do operador AlloyDB Omni anterior à 1.0.0, siga as instruções em Fazer upgrade de um operador AlloyDB Omni anterior à 1.0.0. Caso contrário, continue com Verificar os números da versão de destino.

Verificar os números da versão de destino

Se você executar uma versão do operador AlloyDB Omni 1.0.0 ou mais recente, as próximas etapas vão depender da versão do AlloyDB Omni para a qual você quer fazer upgrade. O número da versão do AlloyDB Omni tem os seguintes componentes:

  • O número da versão principal da compatibilidade com o PostgreSQL
  • O número da versão secundária da compatibilidade com o PostgreSQL
  • O número da versão do patch desta versão do AlloyDB Omni

Por exemplo, a versão 15.7.0 do AlloyDB Omni oferece suporte à versão 15.7 do PostgreSQL e não tem um patch de lançamento do AlloyDB Omni.

Escolha a opção de instalação que funciona para sua versão de destino:

Cenário de instalação Etapas de atualização
Você quer fazer upgrade para uma versão do AlloyDB Omni que oferece suporte a uma versão mais recente do PostgreSQL. Faça upgrade do operador do AlloyDB Omni e do cluster do banco de dados. Cada conjunto de versões do AlloyDB Omni que oferece suporte a uma versão secundária específica do PostgreSQL tem o próprio número de versão do operador do AlloyDB Omni, que pode ser encontrado na nota da versão da versão do AlloyDB Omni. Use a tabela de compatibilidade da versão do operador do AlloyDB Omni para verificar se a versão do operador do AlloyDB Omni é compatível com a versão do operador.
Você quer fazer upgrade apenas para uma versão de patch mais recente do AlloyDB Omni. Faça upgrade apenas do cluster do banco de dados. Consulte a tabela de compatibilidade da versão do operador do AlloyDB Omni e as notas da versão antes de fazer o upgrade para determinar se você também precisa atualizar o operador do AlloyDB Omni.
Todos os outros cenários Siga as etapas em fazer upgrade do operador do AlloyDB Omni.

Fazer upgrade do operador do AlloyDB Omni

Para fazer upgrade do operador AlloyDB Omni, siga estas etapas:

  1. Defina as variáveis de ambiente:

    export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    Substitua OPERATOR_VERSION pela versão do operador do AlloyDB Omni para a qual você está fazendo upgrade, por exemplo, 1.2.0.

  2. Faça o download da versão mais recente do operador do AlloyDB Omni:

    gsutil cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

  3. Aplique as definições de recursos personalizados do operador do AlloyDB Omni mais recentes:

    kubectl apply -f alloydbomni-operator/crds

  4. Faça upgrade do gráfico do Helm do operador do AlloyDB Omni:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    Para atualizar o dbCluster, é necessário atualizar as versões databaseVersion e controlPlaneAgentsVersion no arquivo de manifesto. O exemplo abaixo faz parte de um arquivo de manifesto que especifica a versão 15.7.0 de databaseVersion e a versão 1.2.0 de controlPlaneAgentsVersion:

    apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "15.7.0"
controlPlaneAgentsVersion: "1.2.0"
...