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.

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ệpVai 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.yamlBả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 upstream tới backend; provides.host và provides.port của Recipe backend được truyền vào gateway và kết xuất thành đích proxy_pass củ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_pass chuyể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ó:

Terminal window
aggrega scaffold --example nginx-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 nginx-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; --auto-pull ghi trong lúc build lockfile mà một bản clone mới còn thiếu:

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)
aggrega build --release release-helm-synth.yaml --auto-pull

Cá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)

Terminal window
aggrega build --release release-compose.yaml --auto-pull
docker compose -f dist/app/compose/docker-compose.yaml up -d

Mở 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.