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

aggrega registry

Mengelola registry dan kebijakan kepercayaan tanda tangannya

Sinopsis

aggrega registry

Deskripsi

Manage the OCI registries Aggrega publishes to and resolves from, together with
the signature trust policy for each.
A registry entry records where to reach the registry and what to require of the
signatures on artifacts it serves — which identities are trusted, and whether a
signature is required at all. That policy is what "aggrega pull" enforces when
it verifies an artifact and what "aggrega push" honours when it decides whether
to sign.
"aggrega registry add" can fetch a registry's own advertised trust policy rather
than having you write it out. "aggrega registry update" builds the local
searchable index that "aggrega search" and "aggrega plugin add" read.
A registry entry is written to the global config shared across every workspace
on this machine, because a registry and the identities you trust on it are
usually the same wherever you work. That makes adding or removing one a
machine-wide change: every project on this machine resolves through the entry
you just wrote or dropped. Pass --workspace to write it to this project's config
file instead. Building the searchable index is the exception — that lands in
this workspace's own artifact cache and reaches no other project.

Subperintah

PerintahDeskripsi
aggrega registry addMendaftarkan registry dan kebijakan kepercayaan tanda tangannya
aggrega registry listMencantumkan registry yang dikonfigurasi dan postur kepercayaannya
aggrega registry removeMenghapus registry dan kebijakan kepercayaannya dari file konfigurasi
aggrega registry updateMembangun indeks lokal yang dapat dicari dari registry yang dikonfigurasi

Deskripsi aggrega registry add

Register a registry host and its signature trust policy.
The entry is keyed under the host exactly as written, and every lookup of it is
made in one spelling: a lowercase host name containing a dot, localhost, a single
name followed by a port (registry:5000), an IPv4 address, or an IPv6 address in
brackets, each with an optional :port. A reference may be given instead — its
scheme, path and credentials are dropped and the entry is keyed under the host it
names — but a host written in capitals, with the default HTTPS port, or as a
single name with no port is refused, naming the spelling to write where there is
one.
The entry is written to the global config shared across every workspace, since a
registry and the identities you trust on it are usually the same wherever you
work. Pass --workspace to write it to this project's config file instead; the two
flags are mutually exclusive.
By default the registry's advertised trust policy is fetched once from the
registry's own origin (https://<host>/.well-known/aggrega-trust) and pinned
locally — trust-on-first-use. Verification at pull time always runs against the
pinned local policy, never a live re-fetch. Pass --fetch-trust=false to skip the
fetch and pin only what the flags supply.
A trust policy can also be set by hand: keyless (one or more --identity entries,
each an "identity=issuer" pair) or keyed (--key pointing at a pinned public-key
PEM). Manual --identity / --key flags OVERRIDE the fetched set — when either is
supplied, the fetch is skipped and the policy is built from the flags alone.
Pass --trusted-root to pin a Sigstore trust-root bundle for air-gapped keyless
verification. Adding the official hub host with no policy flags pins the built-in
official baseline.
When the registry advertises no trust policy (a 404 or an unreachable endpoint),
the add does not fail: it writes the policy from the flags (or an empty policy)
and prints a notice suggesting manual --identity / --key pinning. The official
hub writes its built-in baseline instead, and the notice says the baseline was
pinned.
When the workspace is offline the advertised policy cannot be fetched, so the
registry is never asked. Adding a registry other than the official hub is then
refused unless --identity or --key supplies the policy, rather than writing an
entry that trusts nothing: register it once while online, or pin it by hand.
Adding the official hub offline pins its built-in baseline, with a notice saying
so, and a manual policy registers offline exactly as it does online.
Existing settings in the target config file are preserved.

Flag aggrega registry add

FlagDefaultDeskripsi
--advisoryfalseMenurunkan kegagalan verifikasi untuk registry ini menjadi peringatan alih-alih berhenti
--fetch-trusttrueMengambil dan menyematkan kebijakan kepercayaan yang diiklankan registry pada penggunaan pertama. Gunakan —fetch-trust=false untuk melewatinya; —identity/—key manual juga melewati pengambilan.
--globalfalseMenulis entri ke konfigurasi global yang digunakan bersama oleh setiap workspace. Registry secara bawaan ditulis di sini.
--identity[]Identitas keyless tepercaya sebagai identity=issuer, misalnya dev@example.com=https://accounts.google.com (dapat diulang; himpunan OR). Menimpa kebijakan kepercayaan yang diambil.
--key—Path ke PEM kunci publik tersemat yang kompatibel dengan cosign untuk verifikasi keyed. Menimpa kebijakan kepercayaan yang diambil.
--name—Alias ramah opsional untuk registry ini. Host tetap menjadi identitasnya; alias di-resolve ke host itu di mana pun sebuah registry disebut (misalnya —registry). Harus unik di antara semua registry.
--require-signaturesfalseMewajibkan tanda tangan pada setiap artefak yang diambil dari (dan di-push ke) registry ini
--trusted-root—Path ke bundle root kepercayaan Sigstore tersemat untuk verifikasi keyless di lingkungan air-gapped
--workspacefalseMenulis entri ke konfigurasi workspace proyek ini alih-alih konfigurasi global.

Deskripsi aggrega registry list

List every registry configured in the effective merged config, one per line,
with its friendly alias (if any), a short trust-posture summary, and a marker on
the default registry.
This reads the resolved configuration and never contacts a registry. Registries
are listed in ascending host order.
With -o json the same set is emitted as one structured document per registry:
its host, its alias, whether it is the default, its trust posture as discrete
fields rather than the table's rendered sentence, and whether a credential for
that host is present in the shared credential store. The credential state reports
presence only — a credential is never read out, measured, or shown in any form,
and whether the registry would accept it is not asked, since that would take a
network round trip. Reading it consults the local credential store, which honors
a configured credential helper. The order is the same ascending host order the
table uses.

Flag aggrega registry list

FlagDefaultDeskripsi
--output, -otableFormat output: table|json.

Deskripsi aggrega registry remove

Remove a registry's trust-policy entry from a config file, addressed by its host
or its friendly alias.
By default the entry is removed from the global config shared across every
workspace; pass --workspace to remove it from this project's workspace config
instead. Setting both --global and --workspace is a usage error.
The default_registry pointer is left untouched — removing a registry's trust
policy reverts that host to default trust; it does not change which registry is
the default. Where default_registry names the removed entry by its alias, that
alias names nothing afterwards, and the configuration is refused until
default_registry is written as a host or as another entry's name.

Flag aggrega registry remove

FlagDefaultDeskripsi
--globalfalseMenghapus entri dari konfigurasi global yang digunakan bersama oleh setiap workspace.
--workspacefalseMenghapus entri dari konfigurasi workspace proyek ini alih-alih dari konfigurasi global.

Deskripsi aggrega registry update

