Маршрутизация между границами
Эта страница объясняет одну идею — переписывание адреса, который получает компонент, когда то, к чему он подключается, работает в другом месте, — и не является запускаемым рабочим пространством. Сетевое взаимодействие между границами показывает её в рабочем пространстве, которое вы собираете; запишите его в собственную папку командой:
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 — это точная форма каждого из них, а Когда прибегать к шагу конвейера объясняет, когда шаг — правильный инструмент.