Шлюз 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 установлены заранее. - Точка входа плоскости данных.
ServiceEnvoy по умолчанию публикуется какLoadBalancer; оператор задаёт HTTP-порт сервиса черезinfra.portи может изменить тип сервиса черезinfra.overrides.service_type. - Воспроизводимые образы. Recipe повторно закрепляет образы Contour и Envoy за явными тегами релизов, чтобы сгенерированные рабочие нагрузки ссылались на закреплённые версии.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example contour-gatewayЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd contour-gatewayСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:
aggrega pull --release release.yamlaggrega 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,- ресурсы
CustomResourceDefinitionContour, IngressClassс именемcontour,LoadBalancerService, стоящий перед Envoy на HTTP-порту 80 и HTTPS-порту 443,
а также вспомогательные ConfigMap, Job для генерации сертификатов, Service уровня управления, NetworkPolicy, RBAC и ServiceAccount. Образы Contour и Envoy закреплены за тегами своих релизов, поэтому каждая рабочая нагрузка ссылается на закреплённый тег образа.