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.
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
- Pastikan Anda telah memenuhi prasyarat sebelum melanjutkan.
- Buat project Google Cloud jika Anda belum melakukannya.
-
Meluncurkan Apigee wizard penyediaan di browser.
Panel Siapkan Apigee di wizard penyediaan Apigee akan menampilkan:
-
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.
- Klik MULAI EVALUASI.
- Wizard penyediaan Apigee akan menampilkan halaman Menyiapkan Evaluasi Apigee. Ketika Anda menyelesaikan setiap ikon EDIT akan ditampilkan pada langkah berikutnya.
Mengaktifkan API
Aktifkan Google Cloud API yang diperlukan agar Apigee dapat berfungsi.
- Klik EDIT di samping Enable APIs untuk mengaktifkan API yang diperlukan untuk organisasi evaluasi Anda.
-
Klik ENABLE APIS pada panel Enable APIs pada wizard. Hal ini akan memungkinkan
proyek:
- API Apigee
- Compute Engine API
- Service Networking API
- Tunggu beberapa saat sampai langkah ini selesai. Setelah selesai, pemeriksaan akan muncul di samping langkah Enable APIs dan langkah Networking akan tersedia.
Jaringan
Menyiapkan jaringan untuk Virtual Private Cloud (VPC) lokal Anda.
-
Klik EDIT di samping Networking.
Panel Set up networking akan menampilkan:
-
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:
-
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
Buat organisasi evaluasi Apigee.
-
Klik EDIT di samping Pengelola evaluasi Apigee.
Panel Buat organisasi evaluasi Apigee akan menampilkan:
Pilih region hosting analisis dan lokasi runtime. Untuk daftar Analisis Apigee API dan lokasi runtime yang tersedia, lihat Lokasi Apigee.
-
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.
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. |
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.
Guna mengonfigurasi perutean untuk akses eksternal di wizard penyediaan Apigee:
- 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.
Klik
EDIT di samping Pemilihan rute akses.Pilih Aktifkan akses internet dari panel Konfigurasi akses.
Wizard menampilkan opsi tambahan untuk mengonfigurasi instance:
- 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.
- (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.
- 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.
-
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:
- 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.
- 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.
- Menyediakan sertifikat yang dikelola sendiri:
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.
Setelah Apigee selesai menyiapkan akses runtime, Anda akan melihat bahwa tanda centang biru di samping semua langkah dalam wizard:
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}.
- 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.
- (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.
Guna mengonfigurasi perutean untuk akses internal di wizard penyediaan Apigee:
- Klik EDIT di samping langkah Access Routing.
Pilih No internet access di Configure access to the 'grup-eval' env group.
- Klik LANJUTKAN.
Anda akan melihat bahwa ada tanda centang biru di sebelah semua langkah dalam {i>wizard<i}. Ini menunjukkan semua langkah selesai berhasil:
- Klik LANJUTKAN.
- 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
. - (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.
- Klik BUKA KONSOL APIGEE untuk membuka UI Apigee.
- 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.
-
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
-
Klik
hello-world
untuk Anda saat menyediakan organisasi eval.Lokasi Properti Nilai Kembangkan > Proxy API Proxy API hello-world
Develop > Proxy API. Apigee dibuat
proxy API yang disebut
Menghapus organisasi evaluasi
Untuk menghapus (atau mencabut akses) organisasi eval, gunakan Perintah gcloud alpha apigee organizations delete.