合成された helm Deployment におけるマルチキー認証情報
helm provider の Workload 合成によって Kubernetes 上にレンダリングされる、単一のステートレスなアプリです。外部チャートは使用しません。このアプリは 1 つのシークレットから 2 つのデータキーを読み取ります。 ユーザー名とパスワードです。1 つの認証情報スロットが両方を支え、そのスロットは マルチキーの参照可能な認証情報によって埋められます。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example multikey-secret-synthその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd multikey-secret-synthビルド
aggrega build --release release.yaml --auto-pullカタログは .aggrega-config.yaml で指定された 2 つのソースから解決されます。サンプル自身の ./catalog(local/compute/app Component とその helm/app 合成 Recipe)と、hub レジストリ(マルチキー認証情報の Feature、その FeatureRecipe、および helm Provider)です。--auto-pull は、新しいクローンにはない lockfile をビルド中に書き出します。3 つのマニフェストが dist/helm/helm/ に出力されます。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `multikey-secret-synth` フォルダーがない場合は、`example` を `multikey-secret-synth` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `multikey-secret-synth` フォルダーに書き込まれます。次に、`workspace_root` を `multikey-secret-synth`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `multikey-secret-synth/dist/` の下にあります。1 つのスロット、2 つのキー
Component は、透過的な認証情報スロット app_credentials
(inject: [env])を 1 つ宣言します。Aggregate はこれを core/referenced-secret-set で埋めます。
これはマルチキーの参照可能な認証情報で、呼び出し側が指定したデータキーのセットを持つ Kubernetes
Secret を 1 つ生成し、その
Secret のロケーター(provides.name)のみを公開します。ここでは呼び出し側が 2 つのキーを指定します。
features: app_credentials: type: core/referenced-secret-set values: entries: - key: db_username value: appuser - key: db_password value: dev-pw-change-meManifest は core/referenced-secret-set を k8s-secret-set
FeatureRecipe にマッピングし、この FeatureRecipe が両方のキーを持つ 1 つの Secret をレンダリングします。
[… omitted: the apiVersion and the Secret kind]metadata: name: app-app-credentials [… omitted: the labels and annotations every rendered document carries]stringData: db_username: "appuser" db_password: "dev-pw-change-me"各キーによる 1 つのスロットの参照
合成 Recipe は同じスロットを 2 回、データキーごとに 1 回ずつ参照します。各
エントリは key フィールドで読み取るデータキーを指定し、エントリのマップキーが
環境変数名になります。
# helm/app recipe workloadattachments: APP_DB_USER: from: app_credentials as: env key: db_username APP_DB_PASSWORD: from: app_credentials as: env key: db_passwordシンセサイザーはエントリごとに env の secretKeyRef を 1 つレンダリングします。両方とも
同じ Secret(provides.name)を参照し、それぞれが独自のデータキーを持ちます。
# app-deployment.yaml (container env)- name: APP_DB_USER valueFrom: secretKeyRef: name: app-app-credentials # == the Secret's metadata.name key: db_username- name: APP_DB_PASSWORD valueFrom: secretKeyRef: name: app-app-credentials # same Secret key: db_password # different data key[… omitted: the GREETING variable, set from the Aggregate's greeting value]key フィールドによって、マルチキーのシークレットを合成された
Workload から利用できるようになります。エントリが key を省略した場合は、代わりにスロットが公開する単一のデータ
キーを読み取ります。これはロケーターとキーの両方を公開する単一キーの認証情報(core/referenced-secret)
が使用する形です。
オペレーターによるサイジング
release.yaml は環境ごとにオペレーターによるサイジングの柱を満たします。
コンテナイメージのタグは infra.image_tag(myapp:1.2)から取得されます。開発者の
Aggregate がこのフィールドを持つことはありません。