Impor pustaka Workload — badan Workload bersama melalui `$import`
Satu layanan web tanpa status yang Recipe-nya menyintesis Workload Kubernetes-nya
dari entri pustaka bersama, bukan dari badan inline. Ini adalah mode penulisan
ketiga dari spec.workload pada sebuah Recipe:
- Mode 1 (inline): Workload berupa template Go yang ditulis langsung di dalam Recipe.
- Mode 2 (impor file):
$import: ./relative/path.yaml— sebuah file lokal. - Mode 3 (impor pustaka):
$import: <Library>#/workloads/<Entry>— sebuah entriWorkloadLibraryyang dirujuk melalui identitas nama polos.
Recipe web-service di sini menggunakan Mode 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceTulis referensi sebagai satu token yang tidak terputus: tanpa spasi dan tanpa jeda baris di mana pun
di dalamnya, dari nama pustaka hingga fragmen. Referensi yang memuat spasi putih
ditolak alih-alih dipangkas, dan build berhenti — lihat
errors/fatal-halts.md “A reference to a library
entry carries whitespace (Referensi ke entri pustaka memuat spasi putih)”.
BaseWorkloads adalah sebuah WorkloadLibrary yang dipublikasikan di katalog hub
(workloadlibrary/base-workloads). Entri StatelessService-nya adalah template Go
yang dievaluasi dalam konteks render Recipe ini, sehingga .values.image (dari
Component/Aggregate) dan .infra.* (replika, port, komputasi — dari Release)
mengalir ke dalamnya persis seperti ke badan inline. Memfaktorkan Workload ke dalam
pustaka tidak mengubah apa pun tentang apa yang di-deploy: keluaran yang dirender identik byte demi byte
dengan Workload inline yang setara.
Versi pustaka disediakan oleh lockfile per Release — tidak ada host registry
yang muncul dalam referensi. Pada aggrega pull, BaseWorkloads dipatok di
bagian workload_libraries pada lockfile; pada aggrega build, pustaka yang dipatok
diselesaikan dan entrinya dirender.
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 workload-library-importKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlKatalog diselesaikan dari registry hub yang disebutkan di .aggrega-config.yaml (yang menyediakan BaseWorkloads dan provider helm) ditambah catalog/ lokal contoh ini (Component dan Recipe web-service). Manifests ditempatkan di bawah dist/app/helm/ — directory: milik batas diikuti oleh kapabilitas provider.
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 `workload-library-import`, panggil alat `scaffold` sekali dengan `example` diatur ke `workload-library-import` dan tanpa `dir`: alat ini menulis contoh ke folder `workload-library-import` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `workload-library-import`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `workload-library-import/dist/`.Memverifikasi klaim identitas byte
Ganti workload: { $import: … } milik Recipe dengan blok workload: |
yang memuat badan StatelessService apa adanya, lakukan build ulang, dan bandingkan kedua pohon dist/.
Keduanya sama persis: referensi pustaka diselesaikan menjadi teks template
yang sama, dievaluasi dalam konteks render yang sama, sehingga impor merupakan pemfaktoran
permukaan penulisan tanpa efek pada byte yang dirender.