Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

aggrega search

Mencari di indeks lokal registry yang dikonfigurasi

Sinopsis

aggrega search [query] [flags]

Deskripsi

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.

Flag

FlagDefaultDeskripsi
--capability[]Kapabilitas Plugin yang dicocokkan. Dapat diulang; record yang mendeklarasikan salah satunya dipertahankan.
--include-retractedfalseMelaporkan versi terpublikasi tertinggi bahkan ketika penanda yang terverifikasi menariknya. Secara default, versi yang dilaporkan adalah versi yang akan diambil oleh resolusi.
--kind[]Jenis entitas yang dicocokkan (component|feature|recipe|featurerecipe|workload|plugin). Dapat diulang; record yang cocok dengan salah satunya dipertahankan. Tidak peka huruf besar-kecil.
--limit0Membatasi jumlah hasil (0 berarti tanpa batas).
--output, -otableFormat keluaran: table|json|names.
--plugin-type—Tipe socket Plugin yang dicocokkan (misalnya provider, governance, linter).
--registry—Hanya mencari di registry ini, yang dirujuk melalui host atau alias ramah. Secara default, pencarian dilakukan di setiap registry yang dikonfigurasi.
--selector, -l—Selektor label atas label katalog entitas, yang mencakup kategorinya (-l component.aggrega.ai/category=compute).

Ketika tidak ada registry yang dikonfigurasi

Pencarian membaca indeks lokal dari registry yang dikonfigurasi untuk dijangkau mesin ini, sehingga memerlukan setidaknya satu registry. Jika tidak ada yang dikonfigurasi, tidak ada tempat untuk mencari, dan aggrega search menolak alih-alih menjawab: perintah ini menulis alasannya ke standard error, keluar dengan status bukan nol, dan membiarkan standard output kosong — dalam setiap format keluaran, termasuk --output json.

Penolakan inilah yang memisahkan dua jawaban yang berbeda. Pencarian yang berjalan dan tidak menemukan apa pun keluar dengan nol dan melaporkan (no matches) di standard output; pencarian yang sama sekali tidak dapat berjalan keluar dengan status bukan nol dan tidak melaporkan apa pun di sana. Karena itu, skrip yang bercabang berdasarkan status keluar dapat membedakan “entitas ini tidak dipublikasikan” dari “mesin ini tidak memiliki registry untuk ditanya”, sesuatu yang tidak dapat diungkapkan oleh pemberitahuan di standard output disertai status nol.

Jalankan aggrega config init untuk mendaftarkan registry beserta kebijakan kepercayaan tanda tangannya, lalu aggrega registry update untuk membangun indeks lokal yang dibaca oleh pencarian.

aggrega registry list dan aggrega registry update menjawab situasi yang sama secara berbeda, dan memang disengaja. Mencantumkan registry ketika tidak ada satu pun adalah daftar lengkap dari himpunan kosong, dan pembangunan indeks tanpa apa pun untuk ditelusuri tidak punya pekerjaan lagi: keduanya adalah operasi yang selesai, sehingga keduanya melapor di standard output dan keluar dengan nol. Hanya pencarian yang melaporkan bahwa ia tidak dapat melakukan apa yang diminta.

Versi yang dilaporkan pencarian

Kolom VERSION memuat versi yang akan diambil oleh resolusi. Versi yang telah ditarik oleh penerbitnya tidak dilaporkan, asalkan penarikan tersebut membawa tanda tangan yang diverifikasi oleh kebijakan kepercayaan workspace ini — dua kondisi yang sama yang menentukan apakah penarikan memengaruhi pull, sehingga pencarian dan pull sepakat tentang versi mana yang menjadi jawabannya.

Penarikan yang tidak memenuhi salah satu kondisi tidak mengubah apa pun dari yang dilaporkan. Penanda dengan tingkat keparahan advisori membiarkan versinya tetap dapat dipilih, dan penanda yang tanda tangannya tidak terverifikasi bukanlah klaim yang ditindaklanjuti workspace ini. Dalam kedua kasus, versi terpublikasi tertinggi dilaporkan persis seperti tanpa penanda sama sekali.

