Belajar Borg Backup - Otomasi dengan borgmatic

#Pendahuluan

Sejak episode 3 kita menjalankan perintah Borg satu per satu secara manual. Di dunia nyata, tidak ada yang mengingat menjalankan borg create setiap jam 02:00 — dan backup yang bergantung pada ingatan manusia pada akhirnya gagal. Episode 9 memperkenalkan borgmatic: wrapper yang menjadikan seluruh konfigurasi backup menjadi satu file YAML, lalu menjadwalkannya dengan cron atau systemd timer.

#Apa itu borgmatic

Borgmatic adalah wrapper Python di atas Borg yang menangani hal-hal yang mudah dilupakan manusia: membuat archive dengan nama timestamp yang benar, menjalankan prune, compact, dan check secara berurutan, serta mengeksekusi hook sebelum dan sesudah. Satu perintah borgmatic menjalankan seluruh pipeline. Install via paket distribusi (sudo apt install -y borgmatic) atau pipx install borgmatic untuk versi terbaru.

#Konfigurasi YAML

#Struktur Dasar

Konfigurasi borgmatic berada di /etc/borgmatic/config.yaml (atau ~/.config/borgmatic/config.yaml untuk user). File ini mewakili seluruh kebijakan backup kalian:

source_directories:
  - /home
  - /etc
 
repositories:
  - path: /backup/borg
    label: local
 
encryption_passcommand: cat /root/.borg-passphrase
 
retention:
  keep_daily: 7
  keep_weekly: 4
  keep_monthly: 6
 
checks:
  - name: repository
    frequency: 1 month
  - name: data
    frequency: 1 year
 
hooks:
  before_backup:
    - echo "Backup dimulai pada $(date)"
  after_backup:
    - echo "Backup selesai pada $(date)"

Bacaan bagian utamanya:

• source_directories — direktori yang dibackup (setara argumen borg create).
• repositories — daftar repository; borgmatic mengisi BORG_REPO otomatis.
• encryption_passcommand — passphrase dibaca dari command, tidak di-hardcode.
• retention — aturan prune; borgmatic memetakannya ke borg prune.
• checks — jadwal borg check: repository tiap bulan, verifikasi data tiap tahun.
• hooks — perintah sebelum dan sesudah backup.

Sebelum menjalankan, validasi dulu dengan sudo borgmatic config validate — kesalahan YAML atau opsi yang tidak dikenal muncul di sini, bukan saat backup berjalan.

#Menjalankan borgmatic

#Mode Verbose dan Stats

sudo borgmatic --verbosity 1 --stats

• --verbosity 1 menampilkan progress tiap file.
• --stats mencetak ringkasan setelah backup selesai.
• Untuk maintenance terjadwal, subset langkah bisa dipanggil terpisah: sudo borgmatic prune --stats, sudo borgmatic compact, atau sudo borgmatic check.

#Menjadwalkan dengan Cron atau Systemd

#Cron

30 2 * * * root /usr/local/bin/borgmatic --verbosity 1 --stats >> /var/log/borgmatic.log 2>&1

Cron sederhana dan mudah dibaca: setiap hari pukul 02:30. Log diarahkan ke file agar bisa diinspeksi (dan di-monitor di episode 20).

#Systemd Timer

Systemd memberi kontrol lebih: OnCalendar, RandomizedDelaySec untuk menghindari thundering herd, dan integrasi journald.

[Unit]
Description=Jalankan backup borgmatic
 
[Service]
Type=oneshot
ExecStart=/usr/local/bin/borgmatic --verbosity 0
 
[Unit]
Description=Jadwal harian backup borgmatic
 
[Timer]
OnCalendar=daily
RandomizedDelaySec=1800
Persistent=true
 
[Install]
WantedBy=timers.target

Aktifkan dengan sudo systemctl daemon-reload, sudo systemctl enable --now borgmatic.timer, lalu cek dengan systemctl list-timers borgmatic.timer. Persistent=true memastikan backup tetap dijalankan walau host mati saat jadwal tiba. RandomizedDelaySec menyebar waktu mulai acak hingga 30 menit — menolong bila banyak host mulai pada jam yang sama.

#Hook: Sebelum dan Sesudah Backup

Hooks adalah titik integrasi borgmatic:

• before_backup — menjalankan perintah sebelum create: mempersiapkan database dump (episode 10), mengecek ruang disk, atau me-remount filesystem.
• after_backup — pembersihan dan notifikasi.
• on_error — dijalankan ketika backup gagal; dasar untuk alerting di episode 20.

#Pitfall Umum

• Menjalankan borgmatic tanpa env: borgmatic membaca env dari user yang menjalankannya. Pastikan BORG_PASSCOMMAND bisa dieksekusi oleh user scheduler.
• Lupa encryption_passcommand: tanpa ini borgmatic meminta passphrase interaktif — yang gagal di cron/systemd. Wajib untuk otomasi.
• Config di git tanpa secret: config.yaml berisi kebijakan; passphrase tidak boleh di dalamnya. Gunakan passcommand yang menunjuk ke file 600 atau password manager.
• Langkah manual di samping borgmatic: borgmatic sudah mengatur urutan create → prune → compact → check. Jangan menabraknya tanpa alasan.

#Penutup

• borgmatic merangkum create, prune, compact, dan check dalam satu file YAML.
• Gunakan borgmatic config validate sebelum menjalankan.
• borgmatic --verbosity 1 --stats memberi output yang bisa diaudit.
• Jadwalkan dengan cron atau systemd timer (disarankan: timer + Persistent=true).
• Hooks before_backup, after_backup, dan on_error adalah titik integrasi utama.

Di episode 10 kita menangani kasus tersulit dalam backup: backup database konsisten — menyiapkan dump PostgreSQL dan MySQL/MariaDB lewat hooks, memastikan konsistensi WAL, dan pola yang benar untuk service file.