Перейти до вмісту
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-джерела з коренем репозиторію записується окремо в resolved_url: як відомості про походження.
resolved_urlstringніЛише відомості про походження: конкретне розташування артефакту, до якого було розв’язано вказаний автором URL під час завантаження. Для helm-джерела з коренем репозиторію це прямий URL .tgz, до якого індекс репозиторію розв’язав chart+version. Записується для діагностики; не входить до жодного контракту цілісності. Відсутнє, коли розв’язане розташування збігається з указаним автором URL.
versionstringтакКонкретна версія, яку резолвер закріпив під час завантаження. Для видів helm-* — версія чарту. Для git-repository — коміт, до якого було розв’язано вказане автором посилання. Записується як один сегмент шляху, оскільки з неї будується слот кешу, у якому лежать ці метадані, тому вона не містить /, \ і ... Шаблон: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringтакДайджест вмісту кешованого архіву .tar.gz у формі sha256:. Перевірка під час збирання обчислює SHA-256 файлу blob.tgz, порівнює його з цим полем І з дайджестом запису lockfile, а якщо будь-який із них відрізняється, зупиняє збирання з повідомленням про невідповідність дайджесту вмісту. Шаблон: ^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})$.

Додаткові властивості не дозволені.