カタログのみ — プラットフォームのオーサリングなしで MariaDB + Adminer
この例では、小さいながら実用的なスタック — MariaDB データベースと、その前段に置く Adminer Web UI — を、標準ライブラリのカタログ エンティティのみを参照してデプロイします。ここでは Component、Feature、Recipe を一切オーサリングしません。3 つの 短い YAML ファイルが、すべてをカタログに既に含まれるエンティティへルーティングします。
これは Aggrega が提供する最小のオーサリング面であり、言語に最初に 触れるのに自然な入口です。オーサリング層の姉妹例 は、独自のカタログ層を構築しながら同じスタックをデプロイします。まずこの 例を読んで完成したカタログで何が得られるかを確認し、次にそちらで その下の層がどのように作られるかを学んでください。
3 つのファイル
aggregate.yaml— Developer の意図、つまりスタックが何であるかです。type:でカタログから選んだ 2 つのコンポーネント、スロットを埋めるアタッチメントとしての必須の認証情報、そしてデータベースを Adminer のdatabasesソケットに接続する 1 本のusesエッジがあります。release.yaml— Operator による環境ごとの充足、つまりどの規模でどこにです。infra:ブロック(エンジンのバージョン、ストレージサイズ、公開ポート)は Operator に属し、Aggregate がそれらを持つことはありません。manifest.yaml— Operator によるルーティング、つまりこのターゲットでどの Recipe が各タイプを実現するかです。参照がプロバイダーで修飾されている理由は後述します。
示す内容
- カタログ参照としての Components。
type: core/datastore/mariadbとtype: core/devtool/adminerがコンピュート宣言のすべてです。 Developer は Component のスキーマが公開する値だけをオーサリングします。省略した フィールドはすべてスキーマのデフォルト値をとります(レンダリング出力の charset と collation の環境変数を、それらを生成した 1 行のvalues:ブロックと 比較してください)。 - String Pipe。 Adminer のカタログ Component は、
component.aggrega.ai/type=stateful-serverというラベルを持つ任意のコンポーネントを受け入れるdatabasesuses ソケットを宣言します。Aggregate のエッジは、 データベース Recipe のprovides.hostをADMINER_DEFAULT_SERVERに注入します。 コンパイラは文字列を解釈せずにルーティングします。このターゲットではそれは compose のサービス名であり、同じエッジが Kubernetes ターゲットでは Service の DNS 名を運びます。 - アタッチメントの柱。 データベース Component の
featuresSchemaはroot_passwordスロットを必須とし、そこはカタログのcore/secret-valueFeature で埋められます。このスロットはブラックボックスです。Manifest が選択した FeatureRecipe が 配信方法を制御し、Developer はそれを指定できません。 - Provider で修飾された Recipe のルーティング。 Manifest は
core/datastore/mariadb:1.0.0をcompose/mariadb:1.0.0にマッピングします。provider で 修飾しているのは、標準ライブラリが mariadb の Recipe を 複数の provider(compose や helm など)のもとで提供しているためです。 ターゲットを曖昧さなく決めるのは Operator のマッピングです。複数の provider の Recipe に一致する、修飾のない 素の参照は、黙って 1 つを選ぶのではなく、明示的にビルドを停止します。 これらのマッピングの向け先を変えればスタックのターゲットを変更でき、Aggregate は変わりません。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example catalog-onlyその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd catalog-onlyビルド
このディレクトリから、.aggrega-config.yaml が指定するデフォルトレジストリ hub.aggrega.ai からカタログのエンティティを解決して実行します:
aggrega pull --release release.yamlaggrega build --release release.yamlpull は参照されたすべてのエンティティを解決し、それを release.lock に固定します(識別子 + コンテンツダイジェスト。古くなったロックファイルは pull を再実行すると再生成できます)。標準ライブラリのカタログのチェックアウト(入手先)がある場合は、両方のコマンドでその aggrega-catalog ディレクトリを --catalog で指定すると、エンティティをそこから読み込みます。ビルドはそのロックファイルを読み込みます。ロックファイルがなければ、ビルドは停止し、pull または --auto-pull という 2 つの進め方を示します。そして dist/compose/docker-compose.yaml をレンダリングします。Release はコンポーネントを直接記述している(boundaries: ブロックがない)ため、コンパイラはそれらを合成されたデフォルトスコープにまとめ、dist/ の直下にフラットに出力します。境界は 1 つで、パスに境界名のセグメントはありません。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーを自分で作成しないでください。ワークスペースフォルダーにまだ `catalog-only` フォルダーがない場合は、`example` を `catalog-only` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、サンプルが新しい `catalog-only` フォルダーに書き出されます。次に、`workspace_root` を `catalog-only`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き出したファイルを教えてください。ファイルは `catalog-only/dist/` の下にあります。出力を読む
レンダリングされた compose ファイルで、配線が目に見えるようになります。
webサービスはADMINER_DEFAULT_SERVER: dbを持ちます。これはデータベース Recipe のprovides.host(compose のサービス名)が uses エッジを通じて渡されたものです。- 同じエッジが
depends_on: [db]を生成しました。文字列だけでなくトポロジーも生成されます。 dbサービスのMARIADB_CHARACTER_SET_SERVERとMARIADB_COLLATION_SERVERは、Aggregate が一切言及しないスキーマのデフォルト値から 来ています。image: mariadb:11.4と8080:8080のポートバインディングは Release のinfra:ブロックから来ています。これは Operator の柱であり、 Developer の柱と並んでレンダリングされます。
実行
cd dist/composedocker compose up -dhttp://localhost:8080 を開くと、サーバー欄に db が入力済みになっています。
Aggregate のアタッチメントにある開発用パスワード(dev-root-pw-change-me — ローカル開発以外では
置き換えるべきプレースホルダー)で root としてログインし、
データベースは appdb を指定します。
次のステップ
オーサリング層では、この例が出来合いのものとして利用した Components、Recipes、認証情報の FeatureRecipes という同じプラットフォーム層を 自分で構築し、1 つの Aggregate を 4 つのターゲットにコンパイルします。