[k8s] Envoy Gateway

#Kubernetes

Envoy Gateway는 쿠버네티스 환경에서 사용할 수 있는 envoy 기반 프록시 스택이다.
완전한 오픈소스다.

envoy를 게이트웨이 형태로 배포하고, 서비스들 게이트웨이 route 형태로 갖다 붙이는 기능을 제공한다.

더불어 envoy에서 지원하는 고급 로드밸런싱 알고리즘, rate limit, SSL 및 보안 인가 처리 등 게이트웨이에 필요한 것들은 대개 다 지원한다.

그냥 간단한 것만 써도 된다면 traefik을 쓰면 되고, 더 고급 LB 기능들이 필요하다면 이게 더 적절하다.

설치

helm으로 까는게 편하다.

helm install eg oci://docker.io/envoyproxy/gateway-helm --version v1.9.1 -n envoy-gateway-system --create-namespace
kubectl wait --timeout=5m -n envoy-gateway-system deployment/envoy-gateway --for=condition=Available

설치하면 이런 식으로 컨트롤플레인 관련 리소스들이 떠있을 것이다.

kubectl get all -n envoy-gateway-system

전용 어드민

그렇게 대단하진 않지만 대시보드도 지원한다.
127.0.0.1로 바인딩돼있어서 포트포워딩해놓고 봐야한다.

kubectl -n envoy-gateway-system port-forward deploy/envoy-gateway 19000:19000

그럼 이렇게 뜬다. 포트는 19000이다.
사실 별건 없고 ui도 좀 촌스럽다.

게이트웨이 클래스 정의

이것부터 만들어야 한다. 어떤 게이트웨이 구현체를 사용할 것인지를 지정하는 카테고리 값이다.

kubectl apply -f gateway-class.yaml

apiVersion: gateway.networking.k8s.io/v1
kind: GatewayClass
metadata:
  name: eg
spec:
  controllerName: gateway.envoyproxy.io/gatewayclass-controller

이렇게 만들면 eg라는 이름으로 게이트웨이를 생성했을때, envoy controller 구현체가 자동으로 붙는 것이다.

게이트웨이 생성

이게 실질적인 프록시/게이트웨이를 생성하는 시점이다.
방금 정의한 class를 가지고 적당히 정의해주면 된다.

kubectl apply -f public-gateway.yaml

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: public-gateway
  namespace: default
spec:
  gatewayClassName: eg
  listeners:
    - name: http
      protocol: HTTP
      port: 80

그러면 Service와 deployment를 자동으로 만들어준다.

그리고 어드민에서도 확인할 수 있을 것이다.

Route 생성

당연히 게이트웨이만 덜렁 있다고 뭐가 되진 않는다.
실제로 서비스를 붙이는 것은 HTTPRoute라는 리소스를 통해 처리된다.

하나의 게이트웨이에는 여러개의 HTTPRoute를 붙여서 사용할 수 있다.

다음은 nginx 하나 띄워서 붙이는 간단한 구성이다.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-test
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx-test
  template:
    metadata:
      labels:
        app: nginx-test
    spec:
      containers:
        - name: nginx
          image: nginx:1.27-alpine
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-test
  namespace: default
spec:
  selector:
    app: nginx-test
  ports:
    - port: 80
      targetPort: 80
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: nginx-test
  namespace: default
spec:
  parentRefs:
    - name: public-gateway
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /
      backendRefs:
        - name: nginx-test
          port: 80

이 경우에는 nginx-test라는 서비스를 가리키고, 그걸 게이트웨이의 루트 패스로 붙이도록 했다.
prefix는 원하는대로 붙이면 된다.

그렇게 띄워보면

잘 붙을 것이다.

BackendTrafficPolicy

이건 LB 규칙을 지정할 수 있는 별개 리소스 단위다.
로드밸런싱 알고리즘을 여기서 고를 수 있다.

apiVersion: gateway.envoyproxy.io/v1alpha1
kind: BackendTrafficPolicy
metadata:
  name: nginx-test
  namespace: default
spec:
  targetRefs:
    - group: gateway.networking.k8s.io
      kind: HTTPRoute
      name: nginx-test
  loadBalancer:
    type: RoundRobin