All Products
Search
Document Center

Edge Security Acceleration:Purge cache berdasarkan tag

Last Updated:Feb 14, 2026

Ketika konten situs web—seperti detail produk, artikel berita, atau daftar video—diperbarui, Anda sering perlu membersihkan banyak objek cache yang tersebar di berbagai point of presence (POPs). Melakukan purge secara manual satu per satu tidak efisien dan rentan terhadap kelalaian. Fitur purge berbasis tag dari Edge Security Acceleration (ESA) memungkinkan Anda menetapkan cache tag pada resource di origin server. POPs ESA mengenali tag tersebut dan mengaitkannya dengan resource yang di-cache. Saat konten berubah, Anda cukup mengirimkan tag yang ditentukan untuk melakukan purge batch terhadap semua resource cache terkait, sehingga meningkatkan efisiensi operasional dan memastikan pembaruan konten yang akurat.

Fitur

Fitur purge cache berbasis tag menyederhanakan proses purge massal resource cache yang saling terkait, mengurangi beban manajemen, serta meningkatkan efisiensi. Manfaat utamanya meliputi:

  • Operasi batch yang efisien: Untuk kelompok besar resource terkait—seperti halaman fitur berita yang memiliki ratusan gambar serta beberapa file JS atau CSS—tetapkan tag yang sama ke seluruh resource tersebut, lalu lakukan purge terhadap seluruh kelompok hanya dengan satu aksi.

  • Efisiensi O&M yang lebih baik: Tim operasi dan pengembangan tidak perlu lagi melacak setiap URL resource. Mereka cukup fokus pada pengelompokan logis—yaitu tag—untuk mengurangi kompleksitas dan menghindari kelalaian URL.

  • Fleksibilitas bisnis yang lebih tinggi: Dalam aplikasi yang sama, tetapkan tag berbeda untuk skenario berbeda. Purge berdasarkan tag hanya memengaruhi skenario tertentu—misalnya halaman promosi penjualan—tanpa mengganggu skenario lainnya.

  • Pengalaman pengguna yang konsisten: Pastikan resource yang saling terkait erat—seperti halaman frontend dan aset statis pendukungnya—diperbarui secara bersamaan guna menghindari ketidaksesuaian seperti halaman baru dengan gaya lama atau data yang sebagian sudah kedaluwarsa.

Kasus penggunaan

Kasus penggunaan umum meliputi:

  • Memperbarui halaman promosi penjualan e-commerce dan aset terkait

  • Menonaktifkan konten topik khusus di situs berita atau media

  • Mengganti konten untuk situs multibahasa atau multi-versi

  • Membersihkan resource sub-aplikasi dalam arsitektur micro-frontend

Cara kerja

ESA menggunakan Header HTTP sebagai cache tag. Cache tag terdiri dari nama header dan nilai header yang dipisahkan oleh tanda titik dua:, contohnya Cache-Tag:tag1,tag2,tag3. Saat Anda mengirimkan tugas untuk purge cache berdasarkan tag:

image
  1. ESA pertama-tama menentukan apakah file cache di POP ditandai dengan cache tag (default adalah Cache-Tag). Jika cache tag tidak ada, ESA melewati operasi purge. Jika ada, ESA mencocokkan nilai cache tag tersebut.

  2. ESA memeriksa apakah nilai tag pada file cache sesuai dengan Purge Content yang Anda kirimkan. Jika tidak cocok, ESA melewati purge. Jika cocok, ESA melakukan purge cache (perilaku default: Mark as Expired).

Catatan

ESA mendukung penetapan beberapa nilai cache tag untuk resource yang sama, dengan nilai-nilai dipisahkan oleh koma bahasa Inggris. Saat terdapat beberapa nilai cache tag, POPs ESA melakukan normalisasi terhadap nilai cache tag yang diterima:

  • Menghapus spasi tambahan: tag1, tag2 dan tag1,tag2 dianggap identik.

  • Menghapus koma duplikat: tag1,,,tag2 dan tag1,tag2 dianggap identik.

Prasyarat

