コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

境界を越えるルーティング

このページでは、接続先が別の場所で稼働しているときにコンポーネントが受け取るアドレスを書き換えるという 1 つの考え方を説明します。実行可能なワークスペースではありません。境界を越えるネットワーク では、ビルドするワークスペースでそれを示しています。次のコマンドで自分のフォルダーに書き出します:

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

2 つのコンポーネントが異なる境界に配置されている場合、ターゲットが公開する host はビルドが解釈できない文字列です。ビルドには、その文字列が反対側から到達可能かどうかを判断できません。そのため境界を越えるルーティングは、どの注入変数を書き換える必要があるかを示す、呼び出し側にアタッチされた Feature と、それをどう書き換えるかを示す、プロバイダーごとの FeatureRecipe から成ります。これを構成する要素にはそれぞれ専用のページがあります。injectMapping は entities/featurerecipe.md、境界アノテーションは entities/release.md、provides / inject / uses の契約は vocabulary/topology-triad.md にあります。

オペレーターが Feature を呼び出し側にアタッチする

この例の Kubernetes 版では、Adminer とそのデータベースは 2 つの境界にあり、それぞれ独自の名前空間に置かれ、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 プラグイン契約 にあり、ステップが適切な手段となる場面は パイプラインステップを使うべきとき で説明しています。