Шлюз NGINX — маршрутизація зворотного проксі до upstream, дві цілі
Цей приклад компілює невеликий реальний стек — шлюз зворотного проксі NGINX перед веббекендом — з одного Aggregate, написаного розробником, у дві цілі:
- Docker Compose для локальної розробки та
- синтезовані маніфести Kubernetes для кластера.
Той самий aggregate.yaml керує обома. Для кожної цілі змінюється лише шар Recipe, обраний
сутністю Manifest.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: бекенд web (core/devtool/adminer) і шлюз proxy (core/gateway/nginx), який оголошує використання бекенда як upstream. |
manifest-compose.yaml | Зіставляє тип шлюзу з Recipe для Compose (compose/nginx), а бекенд — з Recipe Adminer для Compose. |
manifest-helm-synth.yaml | Зіставляє тип шлюзу із синтезованим helm-Recipe (helm/nginx), а бекенд — з офлайн helm-Recipe Adminer. |
release-compose.yaml / release-helm-synth.yaml | Записи оператора для двох цілей. |
Що демонструє приклад
- Одна поверхня написання, багато цілей. Єдиний Aggregate є джерелом істини щодо того, що являє собою стек. Кожен Manifest визначає, як його реалізувати.
- Маршрутизація upstream через String Pipe. Шлюз оголошує використання
бекенда як
upstream;provides.hostіprovides.portз Recipe бекенда передаються в шлюз і рендеряться в його цільproxy_pass. Компілятор маршрутизує рядки, не інтерпретуючи їх, — тож збірка Compose підставляє ім’я сервісу compose, а збірка Kubernetes — ім’я Service, з того самого ребра. - Конфігурація, ідіоматична для Provider. На обох цілях шлюз під час запуску
контейнера записує мінімальний блок server NGINX, чий
proxy_passпереспрямовує до впровадженого upstream, а потім запускає nginx на передньому плані. Ціль Kubernetes реалізує це як stateless Deployment плюс Service типу ClusterIP, без зовнішнього чарта Helm. - Відтворювані образи. Ціль Kubernetes запускає офіційний образ nginx із закріпленим явним тегом, тож відрендерений Deployment посилається на стабільний образ.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example nginx-gatewayПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd nginx-gatewayЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized manifests)aggrega build --release release-helm-synth.yaml --auto-pullВідрендерені артефакти потрапляють у dist/. Ціль Kubernetes рендерить звичайні
маніфести офлайн — завантаження чарта не потрібне.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека Workspace ще не містить теки `nginx-gateway`, викличте один раз інструмент `scaffold`, задавши для `example` значення `nginx-gateway` і не задаючи `dir`: він запише приклад у нову теку `nginx-gateway`. Потім викличте інструмент `build` один раз для кожної сутності Release у такому порядку — `release-compose.yaml` і `release-helm-synth.yaml` — щоразу задаючи для `workspace_root` значення `nginx-gateway`, для `release` — цей файл, для `auto_pull` — true і для `write` — true. Скажіть мені, які файли записала кожна збірка; вони розташовані в `nginx-gateway/dist/`.Як виглядає впроваджений upstream
У Compose сервіс шлюзу запускає NGINX із блоком server, що вказує на ім’я сервісу compose і порт бекенда:
server { listen 8000; location / { proxy_pass http://web:8080; } }У Kubernetes та сама маршрутизація надходить у команду контейнера, яка записує
конфігурацію сервера перед запуском nginx і вказує на Service бекенда —
helm-провайдер називає його за бекендом і його ключем сервісу default:
server { listen 8080; location / { proxy_pass http://web-default:8080; } }Обидва розв’язуються з того самого ребра Aggregate — хост і порт бекенда проходять
через використання upstream, і кожна ціль рендерить їх у власній ідіомі.
Запуск (Compose)
aggrega build --release release-compose.yaml --auto-pulldocker compose -f dist/app/compose/docker-compose.yaml up -dВідкрийте http://localhost:8000 — NGINX переспрямує запит до бекенда. Зупинити можна командою docker compose -f dist/app/compose/docker-compose.yaml down.