本指南演示了使用 OSM 的 TCP 路由功能处理网格中通信的 TCP 客户端和服务端应用。

先决条件

  • Kubernetes 集群运行版本 v1.20.0 或者更高。
  • 已安装 OSM。
  • 使用 kubectl 与 API server 交互。
  • 已安装 osm 命令行工具，用于管理服务网格。

演示

以下演示了一个 TCP 客户端将数据发送到 tcp-echo 服务器，然后该服务器通过 TCP 连接将数据回显到客户端。

  1. 设置安装 OSM 的命名空间。

    osm_namespace=osm-system  # Replace osm-system with the namespace where OSM is installed if different

  2. 在 tcp-demo 命名空间下部署 tcp-demo service 。 tcp-demo service 运行在 9000 端口上，同时 appProtocol 属性设置为 tcp， 用来告知 OSM： 在将流量定向到 tcp-demo 的 9000 端口时，必须使用 TCP路由。

    # Create the tcp-demo namespace
kubectl create namespace tcp-demo
   
# Add the namespace to the mesh
osm namespace add tcp-demo
   
# Deploy the service
kubectl apply -f https://raw.githubusercontent.com/openservicemesh/osm-docs/release-v1.1/manifests/apps/tcp-echo.yaml -n tcp-demo

    确认 tcp-echo service 和 pod 启动并运行。

    $ kubectl get svc,po -n tcp-demo
NAME               TYPE        CLUSTER-IP    EXTERNAL-IP   PORT(S)    AGE
service/tcp-echo   ClusterIP   10.0.216.68   <none>        9000/TCP   97s
   
NAME                            READY   STATUS    RESTARTS   AGE
pod/tcp-echo-6656b7c4f8-zt92q   2/2     Running   0          97s

  3. 在 curl 命名空间下部署 curl 客户端。

    # Create the curl namespace
kubectl create namespace curl
   
# Add the namespace to the mesh
osm namespace add curl
   
# Deploy curl client in the curl namespace
kubectl apply -f https://raw.githubusercontent.com/openservicemesh/osm-docs/release-v1.1/manifests/samples/curl/curl.yaml -n curl

    确认 curl 客户端 pod 启动并运行。

    $ kubectl get pods -n curl
NAME                    READY   STATUS    RESTARTS   AGE
curl-54ccc6954c-9rlvp   2/2     Running   0          20s

使用宽松流量策略模式

我们将通过 宽松流量策略模式 启用服务发现，这允许应用互通建立而无需显式的指定 SMI 策略。

  1. 开启宽松流量策略模式

    kubectl patch meshconfig osm-mesh-config -n "$osm_namespace" -p '{"spec":{"traffic":{"enablePermissiveTrafficPolicyMode":true}}}' --type=merge

  2. 确认 curl 客户端可以通过 TCP 路由成功发送请求到 tcp-echo service 并接收响应。

    $ kubectl exec -n curl -ti "$(kubectl get pod -n curl -l app=curl -o jsonpath='{.items[0].metadata.name}')" -c curl -- sh -c 'echo hello | nc tcp-echo.tcp-demo 9000'
echo response: hello

    tcp-echo service 应该将客户端发送的数据返回客户端。在上面的示例中，客户端发送 hello，tcp-echo service 回应 echo response: echo。

使用 SMI 流量策略模式

使用 SMI 流量策略模式时，必须显式的配置流量策略来允许应用互通。我们将设置 SMI 策略来允许 curl 客户端与 tcp-echo service 在 9000 端口上进行通讯。

  1. 通过禁用宽松流量策略模式来启用 SMI 策略模式。

    kubectl patch meshconfig osm-mesh-config -n "$osm_namespace" -p '{"spec":{"traffic":{"enablePermissiveTrafficPolicyMode":false}}}' --type=merge

  2. 在缺少 SMI 策略的情况下，确认curl 客户端无法发送请求到 tcp-echo service ，也无法接收响应。

    $ kubectl exec -n curl -ti "$(kubectl get pod -n curl -l app=curl -o jsonpath='{.items[0].metadata.name}')" -c curl -- sh -c 'echo hello | nc tcp-echo.tcp-demo 9000'
command terminated with exit code 1

  3. 配置 SMI 流量访问和路由策略。

    kubectl apply -f - <<EOF
# TCP route to allows access to tcp-echo:9000
apiVersion: specs.smi-spec.io/v1alpha4
kind: TCPRoute
metadata:
name: tcp-echo-route
namespace: tcp-demo
spec:
matches:
    ports:
    - 9000
---
# Traffic target to allow curl app to access tcp-echo service using a TCPRoute
kind: TrafficTarget
apiVersion: access.smi-spec.io/v1alpha3
metadata:
name: tcp-access
namespace: tcp-demo
spec:
destination:
    kind: ServiceAccount
    name: tcp-echo
    namespace: tcp-demo
sources:
- kind: ServiceAccount
    name: curl
    namespace: curl
rules:
- kind: TCPRoute
    name: tcp-echo-route
EOF

  4. 有了 SMI TCP 路由之后，确认 curl 客户端可以成功访问 tcp-echo service 并收到响应。

    $ kubectl exec -n curl -ti "$(kubectl get pod -n curl -l app=curl -o jsonpath='{.items[0].metadata.name}')" -c curl -- sh -c 'echo hello | nc tcp-echo.tcp-demo 9000'
echo response: hello