kubernetes ingress
v3.7.1
이 저장소는 NGINX 뒤에 있는 사람들이 제공하는 NGINX 및 NGINX Plus용 수신 컨트롤러 구현을 제공합니다.
우리는 커뮤니티의 의견을 소중히 여기며 다음 커뮤니티 통화에서 뵙기를 바랍니다. 이러한 통화에서는 커뮤니티 구성원의 PR뿐만 아니라 문제, 토론 및 기능 요청에 대해서도 논의합니다.
Microsoft Teams 링크 : KIC - GitHub 문제 분류
회의 ID: 298 140 979 789
비밀번호: jpx5TM
Slack : NGINX 커뮤니티 Slack의 채널 #nginx-ingress-controller 에 가입하여 업데이트와 토론을 받으세요.
일시 : 15:00 GMT / 격주 월요일마다 해당 시간대로 변환합니다.
| 커뮤니티 통화 날짜 |
|---|
| 2024-10-07 |
| 2024-10-21 |
| 2024-11-05 |
| 2024-11-18 |
| 2024-12-02 |
| 2024-12-16 |
NGINX Ingress Controller는 NGINX 및 NGINX Plus와 함께 작동하며 콘텐츠 기반 라우팅 및 TLS/SSL 종료와 같은 표준 Ingress 기능을 지원합니다.
또한 주석 및 ConfigMap 리소스를 통해 Ingress 리소스에 대한 확장으로 여러 NGINX 및 NGINX Plus 기능을 사용할 수 있습니다. HTTP 외에도 NGINX Ingress Controller는 Websocket, gRPC, TCP 및 UDP 애플리케이션의 로드 밸런싱을 지원합니다. 지원되는 기능과 사용자 정의 옵션에 대해 자세히 알아보려면 ConfigMap 및 Annotations 문서를 참조하세요.
Ingress의 대안으로 NGINX Ingress Controller는 VirtualServer 및 VirtualServerRoute 리소스를 지원합니다. 트래픽 분할 및 고급 콘텐츠 기반 라우팅과 같이 Ingress 리소스에서 지원되지 않는 사용 사례를 활성화합니다. VirtualServer 및 VirtualServerRoute 리소스 문서를 참조하세요.
TCP, UDP 및 TLS 패스스루 로드 밸런싱도 지원됩니다. TransportServer 리소스 문서를 참조하세요.
NGINX Plus가 포함된 NGINX 수신 컨트롤러에 대해 자세히 알아보려면 이 문서를 읽어보세요.
메모
이 프로젝트는 kubernetes/ingress-nginx 저장소의 NGINX 수신 컨트롤러와 다릅니다. 주요 차이점을 알아보려면 이 문서를 참조하세요.
Ingress는 하나 이상의 서비스로 표시되는 Kubernetes에서 실행되는 애플리케이션에 대한 HTTP 부하 분산 장치를 구성할 수 있는 Kubernetes 리소스입니다. 이러한 로드 밸런서는 Kubernetes 클러스터 외부의 클라이언트에 해당 애플리케이션을 제공하는 데 필요합니다.
Ingress 리소스는 다음 기능을 지원합니다.
콘텐츠 기반 라우팅 :
호스트 기반 라우팅 . 예를 들어 호스트 헤더 foo.example.com 이 있는 요청을 한 서비스 그룹으로 라우팅하고 호스트 헤더 bar.example.com 다른 그룹으로 라우팅합니다.
경로 기반 라우팅 . 예를 들어 /serviceA 로 시작하는 URI가 있는 요청을 서비스 A로 라우팅하고 /serviceB 로 시작하는 URI가 있는 요청을 서비스 B로 라우팅합니다.
foo.example.com 과 같은 각 호스트 이름에 대한 TLS/SSL 종료 .
Ingress 리소스에 대해 자세히 알아보려면 Ingress 사용자 가이드를 참조하세요.
Ingress Controller는 클러스터에서 실행되고 Ingress 리소스에 따라 HTTP 부하 분산 장치를 구성하는 애플리케이션입니다. 로드 밸런서는 클러스터에서 실행되는 소프트웨어 로드 밸런서이거나 외부에서 실행되는 하드웨어 또는 클라우드 로드 밸런서일 수 있습니다. 로드 밸런서마다 서로 다른 수신 컨트롤러 구현이 필요합니다.
NGINX의 경우 Ingress Controller는 로드 밸런서와 함께 Pod에 배포됩니다.
메모
모든 문서는 GitHub 저장소의 릴리스 페이지에 표시된 최신 안정 릴리스에서만 사용해야 합니다.
Helm 차트 또는 Kubernetes 매니페스트를 사용하여 NGINX 수신 컨트롤러를 설치합니다.
간단한 웹 애플리케이션에 대한 로드 밸런싱을 구성합니다.
Ingress 리소스를 사용합니다. 카페 예시를 참고하세요.
또는 VirtualServer 리소스. 기본 구성 예를 참조하세요.
추가 구성 예를 참조하세요.
문서에서 사용 가능한 모든 구성 및 사용자 정의에 대해 자세히 알아보세요.
우리는 GitHub에 NGINX Ingress Controller 릴리스를 게시합니다. 릴리스 페이지를 참조하세요.
최신 안정 릴리스는 3.7.2입니다. 프로덕션 용도로 사용하려면 최신 안정 릴리스를 선택하는 것이 좋습니다.
Edge 버전은 아직 안정적인 릴리스에 게시되지 않은 새로운 기능을 실험하는 데 유용합니다. 이를 사용하려면 메인 브랜치의 최신 커밋으로 빌드된 엣지 버전을 선택하세요.
NGINX 수신 컨트롤러를 사용하려면 다음에 대한 액세스 권한이 필요합니다.
NGINX 수신 컨트롤러 이미지.
설치 매니페스트 또는 Helm 차트.
문서 및 예제.
위 항목의 버전이 일치하는 것이 중요합니다.
아래 표에는 이미지, Helm 차트, 매니페스트, 문서 및 예제와 관련된 옵션이 요약되어 있으며 올바른 버전에 대한 링크가 제공됩니다.
| 버전 | 설명 | NGINX용 이미지 | NGINX Plus용 이미지 | 설치 매니페스트 및 Helm 차트 | 문서 및 예제 |
|---|---|---|---|---|---|
| 최신 안정 릴리스 | 생산용 | DockerHub, GitHub 컨테이너, Amazon ECR Public Gallery 또는 Quay.io의 3.7.2 이미지를 사용하거나 자체 이미지를 구축하세요. | F5 Container Registry의 3.7.2 이미지를 사용하거나 자체 이미지를 빌드하세요. | 매니페스트. 헬름 차트. | 선적 서류 비치. 예. |
| 가장자리/야간 | 테스트 및 실험용 | DockerHub, GitHub 컨테이너, Amazon ECR Public Gallery 또는 Quay.io의 엣지 또는 야간 이미지를 사용하거나 자체 이미지를 구축하세요. | 자신만의 이미지를 구축하세요. | 매니페스트. 헬름 차트. | 선적 서류 비치. 예. |
바이너리 및 Docker 이미지에 대한 SBOM을 생성합니다.
바이너리용 SBOM은 릴리스 페이지에서 사용할 수 있습니다. SBOM은 syft를 사용하여 생성되며 SPDX 형식으로 사용할 수 있습니다.
Docker 이미지의 SBOM은 DockerHub, GitHub 컨테이너, Amazon ECR 공개 갤러리 또는 Quay.io 리포지토리에서 사용할 수 있습니다. SBOM은 syft를 사용하여 생성되고 이미지 매니페스트에 증명으로 저장됩니다.
예를 들어 Docker Hub에서 linux/amd64 용 SBOM을 검색하고 grype를 사용하여 분석하려면 다음 명령을 실행할 수 있습니다.
docker buildx imagetools는 nginx/nginx-ingress:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}'를 검사합니다 | 그리프우리는 귀하의 의견을 듣고 싶습니다! Ingress 컨트롤러에 대한 제안 사항이나 문제가 있는 경우 문제를 생성하거나 GitHub에서 끌어오기 요청을 보내주세요. NGINX Community Slack을 통해 직접 문의하실 수 있습니다.
프로젝트에 기여하고 싶다면 기여 가이드를 읽어보세요.
NGINX Plus 고객의 경우 NGINX Ingress Controller(NGINX Plus와 함께 사용되는 경우)에는 지원 계약이 적용됩니다.
