Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.
Schema siêu dữ liệu ô bộ nhớ đệm 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.
Id của schema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
Tệp metadata.yaml được ghi vào mọi ô bộ nhớ đệm của source-artifact, bên cạnh blob.tgz. Tệp này ghi lại bộ định danh {kind, url, version, digest, mediatype, pulled_at} để việc kiểm tra bộ nhớ đệm và việc xác minh tính toàn vẹn lúc build có một bản ghi chuẩn duy nhất. Cấu trúc dữ liệu là đóng (additionalProperties: false) và cả sáu trường đều bắt buộc. Nguyên tắc phát triển schema: thêm một trường tùy chọn mới là SemVer-MINOR (bổ sung); xóa một trường hoặc thắt chặt một ràng buộc là SemVer-MAJOR.
Kiểu cấp cao nhất: object
Thuộc tính
| Thuộc tính | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
kind | enum | có | Loại nguồn đã tạo ra ô bộ nhớ đệm này. Phản ánh enum source_artifacts[].kind của lockfile; loại tương ứng là thứ mà mọi thành phần sử dụng lúc build đọc để chọn đúng trình tải. Giá trị cho phép: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | có | URL do tác giả viết — URL định danh đúng như được viết trong spec.source.url của Recipe. Với helm-https-chart, đây là gốc kho (dạng repo-root) hoặc tệp .tgz trực tiếp (dạng trực tiếp) đúng như được viết. Với git-repository, đây là URL kho có thể clone. Với helm-oci-chart, đây là tham chiếu registry. Với compose-https-fragment, đây là URL HTTPS của fragment. Vị trí artifact đã phân giải của một nguồn helm dạng repo-root được ghi riêng dưới resolved_url: làm thông tin nguồn gốc. |
resolved_url | string | không | Chỉ là thông tin nguồn gốc: vị trí artifact cụ thể mà URL do tác giả viết đã phân giải thành tại thời điểm pull. Với một nguồn helm dạng repo-root, đây là URL .tgz trực tiếp mà chỉ mục kho đã phân giải chart+version thành. Được ghi lại để chẩn đoán; không thuộc bất kỳ hợp đồng toàn vẹn nào. Không có khi vị trí đã phân giải trùng với URL do tác giả viết. |
version | string | có | Phiên bản cụ thể mà trình phân giải đã ghim tại thời điểm pull. Với các loại helm-*, đây là phiên bản chart. Với git-repository, đây là commit mà tham chiếu do tác giả viết đã phân giải thành. Được ghi dưới dạng một đoạn đường dẫn duy nhất, vì nó tạo nên ô bộ nhớ đệm chứa siêu dữ liệu này, nên nó không chứa /, không chứa \ và không chứa ... Mẫu: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | có | Digest nội dung của kho lưu trữ .tar.gz đã lưu đệm, ở dạng sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | có | Kiểu media chuẩn mà registry đã công bố (hoặc giá trị mặc định của loại đối với các loại không có siêu dữ liệu registry). Được ghi lại để làm thông tin nguồn gốc cho chẩn đoán. |
pulled_at | string | có | Dấu thời gian RFC 3339 ghi lại giờ thực tại thời điểm pull. Chỉ là thông tin nguồn gốc cho chẩn đoán — không thuộc bất kỳ hợp đồng toàn vẹn nào. Mẫu (pattern) buộc giá trị theo đúng dạng RFC 3339 khi siêu dữ liệu được đọc. Mẫu: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Không cho phép thuộc tính bổ sung.