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

Taksonomi entitas

Arsitektur Aggrega disusun ke dalam empat domain, masing-masing dimiliki oleh persona yang berbeda dan menampung jenis entitas tertentu, ditambah lapisan pustaka Tingkat 3 — tingkat ketiga dari model tingkat entitas di referensi bahasa — yang menyimpan konten skema, pemetaan, workload, dan artefak yang dapat digunakan ulang. Ikhtisar di bawah menunjukkan bagaimana keempat domain dan pustaka Tingkat 3 saling berhubungan; setiap bagian berikutnya dibuka dengan diagram entitasnya sendiri, tempat entitas dari domain lain digambar dengan garis tepi putus-putus. Permukaan penulisan terperinci (kolom, skema, contoh) untuk setiap entitas terdapat di katalog entitas referensi bahasa.

graph TD
    Intent["<b>Domain 1: Developer Intent</b><br/><i>Developer</i>"]
    Catalog["<b>Domain 2: Platform Catalog</b><br/><i>Platform Architect</i>"]
    Routing["<b>Domain 4: Routing & Policy</b><br/><i>Platform Operator / DevOps</i>"]
    Infra["<b>Domain 3: Infrastructure Base</b><br/><i>Infrastructure Engineer / Ops</i>"]
    Libs["<b>Tier 3: Libraries</b>"]

    Intent -->|"requests, attaches"| Catalog
    Intent -->|"binds via"| Routing
    Routing -->|"attaches"| Catalog
    Catalog -->|"resolved to"| Infra
    Routing -->|"resolves, renders via"| Infra
    Catalog -.->|"$ref"| Libs
    Infra -.->|"$import"| Libs

Korpus ini mencakup empat domain ditambah lapisan pustaka Tingkat 3:

#EntitasDomainPeran
1AggregateDomain 1 — Niat pengembangCetak biru topologi aplikasi
2ComponentDomain 2 — Platform CatalogAntarmuka node komputasi abstrak
3FeatureDomain 2 — Platform CatalogSifat operasional (termasuk Features kredensial)
4RecipeDomain 3 — Basis infrastrukturImplementasi Component, per penyedia
5FeatureRecipeDomain 3 — Basis infrastrukturImplementasi Feature, per penyedia
6PluginDomain 3 — Basis infrastrukturPlugin WebAssembly beralamat konten (rendering penyedia, langkah pipeline, linting)
7ManifestDomain 4 — Perutean & kebijakanLockfile dependensi yang memetakan antarmuka ke Recipes
8ReleaseDomain 4 — Perutean & kebijakanRouter deployment yang mengikat Aggregate ke Manifest
9SchemaLibraryTingkat 3 — PustakaDefinisi JSON Schema 2020-12 yang dapat digunakan ulang
10MappingLibraryTingkat 3 — PustakaFragmen template Go yang dapat digunakan ulang
11WorkloadLibraryTingkat 3 — PustakaFragmen template Workload yang dapat digunakan ulang
12ArtifactLibraryTingkat 3 — PustakaBundel artefak bernama yang dapat digunakan ulang

Tabel tersebut adalah seluruh himpunan jenis entitas penulisan, yaitu jenis yang dideklarasikan penulis dalam kolom kind:. Jenis Workload adalah konten milik platform yang disematkan di dalam input hasil sintesis sebuah Recipe, bukan entitas katalog yang berdiri sendiri (lihat bab 16), sehingga sengaja tidak dicantumkan dalam tabel di atas.

