Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Lihat
Dokumentasi Apigee Edge.
Fitur persistensi Apigee mencakup cache, peta nilai kunci, dan kumpulan properti. Jika menggunakan Apigee Hybrid, Anda dapat menggunakan secret Kubernetes untuk mempertahankan data sensitif.
| Fitur | Gunakan |
|---|---|
| Cache | Dengan menggunakan kebijakan untuk caching tujuan umum, Anda dapat mempertahankan objek apa pun di proxy Anda
diperlukan di beberapa sesi permintaan/respons. Anda juga bisa meng-cache respons suatu
resource backend dengan
kebijakan ResponseCache. Cache respons sangat membantu saat backend
data hanya diperbarui secara berkala. Kebijakan ResponseCache dapat mengurangi panggilan ke backend
sumber data. |
| Peta nilai kunci | Peta nilai kunci (KVM) menyediakan penyimpanan runtime umum untuk data yang dapat berubah secara berkala. Misalnya: data sesi pengguna, keranjang belanja, dll. entri KVM dapat dienkripsi. |
| Kumpulan properti | Kumpulan properti cocok untuk menyimpan data konfigurasi yang tidak sering berubah. |
| Rahasia Kubernetes | (Khusus Apigee Hybrid) Menggunakan Rahasia untuk menyimpan data sensitif seperti kredensial pengguna. |
Menyimpan data ke dalam cache
Resource cache cakupan lingkungan dibuat secara dinamis saat kebijakan cache dijalankan dalam alur proxy API. Kebijakan cache mencakup kebijakan FillCache, Kebijakan LookupCache, kebijakan InvalidateCache, dan Kebijakan ResponseCache.
Item yang di-cache tetap berada dalam memori (L1) selama satu detik. Anda tidak dapat mengubah konfigurasi ini. Setelah satu detik, objek yang di-cache ditempatkan dalam database (L2) tempat objek tersebut tersedia hingga cache tersebut tidak berlaku lagi. Untuk mengetahui detailnya, lihat Tingkat cache persisten dalam memori. Anda mengelola detail cache, seperti waktu habis masa berlaku, melalui konfigurasi kebijakan cache. Disediakan Apigee API yang memungkinkan Anda mencantumkan dan menghapus resource cache.
Saat menggunakan kebijakan cache, Anda memastikan keunikan kunci nilai yang di-cache dengan mengonfigurasi kunci cache. Kunci cache, bersama dengan nilai lain yang dapat Anda mengkonfigurasi, memberi Anda cara yang andal untuk mendapatkan data yang sama dengan yang Anda masukkan. Ukuran cache dan ketersediaannya tunduk kepada batas tertentu.
Anda dapat menggunakan cache untuk:
- Mengurangi latensi dan traffic. Permintaan dipenuhi dalam waktu yang lebih singkat dan dengan representasi yang digunakan kembali.
- Mempertahankan data di seluruh transaksi. Anda dapat menyimpan data sesi untuk digunakan kembali di seluruh transaksi HTTP.
- Mendukung keamanan. Akses cakupan ke entri cache agar dapat diakses hanya di lingkungan tertentu atau oleh proxy API tertentu.
Cache respons backend
Anda dapat meng-cache respons resource backend dengan
kebijakan ResponseCache.
Hal ini sangat membantu ketika data backend hanya diperbarui secara berkala. ResponseCache
kebijakan ini dapat mengurangi panggilan ke sumber data backend.
Melalui kebijakan ResponseCache, Anda juga dapat meminta Apigee melihat cache respons HTTP tertentu
{i>header<i} dan mengambil tindakan
sesuai dengan perintah {i>header<i}. Misalnya, pada respons dari backend
target, Apigee mendukung header Cache-Control. {i>Header<i} ini dapat digunakan untuk mengontrol
usia maksimum respons yang di-cache, di antara hal-hal lainnya. Untuk informasi selengkapnya, lihat
Dukungan untuk header respons HTTP.
Penyimpanan cache tujuan umum jangka pendek
Dengan menggunakan kebijakan untuk caching tujuan umum, Anda dapat mempertahankan objek apa pun yang diperlukan proxy Anda di beberapa sesi permintaan/respons.
Dengan PopulateCache
kebijakan, LookupCache
kebijakan, dan kebijakan InvalidateCache,
Anda bisa mengisi, mengambil, dan menghapus data yang di-cache saat runtime.
Misalnya, Anda dapat menyimpan untuk sementara:
- ID sesi untuk pengelolaan sesi.
- Kredensial untuk panggilan keluar (seperti kunci API atau token akses OAuth).
- Konten respons yang harus diberi nomor halaman untuk aplikasi.
Saat runtime, kebijakan cache Anda menyalin nilai antara variabel proxy dan cache yang dikonfigurasi yang Anda tentukan. Bila nilai ditempatkan dalam cache, nilai tersebut akan disalin dari variabel yang Anda tentukan untuk cache. Ketika diambil dari cache, data akan disalin ke variabel untuk digunakan oleh {i>proxy<i}.
Untuk contoh dengan kode, lihat Contoh: Penyimpanan dalam cache tujuan umum.
Mengelola cache dengan Apigee API
Anda dapat menampilkan daftar dan menghapus cache menggunakan caches API.
Persistensi jangka panjang dengan peta nilai kunci (KVM)
Untuk menyimpan data terstruktur yang dienkripsi atau tidak dienkripsi tanpa batas waktu, Anda dapat membuat dan mengisi peta nilai kunci (KVM) yang berisi key-value pair arbitrer. Sebagai contoh, Anda mungkin toko:
- Peta yang menghubungkan alamat IP dengan kode negara.
- Daftar alamat IP yang diizinkan/ditolak akses.
- Peta yang menghubungkan URL panjang dengan URL yang disingkat.
- Data khusus lingkungan, seperti jumlah kuota dan waktu habis masa berlaku token OAuth.
KVM dapat memiliki salah satu dari tiga cakupan: organisasi, lingkungan, apiproxy. Misalnya, jika key-value pair akan digunakan untuk semua API di organisasi, buat KVM di organisasi scope; atau jika hanya proxy API tertentu yang dapat mengakses kunci/nilai, buat KVM di cakupan apiproxy. Untuk mengetahui informasi selengkapnya, lihat Menggunakan peta nilai kunci.
Kumpulan properti
Kumpulan properti adalah kumpulan kustom key-value pair yang menyimpan data. Proxy API dapat mengambil data ini saat dijalankan.
Biasanya, Anda menggunakan kumpulan properti untuk menyimpan data yang tidak akan kedaluwarsa yang tidak hard code dalam logika proxy API Anda, seperti data konfigurasi. Anda dapat mengakses data kumpulan properti di mana saja di proxy tempat Anda dapat mengakses variabel flow.
Kasus penggunaan umum untuk kumpulan properti adalah memberikan nilai yang yang terkait dengan satu lingkungan atau lingkungan lainnya. Sebagai contoh, Anda dapat membuat set properti cakupan lingkungan dengan nilai konfigurasi yang khusus untuk {i>proxy<i} yang berjalan di lingkungan pengujian Anda, dan yang ditetapkan untuk lingkungan produksi.
Untuk informasi selengkapnya, lihat Menggunakan kumpulan properti.
Rahasia Kubernetes
(Khusus Apigee Hybrid) Jika Anda sudah menggunakan Kubernetes untuk pengelolaan secret di vault kustom untuk data, sebaiknya pertimbangkan untuk menggunakan Kubernetes Secrets. Sama seperti data KVM, Anda dapat mengakses data secret Kubernetes dalam variabel alur proxy API. Untuk mengetahui informasi selengkapnya, lihat Menyimpan data di secret Kubernetes.