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.

Ngữ pháp URI và danh mục chuỗi định dạng

Các thực thể Aggrega tham chiếu lẫn nhau thông qua các chuỗi URI xuất hiện ở nhiều vị trí soạn thảo khác nhau. Cùng một dạng URI (core/postgres:1.0.0) xuất hiện trong năm ngữ cảnh loại thực thể trở lên, và trình biên dịch suy ra loại thực thể từ vị trí trong schema chứ không phải từ một ký hiệu hay tiền tố. Người soạn thảo khi đọc hoặc bảo trì một tệp YAML phải ghi nhớ các quy tắc diễn giải dựa trên vị trí để biết core/postgres:1.0.0 tham chiếu đến một kiểu Component, một module Aggregate, một Recipe, một FeatureRecipe hay một plugin Wasm.

Trang này tổng hợp ngữ pháp URI ở mọi vị trí, các quy tắc ưu tiên cho các khóa type: có phiên bản và không có phiên bản ở các tầng ánh xạ của Manifest, các quy tắc suy luận dạng viết tắt URI OCI, và danh mục chuỗi định dạng rộng hơn trong toàn bộ tài liệu (cú pháp Go template, các hàm Sprig, khai báo JSON Schema 2020-12, JSONPath, mẫu glob, biểu thức chính quy SemVer). Người soạn thảo cần biết “Aggrega làm gì với chuỗi này?” sẽ tìm thấy câu trả lời tại đây.

Suy luận loại thực thể dựa trên vị trí

Cùng một chuỗi URI mang ý nghĩa loại thực thể khác nhau tùy theo vị trí xuất hiện của nó trong schema. Bảng dưới đây liệt kê mọi vị trí mà Aggrega mong đợi một URI tham chiếu thực thể, cùng với loại thực thể được suy luận:

PositionLoại thực thể được suy luậnMở rộng đường dẫn OCI
Aggregate.spec.components.<id>.typeComponent/component/{publisher}/{category}/{name}
Aggregate.spec.subsystems.<name>.components.<id>.typeComponent (giống như components — subsystems là nhóm các component)/component/{publisher}/{category}/{name}
Aggregate.spec.aggregates.<id>.typeAggregate (module aggregate con)/aggregate/{publisher}/{name}
Aggregate.spec.components.<id>.features.<id>.typeFeature/feature/{publisher}/{name}
Aggregate.spec.components.<id>.features.<id>.typeFeature (thông tin xác thực — được gắn nhãn feature.aggrega.ai/kind: secret)/feature/{publisher}/{name}
Manifest.spec.mappings.components.type.<key>Component (URI được dùng làm khóa tra cứu); giá trị là một URI Recipekhóa: /component/; giá trị: /recipe/{provider}/{name}
Manifest.spec.mappings.components.name.<id>Recipe (ràng buộc ghi đè chi tiết)/recipe/{provider}/{name}
Manifest.spec.mappings.features.type.<key>Feature (khóa tra cứu); giá trị là một URI FeatureRecipekhóa: /feature/; giá trị: /featurerecipe/{provider}/{name}
Manifest.spec.mappings.features.name.<id>FeatureRecipe (ràng buộc ghi đè chi tiết)/featurerecipe/{provider}/{name}
Manifest.spec.mappings.features.annotations.<key>.featureFeature (ràng buộc qua annotation)/feature/{publisher}/{name}
Recipe.spec.implementsComponent (hợp đồng giao diện)/component/{publisher}/{category}/{name}
FeatureRecipe.spec.implementsFeature (hợp đồng giao diện)/feature/{publisher}/{name}
Component.spec.extends / Feature.spec.extendsComponent / Feature (cha trong chuỗi kế thừa)/component/{publisher}/{category}/{name} hoặc /feature/{publisher}/{name}
Manifest.spec.extendsManifest (cha trong chuỗi kế thừa ánh xạ)không phải vị trí URI — một đường dẫn tương đối, hoặc metadata.name trần của một Manifest nằm cạnh Release
Release.spec.extendsRelease (cha trong chuỗi kế thừa)không phải vị trí URI — một đường dẫn tương đối đến tệp Release, và không có dạng nào khác
Release.spec.aggregateAggregate (đích triển khai của Release)/aggregate/{publisher}/{name}
Release.spec.manifestManifest (lockfile ánh xạ của Release)không phải vị trí URI — một đường dẫn tương đối, hoặc metadata.name trần của một Manifest nằm cạnh Release
FeatureRecipe.spec.pipeline.<step>.pluginPlugin Wasm/plugin/{pluginType}/{name}

