Per una panoramica concettuale della replica tra data center, consulta Informazioni sulla replica tra data center.
Prima di iniziare
- Installa AlloyDB Omni operator versione 1.1.0 o successive per eseguire il deployment di AlloyDB Omni su un cluster Kubernetes nel data center principale e su un cluster Kubernetes nel data center secondario.
- Crea un cluster di database AlloyDB Omni sul cluster Kubernetes nel data center principale.
Crea un cluster di database secondario
Per creare un cluster di database secondario AlloyDB Omni e abilitare la replica dal cluster di database primario, segui questi passaggi:
Kubernetes
Assicurati che la connettività esterna sia abilitata sul cluster di database primario AlloyDB Omni. Se la connettività esterna non è abilitata, aggiungi quanto segue alla sezione spec del manifest del cluster di database:
kind: DBCluster spec: allowExternalIncomingTraffic: truePer utilizzare la replica tra data center con un cluster di database primario con HA abilitata, assicurati che i server di database primario e in standby nel cluster di database primario dispongano di spazio adeguato per il Write-Ahead Logging (WAL) in grado di contenere i file WAL richiesti per la replica nel cluster secondario. Imposta la dimensione del WAL per il cluster di database primario di AlloyDB Omni impostando la sezione spec del manifest del cluster di database:
kind: DBCluster spec: primarySpec: parameters: wal_keep_size: WAL_KEEP_SIZE max_wal_size: MAX_WAL_SIZESostituisci quanto segue:
WAL_KEEP_SIZE: la dimensione minima dei file WAL precedenti archiviati nella directory WAL nel caso in cui un server secondario debba recuperarli per la replica in streaming. Se un server secondario connesso al server principale rimane indietro di oltrewal_keep_sizemegabyte, il server principale potrebbe rimuovere un segmento WAL necessario al server secondario. In questo caso, la connessione di replica viene interrotta. Di conseguenza, anche le connessioni downstream alla fine non andranno a buon fine. ImpostaWAL_KEEP_SIZEsu un valore che supporti i requisiti del tuo workload, in base alla frequenza di generazione del WAL, alle caratteristiche della rete di replica e al ritardo di replica tra i data center in cui viene eseguito il deployment dei cluster di database primari e secondari. Il valore predefinito è 100 MB.MAX_WAL_SIZE: la dimensione massima consentita per la crescita del WAL durante i checkpoint automatici del database. Il valore predefinito è 1504 MB. Questo valore deve essere impostato su un valore superiore awal_keep_size.
Per abilitare la replica sul cluster di database primario, applica un manifest simile al seguente al cluster Kubernetes nel data center primario:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME spec: dbcluster: name: DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-DB_CLUSTER_NAMESostituisci quanto segue:
DB_CLUSTER_NAME: il nome del cluster di database, ad esempiodbc-1.ENCODED_PASSWORD: la password dell'utente del database da utilizzare per la replica dai database secondari, codificata come stringa base64, ad esempioQ2hhbmdlTWUxMjM= for ChangeMe123. Il valore predefinito èalloydbreplica.REPLICATION_NAME: il nome della replica, ad esempioreplication-1.
Attendi che lo stato della replica sia pronto.
Per ottenere le informazioni sulla connessione upstream utilizzate per configurare la replica sul cluster di database secondario, esegui questo comando:
kubectl get replication REPLICATION_NAMEkubectl get replication REPLICATION_NAME -o json | jq .status.upstreamL'output di esempio è simile al seguente:
{ "host": "35.230.32.36", "password": { "name": "ha-rep-pw-dbc-1" }, "port": 5432, "replicationSlotName": "dbc_1_replication_1", "username": "alloydbreplica" } ```Prendi nota dell'output, poiché ti servirà per abilitare la replica sul cluster di database secondario nel passaggio successivo.
Crea un cluster AlloyDB Omni sul tuo cluster Kubernetes nel data center secondario utilizzando una configurazione identica a quella del cluster del database primario.
Assicurati che la connettività esterna sia abilitata sul cluster di database secondario AlloyDB Omni.
Se la connettività esterna non è abilitata, aggiungi quanto segue alla sezione spec del manifest:
allowExternalIncomingTraffic: truePer abilitare la replica sul cluster di database secondario, applica un manifest simile al seguente al cluster Kubernetes nel data center secondario:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME downstream: host: PRIMARY_HOST port: PRIMARY_PORT username: alloydbreplica password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME replicationSlotName: PRIMARY_REPLICATION_SLOT control: setupSostituisci quanto segue:
SECONDARY_DB_CLUSTER_NAME: il nome del cluster di database secondario, ad esempiodbc-2.ENCODED_PASSWORD: la password dell'utente del database da utilizzare per la replica del cluster di database primario, codificata come stringa base64, ad esempioQ2hhbmdlTWUxMjM= for ChangeMe123. Il valore predefinito èalloydbreplica.SECONDARY_REPLICATION_NAME: il nome della replica, ad esempioreplication-2.PRIMARY_HOST: l'endpoint di connessione del cluster del database primario dall'output del passaggio 3 a cui il database secondario può accedere per la replica.PRIMARY_PORT: la porta di connessione del cluster di database primario dall'output del passaggio 3 a cui il database secondario può accedere per la replica.PRIMARY_REPLICATION_SLOT: il nome dello slot di replica nel cluster di database primario dall'output del passaggio 3 che il database secondario può utilizzare per la replica.
Visualizza la replica nel cluster di database secondario
Per visualizzare informazioni dettagliate su un cluster di database secondario AlloyDB Omni e sul relativo stato di replica, esegui questi comandi:
Kubernetes
kubectl get dbcluster SECONDARY_DB_CLUSTER_NAMEkubectl get replication SECONDARY_REPLICATION_NAME
Quando il cluster di database secondario è configurato correttamente e ha la replica in modalità flusso dal cluster di database primario, lo stato della replica è pronto e integro.
Promuovi un cluster di database secondario
Prima di promuovere un cluster di database secondario, segui questi passaggi per verificare che abbia applicato tutte le transazioni ricevute dal cluster di database primario:
Kubernetes
Controlla lo stato della replica del cluster di database secondario per assicurarti che sia pronto e integro.
kubectl get replication SECONDARY_REPLICATION_NAMEInterrompi tutte le scritture nel cluster di database primario. Esegui la seguente query sul cluster di database primario per controllare il ritardo di replica del database secondario. Verifica che il risultato mostri un ritardo minimo.
Un valore di ritardo pari a 0 è l'ideale. Se il ritardo è maggiore di 0, puoi comunque promuovere il cluster di database secondario, con il rischio di perdere alcune transazioni recenti già sottoposte a commit nel cluster di database primario.
psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
Per promuovere un cluster di database secondario a cluster di database primario, aggiorna il campo control del manifest di replica del cluster di database secondario a promote e applicalo al cluster Kubernetes nel data center secondario.
Kubernetes
apiVersion: v1
kind: Secret
metadata:
name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
type: Opaque
data:
rep-user-pw: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: Replication
metadata:
name: SECONDARY_REPLICATION_NAME
spec:
dbcluster:
name: SECONDARY_DB_CLUSTER_NAME
downstream:
host: PRIMARY_HOST
port: PRIMARY_PORT
username: alloydbreplica
password:
name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
replicationSlotName: PRIMARY_REPLICATION_SLOT
control: promote
Esegui un cambio
Prima di eseguire un cambio, verifica che i cluster di database primari e secondari appartenenti a entrambi i data center siano online e che i cluster di database siano in stato integro.
Per garantire la coerenza dei dati dei cluster di database primario e secondario durante il cambio, segui questi passaggi per verificare che il cluster di database secondario abbia applicato tutte le transazioni ricevute dal cluster di database primario:
Kubernetes
Controlla lo stato della replica del cluster di database secondario per assicurarti che sia pronto e integro.
kubectl get replication SECONDARY_REPLICATION_NAMEInterrompi tutte le scritture nel cluster di database primario. Esegui la seguente query sul cluster di database primario per controllare il ritardo di replica del database secondario. Verifica che il risultato mostri un valore di ritardo pari a
0.psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
Per eseguire uno switchover, completa i seguenti passaggi:
Kubernetes
Per convertire il cluster di database secondario di AlloyDB Omni in un cluster di database primario, aggiorna il manifest di replica nel cluster Kubernetes nel data center secondario come segue:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAMEAttendi che lo stato della replica sia pronto.
Per ottenere le informazioni sulla connessione upstream per la replica, esegui questo comando:
kubectl get replication SECONDARY_REPLICATION_NAMEkubectl get replication SECONDARY_REPLICATION_NAME -o json | jq .status.upstreamL'output di esempio è simile al seguente:
{ "host": "34.23.207.137", "password": { "name": "ha-rep-pw-dbc-2" }, "port": 5432, "replicationSlotName": "dbc_2_replication_2", "username": "alloydbreplica" }Per convertire il cluster di database primario di AlloyDB Omni in un cluster di database secondario, aggiorna il manifest di replica nel cluster Kubernetes nel data center principale in modo simile al seguente:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME spec: dbcluster: name: DB_CLUSTER_NAME downstream: host: SECONDARY_HOST port: SECONDARY_PORT username: alloydbreplica password: name: ha-rep-pw-DB_CLUSTER_NAME replicationSlotName: SECONDARY_REPLICATION_SLOT control: rewindAttendi che lo stato della replica diventi pronto e integro.
Per verificare lo stato della replica, utilizza:
kubectl get replication REPLICATION_NAME