Langkah 2: Men-deploy proxy API

Saat ini Anda melihat versi 1.14 dari dokumentasi Apigee Hybrid. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.14 

   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 mengonfigurasi Google Cloud dan UI Apigee, serta menginstal dan mengonfigurasi runtime, Anda siap melihat cara kerjanya.

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:
   • Nama proxy: Masukkan myproxy. Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ini adalah ID proxy Anda.
   • Jalur dasar: Otomatis ditetapkan ke / diikuti dengan nama proxy, yang dalam contoh ini adalah /myproxy. Jalur dasar 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) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti "Menguji hybrid Apigee dengan proxy sederhana".
   • Target (Existing API): Masukkan "https://mocktarget.apigee.net". Ini menentukan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan mocktarget dihosting di Apigee dan menampilkan data sederhana. API ini tidak memerlukan kunci API atau token akses.

   Detail proxy API Anda akan terlihat seperti berikut:

   

7. Klik Berikutnya.
8. Di bagian Deploy (opsional), Anda memiliki opsi untuk memilih satu atau beberapa lingkungan tempat Anda men-deploy proxy, di kolom Lingkungan deployment. Jika Anda memilih untuk tidak men-deploy proxy pada saat ini, biarkan kolom Lingkungan deployment kosong. Anda dapat men-deploy 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, yang bernilai 1 saat Anda pertama kali men-deploy. Kolom Status menampilkan lingkungan tempat proxy di-deploy dengan indikator status hijau.

Di bawahnya, bagian Revisi menampilkan semua revisi yang dilakukan pada proxy ini. Dengan mengklik salah satu item LIHAT di kolom Ringkasan endpoint, bagian Endpoint akan menampilkan:

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

2. Panggil proxy API

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

1. Pastikan variabel lingkungan DOMAIN Anda disetel ke nama domain yang Anda gunakan untuk nama host grup lingkungan di Penyiapan project dan organisasi - Langkah 3: Buat 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 membangun dan men-deploy proxy API, lihat Ringkasan membangun 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.