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

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:

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

Kemudian ia mencetak perintah yang dijalankan berikutnya:

Terminal window
cd module-boundary-routing
aggrega build --release release.yaml --auto-pull

Modul: 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/ferretdb

Blok 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.mongo

Modul 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.net

Alamat 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/worker

Build 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: backups

Koneksi 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:.