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

Esta página contém instruções para fazer upgrade da versão 1.0.0 para a 1.1.0 do operador AlloyDB Omni.

As etapas para fazer upgrade do AlloyDB Omni no Kubernetes dependem da versão do AlloyDB Omni executada e da versão para a qual você vai fazer upgrade.

Determinar os números de versão atuais

Kubernetes

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

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

Substitua:

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

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

Se você executar a versão 1.0.0 ou mais recente do operador AlloyDB Omni, esse comando 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 este 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, esse comando imprimirá o número da versão do operador AlloyDB Omni executado no cluster do Kubernetes.

Se você executar uma versão do AlloyDB Omni Operator anterior à 1.0.0, siga as instruções em Fazer upgrade de uma versão anterior do AlloyDB Omni Operator.

Caso contrário, prossiga para a seção Verificar os números de versão de destino.

Verificar os números da versão de destino

Kubernetes

Se você executar uma versão do AlloyDB Omni Operator 1.0.0 ou mais recente, as próximas etapas dependerão da versão do AlloyDB Omni para a qual você quer fazer upgrade. Isso, por sua vez, exige o entendimento do número da versão do AlloyDB Omni.

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.5.5 do AlloyDB Omni é a versão 5 do patch do AlloyDB Omni que oferece suporte à versão 15.5 do PostgreSQL.

Se você quiser fazer upgrade para uma versão do AlloyDB Omni compatível com uma versão mais recente do PostgreSQL, atualize o operador do AlloyDB Omni junto com o cluster de banco de dados. Cada conjunto de versões do AlloyDB Omni com 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 nas notas da versão do AlloyDB Omni.

Se você quiser fazer upgrade apenas para uma versão mais recente do patch do AlloyDB Omni, faça upgrade apenas do cluster do banco de dados, sem precisar fazer upgrade do operador do AlloyDB Omni.

Caso contrário, prossiga para a seção Fazer upgrade do operador AlloyDB Omni.

Fazer upgrade do operador do AlloyDB Omni

Kubernetes

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.1.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 recurso personalizado mais recentes do operador AlloyDB Omni:

    kubectl apply -f alloydbomni-operator/crds

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

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

Depois de concluir o upgrade do AlloyDB Omni Operator, siga as instruções em Fazer um upgrade no local para criar um novo cluster de banco de dados.

Se o cluster do AlloyDB Omni foi criado com o AlloyDB Omni Operator 1.0.0, adicione o campo controlPlaneAgentsVersion ao manifesto e defina-o como 1.1.0 antes de fazer upgrade do cluster para a versão 15.5.5. Caso contrário, o seguinte erro será exibido:

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

Um exemplo de manifesto com o campo controlPlaneAgentsVersion tem a seguinte aparência:

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