NGINX Ingress Controller: Định Tuyến Kubernetes

Tìm Hiểu Về NGINX Ingress Controller

NGINX Ingress Controller là Ingress Controller chính thức cho Kubernetes, được xây dựng và duy trì bởi đội ngũ NGINX tại F5. Nó chạy như một pod trong cluster, theo dõi resource Ingress và VirtualServer/VirtualServerRoute của riêng nó để cấu hình lại load balancer NGINX — xử lý routing host/path, TLS termination, và load balancing cho Websocket, gRPC, TCP, UDP. Đây là codebase khác repo kubernetes/ingress-nginx của cộng đồng.

Tính Năng Chính Cho Traffic Kubernetes

• ✓Routing theo nội dung qua Ingress chuẩn: routing theo host (ví dụ foo.example.com so với bar.example.com) và routing theo path (ví dụ /serviceA so với /serviceB).
• ✓TLS/SSL termination cấu hình riêng cho từng hostname.
• ✓Custom resource VirtualServer và VirtualServerRoute cho traffic splitting và routing nội dung nâng cao, vượt ra ngoài những gì spec Ingress hỗ trợ.
• ✓Resource TransportServer cho load balancing TCP, UDP, và TLS Passthrough.
• ✓Load balancing cho traffic Websocket và gRPC, ngoài HTTP.
• ✓Các tính năng NGINX/NGINX Plus bổ sung được expose qua annotations và resource ConfigMap, không cần custom resource riêng cho từng tinh chỉnh nhỏ.

Cài Đặt Ingress Controller

README không dán sẵn lệnh cài đặt — nó trỏ tới một Helm chart hoặc một bộ manifest Kubernetes, cả hai đều được link tới docs, nên hãy coi các trang đó là nguồn chính xác cho từng bước cụ thể. Điều được xác nhận: bản stable mới nhất hiện là 5.5.4, và image của nó được publish lên DockerHub, GitHub Container registry, Amazon ECR Public Gallery, và Quay.io (image NGINX Plus lấy từ container registry riêng của F5, hoặc bạn tự build từ source). README nhấn mạnh image, manifest/Helm chart, và docs bạn dùng phải cùng một phiên bản — ví dụ dùng image edge chung với manifest 5.5.4 là không được hỗ trợ. Sau khi cài, bước tiếp theo mà chính README đưa ra là cấu hình một app đơn giản qua resource Ingress thường (ví dụ Cafe) hoặc resource VirtualServer (ví dụ basic-configuration).

Cấu Hình Ingress Và Routing Nâng Cao

Có hai hướng cấu hình song song. Resource Ingress thường xử lý routing theo host/path cùng TLS termination theo từng hostname — giống hệt Ingress chuẩn của Kubernetes, được mở rộng bằng annotations và resource ConfigMap khi cần vượt ra ngoài các field sẵn có của spec Ingress. VirtualServer và VirtualServerRoute là hướng thứ hai, được xây riêng cho traffic splitting và routing nội dung nâng cao mà Ingress thường không làm được, và README có kèm ví dụ basic-configuration cho hướng này. Với traffic không phải HTTP, resource TransportServer xử lý TCP, UDP, và TLS Passthrough. Ngoài routing, controller còn load balancing traffic Websocket và gRPC giống như HTTP. Mọi ví dụ được nhắc tới đều nằm trong thư mục examples/ của repo, cùng với docs configuration-examples đầy đủ hơn.

Phân Biệt Với Các Lựa Chọn NGINX Ingress Khác

Câu Hỏi Thường Gặp

Vấn đề NGINX Ingress Controller giải quyết

Tài nguyên Ingress có sẵn của Kubernetes chỉ chuẩn hoá những thứ cơ bản — routing theo host/path và TLS theo từng hostname — còn các giao thức như gRPC, TCP/UDP thô, hay các pattern chia traffic kiểu canary release thì nằm ngoài spec đó hoàn toàn. NGINX Ingress Controller sinh ra để lấp khoảng trống đó cho người đã dùng NGINX: nó triển khai đúng resource Ingress chuẩn, rồi xếp thêm các custom resource VirtualServer/VirtualServerRoute và TransportServer của riêng mình lên trên, để những trường hợp chưa được chuẩn hoá đó không cần lắp thêm một load balancer riêng, không liên quan.

Trường hợp sử dụng tốt nhất

• •Chạy Ingress HTTP(S) production cho service trên Kubernetes khi team đã chuẩn hoá dùng NGINX và muốn có hỗ trợ chính hãng phía sau nó.
• •Chia traffic — routing kiểu canary hay blue-green — qua VirtualServer/VirtualServerRoute khi matching path/host đơn giản của Ingress chuẩn là chưa đủ.
• •Load balancing các giao thức không phải HTTP — Websocket, gRPC, TCP/UDP thô — qua một controller duy nhất, thay vì lắp thêm một load balancer L4 riêng.
• •TLS Passthrough cho workload cần tự terminate TLS thay vì để ingress làm, xử lý qua resource TransportServer.
• •Team dùng NGINX Plus muốn hợp đồng hỗ trợ thương mại gắn thẳng vào lớp ingress của mình.

Ai nên dùng — và ai nên bỏ qua

Dùng NGINX Ingress Controller nếu team bạn đã chuẩn hoá dùng NGINX, cần routing vượt ra ngoài những gì Ingress HTTP thuần làm được — traffic splitting, gRPC, TCP/UDP thô — hoặc muốn có đường thẳng tới hỗ trợ thương mại của NGINX Plus. Bỏ qua nếu bạn chỉ cần routing HTTP cơ bản và chưa có sẵn thiên hướng dùng NGINX, vì bạn sẽ phải học thêm CRD VirtualServer/VirtualServerRoute bên trên Ingress chuẩn cho những khả năng có thể bạn không cần, hoặc nếu bạn đã dùng sâu kubernetes/ingress-nginx và không muốn chạy thêm một controller thứ hai, cấu hình khác hẳn, song song.

Repo liên quan