Anda melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Apigee Edge menyertakan beberapa paket ekstensi yang diinstal. Sebelum dapat menggunakan ekstensi dalam proxy API dengan kebijakan Panggilan Ekstensi, Anda harus menambahkan dan mengonfigurasi ekstensi. Saat menambahkan ekstensi, Anda akan menemukan paket ekstensi yang mewakili resource eksternal yang ingin diintegrasikan dengan proxy API, menambahkan dan mengonfigurasi ekstensi dari paket tersebut, serta men-deploy ekstensi ke lingkungan Edge.
Saat mengonfigurasi ekstensi dari paket ekstensi, Anda akan menentukan nilai yang memfokuskan interaksi ekstensi dengan resource eksternalnya. Misalnya, saat mengonfigurasi Ekstensi Google Cloud Firestore, Anda akan menentukan database yang harus digunakan ekstensi saat membuat, mengambil, dan menghapus dokumen. Setiap ekstensi memiliki kumpulan properti konfigurasinya sendiri yang sesuai dengan aspek resource yang berinteraksi dengannya. Untuk mengetahui daftar ekstensi yang disertakan, lihat Ringkasan referensi ekstensi.
Biasanya, konfigurasi setiap ekstensi mencakup kredensial yang harus digunakan ekstensi untuk melakukan autentikasi dengan resource atas nama Anda.
Lingkungan deployment ekstensi bersifat elastis untuk mendukung penskalaan otomatis berdasarkan beban. Oleh karena itu, secara default, deployment ekstensi yang tidak memiliki traffic mungkin tidak memiliki instance yang tersedia untuk merespons permintaan. Jadi, permintaan pertama ke ekstensi mungkin memerlukan waktu lebih lama saat lingkungan membuat instance ekstensi untuk digunakan.
Untuk tutorial memulai, lihat Tutorial: Menambahkan dan menggunakan ekstensi.
Menambahkan dan mengonfigurasi ekstensi
Login ke Edge, klik menu Admin, lalu klik Extensions.
Halaman Extensions yang muncul mencantumkan semua ekstensi yang telah dikonfigurasi dari paket ekstensi yang tersedia di sistem. Jika ingin melihat ekstensi yang dikonfigurasi, Anda dapat memfilter daftar dengan mengetik istilah pemfilteran di bagian atas halaman.
Pada langkah berikutnya, Anda akan menambahkan ekstensi Anda sendiri.
Di halaman Extension, klik Add Extension.
Halaman Select an extension yang muncul membagi ekstensi antara ekstensi yang dikembangkan oleh Google dan ekstensi yang dikembangkan oleh perusahaan lain.
Di bagian Select an extension, klik tab yang Anda inginkan, lalu temukan ekstensi yang sesuai dengan resource eksternal yang Anda akses.
Di kotak untuk paket ekstensi, Anda dapat mengklik View Details untuk melihat informasi tentang versi ekstensi, penulis, dan sebagainya.
Klik kotak untuk paket ekstensi untuk mulai mengonfigurasi ekstensi dari paket.
Di kotak dialog Extension Properties, masukkan nama dan deskripsi untuk ekstensi, lalu klik Create.
Di halaman Extension > My-Extension-Name untuk ekstensi yang Anda buat, temukan lingkungan Apigee Edge yang ingin Anda gunakan untuk mengonfigurasi ekstensi.
Ekstensi harus di-deploy ke lingkungan yang sama dengan proxy API yang akan menggunakannya.
Klik baris lingkungan dalam daftar.
Di dialog Configuration, pilih atau masukkan nilai untuk mengonfigurasi ekstensi ini.
Setiap ekstensi memiliki properti konfigurasinya sendiri. Untuk mengetahui deskripsi properti, gunakan referensi ekstensi. Referensi ekstensi tercantum dalam Ringkasan referensi ekstensi.
Klik Save.
Men-deploy ekstensi
- Di halaman Extension > My-Extension-Name untuk ekstensi, klik Deploy untuk men-deploy ekstensi agar dapat digunakan dari proxy API.
Setelah Anda men-deploy ekstensi:
Tambahkan ekstensi ke proxy API menggunakan kebijakan Panggilan Ekstensi.
Anda dapat melihat data log yang dihasilkan oleh ekstensi. Untuk mengetahui informasi selengkapnya, lihat Melihat log ekstensi.