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

MariaDB di Kubernetes — helm tersintesis (StatefulSet), kredensial dua slot

Satu basis data MariaDB yang dirender di Kubernetes oleh sintesis Workload dari provider helm — tanpa chart eksternal. Component core/datastore/mariadb terikat ke Recipe helm/mariadb, yang mendeklarasikan Workload form: stateful; provider helm menerjemahkannya menjadi sebuah StatefulSet, sebuah ClusterIP Service, sebuah Headless Service (identitas jaringan stabil milik StatefulSet), dan sebuah volumeClaimTemplate untuk direktori data.

Tujuan contoh ini adalah model kredensial dua slot MariaDB pada target helm tersintesis. Kedua slot kata sandi dikirimkan melalui mekanisme yang berbeda karena Component mendeklarasikannya secara berbeda, dan Recipe menghubungkan masing-masing sesuai tuntutan slotnya.

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 mariadb-helm-synth

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

Terminal window
cd mariadb-helm-synth

Build

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

Katalog di-resolve dari registry hub yang disebutkan dalam .aggrega-config.yaml, sehingga flag --catalog tidak diperlukan, dan --auto-pull menulis lockfile yang tidak dimiliki oleh clone baru selama build. Empat 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 `mariadb-helm-synth`, panggil alat `scaffold` sekali dengan `example` diatur ke `mariadb-helm-synth` dan tanpa `dir`: alat ini menulis contoh ke folder `mariadb-helm-synth` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `mariadb-helm-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 `mariadb-helm-synth/dist/`.

root_password — Black-Box, dikirimkan melalui pipa inject

root_password adalah slot Black-Box: featuresSchema milik Component mendeklarasikan inject: [], sehingga Recipe mengendalikan pengiriman dan pengembang tidak dapat menentukannya. Aggregate melampirkan core/secret-value, yang dipetakan oleh Manifest ke env-secret. FeatureRecipe tersebut menempatkan nilai pada pipa inject milik komponen di bawah kunci yang dipilih, dan Recipe membacanya sebagai .context.inject.env.MARIADB_ROOT_PASSWORD, sehingga menghasilkan variabel env kontainer biasa:

# db-statefulset.yaml (container env)
- name: MARIADB_ROOT_PASSWORD
value: dev-root-pw-change-me

Slot Black-Box tidak pernah dirujuk dari blok attachments: milik kontainer workload, dan tidak ada resource Secret Kubernetes yang dibuat untuknya — nilai mencapai kontainer langsung melalui pipa inject.

user_password — transparan, dikirimkan sebagai Secret + secretKeyRef

user_password adalah slot transparan (inject: [env, file]). Aggregate melampirkan core/referenced-secret, yang dipetakan oleh Manifest ke k8s-secret-from-parameter. FeatureRecipe tersebut mewujudkan sebuah Secret Kubernetes dan menerbitkan identitas Secret tersebut sebagai provides {name, key}. Recipe merujuk slot melalui containers.attachments, yang dirender oleh synthesizer sebagai secretKeyRef env. Secret yang dihasilkan dan rujukan kontainer menamai resource yang sama karena keduanya membaca .features.user_password.provides.name — tidak ada penurunan ulang dan tidak ada konvensi yang harus disepakati kedua sisi. Nama yang diterbitkan menormalkan garis bawah dalam nama slot menjadi tanda hubung, sehingga user_password menjadi nama resource Kubernetes yang valid db-user-password. Nama file yang memuatnya merupakan penurunan terpisah dan terbaca berbeda: nama file tersebut diawali dengan nama komponen dan nama slot sebagai koordinat attachment itu sendiri, dikodekan untuk alfabet nama file yang hanya menerima huruf kecil dan angka, sehingga garis bawah muncul di sana sebagai escape, bukan sebagai tanda hubung.

db--user-zupassword--db-secret-db-user-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-user-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)
- name: MARIADB_PASSWORD
valueFrom:
secretKeyRef:
name: db-user-password # == the Secret's metadata.name
key: MARIADB_PASSWORD # == the Secret's data key

Membiarkan user_password tidak dilampirkan juga valid: Recipe kembali ke nilai default pengembangan inline (MARIADB_PASSWORD: apppass) dan tidak ada Secret yang dibuat, sehingga deployment minimal tetap dapat dirender dan dijalankan.

Penentuan ukuran oleh operator

release.yaml memenuhi pilar penentuan ukuran oleh operator per lingkungan: tag image kontainer berasal dari infra.engine_version (mariadb:11.4), dan request serta storage class milik volumeClaimTemplate berasal dari infra.storage (5Gi, standard). Aggregate milik pengembang tidak pernah memuat field-field ini.