aggrega push-artifact
Publikuje samodzielny artefakt danych (np. pakiet dokumentacji) w rejestrze OCI
Składnia
aggrega push-artifact <file> [flags]Opis
Publish a standalone data artifact — a documentation bundle or any other non-entity blob — to an OCI registry under the reserved docs/ namespace. Unlike push, which bundles a catalog entity and dispatches on its kind, push-artifact carries opaque bytes: it reads the file, packs it under the given media type (defaulting to the documentation-bundle media type), and tags it at docs/<name>:<tag>. The published artifact is signed separately by reference with aggrega sign. Beside it, push-artifact states when it published, as a small published-at attachment carrying this machine's clock in UTC to the second; the attachment moves no digest and changes no tag.Flagi
| Flaga | Domyślnie | Opis |
|---|---|---|
--dry-run | false | Oblicza referencję i wypisuje proponowaną wartość |
--media-type | application/vnd.aggrega.docs.v1beta1+tar+gz | Typ nośnika artefaktu OCI; domyślnie typ nośnika pakietu dokumentacji |
--name | — | Nazwa artefaktu w zarezerwowanej przestrzeni nazw docs/ (np. „aggrega-docs” publikuje w docs/aggrega-docs) |
--registry | — | Host rejestru docelowego (zastępuje default_registry obszaru roboczego) |
--tag | — | Tag wersji, pod którym publikowany jest artefakt (wymagany) |
Artefakt pakietu dokumentacji
Pakiet dokumentacji jest samodzielnym artefaktem danych — skompresowanym gzipem archiwum tar wygenerowanej dokumentacji — a nie encją katalogu. Ma typ nośnika application/vnd.aggrega.docs.v1beta1+tar+gz, który jest typem artefaktu widocznym dla odbiorcy pobierającego pakiet z rejestru.
Pakiety są publikowane w segmencie repozytorium docs/: --name aggrega-docs umieszcza
artefakt w docs/aggrega-docs, a --tag wybiera wersję, więc współrzędna pobierania
to <registry>/docs/<name>:<tag> — na przykład
hub.aggrega.ai/docs/aggrega-docs:1.0.0. Ponieważ pakiet jest zwykłym artefaktem
danych, a nie encją katalogu, można go pobrać dowolnym klientem zgodnym z OCI,
używając tej referencji i typu nośnika. Opublikowany plik nosi nazwę podaną
w --name, więc klient zapisujący pliki według nazwy zapisze go pod tą nazwą:
oras pull hub.aggrega.ai/docs/aggrega-docs:1.0.0 pozostawia aggrega-docs w
bieżącym katalogu, bajt w bajt tak, jak został opublikowany.
Gdy rejestr odrzuci zapis
Publikacja zapisuje do rejestru w krokach — plik, manifest, który
go nazywa, tag, a następnie datę publikacji obok niego — a każdy z tych
zapisów jest ponawiany, gdy rejestr lub sieć odrzuci go w sposób, w jaki późniejsza
próba może się powieść, np. błąd serwera, przekroczenie czasu lub zerwane połączenie;
aggrega push wymienia te
błędy. Zapis jest próbowany najwyżej trzy razy, w odstępach pół sekundy, a potem
sekundy, a każda próba jest nowym przesłaniem tych samych bajtów, a nie ponowieniem
żądania, które się nie powiodło, więc ponowiony zapis daje to, co dałaby jedna próba.
Zapis, który nadal się nie powodzi po ostatniej próbie, kończy polecenie błędem, a błąd wskazuje krok. Niepowodzenie dołączenia daty następuje po zapisaniu artefaktu: artefakt pozostaje opublikowany, a polecenie kończy się kodem niezerowym z informacją, że nie udało się dołączyć daty publikacji. Ponowne uruchomienie tej samej publikacji ją kończy: artefakt jest zgłaszany jako już opublikowany, nic nie jest przesyłane, a data jest dołączana tam, gdzie artefakt jej nie ma, i podaje zegar tego uruchomienia — czas ukończenia publikacji. Do artefaktu, który już podaje datę, nic nie jest dołączane, a gdy nie można odczytać listy, polecenie kończy się kodem niezerowym bez dołączenia czegokolwiek.
Tryb offline
Publikacja artefaktu wymaga komunikacji sieciowej, dlatego w trybie offline — ustawionym kluczem najwyższego poziomu offline w pliku konfiguracyjnym, AGGREGA_OFFLINE lub --offline — to polecenie odmawia działania przed odczytaniem pliku, a komunikat odmowy wskazuje, które z tych trzech ustawień włączyło ten tryb. --dry-run nadal działa, ponieważ oblicza referencję i nie wykonuje żadnego wywołania. Aby opublikować artefakt w pojedynczym uruchomieniu z obszaru roboczego w trybie offline, należy przekazać --offline=false.
Zobacz także
- ./aggrega-sign.md — artefakt danych jest podpisywany po fakcie, przez referencję; to polecenie nie dołącza własnego podpisu.
- ./aggrega-serve.md — demon udostępnia tę samą publikację pod
aggrega/publishArtifact, więc edytor może ją uruchomić bez opuszczania sesji. - ./aggrega-mcp.md — ta sama funkcja jako narzędzie
publish-artifact, które może wywołać asystent. Przed zezwoleniem na to należy przeczytać, co ta strona mówi na ten temat.