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 afree-text query and optional facet filters.
The index is the offline snapshot written by 'aggrega registry update'; searchreads it and contacts no network. Run 'aggrega registry update' first, and againwhenever you want to pick up newly published entities. A freshness line namingeach searched registry and when its index was last updated is written to standarderror, so standard output carries only the result data.
The optional positional query is a case-insensitive substring matched againsteach 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 catalogcategory 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 theresults are merged. With --registry (a host or a friendly alias), only thatregistry's index is searched.
A search needs at least one configured registry. With none configured there isnowhere 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 whatlets a caller tell a search that ran and matched nothing from a search thatcould not be performed. Run 'aggrega config init' to register a registry withits signature trust policy, then 'aggrega registry update' to build the index.
The version reported for an entity is the one a resolution would take: aversion a publisher has retracted, where the retraction carries a signaturethis workspace's trust policy verifies, is not reported. Such an entity isstill listed, and the versions left out are named in a NOTES column, so anentity whose every published version is retracted is reported as existing withno version to take rather than disappearing from the result. Pass--include-retracted to report the highest published version whatever itsretraction status; the NOTES column names the retracted versions either way.The same holds for 'aggrega search -o json', where the 'version' field carriesthe version a resolution would take and a 'retracted' array names the versionsleft out.Bayraklar
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--capability | [] | Eşleştirilecek Plugin yeteneği. Tekrarlanabilir; bunlardan herhangi birini bildiren bir kayıt tutulur. |
--include-retracted | false | Doğ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. |
--limit | 0 | Sonuç sayısını sınırlar (0 sınır yok demektir). |
--output, -o | table | Çı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 birretractedlistesiyle 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.