Entitas dengan versi yang ditarik tetap dicantumkan. Kolom NOTES menyebutkan versi yang dikecualikan, dan hanya muncul dalam hasil yang memiliki sesuatu untuk dilaporkan. Entitas yang seluruh versi terpublikasinya ditarik dilaporkan dengan (none) sebagai versinya dan catatan yang menyatakan bahwa tidak ada versi yang tersisa, alih-alih dihapus dari hasil — entitas yang dihilangkan tidak akan dapat dibedakan dari entitas yang tidak ada.

Berikan --include-retracted untuk melaporkan versi terpublikasi tertinggi apa pun status penarikannya, yang merupakan jawaban atas “apa yang dipublikasikan?” alih-alih “apa yang sebaiknya saya gunakan?”. Opsi ini hanya mengubah versi yang dilaporkan; kolom NOTES tetap menyebutkan versi yang ditarik.

Yang dibaca pencarian adalah indeks lokal yang ditulis oleh aggrega registry update, sehingga pencarian melaporkan apa yang dinyatakan setiap registry saat indeks tersebut terakhir dibangun. Versi yang ditarik sejak saat itu belum tercatat, dan baris kesegaran yang ditulis ke standard error menyebutkan saat setiap indeks dibangun.

Hasil yang dapat dibaca mesin

--output json membawa kontrak yang sama dalam dua field:

  • version adalah versi yang akan diambil oleh resolusi. Nilainya berupa string kosong ketika setiap versi terpublikasi ditarik, yang berpasangan dengan daftar retracted yang menyebutkan semuanya.
  • retracted mencantumkan versi yang dikecualikan dari pilihan tersebut, dalam urutan versi menaik. Field ini tidak ada ketika tidak ada yang dikecualikan.

Konsumen yang ingin tahu versi mana yang akan didapatnya membaca version. Menurunkannya dari array deprecations berarti mengimplementasikan ulang kondisi tingkat keparahan dan tanda tangan, dan implementasi kedua dari kondisi tersebut bisa saja tidak sepakat dengan yang diterapkan oleh compiler; retracted melaporkan hasil yang sudah dihasilkan oleh kondisi tersebut.

Setiap record juga membawa published: setiap versi yang dicatat indeks, dalam urutan versi menaik, masing-masing dengan manifestDigest yang menjadi hasil resolusi tag-nya saat indeks dibangun dan, jika kebijakan kepercayaan workspace ini memverifikasi tanda tangan milik versi itu sendiri, signer-nya — dari beberapa yang terverifikasi, yang paling awal dicatat oleh log transparansi. Versi tanpa signer tidak membawa tanda tangan yang diverifikasi kebijakan tersebut, dan tidak ada lagi yang dikatakan tentangnya. Konsumen yang membaca konten suatu versi merujuknya melalui digest tersebut — misalnya aggrega inspect oci://<host>/<repository>@<digest> — sehingga yang dibacanya adalah byte yang dicatat indeks, apa pun yang terjadi pada tag-nya setelah itu.

Jika ada yang mencatat kapan suatu versi dipublikasikan, entrinya juga membawa publishedAt, timestamp RFC 3339 dalam UTC hingga detik, dan publishedAtSource, yang menyatakan dari mana asalnya. transparency-log adalah waktu ketika log transparansi mencatat tanda tangan keyless versi tersebut, yang diverifikasi oleh kebijakan kepercayaan workspace ini bersama janji bertanda tangan dari log tentang waktu itu — tanda tangan signer, yang paling awal dari yang terverifikasi, sehingga menandatangani ulang suatu versi tidak menggeser keduanya. publisher adalah waktu yang dinyatakan publikasi di samping apa yang dipublikasikannya, menurut jam milik mesin yang memublikasikan, yang tidak dibuktikan oleh apa pun. Keduanya dipisahkan agar konsumen yang mengurutkan berdasarkan tanggal tetap dapat membedakan waktu yang dibuktikan dari waktu yang dinyatakan. Versi tanpa keduanya tidak membawa tanggal, dan tidak ada lagi yang dikatakan tentangnya; lihat aggrega registry update untuk mengetahui kapan masing-masing dicatat.