인그레스 컨트롤러

클러스터에서 인그레스가 동작하려면 인그레스 컨트롤러가 실행 중이어야 한다. 적어도 하나의 인그레스 컨트롤러를 선택하고 이를 클러스터 내에 설정해야 한다. 이 페이지는 배포할 수 있는 일반적인 인그레스 컨트롤러를 나열한다.

참고:

쿠버네티스 프로젝트는 인그레스 대신 게이트웨이 사용을 권장한다. 인그레스 API는 동결(frozen)된 상태이다. ​ 이는 다음을 의미한다.

  • 인그레스 API는 일반적으로 사용 가능하며, 일반적으로 사용 가능한 API에 적용하는 안정성 보장을 따른다. 쿠버네티스 프로젝트는 인그레스를 쿠버네티스에서 제거할 계획이 없다.
  • 인그레스 API는 더 이상 개발되지 않으며, 앞으로 변경이나 업데이트가 이루어지지 않는다. ​

인그레스 컨트롤러

프로젝트로서 쿠버네티스는 AWS 및 GCE 인그레스 컨트롤러를 지원하고 유지 관리한다.

서드파티 인그레스 컨트롤러

참고: 이 섹션은 쿠버네티스에 필요한 기능을 제공하는 써드파티 프로젝트와 관련이 있다. 쿠버네티스 프로젝트 작성자는 써드파티 프로젝트에 책임이 없다. 이 페이지는 CNCF 웹사이트 가이드라인에 따라 프로젝트를 알파벳 순으로 나열한다. 이 목록에 프로젝트를 추가하려면 변경사항을 제출하기 전에 콘텐츠 가이드를 읽어본다.

여러 인그레스 컨트롤러 사용

하나의 클러스터 내에 인그레스 클래스를 이용하여 여러 개의 인그레스 컨트롤러를 배포할 수 있다. .metadata.name 필드를 확인해둔다. 인그레스를 생성할 때 인그레스 오브젝트(IngressSpec v1 참고)의 ingressClassName 필드에 해당 이름을 명시해야 한다. ingressClassName은 이전 어노테이션 방식의 대체 수단이다.

인그레스에 대한 인그레스 클래스를 설정하지 않았고, 클러스터에 기본으로 설정된 인그레스 클래스가 정확히 하나만 존재하는 경우, 쿠버네티스는 클러스터의 기본 인그레스 클래스를 인그레스에 적용한다. 인그레스 클래스에 ingressclass.kubernetes.io/is-default-class 어노테이션을 문자열 값 "true"로 설정하여, 해당 인그레스 클래스를 기본으로 설정할 수 있다.

이상적으로는 모든 인그레스 컨트롤러가 이 사양을 충족해야 하지만, 다양한 인그레스 컨트롤러는 약간 다르게 작동한다.

참고:

인그레스 컨트롤러의 설명서를 검토하여 선택 시 주의 사항을 이해해야 한다.

다음 내용

이 페이지는 쿠버네티스가 필요로 하는 기능을 제공하는 써드파티 프로젝트 또는 제품에 대해 언급하고 있습니다. 쿠버네티스 프로젝트 저자들은 이러한 써드파티 프로젝트 또는 제품에 대해 책임지지 않습니다. CNCF 웹사이트 가이드라인에서 더 자세한 내용을 확인합니다.

다른 써드파티 링크를 추가하는 변경을 제안하기 전에, 컨텐츠 가이드를 확인해야 합니다.

최종 수정 January 15, 2026 at 9:55 PM PST: [ko] Update Korean translation: ingress-controllers.md (#53827) (589deaaf00)