Menyiapkan pemilihan rute traffic TCP

Panduan ini menunjukkan cara menggunakan Cloud Service Mesh untuk merutekan traffic ke layanan yang menangani traffic TCP. Layanan ini mencakup database, layanan VOIP, dan platform pengelolaan, yang diharapkan menerima traffic TCP di port atau rentang port tertentu.

Panduan ini berlaku untuk deployment dengan API lama. Jika Anda menggunakan API pemilihan rute layanan baru, yang masih dalam pratinjau, lihat Penyiapan Cloud Service Mesh untuk layanan TCP dengan resource TCPRoute.

Gunakan panduan ini untuk melakukan hal berikut:

  • Siapkan layanan yang mewakili kumpulan backend atau endpoint identik yang menerima permintaan TCP dari klien.
  • Siapkan peta aturan perutean agar proxy Envoy yang dikonfigurasi Cloud Service Mesh dapat mengirim permintaan TCP.

Diagram berikut menunjukkan cara kerja perutean TCP untuk instance mesin virtual (VM) dan grup endpoint jaringan (NEG).

Resource Compute Engine API untuk VM.
Menyiapkan Cloud Service Mesh untuk TCP, backend Compute Engine (klik untuk memperbesar)


Resource Compute Engine API untuk NEG.
Menyiapkan Cloud Service Mesh untuk backend TCP, NEG (klik untuk memperbesar)

Persiapan

  • Panduan ini dibuat berdasarkan panduan persiapan Envoy untuk mesh layanan, dan mengasumsikan bahwa Anda sudah memiliki pemahaman dasar tentang cara kerja Cloud Service Mesh.
  • Panduan ini berfokus pada aspek penyiapan Cloud Service Mesh yang berbeda saat Anda mengonfigurasi layanan dan perutean untuk traffic TCP.
  • Panduan ini mengasumsikan bahwa Anda telah menyiapkan grup instance terkelola (MIG) atau NEG.

Mengonfigurasi resource load balancing

Gunakan langkah-langkah berikut untuk mengonfigurasi resource load balancing.

Membuat health check TCP

Penyiapan dengan VM

Jika Anda mengonfigurasi MIG, gunakan perintah berikut untuk membuat health check global; ganti PORT dengan nomor port TCP yang dipantau oleh health check ini:

gcloud compute health-checks create tcp td-vm-health-check \
    --global \
    --port=PORT

Penyiapan dengan NEG

Jika Anda mengonfigurasi NEG, gunakan perintah berikut untuk membuat health check:

gcloud compute health-checks create tcp td-gke-health-check \
    --use-serving-port

Untuk mengetahui informasi selengkapnya tentang pemeriksaan kesehatan, lihat artikel berikut:

Membuat aturan firewall untuk health check

Aturan ini memungkinkan health check dari health checker Google Cloud menjangkau backend Anda.

gcloud

gcloud compute firewall-rules create fw-allow-health-checks \
  --action=ALLOW \
  --direction=INGRESS \
  --source-ranges=35.191.0.0/16,130.211.0.0/22 \
  --target-tags=TAGS \
  --rules=tcp:80

Untuk mengetahui informasi selengkapnya tentang aturan firewall untuk health check, lihat artikel berikut:

Membuat layanan backend untuk backend TCP

Penyiapan layanan backend untuk TCP dengan Cloud Service Mesh sedikit berbeda dari penyiapan untuk HTTP. Langkah-langkah berikut menunjukkan perbedaan tersebut.

Penyiapan dengan VM

Jika Anda mengonfigurasi MIG, gunakan perintah berikut untuk membuat layanan backend dan menambahkan health check:

 gcloud compute backend-services create td-vm-service \
     --global \
     --load-balancing-scheme=INTERNAL_SELF_MANAGED \
     --health-checks=td-vm-health-check \
     --protocol=TCP \
     --global-health-checks

