Referensi Target yang Dihosting

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

Batas variabel lingkungan

Target yang Dihosting membatasi ukuran dan jumlah variabel lingkungan yang dapat Anda tetapkan di lingkungan runtime Target yang Dihosting.

  • 1.000: Panjang maksimum variabel lingkungan tunggal.
  • 100: Jumlah maksimum variabel lingkungan yang dapat Anda tetapkan.

Untuk mengetahui informasi tentang cara menetapkan variabel lingkungan, lihat File manifes.

Variabel lingkungan yang ditetapkan dalam runtime aplikasi

Ketika Anda men-deploy aplikasi Hosted Targets, variabel lingkungan berikut ini telah ditetapkan dan tersedia untuk aplikasi Anda saat runtime:

  • APIGEE_ENVIRONMENT - Lingkungan tempat proxy Target yang Dihosting di-deploy.
  • APIGEE_ORGANIZATION - Organisasi tempat proxy Target yang Dihosting di-deploy.
  • PORT - Port tempat aplikasi Target yang Dihosting harus memproses.

Alokasi resource sistem

Setiap instance Target yang Dihosting menerima resource berikut:

  • Memori 256 MB
  • CPU 1,2 GHz

Penskalaan

Bagian ini menjelaskan cara penskalaan aplikasi Target yang Dihosting, bergantung pada jenis akun Edge yang Anda miliki.
  • Versi Uji Coba Apigee Edge dibatasi hingga satu instance Target yang Dihosting per proxy.
  • Akun Apigee Edge berbayar menerima penskalaan otomatis berdasarkan tingkat permintaan, latensi respons, dan metrik aplikasi lainnya per proxy.
  • Aplikasi Target yang Dihosting yang di-deploy ke Apigee Edge versi berbayar dan uji coba akan diskalakan ke nol selama periode tidak ada aktivitas. Dalam hal ini, Anda mungkin melihat waktu respons yang lebih lambat untuk sementara waktu. Lihat juga Masalah umum

File manifes

Untuk mengumpulkan informasi runtime guna mem-build dan men-deploy aplikasi yang dihosting, Edge akan mencari file manifes bernama app.yaml di direktori resources/hosted. File ini berisi informasi yang diperlukan untuk mem-build dan men-deploy aplikasi Target yang Dihosting.

Sintaksis file Manfiest

runtime: node
runtimeVersion: version_number
command: command_name
args: argument_array
env:
  - name: variable_name
    value: literal_value
  - name: variable_name
    valueRef:
      name: kvm_name
      key: kvm_value

Elemen file manifes

File manifes app.yaml menyertakan elemen berikut:

  • runtime - (Wajib) Menentukan jenis aplikasi yang Anda deploy. Anda harus menentukan node.
  • runtimeVersion - (Opsional) Versi runtime yang digunakan aplikasi Anda. Default: LTS Node.js (v10.x). Lihat repositori resmi Docker untuk Node untuk opsi lainnya.
  • command - (Opsional) Memungkinkan Anda menentukan perintah untuk dijalankan selain perintah default yang digunakan untuk memulai aplikasi. Default: Node.js=npm
  • args - (Opsional) Array argumen command line yang akan diteruskan ke aplikasi (ditentukan dalam sintaksis array YAML standar). Biasanya, perintah ini ditambahkan ke perintah default. Defaultnya adalah start. Misalnya, secara default, aplikasi Node.js akan menerima perintah npm start.
  • env - (Opsional) Array variabel lingkungan (pasangan nama/nilai) yang akan ditetapkan di lingkungan runtime Target yang Dihosting. Variabel ini tersedia untuk aplikasi Hosted Targets yang di-deploy.
    • name - Nama variabel.
    • value | valueRef - Anda memiliki dua opsi. Anda dapat menetapkan nilai literal atau mereferensikan nilai yang disimpan dalam Key Value Map. Peta Nilai Kunci harus sudah ada di lingkungan Edge Anda. Lihat Menggunakan Peta Nilai Kunci
      • Jika menggunakan value, Anda harus menentukan variabel name dan value literal. Contoh: 
        runtime: node
env:
 - name: NODE_ENV
   value: production
      • Jika menggunakan valueRef, Anda harus memberikan name Key Value Map (KVM) yang sebelumnya Anda buat di Edge dan key. Misalnya: 
        runtime: node
