Kết hợp
Trang này giải thích một ý tưởng, xây dựng một ứng dụng từ các phần lớn hơn một thành phần, và không phải là một không gian làm việc có thể chạy. Định tuyến module vào ranh giới — đặt toàn bộ module con vào ranh giới trình bày điều này trong một không gian làm việc mà bạn tự build; hãy ghi nó vào một thư mục của riêng bạn bằng:
aggrega scaffold --example module-boundary-routingSau đó nó in ra các lệnh cần chạy tiếp theo:
cd module-boundary-routingaggrega build --release release.yaml --auto-pullModule: một Aggregate được một Aggregate khác nhập
Một Aggregate có thể nhập một Aggregate khác làm module dưới aggregates:. Module tự kết hợp các thành phần của nó và tự nối các cạnh của nó, nên không phần bên trong nào của nó xuất hiện trong Aggregate nhập nó. Ví dụ này nhập hai module từ danh mục thư viện chuẩn, từ aggregate.yaml:
spec: aggregates: metrics: type: core/thanos documents: type: core/ferretdbKhối exportedComponents của một module là giao diện công khai của nó: các thành phần mà thứ gì đó bên ngoài module có thể kết nối tới, mỗi thành phần dưới tên mà nó được xuất. core/ferretdb xuất thành phần proxy của nó dưới tên mongo, nên một thành phần của Aggregate nhập module tới được nó bằng đường dẫn có dấu chấm documents.mongo:
uses: database: main: target: documents.mongoMột module có thể khai báo các tham số riêng, và Aggregate nhập module đáp ứng chúng trên parameters: của lần nhập.
Đặt một module
Release đặt toàn bộ một module vào một ranh giới bằng một mục aggregates: có khóa là tên của module, và mọi thành phần mà module chứa đi cùng với nó. Release cũng có thể cấu hình các thành phần của module, mỗi thành phần theo tên mà nó có bên trong module. Từ release.yaml, đã lược bỏ chú thích:
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: {}Các annotation riêng của một module đi tới các thành phần riêng của nó đúng như annotation của một Aggregate đi tới các thành phần của chính nó, nên một module có thể đặt các thành phần của nó vào một namespace mà nó khai báo. Aggregate nhập module không khai báo gì vươn vào bên trong module; Release thì có, và giá trị của nó thắng trên cùng một khóa.
Một dịch vụ mà bản build không cấp phát
Một máy chủ đã tồn tại vẫn là một nút của đồ thị: nó tham gia vào các kết nối, vào chính sách và vào những gì các bên tiêu thụ của nó nhận được, và không có gì được cấp phát cho nó. Manifest của nó liên kết một Recipe không cấp phát gì, và Release cung cấp địa chỉ. Trong Một hợp đồng, ba cách hiện thực, Manifest manifest-external.yaml liên kết core/datastore/postgres với helm/postgres-external, vốn chỉ phát ra một ExternalName Service, và Release cung cấp địa chỉ, từ release-external.yaml:
db: infra: overrides: host: postgres.data.example.netĐịa chỉ là một chuỗi con trỏ: bản build chuyển nó đi mà không phân giải, và bất cứ thứ gì trả lời tại tên đó khi ứng dụng chạy chính là thứ mà ứng dụng tới được. Aggregate là cùng một tệp cho cả ba Releases của ví dụ.
Hệ thống con: nhóm bên trong một Aggregate
Một hệ thống con nhóm các thành phần bên trong một Aggregate. Các annotation được khai báo trên nó đi tới mọi thành phần mà nó chứa, và một Feature được gắn vào nó sẽ được gắn vào từng thành phần đó:
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/workerBản build làm phẳng cây hệ thống con: invoice-api và payment-worker mỗi thành phần đều mang phần gắn metrics và cả hai annotation, mà một Recipe đọc dưới dạng {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }}. aggrega.ai/namespace là một annotation của provider, nên nó cũng đặt cả hai thành phần vào namespace billing. Release cấu hình infra của phần gắn dưới mục của từng thành phần, theo tên mà hệ thống con đã đặt cho nó, và một namespace mà Release đặt sẽ ghi đè namespace của hệ thống con cho các thành phần mà nó bao phủ.
Một phần gắn kết nối tới thứ gì đó của riêng nó
Một phần gắn có thể mang khối uses: của riêng nó, vẽ một cạnh từ phần gắn thay vì từ thành phần mà nó được gắn lên. Trong Một kho dữ liệu được sao lưu trên mọi đích, người vận hành gắn core/backup vào cơ sở dữ liệu và kết nối phần gắn với bucket mà các bản sao lưu được gửi tới, từ release-helm-velero.yaml:
spec: components: db: features: backup: type: core/backup infra: schedule: "30 2 * * *" retention_days: 14 uses: store: bucket: target: backupsCác kết nối riêng của cơ sở dữ liệu không thay đổi: cạnh tới backups thuộc về phần gắn, được ghi nhận là do nó vẽ, và được chính sách kiểm tra như mọi cạnh khác. Một Feature vận hành và một Feature thông tin xác thực được gắn theo cùng cách, và cả hai đều có thể mang một khối uses:.