Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.
Baca dokumentasi Apigee Edge.
Dokumen ini menjelaskan cara mengonfigurasi host Virtual Private Cloud (VPC) Bersama dan melampirkan project layanan target backend dan Apigee yang terpisah ke dalamnya. Jaringan VPC bersama memungkinkan Anda menerapkan infrastruktur jaringan yang diatur secara terpusat dengan Google Cloud. Anda dapat menggunakan satu jaringan VPC dalam project host untuk menghubungkan resource dari beberapa project layanan.
Manfaat VPC Bersama
Runtime Apigee (berjalan di VPC yang dikelola Google) di-peering dengan VPC yang Anda miliki. Dalam topologi ini, endpoint runtime Apigee dapat berkomunikasi dengan jaringan VPC Anda, seperti yang ditunjukkan dalam diagram berikut:
Lihat juga Ringkasan arsitektur Apigee.
Dalam banyak skenario, topologi yang dijelaskan di atas terlalu sederhana, karena jaringan VPC adalah bagian dari satu project Google Cloud, dan banyak organisasi ingin mengikuti praktik terbaik untuk hierarki resource dan memisahkan infrastruktur mereka menjadi beberapa project. Bayangkan topologi jaringan di mana project tenant Apigee di-peering ke jaringan VPC seperti sebelumnya, tetapi memiliki backend internal yang terletak di VPC project lain. Seperti yang ditunjukkan dalam diagram ini:
Jika Anda meng-peering VPC Apigee ke VPC Backend, seperti yang ditunjukkan dalam diagram, backend dapat dijangkau dari jaringan VPC Apigee dan sebaliknya, karena peering jaringan bersifat simetris. Namun, project tenant Apigee hanya dapat berkomunikasi dengan VPC Apigee, karena peering tersebut tidak transitif, seperti yang dijelaskan dalam dokumentasi peering VPC. Agar berhasil, Anda dapat men-deploy proxy tambahan di VPC Apigee untuk meneruskan traffic melalui link peering ke VPC backend; namun, pendekatan ini menambahkan overhead dan pemeliharaan operasional tambahan.
VPC Bersama menawarkan solusi untuk masalah yang dijelaskan di atas. Dengan VPC Bersama, Anda dapat membangun konektivitas antara runtime Apigee dan backend yang berada di project Google Cloud lain dalam organisasi yang sama tanpa komponen jaringan tambahan.
Mengonfigurasi VPC Bersama dengan Apigee
Bagian ini menjelaskan cara memasang project layanan VPC Apigee ke host VPC Bersama. Subnet yang ditentukan dalam project host akan dibagikan ke project layanan. Di bagian selanjutnya, kami akan menjelaskan cara membuat subnet kedua untuk layanan backend yang di-deploy dalam project layanan VPC kedua. Diagram berikut menunjukkan arsitektur yang dihasilkan:
Apigee menyediakan skrip penyediaan untuk menyederhanakan pembuatan topologi yang diperlukan. Ikuti langkah-langkah di bagian ini untuk mendownload dan menggunakan skrip penyediaan untuk menyiapkan Apigee dengan VPC Bersama.
Prasyarat
- Tinjau konsep yang dibahas dalam Ringkasan VPC Bersama. Anda perlu memahami konsep project host dan project layanan.
- Membuat project Google Cloud baru yang dapat Anda konfigurasi untuk VPC Bersama. Project ini adalah project host. Lihat Membuat dan mengelola project.
- Ikuti langkah-langkah dalam Menyediakan VPC Bersama untuk menyediakan project untuk VPC Bersama. Anda harus menjadi admin organisasi atau diberi peran Identity and Access Management (IAM) administratif yang sesuai agar dapat mengaktifkan project host untuk VPC Bersama.
- Membuat project Google Cloud kedua. Project ini adalah project layanan. Kemudian, Anda akan melampirkannya ke project host.
Mendownload skrip
Apigee menyediakan skrip penyediaan untuk menyederhanakan pembuatan topologi yang diperlukan. Anda harus mengambil skrip dari GitHub:
- Clone project GitHub yang berisi skrip:
git clone https://github.com/apigee/devrel.git
- Buka direktori berikut dalam project:
cd devrel/tools/apigee-x-trial-provision
- Setel variabel lingkungan berikut:
export HOST_PROJECT=HOST_PROJECT_ID
export SERVICE_PROJECT=SERVICE_PROJECT_ID
Dengan keterangan:
HOST_PROJECT_ID
adalah project ID dari project host VPC Bersama yang Anda buat sebagai salah satu prasyarat.SERVICE_PROJECT_ID
adalah project ID dari project layanan Google Cloud yang Anda buat di prasyarat.
Mengonfigurasi project host
- Tetapkan variabel lingkungan berikut:
YOUR_SHARED_VPC
adalah nama jaringan VPC Bersama Anda.YOUR_SHARED_SUBNET
adalah nama subnet VPC Bersama Anda.CIDR_BLOCK
adalah blok CIDR untuk VPC Apigee. Contoh:10.111.0.0/23
.- Untuk mengonfigurasi peering VPC dan firewall Apigee, jalankan skrip dengan opsi berikut:
./apigee-x-trial-provision.sh \ -p $HOST_PROJECT --shared-vpc-host-config --peering-cidr $PEERING_CIDR
Skrip ini mengonfigurasi project host; output Anda akan terlihat seperti berikut, dengan
NETWORK
danSUBNET
merepresentasikan jalur yang sepenuhnya memenuhi syarat pada project host:export NETWORK=projects/$HOST_PROJECT/global/networks/$NETWORK
export SUBNET=projects/$HOST_PROJECT/regions/us-west1/subnetworks/$SUBNET
- Ekspor variabel yang ditampilkan dalam output.
export NETWORK=YOUR_SHARED_VPCexport SUBNET=YOUR_SHARED_SUBNET
export PEERING_CIDR=CIDR_BLOCK
Dengan keterangan:
Mengonfigurasi project layanan
Pada langkah ini, Anda akan mengonfigurasi project layanan. Setelah selesai, skrip akan membuat dan men-deploy contoh proxy API di lingkungan Apigee yang dapat Anda gunakan untuk menguji penyediaan.
- Jalankan skrip
apigee-x-trial-provision.sh
untuk kedua kalinya guna menyediakan project layanan dengan setelan jaringan bersama:./apigee-x-trial-provision.sh \ -p $SERVICE_PROJECT
Skrip ini membuat proxy contoh di lingkungan Apigee Anda dan mencetak perintah curl ke
STDOUT
yang dapat Anda panggil untuk menguji penyediaan. - Panggil proxy API pengujian. Contoh:
curl -v https://10-111-111-111.nip.io/hello-world
Mengonfigurasi project layanan lain untuk layanan backend
Memisahkan infrastruktur Google Cloud Anda ke dalam beberapa project merupakan praktik terbaik. Lihat Menentukan hierarki resource untuk zona landing Google Cloud Anda. Bagian ini menjelaskan cara men-deploy layanan backend di project layanan terpisah dan menambahkannya ke host VPC bersama. Apigee dapat menggunakan layanan backend sebagai target proxy API karena project layanan Apigee dan project layanan backend terpasang ke host VPC Bersama.
Prasyarat
Untuk melakukan langkah-langkah ini, kami asumsikan Anda telah menyiapkan VPC Bersama dan membagikannya ke project layanan backend, seperti yang dijelaskan dalam Menyiapkan VPC Bersama.
Mengonfigurasi project layanan
Di bagian ini, Anda akan menguji layanan backend di subnet VPC bersama lainnya, membuat subnet kedua di project host, dan menggunakan alamat IP RFC1918 pribadinya sebagai URL target untuk proxy Apigee API Anda.
- Dari dalam project layanan backend Anda, jalankan perintah berikut untuk melihat semua subnet bersama yang tersedia:
gcloud compute networks subnets list-usable --project $HOST_PROJECT --format yaml
Contoh output:
ipCidrRange: 10.0.0.0/20 network: https://www.googleapis.com/compute/v1/projects/my-svpc-hub/global/networks/hub-vpc subnetwork: https://www.googleapis.com/compute/v1/projects/my-svpc-hub/regions/europe-west1/subnetworks/sub1
- Buat variabel lingkungan berikut:
BACKEND_SERVICE_PROJECT=PROJECT_ID
SHARED_VPC_SUBNET=SUBNET
Dengan keterangan:
PROJECT_ID
adalah nama project layanan yang Anda buat untuk layanan backend.SUBNET
adalah salah satu output subnetwork dari perintah sebelumnya.
- Untuk membuat layanan
httpbin
backend dalam project untuk tujuan pengujian, gunakan perintah berikut:gcloud compute --project=$BACKEND_SERVICE_PROJECT instances create-with-container httpbin \ --machine-type=e2-small --subnet=$SHARED_VPC_SUBNET \ --image-project=cos-cloud --image-family=cos-stable --boot-disk-size=10GB \ --container-image=kennethreitz/httpbin --container-restart-policy=always --tags http-server
- Buat dan deploy proxy API Apigee dengan mengikuti langkah-langkah dalam Membuat proxy API.
- Mendapatkan alamat IP internal virtual machine (VM) tempat layanan target berjalan.
Anda akan menggunakan IP ini pada langkah berikutnya untuk memanggil proxy API pengujian:
gcloud compute instances list --filter=name=httpbin
- Untuk menguji konfigurasi, panggil proxy. Gunakan alamat IP internal VM yang Anda peroleh di langkah sebelumnya. Contoh berikut mengasumsikan bahwa Anda menamai
jalur dasar proxy
/myproxy
. Contoh:curl -v https://INTERNAL_IP/myproxy
Panggilan API ini menampilkan
Hello, Guest!
.