Questa pagina descrive come eseguire l'upgrade della versione secondaria del database per AlloyDB Omni su Kubernetes.
Per eseguire l'upgrade di una versione secondaria del database, sono disponibili due opzioni:
- Upgrade con tempi di inattività ridotti (LDTM): in ambienti ad alta affidabilità (HA), l'operatore AlloyDB Omni esegue prima l'upgrade delle istanze in standby. Una volta eseguito l'upgrade di tutte le istanze in standby, l'operatore esegue un cambio, promuovendo una delle istanze in standby di cui è stato eseguito l'upgrade come nuova istanza principale. Una volta completato lo switchover, viene eseguito l'upgrade della vecchia istanza principale. Questo processo di aggiornamento graduale sequenziale riduce al minimo i tempi di inattività e mantiene l'ambiente principale attivo sulla versione precedente fino alla convalida completa dell'upgrade dell'ambiente di standby.
- Upgrade simultaneo: negli ambienti non ad alta affidabilità o se LDTM è disabilitato esplicitamente, l'operatore AlloyDB Omni esegue l'upgrade di tutte le istanze di database contemporaneamente. Questo metodo causa un downtime del database durante il processo di upgrade.
Limitazioni
Durante il processo di upgrade con tempi di inattività ridotti, ogni istanza in standby viene sottoposta ad upgrade in sequenza e non è disponibile temporaneamente durante l'upgrade.
Per garantire che il cluster di database mantenga un Recovery Point Objective (RPO) pari a zero e non rischi la perdita di dati durante l'upgrade in standby, è consigliabile avere almeno due istanze in standby. Questa configurazione funge da configurazione ad alta affidabilità a tre nodi.
Gli upgrade con tempi di inattività ridotti non sono supportati sui cluster di database secondari in una configurazione di replica tra data center. Prima di eseguire l'upgrade di un cluster di database secondario con standby HA, disattiva esplicitamente LDTM impostando dbcluster.dbadmin.goog/enableLDTM=false.
Prima di iniziare
- Se il tuo cluster è ad alta affidabilità e la versione di AlloyDB Omni è precedente alla 15.7.1, segui i passaggi elencati in Aggiorna i cluster di database prima di seguire questa procedura di upgrade della versione secondaria.
- Per evitare la perdita di dati, esegui il backup dei dati.
- Mentre l'operazione di upgrade con tempi di inattività ridotti è in corso, la ridondanza HA del cluster di database viene temporaneamente ridotta mentre un'istanza in standby viene sottoposta all'upgrade. Tuttavia, il database rimane disponibile per il traffico di lettura e scrittura sull'istanza principale attiva.
Abilita il processo di upgrade della versione secondaria del database con tempi di inattività ridotti
Il processo di upgrade con tempi di inattività ridotti (LDTM) è abilitato automaticamente per impostazione predefinita se il cluster di database ha due o più standby.
Se il cluster di database ha un solo standby, devi attivare manualmente LDTM aggiungendo l'annotazione dbcluster.dbadmin.goog/enableLDTM=true al cluster di database:
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=true
Sostituisci la seguente variabile:
DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database che hai fornito al momento della creazione. Per saperne di più, consulta Installa AlloyDB Omni su Kubernetes.
Esegui l'upgrade della versione di AlloyDB Omni
Per eseguire l'upgrade della versione 18.4.0, aggiorna i campi databaseVersion e controlPlaneAgentsVersion nel file manifest del cluster, quindi applica nuovamente il file.
Di seguito è riportato l'inizio di un file manifest che specifica la versione
18.4.0 per databaseVersion e la versione
1.9.0 per 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"
...
Sostituisci la seguente variabile:
DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database che hai fornito al momento della creazione. Per saperne di più, consulta Installa AlloyDB Omni su Kubernetes.DB_VERSION: la versione del database di cui stai eseguendo l'upgrade.CONTROL_PLANE_AGENTS_VERSION: la versione degli agenti del control plane.OS_TYPE: (Facoltativo) Il sistema operativo di base per l'immagine del database. I valori validi sonoDebianeUBI9. Se non specifichi questo valore, l'operatore lo imposta automaticamente suDebiansedatabaseVersionè inferiore a16.9.0e suUBI9sedatabaseVersionè16.9.0o versioni successive.
Monitora il processo di upgrade
Dopo aver aggiornato il file manifest, l'operatore AlloyDB Omni avvia
il processo di upgrade. Per monitorare il processo di upgrade, controlla la condizione DBCUpgradeInProgress.
kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -o yaml | yq '.status.conditions[] | select(.type == "DBCUpgradeInProgress")'
Sostituisci la seguente variabile:
DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database che hai fornito al momento della creazione. Per saperne di più, consulta Installa AlloyDB Omni su Kubernetes.
Durante il processo, lo stato della condizione è true. Al termine del processo, lo stato della condizione diventa false e il motivo viene aggiornato a UpgradeComplete o UpgradeFailed.
Risoluzione dei problemi
Se ricevi messaggi di errore durante il processo di upgrade, consulta le seguenti sezioni:
Errori precedenti all'upgrade
Se ricevi un errore di pre-upgrade sul cluster di database, controlla il messaggio e risolvi il problema di conseguenza.
Se vuoi ignorare il messaggio di errore pre-upgrade, puoi attivare l'annotazione force-upgrade.
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/force-upgrade=true
Sostituisci la seguente variabile:
DB_CLUSTER_NAME: il nome del cluster di database. Si tratta dello stesso nome del cluster di database che hai fornito al momento della creazione. Per saperne di più, consulta Installa AlloyDB Omni su Kubernetes.
Al termine del processo di upgrade, imposta l'annotazione force-upgrade su
false.
Errori di upgrade
Durante il processo di upgrade automatico, esistono diversi punti in cui potrebbe verificarsi un errore negli ambienti ad alta affidabilità. Per saperne di più su ogni scenario di errore e sulle azioni successive intraprese dall'operatore AlloyDB Omni, consulta la tabella seguente.
| Messaggio di errore | Descrizione | Azioni utente richieste |
|---|---|---|
Standby instance upgrade succeeded but its replication lag is too high to be promoted to a synchronous standby. Please monitor replication status.
|
L'upgrade dell'istanza in standby è stato eseguito correttamente, ma non è stato possibile raggiungere l'istanza principale abbastanza velocemente da soddisfare la soglia di replica sincrona prima della finestra di timeout. In genere, questo problema è causato da un traffico di scrittura intenso sull'istanza principale. |
Per consentire la sincronizzazione dell'istanza in standby, segui questi passaggi:
|
All standbys upgrade succeeded but the switchover instance failed to promote an upgraded standby.
|
L'upgrade delle istanze in standby è stato eseguito correttamente, ma il processo di failover automatico progettato per promuovere un'istanza in standby di cui è stato eseguito l'upgrade a istanza principale non è riuscito. |
Per esaminare e risolvere l'errore di switchover, segui questi passaggi:
|
Standby instance upgrade failed but rollback to the previous versions succeeded
|
L'upgrade dell'istanza in standby non è riuscito, ma l'operatore AlloyDB Omni ha eseguito correttamente il rollback dell'istanza alla versione funzionante precedente. Poiché l'istanza principale non è mai stata toccata, il database rimane integro nella versione precedente. |
Per diagnosticare il problema di fondo e applicare una correzione, segui questi passaggi:
|
Standby instance upgrade failed and rollback to the previous versions failed
|
L'upgrade dell'istanza in standby non è riuscito e anche il tentativo automatico dell'operatore AlloyDB Omni di eseguire il rollback alla versione precedente non è riuscito. L'istanza in standby viene lasciata in uno stato non integro/inutilizzabile (riducendo la ridondanza HA), mentre l'istanza principale continua a gestire il traffico di lettura/scrittura sulla versione precedente. |
Per ripristinare l'integrità del cluster, esegui nuovamente il provisioning dello standby come segue:
|
Correggi le istanze principali e in standby con versioni secondarie diverse
Per risolvere il problema, scegli una delle seguenti opzioni:
Se il problema di fondo che ha causato l'errore di upgrade è stato risolto, puoi riavviare l'upgrade. Rimuovi l'annotazione
start-timedell'upgrade dal DBCluster per chiedere all'operatore AlloyDB Omni di generare una nuova ora di inizio e riprovare:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/start-time-
Sostituisci
DB_CLUSTER_NAMEcon il nome del cluster di database. Si tratta dello stesso nome del cluster di database che hai fornito al momento della creazione. Per saperne di più, consulta Installa AlloyDB Omni su Kubernetes.Se il problema che ha causato l'errore di upgrade persiste e preferisci mantenere il cluster nella versione precedente, non è necessario eseguire una procedura di downgrade. Poiché l'upgrade non è riuscito durante la fase di standby, l'upgrade dell'istanza principale non è mai stato eseguito.
Per cancellare lo stato
UpgradeFailede tornare a uno stato stabile, senza upgrade, aggiorna i campidatabaseVersionecontrolPlaneAgentsVersiondel manifest DBCluster alle versioni utilizzate prima del tentativo di upgrade, quindi applica nuovamente il file.Se l'upgrade o il downgrade si blocca in
DBCUpgradeInProgress=True(DBCUpgradeFlowBegins) dopo i primi upgrade in standby su un cluster di database secondario di replica tra data center, verifica se l'upgrade con tempi di inattività ridotti è abilitato (dbcluster.dbadmin.goog/enableLDTM=true) sul cluster di database secondario. Disabilita LDTM sul cluster di database secondario in modo che l'operatore AlloyDB Omni completi l'upgrade o il downgrade utilizzando il percorso di upgrade simultaneo:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=false
Sostituisci
DB_CLUSTER_NAMEcon il nome del cluster di database secondario.