高度なパターン
このページでは、コンポーネント自身の Recipe を超えてビルドが何を書き出すかを決める場所としての Manifest と FeatureRecipe という 1 つの考え方を説明します。実行可能なワークスペースではありません。インスタンスごとのレシピの上書き では、ビルドするワークスペースで Manifest 側を示しています。次のコマンドで自分のフォルダーに書き出します:
aggrega scaffold --example per-instance-recipe-overrideその後、次に実行するコマンドを表示します。
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yaml1 つのインスタンスに専用の Recipe
Manifest の type 階層は、あるコンポーネントタイプのすべてのインスタンスを 1 つの Recipe に結び付けます。name 階層は、Aggregate 内での名前によって 1 つのインスタンスを別の Recipe に結び付け、そこで名指しされたインスタンスはそれを使い、そのタイプの他のすべてのインスタンスは type の結び付けを維持します。例の manifest.yaml から:
spec: mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 name: greeter-special: compose/greeter-green:1.0.0最も具体的なエントリが優先されます:
- インスタンス名に対する
nameエントリ; example/compute/greeter:1.0.0のように、インスタンスのバージョンでタイプを指定するtypeエントリ;- バージョンなしでタイプを指定する
typeエントリ; - エントリがまったくない場合、ビルドはマッピングされていないインスタンスを示して停止します。
Manifest は通常の YAML であるため、繰り返す値はアンカーで一度だけ記述し、エイリアスで参照できます。
独自のリソースを持ち込む Feature
FeatureRecipe は、コンポーネントの Recipe がレンダリングする内容を変更する代わりに、source: で指定され valuesMapping から値を受け取る独自のチャートから、コンポーネント自身のリソースと並べてリソースをレンダリングできます。標準ライブラリの core/public-ingress は Kubernetes 上でこの方法で実現されており、helm/public-ingress がアタッチ先のコンポーネント用の Ingress をレンダリングします。
コンポーネントが提供するリクエストパスはアプリケーションの一部であるため、Feature はそれを values で受け取ります。ホスト名は環境がそのコンポーネントに付ける名前であるため、クラスタを記述する設定と並んで infra に置きます。エージェント、ルーター、2 つのアップストリームモデル では、開発者が Aggregate でそれをアタッチし、パスを記述します:
features: published: type: core/public-ingress values: path: /そして Release は同じアタッチメントにホストを与え、ターゲットクラスタで ingress コントローラが稼働していることを確認します。この確認がなければビルドは停止します。コメントを省いた release.yaml から:
published: infra: host: assistant.example.internal control_plane_present: trueFeatureRecipe は、レンダリングするリソースに .context.rendered_name、つまりホストコンポーネントのプロバイダーが報告するその名前にちなんだ名前を付けます。そのため Ingress は、コンポーネント自身の Recipe がレンダリングする Service を指します。Aggregate の values に記述された host や、Release の infra にある path は、そのフィールド名を示して拒否されます。各ピラーは閉じており、そのフィールドはもう一方に属するためです。環境ごとに異なるパスは、Aggregate が宣言し各 Release が満たすパラメータです。