インスタンスごとのレシピのオーバーライド
この例では、Manifest の機能を 1 つ取り上げます。name マッピング層です。これは、単一のコンポーネントインスタンスの Recipe をオーバーライドし、同じ型の他のすべてのインスタンスは一括の type 層の Recipe を維持します。
この例で示すこと
Aggregate は、1 つのコンポーネント型(example/compute/greeter)のインスタンスを 2 つ宣言します。
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeterカタログには、どちらも example/compute/greeter を実装する 2 つの Recipes、greeter-blue
(デフォルトのビルド)と greeter-green(代替のビルド)が含まれています。Manifest は
型を一括でマッピングし、1 つのインスタンスを名前でオーバーライドします。
mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance... name: greeter-special: compose/greeter-green:1.0.0 # ...except this one名前は型より優先されるため、greeter-special は greeter-green を通じてデプロイされ、
greeter-default は greeter-blue を通じてデプロイされます。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example per-instance-recipe-overrideその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd per-instance-recipe-overrideビルド
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlこの例では、プロバイダーに標準ライブラリを使用します。compose プロバイダーは標準カタログに含まれています。このオーバーライドの例に固有のおもちゃ、つまり example/compute/greeter デモコンポーネントとその 2 つのレシピ(greeter-blue / greeter-green)は、インスタンスごとのオーバーライドを目に見えるようにするためだけに存在し、標準ライブラリのエンティティとともに、共有カタログの example/ パブリッシャーの下に置かれています。.aggrega-config.yaml は hub.aggrega.ai をデフォルトのレジストリとして宣言しているため、エンティティはハブから解決され、ビルドコマンドに --catalog フラグは不要です。
レンダリングされた dist/app/compose/docker-compose.yaml では、オーバーライドが働いていることがわかります。
greeter-default は image: greeter:blue を実行し、greeter-special は
image: greeter:green を実行します。また、各サービスの aggrega.ai/recipe-uri 来歴
ラベルは、それぞれが解決された別々の Recipe を示します。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。Workspace フォルダーにまだ `per-instance-recipe-override` フォルダーがない場合は、`example` を `per-instance-recipe-override` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `per-instance-recipe-override` フォルダーに例が書き込まれます。次に、`workspace_root` を `per-instance-recipe-override`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `per-instance-recipe-override/dist/` の下にあります。これが有用な理由
1 つのコンポーネント型の 2 つのインスタンスで、異なる物理的な
実装が必要になることがあります。たとえば、プライマリデータベースはマネージドクラウドの Recipe を使い、
そのレプリカはクラスター内の Recipe を使う場合です。name 層は、コンポーネント型をフォークしたり
Aggregate を複製したりすることなく、それを Manifest の中でインスタンスごとに表現します。
複数の Recipe が実装する型は、マッピングによって曖昧さを解消する必要があります。マッピングされていない場合、ビルドは推測せずに停止し、候補を示します。