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 untuk membuat dan men-deploy proxy API pengujian. Terakhir, uji proxy API dengan mengirim permintaan HTTP ke proxy tersebut.

Membuat dan men-deploy proxy API

Izin yang diperlukan untuk langkah ini

Membuat dan men-deploy proxy memerlukan serangkaian izin minimum. Jika memiliki peran Admin Org Apigee, Anda dapat menyelesaikan tugas ini. Untuk mempelajari peran lain yang dapat Anda gunakan, lihat Peran Apigee.

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

UI Apigee di Konsol Cloud

Untuk membuat dan men-deploy proxy pertama Anda:

1. Di konsol Google Cloud , buka halaman Proxy development > API proxies.

   Buka proxy API

2. Pastikan nama organisasi Anda dipilih dari pemilih project di panel Google Cloud. Nama organisasi sama dengan nama project Google Cloud Anda.
3. Klik + Create.

   Halaman Create a proxy akan terbuka.

4. Di kotak Proxy template, pilih Reverse proxy (most common).
5. Di Langkah 1: Detail proxy, konfigurasikan proxy Anda dengan nilai berikut:

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

6. Klik Berikutnya.
7. Di Langkah 2: Deploy (opsional):
   • Lingkungan deployment: Opsional. Gunakan kotak centang untuk memilih satu atau beberapa lingkungan tempat Anda akan men-deploy proxy. Jika Anda memilih untuk tidak men-deploy proxy saat ini, biarkan kolom Lingkungan deployment kosong. Anda selalu dapat men-deploy proxy nanti.
   • Akun Layanan: Opsional. Lampirkan akun layanan ke deployment Anda agar proxy dapat mengakses layanan Google Cloud, seperti yang ditentukan dalam peran dan izin akun layanan.
8. Klik Buat.

   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 agar proxy di-deploy.
9. Halaman Proxy summary 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.
10. Di panel navigasi kiri, pilih Management > Environments > Environment Groups.
11. Salin nama host untuk grup lingkungan Anda. Anda akan menggunakan nama host ini untuk memanggil proxy API pada langkah berikutnya.

Apigee Klasik

Untuk membuat dan men-deploy proxy pertama Anda:

1. Login ke UI Apigee.
2. Pastikan nama organisasi Anda dipilih dari menu drop-down di pojok kiri atas UI. Nama organisasi sama dengan nama project Google Cloud Anda.
3. Klik API Proxies 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 Proxy details, konfigurasi proxy Anda dengan nilai berikut:

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

8. Klik Berikutnya.
9. Di halaman Kebijakan umum, di bagian Keamanan: Otorisasi, pilih Teruskan (tanpa otorisasi).
10. Klik Berikutnya.
11. Di halaman Summary, di bagian Optional Deployment, pilih lingkungan tempat proxy akan di-deploy.
12. Klik Buat dan deploy.

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

    Catatan: Proxy tidak sepenuhnya di-deploy secara instan. Proxy dapat memerlukan waktu hingga satu menit untuk di-deploy.
13. Klik Go to proxy list. 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.
14. Di panel navigasi 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 ini untuk memanggil proxy API pada langkah berikutnya.
17. Tutup konsol Google Cloud .

Memanggil proxy dengan akses internal

Jika Anda mengizinkan akses internal di Langkah 4: Sesuaikan perutean 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 perutean akses, ikuti langkah-langkah berikut:

1. Siapkan entri DNS untuk host Anda. Berikut dua cara untuk menyelesaikan tugas ini:
   • Di registrar Anda, buat data A yang mengarahkan nama host grup lingkungan Anda ke IP yang ditampilkan di halaman wizard pada bagian Konfigurasi DNS. Misalnya, jika nama host Anda adalah sales.example.com dan IP-nya adalah 10.23.0.2, arahkan catatan untuk sales.example.com ke alamat 10.23.0.2.
   • Gunakan Cloud DNS Google untuk memetakan URL ke alamat IP.
2. Uji proxy API dengan mengirim permintaan berikut di jendela terminal:
   Catatan: Perubahan DNS akan langsung dipublikasikan, tetapi penerapannya membutuhkan waktu beberapa saat. Karena penundaan ini, Anda mungkin harus menunggu hingga satu jam sebelum dapat memanggil proxy contoh.

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

   Dengan:

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

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

Langkah berikutnya

• Ikuti tur tutorial Apigee, termasuk:
  • Melindungi dari lonjakan traffic yang tiba-tiba.
  • Mendapatkan tampilan mendetail dari alur permintaan/respons.