Fazer um upgrade de versão secundária do banco de dados para o AlloyDB Omni no Kubernetes

Selecione uma versão da documentação:

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ão Debian e UBI9. Se você não especificar isso, o operador vai definir automaticamente como Debian se databaseVersion for menor que 16.9.0 e como UBI9 se databaseVersion for 16.9.0 ou 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:

  1. Aguarde o tráfego de gravação diminuir para que a instância em espera seja atualizada gradualmente. O operador do AlloyDB Omni o promove automaticamente assim que ele é sincronizado.
  2. (Opcional) É possível aumentar o tempo limite de atualização definindo a anotação upgrade.alloydbomni.dbadmin.google/standby-catch-up-timeout-in-minutes no DBCluster.
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:

  1. Inspecione o status do recurso personalizado de troca para determinar a causa raiz:
    kubectl get switchovers.alloydbomni.dbadmin.goog -n NAMESPACE
  2. Verifique os registros e eventos do controlador de alternância para identificar problemas como partições de rede ou latência de API.
  3. Escolha uma opção em Corrigir instâncias primárias e em espera com versões secundárias diferentes.
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:

  1. Diagnostique a falha de upgrade examinando os registros e eventos do pod em espera:
    kubectl describe pod -l alloydbomni.dbadmin.goog/instance=[standby-name] -n NAMESPACE
  2. Depois que o bloqueador, por exemplo, o esgotamento de recursos do nó ou os taints, for resolvido, escolha uma opção em Corrigir instâncias primárias e em espera com versões secundárias diferentes.
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:

  1. Exclua a instância em espera não íntegra definindo a contagem de instâncias em espera como 0 na especificação do DBCluster:
    kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE --type=merge -p '{"spec": {"availability": {"numberOfStandbys": 0}}}'
  2. Aguarde até que a instância em espera corrompida e o pod dela sejam totalmente excluídos.
  3. Aumente a contagem de instâncias em espera para provisionar uma instância em espera limpa que será sincronizada automaticamente com a instância principal ativa:
    kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE --type=merge -p '{"spec": {"availability": {"numberOfStandbys": 1}}}'

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-time do 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_NAME pelo 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 UpgradeFailed e retornar a um estado estável, sem upgrade, atualize os campos databaseVersion e controlPlaneAgentsVersion do 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_NAME pelo nome do cluster de banco de dados secundário.