Penggantian recipe per instans
Contoh ini mengajarkan satu fitur Manifest: tingkat pemetaan name, yang
mengganti Recipe untuk satu instans komponen saja, sementara setiap instans
lain dengan tipe yang sama tetap memakai Recipe massal tingkat type.
Yang ditunjukkan
Aggregate mendeklarasikan dua instans dari satu tipe komponen (example/compute/greeter):
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeterKatalog menyediakan dua Recipes yang sama-sama mengimplementasikan example/compute/greeter — greeter-blue
(build bawaan) dan greeter-green (build alternatif). Manifest memetakan
tipe tersebut secara massal dan mengganti satu instans berdasarkan nama:
mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance... name: greeter-special: compose/greeter-green:1.0.0 # ...except this oneNama mengalahkan tipe, sehingga greeter-special di-deploy melalui greeter-green dan
greeter-default melalui greeter-blue.
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 per-instance-recipe-overrideKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd per-instance-recipe-overrideBuild
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlContoh ini memakai pustaka standar untuk provider-nya: provider compose disediakan dalam katalog standar. Mainan milik pelajaran penggantian ini — komponen demo example/compute/greeter dan kedua recipe-nya (greeter-blue / greeter-green), yang ada semata-mata agar penggantian per instans terlihat — berada di katalog bersama di bawah penerbit example/, berdampingan dengan entitas pustaka standar. .aggrega-config.yaml mendeklarasikan hub.aggrega.ai sebagai registri bawaan, sehingga entitas diresolusi dari hub — perintah build tidak memerlukan flag --catalog.
dist/app/compose/docker-compose.yaml yang dirender menunjukkan penggantian tersebut bekerja —
greeter-default menjalankan image: greeter:blue, greeter-special menjalankan
image: greeter:green, dan label provenans aggrega.ai/recipe-uri pada setiap layanan
menyebutkan Recipe berbeda yang menjadi hasil resolusinya.
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 Workspace belum berisi folder `per-instance-recipe-override`, panggil alat `scaffold` sekali dengan `example` diatur ke `per-instance-recipe-override` dan tanpa `dir`: alat ini menulis contoh ke folder `per-instance-recipe-override` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `per-instance-recipe-override`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file apa saja yang ditulis build tersebut; file-file itu ada di bawah `per-instance-recipe-override/dist/`.Mengapa ini berguna
Dua instans dari satu tipe komponen terkadang memerlukan implementasi fisik
yang berbeda — misalnya basis data primer pada Recipe cloud terkelola sementara
replikanya memakai Recipe di dalam kluster. Tingkat name menyatakan hal itu per
instans, di dalam Manifest, tanpa melakukan fork pada tipe komponen atau menduplikasi
Aggregate. Tipe yang diimplementasikan oleh lebih dari satu Recipe harus diperjelas melalui
pemetaan; jika tidak dipetakan, build berhenti dan menyebutkan kandidatnya alih-alih
menebak.