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

インスタンスごとのレシピのオーバーライド

この例では、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 アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

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

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd per-instance-recipe-override

ビルド

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega 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 が実装する型は、マッピングによって曖昧さを解消する必要があります。マッピングされていない場合、ビルドは推測せずに停止し、候補を示します。