Plugin adalah entitas authoring kelas satu — dengan kind, JSON Schema, dan direktori katalognya sendiri — yang dimiliki oleh Platform Ops di Domain 3. Sebuah Plugin adalah referensi beralamat konten ke sebuah artefak WebAssembly, yang mendeklarasikan satu jenis soket yang diimplementasikannya. Taksonomi ini memiliki tujuh anggota: provider (merender node IR menjadi artefak native provider), linter (memunculkan diagnostik atas konten yang ditulis), pipeline-step (sebuah langkah feature-recipe-pipeline), governance (menjalankan peran tata kelola — mentransformasi label atau anotasi, atau mengembalikan putusan terima/tolak atas graf IR atau artefak yang dirender), cli (menyumbangkan subperintah aggrega yang dipanggil operator di baris perintah), parser (mengubah teks sumber asing menjadi pohon terstruktur kanonis), dan importer (mengubah sumber infrastruktur atau definisi agen asing menjadi draf file authoring Aggrega). Plugin perenderan provider (pluginType: provider) adalah unit yang melayani perenderan provider: ia mendeklarasikan nama provider yang dirender di spec.provider.capabilities dan membawa sisa metadata soket provider-nya di blok spec.provider yang sama. Compiler mem-pin dan merutekan referensi; runtime WebAssembly mengeksekusi byte-nya; compiler tidak menafsirkan apa yang dilakukan plugin — plugin adalah sarana pengangkut kecerdasan spesifik domain yang hidup di WebAssembly. Permukaan authoring dan metadatanya didokumentasikan di language-reference/entities/plugin.md.

Domain 1: Niat pengembang (“apa”)

graph LR
    classDef ext stroke-dasharray:5 4;

    A["Aggregate<br/>The 'What'"]
    CC["Component"]:::ext
    CapC["Feature"]:::ext
    EB["Release"]:::ext

    A -.->|"Requests"| CC
    A -.->|"Attaches"| CapC
    A -->|"Binds via"| EB
  • Peran: Pengembang. Berfokus murni pada arsitektur AI, loop kognitif, dan persyaratan kelangsungan aplikasi. Mereka tidak perlu memahami CEL, OPA, atau port fisik.
  • 1. Aggregate: Cetak biru deklaratif berbasis peta dari topologi aplikasi. Berfungsi sebagai Aggregate root yang di-build oleh sebuah Release atau modul berparameter yang dapat digunakan ulang, ia mendefinisikan components logis dan melampirkan, di bawah features, Features yang perilakunya merupakan niat aplikasi, beserta values-nya; sebuah Feature yang semua inputnya bersifat operasional justru dilampirkan oleh operator di Release (lihat Domain 4). Kredensial diminta pada permukaan lampiran features yang sama, melalui Feature kredensial — tidak ada blok terpisah untuk itu. Ia mendefinisikan persyaratan kapasitas abstrak melalui parameters (kontrak bertipe yang ditulis dalam kosakata bentuk ringkas) dan state payload melalui values. Instans Component mendukung kolom description opsional untuk dokumentasi dan tampilan di Studio. Ia mendorong konvensi “Zero-Port” (mengabstraksikan port jaringan kecuali diwajibkan secara eksplisit oleh kode yang sudah ada) tanpa platform target atau namespace yang di-hardcode.

Domain 2: Platform Catalog (“antarmuka & kecerdasan”)

graph TD
    classDef ext stroke-dasharray:5 4;

    A["Aggregate"]:::ext
    EB["Release"]:::ext
    CC["Component<br/>The Compute Interface"]
    CapC["Feature<br/>The Operational Trait"]
    CD["Recipe"]:::ext
    CapD["FeatureRecipe"]:::ext

    A -.->|"Requests"| CC
    A -.->|"Attaches"| CapC
    EB -.->|"Attaches"| CapC
    CC -.->|"Resolved to"| CD
    CapC -.->|"Resolved to"| CapD
  • Peran: Platform Architect. “Pemrogram” platform. Mereka menempatkan setiap komponen pada ontologi operasional, menulis kebijakan yang dapat diprogram (mutator dan validator Wasm), serta menetapkan label duck typing semantik.
  • 2. Component: Antarmuka abstrak untuk sebuah node komputasi. Ia mendeklarasikan bentuk dasarnya melalui ontologi cloud operasional (misalnya component.aggrega.ai/type: server), dan melapiskan identitas kognitifnya melalui label duck typing (misalnya model.aggrega.ai/capability: generative). Ia mendeklarasikan slot kredensial melalui featuresSchema (wajib/opsional, blackbox/transparan) dan menggunakan schema: (JSON Schema 2020-12, biasanya ditulis dengan notasi singkat bentuk ringkas) untuk memvalidasi secara ketat blok values pengembang yang buram.
  • 3. Feature: Sifat operasional modular (misalnya penyamaran data, perutean DNS, manajemen secret). Ia menggunakan selector label appliesTo untuk terikat secara dinamis ke label semantik tertentu. Seperti Components, ia mendeklarasikan slot kredensial melalui featuresSchema untuk mewajibkan penyediaan kunci API. Yang terpenting, ia menggunakan metadata.annotations untuk menandai elemen secara eksplisit di graf IR datar, yang memberi tahu validator kebijakan Wasm dan plugin rendering hilir cara menangani payload konfigurasi Feature tersebut.
    • Features kredensial: Platform menyatukan manajemen kredensial ke dalam entitas Feature: sebuah Feature dengan label feature.aggrega.ai/kind: secret adalah fitur kredensial — ia mendefinisikan antarmuka kueri ke penyimpanan secret (misalnya AWS Secrets Manager, HashiCorp Vault). Ia dilampirkan di bawah features: seperti Feature lainnya, pada permukaan yang sama dan dalam bentuk yang sama; label tersebut adalah metadata yang dibawa katalog untuk menjelaskan apa yang dihasilkan lampiran, dan tidak ada cabang kompiler yang membacanya. Tidak ada jenis penyimpanan secret atau resep secret yang terpisah: FeatureRecipe kredensial memiliki bentuk yang sama dengan FeatureRecipe lainnya, pipeline ambil-lalu-kirim sama untuk keduanya, dan kontrak pengiriman inject (env, file, arg) digunakan bersama. Satu entitas, satu kata kunci lampiran, satu jalur eksekusi modifier di sepanjang rendering — dan kredensial dipetakan di bawah features.type di Manifest.

