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

Маршрутизація між межами

Ця сторінка пояснює одну ідею — переписування адреси, яку отримує компонент, коли те, до чого він підключається, працює деінде, — і не є робочим простором, який можна запустити. Мережа між межами показує її в робочому просторі, який ви збираєте; запишіть його у власну теку командою:

Terminal window
aggrega scaffold --example cross-boundary-networking

Потім вона виводить команди, які слід виконати далі:

Terminal window
cd cross-boundary-networking
aggrega pull --release release-compose.yaml --catalog catalog-compose
aggrega build --release release-compose.yaml --catalog catalog-compose
aggrega pull --release release-helm.yaml --catalog catalog-helm
aggrega 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 — це точна форма кожного з них, а Коли вдаватися до кроку конвеєра пояснює, коли крок є правильним інструментом.