Menggunakan cache eksternal yang kompatibel dengan Redis di Azure API Management

  • Artikel

BERLAKU UNTUK: Semua tingkatAN API Management

Selain menggunakan cache bawaan, Azure API Management memperbolehkan respons penembolokan di cache eksternal yang kompatibel dengan Redis, misalnya Azure Cache for 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 informasi lebih terperinci mengenai cache, lihat kebijakan pembuatan cache API Management dan Pembuatan cache kustom di Azure API Management.

Bawa cache Anda sendiri ke APIM

Yang akan Anda pelajari:

  • Menambahkan cache eksternal di API Management

Prasyarat

Untuk menyelesaikan tutorial ini, Anda perlu:

Membuat Azure Cache for Redis

Bagian ini menjelaskan cara membuat Azure Cache for Redis di Azure. Jika Anda sudah memiliki Azure Cache for Redis, atau cache kompatibel Redis lainnya di dalam atau di luar Azure, Anda bisa lompati ke bagian berikutnya.

  1. Untuk membuat cache, masuk ke portal Azure dan pilih Buat sumber daya.

    Membuat sumber daya disorot di panel navigasi kiri.

  2. Di halaman Baru, pilih Database, lalu pilih Azure Cache for Redis.

    Di Baru, Database disorot, dan Azure Cache for Redis disorot.

  3. Pada halaman Cache Redis Baru, konfigurasikan pengaturan untuk cache baru Anda.

    Pengaturan Pilih nilai Deskripsi
    Langganan Buka menu drop-down dan pilih langganan Anda. Langganan untuk membuat instans Azure Cache for Redis baru ini.
    Grup sumber daya Buka drop down dan pilih grup sumber daya, atau pilih Buat baru dan masukkan nama grup sumber daya baru. Nama untuk grup sumber daya tempat membuat cache dan sumber daya lainnya. Dengan menyatukan semua sumber daya aplikasi dalam satu grup sumber daya, Anda dapat dengan mudah mengelola atau menghapusnya sekaligus.
    Nama DNS Masukkan nama yang unik. Nama cache harus merupakan untai (karakter) antara 1 dan 63 karakter yang hanya berisi angka, huruf, atau tanda hubung. Nama harus dimulai dan diakhiri dengan angka atau huruf, dan tidak boleh berisi tanda hubung berturut-turut. Nama host instans cache Anda adalah <DNS name.redis.cache.windows.net>.
    Location Buka drop down dan pilih lokasi. Pilih wilayah di dekat layanan lain yang menggunakan cache Anda.
    Jenis cache Buka menu drop down dan pilih tingkat. Tingkat menentukan ukuran, performa, dan fitur yang tersedia untuk cache tersebut. Untuk informasi selengkapnya, lihat Gambaran Umum Azure Cache for Redis.

  4. Pilih tab Jaringan atau pilih tombol Jaringan di bagian bawah halaman.

  5. Di tab Jaringan, pilih metode konektivitas Anda.

  6. Pilih tab Berikutnya: Tingkat Lanjut atau pilih tombol Berikutnya: Tingkat Lanjut di bagian bawah halaman untuk melihat tab Tingkat Lanjut .

    Cuplikan layar memperlihatkan tab Tingkat Lanjut di panel kerja dan opsi yang tersedia untuk dipilih.

    • Untuk cache Dasar atau Standar, alihkan pilihan untuk port non-TLS. Anda juga dapat memilih apakah Anda ingin mengaktifkan Autentikasi Microsoft Entra.
    • Untuk cache Premium, konfigurasikan pengaturan untuk port non-TLS, pengklusteran, identitas terkelola, dan persistensi data. Anda juga dapat memilih apakah Anda ingin mengaktifkan Autentikasi Microsoft Entra.

  7. Pilih tab Berikutnya: Tag atau pilih tombol Berikutnya: Tag di bagian bawah halaman.

  8. Secara opsional, di tab Tag, masukkan nama dan nilai jika Anda ingin mengategorikan sumber daya.

  9. Pilih Tinjau + buat. Anda dibawa ke tab Tinjau + buat tempat Azure memvalidasi konfigurasi Anda.

  10. Setelah pesan lulus Validasi warna hijau muncul, pilih Buat.

Dibutuhkan beberapa saat untuk membuat cache. Anda dapat memantau kemajuan di halaman Gambaran Umum Azure Cache for Redis. Ketika Status muncul sebagai Sedang Berjalan, cache siap digunakan.

Menyebarkan cache Redis ke Kubernetes

Untuk gateway yang di-hosting sendiri, penembolokan membutuhkan 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.

Cuplikan layar yang menunjukkan cara menambahkan Azure Cache for Redis eksternal di Azure API Management.

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 akan digantikan 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 akan menggunakan cache sendiri, sementara dua wilayah lainnya akan 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.

Tambahkan Azure Cache for Redis dari langganan yang sama

  1. Telusuri ke instans API Management Anda di portal Microsoft Azure.
  2. Pilih tab Cache eksternal dari menu di sebelah kiri.
  3. Pilih tombol +Tambahkan.
  4. Pilih cache Anda di bidang dropdown Instan cache.
  5. Pilih Default atau tentukan wilayah yang diinginkan di bidang turun-bawahGunakan dari.
  6. Pilih Simpan.

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. Pilih tab Cache eksternal dari menu di sebelah kiri.
  3. Pilih tombol +Tambahkan.
  4. Pilih Kustom di bidang turun drop-down Instans cache.
  5. Pilih Default atau tentukan wilayah yang diinginkan di bidang turun-bawahGunakan dari.
  6. Berikan string koneksi Azure Cache for Redis Anda (atau cache kompatibel Redis) di bidang String koneksi.
  7. Pilih Simpan.

Tambahkan cache Redis ke gateway yang dihosting sendiri

  1. Telusuri ke instans API Management Anda di portal Microsoft Azure.
  2. Pilih tab Cache eksternal dari menu di sebelah kiri.
  3. Pilih tombol +Tambahkan.
  4. Pilih Kustom di bidang turun drop-down Instans cache.
  5. Tentukan lokasi gateway yang dihosting sendiri yang diinginkan atau Default di bidang dropdown Gunakan dari.
  6. Berikan string koneksi cache Redis di bidang String koneksi.
  7. 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.

Langkah berikutnya