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

MariaDB(Bitnami チャート)— 複数キーを持つ 1 つの認証情報 Secret

Bitnami Helm チャートで実現される単一の MariaDB データベースで、 そのパスワードは複数キーを持つ 1 つの参照可能なシークレット (core/referenced-secret-set)によって供給されます。

Bitnami チャートは auth.existingSecret で指定された単一の Kubernetes Secret から認証を行い、 その Secret が固定のデータキーを持つことを想定しています。 mariadb-root-password と、カスタムユーザーが設定されている場合は mariadb-password です (レプリケーション構成では mariadb-replication-password が加わります)。これらのキーの名前を 変更する設定項目はなく、チャートによって固定されています。

データベースの Recipe に Secret の名前を推測させる代わりに、開発者はまさにそれらの固定キーを持つ 複数キーの認証情報をアタッチし、Recipe は生成された Secret の名前を .features.root_password.provides.name から読み取ります。 参照名と生成された Secret の metadata.name は 1 つの値です。 再導出はなく、両側が一致させるべき慣例もありません。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

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

Terminal window
aggrega scaffold --example mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

ビルド

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

--auto-pull は、新しいクローンにはない lockfile をビルド中に書き出します。

mariadb-bitnami Recipe はこの例自身のローカルな catalog/ コピー(企業が作成したローカルソースの Recipe)から解決され、core/datastore/mariadb Component と認証情報の feature は .aggrega-config.yaml が指定するデフォルトレジストリ hub.aggrega.ai から解決されます。ローカルの catalog/ はそのファイルの catalog_dirs に列挙されています。Bitnami チャートは OCI ソースから取得されます。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `mariadb-bitnami-credential-set` フォルダーがない場合は、`example` を `mariadb-bitnami-credential-set` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `mariadb-bitnami-credential-set` フォルダーに書き込まれます。次に、`workspace_root` を `mariadb-bitnami-credential-set`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `mariadb-bitnami-credential-set/dist/` の下にあります。

認証情報が生成するもの

db component は、必須の root_password スロットに core/referenced-secret-set をアタッチし、 チャートの固定キー名をデータとして供給します。 Manifest はその認証情報を k8s-secret-set にマッピングし、これが 1 つの Kubernetes Secret を実体化して、その名前を provides.name として公開します。

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

チャートが参照するもの

mariadb-bitnami Recipe は auth.existingSecret をスロットの 公開された名前から設定するため、レンダリングされた StatefulSet は 認証情報が生成したものと同じ Secret をマウントします。両側とも .features.root_password.provides.name を読み取ります。

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

auth.existingSecret が設定されているため、チャートは独自の Secret を 生成しません。ビルド内の唯一の Secret は認証情報が生成したものです。

単一キーの姉妹版

core/referenced-secret(credential-secretkeyref の例を参照)は 同じファミリーの単一キー版です。呼び出し側が名前を付けた 1 つのデータキーをラップし、 リソース名とそのキーの両方を公開するもので、secretKeyRef で 1 つのキーを参照する利用側向けです。 利用側のターゲットが、全体として名前を指定する 1 つの Secret から固定のキー集合を読み取る場合は、 Bitnami チャートのように、代わりに core/referenced-secret-set を使用します。