Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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śćTypWymaganaOpis
kindenumtakRodzaj ź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"
urlstringtakAutorski 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_urlstringnieWyłą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.
versionstringtakKonkretna 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: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringtakSkrót zawartości buforowanego archiwum .tar.gz w postaci sha256:. Weryfikacja w czasie budowania oblicza SHA-256 pliku blob.tgz, porównuje go z tym polem ORAZ ze skrótem we wpisie pliku blokady i, gdy którykolwiek się różni, zatrzymuje budowanie, zgłaszając niezgodność skrótu zawartości. Wzorzec: ^sha256:[a-f0-9]{64}$.
mediatypestringtakKanoniczny 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_atstringtakZnacznik 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.