このページは機械翻訳されています。英語の原文を読む。
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
プロパティ
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
kind | enum | はい | このキャッシュスロットを生成したソースの種類です。ロックファイルの source_artifacts[].kind の enum を反映しており、ビルド時のすべてのコンシューマーは一致する kind を読み取って適切なローダーを選択します。許可される値: "helm-oci-chart"、"helm-https-chart"、"compose-https-fragment"、"git-repository"、"terraform-module-oci" |
url | string | はい | 記述された 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_url | string | いいえ | 来歴専用: プル時に記述された URL が解決された具体的なアーティファクトの場所です。repo-root 形式の helm ソースの場合、リポジトリインデックスが chart+version を解決した先の直接の .tgz URL です。診断のために記録され、いかなる整合性契約にも含まれません。解決された場所が記述された URL と等しい場合は存在しません。 |
version | string | はい | プル時にリゾルバーが固定した具体的なバージョンです。helm-* の kind の場合はチャートのバージョンです。git-repository の場合は、記述された参照が解決されたコミットです。このメタデータが置かれるキャッシュスロットを構成するため、単一のパスセグメントとして記録され、/、\、.. を含みません。パターン: ^([^/\\.]|\.[^/\\.])*\.?$。 |
digest | string | はい | キャッシュされた .tar.gz アーカイブのコンテンツダイジェストで、sha256:^sha256:[a-f0-9]{64}$。 |
mediatype | string | はい | レジストリが提示した正規のメディアタイプです (レジストリメタデータを持たない kind の場合はその kind のデフォルト)。診断用の来歴のために記録されます。 |
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})$。 |
追加のプロパティは許可されません。