aggrega push-artifact
Bağımsız bir veri yapıtını (örneğin bir belge paketini) bir OCI kayıt defterine yayımlar
Kullanım
aggrega push-artifact <file> [flags]Açıklama
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.Bayraklar
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--dry-run | false | Başvuruyu hesaplar ve önerilen |
--media-type | application/vnd.aggrega.docs.v1beta1+tar+gz | OCI yapıtı ortam türü; varsayılan olarak belge paketi ortam türüdür |
--name | — | Ayrılmış docs/ ad alanı içindeki yapıt adı (örn. “aggrega-docs”, docs/aggrega-docs konumunda yayımlanır) |
--registry | — | Hedef kayıt defteri ana bilgisayarı (çalışma alanının default_registry değerini geçersiz kılar) |
--tag | — | Yapıtın altında yayımlanacağı sürüm etiketi (zorunlu) |
Belge paketi yapıtı
Belge paketi, bir katalog varlığı değil, bağımsız bir veri yapıtıdır — işlenmiş belgelerin gzip ile sıkıştırılmış bir tar arşivi. Paket application/vnd.aggrega.docs.v1beta1+tar+gz ortam türünü taşır; bu, bir tüketicinin paketi kayıt defterinden çekerken gördüğü yapıt türüdür.
Paketler docs/ depo bölümü altında yayımlanır: --name aggrega-docs yapıtı
docs/aggrega-docs konumuna yerleştirir ve --tag sürümü seçer; böylece çekme
koordinatı <registry>/docs/<name>:<tag> olur — örneğin
hub.aggrega.ai/docs/aggrega-docs:1.0.0. Paket bir katalog varlığı değil, düz bir veri
yapıtı olduğundan, bu başvuru ve ortam türüyle OCI uyumlu herhangi bir istemciyle
alınır. Yayımlanan dosya --name ile verilen adı taşır; bu nedenle dosyaları ada göre
yazan bir istemci onu bu adla yazar:
oras pull hub.aggrega.ai/docs/aggrega-docs:1.0.0, aggrega-docs dosyasını
geçerli dizinde, yayımlandığı haliyle bayt bayt aynı bırakır.
Kayıt defteri bir yazmayı başarısız kıldığında
Yayımlama, kayıt defterine adımlar halinde yazar — dosya, onu adlandıran manifest,
etiket ve ardından yanındaki yayımlanma tarihi — ve bu yazmaların her biri, kayıt
defteri ya da ağ onu sonraki bir denemenin başarılı olabileceği bir şekilde başarısız
kıldığında, örneğin bir sunucu hatası, bir zaman aşımı ya da sıfırlanan bir bağlantıda,
yeniden denenir; aggrega push bu
hataları listeler. Bir yazma en fazla üç kez, önce yarım saniye sonra bir saniye
aralıkla denenir ve her deneme, başarısız olan isteğin yeniden gönderilmesi değil, aynı
baytların yeni bir yüklemesidir; böylece yeniden denenen bir yazma, tek bir denemenin
bırakacağı sonucu bırakır.
Son denemesinden sonra hâlâ başarısız olan bir yazma komutu başarısız kılar ve hata adımı adlandırır. Tarihin eklenememesi, yapıt yerine ulaştıktan sonra gerçekleşir: yapıt yayımlanmış olarak kalır ve komut, yayımlanma tarihinin eklenemediğini bildirerek sıfır olmayan bir kodla çıkar. Aynı yayımlamayı yeniden çalıştırmak onu tamamlar: yapıt zaten yayımlanmış olarak bildirilir, hiçbir şey yüklenmez ve yapıt hiç tarih taşımıyorsa tarih eklenir; bu tarih o çalıştırmanın saatini, yani yayımlamanın tamamlandığı zamanı belirtir. Zaten bir tarih belirten yapıta hiçbir şey eklenmez ve okunamayan bir listeleme hiçbir şey eklenmeden sıfır olmayan bir kodla çıkar.
Çevrimdışı
Bir yapıtı yayımlamak bir ağ gidiş-dönüşüdür; bu nedenle çevrimdışı duruş altında — bir yapılandırma dosyasındaki üst düzey offline anahtarı, AGGREGA_OFFLINE ya da --offline — bu komut dosyayı okumadan önce reddeder ve ret, duruşu bu üçünden hangisinin ayarladığını belirtir. --dry-run çalışmaya devam eder, çünkü başvuruyu hesaplar ve hiçbir çağrı yapmaz. Çevrimdışı bir çalışma alanından tek bir çalıştırma için yayımlamak üzere --offline=false geçirin.
Ayrıca bakınız
- ./aggrega-sign.md — bir veri yapıtı sonradan, başvuruyla imzalanır; bu komut kendi imzasını eklemez.
- ./aggrega-serve.md — arka plan hizmeti aynı yayımlamayı
aggrega/publishArtifactadresinde sunar; böylece bir düzenleyici onu oturumdan ayrılmadan çalıştırabilir. - ./aggrega-mcp.md — bir asistanın çağırabileceği
publish-artifactaracı olarak aynı yetenek. Buna izin vermeden önce o sayfanın bu konuda söylediklerini okuyun.