Walk each configured registry's repositories, read the latest published version
of each, and write a deterministic local searchable index to the artifact cache.
With no argument, every configured registry is indexed. With a single registry
argument (a host or a friendly alias), only that registry is indexed.
This is the one registry command that reaches the network. The index it writes
lands in this workspace's own artifact cache, so refreshing it changes nothing
another project on this machine resolves through. Credentials are read from a
supplied or ambient source and never asked for: a registry that needs one you do
not have fails with a message naming what it wanted.
For each repository the highest strict-SemVer version is selected (pre-release
versions are skipped) and its catalog facets — kind, description, category,
labels, and, for plugins, socket type and capabilities — are recorded from the
published manifest. A repository with no conforming version is skipped; a
repository that cannot be read is skipped with a note, so one unreadable
repository does not abandon the whole index.
A registry that asks the walk to slow down — a 429 answer, or a 503 that says
how long to wait (Retry-After) — is left alone for as long as it asks, or ten
seconds where it does not say, and the walk reads fewer of its repositories at
once until it answers again, then returns to its usual pace; on a terminal the
wait is shown beside that registry's row. A registry that answers nothing but
"slow down" for five minutes is not indexed: it keeps the index it had before
the run, and the command names it, its last answer and how long it waited.
A read the registry fails or drops in passing — a 5xx answer, a connection
reset or timed out, an answer cut short — is asked again a few times, with a
growing wait between attempts. A repository with a read still
failing after that is not recorded from this run: it keeps the record the index
already holds for it, where that record was judged under the trust policy now in
force, and is otherwise left out of the index; either way it is named as a
repository that could not be read, as the walk goes and again in the closing
summary under its registry's row, with the kind of the read's last failure — the
status the registry answered, a timeout, a reset, an answer cut short — and the
read that failed. So a version is never recorded unsigned,
undated or without its deprecation marker because a read failed, with or without
--upgrade. Each registry's row in the closing summary also says how many reads
were asked again, whether or not they then succeeded — a read sent again after
the registry asked the walk to slow down among them — and says zero when none
was.
Every signature a registry's walk verifies against the public Sigstore trust root
is verified against the same copy of that root, fetched once for the walk rather
than once per signature; a registry whose trust policy pins a trust root of its
own is verified against that file.
A registry whose repository listing repeats itself — naming a repository it has
already named, or answering two pages in a row with no repository while still
pointing to a next page — is not followed round again. That registry is reported
as not indexed, with a message naming it and saying its repository listing
repeated itself; the other registries are still indexed, and the command exits
non-zero.
A registry that is not indexed keeps the index it had before the run, unchanged:
nothing is written for a registry whose walk failed, whose listing repeated
itself, or that was being walked when the command was interrupted. Registries
indexed earlier in the same run keep what this run wrote for them. A registry's
new index is written aside and put in place whole, so a command stopped while
writing one leaves that registry with a complete index — the one it had before
the run, or the new one — or with none, never with a partial one.
Every strict-SemVer version a recorded repository publishes is listed too, each
with the manifest digest its tag resolves to — the address of the exact bytes
published under that version. Where the registry's trust policy pins a public key
or trusted identities, and verification is not switched off, each version's own
signatures are verified against that policy and the signer is recorded when one
verifies; a version with no signature, or none that verifies, is recorded with no
signer. Where several verify, the signer recorded is the one the transparency log
recorded earliest, whatever order the registry lists them in, so signing a version
again never changes its recorded signer.
Each version's publication date is recorded too, with its source. Where one of the
version's keyless signatures verified, the date is the time the transparency log
recorded that earliest signature, as the verified log entry attests it (source
'transparency-log') — so signing a version again never moves its date. Otherwise
it is the date the publication itself stated beside what it published (source
'publisher'), the earliest where several are stated: the publishing machine's own
clock, which nothing attests, read from any registry whatever its trust policy.
A version with neither — published without stating a date, and not signed
keyless in a way this policy verifies — is recorded with no date.
Only manifests, signature attachments and publication-date attachments are read:
no entity's content is fetched. 'aggrega search -o json' reports these under each
record's 'published' field.
The per-repository records are byte-identical across two runs against the same
registry state; the freshness timestamp is written to a sibling file so it never
disturbs the records.
A refresh reads again only what changed, and finds every change a full re-read
would. For each repository it revalidates the tag listing with a conditional
request, resolves every version's tag to its manifest digest, and revalidates every
version's attachments — its signatures, publication-date statements and deprecation
markers — with one conditional request, plus one for the signatures of a
deprecation marker it judged before. A version whose digest or attachments changed
is read again in full, and its signatures and markers are verified again exactly as
a full re-read verifies them; everything else is kept as recorded. A change to this
registry's trust policy reads every version again under the policy now in force, and
so does a repository whose entry in the index records none of these checks. An
unchanged registry therefore costs one conditional request per repository and two
small requests per version (three where a deprecation marker was judged), with
nothing downloaded. A version is read again on the next refresh where it carries a
deprecation marker that was not honored, or where this run got no way to
revalidate its attachments — which, on a registry that offers none, is every
version.
Several repositories are read at a time. Everything the command records and prints
comes out in repository order, so the index and the output are the same as reading
one repository at a time would produce.
While it walks, a terminal shows the walk's progress on standard error, the way
build and pull show theirs: a row naming each registry, a spinner while that
registry's repository listing is read, then how many of its repositories the walk
has finished out of how many it lists, counted in repository order, and a bar for
the whole walk below the rows. On a terminal that cannot redraw in place, or with
--plain, each registry gets one plain line instead, written when its walk ends,
with the count it ended on and the time it took. When standard error is not a
terminal, no progress is shown. The progress changes nothing the command prints on
standard output.
Use --upgrade to read every repository in full, comparing nothing with the index
already written — to rebuild an index from the registry alone. It finds no change a
refresh without it would miss.
Each published version's deprecation markers are read as the walk goes, and the ones
whose own signature verifies are recorded into the index. Every marker read is
reported, whether or not it was recorded — a version kept as recorded is not read, so
its marker is not reported again — and each registry reports how many markers its
index now records, including when that number is zero. Where signature
verification is disabled for a registry, the walk reports that its markers were not
examined rather than a count, so a registry that published nothing is never confused
with one this run had no basis to judge.

