Migre para a versão mais recente do AlloyDB Omni Kubernetes Operator

Selecione uma versão da documentação:

Esta página aborda as instruções para atualizar da versão 1.0.0 para a versão 1.1.0 do AlloyDB Omni Operator.

Os passos que segue para atualizar o AlloyDB Omni no Kubernetes dependem da versão do AlloyDB Omni que executa e da versão para a qual atualiza.

Determine os números da sua versão atual

Kubernetes

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

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

Substitua o seguinte:

  • DB_CLUSTER_NAME: o nome do cluster da base de dados. É o mesmo nome do cluster da base de dados que declarou quando o criou.

  • NAMESPACE: o namespace do Kubernetes do cluster da base de dados.

Se executar a versão 1.0.0 ou posterior do AlloyDB Omni Operator, este comando imprime a versão do AlloyDB Omni usada pelo seu cluster de base de dados.

Para verificar a versão do AlloyDB Omni Operator instalada no seu cluster do Kubernetes, execute este comando:

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

Se executar a versão 1.0.0 ou posterior do AlloyDB Omni Operator, este comando imprime o número da versão do AlloyDB Omni Operator em execução no seu cluster do Kubernetes.

Se executar uma versão do AlloyDB Omni Operator anterior a 1.0.0, siga as instruções em Atualize a partir de um AlloyDB Omni Operator anterior à versão 1.0.0.

Caso contrário, avance para a secção Verifique os números das versões de destino.

Verifique os números das versões de destino

Kubernetes

Se executar uma versão do AlloyDB Omni Operator 1.0.0 ou posterior, os passos seguintes dependem da versão do AlloyDB Omni para a qual quer fazer a atualização. Isto, por sua vez, requer a compreensão 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 respetiva compatibilidade com o PostgreSQL
  • O número da versão secundária da respetiva compatibilidade com o PostgreSQL
  • O número da versão do patch deste lançamento do AlloyDB Omni

Por exemplo, a versão 15.5.5 do AlloyDB Omni é a versão de patch 5 do AlloyDB Omni que suporta a versão 15.5 do PostgreSQL.

Se quiser atualizar para uma versão do AlloyDB Omni que suporte uma versão mais recente do PostgreSQL, tem de atualizar o próprio operador do AlloyDB Omni, juntamente com o cluster da base de dados. Cada conjunto de lançamentos do AlloyDB Omni que suporta uma versão secundária específica do PostgreSQL tem o seu próprio número de versão do operador do AlloyDB Omni, que pode encontrar na nota de lançamento da versão do AlloyDB Omni.

Se quiser atualizar apenas para uma versão de patch mais recente do AlloyDB Omni, pode atualizar apenas o cluster da base de dados, sem necessidade de atualizar o próprio operador do AlloyDB Omni.

Caso contrário, avance para a secção Atualize o operador do AlloyDB Omni.

Atualize o operador do AlloyDB Omni

Kubernetes

Para atualizar o AlloyDB Omni Operator, siga estes passos:

  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 AlloyDB Omni Operator para a qual está a fazer a atualização, por exemplo, 1.1.0.

  2. Transfira o operador do AlloyDB Omni mais recente:

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

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

    kubectl apply -f alloydbomni-operator/crds

  4. Atualize o gráfico Helm do operador AlloyDB Omni:

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

Depois de concluir a atualização do AlloyDB Omni Operator, siga as instruções em Faça uma atualização no local para criar um novo cluster de base de dados.

Se o seu 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 atualizar o cluster para a versão 15.5.5. Caso contrário, é apresentado o seguinte erro:

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 manifesto de exemplo com o campo controlPlaneAgentsVersion tem o seguinte aspeto:

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