Ontologi sebagai label. Ontologi cloud operasional dideklarasikan di metadata.labels["component.aggrega.ai/type"], bukan sebagai kolom spec.type tingkat atas. Pilihan ini memungkinkan mesin selector label kompiler menargetkan nilai ontologi secara langsung — sebuah Feature mendeklarasikan appliesTo: "component.aggrega.ai/type in (server, worker)" untuk terlampir secara dinamis ke setiap komponen server atau worker tanpa logika Go baru di kompiler inti. Mekanisme selector yang sama berlaku untuk setiap label Aggrega, sehingga sebuah Feature, selector soket, atau pemetaan batas Release membaca kunci label milik katalog persis seperti membaca kunci ini.

component.aggrega.ai/type adalah kunci milik Aggrega, dan himpunan nilainya tertutup: skema Component yang dipublikasikan mengenumerasi primitifnya, dan dokumen yang membawa nilai lain akan ditolak saat dimuat, dengan E0215 menyebutkan label tersebut dan mencantumkan nilai yang diterimanya. Katalog yang membutuhkan klasifikasi yang tidak didefinisikan Aggrega menambahkan kunci labelnya sendiri di sampingnya — skema Component menerima kunci label tambahan apa pun dengan nilai string — sehingga sumbu baru hanya membutuhkan kunci milik Anda sendiri tanpa rilis kompiler baru, sementara kunci yang dicadangkan tetap memiliki satu makna di mana pun. Itulah yang membuat sebuah Feature yang ditulis untuk component.aggrega.ai/type in (stateful-server) berfungsi dengan Components dari penulis yang tidak pernah saling bertemu.

Domain 3: Basis infrastruktur (“implementasi”)

