Hanya katalog — MariaDB + Adminer tanpa penulisan platform sama sekali
Contoh ini men-deploy stack kecil yang nyata — basis data MariaDB dengan antarmuka web Adminer di depannya — dengan merujuk hanya entitas katalog pustaka standar. Tidak ada Component, Feature, atau Recipe yang ditulis di sini: tiga berkas YAML pendek merutekan semuanya ke entitas yang sudah disediakan katalog.
Ini adalah permukaan penulisan terkecil yang ditawarkan Aggrega, dan kontak pertama yang alami dengan bahasa ini. Contoh saudara tingkat Authoring men-deploy stack yang sama sambil membangun lapisan katalognya sendiri — baca contoh ini terlebih dahulu untuk melihat apa yang Anda peroleh dari katalog yang sudah jadi, lalu contoh itu untuk mempelajari bagaimana lapisan di bawahnya dibuat.
Tiga berkas
aggregate.yaml— maksud Developer: apa stack tersebut. Dua komponen yang dipilih dari katalog melaluitype:, sebuah kredensial wajib sebagai lampiran pengisi slot, dan satu edgeusesyang menghubungkan basis data ke socketdatabasesmilik Adminer.release.yaml— pemenuhan per lingkungan oleh Operator: seberapa besar dan di mana. Blokinfra:(versi engine, ukuran penyimpanan, port yang dipublikasikan) milik Operator; Aggregate tidak pernah memuatnya.manifest.yaml— perutean oleh Operator: Recipe mana yang mewujudkan setiap tipe pada target ini. Lihat di bawah mengapa rujukannya dikualifikasi dengan provider.
Apa yang didemonstrasikan
- Components sebagai rujukan katalog.
type: core/datastore/mariadbdantype: core/devtool/admineradalah seluruh deklarasi komputasi. Developer hanya menulis nilai yang diekspos oleh skema Component — setiap field yang dihilangkan mengambil nilai bawaan skemanya (bandingkan variabel env charset dan collation pada keluaran hasil render dengan blokvalues:satu baris yang menghasilkannya). - String Pipe. Component katalog Adminer mendeklarasikan uses-socket
databasesyang menerima komponen apa pun berlabelcomponent.aggrega.ai/type=stateful-server. Edge milik Aggregate menyuntikkanprovides.hostdari Recipe basis data keADMINER_DEFAULT_SERVER. Kompiler merutekan string tersebut tanpa menafsirkannya — pada target ini nilainya adalah nama layanan compose; edge yang sama pada target Kubernetes akan membawa nama DNS Service. - Pilar lampiran.
featuresSchemamilik Component basis data mewajibkan slotroot_password, yang diisi dengan Featurecore/secret-valuedari katalog. Slot tersebut bersifat kotak hitam: FeatureRecipe yang dipilih oleh Manifest mengendalikan penyampaiannya, dan Developer tidak dapat menentukannya. - Perutean Recipe yang dikualifikasi dengan Provider. Manifest memetakan
core/datastore/mariadb:1.0.0kecompose/mariadb:1.0.0— dikualifikasi dengan provider — karena pustaka standar menyediakan Recipe mariadb di bawah lebih dari satu provider (di antaranya compose dan helm). Pemetaan oleh Operator itulah yang memperjelas target: rujukan polos tanpa kualifikasi yang cocok dengan Recipe dari lebih dari satu provider menghentikan build secara tegas alih-alih diam-diam memilih salah satunya. Arahkan stack ke target lain dengan mengarahkan ulang pemetaan ini; Aggregate tidak berubah.
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 catalog-onlyKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd catalog-onlyBuild
Dari direktori ini, dengan entitas katalog di-resolve dari hub.aggrega.ai, registry default yang disebut .aggrega-config.yaml:
aggrega pull --release release.yamlaggrega build --release release.yamlPull menyelesaikan setiap entitas yang dirujuk dan menyematkannya di release.lock (identitas + digest konten; jalankan pull lagi untuk membuat ulang lockfile yang kedaluwarsa). Dengan checkout katalog pustaka standar (cara mendapatkannya), sebutkan direktori aggrega-catalog miliknya dengan --catalog pada kedua perintah untuk membaca entitas dari sana. Build membaca lockfile itu — tanpanya, build berhenti dan menyebutkan dua jalan ke depan, pull atau --auto-pull — lalu merender dist/compose/docker-compose.yaml. Release menulis komponennya secara langsung (tanpa blok boundaries:), sehingga kompiler menggabungkannya ke dalam cakupan bawaan yang disintesis dan menghasilkan keluaran datar di bawah dist/ — satu boundary, tanpa segmen nama boundary di path.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya tool Aggrega, dan jangan membuat folder apa pun sendiri. Jika folder workspace belum berisi folder `catalog-only`, panggil tool `scaffold` sekali dengan `example` diatur ke `catalog-only` dan tanpa `dir`: tool itu menulis contoh ke folder baru `catalog-only`. Lalu panggil tool `build` dengan `workspace_root` diatur ke `catalog-only`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana saja yang ditulis build; file-file itu berada di bawah `catalog-only/dist/`.Membaca output
Berkas compose hasil render adalah tempat pengkabelan menjadi terlihat:
- layanan
webmembawaADMINER_DEFAULT_SERVER: db—provides.hostdari Recipe basis data (nama layanan compose) yang disampaikan melalui edge uses; - edge yang sama menghasilkan
depends_on: [db]— topologi, bukan sekadar string; MARIADB_CHARACTER_SET_SERVERdanMARIADB_COLLATION_SERVERmilik layanandbberasal dari nilai bawaan skema yang tidak pernah disebutkan oleh Aggregate;image: mariadb:11.4dan pengikatan port8080:8080berasal dari blokinfra:milik Release — pilar Operator, dirender berdampingan dengan pilar Developer.
Menjalankan
cd dist/composedocker compose up -dBuka http://localhost:8080: field server sudah terisi dengan db.
Masuk sebagai root dengan kata sandi pengembangan dari lampiran
Aggregate (dev-root-pw-change-me — placeholder yang harus diganti untuk
penggunaan apa pun di luar pengembangan lokal), basis data appdb.
Langkah selanjutnya
Tingkat Authoring membangun sendiri lapisan platform yang sama ini — Components, Recipes, dan FeatureRecipes kredensial yang dipakai contoh ini dalam bentuk siap pakai — dan mengompilasi satu Aggregate ke empat target.