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.

Lược đồ Aggrega Catalog (ArtifactLibrary)

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.

Id lược đồ: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json

Một tập hợp có thể tái sử dụng gồm các gói artifact được đặt tên, mà các Recipes và FeatureRecipes sử dụng tại thời điểm render thông qua artifacts.<name>: { $import: ... }. Mỗi gói là một tập hợp các tệp đầu ra được nhập như một đơn vị. Cấp 3 — tùy chọn bật cho các catalog cần tái sử dụng artifact giữa các Recipe. Chế độ soạn thảo duy nhất: chỉ Go template.

Xem tài liệu tham khảo soạn thảo ArtifactLibrary để có hướng dẫn dạng văn xuôi về việc soạn thảo các thực thể ArtifactLibrary; trang này mô tả lược đồ cấu trúc mà tài liệu tham khảo đó trình bày.

Kiểu cấp cao nhất: object

Thuộc tính

Thuộc tínhLoạiBắt buộcMô tả
apiVersionconst “aggrega.ai/v1beta1”cóHằng số: "aggrega.ai/v1beta1"
kindconst “ArtifactLibrary”cóHằng số: "ArtifactLibrary"
metadataobjectcó
specobjectcóNội dung của ArtifactLibrary. spec.artifacts là bắt buộc và phải khai báo ít nhất một gói. spec mang additionalProperties: false — không chấp nhận các chế độ soạn thảo song song ở cấp envelope. Lập trường một chế độ soạn thảo duy nhất giữ cho việc render đồng nhất (Go template xuyên suốt) và tránh buộc tác giả phải chuyển đổi mô hình đánh giá giữa chừng khi render lúc sử dụng các gói được nhập.

Không cho phép thuộc tính bổ sung.

artifactlibrary.metadata

Thuộc tínhLoạiBắt buộcMô tả
namestringcóĐịnh danh PascalCase cho thư viện. Đây là tên trong tham chiếu định danh tên trần #/artifacts/; phiên bản do lockfile của từng Release cung cấp và không có máy chủ registry nào xuất hiện trong tham chiếu hay bất kỳ định danh dẫn xuất nào. Mẫu: ^[A-Z][A-Za-z0-9]*$.
versionstringcóPhiên bản theo Semantic Versioning nghiêm ngặt của thư viện (ví dụ: 1.0.0). Bên sử dụng có thể khẳng định giá trị này như một mức phiên bản tối thiểu :<version> tùy chọn trong tham chiếu tên trần (:#/artifacts/); lockfile của từng Release sở hữu phiên bản đã được phân giải. Mẫu: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstringkhôngBản tóm tắt ngắn gọn về phạm vi của thư viện.
labelsmap của stringkhôngCác nhãn do tác giả khai báo. Trình biên dịch trung lập về nội dung và không diễn giải giá trị nhãn: chúng là metadata không trong suốt, được mang theo để bất cứ thứ gì đọc thư viện dùng làm căn cứ so khớp.
annotationsmap của stringkhôngCác chú thích do tác giả khai báo. Cùng lập trường siêu dữ liệu không trong suốt như nhãn.

Không cho phép thuộc tính bổ sung.

artifactlibrary.spec

Nội dung của ArtifactLibrary. spec.artifacts là bắt buộc và phải khai báo ít nhất một gói. spec mang additionalProperties: false — không chấp nhận các chế độ soạn thảo song song ở cấp envelope. Lập trường một chế độ soạn thảo duy nhất giữ cho việc render đồng nhất (Go template xuyên suốt) và tránh buộc tác giả phải chuyển đổi mô hình đánh giá giữa chừng khi render lúc sử dụng các gói được nhập.

Thuộc tínhLoạiBắt buộcMô tả
artifactsmap của map của stringcóMap được đặt tên gồm các gói artifact có thể tái sử dụng. Mỗi gói nhóm các tệp đầu ra đi cùng nhau (ví dụ một CRD, RBAC của nó và một ConfigMap). Nội dung mỗi tệp là không trong suốt đối với việc xác thực envelope — ngữ nghĩa nội dung do trình phân tích Go template xử lý tại thời điểm sử dụng. Khóa: định danh PascalCase. Các khóa mục xuất hiện trong URL tham chiếu chuẩn (#/artifacts/<name>); ràng buộc ở cấp envelope ngăn các khóa không theo PascalCase lan truyền trong hệ sinh thái catalog. chỉ đến toàn bộ gói, không bao giờ chỉ đến một tệp riêng lẻ bên trong. Mẫu: ^[A-Z][A-Za-z0-9]*$. Ít nhất 1 mục.

Không cho phép thuộc tính bổ sung.