Membuat dan men-deploy proxy API baru

Saat ini Anda melihat versi 1.1 dokumentasi Hybrid Apigee. Versi ini adalah akhir siklus proses. Anda harus mengupgradenya ke versi yang lebih baru. Untuk informasi selengkapnya, lihat Versi yang didukung.

Version 1.1 (unsupported)

Versi yang didukung:

• v1.13 (terbaru)                        
• v1.12                         
• v1.11                         
• Daftar versi yang didukung

Versi yang tidak didukung:

• 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 hybrid, serta menginstal dan mengonfigurasi runtime, Anda dapat melihat cara kerjanya secara bersamaan.

Bagian ini akan memandu Anda melalui hal-hal berikut:

1. Buat proxy API baru di UI Apigee menggunakan Wizard Proxy API
2. Men-deploy proxy baru ke cluster dengan UI

1. Membuat proxy API baru menggunakan UI campuran

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

Untuk membuat proxy API sederhana menggunakan Wizard Proxy API:

1. Buka UI Apigee di browser.
2. Pilih Develop > API Proxies di tampilan utama.
3. Dari menu drop-down Environment, pilih lingkungan tempat Anda ingin membuat proxy API baru. Bagian ini mengasumsikan nama lingkungan adalah "test". Anda telah membuat setidaknya satu lingkungan di Langkah 5: Tambahkan lingkungan.

   UI hybrid menampilkan daftar proxy API untuk lingkungan tersebut. Jika Anda belum membuat proxy, daftar ini akan kosong.

4. Klik +Proxy di kanan atas.

   Wizard Proxy API memulai

5. Pilih Reverse proxy (paling umum), lalu klik Next.

   Tampilan Detail proxy ditampilkan.

6. Konfigurasikan proxy Anda dengan setelan berikut:
   • Proxy Name: Masukkan "myproxy". Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ini adalah ID proxy Anda.
   • Jalur Dasar Proxy: Otomatis disetel ke "/myproxy". Jalur Dasar Proxy adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Edge menggunakan URL untuk mencocokkan dan mengarahkan permintaan yang 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". Fungsi ini menentukan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan tiruan tersebut dihosting di Apigee dan menampilkan data sederhana. Metode ini tidak memerlukan kunci API atau token akses.

   Detail proxy API Anda akan terlihat seperti berikut:

   

7. Klik Next.
8. Pada layar Kebijakan, pilih Pass through (none) sebagai opsi keamanan.
9. Klik Next.
10. Di layar Ringkasan, klik Buat.

    Sistem campuran menghasilkan proxy (terkadang disebut sebagai paket proxy):

    

    CATATAN: Dalam hal ini, UI hybrid tidak men-deploy proxy ke cluster Anda. Anda akan melakukannya di langkah berikutnya.
11. Klik Keluar.

    Hybrid menampilkan tampilan Proxy, yang menampilkan daftar proxy API. Proxy baru tersebut harus berada di bagian atas daftar, dengan indikator status abu-abu, yang berarti proxy tersebut belum di-deploy.

2. Deploy proxy Anda ke cluster menggunakan UI hybrid

Setelah membuat proxy baru, Anda harus menerapkannya agar dapat mencobanya. Bagian ini menjelaskan cara men-deploy proxy baru menggunakan UI hybrid.

Untuk men-deploy proxy API di UI hybrid:

1. Di UI hybrid, pilih Develop > API Proxies.

   Pastikan lingkungan "pengujian" dipilih.

   UI akan menampilkan proxy baru Anda dalam daftar proxy:

   

2. Klik proxy "myproxy".

   UI menampilkan tab API Proxies Overview untuk proxy tersebut.

   Perhatikan bahwa di bagian Deployment, kolom Revision menampilkan "Tidak di-deploy".

3. Di kolom Revision, luaskan pemilih drop-down untuk memilih revisi yang akan di-deploy.

   Menu drop-down hanya menampilkan "1" dan "Batalkan deployment".

4. Pilih "1"—revisi yang ingin di-deploy—dari menu drop-down.

   UI akan meminta Anda untuk mengonfirmasi deployment:

   

5. Klik Deploy.

   UI memulai proses men-deploy revisi 1 proxy baru Anda ke cluster.

   Perlu diperhatikan bahwa deployment bukanlah proses yang instan. Model deployment hybrid yang "pada akhirnya konsisten" berarti bahwa deployment baru akan diluncurkan ke cluster dalam waktu singkat dan tidak seketika.

Meskipun ada beberapa cara untuk memeriksa status deployment proxy di UI, dua langkah berikutnya menjelaskan cara memanggil proxy API yang baru saja Anda deploy dan cara memeriksa status deployment dengan panggilan ke Apigee API.

3. Memanggil proxy API

Ketika UI menunjukkan bahwa proxy di-deploy, Anda dapat mencoba memanggilnya:

1. Jika Anda menggunakan karakter pengganti '*' untuk properti envs.hostAlias seperti yang diinstruksikan dalam Mengonfigurasi cluster, ikuti langkah-langkah berikut sebelum melanjutkan:
   1. Dapatkan IP eksternal untuk layanan istio-ingressgateway. Contoh:

      kubectl get services -n istio-system

      Dalam output, Anda akan melihat sesuatu seperti ini, dengan 34.68.41.240 adalah alamat IP masuk eksternal:

      NAME                       TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)
      istio-ingressgateway       LoadBalancer   10.43.255.19    34.68.41.240      80:31381/TCP,443:31391

   2. Salin nilai EXTERNAL-IP untuk digunakan pada langkah berikutnya. Dalam contoh ini, Anda akan menyalin 34.68.41.240.
2. Panggil proxy menggunakan cURL atau klien REST pilihan Anda:

   curl -v -k https://34.68.41.240/myproxy

   Jika panggilan berhasil, Anda akan melihat output berikut:

   Hello, Guest!