Flag aggrega registry update

FlagDefaultDeskripsi
--upgradefalseMembaca setiap repositori secara penuh, tanpa membandingkan apa pun dengan indeks yang sudah ditulis (penyegaran tanpa flag ini pun sudah membaca ulang apa saja yang berubah)

Apa yang dilaporkan registry update tentang penanda deprecation

Saat menelusuri registry, aggrega registry update membaca penanda deprecation setiap versi yang diterbitkan dan mencatat penanda yang dapat diautentikasinya ke dalam indeks lokal. Perintah ini melaporkan hasil pemindaian itu di setiap jalur, sehingga registry yang tidak menerbitkan penanda dapat dibedakan dari eksekusi yang tidak mencarinya.

Setiap penanda yang dibaca penelusuran menghasilkan satu baris yang menyebut repositori, versi, dan tingkat keparahan yang dicatat penerbit — warning, error, atau retracted — beserta apakah penanda itu dicatat. Versi yang lampirannya tidak berubah sejak penyegaran terakhir dipertahankan sebagaimana tercatat alih-alih dibaca, sehingga penandanya tidak dilaporkan lagi; jumlah di bawah tetap menyertakannya. Penanda hanya dicatat ketika tanda tangannya sendiri terverifikasi terhadap penanda tangan yang diakui kebijakan kepercayaan registry. Penanda yang ada tetapi tidak dapat didekode, atau ada tetapi tidak diakui, dilaporkan sebagaimana adanya dan dikeluarkan dari indeks alih-alih dicatat berdasarkan bukti yang tidak dapat diautentikasi — demikian pula penanda yang menurut jawaban registry tidak disimpannya. Penanda yang pembacaannya gagal adalah kasus yang berbeda: lihat Pembacaan yang gagal.

Setiap registry kemudian melaporkan berapa banyak penanda yang kini dicatat indeksnya, termasuk ketika jumlahnya nol. Jika verifikasi tanda tangan dimatikan — secara global, atau untuk satu registry itu — penelusuran justru melaporkan bahwa penanda tidak diperiksa untuknya. Keduanya adalah fakta yang berbeda: yang pertama menyatakan bahwa registry tidak menerbitkan apa pun yang dapat ditindaklanjuti workspace ini, yang kedua menyatakan bahwa eksekusi ini sama sekali tidak memiliki dasar kepercayaan untuk menilai sebuah penanda. Registry yang penandanya tidak diperiksa tidak menyumbangkan penarikan apa pun ke pemilihan versi, sehingga penulis yang melampirkan penanda dan melihat baris itu tahu mengapa penanda tersebut tidak berpengaruh.

