Belajar Borg Backup - Backup Pertama: borg create

#Pendahuluan

Repository sudah lahir di episode 3. Sekarang saatnya aksi nyata: membuat backup pertama. Ini momen penting karena di sini kalian melihat deduplication bekerja, belajar membaca statistik, dan membangun kebiasaan menamai archive yang baik. Pilihan nama archive yang buruk akan menghantui kalian saat mencari file di masa depan — jadi mari lakukan dengan benar sejak awal.

#Backup Pertama

#Perintah Dasar

export BORG_REPO=/backup/borg
export BORG_PASSCOMMAND='cat /root/.borg-passphrase'
 
borg create --stats --list /backup/borg::"{hostname}-{now}" /home /etc

Mari bedah bagian-bagiannya:

• /backup/borg::"{hostname}-{now}" — setelah :: adalah nama archive. {hostname} dan {now} adalah placeholder Borg yang diganti otomatis menjadi nama host dan timestamp lokal. Hasilnya misalnya web-01-2026-08-13T10:30:00.
• /home /etc — direktori sumber yang dibackup.
• --list — mencetak setiap file yang diproses (berguna saat pertama kali, tidak wajib selalu).
• --stats — menampilkan ringkasan: jumlah file, ukuran asli, ukuran setelah dedup, dan rasio kompresi.

#Placeholder Nama Archive

Borg menyediakan placeholder yang bisa dikombinasikan:

• {hostname} / {fqdn} — nama host.
• {now} — timestamp waktu lokal; {utcnow} untuk UTC.
• {user} — user yang menjalankan backup.

Pola "{hostname}-{now}" adalah standar industri: satu glance langsung tahu data siapa dan kapan. Kalian juga bisa menambahkan suffix untuk jenis data, misalnya "{hostname}-{now}-db".

#Eksklusi File

#--exclude dan --exclude-caches

Backup penuh /home akan menyeret cache, build artifact, dan file sementara — membuang ruang dan memperlambat backup. Bersihkan dengan eksklusi:

borg create --stats \
  --exclude '*.pyc' \
  --exclude '*/node_modules/*' \
  --exclude '*/target/*' \
  --exclude-caches \
  /backup/borg::"{hostname}-{now}" /home /etc

• --exclude menerima pola glob; gunakan * di awal agar cocok di kedalaman mana pun.
• --exclude-caches melewatkan direktori yang mengandung file CACHEDIR.TAG — standar yang dipakai banyak tool (termasuk git dan build system) untuk menandai direktori cache.

#--exclude-if-present

Untuk kontrol berbasis marker, gunakan --exclude-if-present <filename>: direktori yang berisi file penanda akan dilewati. Ini cara yang rapi bila kalian ingin "opt-in" pada file tertentu, misalnya --exclude-if-present .no-backup.

#Dry-run Dulu

Biasakan memeriksa apa yang akan disalin sebelum mengeksekusi:

borg create --dry-run --list /backup/borg::"{hostname}-{now}-dry" /home /etc

--dry-run tidak menulis apa pun — hanya menunjukkan file yang akan disertakan. Perhatikan bahwa archive dummy ikut dibuat namanya, jadi beri penanda -dry agar tidak bingung nanti.

#Mengelola Archive

#borg list

borg list /backup/borg

Output-nya seperti ini:

web-01-2026-08-13T10:30:00   Thu, 2026-08-13 10:30:00  [abc123...]
web-01-2026-08-14T02:00:00   Fri, 2026-08-14 02:00:00  [def456...]

Dua kolom terakhir adalah ID archive (hash) dan waktu pembuatan.

#borg info

borg info /backup/borg::"web-01-2026-08-13T10:30:00"

borg info menampilkan angka yang wajib dibaca:

• Number of files — jumlah file dalam archive.
• Original size — ukuran total sumber sebelum dedup.
• Deduplicated size — ukuran yang benar-benar disimpan di repo.
• Unique chunks / Total chunks — berapa banyak chunk unik vs total referensi.
• Compression ratio — seberapa baik kompresi bekerja.

Angka "Original size" vs "Deduplicated size" adalah bukti dedup bekerja: jika backup kedua hampir tidak menambah ukuran, dedup sukses.

#Pitfall Umum

• File berubah saat backup: file yang ditulis berbarengan dengan proses backup bisa berubah di tengah jalan. Untuk konsistensi database, pakai pendekatan di episode 10.
• Nama archive ambigu: tanpa {hostname}, dua host yang berbagi repo akan saling menimpa nama. Selalu sertakan identitas host.
• Repo ikut ter-backup: jangan letakkan repo di dalam direktori sumber — itu yang kita peringatkan di episode 0.
• Lupa --stats: tanpa stats kalian buta apakah backup benar-benar efisien dan sukses. Selalu sertakan di jadwal manual.

#Penutup

• borg create --stats /backup/borg::"{hostname}-{now}" /home /etc adalah backup pertama kalian.
• Nama archive berpola host-timestamp membuat riwayat mudah dibaca.
• Gunakan --exclude, --exclude-caches, dan --exclude-if-present untuk menghindari sampah.
• borg list menampilkan seluruh archive; borg info menunjukkan angka dedup dan kompresi.
• Dedup terlihat jelas: backup kedua hampir tidak menambah ukuran repo.

Di episode 5 kita mempelajari sisi yang sering dilupakan banyak orang: restore & extract — mengembalikan data dengan borg extract, memilih file secara selektif dengan --path, menjelajah archive via borg mount (FUSE), dan praktik terbaik restore ke direktori bersih dengan verifikasi.