Ingress

Ingress는 쿠버네티스 클러스터 내의 서비스에 대한 외부 HTTP/HTTPS 트래픽을 관리하는 API 객체입니다. 서비스로의 URL 경로 기반 라우팅, SSL/TLS 종료, 이름 기반 가상 호스팅 등을 제공합니다.

2026-10 갱신 — Ingress-NGINX 컨트롤러 은퇴

  • 쿠버네티스 커뮤니티의 Ingress-NGINX 컨트롤러(kubernetes/ingress-nginx)는 2026년 3월에 은퇴하여 더 이상 릴리스·버그 수정·보안 패치가 제공되지 않습니다. (https://kubernetes.io/blog/2025/11/11/ingress-nginx-retirement/)
  • Ingress API 자체는 deprecated되지 않았으며 계속 사용할 수 있습니다. 다른 인그레스 컨트롤러로 교체하면 기존 Ingress 리소스를 유지할 수 있습니다(단, nginx.ingress.kubernetes.io/* 어노테이션은 호환되지 않을 수 있음).
  • 새로운 설계에서는 Gateway API 사용을 권장합니다. → W08-1. Service와 Gateway API - 강의 노트
  • 아래 Nginx 어노테이션 예시는 기존 Ingress-NGINX 환경 이해용으로 남겨 둡니다.

특징

인그레스 컨트롤러

클라우드 네트워크 개념과 비교

기본 Ingress 예시

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: minimal-ingress
spec:
  rules:
  - http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web-service
            port:
              number: 80

호스트 기반 라우팅 예시

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: host-based-routing
spec:
  rules:
  - host: app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: app-service
            port:
              number: 80
  - host: api.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: api-service
            port:
              number: 80

경로 기반 라우팅 예시

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: path-based-routing
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /app
        pathType: Prefix
        backend:
          service:
            name: app-service
            port:
              number: 80
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: api-service
            port:
              number: 80

TLS 구성 예시

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: tls-ingress
spec:
  tls:
  - hosts:
      - secure.example.com
    secretName: tls-secret  # 인증서와 키가 포함된 Secret
  rules:
  - host: secure.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: secure-service
            port:
              number: 80

인그레스 어노테이션 예시 (Nginx 인그레스 컨트롤러)

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-with-annotations
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
    nginx.ingress.kubernetes.io/rewrite-target: /$1
    nginx.ingress.kubernetes.io/proxy-body-size: "10m"
    nginx.ingress.kubernetes.io/use-regex: "true"
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /app/(.*)
        pathType: ImplementationSpecific
        backend:
          service:
            name: app-service
            port:
              number: 80
2026-10 갱신

기존 예시는 정규식 경로(/app/(.*))에 pathType: Prefix를 사용했으나, Prefix/Exact는 정규식을 지원하지 않습니다. 정규식 경로는 pathType: ImplementationSpecific과 nginx.ingress.kubernetes.io/use-regex: "true"를 함께 지정해야 합니다. (rewrite-target 사용 시에도 정규식이 적용됩니다.)

Path 타입


관련 문서