MySQL — satu Aggregate, dua target
Contoh ringkas ini mengompilasi satu basis data MySQL dari Aggregate yang ditulis oleh Developer ke dua target:
- Kubernetes melalui sintesis Workload dari provider helm (sebuah StatefulSet
yang dirender langsung pada image resmi
mysql, tanpa chart eksternal), dan - Docker Compose untuk pengembangan lokal.
Maksud developer yang sama menggerakkan setiap target. Hanya lapisan Recipe yang dipilih oleh Manifest yang berubah per target.
Berkas
| Berkas | Peran |
|---|---|
aggregate-helm-synth.yaml | Maksud developer untuk varian dasar Kubernetes: satu komponen db bertipe core/datastore/mysql, nilai-nilainya, dan hanya kredensial wajib root_password. |
aggregate-helm-synth-auth.yaml | Maksud developer untuk varian lengkap Kubernetes: slot kredensial root_password dan user_password. |
manifest-helm-synth.yaml | Memetakan tipe MySQL ke Recipe helm hasil sintesis (helm/mysql) dan setiap kredensial ke FeatureRecipe-nya (env-secret, k8s-secret-from-parameter). |
release-helm-synth.yaml | Catatan operator untuk varian dasar Kubernetes, dengan penentuan ukuran operasional (engine_version, storage). |
release-helm-synth-auth.yaml | Catatan operator untuk varian lengkap Kubernetes. |
aggregate.yaml | Maksud developer untuk target Compose lokal: komponen db yang sama dengan kedua slot kredensial dikirimkan sebagai kredensial inject-value. |
manifest-compose.yaml | Memetakan tipe MySQL ke Recipe Compose (mysql) dan kredensial ke dotenv-secret. |
release-compose.yaml | Catatan operator untuk target Compose lokal, termasuk entri infra.overrides khusus provider yang menetapkan image kontainer secara persis. |
Apa yang didemonstrasikan
- Satu permukaan penulisan, banyak target. Sebuah Aggregate adalah sumber kebenaran tentang apa stack tersebut. Setiap Manifest menyatakan bagaimana mewujudkannya.
- Sintesis Workload di Kubernetes (disarankan). Recipe
helm/mysqlmendeklarasikanWorkloadyang agnostik terhadap kapabilitas denganform: stateful; provider helm menyintesis sebuah StatefulSet, sebuah ClusterIP Service, sebuah Headless Service (identitas jaringan stabil StatefulSet), dan sebuah volumeClaimTemplate untuk direktori data. Lingkungan kontainer membawaMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORD, danMYSQL_PASSWORD. Set karakter dan collation diterapkan sebagai argumen baris perintah servermysqld(--character-set-server,--collation-server), karena image resmimysqlmenerimanya sebagai flag server, bukan variabel lingkungan. - Sintesis Workload di Compose. Recipe Compose mendeklarasikan
Workloadyang agnostik terhadap kapabilitas; provider compose menyintesis layanandocker-compose.yamldengan image MySQL, lingkungannya, volume data bernama, dan health check. - Jalan keluar bagi operator. Release Compose menetapkan
infra.overrides.image, pilar terbuka untuk fakta khusus penyedia yang tidak disebutkan oleh skema Component itu sendiri, dan layanan yang dirender menjalankan referensi image yang persis itu. Lihat Override khusus Provider. - Model kredensial dua slot. Kata sandi adalah lampiran pada pilar
features:komponen, masing-masing berupa Feature berlabelfeature.aggrega.ai/kind: secret, yang dipisahkan darivaluesaplikasi.featuresSchemamilik Component mendeklarasikan slot Black-Boxroot_passworddan slot transparanuser_password.
Pengiriman kredensial di Kubernetes
root_password adalah slot Black-Box (inject: []): Recipe mengendalikan
pengiriman. Kredensial inject-value yang dilampirkan menaruh nilai pada pipa inject
komponen, dan Recipe membacanya sebagai
.context.inject.env.MYSQL_ROOT_PASSWORD, menghasilkan variabel env kontainer biasa. Tidak ada
Secret Kubernetes yang dibuat untuknya.
user_password adalah slot transparan (inject: [env, file]). Varian lengkap
melampirkan kredensial yang dapat direferensikan, yang mewujudkan sebuah Secret Kubernetes
dan memublikasikan identitasnya; Recipe mereferensikan slot tersebut melalui
containers.attachments, yang dirender oleh synthesizer sebagai env secretKeyRef. Secret
yang dihasilkan dan referensi kontainer menamai resource yang sama karena
keduanya membaca .features.user_password.provides.name. Membiarkan user_password
tidak dilampirkan (varian dasar) juga valid: Recipe kembali ke nilai default
pengembangan inline (MYSQL_PASSWORD: apppass) dan tidak ada Secret yang dibuat, sehingga
deployment minimal tetap dapat dirender dan dijalankan.
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 mysql-standaloneKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd mysql-standaloneBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/.
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 `mysql-standalone`, panggil alat `scaffold` sekali dengan `example` diatur ke `mysql-standalone` dan tanpa `dir`: alat ini menulis contoh ke folder `mysql-standalone` yang baru. Kemudian panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml`, dan `release-compose.yaml` — setiap kali dengan `workspace_root` diatur ke `mysql-standalone`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh setiap build; file tersebut berada di bawah `mysql-standalone/dist/`.Penentuan ukuran oleh operator
Releases Kubernetes memenuhi pilar penentuan ukuran operator per lingkungan: tag
image kontainer berasal dari infra.engine_version (mysql:8.4), dan
request serta storage class volumeClaimTemplate berasal dari infra.storage.
Aggregate milik developer tidak pernah membawa field ini.
Override khusus Provider
Pilar penentuan ukuran adalah field bernama: Component mendeklarasikan engine_version dan
storage, sehingga operator yang menetapkan salah satunya mengisi field yang telah
diantisipasi oleh Component. infra.overrides adalah pilar untuk hal yang tidak dapat
diantisipasi oleh Component — pilar ini dideklarasikan sebagai objek yang menerima struktur bersarang apa pun, dan
setiap Recipe mendokumentasikan kunci mana yang dibacanya.
release-compose.yaml menggunakannya. Recipe Compose membaca satu kunci, image, dan
ketika kunci itu ditetapkan, kontainer menjalankan referensi persis tersebut alih-alih referensi yang
disusun Recipe dari engine_version:
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"Layanan yang dirender membawa override tersebut apa adanya:
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]Inilah jalur menuju build dari versi server yang sama yang di-mirror ke registry atau dipatok dengan digest — fakta deployment yang menjadi milik lingkungan target, bukan
kontrak Component. Karena set kunci ditentukan per Recipe, bukan
per Component, Recipe adalah tempat untuk mencari kunci mana yang berlaku: Recipe
Compose di sini membaca image, dan Recipe yang tidak membaca kunci apa pun menyatakannya.