Workload ライブラリのインポート — `$import` による共有 Workload 本体
単一のステートレスな Web サービスで、その Recipe はインラインの本体ではなく共有ライブラリのエントリから Kubernetes の Workload を合成します。これは Recipe における spec.workload の 3 番目の記述モードです。
- モード 1(インライン): Recipe 内に直接記述する Go テンプレートの Workload。
- モード 2(ファイルのインポート):
$import: ./relative/path.yaml— ローカルファイル。 - モード 3(ライブラリのインポート):
$import: <Library>#/workloads/<Entry>— ベア名の同一性で参照されるWorkloadLibraryのエントリ。
ここでの web-service Recipe はモード 3 を使用します。
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessService参照は途切れのない 1 つのトークンとして記述します。ライブラリ名からフラグメントまで、どこにもスペースや改行を含めてはなりません。空白を含む参照はトリムされずに拒否され、ビルドは停止します。
errors/fatal-halts.md の「A reference to a library
entry carries whitespace(ライブラリエントリへの参照に空白が含まれています)」を参照してください。
BaseWorkloads は、hub カタログ(workloadlibrary/base-workloads)で公開されている WorkloadLibrary です。その StatelessService エントリは、この Recipe のレンダーコンテキストで評価される Go テンプレートであるため、.values.image(Component/Aggregate から)と .infra.*(レプリカ数、ポート、コンピュート — Release から)は、インラインの本体の場合とまったく同じようにそこへ流れ込みます。Workload をライブラリに切り出しても、デプロイされる内容は何も変わりません。レンダリングされた出力は、同等のインライン Workload とバイト単位で同一です。
ライブラリのバージョンは Release ごとのロックファイルから供給されます。参照にレジストリのホストは現れません。aggrega pull では、BaseWorkloads がロックファイルの workload_libraries セクションに固定されます。aggrega build では、固定されたライブラリが解決され、そのエントリがレンダリングされます。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example workload-library-importその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd workload-library-importビルド
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlカタログは、.aggrega-config.yaml で指定された hub レジストリ(BaseWorkloads と helm プロバイダを供給)と、この例のローカルの catalog/(web-service Component と Recipe)から解決されます。Manifests は dist/app/helm/ の下に出力されます。これは境界の directory: にプロバイダの capability が続いたものです。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `workload-library-import` フォルダーがない場合は、`example` を `workload-library-import` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `workload-library-import` フォルダーに例が書き込まれます。次に、`workspace_root` を `workload-library-import`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `workload-library-import/dist/` の下にあります。バイト同一性の主張を検証する
Recipe の workload: { $import: … } を、StatelessService の本体をそのまま記述した workload: | ブロックに置き換えて再ビルドし、2 つの dist/ ツリーを diff で比較します。両者は完全に一致します。ライブラリ参照は同じテンプレートテキストに解決され、同じレンダーコンテキストで評価されるため、インポートは記述面の切り出しにすぎず、レンダリングされるバイトには影響しません。