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

Шлюз Contour — нативный для Kubernetes ingress-контроллер

Этот пример компилирует небольшой реальный стек — ingress-шлюз Contour — из одного Aggregate, написанного разработчиком, в Kubernetes. Разработчик объявляет, что представляет собой шлюз; единственный Recipe от Ops сопоставляет это намерение с официальным Helm-чартом project-contour (который раздаётся из HTTPS-репозитория чартов проекта) и генерирует объекты Kubernetes.

Contour — нативный для Kubernetes ingress-контроллер. Его плоскость управления отслеживает ресурсы Ingress и HTTPProxy кластера и программирует плоскость данных Envoy, которая терминирует клиентский HTTP- и HTTPS-трафик и балансирует его между сервисами, названными в этих ресурсах. Входными данными для маршрутизации служат собственные объекты Ingress кластера, а не подключённый upstream, поэтому шлюз не имеет ребра uses. Приложения обращаются к нему, объявляя ресурсы Ingress для его ingress-класса. По той же причине у него нет автономной формы в виде локального контейнера, поэтому это семейство поставляет только Helm Recipe; цели Compose нет.

Файлы

ФайлРоль
aggregate.yamlНамерение разработчика: единственный компонент gateway (core/gateway/contour), который указывает ingress-класс, обслуживаемый им.
manifest.yamlСопоставляет тип шлюза с Helm Recipe project-contour (contour).
release.yamlЗапись оператора для цели Kubernetes: порт сервиса Envoy и размеры плоскости управления и плоскости данных.

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

  • Одна поверхность описания, реализуемая через Recipe от Ops. Aggregate является источником истины о том, что представляет собой шлюз. Manifest указывает, как его реализовать, сопоставляя тип шлюза с Recipe по имени; Release задаёт эксплуатационные размеры. Намерение разработчика и сопоставление от Ops остаются раздельными.
  • Плоскость управления и плоскость данных из одного компонента. Recipe генерирует обе половины ingress-контроллера: Deployment для плоскости управления Contour и DaemonSet для плоскости данных Envoy, которые связывает между собой чарт.
  • Владение ingress-классом. Значение ingress_class_name разработчика передаётся в чарт, который создаёт IngressClass с этим именем. Приложения направляют трафик на шлюз, ссылаясь на этот класс в своих ресурсах Ingress.
  • Управление CRD. Contour устанавливает собственные CustomResourceDefinition (семейство HTTPProxy) и управляет ими. Recipe по умолчанию оставляет управление CRD включённым; отключите его через infra.overrides.manage_crds, если CRD установлены заранее.
  • Точка входа плоскости данных. Service Envoy по умолчанию публикуется как LoadBalancer; оператор задаёт HTTP-порт сервиса через infra.port и может изменить тип сервиса через infra.overrides.service_type.
  • Воспроизводимые образы. Recipe повторно закрепляет образы Contour и Envoy за явными тегами релизов, чтобы сгенерированные рабочие нагрузки ссылались на закреплённые версии.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example contour-gateway

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd contour-gateway

Сборка

В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Сгенерированные артефакты помещаются в dist/. Сборка разрешает upstream-чарт при aggrega pull и закрепляет его в lock-файле.

С ИИ-ассистентом

ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.

Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочей области ещё нет папки `contour-gateway`, вызовите инструмент `scaffold` один раз, задав `example` равным `contour-gateway` и не указывая `dir`: он запишет пример в новую папку `contour-gateway`. Затем вызовите инструмент `build`, задав `workspace_root` равным `contour-gateway`, `release` равным `release.yaml`, `auto_pull` равным true и `write` равным true. Сообщите мне, какие файлы записала сборка; они находятся в `contour-gateway/dist/`.

Что формируется

Сборка выдаёт полный стек ingress-контроллера:

  • Deployment, в котором работает плоскость управления Contour,
  • DaemonSet, в котором работает плоскость данных Envoy,
  • ресурсы CustomResourceDefinition Contour,
  • IngressClass с именем contour,
  • LoadBalancer Service, стоящий перед Envoy на HTTP-порту 80 и HTTPS-порту 443,

а также вспомогательные ConfigMap, Job для генерации сертификатов, Service уровня управления, NetworkPolicy, RBAC и ServiceAccount. Образы Contour и Envoy закреплены за тегами своих релизов, поэтому каждая рабочая нагрузка ссылается на закреплённый тег образа.