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 de banco de dados. É o mesmo nome de cluster de banco de dados que você declarou quando o criou.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 do 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 do AlloyDB Omni instalada 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 do AlloyDB Omni, a saída será o número da versão do operador do AlloyDB Omni em execução no cluster do Kubernetes.
Se você executar uma versão do operador do AlloyDB Omni anterior à 1.0.0, siga as instruções em Fazer upgrade de um operador do AlloyDB Omni anterior à versão 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 do 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 o 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 de 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 de 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 seu próprio número de versão do operador do AlloyDB Omni, que pode ser encontrado em a nota de versão para a versão do AlloyDB Omni. Use a tabela de compatibilidade de 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 de banco de dados. Consulte a tabela de compatibilidade de versão do operador do AlloyDB Omni e as notas de versão antes de fazer o upgrade para determinar se também é necessário 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 do AlloyDB Omni, siga estas etapas:
Defina as variáveis de ambiente:
export GCS_BUCKET=alloydb-omni-operatorexport OPERATOR_VERSION=OPERATOR_VERSIONexport HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgzSubstitua
OPERATOR_VERSIONpela versão do operador do AlloyDB Omni para a qual você está fazendo o upgrade, por exemplo,1.3.0.Faça o download do operador do AlloyDB Omni mais recente:
gcloud storage cp -r gs://$GCS_BUCKET/$HELM_PATH ./tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgzAplique as definições de recursos personalizados do operador do AlloyDB Omni mais recente:
kubectl apply -f alloydbomni-operator/crdsFaç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 5mPara atualizar o
dbCluster, é necessário atualizar as versõesdatabaseVersionecontrolPlaneAgentsVersionno arquivo de manifesto. A seguir, parte de um arquivo de manifesto que especifica a versão 15.7.0 dedatabaseVersione a versão 1.3.0 decontrolPlaneAgentsVersion:apiVersion: alloydbomni.dbadmin.goog/v1 kind: DBCluster metadata: name: DB_CLUSTER_NAME spec: databaseVersion: "15.7.0" controlPlaneAgentsVersion: "1.3.0" ...