Menyediakan organisasi evaluasi

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Bagian ini menjelaskan cara menyiapkan organisasi evaluasi Apigee (atau eval org) menggunakan wizard penyediaan Apigee. Untuk informasi selengkapnya, lihat Jenis organisasi.

Tips: Sebaiknya tinjau topik arsitektur Apigee sebelum melakukan langkah-langkah penyediaan.

Video: Tonton video singkat ini untuk mempelajari cara menyiapkan dan menguji organisasi evaluasi Apigee.

Membuat organisasi evaluasi dengan wizard penyediaan Apigee

Bagian ini menjelaskan cara menggunakan wizard penyediaan Apigee untuk membuat organisasi evaluasi.

Mulai

Izin yang diperlukan untuk langkah ini

Penyedia Apigee harus memiliki izin yang memadai untuk menggunakan wizard. Untuk memberikan izin ini, admin Google Cloud dapat memberikan peran Admin Organisasi Apigee yang telah ditetapkan kepada penyedia Apigee, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan.

1. Pastikan Anda telah memenuhi prasyarat sebelum Anda melanjutkan.
2. Buat project Google Cloud jika Anda belum melakukannya.

3. Luncurkan wizard penyediaan Apigee di browser.

   Panel Set up Apigee di wizard penyediaan Apigee akan menampilkan:

   

4. Masukkan ID project Google Cloud Anda di kolom Project.

   

   Jika tidak memiliki izin untuk mengelola project, atau jika project tidak ada, Anda akan melihat pesan error. Pastikan project ID yang Anda masukkan sudah benar dan merupakan project ID, bukan nama project, jika berbeda.

   Jika project sudah dikaitkan dengan akun Apigee berbayar, Anda tidak dapat membuat organisasi evaluasi untuk project tersebut. Lihat Penyediaan > Organisasi berbayar > Sebelum memulai untuk menggunakan wizard penyediaan Apigee guna menyediakan organisasi berbayar.

   Catatan: Wizard penyediaan Apigee melacak langkah-langkah Anda untuk project ini. Setelah menyelesaikan satu langkah, Anda dapat keluar dari wizard. Setelah Anda kembali ke sana dan memasukkan project ID lagi, tindakan ini akan dilanjutkan ke langkah berikutnya.
5. Klik MULAI EVALUASI.
6. Wizard penyediaan Apigee akan menampilkan halaman Set up Apigee Evaluation. Setelah Anda menyelesaikan setiap langkah, ikon EDIT akan ditampilkan pada langkah berikutnya.

Mengaktifkan API

Izin yang diperlukan untuk langkah ini

Anda dapat memberi penyedia Apigee peran bawaan yang mencakup izin yang diperlukan untuk menyelesaikan tugas ini, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan. Lihat Peran yang telah ditetapkan dan Izin pengaktifan API.

Aktifkan Google Cloud API yang diperlukan agar Apigee dapat berfungsi.

1. Klik EDIT di samping Aktifkan API guna mengaktifkan API yang diperlukan untuk organisasi evaluasi Anda.
2. Klik ENABLE APIS di panel Enable APIs di wizard. Tindakan ini akan mengaktifkan project Anda:
   • API Apigee
   • Compute Engine API
   • Service Networking API
3. Tunggu beberapa saat sampai langkah ini selesai. Setelah selesai, tanda centang akan ditampilkan di samping langkah Enable APIs, dan langkah Networking akan tersedia.
   Tips: Anda dapat melihat API yang diaktifkan untuk project Anda di Dasbor Google Cloud Platform APIs & Services.

Networking

Izin yang diperlukan untuk langkah ini

Anda dapat memberi penyedia Apigee peran bawaan yang mencakup izin yang diperlukan untuk menyelesaikan tugas ini, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan. Lihat Peran yang telah ditetapkan dan Izin jaringan layanan.

Menyiapkan jaringan untuk Virtual Private Cloud (VPC) lokal Anda.

1. Klik EDIT di samping Networking.

   Panel Set up networking akan menampilkan:

   

