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

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 melalui type:, sebuah kredensial wajib sebagai lampiran pengisi slot, dan satu edge uses yang menghubungkan basis data ke socket databases milik Adminer.
  • release.yaml — pemenuhan per lingkungan oleh Operator: seberapa besar dan di mana. Blok infra: (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/mariadb dan type: core/devtool/adminer adalah 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 blok values: satu baris yang menghasilkannya).
  • String Pipe. Component katalog Adminer mendeklarasikan uses-socket databases yang menerima komponen apa pun berlabel component.aggrega.ai/type=stateful-server. Edge milik Aggregate menyuntikkan provides.host dari Recipe basis data ke ADMINER_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. featuresSchema milik Component basis data mewajibkan slot root_password, yang diisi dengan Feature core/secret-value dari 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.0 ke compose/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:

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

Build

Dari direktori ini, dengan entitas katalog di-resolve dari hub.aggrega.ai, registry default yang disebut .aggrega-config.yaml:

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

Pull 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 web membawa ADMINER_DEFAULT_SERVER: db — provides.host dari 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_SERVER dan MARIADB_COLLATION_SERVER milik layanan db berasal dari nilai bawaan skema yang tidak pernah disebutkan oleh Aggregate;
  • image: mariadb:11.4 dan pengikatan port 8080:8080 berasal dari blok infra: milik Release — pilar Operator, dirender berdampingan dengan pilar Developer.

Menjalankan

Terminal window
cd dist/compose
docker compose up -d

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