graph LR
    classDef ext stroke-dasharray:5 4;

    CC["Component"]:::ext
    CapC["Feature"]:::ext
    ENV["Manifest"]:::ext
    EB["Release"]:::ext
    CD["Recipe<br/>The Implementation"]
    CapD["FeatureRecipe<br/>The Binding"]
    T["Plugin<br/>The Wasm Plugin"]

    CC -.->|"Resolved to"| CD
    CapC -.->|"Resolved to"| CapD
    ENV -->|"Resolves Interfaces to"| CD
    ENV -->|"Resolves Interfaces to"| CapD
    EB -->|"Renders via"| T
  • Peran: Insinyur infrastruktur / Ops. Memiliki realitas fisik, penetapan port jaringan, dan logika templating.
  • 4. Recipe: Template terjemahan multi-penyedia (misalnya Helm atau Docker Compose). Ia menetapkan kontrak API 1:1 yang ketat dengan komponen katalog melalui kata kunci implements. Recipe memetakan .values milik pengembang ke format fisik. Ia meng-hardcode port jaringan fisik (misalnya 5432) dan membaca provides milik target melalui pipe .context.uses, sehingga memenuhi kontrak injeksi tanpa meng-hardcode nama database.
  • 5. FeatureRecipe: Secara eksplisit memetakan sebuah Feature ke implementasi infrastruktur konkret melalui kata kunci implements. Ia mewajibkan kapabilitas provider target di capability (misalnya helm, compose). Karena platform menyatukan manajemen kredensial ke dalam entitas Feature, FeatureRecipes menangani fitur operasional (penyamaran data, perutean DNS, injeksi sidecar) sekaligus fitur kredensial (pembuatan CRD vault, pemasangan volume secret). Untuk mendukung spektrum penuh ini, ia mendukung tiga blok eksekusi yang berbeda:
    1. pipeline: Array berurutan berisi plugin WebAssembly (Wasm) untuk mutasi Workload pasca-rendering (misalnya menyuntikkan sidecar Envoy melalui JSONPatch, atau memasang volume secret).
    2. source & valuesMapping, workload, artifacts: Tiga jenis input yang sama dengan yang dibawa Recipe, digunakan untuk pembuatan resource, memungkinkan Ops me-render template statis secara native (misalnya membuat CRD HTTPRoute baru atau CRD ExternalSecret) di samping komponen dasar.
    3. injectMapping (intersepsi pra-rendering): Blok template Go native yang dieksekusi sebelum Recipe dasar di-render. Blok ini menghasilkan kamus JSON yang secara native di-deep-merge oleh kompiler di atas pipe memori .context.inject milik pemanggil, sehingga memungkinkan mutasi variabel lingkungan dan string koneksi di sisi pemanggil tanpa Wasm.
    • Pola FeatureRecipe kredensial: Ketika sebuah FeatureRecipe mengimplementasikan Feature kredensial (berlabel feature.aggrega.ai/kind: secret), prinsip standar Plugin dua bagian berlaku: pipeline merangkai plugin Fetcher (yang membuat CRD khusus vault) diikuti plugin Injector (yang memasang secret ke container target). Pemisahan Fetcher/Injector memaksimalkan penggunaan ulang — beralih dari AWS Secrets Manager ke HashiCorp Vault hanya memerlukan penggantian plugin Fetcher; Injector tetap sama.
  • 6. Plugin: Plugin WebAssembly beralamat konten. Plugin rendering penyedia (pluginType: provider) adalah unit yang mengubah jenis input sebuah Recipe menjadi format file akhir berupa string: ia mendeklarasikan nama penyedia yang dilayaninya di spec.provider.capabilities (misalnya helm), menyediakan ekspor render_node yang menjadi tujuan dispatch kompiler, dan membawa sisa metadata soket penyedianya (workloadSchema, wellKnownAnnotations) di blok spec.provider yang sama. Jenis soket lain yang dapat dideklarasikan sebuah Plugin adalah pipeline-step, linter, governance, cli, parser, dan importer. Kompiler merutekan referensi yang disematkan; runtime WebAssembly mengeksekusi byte.

Domain 4: Perutean & kebijakan (“perekat”)

