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

Kredensial multi-kunci pada Deployment helm yang disintesis

Satu aplikasi stateless yang dirender di Kubernetes oleh sintesis Workload dari provider helm — tanpa chart eksternal. Aplikasi ini membaca dua kunci data dari satu secret: sebuah nama pengguna dan sebuah kata sandi. Satu slot kredensial mendukung keduanya, diisi oleh kredensial multi-kunci yang dapat dirujuk.

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 multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

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/app dan Recipe sintesis helm/app miliknya) serta registry hub (Feature kredensial multi-kunci, FeatureRecipe-nya, dan Provider helm). --auto-pull menulis lockfile yang tidak dimiliki oleh clone 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 `multikey-secret-synth`, panggil alat `scaffold` sekali dengan `example` diatur ke `multikey-secret-synth` dan tanpa `dir`: alat ini menulis contoh ke folder `multikey-secret-synth` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `multikey-secret-synth`, `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 `multikey-secret-synth/dist/`.

Satu slot, dua kunci

Component mendeklarasikan satu slot kredensial transparan, app_credentials (inject: [env]). Aggregate mengisinya dengan core/referenced-secret-set — kredensial multi-kunci yang dapat dirujuk, yang mewujudkan satu Secret Kubernetes berisi sekumpulan kunci data yang diberikan pemanggil dan hanya menerbitkan lokator Secret tersebut (provides.name). Di sini pemanggil memberikan dua kunci:

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 memetakan core/referenced-secret-set ke FeatureRecipe k8s-secret-set, yang merender satu Secret berisi kedua kunci tersebut:

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"

Merujuk satu slot melalui setiap kunci

Recipe sintesis merujuk slot yang sama dua kali — sekali untuk setiap kunci data. Setiap entri menyebutkan kunci data yang dibacanya melalui field key; kunci map entri tersebut adalah nama variabel lingkungan:

# 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

Synthesizer merender satu secretKeyRef env untuk setiap entri. Keduanya merujuk Secret yang sama (provides.name), masing-masing dengan kunci datanya sendiri:

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

Field key inilah yang membuat secret multi-kunci dapat dikonsumsi dari Workload yang disintesis. Jika sebuah entri menghilangkan key, entri tersebut membaca satu-satunya kunci data yang diterbitkan slot — bentuk yang digunakan kredensial kunci tunggal (core/referenced-secret), yang menerbitkan sebuah lokator sekaligus sebuah kunci.

Penentuan ukuran oleh operator

release.yaml memenuhi pilar penentuan ukuran oleh operator per lingkungan: tag image kontainer berasal dari infra.image_tag (myapp:1.2). Aggregate milik pengembang tidak pernah memuat field ini.