Цю сторінку перекладено машинним способом. Читати оригінал англійською.
Схема метаданих слота кешу Aggrega
Згенерований довідник. Не редагуйте вручну — згенеруйте повторно з опублікованої JSON Schema.
Ідентифікатор схеми: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
Файл metadata.yaml, що записується в кожен слот кешу вихідних артефактів поруч із blob.tgz. Фіксує кортеж ідентичності {kind, url, version, digest, mediatype, pulled_at}, щоб перегляд кешу та перевірка цілісності під час збирання мали єдиний канонічний запис. Форма даних закрита (additionalProperties: false), і всі шість полів обов’язкові. Дисципліна еволюції схеми: додавання нового необов’язкового поля є SemVer-MINOR (адитивна зміна); видалення поля або посилення обмеження є SemVer-MAJOR.
Тип верхнього рівня: object
Властивості
| Властивість | Тип | Обов’язкова | Опис |
|---|---|---|---|
kind | enum | так | Вид джерела, що створив цей слот кешу. Відповідає переліку source_artifacts[].kind у lock-файлі; саме відповідний вид зчитує кожен споживач під час збирання, щоб вибрати потрібний завантажувач. Допустимі значення: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | так | Указаний автором URL — URL ідентичності, як його записано в spec.source.url сутності Recipe. Для helm-https-chart це корінь репозиторію (форма repo-root) або прямий .tgz (пряма форма) точно так, як указано автором. Для git-repository — URL репозиторію, який можна клонувати. Для helm-oci-chart — посилання на реєстр. Для compose-https-fragment — HTTPS URL фрагмента. Розв’язане розташування артефакту для helm-джерела з коренем репозиторію записується окремо в resolved_url: як відомості про походження. |
resolved_url | string | ні | Лише відомості про походження: конкретне розташування артефакту, до якого було розв’язано вказаний автором URL під час завантаження. Для helm-джерела з коренем репозиторію це прямий URL .tgz, до якого індекс репозиторію розв’язав chart+version. Записується для діагностики; не входить до жодного контракту цілісності. Відсутнє, коли розв’язане розташування збігається з указаним автором URL. |
version | string | так | Конкретна версія, яку резолвер закріпив під час завантаження. Для видів helm-* — версія чарту. Для git-repository — коміт, до якого було розв’язано вказане автором посилання. Записується як один сегмент шляху, оскільки з неї будується слот кешу, у якому лежать ці метадані, тому вона не містить /, \ і ... Шаблон: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | так | Дайджест вмісту кешованого архіву .tar.gz у формі sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | так | Канонічний тип медіа, оголошений реєстром (або типовий для виду, якщо вид не має метаданих реєстру). Записується як діагностичні відомості про походження. |
pulled_at | string | так | Позначка часу RFC 3339, що фіксує системний час на момент завантаження. Лише діагностичні відомості про походження — не входить до жодного контракту цілісності. Шаблон утримує значення у формі RFC 3339 під час зчитування метаданих. Шаблон: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Додаткові властивості не дозволені.