Versi 1.20

Versi yang tersedia

1.20 (terbaru)
1.19
1.18
1.17
1.16
1.15
1.14
1.13
1.12
1.12

219}

Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan layanan TCP

Panduan ini menjelaskan cara menyiapkan Cloud Service Mesh untuk menggunakan layanan TCP dan TCPRoute resource.

Cloud Service Mesh dengan layanan TCP dan TCPRoute mirip dengan Konfigurasi proxy file bantuan Envoy dengan layanan HTTP. Pengecualiannya adalah layanan backend menyediakan layanan TCP dan perutean didasarkan pada TCP/IP parameter daripada protokol HTTP.

Resource mesh dengan resource TCPRoute — `Mesh` resource dengan resource `TCPRoute` (klik untuk memperbesar)

Sebelum memulai

Pastikan Anda menyelesaikan tugas-tugas yang dijelaskan dalam Bersiaplah untuk melakukan penyiapan dengan Envoy dan workload tanpa proxy.

Mengonfigurasi resource `Mesh`

Dalam file bernama mesh.yaml, buat spesifikasi resource mesh.
```
name: sidecar-mesh
```

Gunakan file mesh.yaml untuk membuat resource mesh.

gcloud network-services meshes import sidecar-mesh \
  --source=mesh.yaml \
  --location=global

Mengonfigurasi server TCP

Bagian panduan ini tidak khusus untuk API baru dan menggunakan API yang sudah ada layanan backend, health check, dan resource MIG.

Untuk tujuan demonstrasi, Anda membuat layanan backend dengan VM yang diskalakan secara otomatis menggunakan grup instance terkelola yang melayani layanan TCP tes pada porta 10000.

Membuat template instance VM Compute Engine dengan pengujian pada port 10000.

gcloud compute instance-templates create tcp-td-vm-template \
  --scopes=https://www.googleapis.com/auth/cloud-platform \
  --tags=allow-health-checks \
  --image-family=debian-10 \
  --image-project=debian-cloud \
  --metadata=startup-script="#! /bin/bash
sudo apt-get update -y
sudo apt-get install netcat -y
while true;
  do echo 'Hello from TCP service' | nc -l -s 0.0.0.0 -p 10000;
done &"

Membuat grup instance terkelola berdasarkan template.

gcloud compute instance-groups managed create tcp-td-mig-us-east1 \
  --zone=ZONE \
  --size=1 \
  --template=tcp-td-vm-template

Tetapkan port bernama pada grup instance terkelola yang dibuat ke port 10000.

gcloud compute instance-groups set-named-ports tcp-td-mig-us-east1 

  --zone=ZONE 

  --named-ports=tcp:10000

Membuat health check.

gcloud compute health-checks create tcp tcp-helloworld-health-check --port 10000

Buat aturan firewall untuk mengizinkan koneksi health check yang masuk ke di jaringan Anda.

gcloud compute firewall-rules create tcp-vm-allow-health-checks \
   --network default \
   --action allow \
   --direction INGRESS \
   --source-ranges=35.191.0.0/16,130.211.0.0/22 \
   --target-tags allow-health-checks \
   --rules tcp:10000

Membuat layanan backend global dengan skema load balancing INTERNAL_SELF_MANAGED dan pasang health check ke layanan backend. Contoh ini menggunakan instance terkelola grup yang menjalankan layanan TCP sampel yang Anda buat sebelumnya.
```
gcloud compute backend-services create tcp-helloworld-service \
    --global \
    --load-balancing-scheme=INTERNAL_SELF_MANAGED \
    --protocol=TCP \
    --health-checks tcp-helloworld-health-check
```

Tambahkan grup instance terkelola ke layanan backend.

gcloud compute backend-services add-backend tcp-helloworld-service \
  --instance-group tcp-td-mig-us-east1 \
  --instance-group-zone=ZONE \
  --global

Siapkan pemilihan rute dengan `TCPRoute`

Di bagian ini, Anda akan menyiapkan pemilihan rute.

Dalam file bernama tcp_route.yaml, buat spesifikasi TcpRoute.

Anda dapat menggunakan $PROJECT_ID atau $PROJECT_NUMBER.

name: helloworld-tcp-route
meshes:
- projects/$PROJECT_NUMBER/locations/global/meshes/sidecar-mesh
rules:
- action:
    destinations:
    - serviceName: projects/$PROJECT_NUMBER/locations/global/backendServices/tcp-helloworld-service
  matches:
  - address: '10.0.0.1/32'
    port: '10000'

Menggunakan spesifikasi tcp_route.yaml, buat resource TcpRoute.

gcloud network-services tcp-routes import helloworld-tcp-route \
  --source=tcp-route.yaml \
  --location=global

Membuat klien TCP dengan file bantuan Envoy

Membuat template instance lalu membuat VM dengan Envoy yang yang terhubung ke Cloud Service Mesh.

gcloud beta compute instance-templates create td-vm-client-template \
  --image-family=debian-10 \
  --image-project=debian-cloud \
  --service-proxy=enabled,mesh=sidecar-mesh \
  --metadata=startup-script="#! /bin/bash
sudo apt-get update -y
sudo apt-get install netcat -y"

gcloud compute instances create td-vm-client \
  --zone=ZONE \
  --source-instance-template td-vm-client-template

Login ke VM yang Anda buat.
```
gcloud compute ssh td-vm-client
```
Memverifikasi konektivitas ke layanan pengujian yang Anda buat menggunakan netcat utilitas.
```
echo 'Hi TCP Service' | nc 10.0.0.1 10000
```

Layanan pengujian akan menampilkan frasa Hello from TCP layanan. Anda juga dapat melihat teks apa pun yang diketik yang ditampilkan oleh layanan netcat yang berjalan di VM jarak jauh.

Langkah selanjutnya

Untuk informasi tentang cara mencantumkan resource rute yang terkait dengan Mesh atau Gateway, lihat Mencantumkan resource Route. Fitur ini sedang dalam Pratinjau.