Mô hình dữ liệu
Trang này giải thích một ý tưởng, ai viết dữ liệu nào về 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 được. Một hợp đồng, ba cách hiện thực minh họa điều này trong một không gian làm việc mà bạn build; ghi nó vào một thư mục của riêng bạn bằng lệnh:
aggrega scaffold --example postgres-three-realizationsSau đó nó in ra các lệnh cần chạy tiếp theo:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues và infra: hai không gian tên, hai tác giả
Một Component khai báo hai tập thiết lập riêng biệt. values của nó thuộc về nhà phát triển, được viết trong Aggregate: những gì ứng dụng cần, giống nhau ở mọi môi trường. infra của nó thuộc về người vận hành, được viết trong Release: kích thước và vị trí đặt, khác nhau giữa các môi trường. Các schema tách biệt hai phần này — schema của Aggregate không có infra trên một thành phần và schema của Release không có values — nên không tác giả nào có thể đặt các trường của người kia. Một Recipe nhận cả hai, dưới dạng hai đối tượng riêng biệt, .values và .infra.
Trong ví dụ, nhà phát triển đặt tên cho cơ sở dữ liệu và vai trò đăng nhập của nó, lấy từ aggregate.yaml:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuservà Release build một instance được quản lý sẽ xác định kích thước cho nó, lấy từ release-managed.yaml với các chú thích được lược bỏ:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0Hai Releases còn lại của ví dụ build cùng một Aggregate trong một cụm và trên một máy chủ đã tồn tại, mỗi bản có infra riêng; Aggregate không thay đổi.
Một giá trị vẫn cần thay đổi theo môi trường thì được nâng lên: Aggregate khai báo một tham số, viết nó vào giá trị, và mỗi Release đáp ứng tham số đó (xem Các tệp của một bản build).
Một Release được xây dựng trên một Release khác
Một Release có thể chỉ định một Release khác làm bản cơ sở của nó bằng extends: và chỉ thay đổi những gì khác biệt. Bản con kế thừa ranh giới, vị trí đặt và tham số của bản cơ sở, và việc khai báo aggregate: bên cạnh extends: bị schema của Release từ chối, vì bản con phải build cùng một Aggregate với bản cơ sở của nó. Nó có thể chỉ định một Manifest của riêng mình, hoặc bỏ manifest: đi và kế thừa Manifest của bản cơ sở.
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gidirectory: của một ranh giới được kế thừa như mọi thiết lập khác, nên một bản con kế thừa một thư mục cố định sẽ kết xuất vào cùng nơi với bản cơ sở của nó. Viết thư mục theo một tham số mới là cách đưa đầu ra của mỗi Release tới một nơi riêng; xem Release tổng hợp và kế thừa extends.
Một Manifest được xây dựng trên một Manifest khác
Một Manifest có thể mở rộng một Manifest khác theo cùng cách, và các mục của nó thay thế mục của bản cơ sở cho cùng một khóa. Một Manifest dành cho phát triển có thể giữ mọi liên kết của Manifest dành cho production và thay đổi cách hiện thực hóa thông tin xác thực: ở đây một phần đính kèm core/referenced-secret được lấy từ một kho bí mật trong production và được ghi vào một Secret từ giá trị mà tác giả cung cấp trong môi trường phát triển.
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0Hai cách hiện thực công bố tên của Secret theo cùng một cách, nên một thành phần đọc thông tin xác thực sẽ kết xuất cùng một tham chiếu dù dùng Manifest nào; Một ý định của nhà phát triển, hai dạng cung cấp thông tin xác thực build cả hai và so sánh chúng.
Hai nhãn: kiểu và danh mục
Mỗi Component mang một giá trị từ một tập đóng trên nhãn dành riêng component.aggrega.ai/type: server, một endpoint chạy lâu dài; worker, một consumer chạy nền; stateful-server, thứ giữ dữ liệu bền vững của riêng nó; task, chạy cho đến khi hoàn tất; function, một hàm hướng sự kiện; và resource, một tài nguyên đám mây được quản lý không chạy tính toán nào của riêng nó. Giá trị nằm trên thực thể danh mục, không bao giờ nằm trên instance trong một Aggregate.
Kiểu cho biết hạ tầng phải xử lý một thành phần như thế nào, chứ không phải thành phần đó dùng để làm gì. Một message broker giữ đĩa của riêng nó là một stateful-server, y như một cơ sở dữ liệu: core/messaging/kafka và core/datastore/postgres mang cùng một kiểu. Thứ mà người đọc dùng để duyệt là nhãn còn lại, component.aggrega.ai/category — messaging cho broker, datastore cho cơ sở dữ liệu — và đó cũng là thư mục danh mục chứa thực thể. Một bộ chọn viết theo một nhãn không bao giờ khớp trên nhãn kia.