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

アタッチメントが公開するものに Workload をバインドする

helm プロバイダーの Workload 合成によって Kubernetes 上にレンダリングされる、単一のステートレスなアプリです。外部チャートは使いません。このアプリは、Component がスロットを宣言し、Release が埋める クラウドアイデンティティのもとで実行されます。スロットを埋める アタッチメントは Kubernetes ServiceAccount を 1 つ出力してその名前を公開し、 アプリの Recipe は Pod をその公開された名前にバインドします。

ここで学ぶべき点は、流れの方向です。生産者が名前を 一度だけ記述し、消費者がそれを読み取ります。消費側では、生産者がすでに所有する値を 再記述しないため、両者がずれることはありません。

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example workload-identity-binding

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

Terminal window
cd workload-identity-binding

ビルド

Terminal window
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 スロットとしてそれを宣言します。

catalog/component/local/compute/identity-app/1.0.0/component.yaml
featuresSchema:
identity:
required: true
selector: "feature.aggrega.ai/kind!=secret"
inject: []

Aggregate はこれについて何も記述しません。アプリがどのクラウドの どのアイデンティティで実行されるかはターゲットごとにオペレーターが選択するため、Release はアイデンティティ Feature と、その Feature が必要とするすべてのフィールドで スロットを埋めます。

release.yaml
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-identity
locals:
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 workload
serviceAccount: "{{ .features.identity.provides.name }}"
containers:
main:
variables:
IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}

どちらの読み取りも、アタッチメントが実際に出力した ServiceAccount に解決されます。

app--identity--app-serviceaccount-app-workload-identity.yaml
[… omitted: the apiVersion]
kind: ServiceAccount
metadata:
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]
app-deployment.yaml
[… 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 はどちらも保持しません。