2. Pilih jaringan dari menu drop-down Jaringan yang diizinkan. Untuk sebagian besar organisasi evaluasi, Anda akan memilih default, yaitu jaringan yang dibuat oleh Google Cloud saat Anda membuat project Google Cloud. Jika Anda memiliki jaringan Cloud lain dan ingin menggunakannya, pilih jaringan tersebut dari daftar. (Perhatikan bahwa jaringan harus memiliki blok alamat IP /22 CIDR.)

   Jika project Anda menggunakan jaringan Virtual Private Cloud (VPC) bersama, pilih jaringan yang mengelola setelan jaringan untuk project Anda. Jika Anda tidak melihat jaringan tersebut dalam daftar dropdown, minta pengguna dengan izin untuk mengelola login jaringan guna menyelesaikan langkah ini. Kemudian Anda dapat kembali ke wizard dan melanjutkan. Untuk informasi selengkapnya tentang jaringan VPC Bersama, lihat Menggunakan jaringan VPC Bersama.

   Setelah Anda memilih jaringan, wizard akan menampilkan opsi pemilihan rentang peering:

   

3. Pilih cara Apigee mengidentifikasi alamat IP untuk jaringan Anda. Untuk organisasi evaluasi, cara yang paling umum adalah memilih Alokasikan rentang IP secara otomatis. Jika Anda memilih untuk menentukan rentang, pilih Pilih satu atau beberapa rentang IP yang ada atau buat yang baru. Anda harus menentukan nama dan rentang IP spesifik, seperti 10.20.238.0/22.

   Klik AJUKAN DAN HUBUNGKAN untuk melanjutkan.

   Wizard akan membuat jaringan dan mengalokasikan alamat IP untuk layanan dalam jaringan tersebut. Pembuatan jaringan memerlukan waktu beberapa menit untuk diselesaikan.

Organisasi evaluasi Apigee

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran bawaan penyedia Apigee yang mencakup izin yang diperlukan untuk menyelesaikan tugas ini, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan. Lihat Peran yang telah ditetapkan atau Izin pembuatan organisasi (eval org).

Buat organisasi Apigee eval.

1. Klik EDIT di samping Organisasi evaluasi Apigee.

   Panel Create an Apigee evaluasi organization menampilkan:

   

2. Pilih region hosting analisis dan lokasi runtime. Untuk mengetahui daftar Analisis API Apigee dan lokasi runtime yang tersedia, lihat Lokasi Apigee.

3. Klik KETENTUAN.

   Wizard penyediaan Apigee membuat organisasi evaluasi dan instance runtime terkaitnya. Organisasi evaluasi akan memiliki nama dan ID yang sama dengan project ID Anda.

   Catatan: Proses ini dapat memerlukan waktu hingga 45 menit.

   Setelah selesai, pemeriksaan akan ditampilkan di samping langkah Organisasi evaluasi Apigee dan langkah Pemilihan rute akses akan tersedia.

Pemilihan rute akses

Pada langkah ini, Anda dapat memilih apakah akan mengekspos cluster baru ke permintaan eksternal atau membuatnya tetap pribadi (dan hanya mengizinkan permintaan dari dalam VPC Anda). Cara Anda mengakses proxy API bergantung pada apakah Anda memutuskan untuk mengizinkan permintaan eksternal atau permintaan terbatas hanya untuk internal:

Jenis Akses	Deskripsi proses konfigurasi dan deployment
Eksternal	Izinkan akses eksternal ke proxy API. Wizard akan men-deploy proxy Hello World ke instance runtime untuk Anda. Selanjutnya, Anda dapat mengirim permintaan ke proxy API dari mesin administrasi atau mesin mana pun yang memiliki akses ke internet.
Internal	Hanya izinkan akses internal ke proxy API. Wizard akan men-deploy proxy Hello World ke instance runtime untuk Anda. Anda harus membuat VM baru secara manual di dalam VPC dan menghubungkannya. Dari VM baru ini, Anda dapat mengirim permintaan ke proxy API. Perhatian: Karena batasan pada Load Balancer Aplikasi internal Google Cloud, opsi pemilihan rute internal Apigee tidak mendukung permintaan HTTP 1.0. Permintaan klien masuk yang menentukan protokol HTTP 1.0 akan gagal. Versi HTTP yang lebih baru didukung.

Ikuti langkah-langkah di tab Akses Eksternal atau Akses Internal di bawah:

Akses Eksternal

