Schemat metadanych slotu pamięci podręcznej Aggrega
Dokumentacja wygenerowana automatycznie. Nie należy jej edytować ręcznie — należy ją wygenerować ponownie z opublikowanego JSON Schema.
Identyfikator schematu: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
Plik metadata.yaml zapisywany w każdym slocie pamięci podręcznej artefaktu źródłowego obok blob.tgz. Zapisuje krotkę tożsamości {kind, url, version, digest, mediatype, pulled_at}, dzięki czemu inspekcja pamięci podręcznej i weryfikacja integralności w czasie budowania mają jeden kanoniczny rekord. Kształt danych jest zamknięty (additionalProperties: false), a wszystkie sześć pól jest wymaganych. Zasady ewolucji schematu: dodanie nowego pola opcjonalnego to zmiana SemVer-MINOR (addytywna); usunięcie pola lub zaostrzenie ograniczenia to zmiana SemVer-MAJOR.
Typ najwyższego poziomu: object
Właściwości
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
kind | enum | tak | Rodzaj źródła, który utworzył ten slot pamięci podręcznej. Odzwierciedla wyliczenie source_artifacts[].kind z pliku blokady; pasujący rodzaj jest tym, co odczytuje każdy konsument w czasie budowania, aby wybrać właściwy mechanizm ładujący. Dozwolone wartości: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | tak | Autorski URL — URL tożsamości w postaci zapisanej w spec.source.url encji Recipe. Dla helm-https-chart jest to katalog główny repozytorium (forma repo-root) lub bezpośredni plik .tgz (forma bezpośrednia), dokładnie tak, jak zapisano. Dla git-repository jest to URL repozytorium, które można sklonować. Dla helm-oci-chart jest to odwołanie do rejestru. Dla compose-https-fragment jest to URL HTTPS fragmentu. Rozwiązana lokalizacja artefaktu dla źródła helm w formie repo-root jest zapisywana osobno w resolved_url: jako informacja o pochodzeniu. |
resolved_url | string | nie | Wyłącznie informacja o pochodzeniu: konkretna lokalizacja artefaktu, na którą autorski URL został rozwiązany w chwili pobrania. Dla źródła helm w formie repo-root jest to bezpośredni URL pliku .tgz, na który indeks repozytorium rozwiązał chart+wersję. Zapisywana na potrzeby diagnostyki; nie jest częścią żadnego kontraktu integralności. Nieobecna, gdy rozwiązana lokalizacja jest równa autorskiemu URL. |
version | string | tak | Konkretna wersja przypięta przez mechanizm rozwiązywania w chwili pobrania. Dla rodzajów helm-* jest to wersja chartu. Dla git-repository jest to commit, na który rozwiązało się autorskie odwołanie. Zapisywana jako pojedynczy segment ścieżki, ponieważ tworzy slot pamięci podręcznej, w którym znajdują się te metadane, dlatego nie zawiera /, \ ani ... Wzorzec: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | tak | Skrót zawartości buforowanego archiwum .tar.gz w postaci sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | tak | Kanoniczny typ nośnika ogłoszony przez rejestr (lub domyślny dla danego rodzaju w przypadku rodzajów bez metadanych rejestru). Zapisywany na potrzeby diagnostycznej informacji o pochodzeniu. |
pulled_at | string | tak | Znacznik czasu RFC 3339 zapisujący czas zegarowy w chwili pobrania. Wyłącznie diagnostyczna informacja o pochodzeniu — nie jest częścią żadnego kontraktu integralności. Wzorzec wymusza, by wartość miała kształt RFC 3339 podczas odczytu metadanych. Wzorzec: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Dodatkowe właściwości są niedozwolone.