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 Apigee wizard penyediaan. Untuk informasi selengkapnya, lihat Jenis organisasi.

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

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

Membuat organisasi eval dengan wizard penyediaan Apigee

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

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 ditetapkan sebelumnya, 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. Meluncurkan Apigee wizard penyediaan di browser.

   Panel Siapkan Apigee di wizard penyediaan Apigee akan menampilkan:

   

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

   

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

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

   Catatan: Wizard penyediaan Apigee melacak langkah Anda untuk hal ini proyek. Setelah menyelesaikan satu langkah, Anda dapat keluar dari wizard. Ketika Anda kembali dan memasukkan project ID-nya lagi, lanjutkan ke langkah berikutnya.
5. Klik MULAI EVALUASI.
6. Wizard penyediaan Apigee akan menampilkan halaman Menyiapkan Evaluasi Apigee. Ketika Anda menyelesaikan setiap ikon EDIT akan ditampilkan pada langkah berikutnya.

Mengaktifkan API

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran bawaan 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 bawaan 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 pada panel Enable APIs pada wizard. Hal ini akan memungkinkan proyek:
   • API Apigee
   • Compute Engine API
   • Service Networking API
3. Tunggu beberapa saat sampai langkah ini selesai. Setelah selesai, pemeriksaan akan muncul di samping langkah Enable APIs dan langkah Networking akan tersedia.
   Tips: Anda dapat melihat API yang diaktifkan untuk project Anda di API Google Cloud Platform & Dasbor Layanan.

Jaringan

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran bawaan 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 bawaan 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 diotorisasi. Bagi sebagian besar organisasi evaluasi, Anda akan memilih default, yang merupakan jaringan yang dibuat Google Cloud untuk Anda saat Anda membuat project Google Cloud. Jika Anda memiliki jaringan Cloud yang berbeda dan ingin menggunakannya, pilih dari daftar. (Perlu diperhatikan bahwa jaringan harus memiliki blok IP /22 CIDR gratis.)

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

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

   

3. Pilih cara Apigee mengidentifikasi alamat IP untuk jaringan Anda. Untuk Eval di organisasi, biasanya Anda 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 yang spesifik, seperti 10.20.238.0/22.

   Klik Alokasikan DAN HUBUNGKAN untuk melanjutkan.

   Panel {i>wizard<i} membuat jaringan dan mengalokasikan alamat IP untuk layanan dalam jaringan. Pembuatan jaringan memerlukan waktu beberapa menit untuk diselesaikan.

Organisasi evaluasi Apigee

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran bawaan kepada penyediaan 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 bawaan atau Izin pembuatan organisasi (eval org).

Buat organisasi evaluasi Apigee.

1. Klik EDIT di samping Pengelola evaluasi Apigee.

   Panel Buat organisasi evaluasi Apigee akan menampilkan:

   

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

3. Klik PENYEDIAAN.

   Wizard penyediaan Apigee membuat organisasi eval dan instance runtime yang 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, sebuah pemeriksaan akan ditampilkan di samping langkah Organisasi evaluasi Apigee dan langkah Rute akses akan tersedia.

Perutean akses

Pada langkah ini, Anda dapat memilih apakah akan mengekspos cluster baru ke permintaan eksternal atau mempertahankan bersifat pribadi (dan hanya mengizinkan permintaan dari dalam VPC Anda). Cara Anda mengakses Proxy API bergantung pada apakah Anda memutuskan untuk mengizinkan eksternal permintaan terbatas 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 (Halo Dunia) ke instance runtime untuk Anda. Anda kemudian dapat kirim permintaan ke proxy API dari mesin administrasi atau komputer yang memiliki akses ke internet.
Internal	Hanya izinkan akses internal ke proxy API. Wizard akan men-deploy proxy Hello World (Halo Dunia) ke instance runtime untuk Anda. Anda harus membuat VM baru secara manual di dalam VPC dan menghubungkannya. Dari VM baru, Anda bisa mengirim permintaan ke proxy API. Perhatian: Karena batasan pada Aplikasi internal Google Cloud Load Balancer, opsi perutean internal Apigee tidak mendukung Permintaan HTTP 1.0. Permintaan klien yang masuk yang menentukan protokol HTTP 1.0 akan gagal. Versi HTTP yang lebih baru didukung.

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

Akses Eksternal

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

Izin yang diperlukan untuk langkah ini

Anda dapat memberikan peran bawaan 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 bawaan dan Izin perutean akses.

Guna mengonfigurasi perutean untuk akses eksternal di wizard penyediaan Apigee:

1. Buka Apigee wizard penyediaan jika saat ini tidak terbuka. Panel {i>wizard<i} kembali ke {i>output<i} tugas yang belum selesai baru-baru ini di daftar.