Tanggal penerbitan yang dicatat setiap versi

Waktu pembuatan manifest yang diterbitkan disematkan, sehingga digest-nya hanya bergantung pada apa yang diterbitkan dan tidak pernah pada kapan. Karena itu, tanggal sebuah versi diterbitkan dibaca dari samping manifest, dan aggrega registry update mencatatnya untuk setiap versi beserta sumber asalnya:

  • transparency-log — jika tanda tangan versi bersifat keyless dan terverifikasi terhadap kebijakan kepercayaan registry, waktu log transparansi mencatat tanda tangan itu, yang dibuktikan oleh janji bertanda tangan dari log. Jika beberapa tanda tangan versi terverifikasi, yang digunakan adalah waktu paling awal di antaranya, dan penanda tangan yang dicatat untuk versi itu adalah penanda tangan dari tanda tangan yang sama — dalam urutan apa pun registry mencantumkan tanda tangan — sehingga versi yang ditandatangani lagi mempertahankan tanggal dan penanda tangannya. Untuk versi yang ditandatangani saat diterbitkan, itulah penerbitannya; untuk versi yang pertama kali ditandatangani setelahnya dengan aggrega sign, itulah saat ia ditandatangani. Sumber ini diutamakan di mana pun ia ada.
  • publisher — jika tidak, waktu yang dinyatakan penerbitan di samping apa yang diterbitkannya: lampiran published-at kecil yang ditulis aggrega push dan aggrega push-artifact dengan membawa jam milik mesin yang menerbitkan, yang tidak dibuktikan oleh apa pun. Lampiran ini dibaca dari registry mana pun apa pun kebijakan kepercayaannya, karena ia adalah pernyataan penerbit, bukan keputusan kepercayaan. Jika beberapa dilampirkan, yang paling awal diambil.

Versi yang tidak memiliki keduanya tidak mencatat tanggal. Itu adalah penerbitan yang tidak menyatakan tanggal, dan tanda tangannya bukan tanda tangan keyless yang diverifikasi kebijakan ini — misalnya penerbitan keyless yang dibaca di bawah kebijakan yang tidak memercayai identitas keyless apa pun, karena penerbitan keyless tidak menyatakan tanggalnya sendiri. aggrega search -o json melaporkan tanggal di bawah setiap versi dalam published.

Apa yang dibaca ulang oleh penyegaran

Penyegaran membandingkan apa yang kini disajikan registry dengan apa yang dicatat indeks, lalu membaca ulang semua yang berubah — jawaban yang sama dengan yang diberikan pembacaan ulang penuh. Untuk setiap repositori, penyegaran:

  • memvalidasi ulang daftar tag, sehingga versi yang diterbitkan atau dihapus sejak itu ikut tertangkap;
  • meresolusi tag setiap versi ke manifest yang ditunjuknya, sehingga versi lama yang diterbitkan lagi dengan tag yang sudah ada dibaca ulang;
  • memvalidasi ulang lampiran setiap versi — tanda tangannya, pernyataan tanggal penerbitannya, dan penanda deprecation-nya — sehingga tanda tangan, tanggal, atau penanda yang dilampirkan ke suatu versi sejak itu dibaca dan diverifikasi, serta melakukan hal yang sama untuk tanda tangan penanda deprecation yang telah dinilainya sebelumnya;
  • membandingkan kebijakan kepercayaan registry dengan kebijakan yang digunakan saat indeks dibangun, sehingga perubahan kebijakan membuat setiap versi dibaca ulang di bawah kebijakan yang baru.

