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.

Phân loại dữ liệu và kết hợp

Phân loại dữ liệu hợp nhất và các quy tắc kết hợp

Để thiết lập một lược đồ có thể dự đoán và loại bỏ ma sát nhận thức, nền tảng sử dụng đúng năm từ khóa được hiểu phổ quát và một cấu trúc YAML hoàn toàn dựa trên map (từ điển), với các map thay vì các mảng lồng nhau ở gốc cấu trúc.

1. Chuẩn map 5 từ khóa và sự đối xứng lược đồ toàn phần

Bộ từ vựng cấu trúc trực tiếp: Một quy tắc cơ bản của thiết kế lược đồ là các cấu trúc dữ liệu gốc phải là những từ khóa đơn lẻ mang tính cấu trúc. Mặc dù dùng các cụm từ tiếng Anh thông tục (như depends_on hay runs_within) có thể khiến một DSL YAML dễ đọc hơn với nhà phát triển, điều đó lại gây thêm độ phức tạp cấu trúc khi ánh xạ các khóa đó vào mẫu Go lập trình. Để duy trì ánh xạ biến trực tiếp 1:1 và ngăn sự phân mảnh của ngôn ngữ chuyên biệt miền (DSL), các lược đồ JSON của những thực thể danh mục cốt lõi (Component, Feature) thể hiện sự đối xứng cấu trúc gần như toàn phần, dựa trên cùng một tập từ khóa cấu trúc cốt lõi được dùng trên mọi khe thể hiện được soạn thảo. Các Features thông tin xác thực (gắn nhãn feature.aggrega.ai/kind: secret) có chung đúng mô hình này — không có lược đồ riêng cho secret.

  • parameters (Hợp đồng môi trường toàn cục)
    • Phạm vi: Được định nghĩa ở gốc của Aggregate; được Release (CI/CD) đáp ứng nội tuyến dưới parameters: hoặc qua parameters: { $import: <path> } trỏ tới một tệp tham số bên ngoài.
    • Ý nghĩa: Các đối số bên ngoài làm thay đổi động trạng thái nhận thức hoặc logic của ứng dụng giữa các môi trường (ví dụ: đổi workers: 2 thành workers: 10). Hỗ trợ một hợp đồng có kiểu (xem data-pillars để biết cú pháp đầy đủ của hợp đồng có kiểu) được xác thực trước khi nội suy. Với các quy trình GitOps giữ giá trị tham số trong một tệp riêng, Release dùng dạng $import:; trình biên dịch tải nội dung tệp và thay thế map nội tuyến parameters:. Việc xếp lớp nhiều tệp được biểu đạt qua các chuỗi extends: của Release.
  • values (Ý định nhận thức - Do nhà phát triển sở hữu)
    • Phạm vi: Được dùng thống nhất bên trong components và các phần đính kèm features của chúng trong Aggregate, bao gồm cả các Features thông tin xác thực.
    • Ý nghĩa: Trạng thái nhận thức cốt lõi, logic nghiệp vụ và cấu hình vận hành. Mờ đục đối với trình biên dịch Go nhưng được xác thực nghiêm ngặt bởi khai báo schema: hợp nhất của danh mục (dạng rút gọn hoặc JSON Schema 2020-12).
  • uses (Cấu trúc liên kết - Trạng thái khai báo)
    • Phạm vi: Được dùng thống nhất bên trong components và các phần đính kèm features của chúng trong Aggregate, bao gồm cả các Features thông tin xác thực.
    • Ý nghĩa: Một phát biểu khai báo về sự thật, định nghĩa các cạnh mạng và phụ thuộc (ví dụ: “Tác tử này sử dụng cơ sở dữ liệu này”). Được trình biên dịch Go phân tích gốc để vẽ đồ thị biểu diễn trung gian (IR). Được xác thực bởi khai báo usesSchema hợp nhất của danh mục để áp đặt an toàn kiểu giữa các nút.
  • infra (Thực tại vật lý - Do Ops sở hữu)
    • Phạm vi: Được dùng thống nhất bên trong components của một ranh giới và các phần đính kèm features của chúng trong Release.
    • Ý nghĩa: Dấu chân vật lý và kích thước cơ học được tiêm vào trong quá trình Late Binding (ví dụ: cpu_limit: "4", port: 5432). Các thể hiện thành phần của Aggregate và các phần đính kèm features của chúng không có trường infra và, kết hợp với additionalProperties: false, từ chối infra khi xác thực lược đồ. Được xác thực bởi khai báo schema: hợp nhất của danh mục.
  • inject (Hợp đồng chuyển giao - Lệnh mệnh lệnh)
    • Phạm vi: Được dùng trên một thể hiện thành phần, bên trong các định nghĩa đích tường minh trong uses và trên các features được đính kèm, bao gồm cả các Features thông tin xác thực.
    • Ý nghĩa: Một lệnh mệnh lệnh, tường minh, quy định ý định của việc chuyển giao (ví dụ: “Trình biên dịch, hãy tiêm giá trị đã ánh xạ này như một biến môi trường”). Nó thiết lập hợp đồng trừu tượng (env, file, arg hoặc các cơ chế tùy chỉnh) cho một đầu ra vật lý, một endpoint đã phân giải hoặc một thông tin xác thực đã truy xuất, trong khi cơ chế vật lý về việc chính xác như thế nào phép gắn kết đó được thực hiện được ủy thác hoàn toàn cho Recipe Ops bên dưới. Mỗi cơ chế là một danh sách các mục ([{ in: API_HOST, from: "host" }]), mỗi mục đặt tên cho định danh cục bộ của nó bằng in: và mang đúng một trong hai from: hoặc value:.
  • .context (Đường ống siêu dữ liệu chung)
    • Phạm vi: Được trình biên dịch tiêm một cách âm thầm vào các mẫu Recipe của Ops.
    • Ý nghĩa: Mang những gì trình biên dịch đã tập hợp cho nút từ phần còn lại của đồ thị (như .context.uses), được truyền thẳng tới công cụ tạo mẫu của Ops.

Thực tế của ánh xạ 1:1

Bằng cách thay các giới từ thông tục bằng các từ khóa hạ tầng nghiêm ngặt, điều này đạt được ánh xạ 1:1 trực tiếp. Kỹ sư Ops không phải dịch ngữ pháp; họ chỉ cần tham chiếu đúng các khóa mà nhà phát triển đã viết.