2. Klik EDIT di samping Pemilihan rute 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 {i>wildcard<i}, alamat IP eksternal statis dicadangkan untuk Anda. Opsi {i>wildcard <i}mudah digunakan, tetapi hanya direkomendasikan untuk tujuan pengujian.
5. (Opsional) Anda dapat mengubah nama instance virtual machine ke nama lain 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 dan buat perubahan Anda.
6. Pilih subnet yang digunakan untuk menghosting MIG VM yang akan dihubungkan ke Runtime Apigee. Ukuran {i>subnet<i} bisa kecil (mis. /28) karena perlu menjadi {i>host<i} untuk paling banyak tiga VM. Subnet dapat dibagikan dan digunakan oleh VM atau entity lainnya.

7. Jika Anda menggunakan layanan DNS {i>wildcard<i}, perlu diperhatikan bahwa perintah sertifikat akan dibuat untuk domain. Anda tidak perlu melakukan tindakan lebih lanjut. Lihat juga Menggunakan sertifikat SSL yang dikelola Google.

   Jika menggunakan domain Anda sendiri, pilih apakah Anda akan memberikan sertifikat mengelola atau menggunakan sertifikat yang dikelola Google:

   • Menyediakan sertifikat yang dikelola sendiri:
     1. Buat pasangan sertifikat/kunci jika Anda belum memilikinya. Untuk pengujian otentikasi, hal ini bisa berupa sertifikat yang ditandatangani sendiri. Untuk sistem produksi yang harus menggunakan sertifikat yang ditandatangani oleh {i>Certificate Authority<i}. Lihat Menggunakan sertifikat SSL yang dikelola sendiri.
     2. Pada masing-masing {i>field<i}, jelajahi sistem file Anda dan lampirkan file yang berisi sertifikat dan kunci pribadi. Keduanya harus berformat PEM.
   • Gunakan sertifikat yang dikelola Google. Untuk menggunakan sertifikat yang dikelola Google, lakukan tidak 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. Termasuk menyiapkan MIG untuk lalu lintas {i>proxy<i}, membuat {i>firewall<i} aturan, 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 bahwa tanda centang biru di samping semua langkah dalam wizard:

   

10. Klik LANJUTKAN.

    Wizard akan menampilkan Langkah berikutnya yang direkomendasikan. Langkah-langkah yang ditampilkan bergantung apakah Anda menggunakan nama DNS Anda sendiri atau DNS {i>wildcard<i}.

    Catatan: Perubahan DNS segera dipublikasikan, tetapi mungkin perlu waktu untuk diterapkan. Karena keterlambatan ini, Anda mungkin harus menunggu hingga satu jam sebelum Anda dapat memanggil proxy contoh.
    • Jika telah menentukan nama domain Anda sendiri, buka registrar domain dan buat Data untuk nama host domain Anda yang mengarah ke alamat IP yang ditampilkan di wizard. Kapan 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 Anda menggunakan Wizard penyediaan Apigee dan Anda tidak ingin mengizinkan akses eksternal ke proxy API. Namun, Anda hanya ingin membatasi akses ke permintaan internal yang berasal dari dalam VPC.

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

Guna mengonfigurasi perutean untuk akses internal di wizard penyediaan Apigee:

1. Klik EDIT di samping langkah Access Routing.

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

3. Klik LANJUTKAN.

4. Anda akan melihat bahwa ada tanda centang biru di sebelah semua langkah dalam {i>wizard<i}. Ini menunjukkan semua langkah selesai berhasil:

   

5. Klik LANJUTKAN.
6. Untuk menguji organisasi 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, yang Permintaan proxy API dapat dikirim ke load balancer internal (ingress), yang akan meneruskannya ke instance runtime Apigee Anda. Untuk memudahkan, wizard penyediaan membuat dan men-deploy pengujian proxy untuk Anda, yang disebut hello-world.
7. (Opsional) Tambahkan pengguna dan peran untuk organisasi Anda. Lihat Pengguna dan peran.

Jika Anda mengalami kesalahan 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 Anda memiliki Peran Admin Org Apigee, dapat menyelesaikan tugas ini. Untuk mempelajari peran lain yang dapat Anda 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 drop-down proyek.

   Jika proyek Anda tidak ada dalam daftar proyek yang tersedia, Anda mungkin perlu menunggu beberapa saat sebelum data tersebut tersedia. Muat ulang browser Anda 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 > Proxy API. Apigee dibuat proxy API yang disebut hello-world untuk Anda saat menyediakan organisasi eval.

   Lokasi	Properti	Nilai
   Kembangkan > Proxy API	Proxy API	hello-world

Menghapus organisasi evaluasi

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