aggrega push-artifact
Memublikasikan artefak data mandiri (seperti bundel dokumentasi) ke registry OCI
Sinopsis
aggrega push-artifact <file> [flags]Deskripsi
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.Flag
| Flag | Default | Deskripsi |
|---|---|---|
--dry-run | false | Menghitung referensi dan mencetak |
--media-type | application/vnd.aggrega.docs.v1beta1+tar+gz | Media type artefak OCI; default-nya adalah media type bundel dokumentasi |
--name | — | Nama artefak di dalam namespace docs/ yang dicadangkan (mis. “aggrega-docs” dipublikasikan di docs/aggrega-docs) |
--registry | — | Host registry tujuan (menimpa default_registry milik workspace) |
--tag | — | Tag versi tempat artefak dipublikasikan (wajib) |
Artefak bundel dokumentasi
Bundel dokumentasi adalah artefak data mandiri — tar terkompresi gzip berisi dokumentasi yang telah di-render — dan bukan entitas katalog. Bundel ini membawa media type application/vnd.aggrega.docs.v1beta1+tar+gz, yaitu tipe artefak yang dilihat konsumen saat melakukan pull bundel dari registry.
Bundel dipublikasikan di bawah segmen repositori docs/: --name aggrega-docs menempatkan artefak di docs/aggrega-docs, dan --tag memilih versinya, sehingga koordinat pull-nya adalah <registry>/docs/<name>:<tag> — misalnya, hub.aggrega.ai/docs/aggrega-docs:1.0.0. Karena bundel adalah artefak data biasa dan bukan entitas katalog, bundel diambil dengan klien apa pun yang kompatibel dengan OCI menggunakan referensi dan media type tersebut. File yang dipublikasikan membawa nama yang diberikan dengan --name, sehingga klien yang menulis file berdasarkan nama akan menulisnya dengan nama itu: oras pull hub.aggrega.ai/docs/aggrega-docs:1.0.0 meninggalkan aggrega-docs di direktori saat ini, byte demi byte sama seperti saat dipublikasikan.
Ketika registry menggagalkan penulisan
Publikasi menulis ke registry dalam beberapa langkah — file, manifest yang menyebutkannya, tag, lalu tanggal publikasi di sampingnya — dan setiap penulisan tersebut dicoba ulang ketika registry atau jaringan menggagalkannya dengan cara yang memungkinkan percobaan berikutnya berhasil, seperti kesalahan server, timeout, atau koneksi yang di-reset; aggrega push mencantumkan kegagalan tersebut. Sebuah penulisan dicoba paling banyak tiga kali, dengan jeda setengah detik lalu satu detik, dan setiap percobaan merupakan unggahan baru dari byte yang sama, bukan pengiriman ulang permintaan yang gagal, sehingga penulisan yang dicoba ulang menghasilkan apa yang akan dihasilkan satu percobaan.
Penulisan yang masih gagal setelah percobaan terakhirnya menggagalkan perintah, dan kesalahannya menyebutkan langkah tersebut. Kegagalan melampirkan tanggal terjadi setelah artefak berhasil tersimpan: artefak tetap terpublikasi, dan perintah keluar dengan kode bukan nol yang menyatakan bahwa tanggal publikasinya tidak dapat dilampirkan. Menjalankan publikasi yang sama lagi akan menyelesaikannya: artefak dilaporkan sudah dipublikasikan, tidak ada yang diunggah, dan tanggal dilampirkan pada artefak yang belum memilikinya, dengan menyatakan jam eksekusi tersebut — waktu publikasi diselesaikan. Artefak yang sudah menyatakan tanggal tidak dilampiri apa pun, dan daftar yang tidak dapat dibaca keluar dengan kode bukan nol tanpa melampirkan apa pun.
Luring
Memublikasikan artefak adalah perjalanan pulang-pergi jaringan, sehingga dalam mode offline — key tingkat atas offline di file konfigurasi, AGGREGA_OFFLINE, atau --offline — perintah ini menolak sebelum membaca file, dan penolakannya menyebutkan mana dari ketiga hal tersebut yang mengatur mode itu. --dry-run tetap berfungsi, karena ia menghitung referensi dan tidak melakukan panggilan apa pun. Untuk memublikasikan selama satu eksekusi dari workspace offline, berikan --offline=false.
Lihat juga
- ./aggrega-sign.md — artefak data ditandatangani setelahnya, berdasarkan referensi; perintah ini tidak melampirkan tanda tangannya sendiri.
- ./aggrega-serve.md — daemon menyediakan publikasi yang sama di
aggrega/publishArtifact, sehingga editor dapat menjalankannya tanpa meninggalkan sesi. - ./aggrega-mcp.md — kemampuan yang sama sebagai alat
publish-artifact, yang dapat dipanggil oleh asisten. Baca apa yang dikatakan halaman tersebut tentang mengizinkannya sebelum Anda melakukannya.