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 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 memberi penyedia Apigee peran Apigee Organization Admin yang telah ditentukan sebelumnya, atau memberikan lebih banyak izin 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 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 bahwa project ID tersebut, 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 Anda memulai untuk menggunakan wizard penyediaan Apigee guna 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 ke halaman tersebut dan memasukkan project ID lagi, halaman akan melanjutkan ke langkah berikutnya.
5. Klik MULAI EVALUASI.
6. Wizard penyediaan Apigee menampilkan halaman Siapkan Evaluasi Apigee. Saat Anda menyelesaikan setiap langkah, ikon EDIT akan ditampilkan di samping langkah berikutnya.

Mengaktifkan API

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran yang telah ditetapkan sebelumnya 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. Tindakan ini akan mengaktifkan 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 sebelumnya 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.

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

1. Klik EDIT di samping Networking.

   Panel Siapkan jaringan menampilkan:

   

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

   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 dropdown, minta pengguna yang memiliki izin untuk mengelola jaringan tersebut login guna 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 Anda ingin Apigee mengidentifikasi alamat IP untuk jaringan Anda. Untuk organisasi eval, sebaiknya pilih Automatically allocate IP range. Jika Anda memilih untuk menentukan rentang, pilih Select one or more existing IP ranges or create a new one. 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 sebelumnya kepada penyedia Apigee yang menyertakan izin yang diperlukan untuk menyelesaikan tugas ini, atau memberikan izin yang lebih terperinci untuk memberikan hak istimewa terendah yang diperlukan. Lihat Peran bawaan atau Izin pembuatan organisasi (eval org).

Buat organisasi evaluasi Apigee.

1. Klik EDIT di samping Organisasi evaluasi Apigee.

   Panel Buat organisasi evaluasi Apigee menampilkan:

   

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 organisasi evaluasi dan instance runtime terkaitnya. Organisasi eval 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 Pemetaan rute akses akan tersedia.

Pemilihan rute akses

Pada langkah ini, Anda memilih apakah akan mengekspos cluster baru ke permintaan eksternal atau membuatnya tetap bersifat pribadi (dan hanya mengizinkan permintaan dari dalam VPC). 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 untuk Anda. Kemudian, Anda dapat mengirim permintaan ke proxy API dari mesin administrasi atau mesin apa 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 terhubung ke VM tersebut. Dari VM baru, 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 bagian 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 sebelumnya 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 pemilihan rute akses.

Untuk mengonfigurasi pemilihan rute untuk 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 Pemetaan rute akses.

3. Pilih Aktifkan akses internet dari panel Konfigurasi akses.

   Wizard akan menampilkan opsi tambahan untuk mengonfigurasi instance:

   

4. Untuk setelan domain, masukkan nama DNS yang valid yang Anda miliki, atau pilih untuk menggunakan layanan DNS karakter pengganti, seperti nip.io. Jika Anda memilih layanan karakter pengganti, 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 virtual machine menjadi sesuatu yang lebih bermakna. Sebagai bagian dari proses penyediaan, Apigee membuat grup instance terkelola (MIG) yang berisi beberapa VM untuk melakukan 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 untuk menjembatani ke runtime Apigee. Ukuran subnet dapat 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 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, 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 Anda dan lampirkan file yang berisi sertifikat dan kunci pribadi. Keduanya harus dalam format 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 SET ACCESS.

   Apigee menyiapkan cluster Anda untuk akses eksternal. Hal ini mencakup penyiapan MIG untuk memaketkan traffic, membuat aturan firewall, mengupload sertifikat, dan membuat 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 akan menampilkan Rekomendasi langkah berikutnya. Langkah-langkah yang ditampilkan bergantung pada apakah Anda menggunakan nama DNS Anda sendiri atau DNS karakter pengganti.

    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.
    • Jika Anda menentukan nama domain Anda sendiri, buka registrar domain Anda 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.

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

Akses Internal

Bagian ini menjelaskan cara mengonfigurasi pemilihan rute saat Anda menggunakan wizard penyediaan Apigee dan 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 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.

Untuk mengonfigurasi pemilihan rute untuk akses internal di wizard penyediaan Apigee:

1. Klik EDIT di samping langkah Pemilihan Rute Akses.

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

3. Klik LANJUTKAN.

4. Anda akan melihat bahwa ada tanda centang biru di samping semua langkah dalam wizard. Hal ini menunjukkan bahwa semua langkah 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 tempat permintaan proxy API dapat dikirim 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 BUKA APIGEE CONSOLE 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.

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

3. Klik Admin untuk melihat konfigurasi organisasi Anda:

   Lokasi	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 Proxies. Apigee membuat proxy API bernama hello-world untuk Anda saat Anda menyediakan organisasi 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.