Rekomendasi langkah selanjutnya

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Yang Anda lakukan pada langkah ini

Ikuti langkah-langkah di bawah ini untuk membuat dan men-deploy proxy API pengujian. Terakhir, menguji proxy API dengan mengirimkan permintaan HTTP ke proxy tersebut.

Membuat dan men-deploy proxy API

Izin yang diperlukan untuk langkah ini

Pembuatan dan deployment proxy memerlukan sekumpulan izin minimum. Jika memiliki peran Admin Org Apigee, Anda dapat menyelesaikan tugas ini. Untuk mempelajari peran lain yang dapat Anda pekerjakan, lihat Peran Apigee.

Proses penyediaan untuk Apigee tidak dibuat secara otomatis dan men-deploy proxy API untuk Anda. Anda harus membuat dan men-deploy proxy secara manual.

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan Konsol Google Cloud. UI baru ini disebut Apigee in Cloud Console. Tujuan pada dua tab pertama di bawah ini menjelaskan cara menggunakan Apigee di Konsol Cloud atau Apigee klasik.

UI Apigee di Konsol Cloud

Untuk membuat dan men-deploy proxy pertama Anda:

1. Buka UI Apigee di Konsol Cloud di browser.
2. Pastikan nama organisasi Anda dipilih dari menu drop-down di sudut kiri atas UI. Nama organisasi sama sebagai nama project Google Cloud Anda.
3. Di panel navigasi sebelah kiri, klik Pengembangan proxy > Proxy API.
4. Klik + Buat.

   Halaman Buat proxy akan terbuka.

5. Di kotak Proxy template, pilih Reverse proxy (paling umum).
6. Pada Langkah 1: Detail proxy, konfigurasi proxy Anda dengan nilai berikut:

   Nama parameter	Nilai
   Nama proxy	hello-world
   Jalur dasar	/hello-world
   Target (API yang Sudah Ada)	mocktarget.apigee.net

7. Klik Next.
8. Pada Langkah 2: Deploy (opsional):
   • Lingkungan deployment: Opsional. Menggunakan kotak centang untuk memilih satu atau beberapa lingkungan tempat men-deploy proxy Anda. Jika Anda memilih untuk tidak men-deploy proxy pada tahap ini, biarkan Kolom lingkungan deployment kosong. Anda selalu dapat men-deploy {i>proxy<i} nanti.
   • Akun Layanan: Opsional. Lampirkan akun layanan ke deployment agar proxy Anda dapat mengakses Google Cloud layanan, seperti yang ditentukan dalam peran dan izin akun layanan.
9. Klik Create.

   Proxy API baru Anda dibuat dan di-deploy di lingkungan yang dipilih.

   Catatan: Proxy tidak sepenuhnya di-deploy secara instan. Diperlukan waktu hingga satu menit untuk men-deploy proxy.
10. Halaman Ringkasan proxy untuk proxy yang baru dibuat akan terbuka. Tanda centang hijau di bagian Status menunjukkan bahwa proxy berhasil di-deploy. Jika proxy tidak di-deploy, lihat Men-deploy proxy API dan ikuti langkah-langkah untuk men-deploy-nya secara manual.
11. Di panel navigasi sebelah kiri, pilih Manajemen > Lingkungan > {i>Environment Groups<i}.
12. Salin nama host untuk grup lingkungan Anda. Anda akan menggunakan nama host untuk memanggil proxy API di langkah berikutnya.

UI Apigee

Untuk membuat dan men-deploy proxy pertama Anda:

1. Login ke UI Apigee.
2. Pastikan nama organisasi Anda dipilih dari menu drop-down di sudut kiri atas UI. Nama organisasi adalah sama dengan nama project Google Cloud Anda.
3. Klik Proxy API di tampilan utama.
4. Dari menu drop-down Select Environment, pilih lingkungan.
5. Klik Buat baru.
6. Klik Reverse proxy (paling umum).
7. Di halaman Detail proxy, konfigurasikan proxy Anda dengan nilai berikut:

   Nama parameter	Nilai
   Nama	hello-world
   Jalur dasar	/hello-world
   Target (API yang Sudah Ada)	https://mocktarget.apigee.net

8. Klik Next.
9. Di halaman Kebijakan umum, di bagian Keamanan: Otorisasi pilih Lulus (tanpa otorisasi).
10. Klik Next.
11. Di halaman Ringkasan, di bagian Deployment Opsional, pilih lingkungan tempat proxy akan di-deploy.
12. Klik Create and deploy.

    Proxy API baru Anda telah dibuat dan di-deploy di lingkungan yang dipilih.

    Catatan: Proxy tidak sepenuhnya di-deploy secara instan. Aplikasi ini dapat membutuhkan waktu hingga satu menit untuk diterapkan oleh {i>proxy<i}.
13. Klik Buka daftar proxy. Tanda centang hijau di bawah Status menunjukkan bahwa proxy berhasil di-deploy. Jika proxy tidak di-deploy, lihat Men-deploy proxy API dan ikuti langkah-langkah untuk men-deploy-nya secara manual.
14. Di panel navigasi sebelah kiri, pilih Admin > Lingkungan > Grup.
15. Klik Lihat di Konsol Google Cloud.
16. Salin nama host untuk grup lingkungan Anda. Anda akan menggunakan nama host untuk memanggil proxy API di langkah berikutnya.
17. Tutup konsol Google Cloud.

Memanggil proxy dengan akses internal

Jika Anda mengizinkan akses internal di Langkah 4: Sesuaikan pemilihan rute akses, ikuti petunjuk di: Memanggil proxy API dengan akses khusus internal.

Memanggil proxy dengan akses eksternal

Jika Anda mengizinkan akses eksternal di Langkah 4: Sesuaikan pemilihan rute akses, ikuti langkah-langkah berikut:

1. Siapkan entri DNS untuk host Anda. Berikut adalah dua cara untuk menyelesaikan tugas ini:
   • Pada registrar Anda, buat data A yang mengarahkan nama host grup lingkungan Anda ke IP yang ditampilkan di halaman wizard di bagian Configure DNS. Misalnya, jika nama host adalah sales.example.com dan IP adalah 10.23.0.2, lalu arahkan merekam sales.example.com ke alamat 10.23.0.2.
   • Gunakan Google Cloud DNS untuk memetakan URL ke alamat IP.
2. Uji proxy API dengan mengirimkan permintaan berikut di jendela terminal:
   Catatan: Perubahan DNS segera dipublikasikan, tetapi mungkin perlu waktu untuk diterapkan. Karena keterlambatan ini, Anda mungkin harus menunggu hingga satu jam sebelum Anda dapat memanggil proxy contoh.

   curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
     https://YOUR_INSTANCE_IP_OR_DNS/hello-world

   Dengan keterangan:

   • Nilai header Host (YOUR_ENV_GROUP_HOSTNAME) adalah nama host dari objek Environments > Environment Groups.

   Permintaan yang berhasil akan menampilkan string: Hello, Guest!. Jika permintaan Anda tidak berhasil, lihat Pemecahan masalah.

Langkah berikutnya

• Ikuti tur Apigee tutorial, termasuk:
  • Melindungi dari ancaman yang lonjakan traffic.
  • Mendapatkan gambaran terperinci tentang alur permintaan/respons.