Menyediakan organisasi evaluasi

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

Lihat dokumentasi Apigee Edge.

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

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

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

Membuat org evaluasi dengan wizard penyediaan Apigee

Bagian ini menjelaskan cara menggunakan wizard penyediaan Apigee untuk membuat org 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 bawaan kepada penyedia Apigee, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan.

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

3. Luncurkan wizard penyediaan Apigee di browser.

   Panel Siapkan Apigee di wizard penyediaan Apigee akan ditampilkan:

   

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

   

   Jika Anda 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 project ID tersebut adalah project ID, bukan nama project, jika keduanya berbeda.

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

   Catatan: Wizard penyediaan Apigee melacak langkah-langkah Anda untuk project ini. Setelah menyelesaikan langkah, Anda dapat keluar dari wizard. Saat Anda kembali dan memasukkan project ID lagi, proses akan dilanjutkan ke langkah berikutnya.
5. Klik MULAI EVALUASI.
6. Wizard penyediaan Apigee akan menampilkan halaman Setel Evaluasi Apigee. Saat Anda menyelesaikan setiap langkah, ikon EDIT akan ditampilkan di langkah berikutnya.

Mengaktifkan API

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran yang telah ditetapkan kepada 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 standar dan izin pengaktifan API.

Aktifkan Google Cloud API yang diperlukan agar Apigee dapat berfungsi.

1. Klik EDIT di samping Enable APIs untuk mengaktifkan API yang diperlukan untuk organisasi evaluasi Anda.
2. Klik ENABLE APIS di panel Enable APIs pada wizard. Hal ini akan diaktifkan untuk project Anda:
   • Apigee API
   • Compute Engine API
   • Service Networking API
3. Tunggu beberapa saat hingga langkah 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 API & Layanan Google Cloud Platform.

Jaringan

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran yang telah ditetapkan kepada 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 standar dan Izin jaringan layanan.

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

1. Klik EDIT di samping Jaringan.

   Panel Set up networking akan ditampilkan:

   

2. Pilih jaringan dari menu drop-down Jaringan yang diizinkan. Untuk sebagian besar organisasi evaluasi, Anda akan memilih default, yaitu jaringan yang dibuat Google Cloud untuk Anda 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 CIDR /22 alamat IP yang tersedia.)

   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 di daftar drop-down, minta pengguna yang memiliki izin untuk mengelola jaringan login untuk menyelesaikan langkah ini. Kemudian, Anda dapat kembali ke wizard dan melanjutkan. Untuk mengetahui 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, opsi Alokasikan rentang IP secara otomatis adalah opsi yang paling umum dipilih. Jika Anda lebih memilih untuk menentukan rentang, pilih Pilih satu atau beberapa rentang IP yang ada atau buat yang baru. Anda harus menentukan nama dan rentang IP tertentu, seperti 10.20.238.0/22.

   Klik ALOKASIKAN DAN HUBUNGKAN untuk melanjutkan.

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

Organisasi evaluasi Apigee

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran yang telah ditetapkan kepada 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 standar atau Izin pembuatan organisasi (evaluasi org).

Buat organisasi evaluasi Apigee.

1. Klik EDIT di samping Organisasi evaluasi Apigee.

   Panel Create an Apigee evaluation organization akan ditampilkan:

   

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

3. Klik PROVISION.

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

   Catatan: Proses ini dapat memerlukan waktu hingga 45 menit.

   Setelah selesai, tanda centang akan ditampilkan di samping langkah Organisasi evaluasi Apigee dan langkah Perutean akses akan tersedia.

Pemilihan rute akses

Pada langkah ini, Anda memilih apakah akan mengekspos cluster baru ke permintaan eksternal atau menjaganya 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	Mengizinkan akses eksternal ke proxy API. Wizard akan men-deploy proxy Hello World ke instance runtime Anda. Kemudian, 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 Anda. Anda harus membuat VM baru secara manual di dalam VPC dan menghubungkannya. Dari VM baru, Anda dapat mengirim permintaan ke proxy API. Perhatian: Karena batasan pada Load Balancer Aplikasi internal Google Cloud, opsi perutean 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 pemilihan rute saat Anda menggunakan wizard penyediaan Apigee dan ingin mengizinkan akses eksternal ke proxy API Anda.

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran yang telah ditetapkan kepada 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 standar dan Izin perutean akses.

