Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Шлюз NGINX — маршрутизация обратного прокси к вышестоящему сервису, две целевые платформы

Этот пример компилирует небольшой реальный стек — шлюз обратного прокси 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Сопоставляет тип шлюза с синтезирующим Recipe для helm (helm/nginx), а бэкенд — с офлайн-Recipe Adminer для helm.
release-compose.yaml / release-helm-synth.yamlЗаписи оператора для двух целевых платформ.

Что демонстрирует пример

  • Одна поверхность описания, много целевых платформ. Единственный Aggregate — источник истины о том, что представляет собой стек. Каждый Manifest описывает, как его реализовать.
  • Маршрутизация к вышестоящему сервису через String Pipe. Шлюз объявляет использование бэкенда типа upstream; значения provides.host и provides.port из Recipe бэкенда передаются в шлюз и отрисовываются в его цель proxy_pass. Компилятор маршрутизирует строки, не интерпретируя их, — поэтому сборка для Compose подставляет имя сервиса compose, а сборка для Kubernetes — имя Service, из одного и того же ребра.
  • Конфигурация, идиоматичная для Provider. На обеих целях шлюз при запуске контейнера записывает минимальный блок server для NGINX, в котором proxy_pass перенаправляет запросы во внедрённый upstream, а затем запускает nginx в приоритетном режиме. Цель Kubernetes реализует это как 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/`.

Как выглядит внедрённый вышестоящий сервис

В Compose сервис шлюза запускает NGINX с блоком server, указывающим на имя сервиса compose и порт бэкенда:

server { listen 8000; location / { proxy_pass http://web:8080; } }

В Kubernetes та же маршрутизация попадает в команду контейнера, которая записывает конфигурацию server перед запуском 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.