Ba vị trí được liệt kê vì tác giả thường dùng chúng với kỳ vọng là một URI, nhưng chúng không phải. Một Manifest và một Release là các tài liệu phía triển khai được viết cạnh nhau chứ không phải các thực thể được lập chỉ mục trong catalog, nên cả extends: của hai loại này lẫn manifest: của bất kỳ Release nào đều không được phân giải dựa trên catalog hay registry. manifest: của một Release chỉ định một tệp, hoặc metadata.name trần của một Manifest nằm cạnh Release. Ở hai vị trí extends:, giá trị chỉ định một tệp, và một tọa độ registry được viết ở một trong hai vị trí sẽ bị từ chối, với dạng được chấp nhận được nêu trong chẩn đoán. Hai vị trí extends: cũng không được viết giống nhau — một Manifest còn chấp nhận metadata.name trần của một Manifest nằm cạnh Release, trong khi một Release chỉ chấp nhận đường dẫn tương đối và không gì khác. Xem entities/release.md để biết dạng của Release và errors/fatal-halts.md để biết nội dung của từng lần từ chối.

Quy tắc suy luận: vị trí trong schema YAML xác định loại thực thể. Không có dấu hiệu bề mặt nào (sigil, tiền tố, annotation cấp schema) cho tác giả biết một trường type: cụ thể tham chiếu đến loại thực thể nào. Tác giả ghi nhớ các quy tắc dựa trên vị trí khi đọc YAML; công cụ (tự động hoàn thành trong trình soạn thảo, aggrega inspect) đọc cùng các quy tắc đó để đưa ra gợi ý riêng cho từng loại thực thể.

Hai dạng URI — plugin có tọa độ dẫn xuất và thực thể catalog có kind trong metadata

URI của một thực thể catalog không mang ký hiệu loại nào (phần trước). Các URI Plugin là điểm đối trọng có chủ ý: một URI plugin thực sự ghi một đoạn phân loại — loại socket của nó — trực tiếp trong đường dẫn. Hai họ tham chiếu được đọc khác nhau một cách có chủ đích, và việc biết một URI thuộc họ nào cho bạn biết cần tìm phân loại của nó ở đâu.

Tọa độ Plugin được suy ra từ loại của plugin. Một tham chiếu plugin có dạng oci://hub.aggrega.ai/plugin/<pluginType>/<name>. Tọa độ này được suy ra: đoạn <pluginType> và <name> trần đến từ khối định địa chỉ của plugin — metadata.pluginType và metadata.name — được ghép vào đường dẫn. Socket không được mã hóa theo đường dẫn vào tên; metadata.name là tên trần. Tọa độ suy ra CHÍNH LÀ khóa của registry (và của tập plugin nhúng), vì vậy registry tổ chức các plugin theo socket. Các plugin lõi được phân giải thành các tọa độ như plugin/provider/helm, plugin/linter/publishing và plugin/parser/yaml — mỗi tọa độ là sự ghép của một metadata.name trần (helm, publishing, yaml) với metadata.pluginType của nó (provider, linter, parser). Đoạn <pluginType> chính xác là loại socket của plugin: cùng một <name> trần dưới một pluginType khác là một plugin khác, vì tọa độ suy ra — và do đó danh tính — khác nhau. Để xem toàn bộ phân loại socket mà đoạn <pluginType> dùng để phân loại, hãy xem entities/plugin.md.

Thực thể catalog mang kind trong metadata. Tham chiếu được viết có dạng <publisher>/<category>/<name> (ví dụ, core/datastore/postgres). kind: của thực thể nằm trong tệp; kind thực thể của URI được suy ra từ vị trí trong schema, theo Suy luận kind thực thể dựa trên vị trí ở trên. Đường dẫn được tổ chức theo category, không theo kind: một Component mang một phân đoạn category (core/datastore/postgres); một Recipe hoặc FeatureRecipe mang khả năng render của nó làm phân đoạn đầu tiên (helm/postgres); các kind còn lại có dạng phẳng <publisher>/<name>. Không có gì trong đường dẫn viết ra kind của thực thể.

