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.

Tài liệu tham khảo ngôn ngữ

“Cái gì” và “cách sử dụng” của Aggrega. Cú pháp, cách gọi CLI, danh mục lỗi, các ví dụ minh họa.

Hãy đọc các chương dưới đây theo thứ tự để nắm bắt lần đầu. Các thư mục con tham khảo được liệt kê dưới chương tương ứng — hãy chuyển thẳng đến đó khi bạn cần tra cứu một thực thể, từ khóa, provider, lệnh CLI hoặc lỗi cụ thể.

Trước khi đọc chuỗi các chương, hãy tham khảo Trạng thái của ngôn ngữ để biết mức độ sẵn sàng hiện tại — những bề mặt ngôn ngữ nào đã có sẵn hôm nay, những bề mặt nào được chấp nhận nhưng trình biên dịch chưa xử lý, và những bề mặt nào được lên kế hoạch cho các lần lặp trong tương lai. Khả năng tương thích nêu những gì một bản phát hành cam kết đối với các schema, dòng lệnh, các công cụ trợ lý, các mã lỗi và các bộ công cụ plugin.

Mô hình phân tầng thực thể

Các loại thực thể soạn thảo của Aggrega được tổ chức thành ba tầng phản ánh tiến trình áp dụng (bên dưới). Bên cạnh chúng là Workload do nền tảng sở hữu, vốn không phải là một loại soạn thảo riêng — nó là hình dạng mà đầu vào được tổng hợp của một Recipe mang, biểu đạt hình dạng tính toán thông qua bộ từ vựng form: (stateless, stateful, daemon, scheduled, task, reference). Việc phân tầng là một cơ chế dành cho tài liệu và quá trình làm quen, không phải một ràng buộc lúc chạy: mọi loại thực thể đều là công dân hạng nhất của ngôn ngữ; trình biên dịch xử lý chúng như nhau; Aggrega mã nguồn mở hỗ trợ mọi tầng mà không giới hạn bằng giấy phép hay tính năng. Các nhãn tầng báo hiệu “nâng cao; bỏ qua nếu không cần” để điều hướng, chứ không phải về khả năng.

TầngLoại thực thểKhi nào áp dụng
Tầng 1 — bề mặt tối thiểu khả dụngAggregate, Component, Recipe, Manifest, ReleaseNgày 1 — nhà sáng lập một mình và các nhóm nhỏ phát hành phần mềm hoạt động được chỉ với Tầng 1. Mô hình tư duy: “Tôi có một ứng dụng; tôi muốn triển khai nó; đây là cách làm.”
Tầng 2 — tách biệt vai tròFeature, FeatureRecipe, PluginNgày 30 — các nhóm nhỏ nơi vai trò được tách ra (developer + Ops + đôi khi Security). Tầng 2 xuất hiện qua các Plugins kết xuất provider (Ops chọn trong số Helm, helm-chart, Compose, Terraform và CloudFormation), các Features (Security quản lý thông tin xác thực tách biệt khỏi cấu hình ứng dụng) và các FeatureRecipes (tùy biến tại thời điểm liên kết theo từng provider).
Tầng 3 — tái sử dụng xuyên ComponentSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibraryNgày 365 — các catalog trưởng thành nơi các hình dạng chung lặp lại trên nhiều thực thể. Ngưỡng này không chính thức: khi một hình dạng (ví dụ PodResources) xuất hiện trong 5+ Components và việc phối hợp cập nhật trở nên vướng víu, một mục SchemaLibrary sẽ chứng minh được giá trị của nó.

Mỗi bước tiến đều là tùy chọn. Một nhà sáng lập một mình không bao giờ bị buộc phải xem Tầng 3; một catalog doanh nghiệp có toàn quyền truy cập Tầng 3 khi cần. Tầng 1 là hoàn chỉnh cho trường hợp sử dụng của nhà sáng lập một mình — một developer có thể phát hành ứng dụng hoạt động được chỉ bằng các thực thể Tầng 1. Đây là một đặc tính thiết kế mạnh: Tầng 1 không phải là một “tập con biên dịch được”; nó là một “tập con phát hành được phần mềm.”

