Langkah 2: Deploy proxy API

Setelah mengonfigurasi Google Cloud dan UI Apigee, serta menginstal dan mengonfigurasi runtime, Anda siap melihat cara semuanya berfungsi bersama-sama.

1. Membuat proxy API baru menggunakan UI Apigee

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

Apigee di Konsol Cloud

Untuk membuat proxy API baru menggunakan Apigee di Konsol Cloud:

  1. Buka https://console.cloud.google.com/apigee di browser.
  2. Pilih organisasi Anda dari menu dropdown di sudut kiri atas.
  3. Pilih Pengembangan proxy > proxy API di tampilan utama.
  4. Klik Create.API Proxy Wizard dimulai.
  5. Pilih Reverse proxy (paling umum).

    Tampilan Detail proxy akan ditampilkan.

  6. Konfigurasikan proxy Anda dengan setelan berikut:
    • Proxy name: Masukkan myproxy. Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ID ini adalah ID proxy Anda.
    • Jalur dasar: Secara 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. Edge menggunakan URL tersebut untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.
    • (Opsional) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti "Menguji Apigee Hybrid 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. Token ini tidak memerlukan kunci API atau token akses.

    Detail proxy API Anda akan terlihat seperti berikut:

    Detail proxy dalam wizard pembuatan proxy.

  7. Klik Next.
  8. Di layar Policies, pilih Pass through (no authorization) sebagai opsi keamanan.
  9. Klik Next.
  10. Pada bagian Deploy (opsional), Anda memiliki opsi untuk memilih satu atau beberapa lingkungan tempat men-deploy proxy, di kolom Lingkungan deployment. Jika Anda memilih untuk tidak men-deploy proxy pada tahap ini, kosongkan kolom Deployment environment. Anda dapat men-deploy proxy kapan saja.
  11. Klik Create. Apigee menghasilkan proxy (terkadang disebut sebagai paket proxy).

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

Di bawahnya, bagian Endpoint akan menampilkan:

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

Apigee Klasik

Untuk membuat proxy API baru menggunakan Apigee Klasik:

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

    Tampilan Detail proxy akan ditampilkan.

  6. Konfigurasikan proxy Anda dengan setelan berikut:
    • Nama Proxy: Masukkan "myproxy". Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ID ini adalah ID proxy Anda.
    • Jalur Dasar Proxy: Otomatis ditetapkan ke "/myproxy". Jalur Dasar Proxy adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Edge menggunakan URL tersebut untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.
    • (Opsional) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti "Menguji Apigee Hybrid 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. Token ini tidak memerlukan kunci API atau token akses.

    Detail proxy API Anda akan terlihat seperti berikut:

    Detail proxy di wizard Create Proxy.

  7. Klik Next.
  8. Di layar Policies, pilih Pass through (no authorization) sebagai opsi keamanan.
  9. Klik Next.
  10. Pada layar Summary, pilih lingkungan untuk men-deploy proxy, lalu klik Create and Deploy.

    Hybrid menghasilkan proxy (terkadang disebut sebagai paket proxy):

    Dialog konfirmasi wizard pembuatan proxy.

  11. Klik Buka daftar proxy.

    Apigee menampilkan tampilan Proxy, yang menampilkan daftar proxy API. Proxy baru Anda akan ditampilkan dengan indikator status berwarna hijau, yang berarti proxy tersebut telah di-deploy.

2. Memanggil proxy API

Jika UI menunjukkan bahwa proxy 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 digunakan untuk nama host grup lingkungan Anda di Penyiapan project dan organisasi - Langkah 3: Buat grup lingkungan. 
    echo $DOMAIN

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

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

    Output Anda akan terlihat seperti ini: 

    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

    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 membangun dan men-deploy proxy API, lihat Ringkasan mem-build proxy pertama Anda.