🌅 Ingress NGINX Retirement

[JeongsikKang]

안녕하세요, 얼마 전에 은퇴 소식을 전한 Ingress NGINX 에 대한 짧은 포스팅입니다.

About Ingress NGINX

쿠버네티스 클러스터에서 Service는 클러스터 내부 통신을 관리하지만, 외부 HTTP/HTTPS 트래픽을 내부 서비스로 라우팅하기 위해서는 Ingress 리소스가 필요합니다. Ingress는 외부에서 클러스터로 진입하는 트래픽에 대해 로드 밸런싱, SSL/TLS 종료, 호스트 기반 및 경로 기반 라우팅 규칙 등을 정의하는 API 오브젝트입니다. 이러한 Ingress 규칙을 실제로 해석하고 구현(Fulfillment)하는 데이터 플레인 컴포넌트가 Ingress Controller입니다.

Ingress NGINX Controller (이하 커뮤니티 버전) 쿠버네티스 커뮤니티와 SIG Network 에서 유지보수해왔던 가장 널리 배포된 인그레스 컨트롤러 중 하나입니다. 이 컨트롤러는 NGINX를 데이터 플레인으로 사용하며, 표준 Ingress API만으로는 불가능했던 트래픽 관리 기능을 공급업체별 어노테이션을 통해 제공해왔습니다.

현재 클러스터에서 사용 중인 Ingress NGINX 컨트롤러의 배포 정보는 다음과 같이 확인할 수 있습니다:

$ kubectl get pods --all-namespaces --selector app.kubernetes.io/name=ingress-nginx
NAMESPACE       NAME                                        READY   STATUS    RESTARTS   AGE
ingress-nginx   ingress-nginx-controller-65d7957798-g4htw   1/1     Running   0          82d


$ kubectl get deploy -n ingress-nginx ingress-nginx-controller -o yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
spec:
  template:
    spec:
      containers:
      - args:
        - /nginx-ingress-controller
        ...
        image: ingress-nginx/controller:v1.11.2 # 커뮤니티 버전 이미지       

Ingress NGINX의 공식 서비스 종료 (EOL, 2026-03)

Kubernetes SIG Network 및 Security Response Committee(SRC)는 커뮤니티가 관리하는 Ingress NGINX 컨트롤러의 공식적인 은퇴를 발표했습니다.(2025-11-11 )

서비스 종료 배경

널리 사용되었음에도 불구하고 EOL이 결정된 주된 이유는 프로젝트의 지속 가능한 운영 모델 부재와 누적된 기술 부채 때문입니다.

1. 지속 불가능한 유지보수: 이 프로젝트는 수년 동안 1~2명의 자원봉사 개발자에 의해서만 유지보수되었으며, 이는 광범위한 사용 규모에 비해 극도로 취약한 유지보수 모델이었습니다.

2. 보안 및 기술 부채: 장기간의 관리 부실로 인해 기술 부채가 누적되었고, snippets¹⁾과 같은 기능 주변에서 보안 문제가 지속적으로 제기되었습니다. ¹⁾snippets는 Ingress 설정에 Nginx 설정 코드를 그대로 삽입할 수 있게 해주는 기능

EOL 일정 및 영향

2026년 3월 이후 추가 릴리스, 버그 수정, 그리고 발견될 수 있는 보안 취약점에 대한 업데이트가 완전히 중단됩니다. (참고: F5에서 개발 및 유지보수하는 별도의 상업용 NGINX Ingress Controller (Official)는 서비스 종료 대상이 아니므로 , 이를 단기적인 대체 옵션으로 고려할 수 있습니다.)

마이그레이션 대안: Gateway API

장기적인 관점에서 Kubernetes 네트워킹의 공식 후속 표준은 Gateway API입니다. 이는 기존 Ingress API의 설계적 한계를 극복하기 위해 등장했습니다.

Gateway API 란?

Gateway API는 쿠버네티스에서 L4 및 L7 트래픽 라우팅을 위한 표준화되고 확장 가능한 프레임워크를 제공하는 API 입니다. 2023년에 GA 되었으며, 기존 Ingress가 제공하지 못했던 고급 네트워킹 기능을 네이티브하게 지원합니다. Gateway API

Gateway API는 다음 네 가지 설계 원칙을 기반으로 합니다:

• 역할 중심(Role-oriented): 인프라 관리(Gateway)와 애플리케이션 라우팅(Route) 책임을 명확하게 분리하여 RBAC(역할 기반 접근 제어)와 거버넌스를 강화합니다.

• 표현력(Expressive): 헤더 기반 일치, 가중치 트래픽 라우팅, 요청 타임아웃 등 기존 Ingress에서 어노테이션으로만 가능했던 복잡한 기능을 표준화된 필드로 지원합니다.

• 이식성(Portable): 공급업체별 어노테이션 의존성을 줄여, 구성을 다른 Gateway API 구현체로 쉽게 이전할 수 있도록 합니다.

• 확장성(Extensible): 정책(Policies) CRD나 필터(Filters)와 같은 구조화된 확장 모델을 제공하여, 공급업체 고유 기능을 일관된 방식으로 노출합니다.

Ingress NGINX vs. Gateway API

Ingress API와 Gateway API의 가장 큰 차이점은 구성 방식, 책임 분리, 그리고 확장성에 대한 접근 방식입니다.

마치며

오랫동안 정들었던 Ingress NGINX가 은퇴 수순을 밟게 되었다는 소식에 아쉬운 마음을 담아 포스팅을 적어봤습니다. (참 손에 익은 도구였는데 말이죠.) 연말이라 정신없으시겠지만, 서비스의 대문 역할을 하는 중요한 친구인 만큼 미리미리 이사 준비를 고민해보시면 좋을 것 같습니다. Gateway API나 Istio 같은 대안들이 있으니, 일단 ‘얼마나 고쳐야 할지’ 견적부터 내봐야겠습니다. 그럼 모두 따뜻한 연말 보내세요