Vì sao hai dạng khác nhau. Plugin được tổ chức trong registry theo socket, nên phân đoạn socket là khóa registry tự nhiên và có mặt trong mọi URI plugin. Thực thể catalog được tổ chức trong registry theo category, nên category — không phải kind — là thứ đường dẫn viết ra. Do đó, một URI cho bạn biết socket của một plugin chỉ từ đường dẫn, nhưng chỉ cho bạn biết kind của một thực thể catalog sau khi bạn đọc tệp (kind nằm trong metadata, còn vị trí cung cấp nó tại nơi tham chiếu). Sự bất đối xứng này là có chủ ý: đường dẫn của mỗi họ phản ánh cách họ đó được tổ chức trong registry, chứ không phải một ngữ pháp thống nhất duy nhất áp đặt lên cả hai.

Dạng URI — có phiên bản và không có phiên bản

Mọi vị trí URI ở trên đều chấp nhận một tham chiếu ở một trong ba dạng — không có phiên bản, hoặc được ghim sau dấu hai chấm bằng một phiên bản chính xác hay một khoảng caret:

DạngVí dụNgữ nghĩa
Không có phiên bảncore/postgresPhân giải thành “phiên bản bất kỳ” hoặc “phiên bản đăng ký mới nhất”, tùy theo ngữ nghĩa phân giải của vị trí đó
Ghim chính xáccore/postgres:1.0.0Ghim vào một phiên bản cụ thể. Phiên bản là một phiên bản ngữ nghĩa, dạng mà metadata.version của mọi thực thể sử dụng
Ghim caretcore/postgres:^1.0.0Chọn phiên bản cao nhất tương thích với phiên bản được nêu — với ^1.0.0, là từ 1.0.0 trở lên và thấp hơn 2.0.0

Ghim là phần văn bản sau dấu hai chấm cuối cùng của tham chiếu, và chỉ khi phần văn bản đó không chứa /. Vì vậy, một tham chiếu đến một máy chủ registry có cổng — localhost:5000/core/postgres — không mang ghim: phần văn bản sau dấu hai chấm của cổng là phần tiếp theo của tham chiếu.

Một ghim không thuộc dạng nào trong các dạng này — một caret mà phần văn bản không đọc được như một khoảng phiên bản (core/postgres:^garbage), hoặc một ghim chính xác không phải là phiên bản ngữ nghĩa (core/postgres:1.x, core/postgres:1.0, core/postgres:v1.0.0) — không nêu phiên bản nào cả. Khi một lệnh phân giải một tham chiếu như vậy và tham chiếu không phân giải được, thông báo từ chối nêu tham chiếu, ghim và ba dạng ở trên, thay vì báo về một thực thể hay một phiên bản mà catalog không có; chẩn đoán này được mô tả trong errors/fatal-halts.md dưới mục “A version pin is none of the forms a pin takes (Ghim phiên bản không thuộc dạng nào mà một ghim có)”. Ghim chỉ được đánh giá tại đó, nên một ghim sai dạng không bao giờ làm thay đổi những tham chiếu nào được phân giải, và một ghim đúng dạng mà không phiên bản khả dụng nào thỏa mãn sẽ được báo đúng như vậy. Không có schema nào nêu ngữ pháp của ghim, nên một ghim sai dạng được báo khi có thứ gì đó phân giải tham chiếu — aggrega validate, aggrega pull, aggrega build — chứ không phải khi tệp được nạp.

Các dạng cùng tồn tại trong cùng một vị trí. Tác giả lựa chọn dựa trên việc họ cần ghim phiên bản hay cần linh hoạt về phiên bản. Tầng mappings.{components,features}.type của Manifest hỗ trợ cả hai biến thể dưới dạng các khóa từ điển riêng biệt với thứ tự ưu tiên có phiên bản thắng không có phiên bản — một khóa có phiên bản (core/api-server:1.0.0) được ưu tiên hơn khóa không có phiên bản (core/api-server) khi cả hai cùng khớp một lần tra cứu. Hai biến thể không loại trừ nhau; cả hai có thể nằm trong cùng một map type: và bộ phân giải chọn khóa cụ thể nhất. Việc điều phối Provider bắt nguồn từ trường spec.capability của Recipe đã phân giải, nên Manifest chỉ ánh xạ một kiểu tới một Recipe và không gì hơn.

Về cơ chế sử dụng phiên bản theo từng thực thể (những thực thể nào thực sự có trường phiên bản được dùng cho điều phối phân giải, so với chỉ mang tính mô tả nguồn gốc), xem vocabulary/inheritance-and-interface.md mục “Sử dụng phiên bản giữa các thực thể”.

