Schema ngữ cảnh Path-Template của Aggrega
Tài liệu tham khảo được sinh tự động. Không chỉnh sửa thủ công — hãy sinh lại từ JSON Schema đã xuất bản.
Schema id: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
Danh sách biến được phép mà các Go template sử dụng khi được đánh giá trên Release.spec.boundaries[].directory và Release.spec.boundaries[].subDirectory (cùng phần ghi đè subDirectory theo từng component) khi Aggrega build Release. Path template dùng missingkey=error (khác với chế độ missingkey=zero toàn cục cho value template) cùng với xác thực tại thời điểm phân tích cú pháp: mọi tham chiếu trường trong một path template phải xuất hiện trong danh sách được phép này cho ngữ cảnh tương ứng (directory: hoặc subDirectory:); các trường không xác định gây ra lỗi Loud Guardrail tại thời điểm phân tích cú pháp, không bao giờ tại thời điểm render. Trang Path-Template Variables trong tài liệu tham khảo ngôn ngữ giải thích sự khác biệt so với value template.
Kiểu cấp cao nhất: object
Thuộc tính
| Thuộc tính | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
capability | string | không | Có sẵn trong directory: VÀ subDirectory:. Năng lực render mà Recipe của component đóng góp khai báo trong spec.capability, đã loại bỏ mọi ghim phiên bản — ví dụ ‘helm’, ‘helm-chart’ hoặc ‘compose’. subDirectory: mặc định là {{ .capability }}, chính điều này đặt các artifact của mỗi năng lực vào thư mục con riêng bên dưới directory của boundary. Trong một template directory:, giá trị được phân giải theo từng component, nên một boundary có cây con đóng góp nhiều hơn một năng lực sẽ được đánh giá thành một thư mục cho mỗi năng lực; lượt duyệt riêng theo từng boundary để công bố .parent_boundary.directory chạy trước khi bất kỳ component nào được gắn và để trống giá trị này. |
boundary_name | string | không | Có sẵn trong directory: VÀ subDirectory:. Khóa map trong release.spec.boundaries. |
parameters | object | không | Có sẵn trong directory: VÀ subDirectory:. Map tham số có kiểu từ Release. Path template được truy cập .parameters như một ngoại lệ có chủ đích so với vòng đời một lượt của parameters — value template KHÔNG nhận .parameters; các giá trị mang tính môi trường đi vào value template thông qua YAML của Aggregate đã được nội suy. |
component_id | string | không | CHỈ có sẵn trong subDirectory:. Định danh của bên đóng góp đang được đặt vào vị trí. Với một component, đó là ID instance theo từng component đã được làm phẳng (ví dụ: ‘backend’ hoặc ‘data-layer.main-db’). Với một Feature được gắn tại một boundary có FeatureRecipe chạy một lần cho boundary đó (executionScope: boundary), đó là định danh component được ghép mà mọi tài nguyên do attachment đó phát ra mang trong nhãn aggrega.ai/component-id của nó (ví dụ: ‘bfr—app—shared’ cho một attachment ‘shared’ tại boundary ‘app’), được rút ngắn ở nơi plugin render của attachment giới hạn tên, để thư mục mà nó đặt tên khớp với nhãn đó. Vô nghĩa ở cấp boundary và bị từ chối bởi bước xác thực lúc phân tích cú pháp trong các template directory:. |
parent_boundary | object | không | Có sẵn trong directory: VÀ subDirectory:. Các giá trị đã được phân giải của boundary cha. Được điền thông qua một lượt duyệt theo chiều sâu, đánh giá các template của từng boundary với các giá trị đã phân giải của boundary cha; boundary con không bao giờ thấy các giá trị của chính nó ở đây. Một boundary cấp cao nhất không có boundary cha, nên việc đọc một khóa dưới parent_boundary tại đó sẽ dừng build, kèm tên boundary, trường template và khóa bị thiếu. |
manifest | object | không | Có sẵn trong directory: VÀ subDirectory:. Chứa metadata của Recipe đã phân giải, được đánh giá theo từng component. |
Không cho phép thuộc tính bổ sung.
path-template-context.parent_boundary
Có sẵn trong directory: VÀ subDirectory:. Các giá trị đã được phân giải của boundary cha. Được điền thông qua một lượt duyệt theo chiều sâu, đánh giá các template của từng boundary với các giá trị đã phân giải của boundary cha; boundary con không bao giờ thấy các giá trị của chính nó ở đây. Một boundary cấp cao nhất không có boundary cha, nên việc đọc một khóa dưới parent_boundary tại đó sẽ dừng build, kèm tên boundary, trường template và khóa bị thiếu.
| Thuộc tính | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
directory | string | không | Chuỗi directory đã được đánh giá của boundary cha. |
boundary_name | string | không | Tên của boundary cha (khóa map trong release.spec.boundaries). |
parameters | object | không | Map tham số của Release — chính là map mà .parameters mang. |
annotations | map của string | không | Các annotation của boundary cha sau khi cascade được phân giải. |
Không cho phép thuộc tính bổ sung.
path-template-context.manifest
Có sẵn trong directory: VÀ subDirectory:. Chứa metadata của Recipe đã phân giải, được đánh giá theo từng component.
| Thuộc tính | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
recipe_name | string | không | Tên của Recipe đã phân giải từ phép tra cứu theo từng component. |
Không cho phép thuộc tính bổ sung.