Fitur Purge cache berdasarkan tag dari ESA bekerja dengan memeriksa apakah konten cache di POPs ESA mengandung cache tag tertentu. Oleh karena itu, saat menggunakan fitur ini, Anda harus mengonfigurasi origin server untuk menambahkan response header yang sesuai dengan cache tag untuk resource Anda. Untuk metode konfigurasinya, lihat berikut ini:

Tambahkan header cache tag di origin Anda

Contohnya, tambahkan Header respons HTTP Cache-Tag ke resource di direktori /images:

Catatan

Secara default, purge berbasis tag mencocokkan header Cache-Tag dan bersifat case-sensitive. Untuk menggunakan header kustom, lihat Konfigurasi cache tag kustom.

# /etc/nginx/nginx.conf

server {
    listen 80;
    server_name your-origin-domain.com;
    # Tambahkan tag ke semua resource di bawah /images/
    location /images/ {
        add_header Cache-Tag "images";
        # ... konfigurasi lainnya
    }
    # ... blok location lainnya
}

Jika Anda tidak dapat menetapkan response header di sumber, Anda juga dapat menggunakan fitur ESA Modify Inbound Response Header untuk menerapkan konfigurasi di atas:

  1. Di Konsol ESA, pilih Site Management. Di kolom Website, klik situs target Anda.

  2. Di panel navigasi sebelah kiri, pilih Rules > Transform Rules.

  3. Pilih tab Modify Response Header. Di bawah Origin to ESA, klik Create Rule. Lalu konfigurasikan parameter berikut:

    • Rule Name: Masukkan nama kustom, misalnya add_header_cache-tag

    • Filtered Requests: Masukkan URI path equals /images

    • Modify Response Header: Tambahkan static header Cache-Tag: images

    image

Prosedur

  1. Di Konsol ESA, pilih Site Management. Pada kolom Website, klik situs target Anda.

  2. Di panel navigasi sebelah kiri, pilih Caching > Purge Cache.

  3. Di tab Purge Cache, konfigurasikan aturan purge dan klik Submit:

    • Type: Pilih By Tag.

    • Purge Content: Masukkan nilai tag untuk melakukan purge. Pisahkan beberapa nilai dengan ,, seperti images.

      Method

      Description

      Mark as Expired

      Jika pengguna meminta konten yang sesuai dengan resource yang akan di-purge, node ESA pertama-tama melakukan origin fetch untuk mendapatkan informasi Last-Modified resource tersebut. Jika sesuai dengan resource cache, resource cache dikembalikan. Jika tidak, node mengambil resource baru dari origin, mengembalikannya ke pengguna, dan menyimpan cache resource baru tersebut.

      Delete

      Jika pengguna meminta konten yang sesuai dengan resource yang akan di-purge, node ESA langsung melakukan origin fetch untuk mengambil resource baru, mengembalikannya ke pengguna, dan menyimpan cache resource baru tersebut.

    • Purge Content: Masukkan nilai tag yang akan di-purge. Pisahkan beberapa nilai dengan ,, misalnya images.

    image

  4. Setelah mengirimkan tugas purge, Anda dapat melihat catatan detail dan progres purge resource di tab Purge Records. Tugas purge selesai ketika progres mencapai 100%. Progres bervariasi tergantung jumlah objek yang ingin Anda purge. Tugas purge mungkin memerlukan waktu untuk diselesaikan.

    image

Contoh purge cache

Saat Anda memperbarui file gambar atau halaman di situs web e-commerce, Anda perlu menghapus file tersebut dan membersihkan cache ESA yang sesuai. Situs web e-commerce mungkin memiliki banyak versi potongan gambar dalam ukuran berbeda. Saat Anda menghapus gambar, mencantumkan semua versi potongannya secara manual tidak praktis. Oleh karena itu, Anda dapat menghapus file gambar dan cache ESA terkait secara batch berdasarkan nama gambar. Selain itu, saat mempersiapkan acara promosi, Anda perlu terus-menerus melakukan iterasi pada halaman acara selama pengembangan. Saat menerbitkan versi baru halaman, Anda dapat menghapus semua file terkait dan cache ESA terkait berdasarkan versi tertentu. Purge cache berdasarkan tag secara signifikan meningkatkan efisiensi manajemen cache:

Purge berdasarkan nama gambar

Skenario

Tiga gambar berikut merupakan versi potongan dari gambar asli dog.jpg. Origin menambahkan tag ESA-Cache-Tag:dog.jpg ke respons untuk ketiganya:

  • dog_100_200.jpg

  • dog_200_200.jpg

  • dog_300_200.jpg

Tiga gambar berikut merupakan versi potongan dari gambar asli cat.jpg. Origin menambahkan tag ESA-Cache-Tag:cat.jpg ke respons untuk ketiganya:

  • cat_100_200.jpg

  • cat_200_200.jpg

  • cat_300_200.jpg

Hapus gambar asli dan purge semua varian cache secara bersamaan.

Contoh konfigurasi

  1. Di Konsol ESA, pilih Site Management. Pada kolom Website, klik situs target Anda.

  2. Di panel navigasi sebelah kiri, pilih Caching > Settings.

  3. Di bagian Cache Tag, klik tombol Configuration di sebelah kanan.

  4. Konfigurasikan Tag Name dan parameter case-insensitive untuk nilai tag:

    • Tag Name: Pilih Use Custom Cache Tag Name dan masukkan nama tag kustom ESA-Cache-Tag.

    • Ignore Case: Aktifkan atau nonaktifkan pengaturan ini sesuai kebutuhan.

    image

  5. Di panel navigasi sebelah kiri, pilih Caching > Purge Cache.

  6. Di tab Purge Cache, konfigurasikan aturan purge dan klik Submit:

    • Type: Pilih By Tag.

    • Purge Method: Pilih Delete.

    • Purge Content: Masukkan nilai tag yang akan di-purge: cat.jpg,dog.jpg.

    image

Purge berdasarkan nomor versi

Skenario

Enam gambar berikut dihasilkan untuk versi v0820. Origin menambahkan tag ESA-Cache-Tag:v0820 ke respons untuk keenamnya:

  • dog_100_200_v0820.jpg

  • dog_200_200_v0820.jpg

  • dog_300_200_v0820.jpg

  • cat_100_200_v0820.jpg

  • cat_200_200_v0820.jpg

  • cat_300_200_v0820.jpg

Contoh konfigurasi

  1. Di Konsol ESA, pilih Site Management. Pada kolom Website, klik situs target Anda.

  2. Di panel navigasi sebelah kiri, pilih Caching > Settings.

  3. Di bagian Cache Tag, klik tombol Configuration di sebelah kanan.

  4. Konfigurasikan Tag Name dan parameter case-insensitive untuk nilai tag:

    • Tag Name: Pilih Use Custom Cache Tag Name dan masukkan nama tag kustom ESA-Cache-Tag.

    • Ignore Case: Aktifkan atau nonaktifkan pengaturan ini sesuai kebutuhan.

    image

  5. Di panel navigasi sebelah kiri, pilih Caching > Purge Cache.

  6. Di tab Purge Cache, konfigurasikan aturan purge dan klik Submit:

    • Type: Pilih By Tag.

    • Purge Method: Pilih Delete.

    • Purge Content: Masukkan nilai tag yang akan di-purge: v0820.

    image

Cache tag deskripsi

Nama cache tag

  • Nama default adalah Cache-Tag.

  • Nama cache tag kustom harus terdiri dari 1 hingga 64 karakter.

  • Nama cache tag kustom dapat berisi huruf kapital (A–Z), huruf kecil (a–z), angka (0–9), dan tanda hubung (-).

Nilai cache tag

  • Mendukung beberapa nilai cache tag. Pisahkan nilai dengan ,.

  • Panjang minimum adalah 1 byte.

  • Tidak ada batas panjang maksimum per nilai.

  • Jumlah nilai tag cache dibatasi hingga 1000.

  • Nilai harus hanya berisi karakter berkode UTF-8.

  • Nilai CacheTag secara default bersifat case-sensitive. Anda dapat mengonfigurasinya agar tidak case-sensitive menggunakan Konfigurasi Cache Tag.

Ketersediaan

Batas

Entrance

Pro

Premium

Enterprise

Batas kuota harian (satuan: tugas)

Tidak didukung

Tidak didukung

Tidak didukung

2000