Kubernetes 上の MariaDB — 合成された helm (StatefulSet)、2 スロットの認証情報
helm プロバイダーの Workload
合成によって Kubernetes 上にレンダリングされる単一の MariaDB データベースで、外部チャートは使用しません。core/datastore/mariadb Component は
helm/mariadb Recipe にバインドされ、この Recipe は form: stateful Workload を宣言します。helm プロバイダーは
これを StatefulSet、ClusterIP Service、Headless
Service(StatefulSet の安定したネットワーク ID)、およびデータディレクトリ用の
volumeClaimTemplate に変換します。
この例の目的は、合成された helm ターゲット上での MariaDB の 2 スロット認証情報モデルを示すことです。 2 つのパスワードスロットは異なる 仕組みで渡されます。Component がそれぞれを異なる方法で宣言しており、Recipe は 各スロットが求める方法でそれぞれを配線するためです。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example mariadb-helm-synthその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd mariadb-helm-synthビルド
aggrega build --release release.yaml --auto-pullカタログは .aggrega-config.yaml に指定されたハブレジストリから解決されるため、--catalog フラグは不要です。また、--auto-pull は新しいクローンにはない lockfile をビルド中に書き出します。4 つのマニフェストが dist/helm/helm/ 配下に出力されます。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `mariadb-helm-synth` フォルダーがない場合は、`example` を `mariadb-helm-synth` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `mariadb-helm-synth` フォルダーに書き込まれます。次に、`workspace_root` を `mariadb-helm-synth`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `mariadb-helm-synth/dist/` の下にあります。root_password — Black-Box、inject パイプで配信
root_password は Black-Box スロットです。Component の featuresSchema が
inject: [] を宣言しているため、配信は Recipe が制御し、開発者は指定できません。
Aggregate は core/secret-value をアタッチし、Manifest はこれを
env-secret にマップします。この FeatureRecipe は、値をコンポーネントの inject パイプ上の
選択されたキーの下に置き、Recipe はそれを
.context.inject.env.MARIADB_ROOT_PASSWORD として読み取り、通常のコンテナ環境変数を出力します。
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meBlack-Box スロットがワークロードコンテナの attachments: ブロックから参照されることはなく、
そのための Kubernetes Secret リソースも生成されません。値は inject パイプを通じて
コンテナに直接届きます。
user_password — transparent、Secret + secretKeyRef として配信
user_password は transparent スロット(inject: [env, file])です。Aggregate は
core/referenced-secret をアタッチし、Manifest はこれを
k8s-secret-from-parameter にマップします。この FeatureRecipe は Kubernetes Secret を生成し、
その Secret の識別情報を provides {name, key} として公開します。Recipe は
containers.attachments を通じてスロットを参照し、シンセサイザーはこれを
環境変数の secretKeyRef としてレンダリングします。生成された Secret とコンテナの参照は、
どちらも .features.user_password.provides.name を読み取るため、同じリソースを指します。
再導出はなく、両者が一致させるべき慣例もありません。公開される
名前ではスロット名のアンダースコアがハイフンに正規化されるため、user_password
は有効な Kubernetes リソース名 db-user-password になります。それを
格納するファイル名は別の導出によるもので、表記が異なります。アタッチメント自身の座標として
コンポーネントとスロット名を前置し、小文字とアルファベットと数字のみを許容する
ファイル名用の文字セットにエンコードするため、
アンダースコアはハイフンではなくエスケープとして現れます。
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyuser_password をアタッチしないままにすることも有効です。その場合、Recipe は
インラインの開発用デフォルト(MARIADB_PASSWORD: apppass)にフォールバックし、Secret は
生成されないため、最小構成のデプロイでもレンダリングと実行が可能です。
オペレーターによるサイジング
release.yaml は環境ごとにオペレーターによるサイジングの柱を満たします。コンテナ
イメージのタグは infra.engine_version(mariadb:11.4)から、
volumeClaimTemplate のリクエストとストレージクラスは infra.storage
(5Gi、standard)から取得されます。開発者の Aggregate がこれらのフィールドを持つことはありません。