Tipe field di Elasticsearch bersifat immutable — Anda tidak bisa mengubahnya di tempat. Solusinya: bangun index baru dengan mapping benar, salin data lewat _reindex, lalu tukar alias secara atomik. Aplikasi tidak pernah tahu ada pergantian di belakang layar.
mapper [field] cannot be changed. Reindex adalah jalan resmi.Aplikasi selalu menulis dan membaca ke alias, bukan index fisik. Index fisik diberi nama bertanggal/berversi.
# alias logis -> index fisik pages_current -> pages_2026_05 # sebelum reindex pages_current -> pages_2026_06 # setelah swap
PUT /pages_2026_06 { "settings": { "number_of_shards": 3, "number_of_replicas": 1 }, "mappings": { "properties": { "title": { "type": "text" }, "slug": { "type": "keyword" }, # diperbaiki dari text "views": { "type": "long" }, "published": { "type": "date" } } } }
# jalankan asinkron untuk dataset besar POST /_reindex?wait_for_completion=false { "source": { "index": "pages_2026_05" }, "dest": { "index": "pages_2026_06" } } # pantau progres task GET /_tasks/<task_id>
slices: "auto" di body agar reindex berjalan paralel dan lebih cepat. Index lama tetap melayani trafik sepanjang proses.Inilah inti zero-downtime. Satu request _aliases melepas alias dari index lama dan menambahkannya ke index baru secara atomik.
POST /_aliases
{
"actions": [
{ "remove": { "index": "pages_2026_05", "alias": "pages_current" } },
{ "add": { "index": "pages_2026_06", "alias": "pages_current" } }
]
}
pages_current tidak menunjuk ke index mana pun. Klien tidak pernah melihat error.GET /_alias/pages_current harus menunjuk ke pages_2026_06.
GET /pages_current/_count sama dengan count index lama.
Jalankan query aplikasi melalui alias dan pastikan hasil sesuai.
Awasi log aplikasi beberapa saat sebelum menghapus index lama.
# ROLLBACK: tukar alias kembali ke index lama POST /_aliases { "actions": [ { "remove": { "index": "pages_2026_06", "alias": "pages_current" } }, { "add": { "index": "pages_2026_05", "alias": "pages_current" } } ] } # bila sudah yakin, hapus index lama DELETE /pages_2026_05
Tipe sebagian besar field bersifat immutable setelah index dibuat, karena struktur Lucene di balik field sudah ditetapkan. Anda hanya bisa menambah field baru, bukan mengubah tipe field yang sudah ada (mis. dari text ke keyword). Untuk perubahan semacam itu, buat index baru dengan mapping benar lalu reindex.
Alias adalah nama logis yang menunjuk ke satu atau lebih index fisik. Aplikasi cukup memakai alias (mis. pages_current) dan tidak perlu tahu index fisik di belakangnya. Saat reindex, Anda menukar alias secara atomik ke index baru tanpa mengubah konfigurasi aplikasi.
Tidak, bila dilakukan dengan benar. Index lama tetap melayani trafik selama _reindex berjalan ke index baru. Downtime nol dicapai karena pergantian alias bersifat atomik: dalam satu request, alias dilepas dari index lama dan ditambahkan ke index baru.
Karena index lama tidak dihapus segera, rollback semudah menukar alias kembali ke index lama dengan operasi _aliases yang sama (remove dari baru, add ke lama). Tunggu beberapa saat sebelum menghapus index lama untuk berjaga-jaga.
Amankan data dengan snapshot sebelum reindex skala besar agar selalu ada titik pulih.
Backup Snapshot ke S3