graph TD
    classDef ext stroke-dasharray:5 4;

    A["Aggregate"]:::ext
    EB["Release<br/>The Deployment Router"]
    ENV["Manifest<br/>The Dependency Lockfile"]
    CapC["Feature"]:::ext
    T["Plugin"]:::ext
    CD["Recipe"]:::ext
    CapD["FeatureRecipe"]:::ext

    A -->|"Binds via"| EB
    EB -.->|"Attaches"| CapC
    EB -->|"Uses"| ENV
    EB -->|"Renders via"| T
    ENV -->|"Resolves Interfaces to"| CD
    ENV -->|"Resolves Interfaces to"| CapD
  • Peran: Platform Operator / DevOps.
  • 7. Manifest: Lockfile dependensi. Ia menggunakan pemetaan URI datar: kamus components.type memetakan tipe komponen katalog ke URI Recipe, dan kamus features.type memetakan tipe Feature ke URI FeatureRecipe. Resolusi adalah pencarian URI langsung terhadap lockfile dan katalog; penentuan kapabilitas berasal dari kolom spec.capability milik setiap Recipe yang telah di-resolve pada waktu build. Setelah resolusi, setiap entitas harus memiliki pemetaan, jika tidak kompiler akan berhenti. Untuk menjaga ekosistem yang DRY, Manifests mendukung pola komposisi bergaya Kustomize melalui kata kunci extends, sehingga manifest khusus lingkungan (seperti lokal atau staging) dapat mewarisi dengan rapi dari manifest dasar global dan hanya mendeklarasikan penimpaan spesifiknya.
  • 8. Release: Router. Ia mengikat sebuah aggregate ke sebuah manifest dan memetakan komponen ke batas fisik (misalnya aws-eks-production). Untuk menjaga alur kerja yang DRY, Releases mendukung pewarisan melalui kata kunci extends, sehingga rilis khusus lingkungan dapat mewarisi dengan rapi dari rilis dasar global. Ia memenuhi kontrak aggregate abstrak dengan menyuntikkan realitas fisik secara ketat ke dalam blok parameters, dan menyuntikkan penentuan ukuran fisik (seperti CPU atau port) melalui namespace paralel infra. Untuk melindungi Aggregate sebagai satu sumber kebenaran, skema Release secara mekanis melarang blok values: — Ops tidak dapat mendeklarasikan values pada Component atau Feature mana pun dari sebuah Release. Variasi per lingkungan untuk nilai-nilai yang ditujukan bagi pengembang mengalir melalui Parameter Hoisting: pengembang mengekspos kolom bertipe parameters.* di Aggregate, template values milik Component mereferensikannya, dan Release memenuhi parameter tersebut untuk lingkungannya. Nilai yang di-render berbeda antarlingkungan, sementara Aggregate — permukaan penulisan untuk nilai mana yang ada dan bagaimana nilai itu mengalir — tetap menjadi satu sumber kebenaran. Lihat Batasan 4, “Release tidak dapat menimpa nilai pengembang”, di bawah Batasan arsitektural dan pola yang direkomendasikan untuk larangan tingkat skema yang dinyatakan secara eksplisit. Yang terpenting, untuk mencegah Releases “pengubah aggregate” yang tidak dapat dilacak, ketika sebuah Release menggunakan extends, deklarasi aggregate ditolak oleh skema Release (batasan skema tidak mengizinkan deklarasi aggregate ketika extends digunakan). Rilis turunan harus dipetakan ke niat pengembang yang persis sama dengan induknya. Namun, manifest menjadi opsional, sehingga membuka “pengikatan akhir” — memungkinkan Ops mewarisi seluruh topologi fisik tetapi menukar lockfile dependensi secara presisi.
    • Lampiran Feature: Release juga melampirkan Features, di bawah features pada sebuah batas atau pada satu komponen. Feature yang semua inputnya bersifat operasional dilampirkannya secara langsung, beserta type dan infra-nya; Feature yang dilampirkan oleh Aggregate ditentukan ukurannya, dengan menulis infra lampiran tersebut di bawah nama yang sama.

Mengapa Manifest dipisahkan dari Release. Memisahkan lockfile perangkat lunak (Manifest) dari router deployment (Release) memungkinkan bentuk yang tidak dapat dihasilkan oleh kedua entitas itu secara terpisah: DevOps men-deploy satu aplikasi ke beberapa router deployment regional — Releases berbeda yang menargetkan region cloud berbeda, semuanya mereferensikan Manifest yang sama — tanpa menduplikasi binding Recipe di seluruh lingkungan. Setiap Release regional membawa tata letak batas dan parameter khusus lingkungannya sambil menggunakan lockfile perangkat lunak yang sama yang disediakan Manifest. Penskalaan multi-region berasal dari pemisahan domain, bukan dari duplikasi Manifest.

Tingkat 3: Pustaka (penggunaan ulang katalog)

