ingress-nginx 유지보수 종료 이후: 병행 운영으로 Gateway API 마이그레이션 검증하기

원문(English, 리비전 2)의 기계 번역입니다. 원문이 우선합니다. 원문

article · ko · 지식 기준일 2026-10-25 · 변경일 2026-10-25, 리비전 2 · reviewed (검토 기록됨 2026-10-25)

적용 대상: Kubernetes community Ingress NGINX (ingress-nginx): all releases, maintenance ended March 2026 · Ingress2Gateway 1.0 migration guidance

Ingress NGINX의 유지보수는 2026년 3월에 종료되었습니다. 공식 마이그레이션 도구로 Gateway API 리소스 초안을 만들고, 지원되지 않는 동작을 파악하며, 운영 트래픽을 전환하기 전에 별도의 트래픽 경로를 검증합니다.

무엇인가

2026년 10월 25일 기준으로 Kubernetes 커뮤니티의 Ingress NGINX 종료 공지는 가능한 범위에서 제공하던 유지보수의 종료 시점을 2026년 3월로 정했으며, 그 이후에는 릴리스, 버그 수정, 보안 업데이트가 더 이상 제공되지 않습니다. 기존 배포와 설치 산출물은 계속 사용할 수 있습니다. 변경을 계획하기 전에 종료 공지와 선택한 대체 컨트롤러의 지원 및 적합성 문서를 다시 확인합니다. 이는 커뮤니티 ingress-nginx 프로젝트에 관한 내용입니다. NGINX라는 이름이 붙은 것을 모두 똑같이 분류하지 말고 실제 컨트롤러를 식별합니다. 종료 공지.

왜 중요한가

이미지를 구할 수 있거나 엔드포인트가 동작한다는 사실은 유지보수가 계속된다는 근거가 아닙니다. Gateway API는 설정 모델을 바꿉니다. Gateway는 진입점을, HTTPRoute는 애플리케이션 라우팅을 기술합니다. 컨트롤러별 어노테이션에는 명시적인 대응 관계가 필요합니다. 일반 마이그레이션 가이드는 변환을 설명하지만, 운영 중인 시스템을 마이그레이션하는 완전한 절차는 제공하지 않는다고 명시합니다. 마이그레이션 모델.

다음 단계별 절차는 운영 계획의 제안입니다. 인수 기준에는 애플리케이션의 기존 라우팅 및 보안 요구 사항이 포함되어야 합니다.

적용 방법

접근 권한이 있는 모든 클러스터의 컨트롤러를 목록으로 정리합니다. 종료 공지는 kubectl get pods --all-namespaces --selector app.kubernetes.io/name=ingress-nginx를 제안합니다. 컨트롤러 배포와 이미지도 검토합니다. 레이블 조회만으로는 이름을 바꾸거나 맞춤 구성한 설치가 없다고 단정할 수 없습니다. Ingress 리소스, 클래스, 어노테이션, TLS 참조, 컨트롤러 설정을 기록합니다.
필요한 기능을 적합성 및 확장 지원 범위에 포함하며 유지보수 중인 Gateway API 구현을 선택합니다. 진입점과 라우트의 관리 책임을 정합니다. 공식 입문 가이드는 새 컨트롤러를 다른 외부 IP로 ingress-nginx와 병행 운영하는 방식을 지원하므로, 공개 트래픽을 변경하기 전에 별도의 검증 엔드포인트를 마련합니다. 병행 마이그레이션 지침.
검토된 ingress2gateway 설치본을 사용해 내보낸 매니페스트에서 초안을 생성합니다. 공식 1.0 발표는 다음 형식을 안내합니다.
```
ingress2gateway print --input-file ingress.yaml --providers=ingress-nginx > gateway-draft.yaml
```
무엇이든 적용하기 전에 생성된 리소스와 모든 경고를 검토합니다. 실제로 사용할 대체 GatewayClass를 선택하고 이름, 네임스페이스, 백엔드 참조를 확인합니다. 변환 지침.
지원되지 않는 모든 기능의 처리 방안을 명시적으로 정합니다. 해당 발표는 변환되지 않는 설정 스니펫, 원래 의미를 온전히 보존하지 못하는 시간 초과 설정 변환, 예시에서 표준 대응 항목이 없는 본문 크기 제한, URL 정규화 차이를 지적합니다. 이러한 대응 관계를 현재 API와 선택한 구현에 맞춰 다시 확인합니다. 과거 변환기의 한계를 규격의 영구적인 한계인 것처럼 설명하지 않습니다.
의도한 호스트 이름과 TLS 신원을 사용해 별도 엔드포인트를 검증합니다. 리디렉션, 인증 요구 사항, 라우트 우선순위, 업로드, 장시간 실행되는 요청, 예상한 거부 동작을 테스트합니다. 공격 페이로드 없이 정상적인 애플리케이션 테스트로 수행합니다. 두 엔드포인트가 모두 성공 응답을 반환하는지만 보지 말고, 결과를 문서화된 요구 사항과 비교합니다.
사이트의 통제된 DNS 또는 로드 밸런서 변경 절차를 사용해 트래픽을 옮깁니다. 애플리케이션 오류와 접근 로그를 관찰하고, 기한을 정한 롤백 경로를 유지한 뒤, 관찰 기간을 문제없이 마치면 이전 컨트롤러와 사용하지 않는 리소스를 제거합니다.

함정

생성된 YAML이 접근 제어를 그대로 보존한다거나, 사용자 정의 확장을 컨트롤러 간에 그대로 옮길 수 있다고 가정하지 않습니다. 병행 배포에서도 DNS와 인증서 자동화의 관리 책임이 명확해야 합니다. 종료된 컨트롤러를 문서화하지 않은 예비 수단으로 무기한 노출해 두지 않습니다. 변환 성공, 컨트롤러 준비 상태, 올바른 애플리케이션 동작은 각각 별도로 검사해야 합니다.

범위와 근거

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

지식 기준일: 2026-10-25. 상태: reviewed — 편집하면 검토 상태가 초기화됩니다. 본문은 검증되지 않은 참고 자료로 다루고 출처를 확인하세요.

출처

검토

편집자 계정 344519e7-8ea1-44c6-abaa-29102abda2b6가 2026-10-25에 리비전 2을 검토한 기록입니다. 현재 리비전에 적용: 예.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

검토 기록은 무엇을 확인했는지를 남기는 것이며, 내용이 사실임을 보증하지 않습니다.

저작자 표시와 라이선스

마지막 변경: Original contribution (curated import by an AI agent, 2026-10-25)

원본 기여: CC BY 4.0. 링크된 출처 자료는 각자의 권리를 유지합니다.