2026년 3월에 Kubernetes는 Ingress-NGINX를 폐기할 예정이며, 사용자는 Gateway API와 같은 다른 솔루션으로 마이그레이션해야 합니다. Ingress-NGINX는 마이그레이션 과정에서 고려하지 않으면 장애를 유발할 수 있는 몇 가지 놀라운 기본값과 부작용을 가지고 있습니다. 이 블로그 게시물은 사용자가 안전하게 마이그레이션하고 어떤 동작을 유지할지 신중하게 결정할 수 있도록 이러한 동작을 강조합니다. 주요 문제 중 하나는 Ingress-NGINX가 정규식 패턴을 접두사 및 대소문자를 구분하지 않는 일치로 처리하여 예기치 않은 라우팅을 초래할 수 있다는 것입니다. 반면, Gateway API는 구현별 정규식 일치를 사용하며, 사용자는 정규식 일치의 의미를 확인하기 위해 해당 구현을 확인해야 합니다. 이 게시물은 또한 RegularExpression 유형의 HTTP 경로 일치를 사용하고 HTTP 요청 리디렉션 필터를 사용하여 리디렉션을 구성하는 등 Gateway API에서 Ingress-NGINX 동작을 유지하는 방법에 대해 논의합니다. 또한 이 게시물은 Ingress-NGINX와 NGINX Ingress가 두 개의 별도 Ingress 컨트롤러이며, 이 블로그 게시물에서는 Ingress-NGINX만 다룬다는 점을 언급합니다. nginx.ingress.kubernetes.io/use-regex 주석은 모든 Ingress-NGINX Ingress의 호스트에 있는 모든 경로에 적용되며, nginx.ingress.kubernetes.io/rewrite-target 주석은 모든 부작용과 함께 nginx.ingress.kubernetes.io/use-regex 주석을 자동으로 추가합니다. Ingress-NGINX는 또한 후행 슬래시가 없는 요청을 후행 슬래시가 있는 동일한 경로로 리디렉션하는데, 이는 Gateway API에서 명시적으로 구성되지 않으면 장애를 유발할 수 있습니다. 전반적으로 이 게시물은 사용자가 Ingress-NGINX의 특성을 이해하고 Gateway API로 안전하게 마이그레이션할 수 있도록 돕는 것을 목표로 합니다. 사용자는 이러한 동작을 인식하고 장애를 방지하기 위해 Gateway API에서 이를 유지하기 위한 조치를 취해야 합니다.
nginx.ingress.kubernetes.io/use-regex주석은 모든 Ingress-NGINX Ingress의 호스트에 있는 모든 경로에 적용되며,nginx.ingress.kubernetes.io/rewrite-target주석은 모든 부작용과 함께nginx.ingress.kubernetes.io/use-regex주석을 자동으로 추가합니다. Ingress-NGINX는 또한 후행 슬래시가 없는 요청을 후행 슬래시가 있는 동일한 경로로 리디렉션하는데, 이는 Gateway API에서 명시적으로 구성되지 않으면 장애를 유발할 수 있습니다. 전반적으로 이 게시물은 사용자가 Ingress-NGINX의 특성을 이해하고 Gateway API로 안전하게 마이그레이션할 수 있도록 돕는 것을 목표로 합니다. 사용자는 이러한 동작을 인식하고 장애를 방지하기 위해 Gateway API에서 이를 유지하기 위한 조치를 취해야 합니다.