Contour gateway — một ingress controller gốc Kubernetes
Ví dụ này biên dịch một stack nhỏ nhưng thực tế — một ingress gateway Contour — từ
một Aggregate do Developer viết sang Kubernetes. Developer khai báo gateway là gì;
một Recipe duy nhất của Ops ánh xạ ý định đó sang Helm chart chính thức
project-contour (được phục vụ từ kho chart HTTPS của dự án)
và render các đối tượng Kubernetes.
Contour là một ingress controller gốc Kubernetes. Control plane của nó theo dõi các
resource Ingress và HTTPProxy của cluster và lập trình một data plane Envoy,
thành phần này kết thúc lưu lượng HTTP và HTTPS của client và cân bằng tải lưu lượng đó tới
các service phía sau mà các resource kia chỉ định. Đầu vào định tuyến của nó là chính các đối tượng Ingress
của cluster — không phải một upstream được nối dây — nên gateway không nhận cạnh uses
nào. Các ứng dụng tiếp cận nó bằng cách khai báo các resource Ingress theo ingress
class của nó. Cũng vì lý do đó, nó không có dạng container cục bộ độc lập, nên
họ này chỉ cung cấp một Recipe Helm; không có target Compose.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component gateway duy nhất (core/gateway/contour) chỉ định ingress class mà nó reconcile. |
manifest.yaml | Ánh xạ kiểu gateway sang Recipe Helm project-contour (contour). |
release.yaml | Bản ghi của operator cho target Kubernetes: cổng service của Envoy và kích thước control plane/data plane. |
Ví dụ này minh họa điều gì
- Một bề mặt soạn thảo, được hiện thực bởi một Recipe của Ops. Aggregate là nguồn sự thật về việc gateway là gì. Manifest cho biết cách hiện thực nó bằng cách ánh xạ kiểu gateway sang một Recipe theo tên; Release cung cấp kích thước vận hành. Ý định của Developer và ánh xạ của Ops được giữ tách biệt.
- Control plane và data plane từ một component. Recipe render cả hai
nửa của ingress controller: một
Deploymentcho control plane Contour và mộtDaemonSetcho data plane Envoy, được chart nối với nhau. - Quyền sở hữu ingress class. Giá trị
ingress_class_namecủa developer được truyền vào chart, chart này tạo mộtIngressClassmang tên đó. Các ứng dụng định tuyến tới gateway bằng cách tham chiếu class đó trong các resource Ingress của mình. - Quản lý CRD. Contour tự cài đặt và quản lý các
CustomResourceDefinitioncủa riêng nó (họHTTPProxy). Recipe để việc quản lý CRD bật theo mặc định; hãy tắt nó quainfra.overrides.manage_crdskhi các CRD đã được cài đặt sẵn. - Điểm vào của data plane.
Servicecủa Envoy được expose dưới dạngLoadBalancertheo mặc định; operator đặt cổng service HTTP quainfra.portvà có thể thay đổi kiểu service quainfra.overrides.service_type. - Image có thể tái lập. Recipe ghim lại các image Contour và Envoy vào các release tag tường minh để các workload được render tham chiếu các phiên bản đã được ghim.
Tạo ví dụ
Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.
Ghi ví dụ vào một thư mục mới đặt theo tên của nó:
aggrega scaffold --example contour-gatewaySau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:
cd contour-gatewayBuild
Workspace này không có .aggrega-config.yaml, nên các thực thể thư viện chuẩn được phân giải từ registry hub, hub.aggrega.ai, và không cần cờ catalog:
aggrega pull --release release.yamlaggrega build --release release.yamlCác artifact được render nằm trong dist/. Bản build phân giải chart upstream khi
aggrega pull và ghim nó trong một lockfile.
Với trợ lý AI
Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.
Chỉ sử dụng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa chứa thư mục `contour-gateway`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `contour-gateway` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `contour-gateway` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `contour-gateway`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm trong `contour-gateway/dist/`.Những gì được kết xuất
Bản build tạo ra toàn bộ stack ingress controller:
- một
Deploymentchạy control plane Contour, - một
DaemonSetchạy data plane Envoy, - các
CustomResourceDefinitioncủa Contour, - một
IngressClasstên làcontour, - một
LoadBalancerServiceđứng trước Envoy trên cổng HTTP 80 và cổng HTTPS 443,
cùng với ConfigMap hỗ trợ, Job sinh chứng chỉ, Service của control plane, NetworkPolicy, RBAC và ServiceAccount. Các image Contour và Envoy được ghim vào release tag của chúng, nên mọi workload đều tham chiếu một image tag đã được ghim.