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.

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan konsol Google Cloud. UI baru ini disebut konsol Apigee di Cloud. Petunjuk di dua tab pertama di bawah 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 Cloud Console di browser.
2. Pastikan nama organisasi Anda dipilih dari menu drop-down di sudut kiri atas UI. Nama organisasi sama dengan nama project Google Cloud Anda.
3. Di panel navigasi sebelah kiri, klik Pengembangan proxy > Proxy API.
4. Klik + Buat.

   Halaman Create a proxy akan terbuka.

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

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

7. Klik Berikutnya.
8. Di Langkah 2: Men-deploy (opsional):
   • Lingkungan deployment: Opsional. Gunakan kotak centang untuk memilih satu atau beberapa lingkungan tempat proxy akan di-deploy. Jika Anda memilih untuk tidak men-deploy proxy pada tahap ini, kosongkan kolom Deployment environments. Anda dapat men-deploy proxy nanti.
   • Akun Layanan: Opsional. Lampirkan akun layanan ke deployment untuk memungkinkan proxy Anda mengakses layanan Google Cloud, 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-deploynya secara manual.
11. Di panel navigasi sebelah kiri, pilih Pengelolaan > Lingkungan > Grup Lingkungan.
12. Salin nama host untuk grup lingkungan Anda. Anda akan menggunakan nama host ini 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 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 Detail proxy, konfigurasikan proxy 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, pada bagian Keamanan: Otorisasi, pilih Pass through (tanpa otorisasi).
10. Klik Berikutnya.
11. Di halaman Summary , pada 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 di-deploy sepenuhnya secara instan. Diperlukan waktu hingga satu menit untuk men-deploy proxy.
13. Klik Buka daftar proxy. Tanda centang hijau di bagian Status menunjukkan bahwa proxy berhasil di-deploy. Jika proxy tidak di-deploy, lihat Deploying an API proxy dan ikuti langkah-langkah untuk men-deploynya 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 ini 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: Menyesuaikan 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 dua cara untuk menyelesaikan tugas ini:
   • Di registrar, buat data A yang mengarahkan nama host grup lingkungan Anda ke IP yang ditampilkan di halaman wizard pada bagian Configure DNS. Misalnya, jika nama host Anda adalah sales.example.com dan IP-nya adalah 10.23.0.2, arahkan data 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 mengirimkan permintaan berikut di jendela terminal:
   Catatan: Perubahan DNS langsung dipublikasikan, tetapi penerapannya mungkin memerlukan 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 keterangan:

   • 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:
  • Mencegah lonjakan traffic secara tiba-tiba.
  • Mendapatkan tampilan mendetail tentang alur permintaan/respons.