Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Lihat dokumentasi
Apigee Edge.
Developer proxy API biasanya menggunakan satu atau beberapa mekanisme persistensi data Apigee untuk menyimpan data konfigurasi sehingga mereka dapat mengaksesnya nanti di proxy API. Topik ini membahas cara memilih mekanisme persistensi yang tepat, bergantung pada kasus penggunaan Anda.
Mekanisme persistensi
Tabel berikut menjelaskan secara singkat mekanisme persistensi yang tersedia di Apigee:| Mekanisme | Gunakan |
|---|---|
| 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. Lihat juga Menggunakan peta nilai kunci. |
| Kumpulan properti | Set properti cocok untuk menyimpan data konfigurasi yang tidak sering berubah. Lihat juga Menggunakan set properti. |
| Secret Kubernetes | (Khusus Apigee Hybrid) Gunakan Secrets untuk menyimpan data sensitif seperti kredensial pengguna. Lihat juga Menyimpan data di Secret Kubernetes. |
Cakupan mekanisme persistensi
Setiap mekanisme persistensi yang tersedia memiliki cakupan tertentu yang menentukan tempat Anda dapat mengakses data yang tersimpan. Tabel berikut merangkum cakupan yang tersedia untuk setiap mekanisme persistensi. Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Tentang cakupan persistensi dan Cakupan set properti.
| Organisasi | Lingkungan | Proxy API | |
|---|---|---|---|
| Peta Nilai Kunci | Ya | Ya | Ya |
| Kumpulan properti | Tidak | Ya | Ya |
| Secret Kubernetes | Tidak | Ya | Tidak |
Menentukan mekanisme persistensi yang akan digunakan
Bagian ini menjelaskan kasus penggunaan untuk setiap mekanisme persistensi guna membantu Anda memutuskan mana yang paling cocok untuk menyimpan data konfigurasi.
Kapan harus menggunakan Peta Nilai Kunci
Apigee tidak menyediakan API untuk menyimpan, memperbarui, atau menghapus data KVM. Anda harus melakukan tugas ini menggunakan kebijakan KeyValueMapOperations. Kebijakan ini memungkinkan Anda melakukan operasi KVM saat runtime, saat proxy sedang dieksekusi.
Pertimbangkan untuk menggunakan KVM jika:
- Anda memiliki ribuan, ratusan ribu, atau jutaan entri peta nilai kunci (jumlah apa pun hingga batas ukuran KVM yang didokumentasikan).
- Anda memiliki entri yang tidak diketahui pada waktu desain.
Misalnya, gunakan KVM untuk menyimpan data sesi pengguna saat pengguna login dan hapus data tersebut saat pengguna logout.
Kapan harus menggunakan set properti
Pertimbangkan untuk menggunakan set properti saat:
- Kunci dan nilai diketahui pada waktu desain. Nilai set properti tidak dapat diubah oleh proxy API saat sedang berjalan. Variabel ini tersedia dalam alur proxy sebagai variabel hanya baca.
- Anda memiliki beberapa hingga beberapa ratus kunci (total <110 KB). Kunci dan nilai set properti selalu disimpan dalam memori untuk akses cepat.
- Anda menginginkan kemudahan untuk mengizinkan administrator mengubah set properti di lingkungan tanpa men-deploy ulang proxy API.
Misalnya, set properti cocok untuk menyimpan aturan rute. Aturan rute adalah pasangan kunci/nilai dengan nilai berupa URL endpoint target. Nilai ini biasanya bervariasi di antara lingkungan dan dapat digunakan bersama oleh beberapa proxy API yang di-deploy di suatu lingkungan. Kumpulan properti juga dapat menjadi pilihan yang baik untuk menyimpan kunci publik dan sertifikat.
Kapan Secret Kubernetes digunakan
Opsi ini hanya tersedia dengan Apigee hybrid. Kebijakan ini memungkinkan proxy API mengakses data yang disimpan di Secret Kubernetes. Opsi ini mirip dengan set properti, di mana data yang disimpan tersedia sebagai variabel alur pesan dalam proxy yang dieksekusi. Namun, data selalu berada dalam bidang runtime; data tidak pernah ditetapkan ke bidang pengelolaan di cloud Apigee.
Pertimbangkan untuk menggunakan Secret Kubernetes saat:
- Anda perlu menyimpan informasi sensitif yang tidak boleh disimpan di bidang pengelolaan. Misalnya, Anda dapat menggunakan Secret Kubernetes untuk menyimpan kunci pribadi atau kredensial yang diperlukan untuk mengakses sistem eksternal.
- Anda perlu membagikan data tersimpan dengan beberapa proxy API yang di-deploy di lingkungan yang sama.