Một tham chiếu đến một Component, Feature, Aggregate hoặc Plugin cũng chấp nhận một khoảng caret (core/postgres:^1.0.0), và dù ở dạng nào, nó chọn phiên bản thỏa mãn cao nhất trong số các phiên bản catalog có, theo một quy tắc duy nhất mà mọi lệnh đều áp dụng — xem version-resolution.md. Về việc khớp implements: theo ba dạng, vốn là phép kiểm tra tính nhất quán của một ánh xạ chứ không phải một phép chọn, xem 10-status.md mục “Khớp phiên bản”.

Định danh, không phải vị trí

Một tham chiếu thực thể chuẩn tắc — kể cả tham chiếu plugin — là một định danh, không phải một vị trí: nó gọi tên thực thể là gì, không bao giờ nói thực thể hiện nằm ở đâu.

Định danh này trần và không chứa host. Nó không mang registry host nào; host là một tọa độ phân giải do cấu hình cung cấp thông qua default_registry và được gắn vào lúc phân giải. Việc chuyển chỗ một registry, hay mirror cùng một thực thể ở nơi khác, là một thay đổi cấu hình — các tham chiếu gọi tên thực thể vẫn giữ nguyên.

Định danh này cũng không chứa phiên bản. Một tham chiếu có thể mang một pin phiên bản tùy chọn (:<version> hoặc :^<version>) để giới hạn những phiên bản nào thỏa mãn nó, và mỗi Release ghi lại phiên bản đã phân giải chính xác dưới dạng một pin trong lockfile của nó, nhưng phiên bản được cung cấp kèm theo định danh chứ không được gắn cứng vào định danh.

Vào lúc phân giải, trình biên dịch ghép định danh trần với host đã cấu hình và phiên bản đã pin để đi đến các byte cụ thể. Vì cả hai được cung cấp riêng biệt, cùng một tham chiếu có thể phân giải với một registry khác hoặc một phiên bản đã pin khác mà không cần sửa mã nguồn gọi tên nó.

Suy luận dạng viết tắt của URI OCI

Tác giả không phải viết mọi URI dưới dạng URI OCI đầy đủ. Trình biên dịch áp dụng bốn quy tắc suy luận trực giao để mở rộng các dạng viết tắt thành URI OCI chuẩn tại thời điểm phân giải. Các quy tắc:

Quy tắc 1 — Tên miền mặc định

Mọi URI thiếu tên miền đều được thêm tiền tố là default_registry được cấu hình trong .aggrega-config.yaml (mặc định: hub.aggrega.ai/).

# Shorthand
type: core/postgres:1.0.0
# Equivalent canonical form
type: hub.aggrega.ai/component/core/postgres:1.0.0

Quy tắc 2 — Mở rộng thực thể theo ngữ cảnh

Trình biên dịch nối thêm phân đoạn loại thực thể phù hợp dựa trên vị trí trong schema. Ánh xạ giống với bảng suy luận theo vị trí ở trên (/component/, /aggregate/, /recipe/, /featurerecipe/, /feature/, /plugin/).

# Same string, two positions, two expansions
Aggregate.spec.components.foo.type: core/postgres:1.0.0
# → hub.aggrega.ai/component/core/postgres:1.0.0
Manifest.spec.mappings.components.type."core/postgres:1.0.0": helm/postgres:1.0.0
# Key: hub.aggrega.ai/component/core/postgres:1.0.0
# Value: hub.aggrega.ai/recipe/helm/postgres:1.0.0

Quy tắc 3 — Thứ tự ưu tiên ba tầng

