コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Aggrega キャッシュスロットメタデータスキーマ

自動生成されたリファレンスです。手動で編集しないでください。公開されている JSON Schema から再生成してください。

スキーマ ID: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json

すべてのソースアーティファクトのキャッシュスロットに blob.tgz と並んで書き込まれる metadata.yaml ファイルです。{kind, url, version, digest, mediatype, pulled_at} の識別タプルを記録し、キャッシュの検査とビルド時の整合性検証が単一の正規レコードを参照できるようにします。ワイヤ形状は閉じており (additionalProperties: false)、6 つのフィールドはすべて必須です。スキーマ進化の規律: 新しい任意フィールドの追加は SemVer-MINOR (追加的) であり、フィールドの削除や制約の厳格化は SemVer-MAJOR です。

トップレベルの型: object

プロパティ

プロパティ種類必須説明
kindenumはいこのキャッシュスロットを生成したソースの種類です。ロックファイルの source_artifacts[].kind の enum を反映しており、ビルド時のすべてのコンシューマーは一致する kind を読み取って適切なローダーを選択します。許可される値: "helm-oci-chart"、"helm-https-chart"、"compose-https-fragment"、"git-repository"、"terraform-module-oci"
urlstringはい記述された URL、つまり Recipe の spec.source.url に書かれたとおりの識別 URL です。helm-https-chart の場合は、記述されたとおりのリポジトリルート (repo-root 形式) または直接の .tgz (direct 形式) です。git-repository の場合は、クローン可能なリポジトリ URL です。helm-oci-chart の場合は、レジストリ参照です。compose-https-fragment の場合は、フラグメントの HTTPS URL です。repo-root 形式の helm ソースについて解決されたアーティファクトの場所は、来歴として resolved_url: の下に別途記録されます。
resolved_urlstringいいえ来歴専用: プル時に記述された URL が解決された具体的なアーティファクトの場所です。repo-root 形式の helm ソースの場合、リポジトリインデックスが chart+version を解決した先の直接の .tgz URL です。診断のために記録され、いかなる整合性契約にも含まれません。解決された場所が記述された URL と等しい場合は存在しません。
versionstringはいプル時にリゾルバーが固定した具体的なバージョンです。helm-* の kind の場合はチャートのバージョンです。git-repository の場合は、記述された参照が解決されたコミットです。このメタデータが置かれるキャッシュスロットを構成するため、単一のパスセグメントとして記録され、/、\、.. を含みません。パターン: ^([^/\\.]|\.[^/\\.])*\.?$。
digeststringはいキャッシュされた .tar.gz アーカイブのコンテンツダイジェストで、sha256: 形式です。ビルド時の検証では blob.tgz の SHA-256 を計算し、このフィールドおよびロックファイルエントリーの digest の両方と比較して、いずれかが異なる場合はコンテンツダイジェストの不一致を報告してビルドを停止します。パターン: ^sha256:[a-f0-9]{64}$。
mediatypestringはいレジストリが提示した正規のメディアタイプです (レジストリメタデータを持たない kind の場合はその kind のデフォルト)。診断用の来歴のために記録されます。
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})$。

追加のプロパティは許可されません。