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:
aggrega scaffold --example mariadb-helm-synthKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd mariadb-helm-synthBuild
aggrega build --release release.yaml --auto-pullKatalog 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-meSlot 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.
[… 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 keyMembiarkan 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.