Komposisi
Halaman ini menjelaskan satu gagasan, yaitu membangun aplikasi dari bagian-bagian yang lebih besar daripada satu komponen, dan bukan ruang kerja yang dapat dijalankan. Perutean batas modul — menempatkan seluruh submodul ke dalam batas menunjukkannya dalam ruang kerja yang Anda bangun; tuliskan ke folder Anda sendiri dengan:
aggrega scaffold --example module-boundary-routingKemudian ia mencetak perintah yang dijalankan berikutnya:
cd module-boundary-routingaggrega build --release release.yaml --auto-pullModul: Aggregate yang diimpor oleh Aggregate lain
Aggregate dapat mengimpor Aggregate lain sebagai modul di bawah aggregates:. Modul menyusun komponennya sendiri dan menghubungkan edge-nya sendiri, sehingga tidak ada bagian internalnya yang muncul di Aggregate yang mengimpornya. Contoh ini mengimpor dua modul dari katalog pustaka standar, dari aggregate.yaml:
spec: aggregates: metrics: type: core/thanos documents: type: core/ferretdbBlok exportedComponents sebuah modul adalah antarmuka publiknya: komponen-komponen yang boleh dihubungkan oleh sesuatu di luar modul, masing-masing dengan nama ekspornya. core/ferretdb mengekspor komponen proxy miliknya sebagai mongo, sehingga komponen dari Aggregate yang mengimpor menjangkaunya dengan jalur bertitik documents.mongo:
uses: database: main: target: documents.mongoModul dapat mendeklarasikan parameternya sendiri, yang dipenuhi oleh Aggregate yang mengimpor pada parameters: milik impor tersebut.
Menempatkan modul
Release menempatkan seluruh modul di sebuah batas dengan entri aggregates: yang berkunci nama modul, dan setiap komponen yang dikandung modul ikut bersamanya. Release juga dapat mengonfigurasi komponen-komponen modul, masing-masing dengan nama yang dimilikinya di dalam modul. Dari release.yaml, tanpa komentar:
spec: boundaries: observability: directory: observability annotations: aggrega.ai/namespace: observability aggregates: metrics: components: query: infra: compute: cpu: 500m memory: 1Gi data: directory: data annotations: aggrega.ai/namespace: data aggregates: documents: {}Anotasi milik modul itu sendiri menjangkau komponen-komponennya sendiri persis seperti anotasi Aggregate menjangkau komponennya sendiri, sehingga modul dapat menempatkan komponennya di namespace yang dideklarasikannya. Aggregate yang mengimpor tidak mendeklarasikan apa pun yang menjangkau ke dalam modul; Release yang melakukannya, dan nilainya menang pada kunci yang sama.
Layanan yang tidak diprovisikan oleh build
Server yang sudah ada tetap merupakan simpul dalam graf: server itu ikut serta dalam koneksi, dalam kebijakan, dan dalam apa yang diterima konsumennya, dan tidak ada yang diprovisikan untuknya. Manifest-nya mengikat Recipe yang tidak memprovisikan apa pun, dan Release memberikan alamatnya. Dalam Satu kontrak, tiga realisasi, Manifest manifest-external.yaml mengikat core/datastore/postgres ke helm/postgres-external, yang hanya menghasilkan ExternalName Service, dan Release menyediakan alamatnya, dari release-external.yaml:
db: infra: overrides: host: postgres.data.example.netAlamat tersebut adalah string penunjuk: build meneruskannya tanpa menguraikannya, dan apa pun yang menjawab pada nama itu saat aplikasi berjalan adalah apa yang dijangkau aplikasi. Aggregate adalah file yang sama untuk ketiga Releases dalam contoh ini.
Subsistem: pengelompokan di dalam satu Aggregate
Subsistem mengelompokkan komponen di dalam sebuah Aggregate. Anotasi yang dideklarasikan padanya menjangkau setiap komponen yang dikandungnya, dan Feature yang dipasang padanya dipasang pada masing-masing komponen tersebut:
spec: subsystems: billing: annotations: team.aggrega.ai/owner: billing-squad aggrega.ai/namespace: billing features: metrics: type: core/prometheus-exporter components: invoice-api: type: core/compute/server payment-worker: type: core/compute/workerBuild meratakan pohon subsistem: invoice-api dan payment-worker masing-masing membawa pemasangan metrics dan kedua anotasi, yang dibaca Recipe sebagai {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }}. aggrega.ai/namespace adalah anotasi provider, sehingga anotasi ini juga menempatkan kedua komponen di namespace billing. Release mengonfigurasi infra milik pemasangan di bawah entri setiap komponen, dengan nama yang diberikan subsistem kepadanya, dan namespace yang ditetapkan Release menimpa namespace subsistem untuk komponen-komponen yang dicakupnya.
Pemasangan yang terhubung ke sesuatu miliknya sendiri
Pemasangan dapat membawa blok uses: sendiri, menarik edge dari pemasangan itu, bukan dari komponen tempatnya dipasang. Dalam Datastore yang dicadangkan di setiap target, operator memasang core/backup pada basis data dan menghubungkan pemasangan itu ke bucket tujuan cadangan, dari release-helm-velero.yaml:
spec: components: db: features: backup: type: core/backup infra: schedule: "30 2 * * *" retention_days: 14 uses: store: bucket: target: backupsKoneksi milik basis data itu sendiri tidak berubah: edge ke backups milik pemasangan, dicatat sebagai ditarik olehnya, dan diperiksa oleh kebijakan seperti edge lainnya. Feature operasional dan Feature kredensial dipasang dengan cara yang sama, dan keduanya dapat membawa blok uses:.