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

カタログのみ — プラットフォームのオーサリングなしで 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 というラベルを持つ任意のコンポーネントを受け入れる databases uses ソケットを宣言します。Aggregate のエッジは、 データベース Recipe の provides.host を ADMINER_DEFAULT_SERVER に注入します。 コンパイラは文字列を解釈せずにルーティングします。このターゲットではそれは compose のサービス名であり、同じエッジが Kubernetes ターゲットでは Service の DNS 名を運びます。
  • アタッチメントの柱。 データベース Component の featuresSchema は root_password スロットを必須とし、そこはカタログの core/secret-value Feature で埋められます。このスロットはブラックボックスです。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 アシスタントにビルドを任せることもできます。

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

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

ビルド

このディレクトリから、.aggrega-config.yaml が指定するデフォルトレジストリ hub.aggrega.ai からカタログのエンティティを解決して実行します:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

pull は参照されたすべてのエンティティを解決し、それを 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 の柱と並んでレンダリングされます。

実行

Terminal window
cd dist/compose
docker compose up -d

http://localhost:8080 を開くと、サーバー欄に db が入力済みになっています。 Aggregate のアタッチメントにある開発用パスワード(dev-root-pw-change-me — ローカル開発以外では 置き換えるべきプレースホルダー)で root としてログインし、 データベースは appdb を指定します。

次のステップ

オーサリング層では、この例が出来合いのものとして利用した Components、Recipes、認証情報の FeatureRecipes という同じプラットフォーム層を 自分で構築し、1 つの Aggregate を 4 つのターゲットにコンパイルします。