Esta página documenta a versão 16.3.0 do AlloyDB Omni usando a opção de implantação de contêineres. Escolha outra opção de implantação.

Faça upgrade do operador AlloyDB Omni no Kubernetes para a versão 1.4.0

Selecione uma versão da documentação:

Nesta página, descrevemos como fazer upgrade do operador do AlloyDB Omni para a versão 1.4.0. As etapas do upgrade dependem da versão atual do AlloyDB Omni e da versão para a qual você está fazendo upgrade.

Antes de começar

Ao fazer upgrade do operador do AlloyDB Omni, o banco de dados será reiniciado, a menos que todas as condições a seguir sejam verdadeiras:

Você está fazendo upgrade do operador do AlloyDB Omni versão 1.1.1 para uma versão mais recente.
Você está usando o banco de dados do AlloyDB Omni versão 15.5.5 ou mais recente.
O AlloyDB AI não está ativado. Para mais informações, consulte Criar um cluster de banco de dados com o AlloyDB AI.

Se o banco de dados for reiniciado, não haverá perda de dados.

A partir da versão 15.7.1 do banco de dados do AlloyDB Omni, a alta disponibilidade (HA) nos clusters de banco de dados do AlloyDB Omni baseados no Kubernetes usa uma nova arquitetura para oferecer mais reforço da proteção e melhorias para a configuração automática de HA, failover e recursos de correção.

Se você estiver fazendo upgrade da versão 15.7.0 (ou anterior) do banco de dados do AlloyDB Omni para a versão 15.7.1 (ou mais recente) ou se estiver fazendo downgrade de versões, será necessário desativar a HA e reativá-la após a conclusão do processo.

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 ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.
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, verifique 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 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 16.3.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 o próprio número de versão do operador 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.
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.
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-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.4.0.

Baixe o operador do AlloyDB Omni mais recente:

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

Aplique as definições de recursos personalizados mais recentes do operador do AlloyDB Omni:
```
kubectl apply -f alloydbomni-operator/crds
```

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

Atualizar os clusters de banco de dados

Para atualizar o dbCluster, siga estas etapas:

Se você estiver fazendo upgrade de um cluster de banco de dados do AlloyDB Omni de HA da versão 15.7.0 (ou anterior) para a versão 15.7.1 (ou mais recente), siga estas etapas para desativar a HA.

Observação: Se você estiver fazendo upgrade de uma versão mais antiga para a versão 15.7.0 (ou anterior) ou da versão 15.7.1 (ou mais recente) para uma versão mais recente, pule esta etapa.
1. Defina numberOfStandbys como 0 no manifesto do cluster.
```
spec:
  availability:
    numberOfStandbys: 0
```
1. Para desativar a HA, reaplique o manifesto.
Atualize as versões databaseVersion e controlPlaneAgentsVersion no manifesto do cluster e reaplique o manifesto.

Execute o exemplo a seguir, que faz parte de um arquivo de manifesto que especifica a versão 16.3.0 de databaseVersion e a versão 1.4.0 de controlPlaneAgentsVersion:
```
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "16.3.0"
  controlPlaneAgentsVersion: "1.4.0"
...
```
Substitua a seguinte variável:
- DB_CLUSTER_NAME: o nome do cluster de banco de dados. É o mesmo nome de cluster de banco de dados que você declarou ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.
Aguarde a conclusão do upgrade.
Se você desativou a HA antes do upgrade, siga estas etapas.
1. Defina numberOfStandbys de volta para o número anterior ao upgrade no manifesto do cluster.
2. Reaplique o manifesto para reativar a HA.

Atualizar `alloydb_omni_instance_postgresql_wait_time_second_total`

Se você estiver usando a métrica alloydb_omni_instance_postgresql_wait_time_second_total, será necessário atualizá-la para alloydb_omni_instance_postgresql_wait_time_us_total. Para consumir as duas métricas, use o operador OR do Prometheus.

(promQL A) OR (promQL A, but replace all occurrences of alloydb_omni_instance_postgresql_wait_time_second_total to alloydb_omni_instance_postgresql_wait_time_us_total)

Se você usar seconds como a unidade dessa métrica, será necessário convertê-la para us.

Para mais informações, consulte as notas de lançamento.