Trước khi áp dụng suy luận OCI, trình biên dịch phân giải URI thông qua Mô hình phân giải thực thể ba tầng được mô tả tại architecture/13-catalog-and-registry.md:

  1. Đường dẫn cục bộ — cho các tài liệu mà một Release và Manifest của nó chỉ định. aggregate, manifest hoặc extends của một Release, hoặc extends của một Manifest, khi được viết với tiền tố ./ hoặc ../ sẽ được đọc như một tệp tương đối so với thư mục riêng của Release; suy luận OCI không chạy. Không vị trí nào khác nhận đường dẫn: một type, một khóa hoặc giá trị ánh xạ của Manifest, một implements hoặc một plugin của pipeline được viết dưới dạng ./… không chỉ định thực thể nào và sẽ dừng bản build. Một thực thể được viết cục bộ được đặt dưới catalog/ ở gốc workspace hoặc trong một thư mục mà workspace.catalog_dirs liệt kê, và được phân giải theo tên của nó qua tầng workspace và bộ nhớ đệm.
  2. Workspace và bộ nhớ đệm — Ngăn xếp tìm kiếm catalog của workspace, rồi đến bộ nhớ đệm. Các thư mục catalog_dirs: của workspace trong .aggrega-config.yaml — hoặc, với một Release mà cấu hình cấp thư mục riêng dưới workspace.releases, thì các thư mục của Release đó — được tìm theo thứ tự đã viết, và thư mục catalog/ ở gốc workspace được tìm cuối cùng — sau mọi mục đã liệt kê, và chỉ khi thư mục đó tồn tại. Một kết quả khớp ở bất kỳ đâu trong ngăn xếp sẽ bỏ qua suy luận OCI. Nếu không khớp, trình biên dịch tra cứu artifact_cache_dir, nơi chứa những gì các lần kéo từ registry trước đó đã tải về.
  3. Registry. Khi tầng workspace và bộ nhớ đệm không khớp, các quy tắc suy luận OCI được áp dụng và tham chiếu được tải từ registry từ xa bằng aggrega pull, hoặc bằng một bản build chạy với --auto-pull hay thiết lập auto_pull của workspace; một bản build không có cả hai chỉ đọc những gì lockfile của nó ghim.

Cơ chế tầng nấc này cho phép một dự án kết hợp các tài liệu mà một Release chỉ định bằng đường dẫn (tầng đường dẫn cục bộ) với nội dung catalog được vendor và nội dung catalog cục bộ của workspace (tầng workspace và bộ nhớ đệm) cùng nội dung registry được tải từ xa (tầng registry), và một tham chiếu thực thể được viết giống nhau bất kể tầng nào trong hai tầng sau chứa thực thể.

Khi catalog_dirs: liệt kê nhiều hơn một thư mục, danh sách là một ngăn xếp ưu tiên có thứ tự, mục đầu tiên thắng: một định danh thực thể có mặt trong nhiều thư mục được liệt kê sẽ được phân giải tới thư mục liệt kê sớm nhất, và lần xuất hiện sau bị che khuất (bị ghi đè, không phải lỗi) — vì vậy một dự án có thể đặt thư mục catalog của riêng mình trước một thư mục dùng chung và ghi đè các thực thể theo định danh, trong khi phần còn lại vẫn rơi xuống thư mục sau. Việc ghi đè được báo cáo trong chi tiết phân giải. Hai tệp cùng khai báo một định danh trong cùng một thư mục vẫn là một lỗi soạn thảo làm dừng quá trình tải.

Thư mục catalog/ ở gốc workspace nằm ở cuối ngăn xếp đó chứ không phải ở đầu, nên bất cứ thứ gì dự án liệt kê đều thắng nó khi xung đột, và việc liệt kê một thư mục không liên quan không bao giờ ngăn nó được đọc. Nó bị bỏ qua khi một mục đã liệt kê đã bao gồm nó — việc duyệt một thư mục được liệt kê là đệ quy, nên một ngăn xếp có nêu gốc workspace thì đã đọc nó rồi. Bỏ qua catalog_dirs: và viết nó thành danh sách rỗng là hai khai báo khác nhau: khi bỏ qua, workspace vẫn đọc catalog/; khi viết là [], nó không đọc catalog cục bộ nào cả, đó là cách một workspace khai báo rằng nó không có catalog.

Quy tắc 4 — Xử lý phiên bản

Một URI có thể có hoặc bỏ qua phân đoạn phiên bản. Cách xử lý phiên bản phụ thuộc vào vị trí phân giải (phân giải tầng Manifest, khớp implements:, import sub-aggregate) theo các quy tắc sử dụng phiên bản riêng của vị trí đó. Xem mục “Cross-entity version consumption” trong inheritance-and-interface.md để biết ngữ nghĩa phiên bản theo từng thực thể.

Danh mục chuỗi định dạng

Ngoài các chuỗi URI, bề mặt soạn thảo của Aggrega còn có một số quy ước chuỗi định dạng riêng biệt. Người soạn thảo khi viết hoặc đọc các tệp YAML sẽ gặp các định dạng sau ở những vị trí khác nhau:

