Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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ệpVai 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.yamlBả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 Deployment cho control plane Contour và một DaemonSet cho data plane Envoy, được chart nối với nhau.
  • Quyền sở hữu ingress class. Giá trị ingress_class_name của developer được truyền vào chart, chart này tạo một IngressClass mang 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 CustomResourceDefinition của riêng nó (họ HTTPProxy). Recipe để việc quản lý CRD bật theo mặc định; hãy tắt nó qua infra.overrides.manage_crds khi các CRD đã được cài đặt sẵn.
  • Điểm vào của data plane. Service của Envoy được expose dưới dạng LoadBalancer theo mặc định; operator đặt cổng service HTTP qua infra.port và có thể thay đổi kiểu service qua infra.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ó:

Terminal window
aggrega scaffold --example contour-gateway

Sau đó 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:

Terminal window
cd contour-gateway

Build

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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Cá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 Deployment chạy control plane Contour,
  • một DaemonSet chạy data plane Envoy,
  • các CustomResourceDefinition của Contour,
  • một IngressClass tên là contour,
  • một LoadBalancer Service đứ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.