Men-deploy proxy dari command line

Anda 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. Opsi pertama adalah menggunakan alat deployment Apigee Edge yang ditulis dalam Python. Opsi lainnya adalah mengonfigurasi dan menjalankan skrip shell.

Gunakan teknik deployment command line saat Anda bekerja langsung dengan file sumber proxy di sistem Anda. Ada banyak alasan mengapa Anda mungkin bekerja secara offline. Anda mungkin ingin menggunakan editor XML favorit atau Anda mungkin mengembangkan kebijakan yang memerlukan coding Java dan 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 Python Apigee Edge

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

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 Contoh Platform API, dengan direktori dasar adalah direktori induk dari direktori setup dan tools.

Dalam 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 akan mengompresi file Anda, 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 bertambah.

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 menentukan alamat IP server pengelolaan Edge. Jika telah membuat data DNS untuk server pengelolaan, Anda dapat menentukan URL dalam bentuk 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 di 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 file harus disimpan di bawah direktori bernama "apiproxy". Nilai ini adalah jalur direktori yang berisi direktori "apiproxy", dan bukan jalur ke direktori "apiproxy" itu sendiri.
  • -p: Jalur URI yang digunakan sebagai pencocokan pola untuk merutekan 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, yang sesuai dengan Edge di cloud. Untuk deployment lokal, gunakan URL server pengelolaan Edge dan port 8080, seperti dalam: 
    https://ms_URL:8080

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

Mengonfigurasi dan menjalankan skrip shell deployment

Pendekatan termudah adalah menjalankan skrip deployment yang disediakan dengan proxy API contoh. Skrip shell menggabungkan alat deployment 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 Anda, lalu tekan ENTER.

Kemudian, Anda 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 mengubah file /setup/setenv.sh dalam distribusi contoh platform. Untuk mengetahui petunjuknya, lihat README atau Apigee Edge API.

Jika berhasil, alat deployment akan mengompresi file di bawah /apiproxy, mengimpor paket ke organisasi Anda di Apigee Edge, lalu men-deploy proxy API ke lingkungan 'test' .

Proxy API Anda siap dipanggil.