Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Target yang Dihosting dapat Anda gunakan untuk menjalankan aplikasi Node.js di lingkungan runtime native yang dihosting oleh Apigee. Tujuan dari Target yang Dihosting adalah sederhana: memungkinkan Anda men-deploy aplikasi di lingkungan native, aman, skalabel, dan terisolasi tempat proxy Edge API dapat memanggilnya sebagai layanan target.
Seperti yang diilustrasikan pada gambar berikut, proxy Edge API memanggil aplikasi Node.js yang di-deploy ke lingkungan Target yang Dihosting. Perlu diperhatikan bahwa lingkungan Target yang Dihosting tercakup dalam organisasi:environment Apigee.
Mendapatkan proxy Edge API untuk berkomunikasi dengan aplikasi Hosted Targets yang dibangun dan di-deploy dengan benar memerlukan konfigurasi sederhana di Endpoint Target proxy. Untuk memulai, buka tutorial Target yang Dihosting.
Runtime aplikasi apa yang didukung Target Berhosting?
Saat ini, Anda hanya dapat men-deploy aplikasi Node.js ke Target yang Dihosting.
Menginstal Target yang Dihosting
Target yang Dihosting tersedia di semua organisasi Edge Public Cloud. Anda tidak perlu menginstal apa pun untuk menggunakan Target yang Dihosting.
Memverifikasi bahwa Target yang Dihosting telah aktif
Jika ingin memverifikasi bahwa organisasi Anda telah mengaktifkan Target yang Dihosting, dapatkan detail organisasi Anda dan pastikan properti features.isEdgeFunctionsEnabled ditetapkan ke true. Properti bersifat hanya baca.
Contoh:
https://api.enterprise.apigee.com/v1/organizations/myorg
{
"createdAt":1507572884047,
"createdBy":"jdoe@apigee.com",
"displayName":"myorg",
"environments":[
"prod",
"dev",
"test",
"portal"
],
"lastModifiedAt":1507578673194,
"lastModifiedBy":"jdoe@apigee.com",
"name":"jdoe",
"properties":{
"property":[
{
"name":"features.isSmbOrganization",
"value":"false"
},
{
"name":"self.service.virtual.host.enabled",
"value":"true"
},
{
"name":"features.isCpsEnabled",
"value":"true"
},
{
"name":"features.isEdgeFunctionsEnabled",
"value":"true"
}
]
},
"type":"paid"
}
Yang perlu Anda ketahui tentang Target yang Dihosting
Target yang Dihosting memungkinkan aplikasi Node.js berjalan di lingkungan native yang tidak bergantung pada teknologi runtime khusus Apigee. Anda dapat men-debug dan menguji aplikasi secara lokal sebelum men-deploy-nya dan yakin bahwa versi yang di-deploy akan berfungsi persis seperti yang dilakukan secara lokal. Pada waktu deployment, Anda dapat memilih versi runtime aplikasi untuk menjalankan aplikasi di Target yang Dihosting. Misalnya, Anda dapat memilih secara khusus untuk menjalankan aplikasi Node.js di lingkungan v8.10.0.
Batas
Untuk mengetahui batas penggunaan pada Target yang Dihosting, lihat Batas produk Apigee.
Langkah-langkah dasar yang harus diikuti
Jika sudah memahami pengembangan proxy Edge, Anda hanya perlu mempelajari beberapa langkah sederhana untuk berhasil menggunakan Target yang Dihosting. Pada dasarnya, Anda membuat, men-deploy, dan mengelola proxy Edge untuk Target yang Dihosting sama seperti yang Anda lakukan untuk proxy Apigee Edge lainnya.
Untuk menggunakan Target yang Dihosting, Anda perlu melakukan tugas berikut. Tutorial akan membahas setiap tugas ini secara mendetail.
- Kembangkan dan uji aplikasi Node.js Anda secara lokal.
- Buat file manifes di direktori root project aplikasi Anda. Manifes adalah file YAML yang menentukan informasi yang diperlukan untuk mem-build dan men-deploy aplikasi.
- Tambahkan aplikasi Anda ke proxy Edge sebagai jenis resource yang dihosting.
- Di Endpoint Target proxy, tambahkan tag
<HostedTarget/>kosong. Tag ini memberi tahu Edge untuk men-deploy aplikasi Node.js ke lingkungan Target yang Dihosting. Contoh:
<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
<PreFlow name="PreFlow">
<Request />
<Response />
</PreFlow>
<PostFlow name="PostFlow">
<Request />
<Response />
</PostFlow>
<Flows />
<HostedTarget />
</TargetEndpoint>
Cakupan aplikasi Target yang Dihosting
Aplikasi Target yang Dihosting tercakup dalam lingkungan organisasi Edge. Cakupan ini sama seperti cakupan proxy Edge apa pun.
Dapatkah aplikasi Target yang Dihosting mengakses data proxy?
Aplikasi Target yang Dihosting saat ini tidak memiliki akses ke lingkungan runtime proxy. Artinya, Anda tidak dapat mengakses variabel, cache, dan entity lainnya secara langsung dari aplikasi Target yang Dihosting.
Dengan Node.js tersemat (dukungan Node.js tradisional berbasis Trireme di Edge), Anda dapat menggunakan
apigee-access untuk
mengakses variabel alur dan entity lainnya di Edge. Namun, Target yang Dihosting tidak mendukung modul apigee-access untuk deployment Node.js.
Lihat juga Apakah mungkin untuk mengatasi kurangnya akses apigee?
Memigrasikan kode aplikasi yang ada ke Target yang Dihosting
Saat ini tidak ada jalur migrasi otomatis dari aplikasi Node.js tersemat berbasis Trireme tradisional ke Target yang Dihosting. Namun, Anda dapat mengonversi kode aplikasi yang ada menjadi Target yang Dihosting secara manual. Sebagai contoh, lihat Memigrasikan proxy Node.js yang ada ke proxy Target yang Dihosting.