Langkah terakhir untuk menyiapkan layanan backend adalah menambahkan backend. Karena langkah ini adalah penyiapan Cloud Service Mesh standar (dengan kata lain, tidak ada yang spesifik untuk layanan berbasis TCP), langkah ini tidak ditampilkan di sini. Untuk informasi selengkapnya, lihat Membuat layanan backend dalam panduan penyiapan untuk VM Compute Engine dengan deployment Envoy otomatis.

Penyiapan dengan NEG

Jika Anda mengonfigurasi NEG, gunakan perintah berikut untuk membuat layanan backend dan mengaitkan health check dengan layanan backend:

gcloud compute backend-services create td-gke-service \
    --global \
    --health-checks=td-gke-health-check \
    --protocol=TCP \
    --load-balancing-scheme=INTERNAL_SELF_MANAGED

Langkah terakhir untuk menyiapkan layanan backend adalah menambahkan grup backend. Karena langkah ini adalah penyiapan Cloud Service Mesh standar (dengan kata lain, tidak ada yang spesifik untuk layanan berbasis TCP), langkah ini tidak ditampilkan di sini. Untuk informasi selengkapnya, lihat Membuat layanan backend dalam panduan penyiapan untuk Pod GKE dengan injeksi Envoy otomatis.

Menyiapkan pemilihan rute untuk layanan backend berbasis TCP

Di bagian ini, Anda akan membuat proxy TCP target global dan aturan penerusan global. Resource ini memungkinkan aplikasi Anda mengirim traffic ke backend dengan layanan backend yang baru dibuat.

Pertimbangkan hal berikut:

  • Aturan penerusan Anda harus memiliki skema load balancing INTERNAL_SELF_MANAGED.
  • Alamat IP virtual (VIP) dan port yang Anda konfigurasikan dalam aturan penerusan adalah VIP dan port yang digunakan aplikasi Anda saat mengirim traffic ke layanan TCP. Anda dapat memilih VIP dari salah satu subnet. Cloud Service Mesh menggunakan VIP dan port ini untuk mencocokkan permintaan klien dengan layanan backend tertentu.

    Untuk mengetahui informasi tentang cara permintaan klien dicocokkan dengan layanan backend, lihat Penemuan layanan.

gcloud

  1. Gunakan perintah berikut untuk membuat proxy TCP target; ganti BACKEND_SERVICE dengan nama layanan backend yang dibuat di langkah sebelumnya. Dalam contoh berikut, kami menggunakan td-tcp-proxy sebagai nama untuk proxy TCP target, tetapi Anda dapat memilih nama yang sesuai dengan kebutuhan Anda.

    gcloud compute target-tcp-proxies create td-tcp-proxy \
       --backend-service=BACKEND_SERVICE
    
  2. Membuat aturan penerusan. Aturan penerusan menentukan VIP dan port yang digunakan saat mencocokkan permintaan klien dengan layanan backend tertentu. Untuk informasi selengkapnya, lihat gcloud compute forwarding-rules create dalam referensi perintah gcloud.

    gcloud compute forwarding-rules create td-tcp-forwarding-rule \
        --global \
        --load-balancing-scheme=INTERNAL_SELF_MANAGED \
        --address=VIP\
        --target-tcp-proxy=td-tcp-proxy \
        --ports=PORT \
        --network=default
    

Pada tahap ini, Cloud Service Mesh dikonfigurasi untuk melakukan load balancing traffic untuk VIP yang ditentukan dalam aturan penerusan di seluruh backend Anda.

Pemecahan masalah

Jika aplikasi Anda mencoba mengirim permintaan ke layanan berbasis TCP, lakukan hal berikut:

  • Pastikan port health check TCP cocok dengan port tempat aplikasi TCP mengharapkan untuk menerima traffic health check.
  • Pastikan nama port layanan backend cocok dengan yang ditentukan dalam grup instance.

Langkah selanjutnya