Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Шлюз 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 посилається на стабільний образ.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example nginx-gateway

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd nginx-gateway

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:

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

Відрендерені артефакти потрапляють у 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)

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

Відкрийте http://localhost:8000 — NGINX переспрямує запит до бекенда. Зупинити можна командою docker compose -f dist/app/compose/docker-compose.yaml down.