NGINX gateway — định tuyến reverse-proxy tới một upstream, hai đích
Ví dụ này biên dịch một stack nhỏ, thực tế — một gateway reverse-proxy NGINX đứng trước một web backend — từ một Aggregate do Developer soạn thảo tới hai đích:
- Docker Compose cho phát triển cục bộ, và
- các manifest Kubernetes được tổng hợp cho một cluster.
Cùng một aggregate.yaml điều khiển cả hai. Chỉ có lớp Recipe được Manifest
chọn là thay đổi theo từng đích.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một backend web (core/devtool/adminer) và một gateway proxy (core/gateway/nginx) khai báo một lần sử dụng upstream tới backend. |
manifest-compose.yaml | Ánh xạ kiểu gateway tới Recipe Compose (compose/nginx) và backend tới Recipe Compose Adminer. |
manifest-helm-synth.yaml | Ánh xạ kiểu gateway tới Recipe helm tổng hợp (helm/nginx) và backend tới Recipe helm Adminer ngoại tuyến. |
release-compose.yaml / release-helm-synth.yaml | Bản ghi của Operator cho hai đích. |
Ví dụ này minh họa điều gì
- Một bề mặt soạn thảo, nhiều đích. Một Aggregate duy nhất là nguồn chân lý cho việc stack là gì. Mỗi Manifest cho biết cách hiện thực nó.
- Định tuyến upstream qua String Pipe. Gateway khai báo một lần sử dụng
upstreamtới backend;provides.hostvàprovides.portcủa Recipe backend được truyền vào gateway và kết xuất thành đíchproxy_passcủa nó. Trình biên dịch định tuyến các chuỗi mà không diễn giải chúng — vì vậy bản build Compose nối một tên service compose và bản build Kubernetes nối một tên Service, từ cùng một cạnh. - Cấu hình theo phong cách của Provider. Trên cả hai đích, gateway ghi một
server block NGINX tối giản khi container khởi động, với
proxy_passchuyển tiếp tới upstream được chèn vào, rồi khởi động nginx ở chế độ foreground. Đích Kubernetes hiện thực điều này thành một Deployment không trạng thái cùng một ClusterIP Service, không cần Helm chart bên ngoài. - Image có thể tái tạo. Đích Kubernetes chạy image nginx upstream chính thức được ghim vào một tag tường minh, nên Deployment được kết xuất tham chiếu một image ổn định.
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 nginx-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 nginx-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; --auto-pull ghi trong lúc build lockfile mà một bản clone mới còn thiếu:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullCác artifact được kết xuất nằm trong dist/. Đích Kubernetes kết xuất manifest
thuần ở chế độ ngoại tuyến — không cần kéo chart.
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ỉ 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 Workspace chưa có thư mục `nginx-gateway`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `nginx-gateway` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `nginx-gateway` mới. Sau đó gọi công cụ `build` một lần cho mỗi Release, theo thứ tự này — `release-compose.yaml` và `release-helm-synth.yaml` — mỗi lần với `workspace_root` đặt thành `nginx-gateway`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết mỗi bản dựng đã ghi những tệp nào; chúng nằm trong `nginx-gateway/dist/`.Upstream được chèn vào trông như thế nào
Trên Compose, service gateway chạy NGINX với một server block trỏ tới tên service compose và cổng của backend:
server { listen 8000; location / { proxy_pass http://web:8080; } }Trên Kubernetes, cùng việc định tuyến đó xuất hiện trong lệnh của container, lệnh này ghi
cấu hình server trước khi khởi động nginx, trỏ tới Service của backend —
helm provider đặt tên nó theo backend và khóa service default của nó:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Cả hai đều được phân giải từ cùng một cạnh Aggregate — host và cổng của backend đi
qua lần sử dụng upstream, và mỗi đích kết xuất chúng theo phong cách riêng.
Chạy thử (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dMở http://localhost:8000 — NGINX chuyển tiếp yêu cầu tới backend. Gỡ bỏ bằng docker compose -f dist/app/compose/docker-compose.yaml down.