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

合成された helm Deployment におけるマルチキー認証情報

helm provider の Workload 合成によって Kubernetes 上にレンダリングされる、単一のステートレスなアプリです。外部チャートは使用しません。このアプリは 1 つのシークレットから 2 つのデータキーを読み取ります。 ユーザー名とパスワードです。1 つの認証情報スロットが両方を支え、そのスロットは マルチキーの参照可能な認証情報によって埋められます。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

ビルド

Terminal window
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 つのキーを指定します。

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Manifest は core/referenced-secret-set を k8s-secret-set FeatureRecipe にマッピングし、この FeatureRecipe が両方のキーを持つ 1 つの Secret をレンダリングします。

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… 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 workload
attachments:
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 がこのフィールドを持つことはありません。