Questa pagina documenta la versione 18.1.1 di AlloyDB Omni utilizzando l'opzione di deployment RPM. Scegli un'altra opzione di implementazione.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configura pgBackRest per AlloyDB Omni su Linux

Seleziona una versione della documentazione:

Questa pagina mostra come proteggere i dati configurando AlloyDB Omni in modo che funzioni con pgBackRest, un server di backup di database open source.

I cluster abilitati per TDE supportano backup e ripristini trasparenti utilizzando pgBackRest e non è necessario eseguire ulteriori passaggi. Per saperne di più, consulta Crea un cluster abilitato per TDE.

Per saperne di più su pgBackRest, consulta la guida dell'utente.

Prima di iniziare

Prima di configurare AlloyDB Omni per l'utilizzo con pgBackRest, completa i seguenti prerequisiti:

Installa ed esegui AlloyDB Omni su un server che controlli.

Configurazione di base con backup locali

I passaggi descritti in questa sezione ti guideranno nella configurazione di base di pgBackRest. Le configurazioni di base non abilitano i backup in base a una pianificazione. Per saperne di più, consulta Configura i backup pianificati.

Poiché pgBackRest è un prodotto di terze parti flessibile compatibile con AlloyDB Omni, puoi modificare uno qualsiasi di questi passaggi in base alle tue esigenze e preferenze.

Crea una directory di backup

Per motivi di organizzazione, ti consigliamo vivamente di creare una directory separata per i backup di pgBackRest. Per configurare una nuova directory, completa i seguenti passaggi:

Se AlloyDB Omni è in esecuzione, interrompilo.
```
sudo systemctl stop alloydbomni18
```
Crea una directory di backup.
```
sudo mkdir -p BACKUP_DIR
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.
Rendi la directory dei backup leggibile da postgres.
```
sudo chown -R postgres:postgres BACKUP_DIR
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.

Configura i backup locali

pgBackRest crea sottodirectory per ogni backup eseguito e include un file manifest in testo normale.

pgBackRest utilizza il termine stanza per fare riferimento alla configurazione di un cluster di database PostgreSQL. Il nome della stanza è arbitrario e non deve corrispondere al nome del server host, del cluster PostgreSQL o del database. La documentazione di pgBackRest suggerisce di assegnare alla stanza il nome della funzione del cluster.

Il repository è il luogo in cui vengono scritti i backup. pgBackRest supporta la scrittura in più di un repository in una determinata stanza. La maggior parte dei parametri di configurazione relativi ai repository è indicizzata con un valore numerico. Ad esempio, repo1-. Anche i parametri relativi ai cluster PostgreSQL vengono indicizzati in modo indipendente. Ad esempio, i parametri specifici del primo cluster PostgreSQL in una stanza hanno il prefisso pg1-.

pgBackRest utilizza un file di configurazione, denominato pgbackrest.conf, per contenere i parametri globali e specifici della stanza.

Per creare e inizializzare un file di configurazione per il backup del tuo cluster AlloyDB Omni, crea il file pgbackrest.conf nella directory dei backup lato host che hai creato in Monta un volume di backup nel container o Crea una directory di backup.

[global]
# Paths (all mandatory):


repo1-path=BACKUP_DIR
spool-path=BACKUP_DIR/spool
lock-path=BACKUP_DIR


# Retention details:
repo1-retention-full=3
repo1-retention-full-type=count
repo1-retention-diff=16

# Force a checkpoint to start backup immediately:
start-fast=y

# Logging parameters:


log-path=BACKUP_DIR

log-level-console=info
log-level-file=info

# Recommended ZSTD compression:
compress-type=zst

# Other performance parameters:
archive-async=y
archive-push-queue-max=1024MB
archive-get-queue-max=256MB
archive-missing-retry=y

[global:archive-push]
process-max=2

[global:archive-get]
process-max=2

[omni]
pg1-user=postgres
pg1-socket-path=/tmp



pg1-path=DATA_DIR

Alcuni parametri sono obbligatori, ma altri possono essere modificati per soddisfare i tuoi requisiti specifici, se necessario, ad esempio:

repo1-path: la posizione della directory in cui vengono scritti i backup. Ti consigliamo una posizione visibile sia al server host sia al container.
log-path: percorso della directory in cui vengono scritti i file di log. Se vuoi scrivere i file di log in una posizione separata, non combinata con i backup stessi, modifica questo parametro.
repo1-retention-full: numero di backup completi da conservare.
repo1-retention-full-type: indica se la conservazione viene misurata in base al conteggio o al periodo di tempo (giorni).
repo1-retention-diff: numero di backup differenziali da conservare.

Altre impostazioni dei parametri non critiche, ma consigliate, compatibili con AlloyDB Omni nel file di configurazione includono:

log-level-console: livello di logging scritto sullo schermo (STDOUT) durante l'esecuzione dei comandi pgBackup. Puoi modificare questo valore in base alle tue esigenze nel file di configurazione o sostituirlo con l'argomento della riga di comando --log-level-console. Il valore predefinito è warn.
start-fast: forza un checkpoint per avviare rapidamente i backup. Il valore predefinito è n.
archive-async: esegui il push dei file di segmento WAL in modo asincrono per migliorare le prestazioni. Il valore predefinito è n.
process-max: il numero massimo di processi da utilizzare per la compressione e il trasferimento. In genere, questo valore è impostato su max_cpu/4 in un cluster primario o su max_cpu/2 in un cluster in standby. Il valore predefinito è 1.
compress-type: l'algoritmo di compressione da utilizzare. Il valore predefinito è gz.

