Snapshot adalah cara resmi dan aman untuk membackup cluster Elasticsearch/OpenSearch. Panduan ini menyimpannya ke storage S3-compatible — termasuk opsi hemat seperti Cloudflare R2 dan Backblaze B2 — lalu menjadwalkannya otomatis dengan SLM.
# pasang di SETIAP node, lalu restart node
sudo bin/elasticsearch-plugin install repository-s3
sudo systemctl restart elasticsearch
# simpan terenkripsi di keystore tiap node sudo bin/elasticsearch-keystore add s3.client.default.access_key sudo bin/elasticsearch-keystore add s3.client.default.secret_key # muat ulang tanpa restart penuh POST /_nodes/reload_secure_settings
elasticsearch.yml atau di body request. Selalu pakai keystore.PUT /_snapshot/backup_s3 { "type": "s3", "settings": { "bucket": "nusabet88-backups", "region": "ap-southeast-1" } }
PUT /_snapshot/backup_r2 { "type": "s3", "settings": { "bucket": "nusabet88-backups", "endpoint": "<accountid>.r2.cloudflarestorage.com", "path_style_access": true, "region": "auto" } }
PUT /_snapshot/backup_b2 { "type": "s3", "settings": { "bucket": "nusabet88-backups", "endpoint": "s3.us-west-002.backblazeb2.com", "path_style_access": true, "region": "us-west-002" } }
| Penyedia | Setting kunci | Catatan |
|---|---|---|
| AWS S3 | region | Endpoint dideteksi otomatis |
| Cloudflare R2 | endpoint + path_style_access | Tanpa biaya egress, region=auto |
| Backblaze B2 | endpoint + region (cluster B2) | Penyimpanan murah |
# verifikasi repository bisa ditulis POST /_snapshot/backup_r2/_verify # buat snapshot (tunggu sampai selesai) PUT /_snapshot/backup_r2/snap_2026_06_20?wait_for_completion=true { "indices": "pages_*,logs_*", "include_global_state": false } # lihat status GET /_snapshot/backup_r2/_all
# tutup atau hapus index target dulu bila perlu
POST /_snapshot/backup_r2/snap_2026_06_20/_restore
{
"indices": "pages_*",
"rename_pattern": "(.+)",
"rename_replacement": "restored_$1"
}
rename_pattern memulihkan ke nama index baru sehingga tidak menimpa data produksi yang sedang berjalan.PUT /_slm/policy/harian { "schedule": "0 30 1 * * ?", # tiap hari 01:30 "name": "<nusa-{now/d}>", "repository": "backup_r2", "config": { "indices": "*", "include_global_state": true }, "retention": { "expire_after": "30d", "min_count": 7, "max_count": 30 } } # jalankan sekali untuk uji POST /_slm/policy/harian/_execute
expire_after + min_count/max_count menjaga jumlah snapshot tetap sehat tanpa pembersihan manual.Snapshot adalah backup inkremental yang konsisten di tingkat cluster: Elasticsearch mengetahui segmen Lucene yang sudah tersimpan dan hanya menyalin yang baru. Menyalin direktori data secara manual saat cluster berjalan berisiko korup karena file sedang ditulis. Selalu pakai Snapshot API.
Keduanya menyediakan API yang kompatibel dengan S3, jadi plugin repository-s3 bisa dipakai dengan mengatur endpoint kustom dan path_style_access. R2 menarik karena tanpa biaya egress, sementara B2 punya tarif penyimpanan murah. Pastikan region dan endpoint diatur sesuai dokumentasi penyedia.
Di Elasticsearch keystore (elasticsearch-keystore), bukan di elasticsearch.yml. Keystore menyimpan access key dan secret key terenkripsi dan harus diterapkan di setiap node. Jangan pernah menaruh secret key dalam plaintext di file konfigurasi atau body request.
SLM (Snapshot Lifecycle Management) menjadwalkan snapshot otomatis dan menerapkan kebijakan retensi (mis. simpan 7 harian, 4 mingguan). Tanpa SLM, Anda harus memicu snapshot manual dan rawan lupa. SLM memastikan backup berjalan rutin dan yang lama dibersihkan otomatis.
Sebelum mengubah mapping, pelajari pola reindex dengan alias agar aplikasi tidak terganggu.
Reindex Tanpa Downtime