Menggunakan cache eksternal yang kompatibel dengan Redis di Azure API Management

BERLAKU UNTUK: Semua tingkatAN 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 pembuatan cache dengan tingkat Konsumsi API Management
• Aktifkan penembolokan 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 redis string koneksi untuk menyambungkan 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 yang dihost sendiri API Management, penembolokan memerlukan cache eksternal. Agar penembolokan menjadi gateway yang di-hosting sendiri yang efektif dan cache yang diandalkan harus berada dekat satu sama lain untuk meminimalkan pencarian dan menyimpan latensi. 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.

Pengaturan gunakan dari

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 dihosting (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 pencocokan 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.

Tambahan cache kompatibel Redis yang di-hosting 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. Di menu dropdown Instans 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. Di menu dropdown Instans cache, pilih Kustom.
4. Di menu dropdown Gunakan dari, pilih Default atau tentukan wilayah yang diinginkan.
5. Masukkan string koneksi cache Redis Anda di bidang String koneksi.
6. Pilih Simpan.

Gunakan cache eksternal

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

Untuk contoh yang lengkap, lihat Tambahkan penembolokan 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 penembolokan semantik untuk API Azure OpenAI.