Hình dạng cấu trúc: map ở gốc, mảng trong payload. Các khối cấu trúc liên kết gốc — components, features, aggregates, subsystems, boundaries — là các map YAML với khóa do người dùng soạn đóng vai trò ID thể hiện ổn định. Mảng không hợp lệ tại các vị trí này; khóa map là danh tính mà trình biên dịch dùng cho tham chiếu chéo (target: my-db), xây dựng nút đồ thị và phân giải Manifest. Bên trong các khối payload mờ đục (values, infra, parameters), mảng được cho phép hoàn toàn — nhà phát triển có thể viết tools_allowed: ["sql", "web"] hoặc hostnames: ["stripe.com", "twilio.com"] bên trong values của một Component. Lược đồ Aggregate khai báo các khối payload này là additionalProperties: true, nên chúng mờ đục đối với trình biên dịch Go và được xác thực hoàn toàn bởi khai báo schema: nhúng trong danh mục. Điều này đặt sự biến động của framework (hình dạng API AI mới, định dạng payload cloud-native mới) vào trong miền danh mục, nơi nó có thể phát triển độc lập, trong khi trình biên dịch Go chỉ làm việc với các khóa có thể định địa chỉ ở gốc cấu trúc.

2. Các luồng thông tin: Ai, khi nào và để làm gì?

Để ngăn xung đột không gian tên trong mẫu và việc vô tình rò rỉ cấu hình hạ tầng vật lý vào logic nhận thức của ứng dụng, kiến trúc tách dữ liệu một cách tường minh thành sáu luồng riêng biệt:

  • Luồng 1: Tiêm môi trường (parameters): Pipeline CI/CD tiêm các thực tại triển khai. Trình biên dịch xác thực từng giá trị do Release cung cấp theo hợp đồng có kiểu parameters:, rồi nội suy các biến mẫu Go đã phân giải trước khi chạy bước xác thực lược đồ values: ở hạ nguồn.
    • Cách dùng được khuyến nghị: parameters được dành cho logic nhận thức của ứng dụng thay đổi giữa các môi trường (ví dụ: LOG_LEVEL=debug, ENABLE_BETA=true). Kích thước vận hành và các vấn đề hạ tầng vật lý — bản sao, giới hạn CPU, ARN của AWS, tên máy chủ ingress — đi qua khối infra của Release và các lớp phủ ranh giới, giữ cho Aggregate của nhà phát triển tập trung vào ý định ứng dụng.
    • Lối thoát thực dụng: Đối với các nhóm nhỏ hơn, tạo mẫu nhanh hoặc các tích hợp CI/CD cũ nơi việc tách biệt nghiêm ngặt là không thực tế, parameters có thể mang cấu hình môi trường toàn cục xuyên suốt ngăn xếp. Trình biên dịch chấp nhận bất cứ thứ gì vượt qua xác thực lược đồ; khuyến nghị ở trên là một khế ước xã hội, không phải quy tắc của trình biên dịch.
  • Luồng 2: Ý định nhận thức của ứng dụng (values trong Components): Định nghĩa logic nội tại của ứng dụng. Khai báo schema: của Component (dạng rút gọn hoặc JSON Schema 2020-12) cung cấp kiểm tra kiểu và xác thực nghiêm ngặt cho payload này, mang lại phản hồi “Shift-Left” tức thì cho nhà phát triển và bảo đảm các cấu hình được yêu cầu khớp với API hạ tầng bên dưới.
  • Luồng 3: Ý định vận hành của Feature (values trong Features): Trong Aggregate, nhà phát triển yêu cầu các năng lực hạ tầng có hành vi là ý định ứng dụng, và truy vấn thông tin xác thực có kiểu nghiêm ngặt, mà không sửa đổi mã nội bộ. Một Feature có mọi đầu vào đều mang tính vận hành thì không mang values của nhà phát triển: bộ phận vận hành đính kèm nó trong Release, cùng với infra của nó (Luồng 4).
  • Luồng 4: Kích thước hạ tầng vật lý (infra): Bỏ qua hoàn toàn nhà phát triển, kích thước infra vật lý được chiếu một cách tường minh từ Release theo môi trường trực tiếp lên các Components có phạm vi cục bộ và các Features được đính kèm của chúng, bao gồm cả các Features thông tin xác thực. Để tránh xung đột xác thực lược đồ đóng do phát tán nguyên văn các từ điển, kích thước infra được khoanh vùng nghiêm ngặt vào thành phần tường minh nhắm tới nó. Điều này giữ giới hạn tính toán, bản sao và yêu cầu tài nguyên cơ học trong miền Ops.
  • Luồng 5: Chú thích phân tầng (Siêu dữ liệu ngữ cảnh): Dữ liệu ngữ cảnh rộng (như miền vận hành, không gian tên hoặc mã thanh toán) được xử lý qua chú thích phân tầng, ngăn ô nhiễm do phát tán infra. Chúng được tách riêng vào các vùng theo nguồn gốc, và mục đích sử dụng dự kiến của từng vùng dưới đây là một khế ước xã hội: một template Recipe có thể đọc cả ba, và trình biên dịch không áp đặt sự tách biệt này (xem labels-and-annotations):
    • .context.annotations.release (Ranh giới Miền 4): Chỉ được dùng để chi phối các thực tại vật lý. Ops định tuyến tường minh các chú thích này vào các trường infra cục bộ nghiêm ngặt qua mẫu Go (ví dụ: ánh xạ một không gian tên theo vùng vào một thành phần tính toán).
    • .context.annotations.aggregate (Hệ thống con Miền 1): Chỉ được dùng để chi phối logic nhận thức và vận hành. Các chú thích này được định tuyến tường minh vào payload values của thành phần (ví dụ: truyền phân tầng mã thanh toán của nhóm xuống một cấu hình ứng dụng).
    • .context.annotations.catalog (Danh mục Miền 2): Các đặc tính nội tại bất biến do kiến trúc sư soạn, chủ yếu dùng cho việc đánh giá chính sách Wasm theo chương trình.
  • Luồng 6: Đường ống siêu dữ liệu (.context): Áp dụng các yêu cầu doanh nghiệp toàn cục (thẻ SOC2) trực tiếp vào các mẫu hạ tầng vật lý.

