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

aggrega search

Yapılandırılmış kayıt defterlerinin yerel dizininde arama yapar

Kullanım

aggrega search [query] [flags]

Açıklama

Search the local index of the configured registries for entities matching a
free-text query and optional facet filters.
The index is the offline snapshot written by 'aggrega registry update'; search
reads it and contacts no network. Run 'aggrega registry update' first, and again
whenever you want to pick up newly published entities. A freshness line naming
each searched registry and when its index was last updated is written to standard
error, so standard output carries only the result data.
The optional positional query is a case-insensitive substring matched against
each entity's name and description. The facet filters narrow the result further,
combining as AND across facets and OR within a repeatable facet:
--kind entity kind (component, feature, recipe, featurerecipe,
workload, plugin); repeatable, case-insensitive
--capability a plugin capability; repeatable
--plugin-type a plugin socket type (for example provider, governance)
-l, --selector a label selector over the entity's catalog labels
Category is matched through the label selector, not a dedicated flag: a catalog
category is the label component.aggrega.ai/category, so
'-l component.aggrega.ai/category=compute' scopes the result to that category.
With no --registry, every configured registry's index is searched and the
results are merged. With --registry (a host or a friendly alias), only that
registry's index is searched.
A search needs at least one configured registry. With none configured there is
nowhere to look, so the command refuses: the reason goes to standard error,
standard output carries nothing, and the exit status is non-zero. That is what
lets a caller tell a search that ran and matched nothing from a search that
could not be performed. Run 'aggrega config init' to register a registry with
its signature trust policy, then 'aggrega registry update' to build the index.
The version reported for an entity is the one a resolution would take: a
version a publisher has retracted, where the retraction carries a signature
this workspace's trust policy verifies, is not reported. Such an entity is
still listed, and the versions left out are named in a NOTES column, so an
entity whose every published version is retracted is reported as existing with
no version to take rather than disappearing from the result. Pass
--include-retracted to report the highest published version whatever its
retraction status; the NOTES column names the retracted versions either way.
The same holds for 'aggrega search -o json', where the 'version' field carries
the version a resolution would take and a 'retracted' array names the versions
left out.

Bayraklar

BayrakVarsayılanAçıklama
--capability[]Eşleştirilecek Plugin yeteneği. Tekrarlanabilir; bunlardan herhangi birini bildiren bir kayıt tutulur.
--include-retractedfalseDoğrulanmış bir işaretçi geri çekse bile yayımlanmış en yüksek sürümü raporlar. Varsayılan olarak raporlanan sürüm, bir çözümlemenin seçeceği sürümdür.
--kind[]Eşleştirilecek varlık türü (component|feature|recipe|featurerecipe|workload|plugin). Tekrarlanabilir; bunlardan herhangi biriyle eşleşen kayıt tutulur. Büyük/küçük harfe duyarsızdır.
--limit0Sonuç sayısını sınırlar (0 sınır yok demektir).
--output, -otableÇıktı biçimi: table|json|names.
--plugin-type—Eşleştirilecek Plugin soket türü (örneğin provider, governance, linter).
--registry—Yalnızca ana makine adı veya kolay takma adla belirtilen bu kayıt defterinde arar. Varsayılan olarak yapılandırılmış her kayıt defterinde arar.
--selector, -l—Varlığın kategorisini de içeren katalog etiketleri üzerinde etiket seçici (-l component.aggrega.ai/category=compute).

Hiçbir kayıt defteri yapılandırılmamışsa

Bir arama, bu makinenin erişmek üzere yapılandırıldığı kayıt defterlerinin yerel dizinini okur; bu nedenle en az birine ihtiyaç duyar. Hiçbiri yapılandırılmamışsa bakılacak bir yer yoktur ve aggrega search yanıt vermek yerine reddeder: nedeni standart hataya yazar, sıfırdan farklı bir kodla çıkar ve standart çıktıyı boş bırakır — --output json dahil her çıktı biçiminde.

Reddetme, iki farklı yanıtı birbirinden ayrı tutar. Çalışan ve hiçbir şeyle eşleşmeyen bir arama sıfır kodla çıkar ve standart çıktıda (no matches) raporlar; hiç çalışamayan bir arama ise sıfırdan farklı bir kodla çıkar ve orada hiçbir şey raporlamaz. Böylece çıkış durumuna göre dallanan bir betik “bu varlık yayımlanmamış” ile “bu makinenin soracak bir kayıt defteri yok” durumlarını ayırt edebilir; standart çıktıdaki bir bildirim ve sıfır durum kodu bunu ifade edemez.

Bir kayıt defterini imza güven politikasıyla birlikte kaydetmek için aggrega config init, ardından aramanın okuduğu yerel dizini oluşturmak için aggrega registry update komutunu çalıştırın.

aggrega registry list ve aggrega registry update aynı duruma farklı yanıt verir ve bu bilinçli bir tercihtir. Hiç kayıt defteri yokken kayıt defterlerini listelemek boş bir kümenin eksiksiz listesidir ve dolaşacak hiçbir şeyi olmayan bir dizin oluşturma işleminin yapacak bir şeyi kalmamıştır: ikisi de tamamlanmış işlemlerdir, bu yüzden ikisi de standart çıktıya raporlar ve sıfır kodla çıkar. Yalnızca arama, kendisinden isteneni yapamadığını raporlamaktadır.

