Quản trị và tuân thủ
Chương này định nghĩa cách các nhóm nền tảng thực thi tuân thủ doanh nghiệp trên mọi bản build — thông qua socket quản trị, các đường cơ sở và lược đồ của danh mục, và các quy ước mà tác giả danh mục tuân theo — mà không mã hóa cứng chính sách vào trình biên dịch. Các sự kiện vòng đời Day-2 là chủ đề của Vòng đời Day-2.
Các mẫu quản trị và tuân thủ cho doanh nghiệp
Một thách thức cốt lõi trong kỹ thuật nền tảng là thực thi quản trị doanh nghiệp (như tuân thủ SOC 2, theo dõi trung tâm chi phí FinOps và ánh xạ quyền sở hữu chặt chẽ) mà không làm ô nhiễm danh mục mã nguồn mở.
Nếu Aggrega mã hóa cứng logic đặc thù theo miền vào các thành phần chính thức của mình, nó sẽ không còn là một trình biên dịch không có quan điểm riêng mà thoái hóa thành một framework áp đặt quan điểm. Ngược lại, nếu việc tuân thủ được giao hoàn toàn cho nhà phát triển, các thẻ quan trọng sẽ bị viết sai, bị quên hoặc bị bỏ qua.
Để giải quyết điều này, Aggrega cung cấp cơ chế socket Wasm cho việc tuân thủ, còn doanh nghiệp quyết định chính sách. Các doanh nghiệp đạt được quản trị zero-trust bằng cách áp dụng hai khế ước xã hội riêng biệt trong hệ sinh thái của mình.
1. “Bring Your Own Baseline” (BYOB) + cổng kiểm tra Wasm
Đối với dữ liệu tĩnh do nhà phát triển cung cấp (như nhóm sở hữu hoặc phân loại dữ liệu), doanh nghiệp không bao giờ nên dựa trực tiếp vào danh mục mã nguồn mở thô. Thay vào đó, Kiến trúc sư Nền tảng viết một đường cơ sở doanh nghiệp — các trường mà mọi thành phần nội bộ phải mang, được khai báo một lần trong một mục SchemaLibrary — và dùng một vai trò phán quyết quản trị để buộc sử dụng nó.
Hợp đồng danh mục: Doanh nghiệp tạo một nền cơ sở yêu cầu các thẻ cụ thể nhưng không cấp phát bất kỳ hạ tầng nào.
apiVersion: aggrega.ai/v1beta1kind: SchemaLibrarymetadata: name: CorporateBaseline version: 1.0.0spec: schemas: Ownership: type: object properties: owner: { type: string } cost_center: { type: string } # The developer MUST provide these, or the schema validator halts the build required: [owner, cost_center]Mọi thành phần nội bộ (ví dụ: acme/datastore/postgres) tham chiếu mục đó từ schema: của chính nó và thêm các giá trị của riêng nó, nên các trường dùng chung và các trường riêng của thành phần được xác thực cùng nhau:
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: acme/datastore/postgres version: 1.0.0 labels: component.aggrega.ai/type: stateful-serverspec: schema: values: $ref: "CorporateBaseline#/schemas/Ownership" properties: database: { type: string } required: [database]Đường cơ sở là một mục thư viện chứ không phải một Component cơ sở, vì một Component viết extends: nhận trọn vẹn schema: của cơ sở và không khai báo giá trị nào của riêng nó (xem Kế thừa và kỷ luật xuất bản).
Cơ chế an toàn kiểm tra Wasm: Để ngăn nhà phát triển bỏ qua danh mục nội bộ và kéo một thành phần core/postgres trần trực tiếp từ hub công khai, doanh nghiệp đăng ký một plugin kiểm tra topo. Plugin được đánh giá trong lúc phân tích tĩnh — sau khi đồ thị được lắp ráp và trước khi bất kỳ artifact nào được render — đó là lý do nó thấy toàn bộ topo thay vì từng thành phần một.
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some id, _ in input.graph.spec.nodes not input.graph.spec.values_mapping[id].owner msg := sprintf("node %v declares no owner; use a component whose schema references 'CorporateBaseline#/schemas/Ownership'.", [id])}Một quyết định mà chính sách thu thập dưới khóa từ chối của nó là một sự bác bỏ, và bản dựng dừng lại vì nó.
Cấm các kết nối tự do: Nhà phát triển có thể nối một cạnh qua một socket mà danh mục không khai báo — một socket ad hoc (xem dependency-resolution). Sự cởi mở đó là có chủ ý, và việc trình biên dịch không có ý kiến gì về nó cũng vậy: một tổ chức muốn mọi kết nối đi qua socket do các Kiến trúc sư của mình khai báo sẽ thể hiện điều đó dưới dạng chính sách thay vì dựa vào trình biên dịch. Mọi cạnh trong đồ thị đều mang socket_declaration, có giá trị declared hoặc ad-hoc, nên quy tắc chỉ là một dòng:
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some e in input.graph.spec.edges e.socket_declaration == "ad-hoc" msg := sprintf("%v connects to %v through the free-form socket %v; declare the socket in the component type's usesSchema.", [e.source, e.target, e.socket])}Giá trị này luôn có mặt trên mọi cạnh, bất kể cạnh được viết theo cách nào, nên chính sách không bao giờ phải đọc một trường vắng mặt là “declared”. Và nó là một trục riêng: nó cho biết socket đến từ đâu, chứ không phải ai đã vẽ cạnh, nên nó kết hợp với origin_feature và origin_release thay vì chồng lấn với chúng — một chính sách có thể cấm kết nối tự do trong khi vẫn cho phép Release nối các kết nối đã khai báo.
Quản trị doanh nghiệp tập trung (đánh giá toàn bộ thực tế): Các cơ chế ngoài luồng (như CODEOWNERS trên một kho git) xem xét các tệp thay đổi, chứ không phải kiến trúc mà chúng được biên dịch thành. Các vai trò phán quyết quản trị đánh giá chính kiến trúc. Vì trình biên dịch AOT xây dựng Đồ thị IR bằng cách làm phẳng cả Aggregate của nhà phát triển lẫn Release của Người vận hành nền tảng, một chính sách ở vai trò ir-verdict đánh giá toàn bộ thực tế trước khi các artifact vật lý được tạo ra, và một chính sách ở vai trò render-verdict đánh giá chính các artifact. Chính sách có thể dừng hẳn bản dựng nếu nhà phát triển yêu cầu một Component chưa được phê duyệt, hoặc — bằng cách đọc nguồn gốc aggrega.ai/recipe-uri được đóng dấu trên mỗi đối tượng được kết xuất — nếu Manifest ánh xạ một thành phần tới một Recipe chưa được phê duyệt.
2. Cổng biến đổi Wasm (tuân thủ động)
Không nên buộc nhà phát triển gõ thủ công các thẻ tuân thủ theo môi trường (ví dụ: environment: production hoặc soc2_in_scope: true) vào Aggregate của họ, vì chúng thay đổi tùy theo đích GitOps.
Với siêu dữ liệu động, doanh nghiệp sử dụng Mutation Gate — vai trò label-transform của socket quản trị, chạy trong lúc dựng topo. Sau khi đồ thị được mở rộng, và trước khi phân tích tĩnh đánh giá nó, trình biên dịch thực thi plugin Wasm mà doanh nghiệp đã đính kèm. Plugin đó đọc môi trường của Release, các nhãn mà các nút đã khai báo và các giá trị mà instance của mỗi nút khai báo, rồi nêu tên các nhãn mà các nút của bản dựng nên mang — nhờ vậy siêu dữ liệu cần thiết đến được thành phần mà nhà phát triển không phải gõ (ví dụ: nhãn compliance.aggrega.ai/data-class: restricted được quyết định từ môi trường của Release, hoặc datastore.aggrega.ai/engine: vector được quyết định từ các extension mà một cơ sở dữ liệu khai báo). Các giá trị là chỉ đọc: plugin chỉ quyết định nhãn và không gì khác.
Một chính sách ở vai trò này nêu tên nhãn — nút, khóa và giá trị mà nhãn nhận — thay vì viết lệnh chỉnh sửa mà bản dựng áp dụng. Lý do quan trọng với bất kỳ ai viết một chính sách như vậy: lệnh chỉnh sửa xác định nhãn theo đường dẫn, và khóa nhãn Aggrega thường chứa ký tự /, vốn là dấu phân cách đường dẫn, nên một đường dẫn viết tay sẽ trỏ đến một vị trí lồng nhau thay vì một nhãn duy nhất. Bản dựng xác định nhãn mà quyết định nêu tên, và phép chiếu các nút mà vai trò này nhận được đặt chúng nông hơn một cấp so với một phán quyết trên toàn bộ đồ thị.
# Evaluated by the governance label-transform role, during topology constructionpackage acme.tagging
import rego.v1
labels contains {"node": id, "key": "acme.com/soc2-scope", "value": "true"} if { input.compilation_context.environment == "production" some id, node in input.graph.nodes node.labels["component.aggrega.ai/type"] == "stateful-server"}Vì các thẻ này được tiêm trong bộ nhớ vào từ điển siêu dữ liệu chuẩn trước khi quá trình render bắt đầu, các plugin render Wasm có thể đọc chúng để sinh có điều kiện các cấu hình vật lý cụ thể — ví dụ tài nguyên AWS hoặc Kubernetes được gia cố — khi các artifact được render.
Phát biểu quy tắc một lần: các đính kèm quản trị có phạm vi workspace. Hai mẫu trên được viết theo từng thành phần và từng Feature, nhưng đính kèm quản trị thực thi chúng thì không. Một plugin quản trị được đính kèm tại khóa plugins.governance của cấu hình workspace, và đính kèm đó ràng buộc mọi bản dựng trong workspace. Do đó, một quy tắc doanh nghiệp được phát biểu tại đúng một nơi: nhóm nền tảng đính kèm plugin một lần, và không thành phần, Aggregate hay Release nào phải đăng ký tham gia, nhắc đến nó, hay bị chỉnh sửa để nó có hiệu lực. Chính điều này khiến cơ chế an toàn kiểm tra trong mẫu 1 trở thành một câu trả lời trọn vẹn thay vì một quy ước theo từng dự án — một nhà phát triển bỏ qua danh mục nội bộ và yêu cầu một core/postgres trần sẽ bị đánh giá bởi cùng chính sách đã đính kèm như mọi người khác, vì chính sách là thuộc tính của workspace chứ không phải của thành phần họ chọn.
Một quy tắc workspace bác bỏ; nó không viết lại hợp đồng của nhà phát triển. Phạm vi là phổ quát, và tác động được cố ý giới hạn ở một phán quyết. Một quy tắc áp dụng ở mọi nơi sẽ dừng một bản dựng vi phạm nó, nêu rõ cần sửa gì, và không thể thay vào đó sửa đổi thành phần vi phạm để nó tuân thủ. Ranh giới đó là điều giữ cho cơ chế có thể gỡ lỗi được ở quy mô toàn bộ hệ thống: một bản dựng hoặc khớp với các quy tắc mà workspace khai báo, hoặc dừng lại với một thông báo trỏ đến dòng đã viết, và đầu ra đã render không bao giờ chứa một ràng buộc hay tài nguyên mà không tệp đã viết nào yêu cầu. Khi doanh nghiệp thực sự muốn đồ thị được thay đổi thay vì bị phán xét, họ đính kèm một vai trò biến đổi — mẫu 2 ở trên — và thay đổi đó được giới hạn trong phạm vi mà người vận hành đã đính kèm nó để làm, đó là lý do nó là một hành động tường minh của nhóm nền tảng chứ không phải một lần viết lại vô hình.
Hệ quả thực tế cho một nhóm nền tảng đang khép kín vòng tuân thủ: thể hiện hình dạng mà một payload phải có dưới dạng ràng buộc lược đồ trên một nền cơ sở của doanh nghiệp, thể hiện các quy tắc liên thực thể mà hệ thống yêu cầu dưới dạng một vai trò phán quyết được đính kèm, và thể hiện siêu dữ liệu dẫn xuất mà nhà phát triển không bao giờ nên phải gõ dưới dạng một vai trò biến đổi được đính kèm. Cả ba đều được khai báo một lần và áp dụng cho mọi bản dựng, và không cái nào đòi hỏi nhà phát triển phải biết chúng tồn tại.
3. Bảo toàn tri thức miền (các cấu hình và sự an toàn)
Vì trình biên dịch Aggrega không có quan điểm riêng, nó hoàn toàn không có tri thức mã hóa cứng nào về framework AI, ngân sách token hay phân vùng bộ nhớ. Thay vào đó, các lược đồ cloud-native chung đóng vai trò như một chiếc bình rỗng. Thay vì được mã hóa cứng vào lõi trình biên dịch, tri thức miền chuyên sâu được phân bổ khắp toàn bộ hệ sinh thái Aggrega có thể mở rộng. Nó được đóng gói trong danh mục nền tảng thông qua các components, features và recipes chuyên biệt. Nhà phát triển bảo toàn ý định ứng dụng cụ thể của họ trong các khối values và uses — được quản lý chặt chẽ bởi các khai báo schema: của Kiến trúc sư (dạng rút gọn hoặc JSON Schema 2020-12 đầy đủ) và các socket usesSchema — trong khi việc chuyển đổi vật lý tri thức đó được thực thi bởi các plugin WebAssembly đặc thù cho từng đích.
A. Mô hình hóa các triển khai đặc thù theo miền (được kiểm tra qua lược đồ tách)
Kiến trúc sư Nền tảng có thể tận dụng pipeline lược đồ tách để mô hình hóa bất kỳ kiến trúc phức tạp nào, hoàn toàn độc lập với lõi trình biên dịch:
- Logic thực thi mờ (
values): Nếu doanh nghiệp triển khai một AI Gateway, nhà phát triển cấu hình hành vi riêng của gateway — trên AI gateway của thư viện chuẩn, đó là mapmodelscông bố mỗi bí danh mà bên gọi có thể yêu cầu và upstream mà mỗi bí danh phân giải tới. Lõi trình biên dịch không phân tích các khái niệm này. Chúng nằm an toàn trong payloadvaluesmờ, được kiểm tra nghiêm ngặt bởi khai báoschema:của thành phần. Trình biên dịch chỉ đơn giản chuyển payload này cho plugin Wasm để sinh cấu hình của gateway. Các điều khiển mà nhiều sản phẩm gateway cùng có, như chuỗi dự phòng, số lần thử lại hoặc lựa chọn giữa các mục công bố cùng một bí danh, là các Features được đính kèm vào gateway chứ không phải giá trị trên nó, mỗi Feature được hiện thực cho một gateway theo cách riêng của gateway đó. - Ánh xạ phụ thuộc topo (
uses): Khi một framework AI nối một agent với các công cụ của nó hoặc với một kho dữ liệu vector, việc nối đó quyết định ai nói chuyện với ai, nên nó được khai báo trong trụuses; một danh sách tên được giữ trongvalues, nhưtools_allowedcủa thư viện chuẩn, là một quy ước không vẽ cạnh nào. Trình biên dịch vẽ nguyên văn các cạnh tường minh này vào Đồ thị IR. Điều này cho phép các plugin render Wasm ở hạ nguồn sinh theo lập trình các chính sách mạng và ranh giới vật lý cần thiết để bảo mật các kết nối, mà trình biên dịch không cần hiểu framework AI bên dưới. - Cấu trúc dữ liệu phức tạp (ví dụ: CoALA): Thay vì bị giới hạn ở một danh sách đích phẳng duy nhất, Kiến trúc sư khai báo trong
usesSchemabao nhiêu socket tùy theo cấu trúc cần, mỗi socket có selector riêng vàvalueSchemariêng cho từng cạnh. Ví dụ, để triển khai framework CoALA, một Kiến trúc sư có thể khai báosemantic_memory,episodic_memoryvàworking_memorylà các socket riêng biệt, nên mỗi kho bộ nhớ là một đích topo riêng biệt. Các công cụ chính sách chung đánh giá các cạnh có cấu trúc này để bắt buộc các rào chắn kiểm soát truy cập chi tiết cho từng thùy nhận thức riêng biệt.
B. Cơ chế bảo mật và gián tiếp cốt lõi
Dù payload không có quan điểm riêng, lược đồ chung vẫn thực thi các cơ chế cấu trúc nghiêm ngặt hỗ trợ việc sinh artifact an toàn:
- Mẫu đính-kèm-không-phải-giá-trị: quy ước của thư viện chuẩn là một thông tin xác thực được yêu cầu dưới dạng đính kèm, không bao giờ được viết vào một khối
values, nơi nó sẽ là một literal nội tuyến mà trình biên dịch mang theo nguyên văn. Một đính kèm thông tin xác thực nêu tên mộttypeFeature thông tin xác thực (một Feature mang nhãnfeature.aggrega.ai/kind: secret) và dùngvaluesriêng của nó để mô tả truy vấn tới một kho bí mật. Khi đó, việc định tuyến thông tin xác thực là ràng buộc muộn không phụ thuộc năng lực, và lõi trình biên dịch không bao giờ phân giải hay để lộ nội dung bí mật — nó chuyển tiếp con trỏ mà Recipe của Ops cung cấp. Đây là một quy ước mà danh mục và các lược đồ khuyến khích, 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, nên tác giả nào viết nội dung bí mật nội tuyến thì nó sẽ nằm nội tuyến. Điều lược đồ thực sự bảo đảm là bề mặt đính kèm tồn tại và có kiểu. - Xác minh tin cậy trừu tượng: Vì khối
valuescó khả năng mở rộng rộng rãi, Kiến trúc sư có thể bắt buộc các chỉ thị trừu tượng nhưtls_pinninghoặcrequired_signatures: 2(cho đồng thuận đa số). Lõi trình biên dịch chuyển nguyên văn các đối tượng đã được lược đồ kiểm tra này vào đồ thị IR phẳng. Một plugin render Wasm tùy chỉnh sau đó có thể đọc các giá trị này để sinh artifact cho các cổng phê duyệt Human-in-the-Loop (HITL) ở cấp phần cứng. Nếu một ứng dụng cố vượt qua các quy tắc đồng thuận, proxy được triển khai vật lý sẽ chặn việc thực thi cho đến khi nhận được phê duyệt qua webhook.
C. An toàn vận hành nâng cao (spec.interoperability)
Để bảo vệ các khối lượng công việc dễ tổn thương khỏi các biến đổi hạ tầng xung đột, lược đồ Feature chung định nghĩa một cơ chế kiểm soát khả năng tương tác:
spec.interoperability.conflictsWith— danh sách các Features không được phép đến cùng một thành phần với Feature này. Trình biên dịch dừng bản dựng trước khi render khi tập đính kèm mà một thành phần rốt cuộc có — được thu thập từ mọi phạm vi chạm tới nó: chính thành phần, một hệ thống con hoặc ranh giới chứa nó, mục thành phần của nó trong Release và phép mở rộng theo annotation — chứa Feature này và một Feature mà nó nêu tên. Đây là phép so sánh giữa các tên mà tác giả của Feature đã khai báo với các Features mà thành phần mang, không gán ý nghĩa nào cho bên nào: sự không tương thích là phán đoán của tác giả, và trình biên dịch buộc bản dựng tuân theo nó. Một khai báo là đủ, tên được so khớp bất kể phiên bản, và hai Features được đính kèm vào các ranh giới anh em không có chung thành phần nào sẽ không bao giờ gặp nhau.
4. Quản trị ranh giới mạng (quy ước từ chối mặc định)
Nhà phát triển không trực tiếp viết chính sách mạng; các ranh giới mạng cần thiết được ánh xạ bởi đồ thị biểu diễn trung gian (IR) của trình biên dịch, đồ thị này mang mọi cạnh tô-pô giữa các thành phần được khai báo trong Aggregate.
- Ranh giới nội bộ. Trình biên dịch vẽ đồ thị IR phẳng và tự nó không hạn chế gì: khi không có chính sách, mọi kết nối mà mạng của cụm cho phép vẫn có thể truy cập được. Quy ước là một chính sách được viết cho một thành phần chỉ cho phép một kết nối ở nơi Aggregate khai báo một cạnh cho kết nối đó, bên cạnh những gì phần gắn riêng của chính sách nêu tên, và từ chối mọi kết nối khác theo hướng mà chính sách quản lý.
- Hiện thực của thư viện chuẩn. Danh mục thư viện chuẩn hiện thực quy ước này dưới dạng hai Features mà nhà vận hành gắn vào một thành phần trong Release, mỗi cái cho một hướng của kết nối:
core/caller-allowlistchỉ chấp nhận kết nối từ các thành phần có cạnhusestrỏ tới nó, vàcore/egress-allowlistchỉ cho phép thành phần kết nối tới các thành phần mà chính các cạnh của nó trỏ tới và tới DNS của cụm. Trên đích helm, mỗi cái được hiện thực bởi một FeatureRecipe viết một Kubernetes NetworkPolicy từ các cạnh mà trình biên dịch trao cho nó, gọi tên các pod của từng thành phần dựa trên những gì bản render của chính thành phần đó đã phát ra — các selector và nhãn mà các workload của nó mang, namespace mà chúng được phát ra vào và các cổng mà container của chúng khai báo — nhờ vậy không nhãn hay cổng nào phải khai báo lại thủ công. Mỗi cái cũng chấp nhận các pod của chính thành phần và những gì Release nêu tên trên phần gắn: các nguồn bên ngoài Aggregate ở phía vào, và ở phía ra là các dải địa chỉ cho một đích mà cụm không chạy, đích này không render pod nào để chọn và chỉ được chấp nhận theo dải, trên bất kỳ cổng nào. Trình biên dịch không thể kiểm tra cụm, nên mỗi cái dừng bản build cho đến khi Release xác nhận rằng plugin mạng của cụm thực thi chính sách mạng; compose không có chính sách mạng, và một bản build gắn một trong hai cái đó ở đó sẽ dừng. - Ingress công khai (kiểm soát vành đai bất khả tri). Ingress công khai được quản lý bởi các quy tắc riêng của doanh nghiệp tại một vai trò phán quyết quản trị. Một nhóm bảo mật doanh nghiệp có thể viết một chính sách đánh giá kiểu ontology cloud-native của một nút và từ chối bản build nếu nhà phát triển cố gắn một tính năng
public-ingressvào một nútworkerhoặctask. Trình biên dịch không diễn giải “công khai” nghĩa là gì; nó thực thi đầu ra Boolean của cổng xác thực Wasm.
5. Đóng dấu nguồn gốc tại thời điểm biên dịch
Trình biên dịch xây dựng một bản ghi nguồn gốc trong quá trình biên dịch, ghi lại phiên bản trình biên dịch và các phiên bản của Aggregate, Manifest và Release mà nó đã biên dịch — và không có dấu thời gian, nên bản ghi không bao giờ phá vỡ đầu ra giống hệt từng byte. Renderer helm phát ra phiên bản trình biên dịch dưới dạng nhãn aggrega.ai/compiler-version trên các manifest Kubernetes được tạo, còn renderer helm-chart phát ra trên các tệp template mà một Recipe thêm vào chart, vì nó sao chép nguyên vẹn các template của chính chart; các nhóm bảo mật doanh nghiệp dùng nó để xác định artifact đã kết xuất nào được xây dựng bởi phiên bản trình biên dịch nào — điều quan trọng khi một lỗ hổng được phát hiện trong một bản phát hành cụ thể của trình biên dịch và các artifact bị ảnh hưởng cần được kiểm toán.
Provider compose đóng dấu cùng các khóa nguồn gốc dưới dạng nhãn dịch vụ, provider terraform dưới dạng một tệp nguồn gốc trong mỗi module mà nó lắp ráp, và provider cloudformation dưới Metadata của mỗi tài nguyên; bản ghi nguồn gốc trong bộ nhớ tồn tại cho mọi lần biên dịch.
6. Siêu dữ liệu và chú thích làm bề mặt mở rộng
Trình biên dịch Go không phụ thuộc vào các khái niệm đặc thù miền — framework AI, công cụ cơ sở dữ liệu, thành ngữ Kubernetes — và chỉ làm việc trên các phép toán phẳng ở cấp đồ thị đối với IR. Để vận hành hệ sinh thái mà không mã hóa cứng logic đặc thù miền vào tệp nhị phân Go, nền tảng sử dụng các nhãn và chú thích siêu dữ liệu chuẩn làm bề mặt mở rộng cho tri thức miền.
Trình biên dịch không đọc chú thích đặc thù miền nào. Nó gom tất cả chú thích do nhà phát triển cung cấp và các nhãn duck typing vào đồ thị IR phẳng và chuyển nguyên văn siêu dữ liệu này tới các plugin quản trị và render. Hệ sinh thái WebAssembly diễn giải siêu dữ liệu và thực thi logic cần thiết — đánh giá chính sách tuân thủ, chèn thẻ vào các artifact cloud-native hoặc kích hoạt việc mở rộng tính năng — độc lập với lõi trình biên dịch.
Điều này giữ cho bề mặt mở rộng luôn rộng (ai cũng có thể viết một plugin Wasm đọc một tiền tố chú thích mới) trong khi giữ lõi trình biên dịch ổn định: hệ sinh thái không cần bản phát hành lõi nào để thêm một chú thích đặc thù miền mới.
Những gì chính sách đọc được về một phần gắn
Một vai trò phán quyết đánh giá đồ thị IR nhận toàn bộ đồ thị — với mọi giá trị mà tác giả khai báo là nhạy cảm bị giữ lại, như mô tả bên dưới — và điều đó bao gồm mọi phần gắn mà mỗi nút mang, được đánh khóa theo tên mà tác giả đặt cho nó — hoặc, với một phần gắn được viết trên một trong các kết nối của nút, theo bí danh của kết nối và khe nối với nhau bằng dấu chấm. Lý do mang chi tiết phần gắn thay vì một bản tóm tắt là Aggrega không có quan điểm nào để tóm tắt: trình biên dịch định tuyến các phần gắn mà không phán xét chúng chứa gì, nên những dữ kiện mà chính sách cần để phán xét chúng chính là những dữ kiện được trao cho chính sách.
Với mỗi phần gắn, đồ thị mang:
- Kiểu Feature mà nó yêu cầu, và phiên bản danh mục được phân giải cho nó. Kiểu là chuỗi mà tác giả đã viết, nguyên văn — một tham chiếu ghim phiên bản và một tham chiếu trần là hai chuỗi khác nhau cho cùng một đối tượng được tham chiếu, nên chính sách so sánh kiểu nên chờ đợi cả hai cách viết.
- Các nhãn danh mục của Feature được gắn, nguyên văn. Không lọc, không chuẩn hóa, theo thứ tự mà thực thể danh mục khai báo. Chính sách đọc chính xác những gì tác giả danh mục đã viết, kể cả các nhãn do chính tác giả nghĩ ra mà Aggrega hoàn toàn không biết.
- Các chú thích danh mục của Feature được gắn, nguyên văn.
metadata.annotationscủa chính thực thể Feature, được mang theo đúng các điều kiện như nhãn của nó — không lọc, không chuẩn hóa, theo thứ tự khai báo của thực thể — nhờ vậy một khóa chú thích trong namespace riêng của tác giả đến nơi đúng như đã viết. Đây là một chủ đề khác với chú thích đã khiến một phần gắn được mở rộng từ chú thích tồn tại ngay từ đầu: đồ thị báo cáo nguồn gốc đó riêng, và một phần gắn được viết trong khốifeatures:mang các chú thích của thực thể mà không báo cáo nguồn gốc mở rộng nào cả. - Khe gắn đã khai báo nào mà nó lấp. Một khe
featuresSchemađược lấp bằng cách gắn một Feature dưới tên của khe, nên một phần gắn nêu tên một khe mà Component của nó khai báo sẽ báo cáo tên của khe đó, và một phần gắn không lấp khe nào sẽ báo cáofree. Một phần gắn được viết trên một kết nối lấp một khe mà socket của kết nối khai báo, và báo cáo tên của khe đó; vì socket không chấp nhận tên nào khác, nó không bao giờ báo cáofree. Giá trị là tên của khe thay vì một cờ, vì việc điểm ràng buộc nào được lấp thường là nửa hữu ích hơn của câu trả lời. - Nó được viết trên kết nối nào, nếu có. Một phần gắn được viết trên một trong các kết nối của thành phần mang socket và bí danh của kết nối đó, chúng nêu tên cạnh đồ thị mà phần gắn được trình ra trên đó — và qua cạnh đó, thành phần mà nó được trình ra cho. Một phần gắn thuộc khối riêng của thành phần không mang cái nào. Kết nối được mang dưới dạng dữ liệu thay vì để đọc ra từ tên của phần gắn, vốn chứa bí danh chứ không chứa socket.
- Liệu nó có xử lý dữ liệu mà tác giả đã khai báo là nhạy cảm hay không, và những khóa phân phối nào của nó mang dữ liệu đó. Cả hai đều được suy ra từ các khai báo — một lá
sensitivetrên schema của một Feature, một khesensitivetrên Component tiêu thụ, dù là khe nó khai báo cho các phần gắn của chính nó hay khe trên socket mà một kết nối được nối qua — không bao giờ từ việc kiểm tra một giá trị. values,infravà ánh xạ phân phối của nó, cùng với việc phần gắn được viết trong một khốifeatures:hay được đóng góp bởi quá trình mở rộng dựa trên chú thích — với mọi giá trị mà tác giả khai báo là nhạy cảm bị giữ lại, như đoạn tiếp theo mô tả.
Chính sách được cho biết dữ liệu được khai báo nhạy cảm nằm ở đâu, và không bao giờ được trao chính dữ liệu đó. Mỗi lá mà đồ thị đánh dấu là được khai báo nhạy cảm — trong values hoặc infra của bất kỳ phần gắn nào, dù nó được viết trên phạm vi hay kết nối nào, trong infra của một phần gắn ranh giới, trong values và infra riêng của một nút, và trong values và infra riêng của một kết nối — đến với chính sách dưới dạng một dấu đánh dấu một khóa, {"aggrega_withheld": "declared"}, thay cho giá trị. Khóa vẫn được giữ, nên chính sách vẫn thấy payload mang những lá nào; việc đánh dấu nêu tên các lá đó vẫn được giữ, nên chính sách vẫn thấy lá nào trong số đó mang dữ liệu được khai báo; và mọi dữ kiện liệt kê ở trên vẫn đến như trước, cùng với mọi giá trị không bị khai báo nào đánh dấu. Không dữ kiện nào mà chính sách dựa vào để suy luận — phần gắn là gì, nó lấp gì, nó được trình ra cho cái gì, thực thể danh mục của nó nói gì về nó, và dữ liệu bí mật của nó đi đâu — là một giá trị mà tác giả có thể khai báo là nhạy cảm, và chính dữ liệu đó là thứ duy nhất chính sách không cần để phán xét nó đi đâu. Đây cũng chính là sự giữ lại mà dòng lệnh áp dụng khi in đồ thị và daemon áp dụng khi trả lời yêu cầu của trình soạn thảo về đồ thị. Các bề mặt đó trả lại giá trị cho người yêu cầu một cách tường minh; bản sao của chính sách không cung cấp yêu cầu như vậy. Sự giữ lại này chỉ áp dụng cho bản sao của chính sách: đồ thị mà bản build render từ đó vẫn nguyên vẹn, nên không byte nào được render thay đổi.
Nhãn của một phần gắn ràng buộc trình biên dịch ở đúng một chỗ, và đó không phải là quyết định chính sách: một khe có thể khai báo một selector, và một lần lấp có nhãn không thỏa mãn nó sẽ dừng bản build. Vượt qua cổng đó, nhãn không điều hướng gì cả — cách một giá trị được định tuyến và phân phối là như nhau bất kể Feature mang nhãn nào. Vì vậy một chính sách đọc nhãn là đang đọc siêu dữ liệu mà trình biên dịch mang theo mà không diễn giải, chứ không phải phỏng đoán lại một nhánh bên trong nó.
Các chú thích danh mục của một Feature không ràng buộc nó ở chỗ nào cả: không hành vi nào của trình biên dịch rẽ nhánh theo chúng, và một khe không khai báo ràng buộc nào lên chúng theo cách nó có thể làm với nhãn. Chúng được mang theo và không gì hơn.
Những quy tắc mà điều này cho phép viết, không quy tắc nào trong số đó được trình biên dịch đặt ra thay bạn:
- Cấm gắn tự do. Một tổ chức yêu cầu mọi phần gắn phải lấp một điểm ràng buộc đã khai báo sẽ từ chối mọi phần gắn báo cáo
free. Đây là mặt đối ứng của việc bề mặt gắn luôn để mở: việc kết hợp là tự do theo mặc định, và nhà vận hành nào không muốn nó tự do thì nói rõ điều đó. - Từ chối phân phối dữ liệu nhạy cảm theo giá trị. Aggrega cảnh báo khi một dữ liệu được khai báo nhạy cảm đi qua một khóa phân phối dưới dạng literal, và không bao giờ dừng — họ thông tin xác thực theo giá trị là có chủ ý. Nhà vận hành muốn cảnh báo đó trở thành từ chối thì thể hiện điều đó tại đây.
- Tự quyết định điều gì được tính là thông tin xác thực. Thư viện chuẩn đánh dấu các Features thông tin xác thực của nó bằng một nhãn họ, và đọc nhãn đó là một cách để suy luận về chúng. Một vị từ rộng hơn hoặc hẹp hơn — một nhãn nội bộ, một quy tắc đặt tên, một tập kiểu được phê duyệt — đều sẵn có như nhau, vì thứ đến nơi là các nhãn chứ không phải một phán quyết về chúng.
- Đặt cổng kiểm soát dựa trên bất cứ thứ gì danh mục của bạn ghi trong siêu dữ liệu riêng của nó. Một tổ chức lưu trạng thái xem xét, nơi lưu trú dữ liệu hoặc quyền sở hữu dưới dạng chú thích trên các thực thể Feature của mình có thể yêu cầu chúng ở mọi phần gắn. Một quy tắc dựa trên một chú thích mà Aggrega chưa từng biết đến hoạt động tốt y như một quy tắc dựa trên một khóa mà nó cung cấp, vì các chú thích đến nơi đúng như đã viết — điều đó cũng có nghĩa là một Feature và một Component được phán xét trên cùng một nền tảng, mỗi cái theo siêu dữ liệu danh mục mà chính thực thể của nó khai báo.
- Quản lý việc thành phần trình ra cái gì cho ai. Một thông tin xác thực được viết trên một kết nối nêu tên kết nối đó, và cạnh của kết nối nêu tên đích của nó, nên một tổ chức có thể từ chối một thông tin xác thực được trình ra cho một thành phần nằm ngoài vùng tin cậy mà tổ chức đánh dấu bằng một nhãn riêng — một phán xét cần cả hai đầu của kết nối, điều mà không dữ kiện nào chỉ trên thành phần tiêu thụ cung cấp được.
Một vai trò phán quyết chấp nhận hoặc từ chối; nó không bao giờ viết lại. Bản build hoặc tiếp tục không thay đổi hoặc dừng với thông điệp của phán quyết, nên một chính sách không thể âm thầm làm cho một đồ thị không tuân thủ trở nên tuân thủ.
Chi tiết phần gắn đến với chính sách đánh giá đồ thị IR. Một chính sách đánh giá artifact đã render nhận các artifact đó và không nhận đồ thị nào, đó là một đặc tính của đầu vào ấy chứ không phải một hạn chế áp lên nó: hai giai đoạn trả lời các câu hỏi khác nhau, và tô-pô phần gắn không nằm trong số các câu hỏi có thể đặt ra cho đầu ra đã render.
Thể hiện các quy tắc của tổ chức bằng một ngôn ngữ chính sách
Các mẫu ở trên mô tả những gì một phần gắn quản trị làm; phần này nói về những gì doanh nghiệp viết để có được nó. Một nhóm nền tảng có năm mươi quy tắc cần phát biểu không muốn có năm mươi plugin. Họ muốn các quy tắc của mình ở dạng nội dung — các tệp mà họ xem xét, quản lý phiên bản và phát hành như mọi artifact khác — với một engine được gắn duy nhất để đánh giá chúng.
Đó là những gì một engine ngôn ngữ chính sách được gắn vào socket cung cấp, và hai engine như vậy được tích hợp sẵn trong trình biên dịch chính vì mục đích này: một engine Rego và một engine CEL. Nhà vận hành gắn một engine, khai báo các tệp chính sách mà nó cần tải, và các quy tắc chạy: không có chuỗi công cụ bên ngoài, không tải gì về tại thời điểm build và không có logic chính sách nào trong trình biên dịch. Việc đánh giá diễn ra bên trong guest WebAssembly, nơi toàn bộ tri thức miền cư trú.
Cùng một engine phục vụ mọi vai trò quản trị, nên một tổ chức bao phủ toàn bộ bề mặt của mình bằng một plugin được gắn và nhiều phần gắn của nó:
- Phán xét kiến trúc. Khi được gắn trên đồ thị build, một chính sách đọc mọi nút, cạnh và phần gắn mà trình biên dịch nắm giữ, cùng với các đường định tuyến được liệt kê bên cạnh chúng, và báo cáo những gì phải dừng bản build. Đây là nơi chứa một bất biến tô-pô, một quy tắc ủy quyền xuyên ranh giới hoặc một quy tắc luồng thông tin xác thực.
- Phán xét đầu ra. Khi được gắn trên các artifact đã render, một chính sách đọc các tệp mà bản build đã tạo ra — dưới dạng văn bản, và dưới dạng tài liệu đã phân tích cú pháp ở những nơi định dạng đã được phân tích trước chính sách — và báo cáo về kết quả cụ thể.
- Cung cấp siêu dữ liệu dẫn xuất. Khi được gắn để định hình nhãn, một chính sách quyết định các nút của bản build mang những nhãn nào, dựa trên môi trường của Release và những gì các nút đã khai báo. Đây là cơ chế mà mẫu 2 ở trên mô tả, với quy tắc được thể hiện dưới dạng nội dung chính sách thay vì một plugin được xây dựng chuyên biệt.
- Thêm một khả năng mà nhà phát triển không gõ vào. Khi được gắn để chèn chú thích, một chính sách thêm chú thích vào các thành phần của bản build; một chú thích dưới một khóa mà Manifest đăng ký một ràng buộc sẽ mở rộng thành một phần gắn Feature, nên một quy tắc doanh nghiệp có thể cung cấp lớp bọc mà thành phần cần thay vì chỉ từ chối sự vắng mặt của nó. Một quyết định ghi bất kỳ giá trị nào mà người vận hành có thể ghi trên chú thích đó — một chuỗi, hoặc một đối tượng gồm các khóa con cho một ràng buộc định tuyến nhiều giá trị — và bản build đọc nó đúng như cách đọc cùng giá trị đó được ghi trong Release. Quyết định chỉ có thể thêm: một giá trị sẽ xóa hoặc chọn không dùng một chú thích bị từ chối, và một giá trị được chèn mà bản build không thể định tuyến hoặc Feature được ràng buộc không chấp nhận bị từ chối, kèm tên plugin đã chèn nó.
Một quy tắc đọc những gì payload mang và báo cáo quyết định của mình dưới một khóa có tên:
# Evaluated by a governance verdict role over the assembled graphpackage acme.security
import rego.v1
deny contains msg if { some id, node in input.graph.spec.nodes node.labels["compliance.aggrega.ai/data-class"] == "restricted" not node.labels["acme.com/owner"] msg := sprintf("node %v holds restricted data and declares no owner.", [id])}Một quy tắc lần theo dữ liệu dọc theo đồ thị sẽ đọc các tuyến mà payload liệt kê. language-reference/examples/policy-data-class-route/ là một quy tắc như vậy, từ đầu đến cuối: nó dừng một bản build trong đó một thành phần chứa dữ liệu thuộc một lớp tiếp cận một thành phần thuộc lớp khác dọc theo một tuyến không có Feature hạ mức phân loại nào được gắn trên đó, và cùng Aggregate đó hoàn tất khi một Release định tuyến lưu lượng đó qua một gateway mang core/data-masking. Trình biên dịch mang nhãn lớp dưới dạng chuỗi và không xếp hạng gì — các lớp, thứ tự của chúng và các Features được tính là hạ mức phân loại là thiết lập của phần gắn. Quy tắc được viết một lần cho mỗi engine trong ba engine — hai engine được biên dịch vào CLI, và OPA đứng sau guest bộ điều hợp tham chiếu — mỗi bản sao độc lập, nên một bản build mà hai engine bất đồng sẽ cho thấy sự bất đồng đó.
Từ vựng riêng của chính sách được giữ nguyên. Các mức độ nghiêm trọng mà socket xử lý là một tập đóng, nhưng các tên mà chính sách dùng để gom các quyết định của nó thuộc về chính sách. Các tên mặc định là những tên theo quy ước mà một tập Rego vốn đã dùng, và nhà vận hành có chính sách đặt tên quyết định theo cách khác sẽ khai báo ánh xạ trong thiết lập của phần gắn — nhờ vậy một tổ chức đã duy trì sẵn một thư viện chính sách có thể áp dụng socket mà không phải viết lại thư viện. Ánh xạ được định kiểu bởi schema mà plugin khai báo cho thiết lập của nó, nên một ánh xạ sai định dạng sẽ dừng bản build trước khi bất kỳ chính sách nào chạy thay vì định tuyến sai một phán quyết.
Cả một thư viện chính sách di chuyển như một phần gắn duy nhất. Một bộ chính sách có thể được gắn từng tệp một, hoặc dưới dạng một kho lưu trữ duy nhất chứa cả các tệp chính sách và tài liệu dữ liệu của nó, được guest mở ra. Một kho lưu trữ không đọc được sẽ được báo cáo đúng như vậy, kèm tên tệp — không bao giờ như một bộ chính sách không đi đến quyết định nào, vì “thư viện không đọc được” không bao giờ được phép không phân biệt được với “thư viện đã cho phép bản build”.
Một chính sách không thể đánh giá sẽ dừng bản build. Khi một chính sách không thể được đánh giá, phần gắn thất bại và bản build dừng với một lỗi nêu tên plugin, được cố ý phân biệt với một phán quyết dừng bản build. Hai trường hợp này không được nhầm lẫn, và không trường hợp nào là một sự cho phép.
Toàn bộ bề mặt soạn thảo — payload mà mỗi vai trò cung cấp, các khóa quyết định, ánh xạ sang các mức độ nghiêm trọng, và cách gắn một kho lưu trữ — có trong language-reference/plugins/policy-socket.md.
Kế thừa và kỷ luật xuất bản
Kế thừa qua extends: là cơ chế danh mục cho phép các kiến trúc sư nền tảng xây dựng các thực thể con chuyên biệt trên các baseline dùng chung. Hai loại danh mục tách đường ở các trụ dữ liệu của chúng. Schema cha và con của một Feature được kết hợp tại thời điểm tải workspace, tạo ra một schema hợp nhất với nguồn gốc theo từng lá. Một Component mở rộng không viết nội dung trụ nào: nó viết dấu đánh dấu literal schema: inherited và nhận khối schema: của base đúng như base đã viết, ở mọi độ sâu của chuỗi.
Đó chính là điều giải quyết câu hỏi quản trị mà một baseline dùng chung đặt ra — một thực thể con được khai báo những ràng buộc nào so với base của nó. Với một Component, câu trả lời mang tính cấu trúc chứ không phải giám sát: hợp đồng đã khai báo của thực thể con đơn giản là hợp đồng của base, nên một ràng buộc của base không thể bị thực thể con nới lỏng, loại bỏ hay đổi kiểu, và không cần kiểm tra nào tại thời điểm xuất bản để giữ baseline nguyên vẹn. Một thực thể con thực sự cần một quy tắc chặt hơn so với base của nó khai báo sẽ thể hiện điều đó như một mục bổ sung trong khối assertions: của nó, mục này kết hợp bên cạnh các quy tắc của base thay vì thay thế chúng.
Những gì một Component con thực sự kết hợp là cấu trúc: các khe gắn (featuresSchema), socket tô-pô (usesSchema), danh sách cho phép tự chèn (inject) và các assertions có tên của nó đều được hợp nhất dọc theo chuỗi, với một mục được khai báo lại sẽ thay thế hoàn toàn mục của base.
Vị trí đặt quy tắc: quy tắc nào nằm trong plugin chính sách và quy tắc nào nằm trong schema của từng Component
Plugin kỷ luật xuất bản là nơi dành cho các quy tắc xuyên suốt áp dụng trên toàn danh mục: các quy tắc chuỗi cung ứng (ví dụ: “mọi Recipe phải implements: một Component tồn tại trong danh mục”), các quy tắc tuân thủ doanh nghiệp (ví dụ: “mọi Component có compliance.aggrega.ai/scope: pci-dss phải extends: baseline pci của doanh nghiệp”). Các quy tắc này trải qua nhiều thực thể, đánh giá workspace như một khối thống nhất, hoặc thực thi các quy ước tại thời điểm xuất bản thay vì tại thời điểm build.
Khai báo schema: của từng Component / từng Feature là nơi dành cho các ràng buộc theo thực thể: kiểu, phạm vi, mẫu, enum theo từng trường; các quy tắc liên trường được thể hiện trong khối assertions: chuyên dụng. Các ràng buộc này cục bộ trong một thực thể và đi cùng nó xuyên suốt danh mục.
Sự phân chia này không tùy tiện. Một quy tắc như “mọi trường bắt buộc phải có mặt” là một ràng buộc theo thực thể thuộc về các mảng required:. Một quy tắc như “mọi thực thể con mở rộng một cha pci-dss phải khai báo một nhãn quản trị cấp workspace” là một quy tắc liên thực thể mà plugin chính sách thực thi. Hai loại quy tắc này không bao giờ chồng lấn vì chúng trả lời những câu hỏi khác nhau: schema xác thực “instance này có khớp với hợp đồng của nó không”; plugin chính sách xác thực “danh mục này có thỏa mãn các quy tắc xuyên suốt mà workspace yêu cầu không”.
Khi soạn một quy tắc quản trị mới, câu hỏi về vị trí đặt là: quy tắc chỉ phụ thuộc vào nội dung của một thực thể đơn lẻ (→ schema hoặc khối assertions) hay phụ thuộc vào mối quan hệ giữa nhiều thực thể hoặc cấu hình cấp workspace (→ plugin chính sách). Mẫu Wasm-linter là cơ chế chuẩn tắc cho trường hợp xuyên suốt; các danh mục doanh nghiệp có thể phân phối các plugin chính sách tùy chỉnh tiêu thụ cùng giao diện hợp đồng plugin như plugin kỷ luật xuất bản chuẩn.
Kỷ luật tiền tố chú thích
Không gian tên chú thích mang ngữ nghĩa về nguồn gốc — các tiền tố khác nhau báo hiệu các đối tượng khác nhau và các cơ quan quản trị khác nhau. Tác giả danh mục, các nhóm nền tảng doanh nghiệp và chính nền tảng Aggrega đều ghi chú thích vào cùng một từ điển phẳng; chính tiền tố giữ cho các đối tượng tách biệt.
| Tiền tố | Nguồn gốc | Đối tượng | Khả năng thay đổi |
|---|---|---|---|
aggrega.ai/ (không có tên miền con) | Dành riêng: chỉ do trình biên dịch Aggrega phát ra | Công cụ nội bộ, đóng dấu nguồn gốc | Người dùng không thể tự viết; các chú thích dùng tiền tố không có tên miền con được khai báo trong nội dung người dùng sẽ bị từ chối tại thời điểm xuất bản |
<sub-domain>.aggrega.ai/ (ví dụ: component.aggrega.ai/, feature.aggrega.ai/, compliance.aggrega.ai/) | Quy ước danh mục | Kiến trúc sư viết các thực thể danh mục; các plugin chính sách Wasm tiêu thụ nhãn | Nhà xuất bản danh mục viết; bên tiêu thụ đọc |
<enterprise-domain>/ (ví dụ: acme.com/, my-org.io/) | Lớp phủ doanh nghiệp | Các nhóm nền tảng doanh nghiệp; các plugin Wasm của doanh nghiệp | Tác giả doanh nghiệp viết; trình biên dịch của nền tảng bỏ qua chúng như siêu dữ liệu không trong suốt |
<community-domain>/ (ví dụ: cncf.io/, kubernetes.io/) | Hệ sinh thái bên ngoài | Công cụ liên hệ sinh thái đọc các nhãn phổ biến | Do cộng đồng quản trị |
Tiền tố aggrega.ai/ không có tên miền con mang kỷ luật nghiêm ngặt nhất: nó chỉ dành riêng cho các chú thích do nền tảng phát ra. Trình biên dịch phát ra aggrega.ai/compiler-version, aggrega.ai/component-id, aggrega.ai/recipe-uri, aggrega.ai/boundary-path và các khóa nguồn gốc liên quan trên đầu ra đã kết xuất; nội dung người dùng khai báo trực tiếp một chú thích aggrega.ai/<key> sẽ bị từ chối tại thời điểm xuất bản. Kỷ luật này ngăn các chú thích do người dùng viết xung đột với thông tin nguồn gốc do nền tảng phát ra.
Các tiền tố tên miền con dưới <sub-domain>.aggrega.ai/ là không gian quy ước danh mục. Thư viện chuẩn sử dụng component.aggrega.ai/type (nhãn bản thể học cloud-native), feature.aggrega.ai/kind (sự phân chia Feature thành loại vận hành và loại thông tin xác thực), compliance.aggrega.ai/* (các nhãn trục tuân thủ) và các không gian tên con có phạm vi tương tự. Mỗi tên miền con do một đối tượng danh mục cụ thể quản trị: component.aggrega.ai/* do tác giả các thực thể Component, feature.aggrega.ai/* do tác giả các thực thể Feature, compliance.aggrega.ai/* do đối tượng chính sách tuân thủ. Việc đọc xuyên tên miền con (một plugin Wasm đọc từ nhiều không gian tên con) được cho phép nhưng hiếm gặp; mỗi plugin thường tự giới hạn trong một không gian tên con.
Các tiền tố tên miền doanh nghiệp (acme.com/..., my-org.io/...) là bề mặt mở rộng của nền tảng. Trình biên dịch Aggrega coi chúng là siêu dữ liệu không trong suốt; các plugin Wasm của doanh nghiệp tiêu thụ chúng. Doanh nghiệp viết bất kỳ cấu trúc tiền tố nào phù hợp với mô hình quản trị của mình — phẳng (acme.com/owner: team-payments), tên miền con (security.acme.com/scope: pii) hoặc phân cấp (org.acme.com/billing-center: finance). Nền tảng không ràng buộc bố cục tiền tố của doanh nghiệp; quy tắc duy nhất là các tiền tố doanh nghiệp không được xung đột với aggrega.ai/ hoặc các tên miền con của nó.
Kỷ luật này quan trọng vì chú thích lan truyền theo tầng — các chú thích được viết trên hệ thống con của một Aggregate lan tới mọi thành phần trong hệ thống con đó, các chú thích riêng của một thể hiện thành phần ghi đè chú thích của hệ thống con chứa nó, và các chú thích của một mô-đun tới được các thành phần riêng của mô-đun đó; các chú thích trên một ranh giới của một Release lan tới mọi thành phần trong ranh giới đó. Một chú thích dành cho nhà cung cấp tới được đầu ra đã kết xuất từ phía nào cũng được, và khi cả hai phía cùng ghi một khóa thì giá trị của Release là giá trị được áp dụng. Nếu không có kỷ luật tiền tố, một chú thích phía Aggregate có thể âm thầm ghi đè một khóa nguồn gốc do nền tảng phát ra, hoặc một chú thích doanh nghiệp có thể xung đột với một khóa quy ước danh mục. Bảng tiền tố làm cho các đối tượng trở nên tường minh và làm cho quy tắc ngăn xung đột có thể được thực thi tại thời điểm xuất bản.
Xem language-reference/vocabulary/labels-and-annotations.md để biết danh sách các bề mặt chú thích theo từng thực thể và ngữ nghĩa lan truyền ba ngăn (.context.annotations.release / .context.annotations.catalog / .context.annotations.aggregate).