3. Trừu tượng hóa mạng: Quy ước “Zero-Port”

  • Thực hành tốt nhất: Nhà phát triển nên bỏ cổng khỏi Aggregate. Recipe Ops xử lý định tuyến nội bộ một cách động.
  • Lối thoát: Nếu mã nội bộ của một ứng dụng không thể thay đổi, kiến trúc sư nền tảng sẽ phơi bày tường minh một trường port trong khai báo schema:. Ghi chú kiến trúc: Quy ước “Zero-Port” là ví dụ nổi bật nhất cho sự tách biệt mối quan tâm rộng hơn của nền tảng. Đúng triết lý ấy — trừu tượng hóa cơ chế vật lý khỏi nhà phát triển — áp dụng cho yêu cầu CPU, giới hạn bộ nhớ, miền vận hành và kích thước đĩa. Bất cứ khi nào một ràng buộc hạ tầng vật lý buộc phải rò rỉ vào payload ứng dụng của nhà phát triển (do mã cũ hoặc yêu cầu phần cứng nghiêm ngặt), nó luôn phải được chi phối bởi một “lối thoát” tường minh trong khai báo schema: của kiến trúc sư, chính là khai báo mà payload của nhà phát triển được xác thực theo.

Tên “Zero-Port” đại diện cho quy ước này; nguyên tắc này khái quát hóa cho bất kỳ ràng buộc hạ tầng vật lý nào mà một ứng dụng cũ mã hóa cứng. Lược đồ dưới đây dùng tcp_keepalive_seconds làm ví dụ minh họa — một thông số thời gian của kernel/mạng mà ứng dụng mong đợi ở tầng socket — vì nó nằm rõ ràng trên trục rò rỉ infra.

Lược đồ (Miền 2):

values:
image: { type: string, required: true }
# The architect explicitly allows the developer to declare a hardcoded constraint
tcp_keepalive_seconds: { type: integer, min: 10, max: 300 }

YAML của nhà phát triển (Miền 1):

components:
legacy-payment-engine:
type: core/java-tomcat:1.0.0
values:
image: "corp/payments:v4"
tcp_keepalive_seconds: 120 # The infrastructure must adapt to the app, not vice versa

Hành vi của trình biên dịch: Trình biên dịch Go truyền tcp_keepalive_seconds: 120 vào đồ thị IR. Sau đó Recipe Ops đọc {{ .values.tcp_keepalive_seconds }} để cấu hình đặc tả pod Kubernetes hoặc thời gian chờ nhàn rỗi của bộ cân bằng tải của nhà cung cấp đám mây, thu hẹp thành công khoảng cách với hệ thống cũ mà không vi phạm lược đồ.

4. Hợp đồng tiêm và map được phân giải trước

Trong năm từ khóa cấu trúc, inject có hình dạng khác với các từ khóa anh em. parameters, values, uses và infra là trạng thái khai báo — nhà phát triển viết các sự thật về việc ứng dụng là gì và phụ thuộc vào đâu. inject là một lệnh mệnh lệnh — nhà phát triển quy định cách một giá trị cần được chuyển tới container đang chạy, ánh xạ các nguồn dữ liệu trừu tượng (các khóa provides của một đích, các giá trị riêng của thành phần, phản hồi vault của một Feature thông tin xác thực) vào các cơ chế chuyển giao cụ thể (env, file, arg hoặc một cơ chế tùy chỉnh mà Component khai báo).

Sự tách rời này mang tính cấu trúc. Aggregate của nhà phát triển nói “hãy tiêm host cơ sở dữ liệu dưới dạng biến môi trường DB_HOST” mà không nêu địa chỉ vật lý của cơ sở dữ liệu, đường dẫn vault của kho secret hay định dạng tên máy chủ của nhà cung cấp đám mây. Recipe Ops nhận chuỗi đã phân giải qua .context.inject và sử dụng nó mà không phải soạn chuỗi tra cứu.

Map được phân giải trước. Trong quá trình kết xuất, trình biên dịch phân giải mọi nguồn tiêm — các literal tự tiêm và tham chiếu from: tới provides của chính thành phần, các tham chiếu chéo thành phần qua uses[].inject, các chặn bắt injectMapping của FeatureRecipe — thành một từ điển phẳng duy nhất tại .context.inject. Khi mẫu valuesMapping của Recipe cơ sở chạy, mọi khóa tiêm đều đã mang giá trị chuỗi cuối cùng. Các Recipes lặp trực tiếp trên map ({{ range $k, $v := .context.inject.env }}) mà không cần duyệt chuỗi phân giải.

Tên mà nhà phát triển đặt cho các giá trị riêng của thành phần. Khi Component khai báo spec.inject, khối inject: riêng của nhà phát triển chọn các tên mà dưới đó các giá trị riêng và provides của thành phần đi tới đường ống phân phối. Trình biên dịch cho Recipe biết, tại .context.self_inject, một giá trị riêng duy nhất mà template của mỗi mục đọc — theo từng cơ chế, mỗi tên được ánh xạ tới provides.<key>, tới values.<key> đối với một template chỉ đọc đúng một giá trị riêng và không gì khác, hoặc tới một chuỗi rỗng — theo dạng mà tên của một kết nối có tại .context.uses.<alias>.inject. Quy ước của danh mục thư viện chuẩn đối với một Recipe chạy image của nhà phát triển là coi các tên mà nó lẽ ra sẽ chọn cho các giá trị riêng của thành phần là giá trị mặc định, và chỉ cung cấp một giá trị riêng dưới tên mặc định của nó khi chưa có mục nào ánh xạ tới giá trị đó. Đó là một quy ước của danh mục, không phải một quy tắc của trình biên dịch: một danh mục doanh nghiệp có thể cung cấp các giá trị riêng của các thành phần của mình theo bất kỳ cách nào nó chọn. Trình biên dịch đọc bảng ánh xạ từ văn bản mà nhà phát triển đã viết và không gán ý nghĩa nào cho các tên.

Đặc tả đầy đủ của hợp đồng tiêm — ngữ nghĩa ngữ cảnh trạng thái kép, quy tắc xung đột khóa, mô hình chặn bắt của FeatureRecipe và các ví dụ minh họa — nằm trong topology-triad.

5. Công cụ tạo mẫu (DX cho Ops)

Kỹ sư Platform Ops soạn các mẫu chuyển đổi và cần toàn bộ sức mạnh của việc tạo mẫu hạ tầng tiêu chuẩn mà không cần ngôn ngữ mẫu độc quyền. Các mẫu của Aggrega là Go text/template:

  • Không có chuỗi “ma thuật”: Trình biên dịch giữ nguyên chính xác các khóa map của nhà phát triển. Ops truy cập các tính năng một cách an toàn qua cách đánh chỉ mục map chuẩn của Go: {{ (index .features "public-route").infra.hostname }}.
  • Thư viện Sprig: Trình biên dịch đăng ký gốc thư viện Sprig vốn là chuẩn của Helm, cung cấp quyền truy cập ngay lập tức vào các pipeline như | default, | quote và | toYaml.
  • Các đoạn MappingLibrary: Một đoạn ánh xạ được nhiều Recipes tái sử dụng nằm trong một MappingLibrary và được kéo vào mỗi Recipe bằng $import:. Các hàm trợ giúp template chart của Helm (include, tpl, required, warn) không được đăng ký; sprig-functions liệt kê những gì được đăng ký.

6. Quy tắc kết hợp: Aggregates, hệ thống con và Components

  • Nhóm logic (mảng subsystems): Nhà phát triển có thể áp dụng siêu dữ liệu logic (quyền sở hữu nhóm, nhãn tuân thủ) và các tính năng xuyên suốt cho hàng chục thành phần cùng lúc bằng subsystems. Hệ thống con hoạt động như các thư mục đệ quy trên mặt phẳng logic/ý định, truyền phân tầng annotations xuống vùng .context.annotations.aggregate và đính kèm tính năng vào mọi thành phần được chứa mà không áp đặt ranh giới vật lý. Các tính năng cấp hệ thống con tuân theo cùng lược đồ với tính năng cấp thành phần (hỗ trợ type, values, uses, inject) vì chúng thuộc Miền 1 (Ý định của nhà phát triển). Trình biên dịch làm phẳng các tính năng của hệ thống con vào danh sách tính năng của từng thành phần được chứa khi hoàn tất đồ thị, đặt chúng sau các tính năng riêng của thành phần và trước mọi tính năng được Release đính kèm trong thứ tự thực thi.
aggregate.yaml
subsystems:
finance-module:
annotations:
"billing.corp.com/team": "payments"
features:
audit-logging:
type: core/audit-logger:1.0.0
values: { log_level: "verbose" }
components:
ledger-api:
type: core/python-worker:1.0.0
ledger-db:
type: core/postgres:1.0.0
  • Các Aggregates tổng hợp ĐƯỢC HỖ TRỢ (Mẫu mô-đun): Các Aggregates đóng vai trò vừa là Aggregate gốc mà một Release dựng vừa là các mô-đun có thể tái sử dụng. Một Aggregate cha có thể khai báo một Aggregate con giống hệt như một thành phần, truyền parameters xuống nó. Để tránh liên kết chặt, các Aggregates con phơi bày một hợp đồng exportedComponents:, thiết lập một tên giao diện công khai ổn định. Cha chỉ tiếp cận các thành phần của mô-đun thông qua giao diện này: một đích uses: nêu tên mô-đun và một trong các bí danh được xuất của nó, và trình biên dịch nối cạnh tới thành phần nội bộ mà bí danh đó chỉ định, còn một đích đi vào bên trong mô-đun bằng bất kỳ tên nào khác sẽ dừng bản dựng, nêu tên mô-đun và các bí danh mà nó xuất. Bản thân một mô-đun có thể xuất lại thành phần đã xuất của một mô-đun lồng nhau dưới tên giao diện của chính nó — tùy chọn đổi tên — và trình biên dịch phân giải chuỗi xuất lại đó một cách bắc cầu tới nút nội bộ bên dưới, nên các mô-đun kết hợp ở bất kỳ độ sâu nào mà cha không cần biết đích được lồng sâu đến đâu. Một đích không phân giải được thành nút nội bộ nào vẫn dừng bản dựng một cách rõ ràng, và một chuỗi xuất lại khép vòng về chính nó sẽ bị từ chối thay vì bị lần theo mãi mãi.
child-database-module.yaml
apiVersion: aggrega.ai/v1beta1
kind: Aggregate
metadata:
name: child-database-module
version: 1.0.0
spec:
components:
internal-pg-primary:
type: core/postgres:1.0.0
exportedComponents:
# The Public Contract (Written once by the module author)
primary_db: "internal-pg-primary"
parent-app.yaml
apiVersion: aggrega.ai/v1beta1
kind: Aggregate
metadata:
name: parent-app
version: 1.0.0
spec:
aggregates:
finance-db-subsystem:
type: my-catalog/child-database-module:1.0.0
components:
billing-api:
type: core/python-worker:1.0.0
uses:
databases:
- finance-db-subsystem.primary_db
  • Components không thể chứa thành phần con: Components là các khối xây dựng nguyên tử. Việc kết hợp diễn ra ở cấp Aggregate thông qua hệ thống con và aggregate con. Nếu một ứng dụng cần nhiều container vật lý (như một API + một sidecar), sự lồng nhau vật lý đó nằm bên trong mẫu Recipe Ops, không phải trong định nghĩa Component.

  • Một dịch vụ mạch lạc cho mỗi Component — ranh giới khối lượng công việc đơn: Một Component mô hình hóa một dịch vụ mạch lạc — một dịch vụ được phơi bày duy nhất, hoặc (các) khối lượng công việc của một dịch vụ cùng các khối lượng công việc trợ giúp chỉ dùng nội bộ của nó. Nhãn component.aggrega.ai/type của nó đặt tên cho hình dạng vận hành của dịch vụ đó. Nhiều khối lượng công việc vật lý bên trong một Component là ổn khi chúng tạo thành một sản phẩm mạch lạc không có phần nào có thể dùng độc lập: một dịch vụ có chart chạy một controller cộng một webhook cộng một injector vẫn là một Component. Tiêu chí không phải là đa khối lượng công việc; mà là khả năng sử dụng độc lập.

    Ranh giới được vạch ở chỗ một gói chứa thứ mà một thành phần khác có thể sử dụng (use) một cách có ý nghĩa một mình — đặc biệt là hạ tầng bên ngoài như cơ sở dữ liệu, bộ nhớ đệm hoặc message broker mà Aggrega đã mô hình hóa thành Component riêng. Một gói như vậy không phải là một Component; nó là một Mô-đun aggregate con — mẫu spec.aggregates + exportedComponents được trình bày ở trên — kết hợp một Component cho mỗi dịch vụ, để mỗi dịch vụ là một nút có thể định địa chỉ với kiểu riêng, các cạnh riêng và bề mặt chính sách cùng mở rộng quy mô riêng.

    Phương pháp kinh nghiệm, được phát biểu thành một quy tắc rõ ràng: Chart có chứa thứ gì mà một thành phần khác có thể sử dụng một cách có ý nghĩa một mình, hoặc thứ mà Aggrega đã có Component cho nó không? Nếu có, hãy mô hình hóa nó thành một stack — một Mô-đun aggregate con kết hợp các Components theo từng dịch vụ. Nếu nó chỉ phục vụ đúng một dịch vụ này, hãy mô hình hóa nó thành một Component.

    Gói toàn bộ một sản phẩm đa dịch vụ thành một Component mờ đục duy nhất là một phản mẫu đã được ghi nhận. Trình biên dịch không có quan điểm riêng và sẽ chấp nhận điều đó — nó kết xuất bất cứ thứ gì vượt qua xác thực lược đồ — nhưng thư viện chuẩn lại kết hợp các Components theo từng dịch vụ vào một Mô-đun, vì một lớp bọc nguyên khối che giấu các dịch vụ có thể mô hình hóa độc lập khỏi cấu trúc liên kết, khỏi bộ chọn và khỏi chính sách cũng như việc mở rộng quy mô theo từng dịch vụ. Kỷ luật về độ chi tiết này là một khế ước xã hội — xem ../language-reference/vocabulary/social-contracts.md (độ chi tiết của Component).

7. Phạm vi mặc định — tiết lộ dần việc nhóm

subsystems (trong Aggregate) và boundaries (trong Release) là các cấu trúc nhóm, nhưng nhà phát triển không phải khai báo chúng ngay từ đầu. Mỗi thực thể cung cấp hai dạng viết, và chúng loại trừ lẫn nhau: viết các thành phần được nhóm dưới các phạm vi có tên, hoặc viết các thành phần trực tiếp ở cấp cao nhất — không bao giờ cả hai cùng lúc. Một tài liệu khai báo cả components cấp cao nhất lẫn các phạm vi có tên sẽ dừng khi tải với một lỗi phong bì.

Với dạng phẳng (components cấp cao nhất), trình biên dịch tổng hợp một phạm vi default thực sự khi tải và gộp các thành phần cấp cao nhất vào đó, để mọi lượt xử lý phía sau đều thấy một cấu trúc đồng nhất có phạm vi. Phạm vi được tổng hợp không phải là một vùng chứa ẩn: đó là một nút thực sự trong IR, được đánh dấu nguồn gốc, có thể phân biệt với một phạm vi mà nhà phát triển đặt tên tường minh là default. Nó chỉ bị ẩn ở nơi tác giả đọc đường dẫn — chẩn đoán và định địa chỉ hiển thị đường dẫn dạng gốc .spec.components[…] mà nhà phát triển thực sự đã viết.

  • Aggregate phẳng (các thành phần cấp cao nhất): Các thành phần được viết dưới spec.components mà không có subsystems. Trình biên dịch gộp chúng vào một hệ thống con default được tổng hợp khi tải. Chú thích phạm vi hệ thống con và tính năng cấp hệ thống con chỉ áp dụng cho các hệ thống con được khai báo; dạng phẳng không mang cái nào.
  • Release phẳng (các thành phần cấp cao nhất): Các thành phần được viết dưới spec.components mà không có boundaries. Trình biên dịch gộp chúng vào một ranh giới default được tổng hợp có đầu ra phẳng — các artifact nằm trực tiếp dưới dist/ (theo từng nhà cung cấp: dist/compose/, dist/helm/, …), không có đoạn tên ranh giới. Đây là trường hợp đơn giản nhất: aggrega build trên một đích Compose phẳng hoặc một cụm duy nhất mà không cần đặt tên ranh giới. (Một ranh giới mà nhà phát triển khai báo và đặt tên default là một ranh giới có tên thông thường và, khi không có directory: riêng, xuất ra dist/boundaries/default/ như mọi ranh giới khác.)
  • Lộ trình nâng cấp: Khi một kiến trúc phẳng phát triển thành kiến trúc cần nhóm (các namespace khác nhau, các nhóm logic riêng biệt, triển khai nhiều ranh giới), nhà phát triển chuyển các thành phần cấp cao nhất vào subsystems tường minh, hoặc Ops đưa vào boundaries tường minh. Vì hai dạng loại trừ lẫn nhau, đây là việc chuyển từ dạng phẳng sang dạng có phạm vi — không phải trộn cả hai — và danh tính nút được giữ nguyên qua quá trình chuyển đổi.

Lý do là tiết lộ dần: bắt buộc nhóm cho các trường hợp sử dụng đơn giản (một bản demo một dịch vụ, một nguyên mẫu cục bộ nhanh) tạo ra ma sát không cần thiết. Bài kiểm tra làm quen “từ con số không đến chạy được trong 10 phút” đòi hỏi nhà phát triển có thể viết một Aggregate tối thiểu với một thành phần, một Manifest và một Release và nhận được đầu ra hoạt động mà không cần hiểu trước về hệ thống con hay ranh giới. Phạm vi mặc định là lối vào; các phạm vi được khai báo là nơi kiến trúc hướng tới khi nó lớn lên.

Các mục dưới đây gồm một mẫu khuyến nghị và năm ràng buộc. Các lược đồ áp đặt Ràng buộc 4 và 5 — Release không có khối values, và thực thể thành phần của một Aggregate không có khóa labels; các mục còn lại là những quy ước mà trình biên dịch không kiểm tra.

  • Mẫu được khuyến nghị: nâng tham số qua chuỗi template

    • Ví dụ: Nhà phát triển viết workers: {{ .parameters.env_workers }} trong khối values của mình, không đặt trong dấu ngoặc kép, để giá trị đến dưới dạng số nguyên như đã được khai báo.
    • Lý do: Nếu Aggregate khai báo env_workers là một tham số có kiểu (type: integer), trình biên dịch trước tiên xác thực giá trị do Release cung cấp theo hợp đồng. Việc xác thực hợp đồng tham số diễn ra trước nội suy; nội suy diễn ra trước việc xác thực lược đồ values: bao quanh. Điều này giữ được khả năng tái sử dụng của Aggregate: Ops cung cấp số nguyên qua parameters: của Release, trình biên dịch xác thực nó theo khai báo parameters: có kiểu, thay giá trị đã phân giải vào tài liệu, và khai báo schema: của Component xác thực thành công số nguyên thu được.
  • Ràng buộc 1: Thông tin xác thực là phần đính kèm, không phải giá trị

    • Mẫu không được khuyến khích: Nhà phát triển viết values: { password: "123" } trên một thành phần.
    • Lý do: quy ước của thư viện chuẩn là thông tin xác thực được yêu cầu dưới dạng phần đính kèm trong features:, nêu tên một type Feature thông tin xác thực (loại được gắn nhãn feature.aggrega.ai/kind: secret) và dùng chính values của phần đính kèm đó để mô tả truy vấn tới kho bí mật. Đây là một quy ước, không phải một kiểm tra của trình biên dịch — trình biên dịch không diễn giải ý nghĩa của một lá values và sẽ mang nguyên văn một giá trị literal nội tuyến. Chính bề mặt đính kèm mới làm cho dạng được viết đúng trở nên sẵn có và có kiểu.
  • Ràng buộc 2: Components không phụ thuộc vào năng lực

    • Mẫu không được hỗ trợ: Kiến trúc sư viết aws_instance_type: string trong khai báo schema: của Component.
    • Lý do: Theo quy ước, Components không phụ thuộc vào năng lực. Các đích phần cứng vật lý nằm trong Recipes của Ops hoặc trong các chú thích .context chung, không nằm trong logic nhận thức cốt lõi của ứng dụng.
  • Ràng buộc 3: Logic điều kiện trên siêu dữ liệu

    • Mẫu không được hỗ trợ: Ops viết {{ if eq .context.labels.gpu "true" }} trong một Recipe để thay đổi căn bản chiến lược triển khai.
    • Lý do: Kênh .context bỏ qua việc xác thực schema: theo từng trụ cột. Dựa vào các nhãn chưa được xác thực cho logic hạ tầng cốt lõi khiến nền tảng trở nên mong manh. Đối tượng .context mang việc gắn thẻ siêu dữ liệu (ví dụ: thanh toán, SOC2); định tuyến cấu trúc thuộc về các trụ cột được lược đồ xác thực.
  • Ràng buộc 4: Release không thể ghi đè giá trị của nhà phát triển

    • Mẫu không được hỗ trợ: Ops cố gắng ghi đè logic nhận thức của nhà phát triển (ví dụ: đổi workers: 4 thành workers: 10) từ Release.
    • Lý do: Aggregate là nguồn sự thật duy nhất cho ý định của nhà phát triển. Nếu một giá trị được mã hóa cứng trong Aggregate, nó bất biến giữa các môi trường. Nếu một giá trị phải thay đổi theo môi trường, nhà phát triển dùng cách nâng tham số. Lược đồ Release thực thi điều này bằng cách cấm các khối values, giới hạn Ops ở việc đáp ứng hợp đồng parameters và định nghĩa infra vật lý.
  • Ràng buộc 5: Nhãn cấp phiên bản trên Aggregate

    • Mẫu không được hỗ trợ: Nhà phát triển viết labels: {} trên một phiên bản thành phần bên trong Aggregate.
    • Lý do: Nhãn là các đặc điểm bất biến cấp danh mục do kiến trúc sư nền tảng viết — danh tính ngữ nghĩa mà các công cụ chính sách và bộ chọn đọc. Release định tuyến các thành phần tới ranh giới qua việc nhắm ID tường minh dựa trên map (components: { "my-agent": {} }), giúp giữ khả năng lồng infra và ghi đè tính năng theo từng thành phần mà không trộn quyền tác giả nhãn vào Aggregate của nhà phát triển.

9. Vành đai bảo mật & các rào chắn egress tường minh (đích ngoài vành đai)

Không ứng dụng nào tồn tại trong chân không. Một kiến trúc Aggrega đã biên dịch biểu diễn một đồ thị được ánh xạ chặt chẽ. Tuy nhiên, các hệ thống AI hiện đại liên tục tương tác với các thực thể bên ngoài vành đai đã biên dịch này — chẳng hạn LLM SaaS công khai (Anthropic, OpenAI), API công khai chung (Stripe, Twilio) hay các cơ sở dữ liệu brownfield kế thừa (Oracle tại chỗ).

Để tích hợp an toàn các hệ thống bên ngoài này, Aggrega tách biệt nghiêm ngặt ranh giới bảo mật khỏi cơ chế thực thi. Ranh giới bảo mật được điều chỉnh bởi quy tắc Component phổ quát và rào chắn egress tường minh.

1. Quy tắc Component phổ quát

Nếu một ứng dụng tương tác với một thực thể — dù đó là cơ sở dữ liệu cục bộ, tài nguyên đám mây được quản lý, LLM SaaS hay endpoint API công khai chung — thực thể đó PHẢI được khai báo là một Component riêng biệt trong Aggregate. Quy tắc này là một quy ước: trình biên dịch không thể thấy một lệnh gọi mà ứng dụng thực hiện, nên không có gì kiểm tra nó.

Bằng cách coi các API SaaS bên ngoài và cơ sở dữ liệu kế thừa là các nút hạng nhất trong đồ thị biểu diễn trung gian (IR), nhà phát triển có thể gắn cấu hình proxy Zero-Trust trực tiếp vào lệnh gọi đi ra. Ví dụ, khi mô hình hóa API Stripe thành một nút riêng biệt, nhà phát triển có thể gắn một tính năng header-injector vào nó, bảo đảm cấu hình được tạo ngăn tác tử gọi giữ token API thô trong bộ nhớ của chính nó.

2. Rào chắn egress tường minh (tuân thủ hạ tầng)

Thay vì dựa vào logic trình biên dịch được mã hóa cứng để quản lý egress mạng, Aggrega ủy thác hoàn toàn bảo mật vành đai cho các công cụ chính sách không phụ thuộc của doanh nghiệp và các plugin kết xuất Wasm. Điều này bảo đảm các cấu hình được tạo tuân thủ nghiêm ngặt các phê duyệt egress tường minh.

  • Móc danh mục (Miền 2): Khi kiến trúc sư định nghĩa một thành phần SaaS công khai (ví dụ: core/external-service), họ gắn cho nó một nhãn doanh nghiệp bất biến (ví dụ: security.enterprise.com/zone: "untrusted-external").
  • Rào chắn chính sách (thời điểm biên dịch): Trước khi bất kỳ cấu hình nào được tạo, công cụ chính sách OPA hoặc Kyverno đánh giá đồ thị. Doanh nghiệp viết một quy tắc đơn giản: “Nếu một nút nội bộ kết nối tới một nút được gắn nhãn untrusted-external, ID của nút đích đó phải được liệt kê tường minh trong mảng parameters.approved_egress của môi trường.” Nếu nhà phát triển cố định tuyến dữ liệu tới một đích bên ngoài chưa được phê duyệt, công cụ chính sách sẽ dừng bản dựng.
  • Tạo cấu hình (lúc kết xuất): Nếu chính sách thông qua, quy tắc egress được kết xuất từ những gì người vận hành đã đính kèm. Feature core/egress-allowlist, được đính kèm vào thành phần gọi trong Release, kết xuất trên helm một Kubernetes NetworkPolicy cho mỗi workload mà thành phần đó kết xuất, chỉ cho phép egress tới các pod của chính nó, tới các pod của các đích thuộc các cạnh uses của nó trên những cổng mà các pod đó khai báo, tới DNS của cụm, và tới các dải địa chỉ mà phần đính kèm liệt kê cho một đích mà cụm không chạy, chẳng hạn một API SaaS công khai. Bản dựng dừng lại trừ khi Release xác nhận, bằng infra.control_plane_present: true, rằng plugin mạng của cụm thực thi chính sách mạng, và dừng lại nêu tên bất kỳ kết nối bên ngoài nào như vậy không có dải địa chỉ được liệt kê; trên compose, vốn không có chính sách mạng, phần đính kèm dừng bản dựng. Nhà phát triển không bao giờ viết một quy tắc tường lửa.

Điều này bảo đảm — thông qua một vai trò phán quyết quản trị đánh giá tô-pô đã khai báo — rằng hạ tầng được khai báo tường minh tuân thủ chính sách egress mà trình biên dịch Go cốt lõi không cần hiểu “bên ngoài” nghĩa là gì. (Lưu ý: Egress zero-trust thực sự phụ thuộc vào việc cụm đích chạy một CNI Default Deny khi thực thi; các cấu hình được tạo chỉ ánh xạ các ngoại lệ đã được cấp phép).

Một Component cho mỗi dịch vụ bên ngoài

Mỗi dịch vụ bên ngoài được khai báo là một thành phần riêng biệt, không bị gộp vào một mảng nhiều đích. Nếu một ứng dụng gọi năm API bên thứ ba khác nhau, nhà phát triển khai báo năm thành phần core/external-service riêng biệt. Chính việc khai báo theo từng dịch vụ này cho phép các công cụ chính sách và plugin Wasm nhắm tới từng đích đi ra một cách riêng lẻ — gắn các chính sách egress khác nhau, các tính năng proxy khác nhau hoặc các móc quan sát khác nhau cho từng phụ thuộc bên ngoài.

Tách bảo mật khỏi thực thi (kịch bản “brownfield”)

Điều quan trọng cần lưu ý là nhãn ngữ nghĩa (ví dụ: untrusted-external) quyết định chính sách bảo mật mạng, không phải việc thực thi. Nó độc lập với việc Aggrega có kết xuất các artifact cấp phát tài nguyên đó hay không.

  • Kịch bản A (API SaaS công khai): Được gắn nhãn untrusted-external trong danh mục (kích hoạt các rào chắn egress của chính sách). Được hiện thực bởi một workload tham chiếu (không cấp phát tài nguyên tính toán; xem §10).
  • Kịch bản B (cơ sở dữ liệu kế thừa nội bộ): Được gắn nhãn internal-trusted (bỏ qua các rào chắn egress, nằm trong VPC). Được hiện thực bởi một workload tham chiếu (không cấp phát tài nguyên tính toán; xem §10).
  • Kịch bản C (cơ sở dữ liệu tự lưu trữ): Được gắn nhãn internal-trusted. Thực thi qua plugin kết xuất Helm (được cấp phát vật lý dưới dạng StatefulSet của Kubernetes).

10. Các dịch vụ mà bản dựng không cấp phát: các Workloads tham chiếu

Khi một ứng dụng tương tác với cơ sở dữ liệu kế thừa tại chỗ hoặc một API SaaS công khai (như Stripe), quy tắc Component phổ quát quy định rằng các thực thể bên ngoài này phải được khai báo là các thành phần riêng biệt trong Aggregate. Tuy nhiên, Aggrega không được cố tạo cho chúng một artifact vật lý Pod Kubernetes hay phiên bản AWS RDS.

Recipe hiện thực một thành phần như vậy khai báo một Workload có form: reference: một endpoint — một host hoặc một URL — tùy chọn một port, và không có container nào. Trình biên dịch chuyển cả hai đi dưới dạng chuỗi con trỏ tất định và không bao giờ phân giải chúng. Những gì một nhà cung cấp kết xuất cho một Workload tham chiếu là việc của chính nhà cung cấp đó: helm xuất một ExternalName Service mang host của endpoint, để các workload trong cụm có thể tiếp cận một dịch vụ có endpoint là tên DNS dưới một tên ổn định trong cụm; compose không kết xuất gì cho nó. Kubernetes coi một externalName là tên DNS, nên một endpoint được viết dưới dạng địa chỉ IP sẽ được tiếp cận tại địa chỉ mà bên tiêu thụ nhận được thay vì thông qua Service.

