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

Referensi bahasa

“Apa” dan “bagaimana menggunakan” Aggrega. Sintaks, pemanggilan CLI, katalog galat, contoh lengkap.

Baca bab-bab di bawah secara berurutan untuk pemahaman awal. Subdirektori referensi dicantumkan di bawah babnya masing-masing — langsung buka saat mencari entitas, kata kunci, provider, perintah CLI, atau galat tertentu.

Sebelum membaca urutan bab, lihat Status bahasa untuk mengetahui keadaan kesiapan saat ini — permukaan bahasa mana yang tersedia saat ini, mana yang diterima tetapi belum ditindaklanjuti oleh kompiler, dan mana yang direncanakan untuk iterasi mendatang. Kompatibilitas menyatakan apa yang dijanjikan sebuah rilis untuk skema, baris perintah, alat asisten, kode kesalahan, dan kit plugin.

Model tingkat entitas

Jenis entitas authoring Aggrega disusun ke dalam tiga tingkat yang mencerminkan progresi adopsi (di bawah). Di sampingnya terdapat Workload milik platform, yang bukan jenis authoring tersendiri — Workload adalah bentuk yang diambil oleh input tersintesis sebuah Recipe, yang menyatakan bentuk komputasi melalui kosakata form: (stateless, stateful, daemon, scheduled, task, reference). Pembagian tingkat adalah mekanisme dokumentasi dan orientasi, bukan batasan runtime: setiap jenis entitas adalah warga kelas satu dalam bahasa ini; kompiler memperlakukan semuanya secara seragam; Aggrega sumber terbuka mendukung semua tingkat tanpa lisensi atau pembatasan fitur. Penanda tingkat menandakan “lanjutan; lewati jika tidak diperlukan” untuk navigasi, bukan untuk kapabilitas.

TingkatJenis entitasKapan mengadopsi
Tingkat 1 — permukaan minimum yang layakAggregate, Component, Recipe, Manifest, ReleaseHari 1 — pendiri tunggal dan tim kecil merilis perangkat lunak yang berfungsi hanya dengan Tingkat 1. Model mentalnya: “Saya punya aplikasi; saya ingin men-deploy-nya; begini caranya.”
Tingkat 2 — pemisahan peranFeature, FeatureRecipe, PluginHari 30 — tim kecil yang perannya mulai terpisah (pengembang + Ops + terkadang Security). Tingkat 2 masuk melalui Plugins yang me-render provider (Ops memilih di antara Helm, helm-chart, Compose, Terraform, dan CloudFormation), Features (Security mengelola kredensial secara terpisah dari konfigurasi aplikasi), dan FeatureRecipes (kustomisasi saat binding per provider).
Tingkat 3 — penggunaan ulang lintas ComponentSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibraryHari 365 — katalog matang tempat bentuk-bentuk umum berulang di banyak entitas. Ambangnya informal: ketika sebuah bentuk (mis. PodResources) muncul di 5+ Components dan mengoordinasikan pembaruannya menimbulkan gesekan, sebuah entri SchemaLibrary sudah layak dengan sendirinya.

Setiap progresi bersifat opsional. Pendiri tunggal tidak pernah dipaksa melihat Tingkat 3; katalog perusahaan memiliki akses penuh ke Tingkat 3 sesuai kebutuhan. Tingkat 1 lengkap untuk kasus penggunaan pendiri tunggal — seorang pengembang dapat merilis aplikasi yang berfungsi hanya dengan entitas Tingkat 1. Ini adalah properti desain yang kuat: Tingkat 1 bukan “subset yang bisa dikompilasi”; Tingkat 1 adalah “subset yang merilis perangkat lunak.”

Permukaan Tingkat 1 dengan lima entitas memiliki biaya masuk — Aggregate + Component + Recipe + Manifest + Release lebih banyak seremoni daripada “taruh file YAML, dapatkan layanan yang berjalan.” Biaya ini adalah harga dari pemisahan authoring ke dalam empat domain (Niat Pengembang / Katalog Platform / Operasi Platform / Routing) yang membuat Aggrega berbeda dari Helm mentah atau Terraform mentah. Tutorial Tingkat 1 memandu penyiapan lima entitas secara eksplisit.

Di dalam Tingkat 3, mekanisme spec.templates / $instantiate: (helper parametrik dalam SchemaLibrary) didokumentasikan sebagai subfitur yang lebih lanjut lagi. Sebagian besar pengguna Tingkat 3 tidak langsung menggunakan spec.templates; ambangnya adalah “ketika pustaka Anda memiliki 6+ skema yang berbagi struktur berparameter.”

Urutan membaca

  1. Cara menggunakan referensi ini
  2. Konvensi penamaan
  3. Ikhtisar referensi entitas
  4. Ikhtisar kosakata
  5. Ikhtisar template
  6. Ikhtisar Providers
  7. Ikhtisar CLI
  8. Ikhtisar error
  9. Ikhtisar contoh

Referensi authoring Plugin

Permukaan plugin Wasm berada di samping urutan bab, bukan di dalamnya: penulis plugin membacanya secara terpisah dari jalur authoring entitas. Halaman entitas plugin membahas permukaan authoring katalog; halaman-halaman di bawah membahas socket, payload, dan alur kerja penulis.

  • plugin-contract — socket tempat plugin terpasang, penempatannya dalam pipeline, serta bentuk input dan output setiap socket.
  • plugin-developer-guide — alur kerja penulis secara menyeluruh: describe(), klaim kapabilitas, batas runtime, siklus hidup publish/pull/build, penandatanganan, pembuatan versi.
  • policy-socket — socket tata kelola secara mendalam: empat perannya, tingkat keparahan putusan, kanal input operator, dan cara menulis policy untuk salah satu dari kedua engine yang disertakan di dalam kompiler.
  • governance-attachment-facts — fakta per lampiran yang dibaca policy tata kelola dari graf build, termasuk tiga unit penandaan sensitivitas dan alasan mengapa penandaan yang tidak ada bukanlah izin.
  • when-to-use-a-pipeline-step — memilih antara langkah pipeline dan FeatureRecipe berbasis template.
  • embedded-plugins — plugin yang disertakan di dalam biner kompiler.
  • tagging-plugins — dua plugin tata kelola bawaan yang menulis label tanpa kebijakan, governance/label-injector dan governance/selector-tagger: pengaturannya dan apa yang ditulis masing-masing.
  • core-importers — sepuluh importer milik kompiler, dari Langflow, Flowise, dan n8n hingga Compose, MCP, dan framework agen: apa yang dibaca dan didrafkan masing-masing, pengaturannya, dan publikasinya bersama setiap rilis kompiler.
  • authoring-a-provider-walkthrough — panduan langkah demi langkah menulis guest provider, dari direktori kosong hingga build yang menulis berkas-berkas yang dirender provider.
  • writing-a-governance-plugin — menulis plugin tata kelola Anda sendiri dari kerangka adaptor milik kit plugin: satu aturan, ekspor setiap peran yang dijalankan secara manual, entitas Plugin di katalog workspace, dan build yang ditolaknya.
  • compatibility — bagaimana kit plugin diberi versi: apa yang boleh diubah oleh rilis patch dan rilis minor sebuah kit, dan apa yang membuat plugin yang sudah dibangun tetap dapat dimuat.