Tổng quan về từ vựng
Một tập nhỏ các từ khóa xuất hiện lặp lại trên các thực thể của Aggrega. Thay vì giải thích lại chúng trên mỗi trang thực thể, các chương Từ vựng tập trung phần giảng giải vào một nơi cho mỗi họ từ khóa. Mọi thực thể chấp nhận một trong các từ khóa này đều làm vậy với cùng ngữ nghĩa mà bộ chương này đặc tả.
Từ vựng chia thành bốn họ: bộ ba topology (provides, inject, uses) nối các cạnh topology tường minh giữa các nút và mang hợp đồng injection mà trình biên dịch truyền qua; các trụ cột dữ liệu (values, infra, parameters, locals) tách biệt bốn mối quan tâm về dữ liệu — ý định của nhà phát triển, kích thước vật lý, các tùy chỉnh theo từng môi trường và trạng thái riêng của Recipe; các từ khóa kế thừa và giao diện (extends, implements) kết hợp các thực thể catalog và khai báo một Recipe hiện thực Component nào; và hệ thống modifier (appliesTo, appliesToAnyOf) quyết định một Feature gắn vào những nút nào thông qua label selector. Khung khái niệm về cách các trụ cột tách biệt các mối quan tâm nằm trong ../architecture/06-data-taxonomy-and-composition.md; cơ chế phân giải topology nằm trong ../architecture/07-dependency-resolution.md.
Tham chiếu theo chủ đề
- Bộ ba topology:
provides,inject,uses— hợp đồng injection và các khai báo cạnh topology tường minh. Bao gồm cú pháp inject dạng gọn so với dạng đầy đủ, các dạng pipe.context.inject/.context.usesmà template đọc, và context trạng thái kép giúp Ops tránh các lỗi panic do con trỏ nil. - Các trụ cột dữ liệu:
values,infra,parameters,locals— bốn trụ cột dữ liệu và quyền sở hữu của chúng.valuesvàparametersdo nhà phát triển sở hữu,infrado Ops sở hữu,localsriêng của Recipe, và mẫu hoisting tham số cho sự khác biệt theo từng môi trường. - Kế thừa và giao diện:
extends,implements— kế thừa thực thể catalog quaextends(deep-merge phong bì YAML chung cho Components và Features, các trụ cột dữ liệu mà một Component mở rộng kế thừa nguyên vẹn từ base của nó, và phép kết hợp JSON Schema 2020-12 mà schema của một Feature trải qua) và khai báo từ Recipe tới Componentimplements(các dạng chính xác, theo khoảng phiên bản, không có phiên bản), mà ánh xạ của Manifest được kiểm tra dựa vào —implementskhông bao giờ chọn một Recipe. - Hệ thống modifier:
appliesTovà selector — các selector gắn Feature, engine so khớp label gốc viết bằng Go, ngữ pháp selector dạng chuỗi, và biến thểappliesToAnyOfkết hợp theo OR. - Ngoài bốn họ: soạn thảo dạng rút gọn, tham chiếu giữa các tài liệu, nhãn và chú thích, bề mặt công bố, khế ước xã hội, bề mặt xác thực, kết hợp đầu ra, ngữ pháp URI và phân giải phiên bản.