Memulai Node.js di Apigee Edge

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

Topik ini menjelaskan cara paling sederhana untuk membungkus aplikasi Node.js dalam proxy API menggunakan UI pengelolaan.

Pengantar

Kemungkinan besar, aplikasi Node.js pertama yang pernah Anda buat adalah server HTTP yang merespons permintaan dengan "Halo Dunia!" Cara termudah untuk mencoba Node.js di Apigee Edge adalah dengan melakukan sesuatu yang sangat serupa. Hanya dengan beberapa klik mouse, Anda akan memiliki server HTTP Node.js yang berfungsi dan di-proxy yang berjalan di Edge. Setelah itu, Anda dapat menggunakan editor kode di UI untuk mengubah aplikasi Node.js, menambahkan file Node.js tambahan, menambahkan kebijakan, dan sebagainya.

Membuat sampel Halo Dunia! Proxy API

Bagian ini menjelaskan cara membuat proxy API Edge yang berinteraksi dengan server HTTP Node.js. Kode server HTTP Node.js sudah ditulis untuk Anda dan otomatis di-deploy ke Edge saat Anda mengikuti langkah-langkah sederhana ini.
  1. Di wizard Build a Proxy, pilih Node.js App.
  2. Klik Berikutnya.
  3. Ikuti wizard Build a Proxy dan buat pilihan berikut.
    Kolom Pilihan
    Detail
    Nama Proxy Masukkan Nodejs-Hello. Nama yang ditampilkan untuk API Anda.
    Jalur Dasar Proxy Masukkan nodejs-hello
    Sumber Pilih Contoh "Halo Dunia". (Kita akan membahas opsi lainnya nanti dalam topik ini.)
    Deskripsi Masukkan deskripsi API.
    Keamanan
    Teruskan (tidak ada) Pilih Teruskan (tidak ada). Membuat proxy pass-through sederhana.
    Host Virtual
    default, aman Jangan ubah setelan default. Untuk mempelajari host virtual, lihat Tentang host virtual (Beta).
    Build
    Men-deploy Lingkungan Pilih uji.
  4. Klik Build and Deploy
    Sebagai respons, Anda akan melihat konfirmasi bahwa proxy API baru Anda telah berhasil dibuat dan di-deploy di lingkungan 'test'.
  5. Klik Lihat proxy <proxy name> di editor untuk menampilkan halaman detail proxy API.

Memanggil proxy hello

Saat Anda memanggil proxy hello, aplikasi Node.js akan dieksekusi secara otomatis, merespons dengan "Hello, World!". Perhatikan bahwa kecuali jika Anda menentukan sebaliknya, aplikasi Node.js akan di-deploy ke lingkungan yang disebut test. Berikut adalah panggilan dasar menggunakan Curl (ganti nama organisasi Anda dengan myorg). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Melihat dan mengedit kode Node.js

Mari kita lihat kode Node.js yang ditambahkan ke proxy API. Buka halaman ringkasan untuk proxy Hello World, lalu klik Develop.



Tindakan ini akan membuka tampilan Develop yang mencakup editor kode. Anda dapat mengedit kode di sana secara langsung.

Misalnya, ubah respons dari Hello, World! menjadi sesuatu yang lain, seperti Hello, Node!, lalu klik Simpan. Proxy disimpan dan di-deploy ulang.

Terakhir, panggil ulang proxy untuk memverifikasi perubahan:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Selengkapnya tentang menjalankan aplikasi Node.js di Apigee Edge

Seperti semua aplikasi Node.js, aplikasi Node.js yang berjalan di Apigee Edge berjalan dalam satu thread kontrol. Tidak ada kebutuhan (dan sebenarnya tidak ada kemampuan) untuk memulai thread lain, atau menyinkronkan variabel antar-thread. Karena Node.js menerapkan pemrograman non-blocking, satu skrip dapat mendukung ribuan permintaan serentak karena skrip melepaskan CPU setiap kali harus menunggu sesuatu, dan akan diberi tahu nanti saat hal itu terjadi.

Untuk menggunakan Node.js di Apigee Edge, Anda harus menentukan file skrip Node.js utama. Skrip ini harus dikonfigurasi untuk menangani permintaan masuk, yang biasanya Anda lakukan dengan menggunakan modul http atau https, membuat klien, dan sebagainya. (Jika skrip utama tidak dikonfigurasi dengan cara ini, skrip hanya akan dieksekusi dan keluar setelah di-deploy.) Dalam Apigee Edge, setiap skrip aplikasi Node.js dimulai dari awal saat proxy di-deploy, dan dihentikan saat proxy di-un-deploy. Di antaranya, server akan menunggu permintaan baru dan memprosesnya. Untuk mengetahui informasi selengkapnya, lihat "Memanggil file Node.js yang diimpor" di Men-deploy aplikasi Node.js mandiri.

Langkah Berikutnya

Anda juga dapat membuat dan men-deploy aplikasi Node.js mandiri langsung dari sistem file Anda. Topik berikutnya, Men-deploy aplikasi Node.js mandiri, menjelaskan cara menggunakan perintah apigeetool untuk men-deploy aplikasi Node.js dari command line.