Menggunakan cache eksternal yang kompatibel dengan Redis di Azure API Management

BERLAKU UNTUK: SEMUA TIER API Management

Selain menggunakan cache bawaan, Azure API Management memungkinkan penembolokan respons dalam cache kompatibel Redis eksternal, seperti Azure Managed Redis.

Menggunakan cache eksternal memungkinkan Anda mengatasi beberapa batasan cache bawaan:

• Menghindari menghapus cache Anda secara berkala selama pembaruan API Management
• Memiliki kontrol lebih besar atas konfigurasi cache Anda
• Cache lebih banyak data dari yang diizinkan tingkat API Management Anda
• Gunakan cache dengan tingkat Konsumsi API Management
• Aktifkan caching di gateway API Management yang di-hosting sendiri

Untuk latar belakang dan skenario untuk penembolokan, lihat Gambaran umum penembolokan.

Untuk informasi lebih terperinci mengenai cache, lihat kebijakan pembuatan cache API Management dan Pembuatan cache kustom di Azure API Management.

Catatan

Saat ini, fitur ini tidak tersedia di ruang kerja.

Yang akan Anda pelajari:

• Menambahkan cache eksternal di API Management

Prasyarat

Untuk menyelesaikan tutorial ini, Anda perlu:

• Buat sebuah instans API Management Azure

• Memahami pembuatan cache di Azure API Management

• Pastikan Azure Managed Redis atau cache lain yang kompatibel dengan Redis tersedia.

  Penting

  Azure API Management menggunakan string koneksi Redis untuk terhubung ke cache. Jika Anda menggunakan Azure Managed Redis, aktifkan autentikasi kunci akses di cache Anda untuk menggunakan string koneksi. Saat ini, Anda tidak dapat menggunakan autentikasi Microsoft Entra untuk menyambungkan Azure API Management ke Azure Managed Redis.

Cache Redis untuk Kubernetes

Untuk gateway API Management yang dipasang sendiri, caching memerlukan cache eksternal. Agar caching efektif, gateway yang di-hosting sendiri dan cache yang diandalkannya harus berada dekat satu sama lain untuk meminimalkan latensi pencarian dan penyimpanan. Menyebarkan cache Redis ke dalam kluster Kubernetes yang sama atau di kluster terpisah di dekatnya adalah opsi terbaik. Pelajari cara menyebarkan cache Redis ke kluster Kubernetes.

Menambahkan cache eksternal

Ikuti langkah-langkah berikut untuk menambahkan cache kompatibel Redis di Azure API Management. Anda dapat membatasi cache ke gateway tertentu di instans API Management Anda.

Gunakan dari pengaturan

Pengaturan Gunakan dari dalam konfigurasi menentukan lokasi instans API Management Anda yang akan menggunakan cache. Pilih salah satu pilihan berikut:

• Wilayah Azure tempat instans API Management dihostkan (atau salah satu lokasi yang dikonfigurasi, jika Anda memiliki penyebaran multi-wilayah)

• Lokasi gateway yang di-hosting sendiri.

• Default, untuk mengonfigurasi cache sebagai default untuk semua lokasi gateway dalam instans API Management

  Cache yang digunakan untuk Default ditimpa oleh cache yang digunakan untuk wilayah atau lokasi yang sesuai dengan kriteria tertentu.

  Misalnya, mempertimbangkan instans API Management yang dihosting di wilayah US Timur, Asia Tenggara, dan Eropa Barat. Ada dua cache yang dikonfigurasi, satu untuk Default dan satu untuk Asia Tenggara. Dalam contoh ini, API Management di Asia Tenggara menggunakan cache sendiri, sementara dua wilayah lainnya menggunakan entri cache Default .

Catatan

Anda dapat mengonfigurasi cache eksternal yang sama untuk instans API Management yang lebih dari satu. Instans API Management dapat berada di wilayah yang sama atau berbeda. Saat berbagi cache untuk lebih dari satu instans, Anda harus memilih Default di pengaturan Gunakan dari.

Menambahkan instans Azure Managed Redis dari langganan yang sama

1. Telusuri ke instans API Management Anda di portal Microsoft Azure.
2. Di menu sebelah kiri, di bawah Penyebaran + infrastruktur pilih Cache eksternal.
3. Pilih + Tambah.
4. Di menu dropdown Instans Cache, pilih cache Anda.
5. Di menu dropdown Gunakan dari, pilih Default atau tentukan wilayah yang diinginkan. String Koneksi diisi secara otomatis.
6. Pilih Simpan.

Catatan

String koneksi default dalam bentuk <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False. API Management menyimpan string sebagai nilai bernama rahasia. Jika Anda perlu melihat atau mengedit string untuk memutar kunci akses atau memecahkan masalah koneksi, buka panel Nilai Bernama.

Tambahkan cache yang kompatibel dengan Redis yang di-host di luar langganan Azure saat ini atau Azure secara umum

1. Telusuri ke instans API Management Anda di portal Microsoft Azure.
2. Di menu sebelah kiri, di bawah Penyebaran + infrastruktur pilih Cache eksternal.
3. Pilih + Tambah.
4. Pada Dropdown Instance Cache, pilih Kustom.
5. Di menu dropdown Gunakan dari, pilih Default atau tentukan wilayah yang diinginkan.
6. Masukkan string koneksi dari Azure Managed Redis atau cache yang kompatibel dengan Redis ke dalam bidang String koneksi.
7. Pilih Simpan.

Tambahkan cache Redis ke gateway yang dihosting sendiri

1. Di menu sebelah kiri, di bawah Penyebaran + infrastruktur pilih Cache eksternal.
2. Pilih + Tambah.
3. Pada Dropdown Instance Cache, pilih Kustom.
4. Di menu dropdown Gunakan dari, pilih Default atau tentukan wilayah yang diinginkan.
5. Masukkan string koneksi cache Redis Anda di kolom Connection string.
6. Pilih Simpan.

Gunakan cache eksternal

Setelah menambahkan cache yang kompatibel dengan Redis, konfigurasikan kebijakan cache untuk mengaktifkan cache respons, atau cache nilai menurut kunci, di cache eksternal.

Untuk contoh yang rinci, lihat Menambahkan cache untuk meningkatkan performa di Azure API Management.

Konten terkait

• Untuk informasi selengkapnya tentang kebijakan cache, lihat Kebijakan pembuatan cache di dalam referensi kebijakan API Management.
• Untuk item cache berdasarkan kunci menggunakan ekspresi kebijakan, lihat Penembolokan kustom di Azure API Management.
• Pelajari cara mengaktifkan cache semantik untuk API LLM.