Bir aramanın raporladığı sürüm

VERSION sütunu, bir çözümlemenin seçeceği sürümü taşır. Yayımcısının geri çektiği bir sürüm, geri çekme bu çalışma alanının güven politikasının doğruladığı bir imza taşıdığı sürece raporlanmaz — bunlar bir geri çekmenin çekme işlemini etkileyip etkilemediğine karar veren aynı iki koşuldur; böylece bir arama ile bir çekme işlemi hangi sürümün yanıt olduğu konusunda uyuşur.

Koşullardan birini karşılamayan bir geri çekme, raporlanan hiçbir şeyi değiştirmez. Danışma önem düzeyindeki bir işaretçi sürümünü seçilebilir bırakır ve imzası doğrulanmayan bir işaretçi bu çalışma alanının dikkate aldığı bir iddia değildir. Her iki durumda da yayımlanmış en yüksek sürüm, hiç işaretçi yokmuş gibi aynen raporlanır.

Geri çekilmiş bir sürümü olan varlık yine listelenir. Bir NOTES sütunu dışarıda bırakılan sürümleri adlandırır ve yalnızca raporlanacak bir şeyi olan sonuçta görünür. Yayımlanmış her sürümü geri çekilmiş bir varlık, sonuçtan çıkarılmak yerine sürüm olarak (none) ve hiçbir sürüm kalmadığını belirten bir notla raporlanır — çıkarılmış bir varlık, var olmayan bir varlıktan ayırt edilemezdi.

Geri çekilme durumu ne olursa olsun yayımlanmış en yüksek sürümü raporlamak için --include-retracted verin; bu, “ne kullanmalıyım?” sorusunun değil “ne yayımlanmış?” sorusunun yanıtıdır. Yalnızca raporlanan sürümü değiştirir; NOTES sütunu geri çekilmiş sürümleri her iki durumda da adlandırır.

Bir aramanın okuduğu, aggrega registry update komutunun yazdığı yerel dizindir; bu nedenle her kayıt defterinin, o dizin en son oluşturulduğunda bildirdiğini raporlar. O zamandan beri geri çekilmiş bir sürüm henüz kaydedilmemiştir ve standart hataya yazılan güncellik satırı her dizinin oluşturulduğu anı belirtir.

Makine tarafından okunabilir sonuç

--output json aynı sözleşmeyi iki alanda taşır:

  • version, bir çözümlemenin seçeceği sürümdür. Yayımlanmış her sürüm geri çekildiğinde boş dizedir ve bu durum, hepsini adlandıran bir retracted listesiyle eşleşir.
  • retracted, bu seçimin dışında bırakılan sürümleri artan sürüm sırasıyla listeler. Hiçbir şey dışarıda bırakılmadığında bulunmaz.

Hangi sürümü alacağını soran bir tüketici version alanını okur. Bunu bunun yerine deprecations dizisinden türetmek, önem düzeyi ve imza koşullarını yeniden gerçeklemek demektir ve bu koşulların ikinci bir gerçeklemesi derleyicinin uyguladığıyla çelişmekte serbesttir; retracted bu koşulların zaten ürettiği sonucu raporlar.

Her kayıt ayrıca published alanını taşır: dizinin kaydettiği her sürüm, artan sürüm sırasıyla; her biri, dizin oluşturulduğunda etiketinin çözümlendiği manifestDigest ile ve bu çalışma alanının güven politikasının o sürümün kendi imzasını doğruladığı yerde signer ile — doğrulanan birkaç imzacı arasından şeffaflık günlüğünün en erken kaydettiği. signer içermeyen bir sürüm, o politikanın doğruladığı hiçbir imza taşımaz ve hakkında başka bir şey söylenmez. Bir sürümün içeriğini okuyan bir tüketici ona bu özetle erişir — örneğin aggrega inspect oci://<host>/<repository>@<digest> — böylece okuduğu, etikete sonradan ne olursa olsun dizinin kaydettiği baytlardır.

Bir sürümün ne zaman yayımlandığını herhangi bir şey kaydediyorsa, girdisi ayrıca saniye hassasiyetinde UTC cinsinden bir RFC 3339 zaman damgası olan publishedAt alanını ve bunun nereden geldiğini belirten publishedAtSource alanını taşır. transparency-log, bir şeffaflık günlüğünün sürümün anahtarsız imzasını kaydettiği zamandır; bu çalışma alanının güven politikası bunu, günlüğün o zamana ilişkin imzalı taahhüdüyle birlikte doğrulamıştır — signer’ın imzası, yani doğrulananların en erkeni; bu yüzden bir sürümü yeniden imzalamak ikisini de değiştirmez. publisher, yayının yayımladığının yanında bildirdiği zamandır ve yayımlayan makinenin hiçbir şeyin onaylamadığı kendi saatinden gelir. İkisi ayrı tutulur, böylece tarihe göre sıralayan bir tüketici onaylanmış bir zamanı bildirilmiş bir zamandan yine de ayırt edebilir. İkisi de olmayan bir sürüm tarih taşımaz ve hakkında başka bir şey söylenmez; her birinin ne zaman kaydedildiği için aggrega registry update sayfasına bakın.