Penanda deprecation, tanda tangan, dan tanggal penerbitan masing-masing dilampirkan ke versi yang diterbitkan sebagai objek terpisah yang menunjuk kembali ke versi tersebut — yang justru memungkinkan penerbit menandai versi sebagai deprecated atau menandatanganinya tanpa menerbitkannya ulang — sehingga tidak satu pun dari ketiganya menambah tag atau mengubah manifest versi itu sendiri. Ketiganya mengubah lampiran versi, dan itulah yang divalidasi ulang oleh pemeriksaan ketiga. Pengecualian versi dan aggrega inspect sama-sama membaca indeks ini, sehingga versi yang ditarik sejak penyegaran terakhir dikecualikan dari pemilihan, dan ditampilkan, setelah penyegaran berikutnya dijalankan.

Setiap pemeriksaan adalah permintaan kecil — resolusi digest manifest, atau permintaan bersyarat yang dijawab registry sebagai tidak berubah tanpa mengirim apa pun — sehingga penyegaran registry yang tidak berubah tidak mengunduh apa pun. Versi yang membawa penanda deprecation yang tidak diakui, atau yang lampirannya tidak dapat divalidasi ulang oleh proses ini, dibaca ulang pada penyegaran berikutnya. Registry yang tidak dapat memberi tahu apakah lampiran suatu versi berubah membuat setiap versi dibaca ulang pada setiap penyegaran: jawabannya sama, demikian pula biayanya, yaitu biaya pembacaan ulang penuh.

--upgrade membaca setiap repositori secara penuh, tanpa membandingkan apa pun dengan indeks yang sudah ditulis. Gunakan untuk membangun ulang indeks hanya dari registry; flag ini tidak menangkap apa pun yang terlewat oleh penyegaran.

Registry yang meminta untuk memperlambat

Hub resmi, hub.aggrega.ai, membatasi berapa banyak permintaan yang boleh datang dari satu alamat dalam rentang waktu singkat, sehingga mesin-mesin yang berbagi satu alamat juga berbagi jatah itu, dan registry mana pun dapat membatasi kliennya dengan cara yang sama. Registry yang melewati batasnya menjawab 429 Too Many Requests, atau 503 Service Unavailable dengan header Retry-After yang menyatakan berapa lama harus menunggu. Setiap permintaan yang dibuat baris perintah ke sebuah registry, apa pun perintahnya, menanggapi jawaban itu dengan cara yang sama: menunggu selama yang diminta registry, atau sepuluh detik jika jawabannya tidak menyebutkan, ditambah hingga satu detik lagi secara acak, lalu meminta lagi, tanpa jumlah percobaan yang tetap. Setiap permintaan ke registry itu ikut menunggu, bukan hanya yang ditolak, dan lebih sedikit permintaan dikirim kepadanya sekaligus — separuhnya setiap kali registry meminta, hingga tinggal satu — lalu naik lagi satu per satu setelah setiap rangkaian permintaan yang dilayaninya tanpa gagal, kembali ke jumlah biasa perintah tersebut. Penantian ditampilkan dengan ketentuan yang sama seperti progres perintah lainnya, sebagai baris seperti hub.aggrega.ai asked to slow down; waiting 11 s: aggrega build, aggrega pull, dan aggrega registry update menampilkannya di samping langkah yang sedang berjalan, perintah lain yang menampilkan apa yang mereka tunggu menampilkannya sebagai langkah tersendiri — kecuali aggrega sign --jobs yang menandatangani beberapa referensi sekaligus, yang menampilkan penantian-penantian itu sebagai satu langkah — dan tidak ada yang ditampilkan jika standard error bukan terminal, kecuali --progress perintah memintanya. Registry yang selama lima menit tidak menjawab apa pun selain “perlambat” ditolak dengan E0378, dengan menyebutkan registry tersebut, jawaban terakhirnya, dan sudah berapa lama ia tidak menjawab hal lain; lima menit itu tetap, dan tidak ada pengaturan yang mengubahnya. aggrega registry update kemudian menyebutkan registry itu di bawah Not indexed: dalam ringkasan penutupnya, dan registry itu mempertahankan indeks yang dimilikinya sebelum eksekusi.

