TCP 라우팅

Experimental Channel

The TCPRoute resource described below is currently only included in the "Experimental" channel of Gateway API. For more information on release channels, refer to our versioning guide.

Gateway API는 여러 프로토콜과 함께 작동하도록 설계되었으며, TCPRoute는 TCP 트래픽을 관리할 수 있는 라우트 중 하나이다.

이 예제에서는 하나의 게이트웨이 리소스와 두 개의 TCPRoute 리소스가 다음 규칙에 따라 트래픽을 분배한다:

• 게이트웨이의 포트 8080에 대한 모든 TCP 스트림은 my-foo-service 쿠버네티스 Service의 포트 6000으로 전달된다.
• 게이트웨이의 포트 8090에 대한 모든 TCP 스트림은 my-bar-service 쿠버네티스 Service의 포트 6000으로 전달된다.

이 예제에서는 두 개의 TCP 리스너가 게이트웨이에 적용되어 두 개의 별도 백엔드 TCPRoute로 라우팅된다. Gateway의 listeners에 설정된 protocol이 TCP임에 유의한다:

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: my-tcp-gateway
spec:
  gatewayClassName: my-tcp-gateway-class
  listeners:
  - name: foo
    protocol: TCP
    port: 8080
    allowedRoutes:
      kinds:
      - kind: TCPRoute
  - name: bar
    protocol: TCP
    port: 8090
    allowedRoutes:
      kinds:
      - kind: TCPRoute
---
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: TCPRoute
metadata:
  name: tcp-app-1
spec:
  parentRefs:
  - name: my-tcp-gateway
    sectionName: foo
  rules:
  - backendRefs:
    - name: my-foo-service
      port: 6000
---
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: TCPRoute
metadata:
  name: tcp-app-2
spec:
  parentRefs:
  - name: my-tcp-gateway
    sectionName: bar
  rules:
  - backendRefs:
    - name: my-bar-service
      port: 6000

위 예제에서는 parentRefs의 sectionName 필드를 사용하여 두 개의 별도 백엔드 TCP Service에 대한 트래픽을 분리한다:

spec:
  parentRefs:
  - name: my-tcp-gateway
    sectionName: foo

이는 Gateway의 listeners에 있는 name과 직접 대응된다:

  listeners:
  - name: foo
    protocol: TCP
    port: 8080
  - name: bar
    protocol: TCP
    port: 8090

이 방식으로 각 TCPRoute는 Gateway의 서로 다른 포트에 "연결"되므로, my-foo-service 서비스는 클러스터 외부에서 포트 8080의 트래픽을 수신하고 my-bar-service는 포트 8090의 트래픽을 수신한다.

parentRefs의 port 필드를 사용하여 라우트를 게이트웨이 리스너에 바인딩함으로써 동일한 결과를 달성할 수도 있다:

spec:
  parentRefs:
  - name: my-tcp-gateway
    port: 8080

연결에 sectionName 대신 port 필드를 사용하면 게이트웨이와 관련 라우트 간의 관계가 더 밀접하게 결합된다는 단점이 있다. 자세한 내용은 게이트웨이에 연결하기를 참조한다.