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