PostgreSQL è un database relazionale a oggetti open source noto per la sua affidabilità e integrità dei dati. È conforme ad ACID e supporta chiavi esterne, join, viste, trigger e stored procedure.
Questo documento è destinato ad amministratori di database, architetti cloud e professionisti delle operazioni interessati al deployment di una topologia PostgreSQL a disponibilità elevata su Google Kubernetes Engine (GKE).
Obiettivi
In questo tutorial imparerai a:- Utilizza Terraform per creare un cluster GKE regionale.
- Esegui il deployment di un database PostgreSQL a disponibilità elevata.
- Configura il monitoraggio per l'applicazione PostgreSQL.
- Esegui gli upgrade del database PostgreSQL e del cluster GKE.
- Simula l'interruzione del cluster e il failover della replica PostgreSQL.
- Esegui il backup e il ripristino del database PostgreSQL.
Architettura
Questa sezione descrive l'architettura della soluzione che creerai in questo tutorial.
Provisionerete due cluster GKE in regioni diverse: un cluster primario e un cluster di backup. Per questo tutorial, il cluster primario si trova nella regione us-central1
e il cluster di backup si trova nella regione us-west1
. Questa
architettura consente di eseguire il provisioning di un database PostgreSQL a disponibilità elevata e
testare il ripristino di emergenza, come descritto più avanti in questo tutorial.
Per il cluster di origine, utilizzerai un grafico Helm
(bitnami/postgresql-ha
) per
configurare un cluster PostgreSQL ad alta disponibilità.
Costi
In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il calcolatore prezzi.
Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per ulteriori informazioni, vedi Pulizia.
Prima di iniziare
Configura il progetto
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine, Backup for GKE, Artifact Registry, Compute Engine, and IAM APIs.
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine, Backup for GKE, Artifact Registry, Compute Engine, and IAM APIs.
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/storage.objectViewer, roles/logging.logWriter, roles/artifactregistry.Admin, roles/container.clusterAdmin, roles/container.serviceAgent, roles/serviceusage.serviceUsageAdmin, roles/iam.serviceAccountAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
Avvia una sessione di Cloud Shell dalla console Google Cloud facendo clic su
Attiva Cloud Shell nella Google Cloud console. Viene avviata una sessione nel riquadro inferiore della console Google Cloud .
Imposta le variabili di ambiente.
export PROJECT_ID=PROJECT_ID export SOURCE_CLUSTER=cluster-db1 export REGION=us-central1
Sostituisci i seguenti valori:
- PROJECT_ID: il tuo Google Cloud ID progetto.
Imposta le variabili di ambiente predefinite.
gcloud config set project PROJECT_ID
Clona il repository di codice.
git clone https://github.com/GoogleCloudPlatform/kubernetes-engine-samples
Passa alla directory di lavoro.
cd kubernetes-engine-samples/databases/gke-stateful-postgres
Configurare i ruoli
Configura l'ambiente
In questo tutorial utilizzerai Cloud Shell per gestire le risorse ospitate su
Google Cloud. Cloud Shell è preinstallato con il software necessario
per questo tutorial, tra cui Docker, kubectl
, gcloud CLI, Helm
e Terraform.
Per utilizzare Cloud Shell per configurare l'ambiente:
Crea l'infrastruttura del cluster
In questa sezione, eseguirai uno script Terraform per creare un VPC (Virtual Private Cloud) personalizzato, un repository Artifact Registry per archiviare le immagini PostgreSQL e due cluster GKE regionali.
Un cluster verrà implementato in us-central1
e il secondo cluster per il backup
verrà implementato in us-west1
.
Per creare il cluster:
Autopilot
In Cloud Shell, esegui questi comandi:
terraform -chdir=terraform/gke-autopilot init
terraform -chdir=terraform/gke-autopilot apply -var project_id=$PROJECT_ID
Quando richiesto, digita yes
.
Informazioni sulla configurazione Terraform
I file di configurazione Terraform creano le seguenti risorse per eseguire il deployment dell'infrastruttura:
- Crea un repository Artifact Registry per archiviare le immagini Docker.
- Crea la rete VPC e la subnet per l'interfaccia di rete della VM.
Crea un cluster GKE principale.
Terraform crea un cluster privato nella regione
us-central1
e abilita Backup per GKE per il ripristino di emergenza e Managed Service per Prometheus per il monitoraggio del cluster.Managed Service per Prometheus è supportato solo sui cluster Autopilot che eseguono GKE versione 1.25 o successive.
Crea un cluster di backup nella regione
us-west1
per il ripristino di emergenza.
Standard
In Cloud Shell, esegui questi comandi:
terraform -chdir=terraform/gke-standard init
terraform -chdir=terraform/gke-standard apply -var project_id=$PROJECT_ID
Quando richiesto, digita yes
.
Informazioni sulla configurazione Terraform
I file di configurazione Terraform creano le seguenti risorse per il deployment dell'infrastruttura:
- Crea un repository Artifact Registry per archiviare le immagini Docker.
- Crea la rete VPC e la subnet per l'interfaccia di rete della VM.
Crea un cluster GKE principale.
Terraform crea un cluster privato nella regione
us-central1
e abilita Backup per GKE per il ripristino di emergenza e Managed Service per Prometheus per il monitoraggio del cluster.Crea un cluster di backup nella regione
us-west1
per il ripristino di emergenza.
Esegui il deployment di PostgreSQL sul cluster
In questa sezione, eseguirai il deployment di un'istanza di database PostgreSQL da eseguire su GKE utilizzando un grafico Helm.
Installa PostgreSQL
Per installare PostgreSQL sul cluster:
Configura l'accesso a Docker.
gcloud auth configure-docker us-docker.pkg.dev
Popola Artifact Registry con le immagini Docker PostgreSQL richieste.
./scripts/gcr.sh bitnami/postgresql-repmgr 15.1.0-debian-11-r0 ./scripts/gcr.sh bitnami/postgres-exporter 0.11.1-debian-11-r27 ./scripts/gcr.sh bitnami/pgpool 4.3.3-debian-11-r28
Lo script esegue il push delle seguenti immagini Bitnami in Artifact Registry per l'installazione di Helm:
postgresql-repmgr
: Questa soluzione di cluster PostgreSQL include PostgreSQL Replication Manager (repmgr), uno strumento open source per la gestione della replica e del failover nei cluster PostgreSQL.postgres-exporter
: PostgreSQL Exporter raccoglie le metriche PostgreSQL per l'utilizzo di Prometheus.pgpool
: Pgpool-II è il proxy PostgreSQL. Fornisce il pool di connessioni e il bilanciamento del carico.
Verifica che nel repository siano memorizzate le immagini corrette.
gcloud artifacts docker images list us-docker.pkg.dev/$PROJECT_ID/main \ --format="flattened(package)"
L'output è simile al seguente:
--- image: us-docker.pkg.dev/[PROJECT_ID]/main/bitnami/pgpool --- image: us-docker.pkg.dev/[PROJECT_ID]/main/bitnami/postgres-exporter --- image: us-docker.pkg.dev/h[PROJECT_ID]/main/bitnami/postgresql-repmgr
Configura l'accesso alla riga di comando
kubectl
al cluster primario.gcloud container clusters get-credentials $SOURCE_CLUSTER \ --region=$REGION --project=$PROJECT_ID
Crea uno spazio dei nomi.
export NAMESPACE=postgresql kubectl create namespace $NAMESPACE
Se esegui il deployment in un cluster Autopilot, configura il provisioning dei nodi in tre zone. Puoi saltare questo passaggio se esegui il deployment in un cluster Standard.
Per impostazione predefinita, Autopilot esegue il provisioning delle risorse solo in due zone. Il deployment definito in
prepareforha.yaml
garantisce che Autopilot esegua il provisioning dei nodi in tre zone del tuo cluster impostando questi valori:replicas:3
podAntiAffinity
conrequiredDuringSchedulingIgnoredDuringExecution
etopologyKey: "topology.kubernetes.io/zone"
kubectl -n $NAMESPACE apply -f scripts/prepareforha.yaml
Aggiorna la dipendenza Helm.
cd helm/postgresql-bootstrap helm dependency update
Ispeziona e verifica i grafici che Helm installerà.
helm -n postgresql template postgresql . \ --set global.imageRegistry="us-docker.pkg.dev/$PROJECT_ID/main"
Installa il grafico Helm.
helm -n postgresql upgrade --install postgresql . \ --set global.imageRegistry="us-docker.pkg.dev/$PROJECT_ID/main"
L'output è simile al seguente:
NAMESPACE: postgresql STATUS: deployed REVISION: 1 TEST SUITE: None
Verifica che le repliche PostgreSQL siano in esecuzione.
kubectl get all -n $NAMESPACE
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE pod/postgresql-postgresql-bootstrap-pgpool-75664444cb-dkl24 1/1 Running 0 8m39s pod/postgresql-postgresql-ha-pgpool-6d86bf9b58-ff2bg 1/1 Running 0 8m39s pod/postgresql-postgresql-ha-postgresql-0 2/2 Running 0 8m39s pod/postgresql-postgresql-ha-postgresql-1 2/2 Running 0 8m39s pod/postgresql-postgresql-ha-postgresql-2 2/2 Running 0 8m38s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/postgresql-postgresql-ha-pgpool ClusterIP 192.168.99.236 <none> 5432/TCP 8m39s service/postgresql-postgresql-ha-postgresql ClusterIP 192.168.90.20 <none> 5432/TCP 8m39s service/postgresql-postgresql-ha-postgresql-headless ClusterIP None <none> 5432/TCP 8m39s service/postgresql-postgresql-ha-postgresql-metrics ClusterIP 192.168.127.198 <none> 9187/TCP 8m39s NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/postgresql-postgresql-bootstrap-pgpool 1/1 1 1 8m39s deployment.apps/postgresql-postgresql-ha-pgpool 1/1 1 1 8m39s NAME DESIRED CURRENT READY AGE replicaset.apps/postgresql-postgresql-bootstrap-pgpool-75664444cb 1 1 1 8m39s replicaset.apps/postgresql-postgresql-ha-pgpool-6d86bf9b58 1 1 1 8m39s NAME READY AGE statefulset.apps/postgresql-postgresql-ha-postgresql 3/3 8m39s
Creare un set di dati di test
In questa sezione creerai un database e una tabella con valori di esempio. Il database funge da set di dati di test per la procedura di failover che testerai più avanti in questo tutorial.
Connetterti all'istanza PostgreSQL.
cd ../../ ./scripts/launch-client.sh
L'output è simile al seguente:
Launching Pod pg-client in the namespace postgresql ... pod/pg-client created waiting for the Pod to be ready Copying script files to the target Pod pg-client ... Pod: pg-client is healthy
Avvia una sessione shell.
kubectl exec -it pg-client -n postgresql -- /bin/bash
Crea un database e una tabella, quindi inserisci alcune righe di test.
psql -h $HOST_PGPOOL -U postgres -a -q -f /tmp/scripts/generate-db.sql
Verifica il numero di righe per ogni tabella.
psql -h $HOST_PGPOOL -U postgres -a -q -f /tmp/scripts/count-rows.sql
L'output è simile al seguente:
select COUNT(*) from tb01; count -------- 300000 (1 row) select COUNT(*) from tb02; count -------- 300000 (1 row)
Genera dati di test.
export DB=postgres pgbench -i -h $HOST_PGPOOL -U postgres $DB -s 50
L'output è simile al seguente:
dropping old tables... creating tables... generating data (client-side)... 5000000 of 5000000 tuples (100%) done (elapsed 29.85 s, remaining 0.00 s) vacuuming... creating primary keys... done in 36.86 s (drop tables 0.00 s, create tables 0.01 s, client-side generate 31.10 s, vacuum 1.88 s, primary keys 3.86 s).
Esci dal pod client postgres.
exit
Monitorare PostgreSQL
In questa sezione visualizzerai le metriche e configurerai gli avvisi per l'istanza PostgreSQL. Utilizzerai Google Cloud Managed Service per Prometheus per eseguire il monitoraggio e la creazione di avvisi.
Visualizza metriche
Il deployment PostgreSQL include un container
sidecar postgresql-exporter
. Questo contenitore espone un endpoint /metrics
.
Google Cloud Managed Service per Prometheus è configurato per monitorare i pod PostgreSQL su questo endpoint. Puoi visualizzare queste metriche tramite le dashboard della console Google Cloud .
La console Google Cloud offre alcuni modi per creare e salvare la configurazione della dashboard:
- Creazione ed esportazione: puoi creare dashboard direttamente nella console Google Cloud , poi esportarle e archiviarle in un repository di codice. Per farlo, nella barra degli strumenti della dashboard, apri l'editor JSON e scarica il file JSON della dashboard.
- Archiviazione e importazione: puoi importare una dashboard da un file JSON facendo clic su +Crea dashboard e caricando i contenuti JSON della dashboard utilizzando il menu Editor JSON.
Per visualizzare i dati dell'applicazione PostgreSQL e del cluster GKE, segui questi passaggi:
Crea le seguenti dashboard.
cd monitoring gcloud monitoring dashboards create \ --config-from-file=dashboard/postgresql-overview.json \ --project=$PROJECT_ID gcloud monitoring dashboards create \ --config-from-file dashboard/gke-postgresql.json \ --project $PROJECT_ID
Nella console Google Cloud , vai alla dashboard di Cloud Monitoring. Vai alla dashboard di Cloud Monitoring
Seleziona Personalizzato dall'elenco dei dashboard. Vengono visualizzate le seguenti dashboard:
- Panoramica di PostgreSQL: mostra le metriche dell'applicazione PostgreSQL, tra cui uptime del database, dimensioni del database e latenza delle transazioni.
- Cluster GKE PostgreSQL: mostra le metriche del cluster GKE su cui è in esecuzione PostgreSQL, tra cui utilizzo della CPU, utilizzo della memoria e utilizzo del volume.
Fai clic su ogni link per esaminare le dashboard generate.
Configurazione degli avvisi
Gli avvisi ti consentono di rilevare tempestivamente i problemi nelle tue applicazioni, in modo da poterli risolvere rapidamente. Puoi creare un criterio di avviso per specificare le circostanze in cui vuoi ricevere un avviso e come vuoi ricevere le notifiche. Puoi anche creare canali di notifica che ti consentono di selezionare dove vengono inviati gli avvisi.
In questa sezione utilizzerai Terraform per configurare i seguenti avvisi di esempio:
db_max_transaction
: monitora il ritardo massimo delle transazioni in secondi; viene attivato un avviso se il valore è maggiore di 10.db_node_up
: monitora lo stato dei pod del database; 0 indica che un pod non è attivo e attiva un avviso.
Per configurare gli avvisi:
Configura gli avvisi con Terraform.
EMAIL=YOUR_EMAIL cd alerting/terraform terraform init terraform plan -var project_id=$PROJECT_ID -var email_address=$EMAIL terraform apply -var project_id=$PROJECT_ID -var email_address=$EMAIL
Sostituisci i seguenti valori:
- YOUR_EMAIL: il tuo indirizzo email.
L'output è simile al seguente :
Apply complete! Resources: 3 added, 0 changed, 0 destroyed.
Connettiti al pod client.
cd ../../../ kubectl exec -it --namespace postgresql pg-client -- /bin/bash
Genera un test di carico per testare l'avviso
db_max_transaction
.pgbench -i -h $HOST_PGPOOL -U postgres -s 200 postgres
L'output è simile al seguente:
dropping old tables... creating tables... generating data (client-side)... 20000000 of 20000000 tuples (100%) done (elapsed 163.22 s, remaining 0.00 s) vacuuming... creating primary keys... done in 191.30 s (drop tables 0.14 s, create tables 0.01 s, client-side generate 165.62 s, vacuum 4.52 s, primary keys 21.00 s).
L'avviso viene attivato e invia un'email a YOUR_EMAIL con un oggetto che inizia con "[AVVISO] Ritardo massimo della transazione".
Nella console Google Cloud , vai alla pagina Policy di avviso.
Seleziona
db_max_transaction
dai criteri elencati. Dal grafico dovresti vedere un picco del test di carico che supera la soglia di 10 per la metrica Prometheuspg_stat_activity_max_tx_duration/gauge
.Esci dal pod client postgres.
exit
Gestire gli upgrade di PostgreSQL e GKE
Gli aggiornamenti delle versioni di PostgreSQL e Kubernetes vengono rilasciati regolarmente. Segui le best practice operative per aggiornare regolarmente l'ambiente software. Per impostazione predefinita, GKE gestisce gli upgrade del cluster e del pool di nodi.
Upgrade di PostgreSQL
Questa sezione mostra come eseguire l'upgrade della versione di PostgreSQL. Per questo tutorial, utilizzerai una strategia di aggiornamento in sequenza per l'upgrade dei pod, in modo che in nessun momento tutti i pod siano inattivi.
Per eseguire l'upgrade di una versione:
Esegui il push di una versione aggiornata dell'immagine
postgresql-repmgr
in Artifact Registry. Definisci la nuova versione (ad esempio,postgresql-repmgr 15.1.0-debian-11-r1
).NEW_IMAGE=us-docker.pkg.dev/$PROJECT_ID/main/bitnami/postgresql-repmgr:15.1.0-debian-11-r1 ./scripts/gcr.sh bitnami/postgresql-repmgr 15.1.0-debian-11-r1
Attiva un aggiornamento in sequenza utilizzando
kubectl
.kubectl set image statefulset -n postgresql postgresql-postgresql-ha-postgresql postgresql=$NEW_IMAGE kubectl rollout restart statefulsets -n postgresql postgresql-postgresql-ha-postgresql kubectl rollout status statefulset -n postgresql postgresql-postgresql-ha-postgresql
Vedrai lo StatefulSet completare un aggiornamento in sequenza, a partire dalla replica con numero ordinale più alto fino a quella con numero ordinale più basso.
L'output è simile al seguente:
Waiting for 1 pods to be ready... waiting for statefulset rolling update to complete 1 pods at revision postgresql-postgresql-ha-postgresql-5c566ccf49... Waiting for 1 pods to be ready... Waiting for 1 pods to be ready... waiting for statefulset rolling update to complete 2 pods at revision postgresql-postgresql-ha-postgresql-5c566ccf49... Waiting for 1 pods to be ready... Waiting for 1 pods to be ready... statefulset rolling update complete 3 pods at revision postgresql-postgresql-ha-postgresql-5c566ccf49...
Pianifica gli upgrade di GKE sui cluster Standard
Questa sezione è applicabile se esegui cluster Standard. Puoi adottare misure proattive e impostare configurazioni per ridurre i rischi e facilitare un upgrade del cluster più fluido quando esegui servizi stateful, tra cui:
Segui le best practice di GKE per l'upgrade dei cluster. Scegli una strategia di upgrade appropriata per assicurarti che gli upgrade vengano eseguiti durante il periodo di manutenzione:
- Scegli upgrade improvvisi se l'ottimizzazione dei costi è importante e se i tuoi workload possono tollerare un arresto controllato in meno di 60 minuti.
- Scegli gli upgrade blu/verde se i tuoi workload sono meno tolleranti alle interruzioni e un aumento temporaneo dei costi dovuto a un maggiore utilizzo delle risorse è accettabile.
Per saperne di più, consulta Eseguire l'upgrade di un cluster che esegue un carico di lavoro stateful.
Utilizza il servizio Recommender per verificare insight e suggerimenti sul ritiro per evitare interruzioni del servizio.
Utilizza i periodi di manutenzione per assicurarti che gli upgrade vengano eseguiti quando vuoi. Prima della periodo di manutenzione, assicurati che i backup del database siano riusciti.
Prima di consentire il traffico ai nodi sottoposti ad upgrade, utilizza i probe di idoneità e attività per assicurarti che siano pronti per il traffico.
Crea probe che valutino se la replica è sincronizzata prima di accettare il traffico. Questa operazione può essere eseguita tramite script personalizzati, a seconda della complessità e delle dimensioni del database.
Verificare la disponibilità del database durante gli upgrade dei cluster Standard
Questa sezione è applicabile se esegui cluster Standard. Per
verificare la disponibilità di PostgreSQL durante gli upgrade, la procedura generale consiste nel generare
traffico sul database PostgreSQL durante la
procedura di upgrade. Poi, utilizza pgbench
per verificare che il database possa gestire un livello di traffico di base durante un
upgrade, rispetto a quando il database è completamente disponibile.
Connetterti all'istanza PostgreSQL.
./scripts/launch-client.sh
L'output è simile al seguente:
Launching Pod pg-client in the namespace postgresql ... pod/pg-client created waiting for the Pod to be ready Copying script files to the target Pod pg-client ... Pod: pg-client is healthy
In Cloud Shell, accedi al pod client.
kubectl exec -it -n postgresql pg-client -- /bin/bash
Inizializza pgbench .
pgbench -i -h $HOST_PGPOOL -U postgres postgres
Utilizza il seguente comando per ottenere i risultati di base per verificare che la tua applicazione PostgreSQL rimanga a disponibilità elevata durante l'intervallo di tempo per un upgrade. Per ottenere un risultato di base, esegui il test con più connessioni tramite più job (thread) per 30 secondi.
pgbench -h $HOST_PGPOOL -U postgres postgres -c10 -j4 -T 30 -R 200
L'output è simile al seguente:
pgbench (14.5) starting vacuum...end. transaction type: <builtin: TPC-B (sort of)> scaling factor: 1 query mode: simple number of clients: 10 number of threads: 4 duration: 30 s number of transactions actually processed: 5980 latency average = 7.613 ms latency stddev = 2.898 ms rate limit schedule lag: avg 0.256 (max 36.613) ms initial connection time = 397.804 ms tps = 201.955497 (without initial connection time)
Per garantire la disponibilità durante gli upgrade, puoi generare un carico sul database e assicurarti che l'applicazione PostgreSQL fornisca una velocità di risposta coerente durante l'upgrade. Per eseguire questo test, genera un po' di traffico sul database utilizzando il comando
pgbench
. Il seguente comando eseguiràpgbench
per un'ora, con un target di 200 TPS (transazioni al secondo) ed elencando la tasso di richieste ogni 2 secondi.pgbench -h $HOST_PGPOOL -U postgres postgres --client=10 --jobs=4 --rate=200 --time=3600 --progress=2 --select-only
Dove:
--client
: numero di client simulati, ovvero numero di sessioni di database simultanee.--jobs
: numero di thread di lavoro all'interno di pgbench. L'utilizzo di più thread può essere utile su macchine con più CPU. I client vengono distribuiti nel modo più uniforme possibile tra i thread disponibili. Il valore predefinito è 1.--rate
: Il tasso è indicato in transazioni al secondo--progress
: mostra il report sullo stato di avanzamento ogni sec secondi.
L'output è simile al seguente:
pgbench (14.5) starting vacuum...end. progress: 5.0 s, 354.8 tps, lat 25.222 ms stddev 15.038 progress: 10.0 s, 393.8 tps, lat 25.396 ms stddev 16.459 progress: 15.0 s, 412.8 tps, lat 24.216 ms stddev 14.548 progress: 20.0 s, 405.0 tps, lat 24.656 ms stddev 14.066
Nella console Google Cloud , torna alla dashboard Panoramica di PostgreSQL in Cloud Monitoring. Nota il picco nei grafici Connessione per DB e Connessione per pod.
Esci dal pod client.
exit
Elimina il pod client.
kubectl delete pod -n postgresql pg-client
Simula un'interruzione del servizio PostgreSQL
In questa sezione simulerai un'interruzione del servizio in una delle repliche PostgreSQL arrestando il servizio di gestione della replica. In questo modo, il pod non gestirà il traffico verso le repliche peer e i probe di attività non andranno a buon fine.
Apri una nuova sessione Cloud Shell e configura l'accesso alla riga di comando
kubectl
al cluster primario.gcloud container clusters get-credentials $SOURCE_CLUSTER \ --region=$REGION --project=$PROJECT_ID
Visualizza gli eventi PostgreSQL emessi in Kubernetes.
kubectl get events -n postgresql --field-selector=involvedObject.name=postgresql-postgresql-ha-postgresql-0 --watch
Nella sessione precedente di Cloud Shell, simula un errore del servizio arrestando PostgreSQL
repmgr
.Collega la sessione al contenitore del database.
kubectl exec -it -n $NAMESPACE postgresql-postgresql-ha-postgresql-0 -c postgresql -- /bin/bash
Interrompi il servizio utilizzando
repmgr
e rimuovi il checkpoint e l'argomentodry-run
.export ENTRY='/opt/bitnami/scripts/postgresql-repmgr/entrypoint.sh' export RCONF='/opt/bitnami/repmgr/conf/repmgr.conf' $ENTRY repmgr -f $RCONF node service --action=stop --checkpoint
Il probe di attività configurato per il container PostgreSQL inizierà a non funzionare
entro cinque secondi. Questa operazione viene ripetuta ogni 10 secondi finché non viene raggiunto il limite di sei errori. Una volta raggiunto il valore di failureThreshold
, il
container viene riavviato. Puoi configurare questi parametri per diminuire la tolleranza del probe di attività e ottimizzare i requisiti SLO del deployment.
Nel flusso di eventi, vedrai che i probe di attività e di idoneità del pod non riescono e un messaggio che indica che il container deve essere riavviato. L'output è simile al seguente:
0s Normal Killing pod/postgresql-postgresql-ha-postgresql-0 Container postgresql failed liveness probe, will be restarted
0s Warning Unhealthy pod/postgresql-postgresql-ha-postgresql-0 Readiness probe failed: psql: error: connection to server at "127.0.0.1", port 5432 failed: Connection refused...
0s Normal Pulled pod/postgresql-postgresql-ha-postgresql-0 Container image "us-docker.pkg.dev/psch-gke-dev/main/bitnami/postgresql-repmgr:14.5.0-debian-11-r10" already present on machine
0s Normal Created pod/postgresql-postgresql-ha-postgresql-0 Created container postgresql
0s Normal Started pod/postgresql-postgresql-ha-postgresql-0 Started container postgresql
Prepararsi per il ripristino di emergenza
Per garantire che i carichi di lavoro di produzione rimangano disponibili in caso di interruzione del servizio, devi preparare un piano di ripristino di emergenza. Per scoprire di più sulla pianificazione del RE, consulta la Guida alla pianificazione del disaster recovery.
Il disaster recovery per Kubernetes può essere implementato in due fasi:
- Il backup prevede la creazione di uno snapshot point-in-time del tuo stato o dei tuoi dati prima che si verifichi un evento che interrompe il servizio.
- Il recupero prevede il ripristino dello stato o dei dati da una copia di backup dopo il verificarsi di un disastro.
Per eseguire il backup e il ripristino dei workload sui cluster GKE, puoi utilizzare Backup per GKE. Puoi abilitare questo servizio sui cluster nuovi ed esistenti. Viene eseguito il deployment di un agente Backup per GKE che viene eseguito nei cluster. L'agente è responsabile dell'acquisizione della configurazione e dei dati di backup dei volumi e dell'orchestrazione del ripristino.
I backup e i ripristini possono essere limitati a un intero cluster, a uno spazio dei nomi o a un'applicazione (definiti da selettori come matchLabels
).
Scenario di backup e ripristino PostgreSQL di esempio
L'esempio in questa sezione mostra come eseguire un'operazione di backup e ripristino
nell'ambito dell'applicazione, utilizzando la risorsa personalizzata ProtectedApplication
.
Il seguente diagramma mostra le risorse dei componenti in ProtectedApplication, ovvero un oggetto StatefulSet che rappresenta l'applicazione postgresql-ha
e un deployment di pgpool
, che utilizzano la stessa etichetta (app.kubernetes.io/name: postgresql-ha
).
Per prepararti a eseguire il backup e il ripristino del carico di lavoro PostgreSQL:
Configura le variabili di ambiente. In questo esempio utilizzerai un ProtectedApplication per ripristinare il workload PostgreSQL e i relativi volumi dal cluster GKE di origine (
us-central1
), quindi ripristinarli in un altro cluster GKE in una regione diversa (us-west1
).export SOURCE_CLUSTER=cluster-db1 export TARGET_CLUSTER=cluster-db2 export REGION=us-central1 export DR_REGION=us-west1 export NAME_PREFIX=g-db-protected-app export BACKUP_PLAN_NAME=$NAME_PREFIX-bkp-plan-01 export BACKUP_NAME=bkp-$BACKUP_PLAN_NAME export RESTORE_PLAN_NAME=$NAME_PREFIX-rest-plan-01 export RESTORE_NAME=rest-$RESTORE_PLAN_NAME
Verifica che Backup per GKE sia abilitato sui tuoi cluster. Dovrebbe essere già abilitata nell'ambito della configurazione Terraform eseguita in precedenza.
gcloud container clusters describe $SOURCE_CLUSTER \ --project=$PROJECT_ID \ --region=$REGION \ --format='value(addonsConfig.gkeBackupAgentConfig)'
Se Backup per GKE è abilitato, l'output del comando mostra
enabled=True
.
Configurare un piano di backup ed eseguire un ripristino
Backup per GKE consente di creare un piano di backup come cron job. Un piano di backup contiene una configurazione di backup che include il cluster di origine, la selezione dei carichi di lavoro di cui eseguire il backup e la regione in cui vengono archiviati gli artefatti di backup prodotti nell'ambito di questo piano.
Per eseguire un backup e un ripristino:
Verifica lo stato di ProtectedApplication su
cluster-db1
.kubectl get ProtectedApplication -A
L'output è simile al seguente:
NAMESPACE NAME READY TO BACKUP postgresql postgresql-ha true
Crea un piano di backup per ProtectedApplication.
export NAMESPACE=postgresql export PROTECTED_APP=$(kubectl get ProtectedApplication -n $NAMESPACE | grep -v 'NAME' | awk '{ print $1 }')
gcloud beta container backup-restore backup-plans create $BACKUP_PLAN_NAME \ --project=$PROJECT_ID \ --location=$DR_REGION \ --cluster=projects/$PROJECT_ID/locations/$REGION/clusters/$SOURCE_CLUSTER \ --selected-applications=$NAMESPACE/$PROTECTED_APP \ --include-secrets \ --include-volume-data \ --cron-schedule="0 3 * * *" \ --backup-retain-days=7 \ --backup-delete-lock-days=0
Crea manualmente un backup.
gcloud beta container backup-restore backups create $BACKUP_NAME \ --project=$PROJECT_ID \ --location=$DR_REGION \ --backup-plan=$BACKUP_PLAN_NAME \ --wait-for-completion
Configura un piano di ripristino.
gcloud beta container backup-restore restore-plans create $RESTORE_PLAN_NAME \ --project=$PROJECT_ID \ --location=$DR_REGION \ --backup-plan=projects/$PROJECT_ID/locations/$DR_REGION/backupPlans/$BACKUP_PLAN_NAME \ --cluster=projects/$PROJECT_ID/locations/$DR_REGION/clusters/$TARGET_CLUSTER \ --cluster-resource-conflict-policy=use-existing-version \ --namespaced-resource-restore-mode=delete-and-restore \ --volume-data-restore-policy=restore-volume-data-from-backup \ --selected-applications=$NAMESPACE/$PROTECTED_APP \ --cluster-resource-scope-selected-group-kinds="storage.k8s.io/StorageClass","scheduling.k8s.io/PriorityClass"
Ripristina dal backup.
gcloud beta container backup-restore restores create $RESTORE_NAME \ --project=$PROJECT_ID \ --location=$DR_REGION \ --restore-plan=$RESTORE_PLAN_NAME \ --backup=projects/$PROJECT_ID/locations/$DR_REGION/backupPlans/$BACKUP_PLAN_NAME/backups/$BACKUP_NAME \ --wait-for-completion
Verifica che il cluster sia stato ripristinato
Per verificare che il cluster ripristinato contenga tutte le risorse Pod, PersistentVolume e StorageClass previste, segui questi passaggi:
Configura l'accesso alla riga di comando
kubectl
al cluster di backupcluster-db2
.gcloud container clusters get-credentials $TARGET_CLUSTER --region $DR_REGION --project $PROJECT_ID
Verifica che StatefulSet sia pronto con 3/3 pod.
kubectl get all -n $NAMESPACE
L'output è simile al seguente:
NAME READY STATUS RESTARTS AGE pod/postgresql-postgresql-ha-pgpool-778798b5bd-k2q4b 1/1 Running 0 4m49s pod/postgresql-postgresql-ha-postgresql-0 2/2 Running 2 (4m13s ago) 4m49s pod/postgresql-postgresql-ha-postgresql-1 2/2 Running 0 4m49s pod/postgresql-postgresql-ha-postgresql-2 2/2 Running 0 4m49s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/postgresql-postgresql-ha-pgpool ClusterIP 192.168.241.46 <none> 5432/TCP 4m49s service/postgresql-postgresql-ha-postgresql ClusterIP 192.168.220.20 <none> 5432/TCP 4m49s service/postgresql-postgresql-ha-postgresql-headless ClusterIP None <none> 5432/TCP 4m49s service/postgresql-postgresql-ha-postgresql-metrics ClusterIP 192.168.226.235 <none> 9187/TCP 4m49s NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/postgresql-postgresql-ha-pgpool 1/1 1 1 4m49s NAME DESIRED CURRENT READY AGE replicaset.apps/postgresql-postgresql-ha-pgpool-778798b5bd 1 1 1 4m49s NAME READY AGE statefulset.apps/postgresql-postgresql-ha-postgresql 3/3 4m49s
Verifica che tutti i pod nello spazio dei nomi
postgres
siano in esecuzione.kubectl get pods -n $NAMESPACE
L'output è simile al seguente:
postgresql-postgresql-ha-pgpool-569d7b8dfc-2f9zx 1/1 Running 0 7m56s postgresql-postgresql-ha-postgresql-0 2/2 Running 0 7m56s postgresql-postgresql-ha-postgresql-1 2/2 Running 0 7m56s postgresql-postgresql-ha-postgresql-2 2/2 Running 0 7m56s
Verifica PersistentVolumes e StorageClass. Durante il processo di ripristino, Backup per GKE crea una classe proxy nel workload di destinazione per sostituire la StorageClass di cui è stato eseguito il provisioning nel workload di origine (
gce-pd-gkebackup-dn
nell'output di esempio).kubectl get pvc -n $NAMESPACE
L'output è simile al seguente:
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE data-postgresql-postgresql-ha-postgresql-0 Bound pvc-be91c361e9303f96 8Gi RWO gce-pd-gkebackup-dn 10m data-postgresql-postgresql-ha-postgresql-1 Bound pvc-6523044f8ce927d3 8Gi RWO gce-pd-gkebackup-dn 10m data-postgresql-postgresql-ha-postgresql-2 Bound pvc-c9e71a99ccb99a4c 8Gi RWO gce-pd-gkebackup-dn 10m
Verificare che i dati previsti siano stati ripristinati
Per verificare che i dati previsti siano stati ripristinati:
Connetterti all'istanza PostgreSQL.
./scripts/launch-client.sh kubectl exec -it pg-client -n postgresql -- /bin/bash
Verifica il numero di righe per ogni tabella.
psql -h $HOST_PGPOOL -U postgres -a -q -f /tmp/scripts/count-rows.sql select COUNT(*) from tb01;
Dovresti visualizzare un risultato simile ai dati che hai scritto in precedenza nella sezione Crea un set di dati di test. L'output è simile al seguente:
300000 (1 row)
Esci dal pod client.
exit
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.
Elimina il progetto
Il modo più semplice per evitare la fatturazione è eliminare il progetto creato per il tutorial.
Delete a Google Cloud project:
gcloud projects delete PROJECT_ID
Passaggi successivi
- Scopri le best practice per il deployment dei database su GKE.
- Esplora i volumi permanenti in modo più dettagliato.
- Consulta un esempio di come utilizzare Pgpool-II per la replica in streaming con cluster PostgreSQL ad alta disponibilità.