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 melakukan deployment dari command line. Pertama-tama, gunakan alat deployment Apigee Edge yang ditulis dalam Python. Cara lainnya adalah untuk mengkonfigurasi dan menjalankan skrip {i>shell<i}.

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

Jika Anda terutama bekerja 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 Apigee Edge Python berfungsi dengan API pengelolaan Edge untuk mengimpor dan men-deploy API menggunakan {i>proxy<i}. Alat ini tersedia sebagai bagian dari distribusi Contoh Platform API di GitHub. Lihat Menggunakan contoh proxy API.

Gunakan alat Apigee Edge Python untuk mengimpor (mengupload) dan men-deploy API Anda dengan satu {i>checkout<i}.

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

Dalam perintah berikut, ganti nama proxy, nama pengguna dan sandi Edge Anda, organisasi dan lingkungan, dan jalur ke direktori yang berisi alamat IP proxy "Direktori apiproxy":

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 melakukan zip file, mengirimkannya ke organisasi Anda di Apigee Edge, dan men-deploy mereka ke lingkungan tertentu.

Alat deploy akan otomatis menemukan revisi API Anda saat ini proxy, membatalkan deployment revisi yang ada, dan men-deploy revisi API yang bertambah {i>proxy<i}.

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 mengunggah proxy API ke Edge versi lokal dengan menentukan tanda -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 menentukan alamat IP server pengelolaan Edge. Jika Anda telah membuat data DNS untuk server pengelolaan, Anda dapat menentukan URL dengan format berikut:

https://ms_URL:8080

Daftar lengkap flag untuk perintah tersebut adalah:

  • -n: Nama proxy API Anda.
  • -u: Nama pengguna dan sandi untuk akun Anda pada 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. Proxy API Anda file harus disimpan di direktori yang bernama "apiproxy". Nilai ini adalah jalur yang berisi "apiproxy" bukan ke jalur menuju "apiproxy" direktori itu sendiri.
  • -p: Jalur URI yang digunakan sebagai pola yang cocok untuk mengarahkan pesan masuk ke API ini deployment proxy. Dalam kebanyakan kasus, Anda dapat menetapkan nilai ini ke '/', kecuali Anda telah deployment dan persyaratan perutean. Jalur utama yang digunakan untuk perutean proxy API ditentukan di file konfigurasi ProxyEndpoint proxy API.
  • -h: URL Edge. Secara default, URL-nya adalah https://api.enterprise.apigee.com, yang sesuai dengan Edge di cloud. Untuk deployment lokal, gunakan URL 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 shell deploy skrip

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

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]:

artinya Anda perlu memodifikasi file /setup/setenv.sh di contoh platform. Untuk mendapatkan petunjuk, baca README atau Apigee Edge API.

Setelah berhasil, alat deploy akan menyimpan file yang berisi /apiproxy, pada impor paket ke organisasi Anda di Apigee Edge, lalu men-deploy proxy API ke 'test' lingkungan fleksibel App Engine.

Proxy API Anda siap dipanggil.