跨边界路由
本页讲解一个概念:当组件所连接的对象运行在别处时,改写该组件收到的地址;本页并不是可运行的工作区。跨边界网络在一个你可以构建的工作区中展示了这一点;用以下命令将其写入你自己的文件夹:
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 接收数据库的地址。运维人员在 Release 中将标准库的 core/k8s-dns-resolver 附加到 Adminer 并指明该变量;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 插件契约给出了两者各自的确切格式,何时使用流水线步骤说明了何时步骤才是合适的工具。