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 Secret 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 disimpannya. Tabel berikut merangkum cakupan yang tersedia untuk setiap mekanisme persistensi. Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Tentang cakupan persistensi dan Cakupan kumpulan 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 sesuai 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 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 terdokumentasi).
- Anda memiliki entri yang tidak diketahui pada waktu desain.
Misalnya, gunakan KVM untuk menyimpan data sesi pengguna saat pengguna login dan menghapusnya saat pengguna logout.
Kapan harus menggunakan kumpulan properti
Pertimbangkan untuk menggunakan set properti jika:
- Kunci dan nilai diketahui pada waktu desain. Nilai kumpulan properti tidak dapat diubah oleh proxy API saat berjalan. Variabel ini tersedia dalam alur proxy sebagai variabel hanya baca.
- Anda memiliki beberapa hingga beberapa ratus kunci (<110 KB total). Kunci dan nilai kumpulan properti selalu disimpan dalam memori untuk akses cepat.
- Anda ingin kemudahan yang memungkinkan administrator mengubah kumpulan properti di lingkungan tanpa men-deploy ulang proxy API.
Misalnya, kumpulan 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 dibagikan oleh beberapa proxy API yang di-deploy di lingkungan. Set properti juga dapat menjadi pilihan yang baik untuk menyimpan kunci publik dan sertifikat.
Kapan menggunakan Secret Kubernetes
Opsi ini hanya tersedia dengan Apigee hybrid. Hal ini memungkinkan proxy API mengakses data yang disimpan di Kubernetes Secrets. Opsi ini mirip dengan set properti, tempat data yang disimpan tersedia sebagai variabel alur pesan dalam proxy yang dieksekusi. Namun, data selalu tetap berada dalam platform runtime; data tidak pernah ditetapkan ke platform pengelolaan di cloud Apigee.
Pertimbangkan untuk menggunakan Secret Kubernetes jika:
- Anda perlu menyimpan informasi sensitif yang tidak ingin disimpan di platform manajemen. Misalnya, Anda dapat menggunakan Secret Kubernetes untuk menyimpan kunci pribadi atau kredensial yang diperlukan untuk mengakses sistem eksternal.
- Anda perlu membagikan data yang disimpan dengan beberapa proxy API yang di-deploy di lingkungan yang sama.