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

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/greeter

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

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

Terminal window
aggrega scaffold --example per-instance-recipe-override

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

Terminal window
cd per-instance-recipe-override

Build

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

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