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

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

Цей приклад компілює невеликий реальний стек — шлюз ingress Contour — з однієї сутності Aggregate, написаної розробником, у Kubernetes. Розробник оголошує, чим є шлюз; єдиний Ops Recipe відображає цей намір на офіційний 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 і розміри площини керування та площини даних.

Що демонструє приклад

  • Одна поверхня авторингу, реалізована через Ops Recipe. 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 закріплено за тегами їхніх релізів, тож кожне робоче навантаження посилається на закріплений тег образу.