Pembacaan yang gagal

Penelusuran membaca banyak objek kecil dari registry, dan sebagian pembacaan gagal sesaat: registry menjawab bahwa ia gagal atau tidak tersedia (status 5xx, selain 503 yang menyatakan berapa lama harus menunggu) atau bahwa permintaan habis waktu (408), koneksi diatur ulang atau habis waktu, atau jawaban berhenti sebelum lengkap. Setiap pembacaan seperti itu diminta lagi beberapa kali, dengan waktu tunggu yang makin lama di antara percobaan. Registry yang meminta penelusuran untuk memperlambat tidak sedang menggagalkan pembacaan: pembacaan menunggu dan diminta lagi seperti dijelaskan dalam Registry yang meminta untuk memperlambat, dan registry yang terus meminta selama lima menit mengakhiri penelusuran registry itu, bukan penelusuran satu repositori.

Pembacaan yang tetap gagal tidak pernah dianggap sebagai jawaban. Tanda tangan yang tidak dapat dibaca bukanlah versi tanpa tanda tangan, dan penanda deprecation yang tidak dapat dibaca bukanlah versi yang tidak pernah ditarik, sehingga penelusuran tidak mencatat apa pun tentang repositori itu dari proses ini. Repositori tersebut mempertahankan catatan yang sudah dimiliki indeks untuknya, bila catatan itu dinilai di bawah kebijakan kepercayaan registry yang kini berlaku, dan jika tidak, dikeluarkan dari indeks. Dalam kedua kasus, penelusuran menyebutkan repositori tersebut dalam keterangan berjalannya, dengan menyatakan mana dari kedua hal itu yang terjadi dan pembacaan mana yang gagal, lalu menyebutkannya lagi dalam ringkasan penutupnya, pada barisnya sendiri di bawah baris registry-nya, di antara repositori yang tidak dapat dibaca:

Indexed 1 registry.
registry.example.com: 41 entities, 1 repository could not be read, 4 reads retried
component/core/web: the registry answered 503 Service Unavailable: …

Baris registry juga menyatakan berapa banyak pembacaan yang diminta lagi, dengan setiap pembacaan dihitung sekali berapa pun percobaan yang diperlukannya dan entah kemudian berhasil atau tidak, dan menyatakan 0 reads retried bila tidak ada. Penelusuran yang semua pembacaannya akhirnya berhasil tidak menampilkan repositori apa pun pada barisnya, sehingga hitungan inilah yang menyatakan seberapa dekat penelusuran itu dengan melewatkan satu repositori.

Setiap baris seperti itu diawali dengan jenis kegagalan terakhir pembacaan tersebut — status yang dijawab registry, pembacaan yang habis waktu, koneksi yang diatur ulang, atau jawaban yang terpotong — diikuti oleh kegagalan itu sendiri, yang menyatakan pembacaan mana yang dimaksud. Kegagalan yang tidak termasuk jenis mana pun di atas, seperti root kepercayaan yang tidak dapat diperoleh untuk memverifikasi tanda tangan, diberikan sebagai kegagalan itu saja. Metode aggrega/registryUpdate dari aggrega serve menjawab dengan repositori yang sama di bawah skipped setiap host, masing-masing dengan reason yang sama, dan dengan jumlah pembacaan yang diminta lagi sebagai readsRetried. Hal yang sama berlaku untuk penyegaran dan untuk --upgrade, dan penelusuran berikutnya dimulai dari apa pun yang saat itu disimpan indeks, seperti halnya untuk repositori mana pun.

Kunci publik yang disematkan kebijakan keyed

