Маршрутизація між межами
Ця сторінка пояснює одну ідею — переписування адреси, яку отримує компонент, коли те, до чого він підключається, працює деінде, — і не є робочим простором, який можна запустити. Мережа між межами показує її в робочому просторі, який ви збираєте; запишіть його у власну теку командою:
aggrega scaffold --example cross-boundary-networkingПотім вона виводить команди, які слід виконати далі:
cd cross-boundary-networkingaggrega pull --release release-compose.yaml --catalog catalog-composeaggrega build --release release-compose.yaml --catalog catalog-composeaggrega pull --release release-helm.yaml --catalog catalog-helmaggrega build --release release-helm.yaml --catalog catalog-helmКоли два компоненти розміщено в різних межах, host, який публікує ціль, — це рядок, який збирання не може інтерпретувати: воно не може визначити, чи досяжний цей рядок з іншого боку. Тому маршрутизація між межами — це Feature, приєднана до викликача, яка вказує, яку впроваджену змінну слід переписати, і FeatureRecipe для кожного провайдера, яка вказує, як її переписати. Складники, з яких вона побудована, мають власні сторінки: injectMapping у entities/featurerecipe.md, анотації меж у entities/release.md і контракт provides / inject / uses у vocabulary/topology-triad.md.
Оператор приєднує Feature до викликача
У варіанті прикладу для Kubernetes Adminer і його база даних розташовані у двох межах, кожна у власному просторі імен, і Adminer отримує адресу бази даних у ADMINER_DEFAULT_SERVER. Оператор приєднує core/k8s-dns-resolver зі стандартної бібліотеки до Adminer у сутності Release і називає цю змінну; сутність Aggregate не змінюється. З файлу release-helm.yaml без коментарів:
spec: boundaries: frontend: directory: frontend annotations: aggrega.ai/namespace: "frontend" components: adminer: features: dns-resolver: type: core/k8s-dns-resolver:1.0.0 infra: target_var: ADMINER_DEFAULT_SERVER backend: directory: backend annotations: aggrega.ai/namespace: "backend"FeatureRecipe переписує змінну до рендерингу викликача
Сутність Manifest прив’язує Feature до helm/k8s-dns-resolver. Її injectMapping виконується після того, як змінні, що їх доставляє кожне з’єднання, опиняються на місці, і до того, як рендерить власна сутність Recipe викликача: він читає змінну, знаходить з’єднання, яке її доставило, читає простір імен цілі з анотацій цього з’єднання й записує змінну назад, кваліфіковану простором імен, — default, коли ціль його не оголошує:
spec: capability: helm implements: core/k8s-dns-resolver:1.0.0 injectMapping: | {{- $base_host := optional .context.inject.env .infra.target_var "" }} {{- $target_edge := dict }} {{- range $alias, $edge := .context.uses }} {{- if hasKey $edge.inject.env $.infra.target_var }} {{- $target_edge = $edge }} {{- end }} {{- end }} {{- $ns := "default" }} {{- if $target_edge.annotations }} {{- $raw := optional (optional (default dict $target_edge.annotations) "release" dict) "aggrega.ai/namespace" (optional (optional (default dict $target_edge.annotations) "aggregate" dict) "aggrega.ai/namespace" "") }} {{- if $raw }}{{- $ns = $raw }}{{- end }} {{- end }} {{- if and $target_edge $base_host }} env: "{{ .infra.target_var }}": "{{ $base_host | replace "\\" "\\\\" | replace "\"" "\\\"" }}.{{ $ns }}" {{- end }}Отже, база даних публікує своє некваліфіковане ім’я сервісу, а Adminer отримує його як db-default.backend. Переписується лише змінна викликача: опублікований host цілі не змінюється, і викликач у власному просторі імен цілі й далі досягає її за некваліфікованим іменем. target_var, що не відповідає жодному з’єднанню, нічого не впроваджує. Варіант прикладу для Docker Compose перетинає той самий шов в інший спосіб — за допомогою core/compose-bridge зі стандартної бібліотеки.
Крок конвеєра з боку плагіна
injectMapping — це шаблон, який збирання обчислює саме. FeatureRecipe або сутність Recipe може також оголосити pipeline: із кроків, кожен з яких після рендерингу виконує плагін WebAssembly. Крок отримує свій вхід with:, уже оброблений як шаблон відносно контексту приєднання, і набір відрендерених документів із ключами; він повертає патчі RFC 6902 щодо цих документів, будь-які ресурси, які додає як побічні ефекти, діагностику в спільній формі, у якій звітує кожен сокет, і виходи, які може прочитати наступний крок. Обидва напрямки передаються в канонічному двійковому кодуванні; контракт плагінів Wasm — це точна форма кожного з них, а Коли вдаватися до кроку конвеєра пояснює, коли крок є правильним інструментом.