graph LR
    classDef ext stroke-dasharray:5 4;

    CC["Component"]:::ext
    CapC["Feature"]:::ext
    CD["Recipe"]:::ext
    CapD["FeatureRecipe"]:::ext
    SL["SchemaLibrary<br/>JSON Schema definitions"]
    ML["MappingLibrary<br/>Go template fragments"]
    WL["WorkloadLibrary<br/>Workload template fragments"]
    AL["ArtifactLibrary<br/>Named artifact bundles"]

    CC -.->|"$ref"| SL
    CapC -.->|"$ref"| SL
    CD -.->|"valuesMapping $import"| ML
    CapD -.->|"$import"| ML
    CD -.->|"workload $import"| WL
    CD -.->|"artifacts $import"| AL
    CapD -.->|"$import"| AL
  • Peran: Platform Architect (persona yang sama dengan Domain 2), tetapi peran ini baru berlaku ketika konten katalog tumbuh cukup besar untuk mendapat manfaat dari penggunaan ulang skema lintas Component atau penggunaan ulang template, bentuk workload, atau bundel artefak lintas Recipe. Penulis tunggal dan katalog kecil dirilis tanpa entitas Tingkat 3 sama sekali.
  • 9. SchemaLibrary: Definisi JSON Schema 2020-12 yang dapat digunakan ulang. Sebuah pustaka mendeklarasikan skema bernama di spec.schemas: dan helper berparameter opsional di spec.templates: (dengan deklarasi $params: dan referensi $instantiate: untuk penggunaan ulang parametris). Entitas katalog menggunakan entri pustaka melalui kata kunci JSON Schema standar $ref: yang menunjuk ke entri pustaka berdasarkan identitas — bentuk tanpa host <library>#/schemas/<name> (versinya berasal dari lockfile, bukan dari referensi). Penamaan PascalCase, didistribusikan melalui OCI, disematkan di lockfile. Bersifat opt-in untuk katalog yang membutuhkan penggunaan ulang skema lintas Component — bentuk umum seperti PodResources, PersistenceSpec, NodePool, MetricsServiceMonitor muncul berulang di setiap Component datastore dan setiap Component workload, dan entri SchemaLibrary mengeluarkan pengulangan itu dari penulisan per Component.
  • 10. MappingLibrary: Fragmen template Go yang dapat digunakan ulang. Sebuah pustaka mendeklarasikan template bernama di spec.mappings:. Recipes dan FeatureRecipes menggunakan entri pustaka berdasarkan identitas melalui valuesMapping: { $import: <library>#/mappings/<name> }. Satu mode penulisan (hanya template Go); tidak ada jalur penulisan Jsonnet paralel. Bersifat opt-in untuk katalog yang membutuhkan penggunaan ulang pemetaan lintas Recipe — pola umum seperti logika helper chart Bitnami atau pola template pod bersama muncul berulang di setiap Recipe datastore yang menargetkan penyedia yang sama, dan entri MappingLibrary mengeluarkan pengulangan itu dari penulisan per Recipe.
  • 11. WorkloadLibrary: Fragmen template Workload yang dapat digunakan ulang. Sebuah pustaka mendeklarasikan entri workload bernama di spec.workloads:. Sebuah Recipe menggunakan entri berdasarkan identitas melalui workload: { $import: <library>#/workloads/<entry> }, dan isi yang diimpor divalidasi terhadap skema Workload milik platform persis seperti blok workload: inline — sehingga workload yang diimpor dari pustaka di-render identik dengan padanan inline-nya. Satu mode penulisan (hanya template Go). Bersifat opt-in untuk katalog yang membutuhkan penggunaan ulang workload lintas Recipe, ketika beberapa Recipes berbagi satu bentuk deployment dan hanya nilainya yang berbeda.
  • 12. ArtifactLibrary: Bundel artefak bernama yang dapat digunakan ulang. Sebuah pustaka mendeklarasikan bundel bernama di spec.artifacts:, masing-masing mengelompokkan file output yang saling terkait — misalnya CRD, RBAC-nya, dan sebuah ConfigMap — dan diimpor sebagai satu unit. Recipes dan FeatureRecipes menggunakan bundel berdasarkan identitas melalui artifacts.<name>: { $import: <library>#/artifacts/<name> }. Satu mode penulisan (hanya template Go). Bersifat opt-in untuk katalog yang membutuhkan penggunaan ulang artefak lintas Recipe, ketika himpunan resource pendukung yang sama menyertai banyak Recipes.

Setiap pustaka dipublikasikan melalui OCI, disematkan di lockfile (bagian schema_libraries:, mapping_libraries:, workload_libraries:, dan artifact_libraries:), dan muncul di UI Hub dengan kesadaran konsumen (Components mana yang mereferensikan entri pustaka mana; Recipes mana yang menggunakan entri pustaka mana).