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

Selecione uma versão da documentação:

Esta página descreve como atualizar o operador do AlloyDB Omni. Os passos para atualizar o AlloyDB Omni no Kubernetes dependem da sua versão atual do AlloyDB Omni e da versão para a qual vai atualizar.

Determine as suas versões atuais

Para verificar a versão do AlloyDB Omni usada pelo cluster da base 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 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 sua base de dados.

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

Para verificar a versão do operador do AlloyDB Omni instalada no seu cluster do Kubernetes, execute o seguinte 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 operador AlloyDB Omni, o resultado é o número da versão do operador AlloyDB Omni em execução no cluster do Kubernetes.

Se executar uma versão do operador do AlloyDB Omni anterior a 1.0.0, siga as instruções em Atualize a partir de um operador do AlloyDB Omni anterior à versão 1.0.0. Caso contrário, continue com a secção Verifique os números das versões de destino.

Verifique os números das versões de destino

Se executar uma versão do operador do AlloyDB Omni 1.0.0 ou posterior, os passos seguintes dependem da versão do AlloyDB Omni para a qual quer fazer a atualização. 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.7.0 do AlloyDB Omni é compatível com a 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 adequada à sua versão de destino:

Cenário de instalação Passos de atualização
Quer atualizar para uma versão do AlloyDB Omni que suporte uma versão mais recente do PostgreSQL. Atualize o operador do AlloyDB Omni e 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. Use a tabela de compatibilidade de versões do operador do AlloyDB Omni para verificar se a versão do operador do AlloyDB Omni é compatível com a versão do operador.
Quiser atualizar apenas para uma versão de patch mais recente do AlloyDB Omni. Atualize apenas o cluster de base de dados. Consulte a tabela de compatibilidade de versões do operador do AlloyDB Omni e as notas de lançamento antes de fazer a atualização para determinar se também tem de atualizar o operador do AlloyDB Omni.
Todos os outros cenários Siga os passos para atualizar o operador do AlloyDB Omni.

Atualize o operador do AlloyDB Omni

Para atualizar o operador do AlloyDB Omni, 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 operador AlloyDB Omni para a qual está a fazer a atualização, por exemplo, 1.3.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 operador do AlloyDB Omni 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

    Para atualizar o dbCluster, tem de atualizar as versões databaseVersion e controlPlaneAgentsVersion no ficheiro do manifesto. Segue-se um exemplo de parte de um ficheiro de manifesto que especifica a versão 15.7.0 de databaseVersion e a versão 1.3.0 de controlPlaneAgentsVersion:

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