Repolode
nginx

nginx/kubernetes-ingress

Kubernetes Ingress Controller로, NGINX 또는 NGINX Plus를 사용해 외부 HTTP, gRPC, TCP, UDP 트래픽을 클러스터 서비스로 라우팅합니다.

스타
5,094
포크
2,056
열린 이슈
190
마지막 커밋
8시간 전

어떤 프로젝트인가요?

NGINX Ingress Controller는 클러스터의 Ingress 리소스에 따라 NGINX 또는 NGINX Plus 로드 밸런서를 구성하는 Kubernetes 구성 요소입니다. 호스트와 경로를 기준으로 콘텐츠를 라우팅하고, 각 호스트 이름의 TLS/SSL을 종료해 클러스터 내부 애플리케이션에 외부에서 접근할 수 있도록 합니다.

표준 Ingress 외에도 이 컨트롤러는 어노테이션과 ConfigMap 설정으로 NGINX 기능을 제공합니다. 트래픽 분할과 같은 경우에 사용할 수 있는 자체 VirtualServer 및 VirtualServerRoute 리소스와, TCP·UDP 및 TLS passthrough를 위한 TransportServer 리소스도 제공합니다. HTTP뿐 아니라 Websocket, gRPC, TCP, UDP 애플리케이션도 지원합니다.

이 프로젝트는 NGINX(F5)가 유지 관리합니다. Helm chart 또는 Kubernetes 매니페스트로 설치할 수 있으며, NGINX와 NGINX Plus용 이미지를 모두 제공합니다. kubernetes/ingress-nginx 컨트롤러와는 별개의 프로젝트입니다.

핵심 기능

  • 01HTTP 트래픽을 호스트 및 경로 기준으로 라우팅합니다.
  • 02각 호스트 이름의 TLS/SSL을 종료합니다.
  • 03HTTP, Websocket, gRPC, TCP, UDP 애플리케이션의 로드 밸런싱을 지원합니다.
  • 04트래픽 분할과 고급 라우팅을 위한 VirtualServer 리소스를 제공합니다.
  • 05TransportServer 리소스를 통해 TLS passthrough를 지원합니다.
  • 06오픈소스 NGINX와 NGINX Plus를 모두 지원합니다.

활용 사례

  • Kubernetes 클러스터에서 실행되는 웹 애플리케이션을 외부 클라이언트에 공개합니다.
  • 단일 진입점에서 여러 서비스의 TLS 인증서를 종료합니다.
  • 롤아웃 중 애플리케이션 버전 간 트래픽을 분할합니다.
  • Kubernetes 환경에서 gRPC 또는 TCP 서비스의 로드 밸런싱을 수행합니다.

빠른 시작

  1. 1

    README에 링크된 Helm chart 또는 Kubernetes manifests를 사용해 컨트롤러를 설치하세요

  2. 2

    Cafe 예제 또는 VirtualServer 기본 구성 예제를 사용해 샘플 앱의 로드 밸런싱을 설정하세요

사용 전 알아둘 점

  • Kubernetes 클러스터 내에서만 실행됩니다.
  • 일부 기능을 사용하려면 지원 계약이 적용되는 상용 제품인 NGINX Plus가 필요합니다.
  • kubernetes/ingress-nginx의 NGINX Ingress Controller와는 별개의 프로젝트입니다.

포함된 컬렉션

토픽

자주 묻는 질문

kubernetes-ingress은(는) 무엇인가요?
Kubernetes Ingress Controller로, NGINX 또는 NGINX Plus를 사용해 외부 HTTP, gRPC, TCP, UDP 트래픽을 클러스터 서비스로 라우팅합니다. NGINX Ingress Controller는 클러스터의 Ingress 리소스에 따라 NGINX 또는 NGINX Plus 로드 밸런서를 구성하는 Kubernetes 구성 요소입니다. 호스트와 경로를 기준으로 콘텐츠를 라우팅하고, 각 호스트 이름의 TLS/SSL을 종료해 클러스터 내부 애플리케이션에 외부에서 접근할 수 있도록 합니다.
kubernetes-ingress은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
kubernetes-ingress은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
kubernetes-ingress은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. kubernetes-ingress의 마지막 커밋은 2026년 11월 6일입니다.
kubernetes-ingress은(는) 어디에 사용할 수 있나요?
Kubernetes 클러스터에서 실행되는 웹 애플리케이션을 외부 클라이언트에 공개합니다. 단일 진입점에서 여러 서비스의 TLS 인증서를 종료합니다. 롤아웃 중 애플리케이션 버전 간 트래픽을 분할합니다. Kubernetes 환경에서 gRPC 또는 TCP 서비스의 로드 밸런싱을 수행합니다.
kubernetes-ingress는 어떻게 설치하나요?
README에 링크된 Helm chart 또는 Kubernetes manifests를 사용해 컨트롤러를 설치하세요 Cafe 예제 또는 VirtualServer 기본 구성 예제를 사용해 샘플 앱의 로드 밸런싱을 설정하세요
kubernetes-ingress은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nginx/kubernetes-ingress

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트