Menambahkan dan mengonfigurasi ekstensi

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Apigee Edge menyertakan beberapa paket ekstensi yang telah diinstal. Sebelum dapat menggunakan ekstensi di proxy API dengan kebijakan Info Ekstensi, Anda harus menambahkan dan mengonfigurasi ekstensi. Saat menambahkan ekstensi, Anda mencari paket ekstensi yang mewakili resource eksternal yang ingin diintegrasikan dengan proxy API Anda, menambahkan dan mengonfigurasi ekstensi dari paket tersebut, dan men-deploy ekstensi ke lingkungan Edge.

Saat mengonfigurasi ekstensi dari paket ekstensi, Anda menentukan nilai yang memfokuskan interaksi ekstensi dengan resource eksternalnya. Misalnya, saat mengonfigurasi Ekstensi Google Cloud Firestore, Anda menentukan database mana yang harus digunakan ekstensi saat membuat, mendapatkan, dan menghapus dokumen. Setiap ekstensi memiliki kumpulan properti konfigurasinya sendiri yang sesuai dengan aspek resource yang berinteraksi dengannya. Untuk daftar ekstensi yang disertakan, lihat Ringkasan referensi ekstensi.

Biasanya, setiap konfigurasi ekstensi menyertakan kredensial yang harus digunakan ekstensi untuk mengautentikasi dengan resource untuk Anda.

Lingkungan deployment ekstensi bersifat elastis untuk mendukung penskalaan otomatis berdasarkan beban. Akibatnya, 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 selagi lingkungan membuat instance ekstensi untuk digunakan.

Untuk mengetahui cara memulai, lihat Tutorial: Menambahkan dan menggunakan ekstensi.

Menambahkan dan mengonfigurasi ekstensi

  1. Login ke Edge, klik menu Admin, lalu klik Ekstensi.

    Halaman Ekstensi yang muncul mencantumkan semua ekstensi yang telah dikonfigurasi dari paket ekstensi yang tersedia di sistem. Jika ingin melihat ekstensi terkonfigurasi yang ada, Anda dapat memfilter daftar dengan mengetikkan istilah pemfilteran di bagian atas halaman.

    Pada langkah berikutnya, Anda akan menambahkan ekstensi Anda sendiri.

  2. Di halaman Ekstensi, klik Tambahkan Ekstensi.

    Laman Pilih ekstensi yang muncul membagi ekstensi antara ekstensi yang dikembangkan oleh Google dan yang dikembangkan oleh perusahaan lain.

  3. Di bagian Pilih ekstensi, klik tab yang Anda inginkan, lalu cari ekstensi yang sesuai dengan resource eksternal yang Anda akses.

    Di kotak paket ekstensi, Anda dapat mengklik Lihat Detail untuk melihat informasi tentang versi ekstensi, penulis, dan sebagainya.

  4. Klik kotak paket ekstensi untuk mulai mengonfigurasi ekstensi dari paket.

  5. Di kotak dialog Extension Properties, masukkan nama dan deskripsi untuk ekstensi tersebut, lalu klik Create.

  6. Di halaman Extension > My-Extension-Name untuk ekstensi yang Anda buat, cari lingkungan Apigee Edge yang ekstensinya ingin Anda konfigurasi.

    Ekstensi harus di-deploy ke lingkungan yang sama dengan proxy API yang akan menggunakannya.

  7. Klik baris lingkungan dalam daftar.

  8. Pada dialog Konfigurasi, pilih atau masukkan nilai untuk mengonfigurasi ekstensi ini.

    Setiap ekstensi memiliki properti konfigurasinya sendiri. Untuk deskripsi properti, gunakan referensi ekstensi. Referensi ekstensi tercantum dalam Ringkasan referensi ekstensi.

  9. Klik Simpan.

Men-deploy ekstensi

  1. 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: