Proxy target untuk Cloud Service Mesh

Dokumen ini hanya berlaku untuk Cloud Service Mesh dengan API load balancing. Sebaiknya gunakan API pemilihan rute layanan untuk men-deploy Cloud Service Mesh.

Saat Anda mengonfigurasi Cloud Service Mesh, salah satu resource yang Anda konfigurasikan adalah proxy target. Dalam konteks Cloud Service Mesh, proxy target memiliki dua tujuan utama:

  • Menentukan protokol yang digunakan klien Cloud Service Mesh saat mereka membuka koneksi ke backend atau endpoint yang terkait dengan layanan.

  • Menggunakan aturan penerusan dan peta URL untuk membuat peta aturan perutean. Peta aturan pemilihan rute memberikan kemampuan tambahan, seperti aturan pemilihan rute, bergantung pada jenis proxy target. Pilihan yang tidak valid akan disembunyikan di antarmuka pengguna atau ditolak oleh API.

Jenis proxy target dan protokol permintaan

Cloud Service Mesh menghasilkan konfigurasi yang berbeda untuk kliennya berdasarkan jenis proxy target yang Anda konfigurasikan. Saat Anda mengonfigurasi jenis proxy target, klien Cloud Service Mesh akan menggunakan protokol permintaan tertentu.

Proxy target Meminta protokol
HTTPS Klien memulai koneksi HTTPS
HTTP Klien memulai koneksi HTTP
gRPC Klien memulai koneksi gRPC
TCP Klien memulai koneksi TCP

Anda tidak dibatasi untuk memilih hanya satu jenis. Misalnya, aplikasi Anda mungkin ingin menggunakan HTTP saat menangani beberapa layanan, tetapi menggunakan TCP saat menangani layanan lainnya. Untuk kasus penggunaan tersebut, Anda perlu membuat proxy HTTP target dan proxy TCP target.

Kombinasi resource yang valid di peta aturan perutean

Untuk menghindari kesalahan konfigurasi, Cloud Service Mesh hanya memungkinkan Anda membuat peta aturan perutean yang terlihat seperti berikut:

  • Aturan penerusan > proxy HTTPS target global > peta URL > satu atau beberapa layanan backend
  • Aturan penerusan > proxy HTTP target global > peta URL > satu atau beberapa layanan backend
  • Aturan penerusan > proxy gRPC target global > peta URL > satu atau beberapa layanan backend
  • Aturan penerusan > proxy TCP target global > satu layanan backend

Jika Anda menggunakan konsol Google Cloud untuk menyiapkan proxy HTTP target, proxy target akan disiapkan secara implisit sebagai bagian dari konfigurasi peta aturan pemilihan rute Anda. Penyiapan proxy TCP belum didukung di konsol Google Cloud.

Jika menggunakan Google Cloud CLI atau API, Anda perlu mengonfigurasi proxy target secara eksplisit.

Penanganan traffic

Bagian berikut menjelaskan cara menangani traffic, bergantung pada jenis proxy target yang Anda gunakan.

Menggunakan proxy HTTP atau HTTPS target

Saat Anda mengonfigurasi layanan berbasis HTTP atau HTTPS, setiap instance layanan umumnya memiliki proxy Envoy yang di-deploy bersamanya. Cloud Service Mesh mengonfigurasi proxy Envoy ini. Ini adalah bagian dari bidang data mesh layanan Anda dan menangani traffic sebagai berikut.

Proxy Envoy menerima permintaan keluar. Kemudian, aturan ini membandingkan alamat IP dan port tujuan permintaan dengan alamat IP dan port yang dikonfigurasi di setiap aturan penerusan yang mereferensikan proxy HTTP atau HTTPS target. Jika kecocokan ditemukan, proxy Envoy akan mengevaluasi permintaan sesuai dengan peta URL yang sesuai untuk proxy target.

Menggunakan proxy TCP target

Saat Anda mengonfigurasi layanan berbasis TCP, setiap instance layanan umumnya memiliki proxy Envoy yang di-deploy bersamanya. Cloud Service Mesh mengonfigurasi proxy Envoy ini. Ini adalah bagian dari bidang data mesh layanan Anda dan menangani traffic sebagai berikut.

Proxy Envoy menerima permintaan keluar. Kemudian, aturan ini membandingkan alamat IP dan port tujuan permintaan dengan alamat IP dan port yang dikonfigurasi di setiap aturan penerusan yang mereferensikan proxy TCP target. Setiap aturan penerusan merutekan traffic TCP ke proxy target yang mengarah ke layanan backend default. Layanan backend menentukan health check dan menentukan backend yang sesuai.

Menggunakan proxy gRPC target

Saat Anda mengonfigurasi layanan berbasis gRPC, instance layanan Anda umumnya tidak memiliki proxy Envoy yang di-deploy bersamanya. Sebagai gantinya, Cloud Service Mesh mengonfigurasi library gRPC. Library ini adalah bagian dari bidang data mesh layanan Anda dan menangani traffic sebagai berikut.

Library gRPC membandingkan hostname[:port] yang ditentukan dalam URI dengan aturan host di semua peta URL yang dirujuk oleh proxy gRPC target. Jika kecocokan ditemukan, library gRPC akan mengevaluasi permintaan sesuai dengan aturan jalur yang terkait dengan aturan host yang cocok.

Resource proxy target

Untuk menambahkan, menghapus, mencantumkan, dan mendapatkan informasi tentang proxy target, Anda dapat menggunakan REST API atau gcloud CLI.

Selain itu, untuk mendapatkan informasi tentang proxy target, Anda dapat menggunakan perintah gcloud berikut:

gcloud compute [target-http-proxies | target-tcp-proxies | target-grpc-proxies] list

gcloud compute [target-http-proxies | target-tcp-proxies | target-grpc-proxies] describe TARGET_PROXY_NAME

API

Untuk deskripsi properti dan metode yang tersedia bagi Anda saat menggunakan proxy target melalui REST API, lihat referensi berikut yang didukung Cloud Service Mesh:

gcloud CLI

Untuk Google Cloud CLI, lihat referensi berikut:

Langkah selanjutnya