İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

BayrakVarsayılanAçıklama
--dry-runfalseBaşvuruyu hesaplar ve önerilen : değerini yazdırır; ağ çağrısını atlar
--media-typeapplication/vnd.aggrega.docs.v1beta1+tar+gzOCI 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/publishArtifact adresinde sunar; böylece bir düzenleyici onu oturumdan ayrılmadan çalıştırabilir.
  • ./aggrega-mcp.md — bir asistanın çağırabileceği publish-artifact aracı olarak aynı yetenek. Buna izin vermeden önce o sayfanın bu konuda söylediklerini okuyun.