Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Схема метаданных слота кэша 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

Свойства

СвойствоТипОбязательноОписание
kindenumдаВид источника, создавшего этот слот кэша. Повторяет перечисление source_artifacts[].kind из lock-файла; именно соответствующий вид читает каждый потребитель во время сборки, чтобы выбрать нужный загрузчик. Допустимые значения: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci"
urlstringдаУказанный автором 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_urlstringнетТолько сведения о происхождении: конкретное расположение артефакта, в которое разрешился указанный автором URL в момент загрузки. Для helm-источника в форме repo-root это прямой URL .tgz, в который индекс репозитория разрешил chart+version. Записывается для диагностики; не входит ни в какой контракт целостности. Отсутствует, если разрешённое расположение совпадает с указанным автором URL.
versionstringдаКонкретная версия, зафиксированная резолвером в момент загрузки. Для видов helm-* — версия чарта. Для git-repository — коммит, в который разрешилась указанная автором ссылка. Записывается как один сегмент пути, поскольку из неё строится слот кэша, в котором лежат эти метаданные, поэтому она не содержит /, \ и ... Шаблон: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringдаДайджест содержимого кэшированного архива .tar.gz в форме sha256:. Проверка во время сборки вычисляет SHA-256 файла blob.tgz, сравнивает его с этим полем И с дайджестом записи lock-файла и, если хотя бы один из них отличается, останавливает сборку, сообщая о несовпадении дайджеста содержимого. Шаблон: ^sha256:[a-f0-9]{64}$.
mediatypestringдаКанонический тип медиа, объявленный реестром (или значение по умолчанию для вида, если у вида нет метаданных реестра). Записывается как диагностические сведения о происхождении.
pulled_atstringдаМетка времени RFC 3339, фиксирующая системное время в момент загрузки. Только диагностические сведения о происхождении — не входит ни в какой контракт целостности. Шаблон при чтении метаданных требует, чтобы значение соответствовало формату RFC 3339. Шаблон: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$.

Дополнительные свойства не допускаются.