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:
aggrega scaffold --example workload-identity-bindingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd workload-identity-bindingBuild
aggrega build --release release.yaml --auto-pullKatalog 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:
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:
features: identity: type: core/gcp-workload-identity infra: service_account_name: app-workload-identity gcp_service_account: app-dev@example-project.iam.gserviceaccount.comRelease 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-identitylocals: 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 workloadserviceAccount: "{{ .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:
[… 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-identityMengapa 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.