env:
  - name: DB_ENV
    value: production
  - name: DB_PASSWORD
    valueRef:
      name: hosted-kvm
      key: db-password

    Contoh file manifes

    Bagian ini berisi contoh file manifes untuk aplikasi Node.js. File manifes diperlukan untuk men-deploy aplikasi Target yang Dihosting, dan harus berada dalam direktori apiproxy/resources/hosted, dan nama filenya harus app.yaml.

    Berikut adalah contoh file app.yaml (manifes) untuk aplikasi Node.js.

    Contoh yang menentukan variabel lingkungan literal: 

     runtime: node
 env:
   - name: NODE_ENV
     value: production

    Contoh dengan perintah mulai, argumen command line, dan variabel lingkungan.

     runtime: node
 command: ./node_modules/pm2/bin/pm2
 env:
   - name: NODE_ENV
     value: production
 args:
   - app.js


    Contoh yang menentukan referensi Peta Nilai Kunci (KVM):

    Untuk mengetahui informasi selengkapnya tentang akses KVM, lihat File Manifes.

    runtime: node
env:
  - name: DB_ENV
    value: production
  - name: DB_PASSWORD
    valueRef:
      name: hosted-kvm
      key: db-password

    Contoh aplikasi Target yang Dihosting di GitHub

    Apigee menyediakan proxy contoh di GitHub dengan aplikasi Target yang Dihosting yang ditulis di Node.js. Anda dapat meng-clone repo ini dan mengikuti petunjuk README untuk men-deploy proxy.

    Prasyarat

    Untuk men-deploy sampel, Anda harus menginstal dua alat di sistem:

    • apigeetool -- Alat command line untuk men-deploy proxy Edge.
    • get_token - Alat command line untuk mendapatkan token otorisasi yang diperlukan oleh apigeetool.

    Jika ingin menguji contoh secara lokal, Anda juga harus menginstal Node.js.

    Mendapatkan repositori sampel

    1. Di browser, buka https://github.com/apigee/api-platform-samples.
    2. Klik Clone or download dan tarik repo ke sistem lokal Anda, menggunakan metode pilihan Anda.
    3. cd ke <your install dir>/api-platform-samples/doc-samples/hosting-targets
    4. Setelah repo didownload, Anda dapat menjalankan cd ke salah satu direktori contoh dan mengikuti petunjuk README untuk men-deploy proxy sampel ke Edge. Perintah deploy ditampilkan di bawah. Cukup ganti parameter yang ditunjukkan dengan parameter untuk akun Apigee Anda:
      5. get_token && apigeetool deployproxy \
  -o YOUR_ORGANIZATION \
  -e YOUR_ENVIRONMENT \
  --json \
  --token "$(< ~/.sso-cli/valid_token.dat)"\
  --api NAME_OF_THE_PROXY \
  --directory .

    Contoh: Mengeksekusi aplikasi contoh

    Meng-clone repositori contoh

    cd ~/myhome
git clone https://github.com/apigee/api-platform-samples.git
cd ~/myhome/api-platform-samples/doc-samples/hosted-targets
cd node-hosted-hello

    Menguji aplikasi secara lokal

    Anda harus menginstal Node.js untuk melakukan pengujian lokal ini.

     PORT=8081 node apiproxy/resources/hosted/index.js
 curl http://localhost:8081

    Contoh output:

    {"date":"2018-03-12T21:45:22.161Z","msg":"Hello, World!"}

    Men-deploy proxy

     get_token && apigeetool deployproxy \
   -o myorg \
   -e test \
   --json \
   --token "$(< ~/.sso-cli/valid_token.dat)"\
   --api node-hosted-hello \
   --directory .

    Melakukan pengujian deployment

    Proses deployment mungkin memerlukan waktu beberapa menit hingga selesai. Jika terjadi error deployment, jalankan kembali perintah deploy.

    curl http://myorg-test.apigee.net/node-hosted-hello

    Contoh output:

    {"date":"2018-03-23T18:59:18.668Z","msg":"Hello, World!"

    Masalah Umum

    • Network Latencies - Setelah aplikasi Node.js tidak lagi berjalan di JVM MP, sekarang ada network hop antara MP dan deployment. Hal ini tentu memerlukan biaya, tetapi tolok ukur awal menunjukkan bahwa solusi ini dalam jumlah yang wajar
    • Respons API Lambat - Infrastruktur yang menjalankan aplikasi Anda akan otomatis diskalakan berdasarkan kebutuhan. Artinya, aplikasi Anda sebenarnya dapat diskalakan ke nol instance dan jika demikian, permintaan API berikutnya akan memerlukan waktu sedikit lebih lama daripada permintaan API standar karena infrastruktur sedang mengaktifkan instance untuk memproses permintaan.
    • Error deployment - Jika Anda menerima error deployment saat men-deploy proxy Target yang Dihosting, coba deploy ulang proxy. Dalam beberapa kasus, waktu tunggu deployment dapat habis dan jika Anda melakukan deployment ulang, masalah ini akan teratasi dengan sendirinya.