Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Cách sử dụng tài liệu tham chiếu này

Tài liệu tham chiếu ngôn ngữ đặc tả bề mặt soạn thảo của Aggrega — các schema YAML, bộ từ khóa dùng chung, hệ thống template Go, các hợp đồng provider, các lệnh CLI, danh mục lỗi của trình biên dịch, và các ví dụ hoàn chỉnh từ đầu đến cuối. Hãy đọc các chương dưới đây theo thứ tự để định hướng lần đầu, hoặc chuyển thẳng vào một thư mục con khi tra cứu một thực thể, từ khóa, provider, lệnh CLI hoặc lỗi cụ thể.

Để cài đặt tệp nhị phân aggrega trước, hãy làm theo Cài đặt tệp nhị phân; để một trợ lý AI cài đặt và thiết lập nó cho bạn, hãy dán prompt trong Thiết lập Aggrega với trợ lý AI của bạn. Trước khi xây dựng script hoặc catalog trên Aggrega, hãy đọc Khả năng tương thích để biết một lần nâng cấp có thể và không thể thay đổi những gì.

Trước khi đọc tài liệu tham chiếu, hãy nắm vững mô hình tư duy mà các chương kiến trúc thiết lập. Chương Bốn miền và Team Topologies giải thích cách Aggrega tách các mối quan tâm Developer Intent, Platform Catalog, Platform Ops và Platform Operator thành các bề mặt soạn thảo riêng biệt; chương Phân loại thực thể nêu tên các thực thể (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) và vai trò của chúng trong các miền đó. Mọi chương tham chiếu sau chương này đều giả định người đọc đã có hình dung đó.

Hãy dùng tài liệu tham chiếu này theo hai cách. Để làm quen, hãy đọc tuần tự: bắt đầu với Quy ước đặt tên để biết mẫu tên instance và các quy tắc viết hoa, rồi đi qua các chương về thực thể và từ vựng để xây dựng toàn bộ hợp đồng soạn thảo. Để tra cứu, hãy chuyển thẳng tới thư mục con phù hợp với câu hỏi — entities/ cho ngữ nghĩa trường của từng thực thể, vocabulary/ cho các từ khóa dùng chung giữa các thực thể, templates/ cho bề mặt template Go dành cho tác giả Recipe, providers/ cho các hợp đồng điều phối của từng provider, plugins/ cho các socket plugin và việc viết plugin, schema/ cho JSON Schema của từng kind, cli/ cho cách dùng dòng lệnh, errors/ cho chẩn đoán, và examples/ cho các mẫu hoàn chỉnh.