Kebijakan kepercayaan keyed menyematkan kunci publik registry secara inline, sebagai public_key milik entri: aggrega registry add --key <file> menyalin isi file ke sana, demikian pula penyematan kebijakan yang diiklankan registry dengan kunci di dalamnya. Nilainya adalah blok kunci publik PEM — teks dari baris -----BEGIN PUBLIC KEY-----, atau -----BEGIN RSA PUBLIC KEY-----, hingga baris -----END yang sesuai — dan teks apa pun di atas blok diabaikan.

Nilai yang tidak memuat baris -----BEGIN … PUBLIC KEY----- ditolak saat file konfigurasi dimuat, dengan menyebut file dan entrinya. registry add melakukan pemeriksaan yang sama sebelum menulis, sehingga file --key yang memuat hal lain — kunci privat, sertifikat, atau kunci dalam pengodean lain — ditolak dan file konfigurasi dibiarkan seperti semula. Hanya baris itu yang diperiksa: apakah blok tersebut dapat didekode menjadi kunci yang dapat digunakan baru diketahui ketika tanda tangan dari registry diverifikasi terhadapnya.

Luring

aggrega registry update adalah satu-satunya perintah dalam kelompok ini yang seluruh pekerjaannya adalah menelusuri registry, dan dalam mode offline — kunci tingkat atas offline dalam file konfigurasi, AGGREGA_OFFLINE, atau --offline — perintah ini menolak sebelum menelusuri apa pun. Penolakan itu menyebutkan mana dari ketiganya yang menetapkan mode tersebut.

Tidak ada bentuk parsial sebagai cadangan, karena indeks mencatat apa yang saat ini disajikan setiap registry dan hal itu tidak dapat diketahui tanpa menanyakannya. Yang dapat dilakukan workspace offline adalah membaca indeks yang sudah dimilikinya: aggrega search dan pemberitahuan deprecation pada aggrega inspect sama-sama membaca snapshot lokal dan sama sekali tidak memerlukan jaringan, sehingga penyegaran adalah satu-satunya hal yang diambil oleh mode tersebut. Untuk menyegarkan dalam satu eksekusi dari workspace offline, berikan --offline=false.

aggrega registry add menjangkau jaringan satu kali, untuk kebijakan kepercayaan yang diiklankan registry, kecuali --fetch-trust=false, --identity, atau --key menyatakan untuk tidak mengambilnya. Dalam mode offline, pengambilan itu ditolak sebelum koneksi apa pun dibuat, sehingga registry tidak pernah ditanya. Menambahkan registry selain hub resmi kemudian ditolak — menambahkan registry adalah satu-satunya momen kepercayaannya disematkan, dan entri yang ditulis tanpa kebijakan tidak akan memercayai apa pun sementara setiap pull berikutnya mengikat registry itu padanya. Penolakan itu membawa kode singkat E0310 dan menyebutkan kedua cara untuk melanjutkan: daftarkan sekali saat online, yang dimungkinkan --offline=false untuk satu eksekusi, atau sematkan kebijakan secara manual dengan --identity atau --key, yang mendaftarkan persis apa yang Anda berikan dan sama sekali tidak melakukan pengambilan. Hub resmi ditambahkan dengan baseline bawaannya, disertai pemberitahuan bahwa hub tidak ditanya tentang kebijakan kepercayaannya karena workspace sedang offline dan baseline digunakan sebagai gantinya, dan --fetch-trust=false mendaftarkan entri dari flag-flagnya persis seperti saat online. Pendaftaran yang sama melalui aggrega serve atau aggrega mcp berperilaku sama: penolakan yang sama dengan kata-kata yang sama, dan selebihnya entri yang sama. A registry is added offline with no trust policy to pin (Registry ditambahkan secara offline tanpa kebijakan kepercayaan untuk disematkan) mengutip penolakan tersebut.

list dan remove mengubah atau membaca konfigurasi lokal dan tidak terpengaruh.