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

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

BerkasPeran
aggregate.yamlMaksud Developer: mengimpor modul metrik (core/thanos) dan modul basis data dokumen (core/ferretdb).
manifest.yamlMemetakan 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.yamlCatatan 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 batas observability dan kedua komponen basis data dokumen di bawah data.
  • Tidak menyebutkan komponen sama sekali adalah bentuk utama. Batas data merutekan modul basis data dokumen dengan documents: {} 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, bukan metrics.query, karena di dalam modul itulah satu-satunya nama yang dimilikinya. Menyebutkan satu komponen tidak menyatakan apa pun tentang komponen lainnya: di sini query diberi 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/namespace milik 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:

Terminal window
aggrega scaffold --example module-boundary-routing

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

Terminal window
cd module-boundary-routing

Build

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:

Terminal window
aggrega build --release release.yaml --auto-pull

Artefak 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-zdquery
dist/data/helm/ documents-zdproxy, documents-zdbackend

Nama 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/v1
kind: ServiceMonitor
metadata:
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