Jaringan northbound dengan Private Service Connect

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

Lihat dokumentasi Apigee Edge.

Dokumen ini menjelaskan penggunaan Private Service Connect (PSC) untuk mengonfigurasi perutean dari klien ke Apigee, yang juga disebut traffic "northbound".

Informasi harga: Untuk mengetahui informasi tentang cara PSC diukur dan ditagih, lihat Private Service Connect di halaman harga Virtual Private Cloud.

Ringkasan

Anda dapat menggunakan PSC untuk menghubungkan VPC Apigee dengan VPC yang telah Anda peering dengan Apigee, atau dengan VPC lain yang Anda kontrol. Pola arsitektur ini menghilangkan kebutuhan untuk membuat grup instance terkelola (MIG) guna meneruskan permintaan dari load balancer global ke Apigee. Dengan metode perutean PSC, permintaan proxy API diteruskan melalui load balancer HTTP(S) eksternal global yang Anda instal di VPC ke satu titik lampiran di VPC Apigee, yang disebut Lampiran Layanan. Konfigurasi ini memungkinkan Anda mengirim permintaan proxy API Apigee dari mesin yang mendukung jaringan. Lihat Gambar 1.

Perhatikan fitur PSC northbound yang didukung berikut:

• Anda dapat menggunakan PSC dengan instance Apigee yang sudah ada.
• Anda dapat melampirkan beberapa grup endpoint jaringan (NEG) PSC ke load balancer HTTP(S) eksternal global berbasis Envoy di Google Cloud.
• PSC didukung dengan Kontrol Layanan VPC.

• Anda dapat menetapkan kebijakan traffic deteksi pencilan pada layanan backend untuk menangani skenario failover secara otomatis. Lihat informasi selengkapnya di sini:

  • Kebijakan traffic
  • Mengonfigurasi deteksi pencilan
  • REST Resource: backendServices

Catatan: Jika saat ini Anda menggunakan pendekatan berbasis MIG, Anda dapat memigrasikan sistem ke perutean northbound berbasis PSC. Lihat Memigrasikan perutean northbound dari ke PSC.

Gambar 1: Koneksi layanan pribadi

Pembatasan

Penggunaan PSC dengan Apigee saat ini memiliki batasan berikut:

Batasan: Perhatikan batasan berikut untuk konfigurasi PSC:

• Load balancer HTTP(S) eksternal global (klasik) tidak didukung untuk konfigurasi ini.
• Untuk failover dengan beberapa NEG PSC, health check aktif tidak didukung. Sebagai gantinya, gunakan deteksi pencilan.
• Batas berlaku untuk jumlah project Google Cloud yang dapat terhubung ke instance Apigee melalui PSC, dan untuk jumlah koneksi NEG PSC yang dapat Anda miliki per project. Untuk mengetahui detailnya, lihat Batas Private Service Connect (PSC).
• Jika project cloud Google dihapus dari consumerAcceptList, PSC NEG yang ada di project yang dihapus tersebut akan terus berfungsi. Namun, NEG baru akan ditolak. Anda harus menghapus NEG yang ada jika Anda menghapus project terkaitnya dari consumerAcceptList. Atau, Anda dapat membuat ulang instance Apigee, yang membuat ulang lampiran layanan di project Apigee.

Memperbarui daftar penerimaan konsumen untuk instance Apigee

Pada 10 Oktober 2024, batas koneksi NEG PSC yang diizinkan per project ke instance Apigee ditingkatkan dari 20 menjadi 100. Untuk instance Apigee yang dibuat sebelum tanggal tersebut, Anda harus melakukan langkah-langkah di bagian ini untuk memperbarui daftar penerima konsumen agar dapat memanfaatkan batas baru. Anda hanya perlu mengupgrade setiap instance Apigee satu kali untuk menerima batas koneksi baru. Lihat juga Batas Private Service Connect (PSC).

Jika Anda perlu memiliki lebih dari 1.000 koneksi NEG PSC secara total di semua project Cloud yang terhubung ke instance Apigee, hubungi Dukungan Google Cloud.

Untuk memperbarui daftar penerimaan konsumen instance Apigee agar dapat memanfaatkan batas koneksi yang lebih tinggi, lakukan langkah-langkah berikut:

Cloud Console

Untuk mengetahui langkah-langkah mendetail, lihat Mengedit daftar project yang diterima.

Apigee API

Edit daftar penerimaan konsumen yang ada untuk instance Apigee Anda. Untuk menggunakan instances API:

1. Dapatkan token autentikasi untuk Apigee API:

   TOKEN="$(gcloud auth print-access-token)"

2. Mendapatkan daftar project Cloud dalam daftar penerimaan konsumen instance:

   curl https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances/INSTANCE_ID \
     -H "Authorization: Bearer $TOKEN" -H Content-Type:application/json | jq .consumerAcceptList

3. Buat file JSON bernama update_consumer_accept_list.json yang berisi daftar saat ini project yang diterima yang ditampilkan oleh perintah sebelumnya. Contoh:

   {
     "consumerAcceptList": [
       "dg-runtime-test1",
       "ne24b79b92c7db623p-tp",
       "dg-runtime-test2",
       "jd2fee78402218863p-tp"
     ]
   }

4. Jika perlu, edit file untuk menambahkan project lainnya.
5. Perbarui instance, menggunakan file JSON yang Anda buat sebagai input. Contoh:

   curl https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances/INSTANCE_ID?updateMask="consumer_accept_list" \
     -X PATCH -H "Authorization: Bearer $TOKEN" -H Content-Type:application/json -d @update_consumer_accept_list.json
   

Mengonfigurasi perutean PSC

Kami mendukung penggunaan PSC untuk perutean ke utara dari klien internal dan eksternal. Untuk mengetahui langkah-langkah mendetail, lihat Langkah 8: Mengonfigurasi perutean dari petunjuk penyediaan CLI.

Perluasan multi-region dengan PSC

Anda dapat memperluas organisasi Apigee di beberapa region dan menggunakan PSC untuk perutean ke utara di region baru. Untuk mengetahui detailnya, lihat Memperluas Apigee ke beberapa region.

Menghapus instance Apigee

Untuk menghapus instance Apigee yang menggunakan PSC, ikuti langkah-langkah berikut:

1. Hapus dan hapus backend NEG PSC dari load balancer eksternal.
2. Hapus instance runtime Apigee menggunakan Apigee API. Ini adalah operasi yang berjalan lama dan dapat memerlukan waktu hingga 20 menit untuk diselesaikan.
3. Secara opsional, ambil status operasi yang berjalan lama menggunakan Apigee API.