Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.
Lộ trình Aggrega
Aggrega đến từ đâu và đang đi về đâu, qua những bước lớn. Các cột mốc 0 đến 3 mô tả những gì trình biên dịch và danh mục của nó làm được hiện nay; cột mốc 4 và các hướng đi sau đó mô tả công việc phía trước. Trang này không đưa ra mốc thời gian. Những gì hoạt động hiện nay, theo từng bề mặt, có tại Trạng thái của ngôn ngữ.
Cột mốc 0 — Một bản mẫu
Bản mẫu đầu tiên biên dịch các tài liệu YAML thông qua một đồ thị trung gian thành đầu ra Helm và cho thấy cách tiếp cận này khả thi. Trình biên dịch ra đời sau đó được viết xoay quanh mô hình thực thể dưới đây.
Cột mốc 1 — Lõi trình biên dịch
- Mô hình thực thể. Nhà phát triển mô tả một ứng dụng trong một Aggregate. Các nhóm nền tảng cung cấp các Components và Features mà nó sử dụng cùng các Recipes và FeatureRecipes hiện thực hóa chúng trên một mục tiêu; một Manifest ánh xạ mỗi loại tới Recipe của nó, và một Release đặt Aggregate vào một môi trường.
- Quy trình biên dịch. Phân giải, xây dựng cấu trúc liên kết, hoàn tất đồ thị, phân tích tĩnh và kết xuất biến các tài liệu thành một đồ thị trung gian gồm các thành phần và các kết nối
usesgiữa chúng, rồi thành các tệp. - Hợp đồng tiêm. Một thành phần công bố các giá trị kết nối của nó thông qua
provides, và trình biên dịch chuyển chúng tới từng bên tiêu thụ thông quainject, xuyên qua các namespace, mà nhà phát triển không phải viết tên máy chủ. - Tham số theo môi trường. Một Aggregate công khai các tham số, và mỗi Release điền chúng cho môi trường của mình.
- Các manifest Kubernetes và chart Helm, được ghi theo từng ranh giới, với
aggrega buildvàaggrega inspect.
Cột mốc 2 — Một quy trình hoàn chỉnh
- Features kết xuất tài nguyên, và thông tin xác thực dưới dạng Features. Một Feature được gắn có thể kết xuất tài nguyên riêng, và một thông tin xác thực là một Feature như bất kỳ cái nào khác, được chuyển tới thành phần của nó dưới dạng biến môi trường hoặc tệp.
- Docker Compose, với một cầu nối chuyển tiếp các kết nối giữa các mạng Compose.
- Ba cách viết một Recipe, có thể kết hợp với nhau: bao bọc một chart, mô-đun hoặc tệp có sẵn (
source:), mô tả một container một lần dưới dạng Workload để mục tiêu tổng hợp (workload:), hoặc phát ra các tệp của riêng bạn (artifacts:). - Đầu ra tất định. Thứ tự của tác giả được giữ nguyên ở mọi nơi, nên đầu vào giống hệt nhau cho ra đầu ra giống hệt nhau đến từng byte.
- Một ngôn ngữ schema duy nhất. JSON Schema 2020-12, với cú pháp viết tắt YAML gọn nhẹ, các thư viện schema và ánh xạ có thể tái sử dụng, hợp đồng tham số có kiểu và các khẳng định liên trường.
- Features được gắn qua chú thích. Một Release hoặc một Aggregate gắn một Feature bằng cách viết một chú thích mà Manifest liên kết, với cùng đầu ra như khi gắn tường minh.
aggrega build --trace, ghi trạng thái trung gian của từng thành phần để gỡ lỗi.
Cột mốc 3 — Bản phát hành 0.9.0
Những gì 0.9.0 bổ sung:
- Năm mục tiêu, được kết xuất bởi plugin. Các manifest Kubernetes, chart Helm, Docker Compose, Terraform và CloudFormation đều được ghi bởi một plugin trình cung cấp WebAssembly tích hợp trong tệp nhị phân, nên một bản cài đặt mới có thể kết xuất ngoại tuyến; trình biên dịch ghi các tệp và không bao giờ chạy các công cụ. Trường
formcủa một Workload chọn bộ điều khiển mà nó trở thành: không trạng thái, có trạng thái, daemon, theo lịch hoặc một tác vụ chạy một lần. - Plugins cho mọi thứ đặc thù theo miền. Providers, chính sách, trình nhập, các bước quy trình và tiện ích mở rộng dòng lệnh đều là plugin WebAssembly, được viết bằng các bộ công cụ plugin cho Go, Rust và TypeScript. Host và plugin trao đổi dữ liệu qua một giao diện duy nhất có phiên bản, mã hóa bằng CBOR, được sinh từ một schema duy nhất cho cả ba ngôn ngữ.
- Quản trị. Một plugin chính sách được gắn vào một workspace sẽ kiểm tra mọi bản build: nó từ chối một đồ thị hoặc một tệp đã kết xuất vi phạm quy tắc, kèm cho biết cần sửa gì, hoặc cung cấp các nhãn và chú thích mà nhà phát triển không bao giờ phải gõ.
- Registry, lockfile và ký số. Các thực thể danh mục, kể cả Aggregates, được xuất bản lên và kéo về từ các registry OCI theo tên và phiên bản;
aggrega pullghim mọi phụ thuộc trong một lockfile, và các artifact được ký khi xuất bản và được xác minh khi kéo về. - Danh mục thư viện chuẩn và hub công khai của nó. Các Components cho tác tử, mô hình, gateway, kho dữ liệu, nhắn tin, khả năng quan sát, bảo mật và lưu trữ, được tổ chức theo nhãn loại, danh mục và năng lực, và được phục vụ từ
hub.aggrega.ai. aggrega import. Các plugin trình nhập soạn bản nháp các tệp Aggrega từ các dự án Langflow, Flowise, n8n, Dify, CrewAI, LangGraph, Google ADK, Microsoft Agent Framework, MCP và Docker Compose, chấm điểm từng ánh xạ dựa trên danh mục;--syncgiữ các bản nháp đồng bộ với nguồn của chúng.- Khởi đầu nhẹ nhàng. Một Release hoặc một Aggregate với một phạm vi duy nhất không cần ranh giới hay hệ thống con, và
aggrega scaffold,aggrega edit-document,aggrega validate,aggrega lintvàaggrega explainhỗ trợ vòng lặp soạn thảo. - Trình soạn thảo và trợ lý. Tiện ích mở rộng Visual Studio Code mang đến xác thực, điều hướng, hover, tự động hoàn thành và một đồ thị cấu trúc liên kết cho YAML của Aggrega thông qua
aggrega serve;aggrega mcpvà skill Aggrega cung cấp cho trợ lý AI cùng các công cụ đó. - Cài đặt bằng một lệnh trên Linux, macOS và Windows, hoặc thông qua Homebrew, Scoop và winget.
Cột mốc 4 — Mức độ áp dụng của người dùng, thêm đám mây và danh mục lớn hơn
- Mức độ áp dụng của người dùng. Những gì người dùng cho chúng tôi biết sẽ quyết định thứ tự công việc: bất cứ điều gì giúp việc áp dụng dễ dàng hơn sẽ được ưu tiên.
- Các trình cung cấp cho Azure và Google Cloud.
- Danh mục lớn hơn. Thêm nhiều thành phần, và các Recipes cho mọi mục tiêu, bao gồm cả các hiện thực Terraform và CloudFormation của các thành phần cơ sở.
- Lõi được kiểm chứng hình thức. Các thuộc tính cốt lõi của trình biên dịch được chứng minh dưới dạng định lý trong Lean: đầu vào giống hệt nhau cho đầu ra giống hệt nhau, không có gì được phát ra mà chưa được khai báo, và mỗi giá trị kết nối đến đúng những bên tiêu thụ mà các kết nối
usescủa nó chỉ định. Kiểm thử dựa trên thuộc tính bao phủ các plugin tích hợp sẵn.
Các hướng đi tiếp theo
- Chế độ xem trực tiếp kiến trúc của bạn. Đồ thị cấu trúc liên kết của trình soạn thảo và
--ir-graphđã hiển thị đồ thị mà trình biên dịch phân giải; một chế độ truyền luồng sẽ gửi đồ thị đó mỗi khi nó thay đổi, để một frontend theo kịp từng chỉnh sửa ngay khi nó diễn ra. - Workloads trên các dịch vụ container được quản lý. Một Workload được mô tả một lần sẽ được tổng hợp cho các dịch vụ container được quản lý của các mục tiêu đám mây, chẳng hạn Amazon ECS và Fargate, Google Cloud Run và Azure Container Apps.
- Thêm định dạng để nhập. Đặc tả OpenAPI, cho một API mà ứng dụng gọi hoặc cung cấp, và các tệp workload Score.
- Một Recipe được phác thảo từ Component của nó. Một Recipe khởi đầu đã đọc các giá trị của Component và cung cấp các giá trị kết nối của nó, để nhóm nền tảng hoàn thiện.
- Template thay đổi hình dạng tài liệu theo môi trường. Một khóa có mặt trong môi trường này và vắng mặt trong môi trường khác, bằng cách đánh giá template trước khi phân tích cú pháp tài liệu.
- Kết quả chính sách trong trình soạn thảo. Các kết quả của một plugin quản trị được hiển thị trong trình soạn thảo khi các tệp thay đổi, bên cạnh phần xác thực mà nó hiển thị hiện nay.