Belajar Restic - Restore & File Extract

#Pendahuluan

Di episode 4 kalian menghasilkan snapshot pertama. Sekarang kita belajar sisi lain yang lebih penting: mengembalikan data. Sebuah backup yang tidak bisa di-restore hanyalah sampah yang mahal — filosofi restore-first restic baru terasa di episode ini.

Kita akan menempuh tiga skenario: restore penuh, extract satu file, dan restore sebagian dengan pola include/exclude.

#Restore Penuh

Perintah paling mendasar mengembalikan seluruh isi snapshot ke direktori target:

Restore seluruh snapshot

restic restore 8b0a7f2e --target /tmp/restore

Hasilnya, isi snapshot tersusun di bawah /tmp/restore sesuai struktur aslinya — misalnya /tmp/restore/home/user/.... Restic tidak pernah menimpa file yang sudah ada di luar path snapshot: ia menulis ulang struktur ke dalam --target, sehingga aman untuk restore di atas direktori aktif.

#Restore Snapshot Terbaru atau Ter-tag

Daripada menyalin ID manual, pilih snapshot secara dinamis:

Restore snapshot terbaru untuk path tertentu

restic restore latest --target /tmp/restore --path /home/user
restic restore latest --target /tmp/restore --tag daily

latest berarti snapshot terbaru yang cocok dengan filter --path/--tag yang diberikan — sangat berguna dalam script otomasi.

#Ekstrak Satu File dengan dump

restic dump menarik satu file dan mengirim isinya ke stdout — tanpa menulis ke disk, cocok untuk melihat isi config atau menggabungkan dengan perintah lain:

Tampilkan satu file ke stdout

restic dump 8b0a7f2e /etc/nginx/nginx.conf

Kombinasi paling berguna: memulihkan satu file langsung ke tempat aslinya:

Restore satu file via redirect

restic dump 8b0a7f2e /etc/nginx/nginx.conf > /etc/nginx/nginx.conf

Hati-hati dengan redirect menimpa file asli — pastikan dulu isi stdout benar (restic dump ... | head).

#Restore Selektif dengan Include/Exclude

Saat hanya sebagian snapshot yang dibutuhkan, jangan restore semuanya — itu membuang waktu dan disk. Gunakan --include untuk menyeleksi apa yang dikembalikan:

Restore hanya direktori tertentu

restic restore 8b0a7f2e --target /tmp/restore \
  --include /home/user/Documents

Atau --exclude untuk membuang bagian yang tidak diinginkan:

Restore minus direktori cache

restic restore 8b0a7f2e --target /tmp/restore \
  --exclude /home/user/.cache

Sama seperti backup, pola mengikuti aturan filepath.Match. Ingat: --include dan --exclude berlaku pada restore, sedangkan filter snapshot (mana yang dipilih) ditentukan --path/--tag/latest.

Important

restic restore tidak memproteksi dari penimpaan file yang sudah ada di target jika path-nya memang ada di snapshot — file akan ditimpa dengan isi dari snapshot. Jika ingin membandingkan dulu, restore ke direktori kosong dan pindahkan secara manual.

#Skenario: Menemukan File di Snapshot

Alur praktis saat harus mengembalikan file yang hilang:

Cari lalu restore file

restic find 8b0a7f2e "report-2026.pdf"
restic dump 8b0a7f2e "/home/user/report-2026.pdf" > report-2026.pdf

restic find melacak file berdasarkan nama/pattern di dalam snapshot — pasangan sempurna dengan dump.

#Penutup

restic restore <id> --target <dir> mengembalikan seluruh snapshot ke struktur di bawah target.
latest dengan --path/--tag memilih snapshot terbaru yang cocok secara dinamis.
restic dump mengekstrak satu file ke stdout — cepat, tanpa menyentuh disk.
Restore sebagian: --include untuk menyeleksi, --exclude untuk membuang.
Restore menimpa file yang path-nya cocok di target — restore ke direktori kosong bila ragu.

Di episode 6 selanjutnya kita masuk ke jantung efisiensi restic: deduplication, storage & compression — bagaimana content-defined chunking membuat backup berulang hanya menyimpan delta, membaca angka dedup lewat restic stats --mode raw-data, dan bagaimana kompresi zstd (--compression auto) menghemat storage sejak default di versi 0.14+.