設定 TCP 服務

本指南說明如何設定 Cloud Service Mesh，以便使用 TCP 服務和 TCPRoute 資源。

搭配 TCP 服務和 TCPRoute 的 Cloud Service Mesh 與搭配 HTTP 服務的 Envoy 附屬 Proxy 設定類似。例外狀況是，後端服務提供 TCP 服務，且路由是根據 TCP/IP 參數而非 HTTP 通訊協定。

事前準備

請務必完成「準備使用 Envoy 和無 Proxy 工作負載設定」一文中所述的工作。

設定 Mesh 資源

1. 在名為 mesh.yaml 的檔案中，建立 mesh 資源規格。

   name: sidecar-mesh
   

2. 使用 mesh.yaml 檔案建立 mesh 資源。

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

設定 TCP 伺服器

本指南的這部分並非針對新 API 而設計，而是使用現有的後端服務、健康檢查和 MIG 資源。

為了方便說明，您會使用代管的執行個體群組，建立後端服務，並在通訊埠 10000 上提供測試 TCP 服務。

1. 建立 Compute Engine VM 執行個體範本，並在 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 &"
   

2. 依據範本建立代管執行個體群組。

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

3. 將已建立的代管執行個體群組的具名通訊埠設為 10000 埠。

   gcloud compute instance-groups set-named-ports tcp-td-mig-us-east1 
   
     --zone=ZONE 
   
     --named-ports=tcp:10000
   

4. 建立健康狀態檢查。

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

5. 建立防火牆規則，允許傳入的健康狀態檢查連線連線至網路中的執行個體。

   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
   

6. 使用 INTERNAL_SELF_MANAGED 的負載平衡機制建立全球後端服務，並將健康狀態檢查附加至後端服務。這個範例會使用執行您先前建立的 TCP 服務範例的代管執行個體群組。

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

7. 將代管執行個體群組新增至後端服務。

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

使用 TCPRoute 設定轉送

在本節中，您將設定路由。

1. 在名為 tcp_route.yaml 的檔案中，建立 TcpRoute 規格。

   您可以使用 $PROJECT_ID 或 $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'
   

2. 使用 tcp_route.yaml 規格建立 TcpRoute 資源。

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

使用 Envoy 附加元件建立 TCP 用戶端

1. 建立執行個體範本，然後使用 Envoy 建立與 Cloud Service Mesh 連線的 VM。

   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
   

2. 登入您建立的 VM。

   gcloud compute ssh td-vm-client
   

3. 使用 netcat 公用程式，驗證您建立的測試服務連線。

   echo 'Hi TCP Service' | nc 10.0.0.1 10000
   

測試服務應傳回「Hello from TCP service」字詞。您也應該可以看到您輸入的任何文字，這些文字是由在遠端 VM 上執行的 netcat 服務傳回。

後續步驟

• 如要瞭解如何列出與 Mesh 或 Gateway 資源相關聯的路線資源，請參閱「列出 Route 資源」。