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

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 entri WorkloadLibrary yang 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/StatelessService

Tulis 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:

Terminal window
aggrega scaffold --example workload-library-import

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

Terminal window
cd workload-library-import

Build

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

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