Ingress 와 Gateway API

Ingress — HTTP 라우팅 규칙

서비스마다 LoadBalancer 를 만들면 비싸고 번거롭습니다. Ingress 는 하나의 입구에서 호스트 이름·URL 경로에 따라 여러 서비스로 나눠 줍니다.

shop.example.com/api  →  api-svc:8080
shop.example.com/     →  web-svc:80

Ingress 리소스는 규칙표일 뿐이고, 실제로 트래픽을 받는 것은 Ingress 컨트롤러(ingress-nginx, Traefik …)입니다. 컨트롤러는 설치해야 하고, 어떤 Ingress 를 자기가 처리할지 IngressClass 로 구분합니다.

kubectl get ingressclass                  # NAME: nginx, CONTROLLER: k8s.io/ingress-nginx
kubectl get pods -n ingress-nginx

명령형

kubectl create ingress shop-ing --class=nginx \
  --rule="shop.example.com/api*=api-svc:8080" \
  --rule="shop.example.com/*=web-svc:80"
# 경로 끝의 * → pathType Prefix, 없으면 Exact
# TLS: --rule="shop.example.com/*=web-svc:80,tls=shop-tls"

선언형

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: shop-ing
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /     # (컨트롤러 전용 설정 — 필요할 때만)
spec:
  ingressClassName: nginx
  tls:
  - hosts: [shop.example.com]
    secretName: shop-tls
  rules:
  - host: shop.example.com
    http:
      paths:
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: api-svc
            port:
              number: 8080
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web-svc
            port:
              number: 80

kubectl describe ingress shop-ing       # Rules · Backends 확인(백엔드 서비스가 없으면 error 표시)
curl -H "Host: shop.example.com" http://<노드IP>:<ingress 컨트롤러 NodePort>/api

Gateway API — Ingress 의 후계자

Gateway API 는 Ingress 의 한계(컨트롤러별 어노테이션 난립, 역할 구분 없음, HTTP 외 프로토콜)를 풀려고 만든 새 표준입니다. 2025년 교과과정에 “Use the Gateway API to manage Ingress traffic” 으로 들어왔습니다. CRD 로 설치됩니다.

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: web-gw
spec:
  gatewayClassName: nginx
  listeners:
  - name: http
    protocol: HTTP
    port: 80
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: web-route
spec:
  parentRefs:                 # 어느 Gateway 에 붙을지
  - name: web-gw
  hostnames:
  - web.example.com
  rules:
  - matches:
    - path:
        type: PathPrefix      # Exact · PathPrefix · RegularExpression
        value: /
    backendRefs:              # 어느 서비스로
    - name: web
      port: 80
      weight: 100             # 여러 백엔드에 비율로 나누기(카나리)도 가능

kubectl get gatewayclass
kubectl get gateway,httproute
kubectl describe gateway web-gw        # Programmed 조건, 주소

명령형 생성기가 없으므로 공식 문서(gateway-api.sigs.k8s.io)의 예제를 가져와 이름만 바꾸는 방식이 가장 빠릅니다.

Ingress 를 Gateway API 로 옮기기