Anda kini telah mengonfigurasi Google Cloud dan UI Apigee, serta menginstal dan mengonfigurasi {i>runtime<i}, Anda siap untuk melihat bagaimana semuanya bekerja.
1. Membuat proxy API baru menggunakan UI Apigee
Bagian ini menjelaskan cara membuat proxy API baru di UI dengan menggunakan Wizard Proxy API.
Apigee di Konsol Cloud
Untuk membuat proxy API baru menggunakan Apigee di Konsol Cloud:
- Buka UI Apigee di Konsol Cloud di browser.
- Pilih organisasi Anda dari menu dropdown di pojok kiri atas.
- Pilih Pengembangan proxy > Proxy API di tampilan utama.
- Klik Create.Wizard Proxy API akan dimulai.
- Pilih Reverse proxy (paling umum).
Tampilan Detail proxy ditampilkan.
- Konfigurasikan 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: Secara otomatis ditetapkan ke / diikuti oleh nama proxy, yang dalam contoh ini adalah /myproxy. Dasar path adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Edge menggunakan URL untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.
- (Opsional) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti sebagai "Menguji Apigee Hybrid dengan proxy sederhana".
- Target (Existing API): Masukkan "https://mocktarget.apigee.net". Ini mendefinisikan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan mocktarget memiliki yang dihosting di Apigee dan menampilkan data sederhana. Pengujian ini tidak memerlukan kunci API atau token akses.
Detail proxy API Anda akan terlihat seperti berikut:
- Klik Berikutnya.
- Pada layar Kebijakan, pilih Lewati (tanpa otorisasi) sebagai keamanan.
- Klik Berikutnya.
- Di bagian Deploy (opsional), Anda memiliki opsi untuk memilih satu atau beberapa lingkungan yang digunakan untuk men-deploy proxy Anda, di kolom Lingkungan deployment. Jika Anda memilih untuk tidak menerapkan proxy pada biarkan kolom Lingkungan deployment kosong. Anda selalu dapat men-deploy {i>proxy<i} nanti.
- Klik Create. Apigee membuat proxy (terkadang disebut sebagai paket proxy).
Apigee menampilkan tampilan Ringkasan proxy. Jika Anda memilih untuk men-deploy proxy, bagian Deployment akan menampilkan Revisi , yaitu 1 saat pertama kali men-deploy. Kolom Status menampilkan lingkungan tempat proxy di-deploy dengan indikator status hijau.
Di bawahnya, bagian Endpoint akan menampilkan:
- Endpoint proxy: Jalur dasar yang Anda tetapkan untuk proxy, yang merupakan contoh ini
adalah
/myproxy
. - Endpoint target: Jalur dasar yang Anda tetapkan untuk target,
contohnya adalah
https://mocktarget.apigee.net
.
Apigee Klasik
Untuk membuat proxy API baru menggunakan Apigee Klasik:
- Buka UI Apigee di browser.
- Pilih organisasi Anda dari menu dropdown di pojok kiri atas.
- Pilih Develop > Proxy API di tampilan utama.
- Klik Create New.Wizard Proxy API akan dimulai.
- Pilih Reverse proxy (paling umum).
Tampilan Detail proxy ditampilkan.
- Konfigurasikan proxy Anda dengan setelan berikut:
- Nama Proxy: Masukkan "myproxy". Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ini adalah ID proxy Anda.
- Proxy Base Path: Secara otomatis disetel ke "/myproxy". Proxy Base Path adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Edge menggunakan URL untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.
- (Opsional) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti sebagai "Menguji Apigee Hybrid dengan proxy sederhana".
- Target (Existing API): Masukkan "https://mocktarget.apigee.net". Ini mendefinisikan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan mocktarget memiliki yang dihosting di Apigee dan menampilkan data sederhana. Pengujian ini tidak memerlukan kunci API atau token akses.
Detail proxy API Anda akan terlihat seperti berikut:
- Klik Berikutnya.
- Pada layar Kebijakan, pilih Lewati (tanpa otorisasi) sebagai keamanan.
- Klik Berikutnya.
- Pada layar Summary, pilih lingkungan untuk men-deploy proxy dan
klik Create and Deploy.
Hybrid menghasilkan proxy (terkadang disebut sebagai paket proxy):
- Klik Buka daftar proxy.
Apigee menampilkan tampilan Proxy, yang menampilkan daftar proxy API. Nama proxy baru akan ditampilkan dengan indikator status hijau, artinya proxy tersebut telah di-deploy.
2. Memanggil proxy API
Saat UI menunjukkan bahwa proxy Anda di-deploy, Anda dapat mencoba memanggilnya menggunakan cURL atau REST klien pilihan Anda. Contoh:
- Pastikan variabel lingkungan
DOMAIN
Anda ditetapkan ke nama domain yang Anda gunakan nama host untuk grup lingkungan Anda di Project dan org penyiapan - Langkah 3: Buat grup lingkungan.echo $DOMAIN
-
Temukan alamat IP eksternal dan port dari gateway masuk Apigee dengan perintah berikut:
kubectl get svc -n apigee -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
- Ekspor IP eksternal dan port Anda ke variabel:
export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
- Panggil proxy API:
curl -H Host:$DOMAIN --resolve \ $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS \ https://$DOMAIN:$INGRESS_PORT/myproxy -k
Contoh:
curl -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k
Untuk mempelajari lebih lanjut cara membuat dan men-deploy proxy API, lihat Ringkasan membuat proxy pertama Anda.