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

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

BerkasPeran
aggregate-helm-synth.yamlMaksud developer untuk varian dasar Kubernetes: satu komponen db bertipe core/datastore/mysql, nilai-nilainya, dan hanya kredensial wajib root_password.
aggregate-helm-synth-auth.yamlMaksud developer untuk varian lengkap Kubernetes: slot kredensial root_password dan user_password.
manifest-helm-synth.yamlMemetakan tipe MySQL ke Recipe helm hasil sintesis (helm/mysql) dan setiap kredensial ke FeatureRecipe-nya (env-secret, k8s-secret-from-parameter).
release-helm-synth.yamlCatatan operator untuk varian dasar Kubernetes, dengan penentuan ukuran operasional (engine_version, storage).
release-helm-synth-auth.yamlCatatan operator untuk varian lengkap Kubernetes.
aggregate.yamlMaksud developer untuk target Compose lokal: komponen db yang sama dengan kedua slot kredensial dikirimkan sebagai kredensial inject-value.
manifest-compose.yamlMemetakan tipe MySQL ke Recipe Compose (mysql) dan kredensial ke dotenv-secret.
release-compose.yamlCatatan 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/mysql mendeklarasikan Workload yang agnostik terhadap kapabilitas dengan form: stateful; provider helm menyintesis sebuah StatefulSet, sebuah ClusterIP Service, sebuah Headless Service (identitas jaringan stabil StatefulSet), dan sebuah volumeClaimTemplate untuk direktori data. Lingkungan kontainer membawa MYSQL_DATABASE, MYSQL_USER, MYSQL_ROOT_PASSWORD, dan MYSQL_PASSWORD. Set karakter dan collation diterapkan sebagai argumen baris perintah server mysqld (--character-set-server, --collation-server), karena image resmi mysql menerimanya sebagai flag server, bukan variabel lingkungan.
  • Sintesis Workload di Compose. Recipe Compose mendeklarasikan Workload yang agnostik terhadap kapabilitas; provider compose menyintesis layanan docker-compose.yaml dengan 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 berlabel feature.aggrega.ai/kind: secret, yang dipisahkan dari values aplikasi. featuresSchema milik Component mendeklarasikan slot Black-Box root_password dan slot transparan user_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:

Terminal window
aggrega scaffold --example mysql-standalone

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

Terminal window
cd mysql-standalone

Build

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:

Terminal window
# 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-pull

Artefak 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.