Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Mengikat workload ke apa yang dipublikasikan oleh sebuah lampiran

Sebuah aplikasi stateless tunggal yang dirender di Kubernetes oleh sintesis Workload dari provider helm — tanpa chart eksternal. Aplikasi ini berjalan di bawah identitas cloud yang slotnya dideklarasikan oleh Component-nya dan diisi oleh Release: lampiran yang mengisi slot tersebut menghasilkan satu ServiceAccount Kubernetes dan memublikasikan namanya, lalu Recipe aplikasi mengikat pod ke nama yang dipublikasikan itu.

Inti pelajarannya adalah arah aliran. Produsen menyatakan nama satu kali; konsumen membacanya. Tidak ada apa pun di sisi konsumen yang menyatakan ulang nilai yang sudah dimiliki produsen, sehingga keduanya tidak dapat saling menyimpang.

Membuat contoh

Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

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

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd workload-identity-binding

Build

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

Katalog di-resolve dari dua sumber yang disebutkan dalam .aggrega-config.yaml: ./catalog milik contoh ini sendiri (Component local/compute/identity-app beserta Recipe sintesis helm/identity-app-nya) dan registry hub (Feature core/gcp-workload-identity beserta FeatureRecipe-nya). --auto-pull menulis lockfile yang tidak dimiliki klon baru selama build. Tiga manifest dihasilkan di bawah dist/helm/helm/.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `workload-identity-binding`, panggil alat `scaffold` sekali dengan `example` diatur ke `workload-identity-binding` dan tanpa `dir`: alat ini menulis contoh ke folder `workload-identity-binding` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `workload-identity-binding`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `workload-identity-binding/dist/`.

Component mendeklarasikan kebutuhan; Release memenuhinya

Aplikasi memerlukan identitas untuk dijalankan, sehingga Component-nya mendeklarasikan satu, sebagai slot identity yang wajib:

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

Aggregate tidak menuliskan apa pun untuknya. Identitas mana yang digunakan aplikasi, di cloud mana, adalah pilihan Operator untuk setiap target, sehingga Release mengisi slot dengan Feature identitas dan setiap field yang diperlukan Feature tersebut:

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 yang membiarkan slot tidak terisi akan berhenti, dengan menyebutkan slot tersebut. Release untuk cluster EKS mengisi slot yang sama dengan core/aws-irsa dan role_arn-nya sebagai gantinya, dan Manifest-nya memetakan Feature tersebut ke FeatureRecipe-nya. Selektor menjaga agar kredensial tidak masuk ke slot: Feature berjenis secret yang mengisinya akan berhenti.

Lampiran memublikasikan

Feature mendeklarasikan dalam schema.provides-nya bahwa ia memublikasikan name, dan FeatureRecipe-nya memublikasikannya — dari local yang sama yang digunakan chart yang dihasilkan untuk menamai ServiceAccount, yaitu service_account_name yang ditetapkan operator ketika Release menuliskannya:

# 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 mengonsumsi

Recipe yang mengonsumsi membaca nama yang dipublikasikan di .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 }}

Kedua pembacaan tersebut di-resolve ke ServiceAccount yang benar-benar dihasilkan oleh lampiran:

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

Mengapa membacanya alih-alih mengulanginya

Alternatifnya adalah menulis app-workload-identity untuk kedua kalinya di sisi konsumen. Cara itu berfungsi sampai seseorang mengubah service_account_name milik Operator dan hanya memperbarui salah satu dari dua tempat — pada saat itu pod meminta ServiceAccount yang tidak ada, dan tidak ada apa pun dalam kompilasi yang menyadarinya, karena kedua penulisan merupakan string yang valid.

Membaca .features.identity.provides.name menghilangkan penulisan kedua. Bentuk yang sama berlaku untuk setiap lampiran: kredensial memublikasikan locator Secret-nya di .features.<slot>.provides.name, sidecar memublikasikan port-nya, identitas memublikasikan namanya. Bentuk lampiran lengkap per field tersedia di templates/template-context-contract.md.

Penentuan ukuran oleh operator

release.yaml memenuhi pilar operator-sizing per lingkungan: tag image kontainer berasal dari infra.image_tag (myapp:1.2), dan identitas — Feature-nya dan field Feature tersebut — berasal dari pengisian slot. Aggregate milik Developer tidak membawa keduanya.