Bagian ini menjelaskan cara mengonfigurasi perutean saat Anda menggunakan wizard penyediaan Apigee dan ingin mengizinkan akses eksternal ke proxy API Anda.

Izin yang diperlukan untuk langkah ini

Anda dapat memberi penyedia Apigee peran bawaan yang mencakup izin yang diperlukan untuk menyelesaikan tugas ini, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan. Lihat Peran yang telah ditetapkan dan Izin pemilihan rute akses.

Untuk mengonfigurasi pemilihan rute bagi akses eksternal di wizard penyediaan Apigee:

1. Buka wizard penyediaan Apigee jika saat ini tidak terbuka. Wizard akan kembali ke tugas terbaru yang belum selesai dalam daftar.

2. Klik EDIT di samping Pemilihan rute akses.

3. Pilih Enable internet access dari panel Configure access.

   Wizard akan menampilkan opsi tambahan untuk mengonfigurasi instance:

   

4. Untuk setelan domain, masukkan nama DNS yang valid milik Anda, atau pilih untuk menggunakan layanan DNS karakter pengganti, seperti nip.io. Jika memilih layanan karakter pengganti, alamat IP eksternal statis akan disediakan untuk Anda. Opsi karakter pengganti mudah digunakan, tetapi hanya direkomendasikan untuk tujuan pengujian.
5. (Opsional) Anda dapat mengubah nama instance virtual machine menjadi sesuatu yang lebih bermakna. Sebagai bagian dari proses penyediaan, Apigee membuat grup instance terkelola (MIG) yang berisi beberapa VM untuk mem-proxy traffic antara load balancer dan runtime Apigee. Untuk mengubah nama instance VM, klik EDIT, lalu buat perubahan.
6. Pilih subnet yang digunakan untuk menghosting MIG VM yang akan dihubungkan ke runtime Apigee. Ukuran subnet boleh kecil (misalnya /28) karena harus menghosting maksimal tiga VM. Subnet dapat dibagikan dan digunakan oleh VM atau entitas lainnya.

7. Jika Anda menggunakan layanan DNS karakter pengganti, perhatikan bahwa sertifikat yang dikelola Google akan dibuat untuk domain. Anda tidak perlu melakukan tindakan apa pun. Lihat juga Menggunakan sertifikat SSL yang dikelola Google.

   Jika menggunakan domain Anda sendiri, pilih untuk memberikan sertifikat yang Anda kelola atau gunakan sertifikat yang dikelola Google:

   • Sediakan sertifikat yang dikelola sendiri:
     1. Buat pasangan sertifikat/kunci jika Anda belum memilikinya. Untuk lingkungan pengujian, sertifikat ini dapat berupa sertifikat yang ditandatangani sendiri. Untuk sistem produksi, Anda harus menggunakan sertifikat yang ditandatangani oleh Certificate Authority. Lihat Menggunakan sertifikat SSL yang dikelola sendiri.
     2. Di kolom masing-masing, jelajahi sistem file dan lampirkan file yang berisi sertifikat dan kunci pribadi. Keduanya harus berformat PEM.
   • Menggunakan sertifikat yang dikelola Google. Untuk menggunakan sertifikat yang dikelola Google, jangan masukkan sertifikat yang ditandatangani atau kunci pribadi RSA. Sertifikat yang dikelola Google akan dibuat untuk Anda.

8. Klik TETAPKAN AKSES.

   Apigee menyiapkan cluster Anda untuk akses eksternal. Hal ini termasuk menyiapkan MIG untuk melakukan proxy traffic, membuat aturan firewall, mengupload sertifikat, dan membuat load balancer.

   Proses ini dapat memerlukan waktu beberapa menit.

9. Setelah Apigee selesai menyiapkan akses runtime, Anda akan melihat tanda centang biru di samping semua langkah dalam wizard:

   

10. Klik CONTINUE.

    Wizard akan menampilkan Recommended next steps. Langkah-langkah yang ditampilkan bergantung pada apakah Anda menggunakan nama DNS Anda sendiri atau DNS karakter pengganti.

    Catatan: Perubahan DNS akan segera dipublikasikan, tetapi mungkin perlu waktu beberapa saat untuk diterapkan. Karena penundaan ini, Anda mungkin harus menunggu hingga satu jam sebelum dapat memanggil proxy contoh.
    • Jika Anda menentukan nama domain Anda sendiri, buka registrar domain dan buat data A untuk nama host domain yang mengarah ke alamat IP yang ditampilkan di wizard. Setelah selesai, klik Launch untuk memanggil proxy API yang di-deploy untuk Anda.
    • Jika Anda menggunakan DNS karakter pengganti, cukup klik Launch untuk memanggil proxy API hello-world yang di-deploy untuk Anda.