Untuk mengonfigurasi perutean untuk akses eksternal di wizard penyediaan Apigee:

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

2. Klik EDIT di samping Perutean akses.

3. Pilih Aktifkan akses internet dari panel Konfigurasi akses.

   Wizard menampilkan opsi tambahan untuk mengonfigurasi instance:

   

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

7. Jika Anda menggunakan layanan DNS karakter pengganti, perlu diketahui bahwa sertifikat yang dikelola Google akan dibuat untuk domain tersebut. Anda tidak perlu melakukan tindakan lebih lanjut. Lihat juga Menggunakan sertifikat SSL yang dikelola Google.

   Jika Anda menggunakan domain sendiri, pilih apakah akan menyediakan sertifikat yang Anda kelola atau menggunakan sertifikat yang dikelola Google:

   • Berikan sertifikat yang dikelola sendiri:
     1. Buat pasangan kunci/sertifikat 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 Otoritas Sertifikat. Lihat Menggunakan sertifikat SSL yang dikelola sendiri.
     2. Di kolom masing-masing, jelajahi sistem file Anda dan lampirkan file yang berisi sertifikat dan kunci pribadi. Keduanya harus diformat PEM.
   • Gunakan sertifikat yang dikelola Google. Untuk menggunakan sertifikat yang dikelola Google, jangan memasukkan sertifikat yang ditandatangani atau kunci pribadi RSA. Sertifikat yang dikelola Google akan dibuat untuk Anda.

8. Klik SETEL AKSES.

   Apigee menyiapkan cluster Anda untuk akses eksternal. Hal ini mencakup penyiapan MIG untuk memproksi traffic, pembuatan aturan firewall, upload sertifikat, dan pembuatan load balancer.

   Proses ini dapat memerlukan waktu beberapa menit hingga selesai.

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

   

10. Klik LANJUTKAN.

    Wizard menampilkan Langkah berikutnya yang direkomendasikan. Langkah-langkah yang ditampilkan bergantung pada apakah Anda menggunakan nama DNS Anda sendiri atau DNS karakter pengganti.

    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.
    • Jika Anda menentukan nama domain Anda sendiri, buka registrar domain Anda dan buat data A untuk nama host domain Anda 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 wildcard, 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.

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

Akses Internal

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

Perhatian: Karena batasan pada Load Balancer Aplikasi internal Google Cloud, opsi perutean 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.

Untuk mengonfigurasi perutean untuk akses internal di wizard penyediaan Apigee:

1. Klik EDIT di samping langkah Perutean Akses.

2. Pilih Tidak ada akses internet di panel Konfigurasi akses ke grup lingkungan 'eval-group'.

3. Klik LANJUTKAN.

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

   

5. Klik LANJUTKAN.
6. Untuk menguji organisasi yang baru disediakan, ikuti petunjuk di Memanggil proxy API dengan akses khusus internal. Dalam langkah-langkah tersebut, Anda akan membuat Virtual Machine (VM) di dalam VPC yang dapat mengirim permintaan proxy API ke load balancer internal (ingress), yang meneruskannya ke instance runtime Apigee Anda. 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.

Melihat 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 gunakan untuk menggunakan UI Apigee, lihat Peran Apigee.

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

   

   Jika org yang baru saja Anda buat bukan yang dipilih, klik nama project untuk melihat daftar project.

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

3. Klik Admin untuk melihat konfigurasi organisasi Anda:

   Lokasi	Properti	Nilai
   Admin > Instances	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 Proxies. Apigee membuat proxy API bernama hello-world untuk Anda saat Anda menyediakan org evaluasi.

   Lokasi	Properti	Nilai
   Develop > API Proxies	Proxy API	hello-world

Menghapus organisasi evaluasi

Untuk menghapus (atau membatalkan penyediaan) organisasi evaluasi, gunakan perintah gcloud alpha apigee organizations delete.