Схема метаданных слота кэша 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-источника в форме repo-root записывается отдельно в resolved_url: как сведения о происхождении. |
resolved_url | string | нет | Только сведения о происхождении: конкретное расположение артефакта, в которое разрешился указанный автором URL в момент загрузки. Для helm-источника в форме repo-root это прямой 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})$. |
Дополнительные свойства не допускаются.