Menyiapkan pgBackRest untuk AlloyDB Omni di Linux

Pilih versi dokumentasi:

Halaman ini menunjukkan cara melindungi data Anda dengan mengonfigurasi AlloyDB Omni agar berfungsi dengan pgBackRest, server pencadangan database open source.

Untuk mengetahui informasi selengkapnya tentang pgBackRest, lihat panduan penggunanya.

Sebelum memulai

Sebelum mengonfigurasi AlloyDB Omni agar berfungsi dengan pgBackRest, selesaikan prasyarat berikut:

Konfigurasi dasar dengan pencadangan lokal

Langkah-langkah di bagian ini akan memandu Anda melalui penyiapan dasar pgBackRest. Konfigurasi dasar tidak mengaktifkan pencadangan sesuai jadwal. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan pencadangan terjadwal.

Karena pgBackRest adalah produk pihak ketiga yang fleksibel dan kompatibel dengan AlloyDB Omni, Anda dapat mengubah langkah-langkah ini sesuai kebutuhan dan preferensi Anda sendiri.

Membuat direktori cadangan

Untuk tujuan organisasi, sebaiknya buat direktori terpisah untuk pencadangan pgBackRest. Untuk menyiapkan direktori baru, selesaikan langkah-langkah berikut:

  1. Jika AlloyDB Omni berjalan, hentikan.

    sudo systemctl stop alloydbomni18

  2. Buat direktori cadangan.

    sudo mkdir -p BACKUP_DIR

    Ganti BACKUP_DIR dengan direktori host tempat cadangan Anda akan disimpan.

  3. Buat direktori cadangan dapat dibaca oleh postgres.

    sudo chown -R postgres:postgres BACKUP_DIR

Mengonfigurasi pencadangan lokal

pgBackRest membuat subdirektori untuk setiap cadangan yang diambil dan menyertakan file manifes teks biasa.

pgBackRest menggunakan istilah stanza untuk merujuk ke konfigurasi untuk cluster database PostgreSQL. Nama stanza bersifat arbitrer dan tidak harus cocok dengan server host, cluster PostgreSQL, atau nama database. Dokumentasi pgBackRest menyarankan untuk memberi nama stanza sesuai dengan fungsi cluster.

Repositori adalah tempat cadangan ditulis. pgBackRest mendukung penulisan ke lebih dari satu repositori dalam stanza tertentu. Sebagian besar parameter konfigurasi yang terkait dengan repositori diindeks dengan nilai numerik. Misalnya, repo1-. Parameter yang terkait dengan cluster PostgreSQL juga diindeks secara terpisah. Misalnya, pg1-.

pgBackRest memanfaatkan file konfigurasi, yang disebut pgbackrest.conf, untuk menyimpan parameter global dan khusus stanza.

Untuk mem-build dan menginisialisasi file konfigurasi untuk mencadangkan cluster AlloyDB Omni, buat file pgbackrest.conf di direktori cadangan sisi host yang Anda buat di Membuat direktori cadangan. 

