Langkah 2: Men-deploy proxy API

Version 1.16 (latest)

   Versi yang didukung:

• v1.16 (terbaru)                        
• v1.15                         
• v1.14                        
• Daftar versi yang didukung

   Versi yang tidak didukung:

• v1.13                         
• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Setelah menginstal dan mengonfigurasi runtime Apigee hybrid dan gateway ingress, Anda siap melihat cara semuanya berfungsi bersama.

1. Membuat proxy API baru menggunakan UI Apigee

Bagian ini menjelaskan cara membuat proxy API baru di UI menggunakan Wizard Proxy API.

1. Buka UI Apigee di browser.
2. Pilih organisasi Anda dari menu dropdown di pojok kiri atas.
3. Pilih Proxy development > API proxies di tampilan utama.
4. Klik Create.Wizard Proxy API akan dimulai.
5. Pilih Reverse proxy (paling umum).

   Tampilan Proxy details akan ditampilkan.

6. Konfigurasi proxy Anda dengan setelan berikut:
   • Proxy name: Masukkan myproxy. Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ini adalah ID proxy Anda.
   • Base path: Otomatis ditetapkan ke / diikuti dengan nama proxy, yang dalam contoh ini adalah /myproxy. Base path adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Apigee menggunakan URL untuk mencocokkan dan merutekan permintaan masuk ke proxy API yang tepat.
   • (Opsional) Description: Masukkan deskripsi untuk proxy API baru Anda, seperti "Testing Apigee hybrid with a simple proxy".
   • Target (Existing API): Masukkan "https://mocktarget.apigee.net". Tindakan ini menentukan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan mocktarget dihosting di Apigee dan menampilkan data sederhana. Layanan ini tidak memerlukan kunci API atau token akses.

   Detail proxy API Anda akan terlihat seperti berikut:

   

7. Klik Next.
8. Di bagian Deploy (optional), Anda memiliki opsi untuk memilih satu atau beberapa lingkungan tempat men-deploy proxy Anda, di kolom Deployment environments. Jika Anda memilih untuk tidak men-deploy proxy saat ini, kosongkan kolom Deployment environments. Anda selalu dapat men-deploy the proxy nanti.
9. Klik Create. Apigee membuat proxy (terkadang disebut sebagai paket proxy).

Apigee menampilkan tampilan Proxy summary. Jika Anda memilih untuk men-deploy proxy, bagian Deployments akan menampilkan nomor Revision, yaitu 1 saat Anda pertama kali men-deploy. Kolom Status menampilkan lingkungan tempat proxy di-deploy dengan indikator status berwarna hijau.

Di bawahnya, bagian Revisions menampilkan semua revisi yang dilakukan pada proxy ini. Dengan mengklik salah satu item VIEW di kolom Endpoint summary, bagian Endpoint akan menampilkan:

• Proxy endpoints: Basepath yang Anda tetapkan untuk proxy, yang dalam contoh ini adalah /myproxy.
• Target endpoints: Basepath yang Anda tetapkan untuk target, yang dalam contoh ini adalah https://mocktarget.apigee.net.

2. Memanggil proxy API

Saat UI menunjukkan bahwa proxy Anda telah di-deploy, Anda dapat mencoba memanggilnya menggunakan cURL atau klien REST pilihan Anda. Contoh:

1. Pastikan variabel lingkungan DOMAIN Anda ditetapkan ke nama domain yang Anda gunakan untuk nama host untuk grup lingkungan Anda di Penyiapan project dan organisasi - Langkah 3: Membuat grup lingkungan.

   echo $DOMAIN

2. Temukan alamat IP eksternal dan port gateway ingress Apigee dengan perintah berikut:

   kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway

   Output Anda akan terlihat seperti:

   NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
   apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h

3. Ekspor IP dan port eksternal Anda ke variabel:

   export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
   export INGRESS_PORT=PORT_NUMBER

4. Panggil proxy API:

   curl  -H Host:$DOMAIN --resolve \
     $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
     https://$DOMAIN:$INGRESS_PORT/myproxy -k -v

   Contoh:

   curl -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v

5. Panggilan yang berhasil ke proxy akan menampilkan kode respons HTTP 200 dan output berikut.

   Hello, Guest!

Untuk mempelajari lebih lanjut cara membuat dan men-deploy proxy API, lihat Ringkasan pembuatan proxy pertama Anda.

Selamat!

Anda telah berhasil menginstal Apigee hybrid. Untuk mempelajari lebih lanjut cara membuat dan men-deploy proxy API, lihat Pengantar pembuatan proxy API.