Men-deploy proxy dari command line

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

Topik ini menjelaskan cara men-deploy proxy dari command line. Apigee Edge menyediakan dua opsi untuk men-deploy dari command line. Yang pertama adalah menggunakan alat deploy Apigee Edge yang ditulis dalam Python. Kedua adalah dengan mengkonfigurasi dan menjalankan skrip {i>shell<i}.

Gunakan teknik deployment command line saat Anda bekerja langsung dengan file sumber proxy di sistem. Ada banyak alasan mengapa Anda mungkin bekerja secara offline. Anda dapat menggunakan editor XML favorit atau mengembangkan kebijakan yang memerlukan coding Java dan saat ini Anda bekerja terutama di IDE. Teknik yang dijelaskan di bagian ini memungkinkan Anda mengupload dan men-deploy file sumber ke lingkungan Layanan API yang Anda pilih.

Jika Anda bekerja terutama di UI pengelolaan, lihat Men-deploy proxy di UI.

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

Menjalankan alat deployment Apigee Edge Python

Alat deployment Python Apigee Edge berfungsi dengan Edge management API untuk mengimpor dan men-deploy proxy API. Alat ini tersedia sebagai bagian dari distribusi Contoh Platform API di GitHub. Lihat Menggunakan contoh proxy API.

Gunakan alat Python Apigee Edge untuk mengimpor (mengupload) dan men-deploy API Anda dalam satu proses sederhana.

Alat deployment harus dijalankan dari direktori dasar dalam distribusi distribusi Sampel Platform API, dengan direktori dasarnya adalah direktori induk dari direktori setup dan tools.

Pada perintah berikut, ganti nama proxy, nama pengguna dan sandi Edge Anda, organisasi dan lingkungan Edge, serta jalur ke direktori yang berisi direktori "apiproxy"" proxy API:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Contoh:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Perintah ini memasukkan file Anda ke dalam zip, mendorongnya ke organisasi Anda di Apigee Edge, dan men-deploy-nya ke lingkungan yang ditentukan.

Alat deployment secara otomatis menemukan revisi proxy API Anda saat ini, membatalkan deployment revisi yang ada, dan men-deploy revisi proxy API yang ditingkatkan.

Jika berhasil, Anda akan melihat output dalam bentuk:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

Secara default, alat ini mengupload proxy API ke https://api.enterprise.apigee.com, yang sesuai dengan Edge di cloud. Anda juga dapat menggunakan alat ini untuk mengupload proxy API ke versi Edge lokal dengan menentukan flag -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

Dalam contoh ini, Anda akan menentukan alamat IP server pengelolaan Edge. Jika telah membuat data DNS untuk server pengelolaan, Anda dapat menentukan URL dalam format berikut:

https://ms_URL:8080

Daftar lengkap flag untuk perintah ini adalah:

  • -n: Nama proxy API Anda.
  • -u: Nama pengguna dan sandi untuk akun Anda dalam organisasi di Apigee Edge.
  • -o: Nama organisasi tempat Anda memiliki akun.
  • -e: Lingkungan tempat proxy API harus di-deploy (test atau prod).
  • -d: Jalur ke direktori yang berisi file proxy API Anda. File proxy API Anda harus disimpan di dalam direktori yang bernama "apiproxy". Nilai ini adalah jalur direktori yang berisi direktori "apiproxy", dan bukan ke jalur ke direktori "apiproxy" itu sendiri.
  • -p: Jalur URI yang digunakan sebagai pencocokan pola untuk mengarahkan pesan masuk ke deployment proxy API ini. Pada umumnya, Anda dapat menetapkan nilai ini ke '/', kecuali jika Anda memiliki persyaratan deployment dan perutean lanjutan. Jalur utama yang digunakan untuk perutean proxy API ditentukan dalam file konfigurasi ProxyEndpoint proxy API.
  • -h: URL Edge. Secara default, URL-nya adalah https://api.enterprise.apigee.com, sesuai dengan Edge di cloud. Untuk deployment lokal, gunakan URL server pengelolaan Edge dan port 8080, seperti di: 
    https://ms_URL:8080

    Atau, gunakan alamat IP server pengelolaan, seperti di https://192.168.11.111:8080.

Mengonfigurasi dan menjalankan skrip shell

Pendekatan termudah adalah menjalankan skrip deployment yang disediakan bersama proxy API contoh. Skrip shell menggabungkan alat deploy Python Apigee Edge.

Dari direktori /simplyProxy, jalankan:

$ sh deploy.sh

Anda akan melihat:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

Masukkan sandi, tekan ENTER.

Anda kemudian akan melihat:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Jika Anda melihat hal berikut:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

itu berarti Anda perlu memodifikasi file /setup/setenv.sh dalam distribusi sampel platform. Untuk mendapatkan petunjuk, lihat README atau Apigee Edge API.

Jika berhasil, alat deploy akan mem-zip file di bagian /apiproxy, akan mengimpor paket ke organisasi Anda di Apigee Edge, lalu men-deploy proxy API ke lingkungan 'pengujian'.

Proxy API Anda siap dipanggil.