[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

Beberapa parameter bersifat wajib, tetapi parameter lainnya dapat disesuaikan untuk memenuhi persyaratan spesifik Anda jika diperlukan, seperti berikut:

  • repo1-path: Lokasi direktori tempat cadangan ditulis. Sebaiknya gunakan lokasi yang terlihat oleh server host dan penampung.

  • log-path: Lokasi direktori tempat file log ditulis. Jika Anda ingin menulis file log ke lokasi terpisah, tidak dicampur dengan cadangan itu sendiri, sesuaikan parameter ini.

  • repo1-retention-full: Jumlah cadangan penuh yang akan dipertahankan.

  • repo1-retention-full-type: Apakah retensi diukur berdasarkan jumlah atau jangka waktu (hari).

  • repo1-retention-diff: Jumlah cadangan diferensial yang akan dipertahankan.

Setelan parameter non-kritis lainnya, tetapi direkomendasikan, yang kompatibel dengan AlloyDB Omni dalam file konfigurasi mencakup hal berikut:

  • log-level-console: Tingkat logging yang ditulis ke layar (STDOUT) saat menjalankan perintah pgBackup. Anda dapat menyesuaikannya untuk memenuhi kebutuhan Anda dalam file konfigurasi, atau mengganti nilai ini dengan argumen command line --log-level-console. Nilai defaultnya adalah warn.

  • start-fast: Memaksa checkpoint untuk memulai pencadangan dengan cepat. Nilai defaultnya adalah n.

  • archive-async: Mendorong file segmen WAL secara asinkron untuk performa. Nilai defaultnya adalah n.

  • process-max: Jumlah maksimum proses yang akan digunakan untuk kompresi dan transfer. Biasanya ditetapkan ke max_cpu/4 pada cluster utama atau max_cpu/2 pada cluster standby. Nilai defaultnya adalah 1.

  • compress-type: Algoritma kompresi yang akan digunakan. Nilai defaultnya adalah gz.

Ada banyak parameter konfigurasi pgBackRest lainnya yang dapat disesuaikan. Dokumentasi ini hanya mencakup parameter yang wajib untuk konfigurasi AlloyDB Omni default dan beberapa setelan parameter yang direkomendasikan. Untuk mengetahui daftar lengkap parameter konfigurasi, lihat dokumentasi online Referensi Konfigurasi pgBackRest.

Setelah mengonfigurasi pgBackRest, repositori target tempat cadangan ditulis harus diinisialisasi dengan membuat stanza, yang menggunakan parameter seperti yang ditetapkan dalam file konfigurasi.

Untuk mengonfigurasi database Anda untuk pencadangan, selesaikan langkah-langkah berikut:

  1. Buat stanza menggunakan perintah stanza-create.

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

    Ganti BACKUP_DIR dengan direktori cadangan yang Anda buat di Membuat direktori cadangan.

  2. Konfigurasikan database Anda untuk pencadangan.

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres \
-c "ALTER SYSTEM SET archive_command='pgbackrest --config-path=/var/lib/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;"

  3. Mulai ulang AlloyDB Omni.

    sudo systemctl restart alloydbomni18

  4. Validasi konfigurasi cadangan.

    /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"

  5. Lakukan pemeriksaan pgBackRest.

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

Melakukan pencadangan

  1. Lakukan pencadangan penuh.

    sudo -u postgres pgbackrest \
--config-path=/var/lib/BACKUP_DIR \
--stanza=omni \
--type=full backup

    Ganti BACKUP_DIR dengan direktori cadangan yang Anda buat di Membuat direktori cadangan.

  2. Lakukan pencadangan diferensial.

    sudo -u postgres pgbackrest \
--config-path=/var/lib/BACKUP_DIR \
--stanza=omni \
--type=diff backup

  3. Laporkan cadangan.

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

Menyiapkan pencadangan terjadwal

Untuk menyiapkan pencadangan terjadwal, buat cron job yang menjalankan perintah pgbackrest backup sesering yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Menjadwalkan pencadangan.

Konfigurasi kustom dan pencadangan jarak jauh

Setelah konfigurasi dasar berfungsi, Anda dapat menyesuaikan file konfigurasi agar sesuai dengan kebutuhan dan preferensi Anda menggunakan opsi yang didokumentasikan dalam referensi konfigurasi pgBackRest.

Hal ini mencakup penentuan repositori cadangan tambahan yang terletak di mesin jarak jauh, atau di cloud. Jika Anda menentukan beberapa repositori, pgBackRest akan menulis ke semuanya secara bersamaan sebagai tindakan pencadangan default.

Misalnya, pgBackRest mendukung penggunaan bucket Cloud Storage sebagai repositori cadangan, dengan sejumlah opsi konfigurasi terkait. Bagian berikut menunjukkan salah satu cara menggunakan opsi ini.

Contoh konfigurasi menggunakan Cloud Storage

Langkah-langkah di bagian ini dibuat berdasarkan file konfigurasi yang diperkenalkan di Konfigurasi dasar dengan pencadangan lokal. Perubahan pada file tersebut menentukan repositori cadangan kedua di bucket Cloud Storage, yang diakses melalui Identity and Access Management (IAM).

Gaya autentikasi otomatis dalam contoh ini mengharuskan cluster AlloyDB Omni berjalan pada instance VM Compute Engine. Jika Anda tidak menjalankan AlloyDB Omni pada instance VM Compute Engine, Anda tetap dapat mencadangkan ke bucket Cloud Storage dengan menggunakan metode autentikasi lain, seperti kunci akun layanan yang disimpan ke sistem file lokal. Google Cloud

Untuk memperluas file konfigurasi sebelumnya guna menentukan repositori pgBackRest berbasis Cloud Storage, ikuti langkah-langkah berikut:

  1. Konfigurasikan izin bucket untuk mengizinkan akun layanan yang terlampir ke instance VM Anda menulis ke bucket. Hal ini memerlukan peran IAM Pengguna Objek Penyimpanan yang ditetapkan pada akun layanan tersebut.

  2. Tambahkan baris berikut ke bagian [global] file pgbackrest.conf Anda:

    # 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

    Ganti variabel berikut:

    • BUCKET_NAME: Nama bucket Cloud Storage yang Anda inginkan agar pgBackRest menyimpan cadangan.
    • PATH_IN_BUCKET: Jalur direktori di bucket Cloud Storage yang Anda inginkan agar pgBackRest menyimpan cadangan.

  3. Inisialisasi lokasi cadangan berbasis cloud menggunakan the pgbackrest stanza-create command:

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

    Ganti BACKUP_DIR dengan direktori cadangan yang Anda buat di Membuat direktori cadangan.

Setelah Anda menginisialisasi repositori cadangan di bucket Cloud Storage menggunakan perintah pgbackrest stanza-create, pgBackRest dapat mencadangkan ke dua lokasi:

  • Lokasi di sistem file lokal, yang ditentukan di tempat lain dalam file konfigurasi sebagai repo1-path. Ini adalah lokasi default jika --repo tidak ditentukan dalam perintah pgbackrest.

  • Bucket Cloud Storage, yang ditentukan menggunakan perintah konfigurasi repo2-gcs-bucket yang disiapkan oleh contoh ini. Untuk menggunakan bucket Cloud Storage, tentukan --repo=2 dalam perintah pgbackrest.

Langkah berikutnya