11. (Opsional) Tambahkan pengguna dan peran untuk organisasi Anda. Lihat Pengguna dan peran.

Anda kini telah menyelesaikan langkah-langkah untuk mengonfigurasi akses internet eksternal ke proxy API.

Akses Internal

Bagian ini menjelaskan cara mengonfigurasi perutean saat menggunakan wizard penyediaan Apigee dan tidak ingin mengizinkan akses eksternal ke proxy API Anda. Sebagai gantinya, Anda ingin membatasi akses ke permintaan internal saja yang berasal dari dalam VPC.

Perhatian: Karena batasan pada Load Balancer Aplikasi internal Google Cloud, opsi pemilihan rute internal Apigee tidak mendukung permintaan HTTP 1.0. Permintaan klien masuk yang menentukan protokol HTTP 1.0 akan gagal. Versi HTTP yang lebih baru didukung.

Guna mengonfigurasi perutean bagi akses internal di wizard penyediaan Apigee:

1. Klik EDIT di samping langkah Access Routing.

2. Pilih No internet access di panel Configure access to 'eval-group' env group.

3. Klik CONTINUE.

4. Anda akan melihat tanda centang biru di samping semua langkah dalam wizard. Hal ini menunjukkan bahwa semua langkah berhasil diselesaikan:

   

5. Klik CONTINUE.
6. Untuk menguji organisasi Anda yang baru disediakan, ikuti petunjuk di Memanggil proxy API dengan akses khusus internal. Pada langkah-langkah tersebut, Anda akan membuat Virtual Machine (VM) di dalam VPC Anda yang dapat digunakan untuk mengirim permintaan proxy API ke load balancer internal (ingress) yang meneruskannya ke instance runtime Apigee. Untuk memudahkan, wizard penyediaan membuat dan men-deploy proxy pengujian untuk Anda, yang disebut hello-world.
7. (Opsional) Tambahkan pengguna dan peran untuk organisasi Anda. Lihat Pengguna dan peran.

Jika Anda mengalami error selama bagian proses ini, lihat Pemecahan masalah.

Lihat detail organisasi

Terakhir, buka UI Apigee untuk melihat detail tentang organisasi Anda.

Izin yang diperlukan untuk langkah ini

Jika memiliki peran Admin Org Apigee, Anda dapat menyelesaikan tugas ini. Untuk mempelajari peran lain yang dapat Anda terapkan dalam menggunakan UI Apigee, lihat Peran Apigee.

1. Klik BUKA KONSOL APIGEE untuk membuka UI Apigee.
2. Pastikan project yang baru saja Anda buat dipilih di UI Apigee. Contoh:

   

   Jika organisasi yang baru saja Anda buat bukan yang dipilih, klik nama project untuk menampilkan daftar project secara drop-down.

   Jika project Anda tidak tercantum dalam daftar project yang tersedia, Anda mungkin perlu menunggu beberapa saat sebelum project tersebut tersedia. Refresh browser Anda dan periksa lagi.

3. Klik Admin untuk melihat konfigurasi organisasi Anda:

   Location	Properti	Nilai
   Admin > Instance	Nama	eval-instance
   	Alamat IP	Ini adalah alamat IP load balancer internal organisasi Anda.
   Admin > Lingkungan > Ringkasan	Nama lingkungan	eval
   Admin > Lingkungan > Grup	Grup lingkungan	eval-group
   Admin > Lingkungan > Grup	Nama host	PROJECT_NAME-eval.apigee.net

4. Klik Develop > API Proxy. Apigee membuat proxy API bernama hello-world untuk Anda saat Anda menyediakan organisasi evaluasi.

   Location	Properti	Nilai
   Pengembangan > Proxy API	Proxy API	hello-world

Menghapus organisasi evaluasi

Untuk menghapus (atau mencabut akses) organisasi eval, gunakan perintah gcloud alpha apigee organizations delete.