アタッチメントが公開するものに Workload をバインドする
helm プロバイダーの Workload 合成によって Kubernetes 上にレンダリングされる、単一のステートレスなアプリです。外部チャートは使いません。このアプリは、Component がスロットを宣言し、Release が埋める クラウドアイデンティティのもとで実行されます。スロットを埋める アタッチメントは Kubernetes ServiceAccount を 1 つ出力してその名前を公開し、 アプリの Recipe は Pod をその公開された名前にバインドします。
ここで学ぶべき点は、流れの方向です。生産者が名前を 一度だけ記述し、消費者がそれを読み取ります。消費側では、生産者がすでに所有する値を 再記述しないため、両者がずれることはありません。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example workload-identity-bindingその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd workload-identity-bindingビルド
aggrega build --release release.yaml --auto-pullカタログは .aggrega-config.yaml で指定された 2 つのソースから解決されます。この例自身の ./catalog(local/compute/identity-app Component とその helm/identity-app 合成 Recipe)と、hub レジストリ(core/gcp-workload-identity Feature とその FeatureRecipe)です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き出します。3 つのマニフェストが dist/helm/helm/ 以下に出力されます。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `workload-identity-binding` フォルダーがない場合は、`example` を `workload-identity-binding` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `workload-identity-binding` フォルダーに例が書き込まれます。次に、`workspace_root` を `workload-identity-binding`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `workload-identity-binding/dist/` の下にあります。Component が必要性を宣言し、Release がそれを埋める
アプリは実行に使うアイデンティティを必要とするため、その Component は
必須の identity スロットとしてそれを宣言します。
featuresSchema: identity: required: true selector: "feature.aggrega.ai/kind!=secret" inject: []Aggregate はこれについて何も記述しません。アプリがどのクラウドの どのアイデンティティで実行されるかはターゲットごとにオペレーターが選択するため、Release はアイデンティティ Feature と、その Feature が必要とするすべてのフィールドで スロットを埋めます。
features: identity: type: core/gcp-workload-identity infra: service_account_name: app-workload-identity gcp_service_account: app-dev@example-project.iam.gserviceaccount.comスロットを埋めない Release は、そのスロットを示して停止します。EKS
クラスター向けの Release は、代わりに core/aws-irsa とその role_arn で同じスロットを埋め、
その Manifest がその Feature を対応する FeatureRecipe にマッピングします。セレクターは
認証情報がスロットに入ることを防ぎます。secret 種別の Feature でスロットを埋めると停止します。
アタッチメントが公開する
Feature は schema.provides で name を公開することを宣言し、その
FeatureRecipe がそれを公開します。値は、出力されるチャートが
ServiceAccount の命名に使うものと同じローカル値から取られ、
Release が記述している場合はオペレーターが設定した service_account_name になります。
# FeatureRecipe gcp-workload-identitylocals: sa_name: '{{ default (printf "%s-%s" .context.rendered_name (.attachment_name | replace "_" "-")) .infra.service_account_name }}'provides: name: "{{ .locals.sa_name }}"Recipe が消費する
消費側の Recipe は、公開された名前を
.features.<instance-name>.provides.<key> で読み取ります。
# helm/identity-app recipe workloadserviceAccount: "{{ .features.identity.provides.name }}"containers: main: variables: IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}どちらの読み取りも、アタッチメントが実際に出力した ServiceAccount に解決されます。
[… omitted: the apiVersion]kind: ServiceAccountmetadata: name: app-workload-identity annotations: iam.gke.io/gcp-service-account: "app-dev@example-project.iam.gserviceaccount.com" [… omitted: the boundary and recipe annotations, and the labels, that every rendered document carries][… omitted: the Deployment's metadata, selector and pod template up to the containers] containers: - name: main [… omitted: the image and the port] env: [… omitted: the GREETING variable] - name: IDENTITY_SERVICE_ACCOUNT value: app-workload-identity serviceAccountName: app-workload-identity繰り返さずに読み取る理由
別の方法は、消費側で app-workload-identity をもう一度記述することです。
これは、誰かがオペレーターの
service_account_name を変更して 2 か所のうち片方だけを更新するまでは機能します。その時点で
Pod は存在しない ServiceAccount を要求し、どちらの記述も有効な文字列であるため、
コンパイルでは何も検出されません。
.features.identity.provides.name を読み取ることで、2 つ目の記述がなくなります。同じ
形はすべてのアタッチメントに当てはまります。認証情報はその Secret のロケーターを
.features.<slot>.provides.name で公開し、サイドカーはそのポートを、アイデンティティは
その名前を公開します。フィールドごとのアタッチメントの完全な形は
templates/template-context-contract.md にあります。
オペレーターによるサイジング
release.yaml は環境ごとにオペレーターによるサイジングの柱を満たします。コンテナ
イメージのタグは infra.image_tag(myapp:1.2)から取られ、アイデンティティ、つまりその
Feature とその Feature のフィールドは、スロットの充填から取られます。開発者の
Aggregate はどちらも保持しません。