Esistono molti altri parametri di configurazione di pgBackRest che possono essere modificati. Questa documentazione illustra solo i parametri obbligatori per la configurazione predefinita di AlloyDB Omni e alcune impostazioni dei parametri consigliate. Per l'elenco completo dei parametri di configurazione, consulta la documentazione online pgBackRest Configuration Reference.

Dopo aver configurato pgBackRest, i repository di destinazione in cui vengono scritti i backup devono essere inizializzati creando la stanza, che utilizza i parametri impostati nel file di configurazione.

Per configurare il database per i backup, completa i seguenti passaggi:

Crea l'istanza utilizzando il comando stanza-create.

sudo -u postgres pgbackrest \
--config-path=/var/lib/BACKUP_DIR \
--stanza=omni stanza-create

Configura il database per i backup.

/usr/lib/postgresql/18/bin/psql -h localhost -U postgres \
-c "ALTER SYSTEM SET archive_command='pgbackrest --config-path=BACKUP_DIR --stanza=omni archive-push %p';" \
-c "ALTER SYSTEM SET archive_mode=on;" \
-c "ALTER SYSTEM SET max_wal_senders=10;" \
-c "ALTER SYSTEM SET wal_level=replica;"

Sostituisci la seguente variabile:

BACKUP_DIR: la directory host in cui verranno archiviati i backup.

Riavvia AlloyDB Omni.
```
sudo systemctl restart 18
```

Convalida la configurazione del backup.

/usr/lib/postgresql/18/bin/psql -h localhost -U postgres \
-c "SELECT name, setting
    FROM pg_catalog.pg_settings
    WHERE name IN ('archive_command',
                   'archive_mode',
                   'max_wal_senders',
                   'wal_level')
    ORDER BY name"

Esegui un controllo pgBackRest.
```
sudo -u postgres pgbackrest \
--config-path=BACKUP_DIR \
--stanza=omni \
check
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.

Esegui un backup

Esegui un backup completo.
```
sudo -u postgres pgbackrest \
--config-path=BACKUP_DIR \
--stanza=omni \
--type=full backup
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.
Esegui un backup differenziale.
```
sudo -u postgres pgbackrest \
--config-path=BACKUP_DIR \
--stanza=omni \
--type=diff backup
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.
Backup dei report.
```
sudo -u postgres pgbackrest \
--config-path=BACKUP_DIR \
--stanza=omni \
info
```
Sostituisci la seguente variabile:
- BACKUP_DIR: la directory host in cui verranno archiviati i backup.

Configura backup pianificati

Per configurare i backup pianificati, crea un cron job che esegua il comando pgbackrest backup con la frequenza necessaria. Per saperne di più, consulta Pianifica un backup.

Configurazione personalizzata e backup remoti

Dopo aver creato una configurazione di base funzionante, puoi ottimizzare il file di configurazione in base alle tue esigenze e preferenze utilizzando le opzioni documentate nel riferimento alla configurazione di pgBackRest.

Ciò include la specifica di repository di backup aggiuntivi situati su macchine remote o nel cloud. Se definisci più repository, pgBackRest scrive contemporaneamente in tutti come azione di backup predefinita.

Ad esempio, pgBackRest supporta l'utilizzo di un bucket Cloud Storage come repository di backup, con una serie di opzioni di configurazione correlate. La sezione seguente mostra un modo per utilizzare queste opzioni.

Esempio di configurazione che utilizza Cloud Storage

I passaggi descritti in questa sezione si basano sul file di configurazione introdotto in Configurazione di base con backup locali. Queste modifiche al file definiscono un secondo repository di backup in un bucket Cloud Storage, a cui si accede tramite Identity and Access Management (IAM).

Lo stile di autenticazione automatica in questo esempio richiede l'esecuzione di un cluster AlloyDB Omni su un'istanza VM di Compute Engine. Se non esegui AlloyDB Omni su un'istanza VM di Compute Engine, puoi comunque eseguire il backup in un bucket Cloud Storage utilizzando un altro metodo di autenticazione, ad esempio una chiave del service account Google Cloud salvata nel file system locale.

Per estendere il file di configurazione precedente in modo da definire un repository pgBackRest basato su Cloud Storage, segui questi passaggi:

Configura le autorizzazioni del bucket per consentire al account di servizio collegato alla tua istanza VM di scrivere nel bucket. Ciò richiede che il ruolo IAM Storage Object User sia impostato su quel account di servizio.

Aggiungi queste righe alla sezione [global] del file pgbackrest.conf:

# Cloud Storage access details:
repo2-type=gcs
repo2-gcs-key-type=auto
repo2-storage-verify-tls=n

# Cloud Storage bucket and path details:
repo2-gcs-bucket=BUCKET_NAME
repo2-path=PATH_IN_BUCKET

# Cloud Storage backup retention parameters:
repo2-retention-full=8
repo2-retention-full-type=count