Bề mặt Tầng 1 gồm năm thực thể có một chi phí ban đầu — Aggregate + Component + Recipe + Manifest + Release đòi hỏi nhiều thủ tục hơn kiểu “thả một tệp YAML, có ngay một dịch vụ đang chạy.” Chi phí này là cái giá của sự tách biệt soạn thảo theo bốn miền (Developer Intent / Platform Catalog / Platform Ops / Routing) khiến Aggrega khác với Helm thuần hay Terraform thuần. Các hướng dẫn Tầng 1 đi qua thiết lập năm thực thể một cách tường minh.

Trong Tầng 3, cơ chế spec.templates / $instantiate: (các helper tham số hóa trong SchemaLibrary) được tài liệu hóa như một tính năng con còn nâng cao hơn nữa. Phần lớn người áp dụng Tầng 3 ban đầu không dùng đến spec.templates; ngưỡng là “khi thư viện của bạn có 6+ schema chia sẻ cấu trúc được tham số hóa.”

Thứ tự đọc

  1. Cách sử dụng tài liệu tham chiếu này
  2. Quy ước đặt tên
  3. Tổng quan tham chiếu thực thể
  4. Tổng quan từ vựng
  5. Tổng quan về template
  6. Tổng quan về Providers
  7. Tổng quan về CLI
  8. Tổng quan về lỗi
  9. Tổng quan về ví dụ

Tài liệu tham khảo về việc viết Plugin

Bề mặt plugin Wasm nằm song song với chuỗi chương thay vì nằm bên trong nó: người viết plugin đọc phần này độc lập với lộ trình viết entity. Trang entity plugin trình bày bề mặt viết catalog; các trang dưới đây trình bày các socket, các payload và quy trình làm việc của người viết.

  • plugin-contract — các socket mà một plugin gắn vào, vị trí của chúng trong pipeline, và hình dạng đầu vào, đầu ra của từng socket.
  • plugin-developer-guide — quy trình làm việc đầy đủ của người viết: describe(), các khai báo năng lực, giới hạn runtime, vòng đời publish/pull/build, ký số, quản lý phiên bản.
  • policy-socket — socket quản trị chuyên sâu: bốn vai trò của nó, các mức độ nghiêm trọng của phán quyết, kênh đầu vào của người vận hành, và cách viết policy cho một trong hai engine được đóng gói sẵn trong trình biên dịch.
  • governance-attachment-facts — các dữ kiện theo từng attachment mà một policy quản trị đọc từ đồ thị build, bao gồm ba đơn vị của nhãn độ nhạy cảm và lý do việc không có nhãn không có nghĩa là được phép.
  • when-to-use-a-pipeline-step — lựa chọn giữa một bước pipeline và một FeatureRecipe dùng template.
  • embedded-plugins — các plugin được đóng gói sẵn trong binary của trình biên dịch.
  • tagging-plugins — hai plugin quản trị tích hợp sẵn ghi label mà không cần chính sách, governance/label-injector và governance/selector-tagger: các thiết lập của chúng và những gì mỗi plugin ghi.
  • core-importers — mười importer của trình biên dịch, từ Langflow, Flowise và n8n đến Compose, MCP và các framework agent: mỗi importer đọc gì và soạn bản nháp gì, các thiết lập của chúng, và việc chúng được phát hành cùng mỗi bản phát hành của trình biên dịch.
  • authoring-a-provider-walkthrough — hướng dẫn thực hành từng bước soạn một guest provider, từ một thư mục trống đến một bản build ghi ra các tệp mà provider đã render.
  • writing-a-governance-plugin — viết một plugin quản trị của riêng bạn từ khung adapter của bộ công cụ plugin: một quy tắc, chạy thủ công export của từng vai trò, một thực thể Plugin trong catalog của workspace, và một bản build mà plugin từ chối.
  • compatibility — cách các bộ công cụ plugin được đánh phiên bản: một bản phát hành bản vá và một bản phát hành phụ của một bộ công cụ có thể thay đổi những gì, và điều gì giữ cho một plugin đã build vẫn tải được.