
API Ingress của Kubernetes, dù là nền tảng, vẫn bộc lộ những hạn chế về khả năng biểu đạt, phân tách vai trò và khả năng mở rộng cho việc quản lý lưu lượng phức tạp. Gateway API, một phiên bản kế nhiệm, giải quyết những thiếu sót này bằng cách giới thiệu một thiết kế chi tiết hơn, định hướng vai trò và một cơ chế mở rộng mạnh mẽ. Hướng dẫn này trình bày chi tiết chiến lược di chuyển sản xuất từ ingress-nginx sang triển khai Gateway API dựa trên Envoy, tập trung vào Envoy Gateway hoặc Cilium Gateway vì nền tảng proxy Envoy của chúng.
Generate Deployments, Services, ConfigMaps & Ingress
Convert multi-service Docker Compose v2/v3 YAML into production-grade Kubernetes manifests with custom replicas, health probes, resource limits, and PVC storage.
Gateway API giới thiệu một cấu trúc phân cấp:
GatewayClass: Định nghĩa một lớp Gateway, chỉ định bộ điều khiển chịu trách nhiệm triển khai nó (ví dụ: envoy-gateway-class, cilium-gateway-class). Điều này thường được quản lý bởi các nhà cung cấp cơ sở hạ tầng hoặc quản trị viên cụm.Gateway: Đại diện cho một phiên bản cụ thể của bộ cân bằng tải, phơi bày các cổng và giao thức. Nó được cung cấp bởi các nhà điều hành cơ sở hạ tầng hoặc nhóm nền tảng.HTTPRoute / GRPCRoute / TLSRoute / TCPRoute / UDPRoute: Định nghĩa các quy tắc định tuyến cụ thể theo giao thức, gắn vào các Gateway. Những quy tắc này thường được quản lý bởi các nhà phát triển ứng dụng.Thiết kế định hướng vai trò này phân tách các mối quan tâm: các nhóm cơ sở hạ tầng quản lý tài nguyên GatewayClass và Gateway, trong khi các nhóm ứng dụng quản lý tài nguyên Route, cho phép tự phục vụ mà không cần sửa đổi trực tiếp cơ sở hạ tầng.
Việc di chuyển theo từng giai đoạn, không gián đoạn là rất quan trọng. Chiến lược bao gồm:
ingress-nginx hiện có.ingress-nginx sang IP LoadBalancer của Gateway API.ingress-nginx cho đến khi hệ thống mới được xác thực hoàn toàn.cert-manager được cài đặt để tự động hóa TLS.kubectl và helm.ingress-nginx hiện có.Chúng ta sẽ sử dụng Envoy Gateway làm ví dụ chính, nhưng Cilium Gateway tuân theo một mô hình tương tự, tận dụng mặt phẳng dữ liệu eBPF của Cilium.
# gateway-api-crd-install.yaml
# Install Gateway API CRDs if not already present in your cluster.
# This is a prerequisite for any Gateway API controller.
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
name: gatewayclasses.gateway.networking.k8s.io
spec:
group: gateway.networking.k8s.io
names:
kind: GatewayClass
listKind: GatewayClassList
plural: gatewayclasses
singular: gatewayclass
scope: Cluster
versions:
- name: v1
served: true
storage: true
schema:
openAPIV3Schema:
type: object
x-kubernetes-preserve-unknown-fields: true
subresources:
status: {}
---
# ... other Gateway API CRDs (Gateway, HTTPRoute, etc.) ...
# For brevity, full CRD definitions are omitted.
# You can find them at https://github.com/kubernetes-sigs/gateway-api/releases
# Install Envoy Gateway via Helm
# Add the Envoy Gateway Helm repository
helm repo add envoy-gateway https://envoyproxy.github.io/envoy-gateway/
helm repo update
# Install Envoy Gateway into the 'envoy-gateway-system' namespace
helm install envoy-gateway envoy-gateway/envoy-gateway \
--create-namespace \
--namespace envoy-gateway-system \
--version v0.8.0 # Use the latest stable version
Xác minh việc triển khai:
kubectl get pods -n envoy-gateway-system
kubectl get gatewayclass
Bạn sẽ thấy một pod EnvoyGateway đang chạy và một GatewayClass có tên eg (mặc định cho Envoy Gateway) hoặc tương tự.
Nếu bạn đã sử dụng Cilium làm CNI của mình, Cilium Gateway cung cấp một giải pháp tích hợp cao tận dụng eBPF.
# Install Cilium with Gateway API support
helm upgrade --install cilium cilium/cilium \
--namespace kube-system \
--set gatewayAPI.enabled=true \
--set gatewayAPI.nodePort.enabled=true # Or LoadBalancer, depending on your cloud provider
# ... other Cilium configurations ...
Xác minh việc triển khai:
kubectl get pods -n kube-system -l k8s-app=cilium
kubectl get gatewayclass
Bạn sẽ thấy một GatewayClass có tên cilium hoặc tương tự.
Bước này bao gồm việc tạo tài nguyên Gateway, tài nguyên này sẽ cung cấp bộ cân bằng tải bên ngoài, và tài nguyên HTTPRoute để định nghĩa các quy tắc định tuyến.
Tài nguyên Gateway này sẽ cung cấp một Cloud LoadBalancer và phơi bày các cổng 80 và 443.
# gateway.yaml
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: my-app-gateway
namespace: default # Or your designated ingress namespace
spec:
gatewayClassName: eg # Use 'eg' for Envoy Gateway, 'cilium' for Cilium Gateway
listeners:
- name: http
protocol: HTTP
port: 80
allowedRoutes:
namespaces:
from: All # Allow HTTPRoutes from any namespace to attach
- name: https
protocol: HTTPS
port: 443
tls:
mode: Terminate
certificateRefs:
- kind: Secret
name: my-app-tls-secret # This secret will be provisioned by cert-manager
allowedRoutes:
namespaces:
from: All # Allow HTTPRoutes from any namespace to attach
Áp dụng điều này: kubectl apply -f gateway.yaml
Chờ Gateway được cung cấp. Kiểm tra trạng thái của nó:
kubectl get gateway my-app-gateway -n default -o yaml
Tìm status.addresses để lấy IP hoặc tên máy chủ bên ngoài của LoadBalancer đã được cung cấp. Đây sẽ là điểm truy cập mới của bạn.
cert-managerĐảm bảo cert-manager đã được cài đặt và cấu hình. Chúng ta sẽ sử dụng tài nguyên Certificate để cung cấp bí mật TLS.
# cert-manager-certificate.yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: my-app-tls-certificate
namespace: default
spec:
secretName: my-app-tls-secret # Matches the name in Gateway listener
dnsNames:
- myapp.example.com
- www.myapp.example.com
issuerRef:
name: letsencrypt-prod # Or your preferred ClusterIssuer/Issuer
kind: ClusterIssuer
group: cert-manager.io
Áp dụng điều này: kubectl apply -f cert-manager-certificate.yaml
Xác minh bí mật đã được tạo: kubectl get secret my-app-tls-secret -n default
Bây giờ, hãy định nghĩa HTTPRoute để định tuyến lưu lượng đến dịch vụ backend của bạn. Ví dụ này bao gồm định tuyến dựa trên đường dẫn và chia tách lưu lượng theo trọng số cho các triển khai canary.
# httproute.yaml
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: my-app-route
namespace: default # Namespace where your application service resides
spec:
parentRefs:
- name: my-app-gateway # Attach to the Gateway defined above
namespace: default
hostnames:
- "myapp.example.com"
- "www.myapp.example.com"
rules:
- matches:
- path:
type: PathPrefix
value: /api/v1/
backendRefs:
- name: my-app-service-v1 # Existing stable service
port: 80
weight: 90 # 90% of traffic to v1
- name: my-app-service-v2 # New canary service
port: 80
weight: 10 # 10% of traffic to v2
- matches:
- path:
type: PathPrefix
value: /
backendRefs:
- name: my-app-service-v1 # Default route for all other paths
port: 80
Áp dụng điều này: kubectl apply -f httproute.yaml
Đảm bảo my-app-service-v1 và my-app-service-v2 của bạn (và các Triển khai tương ứng của chúng) tồn tại trong không gian tên default.
Đây là giai đoạn quan trọng nhất để không gián đoạn.
kubectl get gateway my-app-gateway -n default -o jsonpath='{.status.addresses[0].value}'.a123.us-east-1.elb.amazonaws.com), hãy cập nhật bản ghi CNAME myapp.example.com của bạn để trỏ đến tên máy chủ mới này.myapp.example.com của bạn để trỏ đến IP mới này.myapp.example.com xuống một giá trị rất thấp (ví dụ: 60 giây). Điều này đảm bảo các thay đổi được lan truyền nhanh chóng.ingress-nginx cũ sang IP Gateway API mới. Điều này cho phép chuyển đổi có kiểm soát, dựa trên tỷ lệ phần trăm.Ví dụ Cập nhật DNS (Khái niệm, sử dụng myapp.example.com):
# Before migration (pointing to ingress-nginx LB)
myapp.example.com. 300 IN A 192.0.2.100
# During migration (after Gateway API LB is ready)
# Option 1: CNAME (if Gateway provides hostname)
myapp.example.com. 60 IN CNAME a123.us-east-1.elb.amazonaws.com.
# Option 2: A Record (if Gateway provides IP)
myapp.example.com. 60 IN A 203.0.113.200
# After full validation, revert TTL to a higher value (e.g., 3600)
myapp.example.com. 3600 IN CNAME a123.us-east-1.elb.amazonaws.com.
Xác thực kỹ lưỡng là tối quan trọng.
ingress-nginx cũ và đường dẫn Gateway API mới. Envoy Gateway phơi bày các số liệu Prometheus có thể được thu thập.HTTPRoute để dần dần cho một tỷ lệ nhỏ người dùng tiếp cận đường dẫn mới. Giám sát chặt chẽ.Gateway bị kẹt ở trạng thái Pendingkubectl get gateway my-app-gateway hiển thị status.conditions với Ready: False và message: "Gateway is not ready".kubectl logs -n envoy-gateway-system -l app.kubernetes.io/name=envoy-gateway. Tìm kiếm các lỗi liên quan đến các lệnh gọi API của nhà cung cấp đám mây.kubectl describe gateway my-app-gateway.HTTPRoute không gắn vào Gatewaykubectl get httproute my-app-route -o yaml hiển thị status.parents với conditions cho biết ResolvedRefs: False hoặc Accepted: False.parentRefs (tên, không gian tên) hoặc cấu hình allowedRoutes trên Gateway.parentRefs.name và parentRefs.namespace trong HTTPRoute khớp chính xác với tên và không gian tên của Gateway.Gateway.spec.listeners.allowedRoutes.namespaces.from được đặt chính xác (ví dụ: All hoặc Selector khớp với không gian tên của HTTPRoute).Gateway và HTTPRoute: kubectl describe gateway my-app-gateway và kubectl describe httproute my-app-route.SSL_PROTOCOL_ERROR hoặc certificate_unknown.certificateRef không chính xác trong Gateway, lỗi cert-manager, hoặc tls.mode không chính xác.Gateway.spec.listeners.tls.certificateRefs trỏ đến tên và không gian tên Secret chính xác.cert-manager Certificate và CertificateRequest: kubectl get certificate my-app-tls-certificate -n default -o yaml. Đảm bảo Ready: True.cert-manager: kubectl logs -n cert-manager -l app.kubernetes.io/instance=cert-manager.tls.mode là Terminate để kết thúc TLS ở biên.weight, hoặc tất cả lưu lượng đi đến một backend.backendRefs hoặc các vấn đề với khám phá dịch vụ.HTTPRoute.spec.rules.backendRefs.weight. Đảm bảo chúng tổng hợp chính xác nếu nhiều quy tắc được áp dụng.backendRefs.name và backendRefs.port trỏ chính xác đến tài nguyên Service Kubernetes của bạn.Service và EndpointSlice cho các dịch vụ backend của bạn để đảm bảo chúng có các pod khỏe mạnh.EnvoyProxy (nếu sử dụng Envoy Gateway) để điều chỉnh kích thước bộ đệm, giới hạn kết nối hoặc các cài đặt cụ thể khác của Envoy.envoy_cluster_upstream_rq_total, envoy_server_uptime).| Tính năng | Ingress-Nginx | Gateway API (Envoy Gateway) |
|---|---|---|
| Mô hình API | Ingress, IngressClass | GatewayClass, Gateway, HTTPRoute, v.v. |
| Phân tách vai trò | Hạn chế (quản trị viên quản lý IngressClass, nhà phát triển quản lý Ingress) | Mạnh mẽ (Cơ sở hạ tầng: GatewayClass, Người vận hành: Gateway, Nhà phát triển: Route) |
| Khả năng mở rộng | Chú thích, Nginx ConfigMaps | Gắn chính sách (ví dụ: HTTPRouteFilter), CRD EnvoyProxy |
| Chia tách lưu lượng | Chú thích (ví dụ: nginx.ingress.kubernetes.io/canary) | backendRefs.weight hạng nhất trong HTTPRoute |
| Đa cụm | Không được hỗ trợ nguyên bản | Được thiết kế cho đa cụm/đa người thuê |
| Hỗ trợ giao thức | HTTP/HTTPS, TCP/UDP (qua externalName hoặc stream-snippets) | HTTP/HTTPS, gRPC, TCP, UDP, TLS (CRD gốc) |
| Triển khai | Nginx | Envoy Proxy |
| Quản lý TLS | cert-manager qua chú thích Ingress | cert-manager qua Gateway.spec.listeners.tls.certificateRefs |
ingress-nginx và Gateway API đồng thời không?Có, đây là cách tiếp cận được khuyến nghị cho việc di chuyển theo từng giai đoạn. Chúng hoạt động độc lập, mỗi cái cung cấp LoadBalancer riêng. Bạn sẽ quản lý DNS để định tuyến lưu lượng đến một trong hai.
Đối với Envoy Gateway, bạn thường sử dụng tài nguyên tùy chỉnh EnvoyProxy để áp dụng các cấu hình Envoy nâng cao. Điều này cho phép thao tác trực tiếp cấu hình của proxy Envoy cơ bản. Đối với Cilium Gateway, bạn sẽ tận dụng các chính sách mạng của Cilium và có thể là tài nguyên CiliumEnvoyConfig cho các tính năng Envoy nâng cao. Bản thân Gateway API tập trung vào định tuyến tiêu chuẩn, trong khi các CRD cụ thể của bộ điều khiển cung cấp khả năng mở rộng.
Envoy là một proxy hiệu suất cao, thường vượt trội hơn Nginx đối với một số khối lượng công việc nhất định, đặc biệt với HTTP/2 và gRPC. Tác động hiệu suất thường là tích cực hoặc trung tính, giả sử phân bổ tài nguyên đầy đủ. Điều quan trọng là cấu hình và cung cấp tài nguyên phù hợp cho bộ điều khiển Envoy Gateway và các pod proxy Envoy.
Trường Gateway.spec.listeners.allowedRoutes kiểm soát những không gian tên nào được phép gắn tài nguyên Route vào một Gateway cụ thể. Bạn có thể chỉ định All, Same hoặc Selector để hạn chế hoặc cho phép các tệp đính kèm Route, cho phép môi trường đa người thuê an toàn. Ví dụ: from: All cho phép bất kỳ không gian tên nào, trong khi from: Selector với namespaceSelector chỉ cho phép các không gian tên khớp với các nhãn cụ thể.
Có, Gateway API đã được nâng cấp lên GA (General Availability) cho v1 vào tháng 10 năm 2023. Các bộ điều khiển như Envoy Gateway và Cilium Gateway đang được phát triển tích cực và được sử dụng trong môi trường sản xuất. Nó được coi là tương lai của ingress và quản lý lưu lượng trong Kubernetes.
Trong quá trình di chuyển từ `ingress-nginx` sang triển khai Gateway API dựa trên Envoy, một ứng dụng sản xuất quan trọng gặp lỗi 503 không liên tục sau khi chuyển đổi DNS một phần. Đội vận hành nghi ngờ có cấu hình sai trong thiết lập Gateway API mới. Hành động tức thời hiệu quả NHẤT sau đây để giảm thiểu sự cố với thời gian ngừng hoạt động tối thiểu là gì?
Làm sạch log AI CLI, tạo biểu thức cron, giải mã JWT và tính quyền chmod offline.

Hướng dẫn toàn diện về eBPF & Cilium trong Kubernetes: định tuyến thông lượng cao, chính sách mạng & khả năng quan sát Hubble với kiến trúc cấp độ sản xuất và các ví dụ mã.
Đọc tiếp
Đạt được triển khai thực sự không gián đoạn (zero-downtime) trên Kubernetes. Cấu hình Pod Disruption Budgets, terminationGracePeriodSeconds, preStop hooks và cơ chế connection draining của ingress.
Đọc tiếp
Hướng dẫn toàn diện so sánh Cilium và Calico với eBPF: thông lượng mạng Kubernetes, bảo mật & service mesh với kiến trúc cấp độ sản xuất và ví dụ mã.
Đọc tiếp