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.

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ínhLoạiBắt buộcMô tả
capabilitystringkhôngCó 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_namestringkhôngCó sẵn trong directory: VÀ subDirectory:. Khóa map trong release.spec.boundaries..
parametersobjectkhôngCó 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_idstringkhôngCHỈ 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_boundaryobjectkhôngCó 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.
manifestobjectkhôngCó 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ínhLoạiBắt buộcMô tả
directorystringkhôngChuỗi directory đã được đánh giá của boundary cha.
boundary_namestringkhôngTên của boundary cha (khóa map trong release.spec.boundaries).
parametersobjectkhôngMap tham số của Release — chính là map mà .parameters mang.
annotationsmap của stringkhôngCá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ínhLoạiBắt buộcMô tả
recipe_namestringkhôngTê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.