Perutean batas modul — menempatkan seluruh submodul ke dalam batas
Contoh ini mengompilasi dua kapabilitas — sebuah tingkat baca metrik Thanos di atas
penyimpanan objek dan sebuah basis data dokumen yang menggunakan protokol wire MongoDB —
dari satu Aggregate yang ditulis oleh Developer, dan menempatkan masing-masing ke dalam batasnya
sendiri dari Release.
Kedua kapabilitas tersebut adalah modul: sub-aggregate yang dapat digunakan ulang yang masing-masing menyusun
beberapa komponen satu-workload dan menghubungkan edge internalnya sendiri. Aggregate
menyebutkan kedua modul dan tidak menyatakan apa pun tentang tempat modul tersebut berjalan. Release
menempatkan setiap modul secara utuh dengan satu entri aggregates: per batas — operator
menentukan tempat suatu kapabilitas berjalan tanpa melacak, atau menyatakan ulang, apa yang ada di
dalamnya.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: mengimpor modul metrik (core/thanos) dan modul basis data dokumen (core/ferretdb). |
manifest.yaml | Memetakan setiap tipe komponen yang disumbangkan kedua modul ke Recipe synth helm-nya, Feature kredensial yang dilampirkan modul metrik ke realisasi yang menghasilkan Secret dari masing-masing dua parameter kunci modul, dan Feature scrape ke FeatureRecipe-nya. |
release.yaml | Catatan operator: merutekan setiap modul ke batasnya sendiri, menentukan ukuran satu komponen dari satu modul, dan melampirkan Feature scrape padanya. |
Apa yang didemonstrasikan
- Merutekan seluruh modul ke dalam batas. Entri
aggregates:suatu batas dikunci dengan nama modul di Aggregate. Entri ini menempatkan setiap komponen yang dimuat modul, sehingga artefak yang dihasilkan untuk ketiga komponen metrik berada di bawah batasobservabilitydan kedua komponen basis data dokumen di bawahdata. - Tidak menyebutkan komponen sama sekali adalah bentuk utama. Batas
datamerutekan modul basis data dokumen dengandocuments: {}saja. Setiap komponen di dalamnya ditempatkan dan memakai default skemanya sendiri; Release hanya memerlukan nama modul dan tidak hal lain tentangnya. - Mengonfigurasi komponen yang dirutekan melalui nama lokalnya. Entri perutean juga dapat
mengonfigurasi komponen individual dari modul yang dirutekannya, yang dirujuk dengan nama
lokal yang dimiliki masing-masing di dalam modul tersebut —
query, bukanmetrics.query, karena di dalam modul itulah satu-satunya nama yang dimilikinya. Menyebutkan satu komponen tidak menyatakan apa pun tentang komponen lainnya: di siniquerydiberi ukuran dan target scrape, sementara penyimpanan objek dan store gateway dirutekan dengan default-nya. - Komponen yang dirutekan adalah komponen dari batas tersebut. Komponen ini mewarisi
kaskade anotasi batas seperti komponen lainnya, dan itulah yang memberi setiap
resource dari modul yang dirutekan nilai
aggrega.ai/namespacemilik batas — termasuk komponen yang tidak pernah disebutkan oleh entri perutean. - Perutean adalah penempatan, bukan jenis keanggotaan yang berbeda. Komponen yang dirutekan tanpa keterangan apa pun dirender sama seperti komponen yang sama yang disebutkan langsung di batas tersebut dengan isi kosong. Kedua penulisan itu adalah dua cara untuk menyatakan tempat suatu komponen berada, bukan dua perilaku.
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 module-boundary-routingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd module-boundary-routingBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
aggrega build --release release.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/. Target Kubernetes merender manifest
biasa secara offline — tidak diperlukan penarikan chart.
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 `module-boundary-routing`, panggil alat `scaffold` sekali dengan `example` diatur ke `module-boundary-routing` dan tanpa `dir`: alat ini menulis contoh ke folder `module-boundary-routing` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `module-boundary-routing`, `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 `module-boundary-routing/dist/`.Tampilan stack yang ditempatkan
directory setiap batas adalah root artefak untuk semua yang ditempatkan di dalamnya, sehingga
komponen kedua modul terpisah di disk menurut batas yang merutekannya:
dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquerydist/data/helm/ documents-zdproxy, documents-zdbackendNama file memuat identitas setiap komponen dengan pemisah modul yang ditulis
lengkap, karena titik bukan karakter yang dapat dimuat oleh setiap nama resource — metrics.store
di Aggregate menjadi metrics-zdstore di klaster. Menyusun modul adalah
satu-satunya hal yang menempatkan pemisah dalam identitas, sehingga komponen yang Anda sebutkan langsung
ditulis sama di kedua tempat.
Setiap resource membawa namespace batas perutean dan mencatat batas mana yang menempatkannya. Store gateway tidak pernah disebutkan dalam entri perutean dan tetap mewarisi keduanya:
metadata: name: metrics-zdstore namespace: observability [… omitted: the labels every rendered document carries] annotations: aggrega.ai/boundary-path: observability [… omitted: the annotation naming the Recipe that rendered it]Hal yang sama berlaku untuk empat Secret yang dihasilkan Feature kredensial modul metrik untuk pasangan kunci penyimpanan objek dan pasangan kunci yang diserahkan store gateway kepadanya: masing-masing berada di bawah observability dengan namespace tersebut, di samping workload yang membacanya.
Feature scrape yang dilampirkan pada komponen query yang dirutekan merender artefaknya sendiri
di bawah batas yang sama, dengan membawa pengaturan scrape operator:
apiVersion: monitoring.coreos.com/v1kind: ServiceMonitormetadata: name: metrics-zdquery-scrape [… omitted: the namespace, labels and annotations every rendered document carries]spec: selector: matchLabels: app.kubernetes.io/name: metrics-zdquery endpoints: - port: http interval: 30s path: /metrics