Định dạngNơi viếtĐược xác thực bởi
Go template ({{ .field }})Recipe valuesMapping: / workload: / artifacts: / provides: / locals: / source:; FeatureRecipe injectMapping: / pipeline with:; nội suy parameters: của Aggregate; Release directory: / subDirectory:Trình phân tích Go template tại thời điểm đánh giá; quy tắc khả dụng theo từng vị trí tại templates/expansion-matrix.md
Tham chiếu hàm Sprig ({{ default 1 .v }} v.v.)Cùng các bề mặt như Go templateFuncMap của Sprig v3 được đăng ký khi khởi tạo template engine; danh sách hàm trợ giúp đầy đủ tại templates/sprig-functions.md
JSON Schema 2020-12 (dạng rút gọn hoặc đầy đủ)Nội dung schema: của Component / Feature (hoặc một $ref: tới một mục SchemaLibrary)Trình xác thực JSON Schema khi nạp thực thể trong quá trình phân giải
JSON Pointer (RFC 6901)Các khóa locals.<*_path>: của Recipe (volumes_path, containers_path, v.v.); tham chiếu đầu ra của bước pipeline: trong FeatureRecipe; payload JSONPatch của plugin WasmCơ sở RFC 6901 theo hợp đồng plugin Wasm; được khai báo trong plugins/plugin-contract.md
Biểu thức chính quy SemVerCác trường metadata.version trên mọi thực thểBiểu thức chính quy JSON Schema ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-...)?$ theo schema của từng thực thể
Ghim phiên bản (:<version>, :^<version>)Phân đoạn phiên bản của một tham chiếu thực thể, tại mọi vị trí URI nêu trênTrình biên dịch, khi phân giải tham chiếu: một ghim chính xác phải là một phiên bản ngữ nghĩa và phạm vi của một ghim dấu mũ phải phân tích được, còn một ghim sai định dạng bị từ chối theo điều kiện riêng của nó — xem Dạng URI ở trên
Đường dẫn hệ thống tệpĐường dẫn tương đối theo catalog (ví dụ: các mục catalog_dirs: trong .aggrega-config.yaml); đường dẫn tệp $import: của Recipe trong workload: / artifacts: / valuesMapping:Được đọc đúng như đã viết khi phân giải — một mục catalog_dirs: tương đối so với tệp cấu hình khai báo nó, một đường dẫn $import: tương đối so với thư mục riêng của thực thể; không glob nào được mở rộng, nên * chỉ một tệp hoặc thư mục có đúng tên đó
Biểu thức bộ chọn nhãnComponent.spec.usesSchema.<socket>.selector; Feature appliesTo: / appliesToAnyOf:Trình phân tích bộ chọn của Aggrega tại nơi bộ chọn được đánh giá; ngữ pháp bộ chọn được mô tả tại vocabulary/modifier-system.md
Dạng khóa chú thích (<namespace>/<name>)Các khóa metadata.annotations; các khóa features.annotations của Manifest; lan truyền chú thích ranh giớiBiểu thức chính quy JSON Schema theo từng thực thể; nguyên tắc tiền tố dành riêng tại vocabulary/labels-and-annotations.md
Tên Provider, có thể ghim phiên bản (helm, helm:^1.0.0)Recipe.spec.capability; FeatureRecipe.spec.capabilityTra cứu để điều phối Provider; một pin mà không phiên bản plugin nào thỏa mãn sẽ dừng bản build
Khóa phân phối inject (env.<KEY>, file.<path>, arg.<flag>)Các khối inject: của Aggregate; đầu ra injectMapping: của FeatureRecipeSchema inject tại vocabulary/topology-triad.md

Mỗi định dạng có ngữ pháp riêng, trình xác thực riêng và cách báo lỗi riêng. Người soạn thảo gặp lỗi phân tích chuỗi định dạng hãy đọc tài liệu tham chiếu của định dạng đó để biết các quy tắc cú pháp.

Trình soạn thảo báo các lỗi này ngay khi bạn viết: aggrega serve kiểm tra từng tài liệu được gửi tới nó theo schema của loại tài liệu đó và trả về cùng kết luận mà một bản build sẽ đưa ra (xem cli/aggrega-serve.md “Kiểm tra trực tiếp”), và aggrega scaffold soạn sẵn một tài liệu khởi đầu thuộc bất kỳ loại nào.

Tham chiếu chéo