Nesta página, descrevemos como fazer um upgrade de versão secundária do banco de dados para o AlloyDB Omni no Kubernetes.
Para fazer upgrade de uma versão secundária do banco de dados, há duas opções:
- Upgrade com pouco tempo de inatividade (LDTM, na sigla em inglês): em ambientes de alta disponibilidade (HA), o operador do AlloyDB Omni faz upgrade das instâncias em espera primeiro. Depois que todas as instâncias em espera forem atualizadas, o operador vai realizar uma alternância, promovendo uma das instâncias em espera atualizadas para ser a nova instância principal. Depois que a alternância for concluída, a instância principal antiga será atualizada. Esse processo sequencial garante um tempo de inatividade mínimo e mantém o ambiente principal ativo na versão anterior até que o upgrade do ambiente de espera seja totalmente validado.
- Upgrade simultâneo: em ambientes sem alta disponibilidade ou se o LDTM estiver explicitamente desativado, o operador do AlloyDB Omni faz upgrade de todas as instâncias de banco de dados simultaneamente. Esse método causa inatividade do banco de dados durante o processo de upgrade.
Limitações
Durante o processo de upgrade com baixa inatividade, cada instância em espera é atualizada sequencialmente e fica temporariamente indisponível durante o upgrade.
Para garantir que o cluster de banco de dados mantenha um objetivo de ponto de recuperação (RPO) zero e não corra o risco de perder dados durante o upgrade da instância em espera, é recomendável ter pelo menos duas instâncias em espera. Essa configuração funciona como uma configuração de alta disponibilidade de três nós.
Os upgrades com baixa inatividade não são compatíveis com clusters de banco de dados secundários em uma configuração de replicação entre data centers. Antes de fazer upgrade de um cluster de banco de dados secundário com standbys de alta disponibilidade,
desative explicitamente o LDTM definindo dbcluster.dbadmin.goog/enableLDTM=false.
Antes de começar
- Se o cluster for de alta disponibilidade e a versão do AlloyDB Omni for anterior à 15.7.1, siga as etapas listadas em Atualizar os clusters de banco de dados antes de seguir este processo de upgrade de versão secundária.
- Para evitar a perda de dados, faça backup deles.
- Enquanto a operação de upgrade com pouco tempo de inatividade estiver em andamento, a redundância de alta disponibilidade do cluster de banco de dados será temporariamente degradada enquanto uma instância em espera passa por upgrade. No entanto, o banco de dados permanece disponível para tráfego de leitura e gravação na instância principal ativa.
Ativar o processo de upgrade de versão secundária do banco de dados com baixa inatividade
O processo de upgrade com pouco tempo de inatividade (LDTM, na sigla em inglês) é ativado automaticamente por padrão se o cluster de banco de dados tiver dois ou mais standbys.
Se o cluster de banco de dados tiver apenas um modo de espera, ative o LDTM manualmente adicionando a anotação dbcluster.dbadmin.goog/enableLDTM=true ao cluster de banco de dados:
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=true
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ê forneceu ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.
Fazer upgrade da versão do AlloyDB Omni
Para fazer upgrade da versão 18.4.0, atualize os campos
databaseVersion e controlPlaneAgentsVersion no arquivo de manifesto
do cluster e aplique o arquivo novamente.
Veja a seguir o início de um arquivo de manifesto que especifica a versão
18.4.0 para databaseVersion e a versão
1.9.0 para controlPlaneAgentsVersion:
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "DB_VERSION"
controlPlaneAgentsVersion: "CONTROL_PLANE_AGENTS_VERSION"
# It is recommended to switch to UBI9 for improved security and
# compatibility.
# If you need to stick to Debian, set this field to "Debian".
databaseImageOSType: "OS_TYPE"
...
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ê forneceu ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.DB_VERSION: a versão do banco de dados para a qual você está fazendo upgrade.CONTROL_PLANE_AGENTS_VERSION: a versão dos agentes do plano de controle.OS_TYPE: opcional. O sistema operacional de base para a imagem do banco de dados. Os valores válidos sãoDebianeUBI9. Se você não especificar isso, o operador vai definir automaticamente comoDebiansedatabaseVersionfor menor que16.9.0e comoUBI9sedatabaseVersionfor16.9.0ou posterior.
Monitorar o processo de upgrade
Depois que você atualizar o arquivo de manifesto, o operador do AlloyDB Omni vai iniciar
o processo de upgrade. Para monitorar o processo de upgrade, verifique a
condição DBCUpgradeInProgress.
kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -o yaml | yq '.status.conditions[] | select(.type == "DBCUpgradeInProgress")'
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ê forneceu ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.
Enquanto o processo está em andamento, o status da condição é true. Quando o processo é
concluído, o status da condição muda para false e o motivo é atualizado para UpgradeComplete ou UpgradeFailed.
Solução de problemas
Se você receber mensagens de falha durante o processo de upgrade, consulte as seguintes seções:
Falhas antes do upgrade
Se você receber uma falha de pré-upgrade no cluster de banco de dados, verifique a mensagem e resolva o problema.
Se você quiser ignorar a mensagem de falha de pré-upgrade, ative
a anotação force-upgrade.
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/force-upgrade=true
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ê forneceu ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.
Depois que o processo de upgrade for concluído, defina a anotação force-upgrade como
false.
Falhas no upgrade
Durante o processo de upgrade automático, há vários pontos em que ele pode falhar em ambientes de alta disponibilidade. Para mais informações sobre cada cenário de falha e as ações subsequentes que o operador do AlloyDB Omni realiza, consulte a tabela a seguir.
| Mensagem de falha | Descrição | Ações necessárias do usuário |
|---|---|---|
Standby instance upgrade succeeded but its replication lag is too high to be promoted to a synchronous standby. Please monitor replication status.
|
O upgrade da instância em espera foi concluído, mas não foi possível acompanhar a instância principal com rapidez suficiente para atingir o limite de replicação síncrona antes da janela de tempo limite. Isso geralmente é causado por um tráfego de gravação intenso na instância principal. |
Para permitir que a instância em espera seja sincronizada, faça o seguinte:
|
All standbys upgrade succeeded but the switchover instance failed to promote an upgraded standby.
|
O upgrade das instâncias em espera foi concluído, mas o processo de alternância automática para promover uma instância em espera atualizada para principal falhou. |
Para investigar e resolver a falha de alternância, siga estas etapas:
|
Standby instance upgrade failed but rollback to the previous versions succeeded
|
O upgrade da instância em espera falhou, mas o operador do AlloyDB Omni reverteu a instância para a versão de trabalho anterior. Como a instância principal nunca foi modificada, o banco de dados permanece íntegro na versão anterior. |
Para diagnosticar o problema e aplicar uma correção, siga estas etapas:
|
Standby instance upgrade failed and rollback to the previous versions failed
|
O upgrade da instância em espera falhou, e a tentativa automática do operador do AlloyDB Omni de reverter para a versão anterior também falhou. A instância em espera fica em um estado não íntegro/inutilizável (reduzindo a redundância de alta disponibilidade), enquanto a principal continua a processar o tráfego de leitura/gravação na versão anterior. |
Para restaurar a integridade do cluster, reprovisione o modo de espera da seguinte maneira:
|
Corrigir instâncias primárias e em espera com versões secundárias diferentes
Para resolver esse problema, escolha uma destas opções:
Se o problema que causou a falha no upgrade tiver sido resolvido, reinicie o upgrade. Remova a anotação
start-timedo upgrade do DBCluster para solicitar que o operador do AlloyDB Omni gere um novo horário de início e tente novamente:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/start-time-
Substitua
DB_CLUSTER_NAMEpelo nome do cluster de banco de dados. É o mesmo nome de cluster de banco de dados que você forneceu ao criá-lo. Para mais informações, consulte Instalar o AlloyDB Omni no Kubernetes.Se o problema que causou a falha no upgrade persistir e você preferir manter o cluster na versão anterior, não será necessário realizar um procedimento de downgrade. Como o upgrade falhou durante a fase de espera, a instância principal nunca foi atualizada.
Para limpar o status
UpgradeFailede retornar a um estado estável, sem upgrade, atualize os camposdatabaseVersionecontrolPlaneAgentsVersiondo manifesto do DBCluster para as versões usadas antes da tentativa de upgrade e aplique o arquivo novamente.Se o upgrade ou downgrade travar em
DBCUpgradeInProgress=True(DBCUpgradeFlowBegins) após os primeiros upgrades em espera em um cluster de banco de dados secundário de replicação entre data centers, verifique se o upgrade com pouco tempo de inatividade está ativado (dbcluster.dbadmin.goog/enableLDTM=true) no cluster de banco de dados secundário. Desative o LDTM no cluster de banco de dados secundário para que o operador do AlloyDB Omni conclua o upgrade ou downgrade usando o caminho de upgrade simultâneo:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=false
Substitua
DB_CLUSTER_NAMEpelo nome do cluster de banco de dados secundário.