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

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

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

Terminal window
aggrega scaffold --example mariadb-helm-synth

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

Terminal window
cd mariadb-helm-synth

ビルド

Terminal window
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-me

Black-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 になります。それを 格納するファイル名は別の導出によるもので、表記が異なります。アタッチメント自身の座標として コンポーネントとスロット名を前置し、小文字とアルファベットと数字のみを許容する ファイル名用の文字セットにエンコードするため、 アンダースコアはハイフンではなくエスケープとして現れます。

db--user-zupassword--db-secret-db-user-password.yaml
[… 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 key

user_password をアタッチしないままにすることも有効です。その場合、Recipe は インラインの開発用デフォルト(MARIADB_PASSWORD: apppass)にフォールバックし、Secret は 生成されないため、最小構成のデプロイでもレンダリングと実行が可能です。

オペレーターによるサイジング

release.yaml は環境ごとにオペレーターによるサイジングの柱を満たします。コンテナ イメージのタグは infra.engine_version(mariadb:11.4)から、 volumeClaimTemplate のリクエストとストレージクラスは infra.storage (5Gi、standard)から取得されます。開発者の Aggregate がこれらのフィールドを持つことはありません。