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

高度なパターン

このページでは、コンポーネント自身の Recipe を超えてビルドが何を書き出すかを決める場所としての Manifest と FeatureRecipe という 1 つの考え方を説明します。実行可能なワークスペースではありません。インスタンスごとのレシピの上書き では、ビルドするワークスペースで Manifest 側を示しています。次のコマンドで自分のフォルダーに書き出します:

Terminal window
aggrega scaffold --example per-instance-recipe-override

その後、次に実行するコマンドを表示します。

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

1 つのインスタンスに専用の 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

最も具体的なエントリが優先されます:

  1. インスタンス名に対する name エントリ;
  2. example/compute/greeter:1.0.0 のように、インスタンスのバージョンでタイプを指定する type エントリ;
  3. バージョンなしでタイプを指定する type エントリ;
  4. エントリがまったくない場合、ビルドはマッピングされていないインスタンスを示して停止します。

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: true

FeatureRecipe は、レンダリングするリソースに .context.rendered_name、つまりホストコンポーネントのプロバイダーが報告するその名前にちなんだ名前を付けます。そのため Ingress は、コンポーネント自身の Recipe がレンダリングする Service を指します。Aggregate の values に記述された host や、Release の infra にある path は、そのフィールド名を示して拒否されます。各ピラーは閉じており、そのフィールドはもう一方に属するためです。環境ごとに異なるパスは、Aggregate が宣言し各 Release が満たすパラメータです。