Trên cả hai nhà cung cấp, các provides: của Recipe tới được mọi bên tiêu thụ qua .context.uses và hợp đồng inject y hệt như của một thành phần được cấp phát. Vì vậy, việc đấu nối của bên tiêu thụ không thay đổi khi đích của nó chuyển từ được cấp phát sang được tham chiếu: chỉ Recipe mà Manifest ánh xạ đích tới là thay đổi.

Pipeline thực thi từng bước

1. Miền 1 (Aggregate): Ý định của nhà phát triển Nhà phát triển yêu cầu một cơ sở dữ liệu Oracle kế thừa. Họ không quan tâm nó nằm ở đâu; họ chỉ quy định rằng tác tử gọi của mình mong nhận chuỗi kết nối dưới dạng biến môi trường. Vì IP là tĩnh và được biết trước, họ truyền nó qua tham số.

components:
legacy-oracle:
type: core/legacy-database:1.0.0
values:
host: "{{ .parameters.legacy_oracle_ip }}"
sid: "PROD_DB"
my-agent:
type: core/python-worker:1.0.0
values: {}
uses:
databases:
legacy_db:
target: legacy-oracle
inject:
env:
- in: ORACLE_DSN # Local env var
from: "primary_endpoint" # Target provides key

2. Miền 4 (Manifest): Định tuyến Ops ánh xạ loại cơ sở dữ liệu kế thừa tới Recipe định dạng chuỗi kết nối của nó. Manifest nêu tên một Recipe và không gì hơn; Recipe được nêu tên khai báo một Workload có form: reference, và chính dạng đó giữ cho nút không cấp phát tài nguyên tính toán. Định tuyến vẫn hoàn toàn phẳng và dễ đoán vì map có đúng một hình dạng bất kể đích là gì.

spec:
mappings:
components:
type:
"core/legacy-database": "oracle-dsn-formatter:1.0.0"

3. Miền 3 (Recipe tham chiếu): Cấu trúc việc bàn giao Kỹ sư Ops viết Recipe. Nó dựng chuỗi kết nối primary_endpoint từ values của nhà phát triển trong khối locals của nó, công bố chuỗi đó dưới provides, và khai báo một Workload tham chiếu trỏ tới host của cơ sở dữ liệu.

apiVersion: aggrega.ai/v1beta1
kind: Recipe
metadata:
name: oracle-dsn-formatter
version: 1.0.0
spec:
capability: helm
implements: core/legacy-database:1.0.0
# The connection string, built from the Developer's values
locals:
primary_endpoint: "oracle://{{ .values.host }}:1521/{{ .values.sid }}"
# The public contract a consumer's inject reads
provides:
primary_endpoint: "{{ .locals.primary_endpoint }}"
# No compute: an endpoint the build does not provision
workload: |
apiVersion: aggrega.ai/v1beta1
kind: Workload
form: reference
endpoint: "{{ .values.host }}"
port: 1521

4. Trình biên dịch thực thi khi kết xuất (bàn giao)

  1. Trình biên dịch đánh giá Recipe cho legacy-oracle. Với một Release cung cấp legacy_oracle_ip: "10.0.4.55", primary_endpoint của nó là oracle://10.0.4.55:1521/PROD_DB.
  2. Trên helm, Workload tham chiếu kết xuất một ExternalName Service, legacy-oracle, với externalName: 10.0.4.55 và cổng 1521; trên compose, nó không kết xuất gì.
  3. Sau đó trình biên dịch kết xuất Recipe cho my-agent. Kênh .context.uses của nó mang các provides của nút Oracle, và hợp đồng inject đã phân giải ORACLE_DSN dựa trên chúng.

5. Miền 3 (Recipe bên gọi): Thực hiện hợp đồng Recipe Helm chuẩn cho worker Python đọc map inject mà nó nhận được, y hệt như với một cơ sở dữ liệu mà bản dựng cấp phát.

# Inside python-worker-helm (The calling agent's recipe)
env:
# The compiler pre-resolved the target's provides into the inject map
{{- range $key, $value := .context.inject.env }}
- name: {{ $key }} # Renders: ORACLE_DSN
value: "{{ $value }}" # Renders: oracle://10.0.4.55:1521/PROD_DB
{{- end }}

11. Truyền dẫn liên trụ cột qua schema-bridge: Bắc cầu từ ý định tới hạ tầng

Xem inheritance-and-interface để biết mẫu schema-bridge giúp phơi bày an toàn các nút điều chỉnh hạ tầng chuyên biệt qua các thành phần con — một trường values: hướng tới nhà phát triển, được khai báo trên schema: của Component, mà template valuesMapping: của Recipe dẫn vào đầu ra đã kết xuất có dạng infra:.

12. Cấp phát greenfield (“Aggregates nền tảng”)

Một cái bẫy thường gặp trong kỹ thuật nền tảng là buộc bộ định tuyến (tệp Release) xử lý việc cấp phát cụm Day-0 nặng nề (ví dụ: dựng một cụm AWS EKS mới trước khi triển khai ứng dụng vào đó). Điều này tạo ra các tệp định tuyến dài và khó đọc.

Aggrega xử lý điều này bằng nguyên tắc “rùa chồng rùa đến tận cùng”. Lược đồ Release không có khối nào để cài đặt hạ tầng; việc cấp phát cụm được mô hình hóa bằng Aggregates nền tảng.

Vì một cụm AWS EKS, một control plane Istio và một AWS VPC rốt cuộc chỉ là các tài nguyên đám mây vật lý, chúng được mô hình hóa giống hệt các thành phần ứng dụng.

  1. Aggregate nền tảng: Nhóm hạ tầng viết một Aggregate.yaml chuẩn trong đó các thành phần là core/aws-vpc, core/eks-cluster và core/istio-base.
  2. Release nền tảng: Nhóm triển khai aggregate này. Trình kết xuất được gắn cho các thành phần nền tảng này xuất ra các artifact cần thiết để dựng hạ tầng cơ sở.
  3. Release ứng dụng: Khi nhà phát triển ứng dụng sẵn sàng triển khai tác tử AI của mình, nhóm Ops chỉ cần nhắm tới cụm vừa được tạo bằng một ranh giới trong chính tệp Release của ứng dụng.