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

aggrega registry

Kayıt defterlerini ve bunların imza güven ilkesini yönetir

Kullanım

aggrega registry

Açıklama

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.

Alt komutlar

KomutAçıklama
aggrega registry addBir kayıt defterini ve onun imza güven ilkesini kaydeder
aggrega registry listYapılandırılmış kayıt defterlerini ve güven durumlarını listeler
aggrega registry removeBir kayıt defterini ve güven ilkesini bir yapılandırma dosyasından kaldırır
aggrega registry updateYapılandırılmış kayıt defterlerinin yerel, aranabilir dizinini oluşturur

aggrega registry add açıklaması

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.

aggrega registry add bayrakları

BayrakVarsayılanAçıklama
--advisoryfalseBu kayıt defteri için doğrulama hatalarını durdurmak yerine uyarılara düşürür
--fetch-trusttrueKayıt defterinin duyurduğu güven ilkesini ilk kullanımda getirir ve sabitler. Atlamak için —fetch-trust=false kullanın; elle verilen —identity/—key de getirmeyi atlar.
--globalfalseGirdiyi tüm çalışma alanlarınca paylaşılan genel yapılandırmaya yazar. Bir kayıt defteri varsayılan olarak buraya yazılır.
--identity[]identity=issuer biçiminde güvenilen anahtarsız kimlik, örneğin dev@example.com=https://accounts.google.com (tekrarlanabilir; VEYA kümesi). Getirilen güven ilkesini geçersiz kılar.
--key—Anahtarlı doğrulama için sabitlenmiş, cosign uyumlu bir genel anahtar PEM dosyasının yolu. Getirilen güven ilkesini geçersiz kılar.
--name—Bu kayıt defteri için isteğe bağlı kolay bir takma ad. Kimlik ana makine olarak kalır; takma ad, bir kayıt defterinin adlandırıldığı her yerde (ör. —registry) ona çözümlenir. Kayıt defterleri arasında benzersiz olmalıdır.
--require-signaturesfalseBu kayıt defterinden çekilen (ve ona gönderilen) her yapıtta imza gerektirir
--trusted-root—Ağdan yalıtılmış anahtarsız doğrulama için sabitlenmiş bir Sigstore güven kökü paketinin yolu
--workspacefalseGirdiyi genel yapılandırma yerine bu projenin çalışma alanı yapılandırmasına yazar.

aggrega registry list açıklaması

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.

aggrega registry list bayrakları

BayrakVarsayılanAçıklama
--output, -otableÇıktı biçimi: table|json.

aggrega registry remove açıklaması

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.

aggrega registry remove bayrakları

BayrakVarsayılanAçıklama
--globalfalseGirdiyi tüm çalışma alanlarınca paylaşılan genel yapılandırmadan kaldırır.
--workspacefalseGirdiyi genel yapılandırma yerine bu projenin çalışma alanı yapılandırmasından kaldırır.

aggrega registry update açıklaması

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.

aggrega registry update bayrakları

BayrakVarsayılanAçıklama
--upgradefalseHer depoyu, önceden yazılmış dizinle hiçbir şeyi karşılaştırmadan baştan sona okur (bu bayrak olmadan yapılan bir yenileme de değişen her şeyi zaten yeniden okur)

registry update komutunun kullanımdan kaldırma işaretleri hakkında bildirdikleri

aggrega registry update, bir kayıt defterini tararken yayımlanmış her sürümün kullanımdan kaldırma işaretlerini okur ve doğrulayabildiklerini yerel dizine kaydeder. Bu taramanın sonucunu her yolda bildirir; böylece hiç işaret yayımlamamış bir kayıt defteri, işaret aramamış bir çalıştırmadan ayırt edilebilir.

Taramanın okuduğu her işaret; depoyu, sürümü ve yayımcının kaydettiği önem derecesini — warning, error veya retracted — işaretin kaydedilip kaydedilmediğiyle birlikte belirten bir satır üretir. Ekleri son yenilemeden bu yana değişmemiş bir sürüm okunmak yerine kaydedildiği gibi tutulur; bu nedenle işareti yeniden bildirilmez, ancak aşağıdaki sayı onu yine de içerir. Bir işaret yalnızca kendi imzası, kayıt defterinin güven ilkesinin kabul ettiği imzalayanlara karşı doğrulandığında kaydedilir. Mevcut ama çözülemeyen ya da mevcut ama kabul edilmeyen bir işaret bu şekilde bildirilir ve doğrulanamayan kanıta dayanarak kaydedilmek yerine dizinin dışında bırakılır; kayıt defterinin elinde bulunmadığını yanıtladığı bir işaret de öyle. Okuması başarısız olan bir işaret farklı bir durumdur: bkz. Başarısız olan bir okuma.

Ardından her kayıt defteri, dizininin artık kaç işaret kaydettiğini bildirir; bu sayı sıfır olduğunda da. İmza doğrulamasının — genel olarak ya da yalnızca o kayıt defteri için — kapatıldığı durumda tarama bunun yerine o kayıt defteri için işaretlerin incelenmediğini bildirir. Bu ikisi farklı olgulardır: ilki, kayıt defterinin bu çalışma alanının üzerinde işlem yapabileceği hiçbir şey yayımlamadığını; ikincisi ise bu çalıştırmanın bir işareti değerlendirecek hiçbir güven temeline sahip olmadığını söyler. İşaretleri incelenmemiş bir kayıt defteri, sürüm seçimine hiçbir geri çekme katkısında bulunmaz; bu nedenle bir işaret eklemiş ve bu satırı gören bir yazar, işaretin neden etkisiz kaldığını bilir.

Her sürümün kaydettiği yayın tarihi

Yayımlanmış bir manifest’in oluşturulma zamanı sabitlenir; böylece özeti yalnızca neyin yayımlandığına bağlıdır, asla ne zaman yayımlandığına bağlı değildir. Bu nedenle bir sürümün yayımlandığı tarih manifest’in yanından okunur ve aggrega registry update bu tarihi her sürüm için geldiği kaynakla birlikte kaydeder:

  • transparency-log — sürümün imzası anahtarsız olduğunda ve kayıt defterinin güven politikasına göre doğrulandığında, şeffaflık günlüğünün o imzayı kaydettiği zamandır; bunu günlüğün imzalı taahhüdü onaylar. Sürümün birden fazla imzası doğrulandığında, bu zaman onların zamanlarının en erkenidir ve sürüm için kaydedilen imzalayan da aynı imzanınkidir — kayıt defteri imzaları hangi sırayla listelerse listelesin — böylece yeniden imzalanan bir sürüm tarihini ve imzalayanını korur. Yayımlanırken imzalanan bir sürüm için bu, yayımlanma zamanıdır; daha sonra aggrega sign ile ilk kez imzalanan bir sürüm için ise imzalandığı zamandır. Bu kaynak, var olduğu her yerde önceliklidir.
  • publisher — aksi takdirde, yayının yayımladığı şeyin yanında belirttiği zamandır: aggrega push ve aggrega push-artifact komutlarının yazdığı, yayımlayan makinenin kendi saatini taşıyan ve hiçbir şeyin onaylamadığı küçük bir yayımlanma zamanı eki. Bir güven kararı değil yayımlayanın beyanı olduğundan, güven politikası ne olursa olsun her kayıt defterinden okunur. Birden fazla ek bulunduğunda en erkeni alınır.

İkisi de olmayan bir sürüm tarih kaydetmez. Bu, imzası bu politikanın doğruladığı anahtarsız bir imza olmayan ve tarih belirtmemiş bir yayındır — örneğin hiçbir anahtarsız kimliğe güvenmeyen bir politika altında okunan anahtarsız bir yayın; çünkü anahtarsız bir yayın kendi başına bir tarih belirtmez. aggrega search -o json, tarihi her sürümün altında published içinde bildirir.

Bir yenilemenin yeniden okudukları

Bir yenileme, kayıt defterinin şu anda sunduğunu dizinin kaydettiğiyle karşılaştırır ve değişen her şeyi yeniden okur — tam bir yeniden okumanın verdiği yanıtın aynısı. Her depo için:

  • etiket listesini yeniden doğrular, böylece o zamandan beri yayımlanan ya da silinen bir sürüm algılanır;
  • her sürümün etiketini adlandırdığı manifeste çözümler, böylece mevcut etiketi altında yeniden yayımlanan eski bir sürüm yeniden okunur;
  • her sürümün eklerini — imzalarını, yayım tarihi beyanlarını ve kullanımdan kaldırma işaretlerini — yeniden doğrular, böylece o zamandan beri bir sürüme eklenen bir imza, tarih ya da işaret okunur ve doğrulanır; daha önce değerlendirdiği bir kullanımdan kaldırma işaretinin imzaları için de aynısını yapar;
  • kayıt defterinin güven ilkesini dizinin oluşturulduğu ilkeyle karşılaştırır, böylece ilkede yapılan bir değişiklik her sürümün yeni ilke altında yeniden okunmasını sağlar.

Bir kullanımdan kaldırma işareti, bir imza ve bir yayım tarihi, her biri yayımlanmış bir sürüme ona geri işaret eden ayrı bir nesne olarak eklenir; bir yayımcının bir sürümü yeniden yayımlamadan kullanımdan kaldırabilmesini ya da imzalayabilmesini sağlayan da tam olarak budur. Bu nedenle hiçbiri etiket eklemez ya da sürümün kendi manifestini değiştirmez. Bunlar sürümün eklerini değiştirir ve üçüncü denetimin yeniden doğruladığı da budur. Sürüm dışlama ve aggrega inspect bu dizini okur; bu nedenle son yenilemeden bu yana geri çekilmiş bir sürüm, bir sonraki yenileme çalıştığında seçimin dışında bırakılır ve gösterilir.

Her denetim küçük bir istektir — bir manifest özetinin çözümlenmesi ya da kayıt defterinin hiçbir şey göndermeden değişmedi diye yanıtladığı koşullu bir istek — bu nedenle değişmemiş bir kayıt defterinin yenilenmesi hiçbir şey indirmez. Kabul edilmemiş bir kullanımdan kaldırma işareti taşıyan ya da eklerini bu çalıştırmanın yeniden doğrulamasının hiçbir yolu olmamış bir sürüm, bir sonraki yenilemede yeniden okunur. Bir sürümün eklerinin değişip değişmediğini söyleyemeyen bir kayıt defterinde her yenilemede her sürüm yeniden okunur: yanıt aynıdır, maliyet de tam bir yeniden okumanınkiyle aynıdır.

--upgrade, önceden yazılmış dizinle hiçbir şeyi karşılaştırmadan her depoyu baştan sona okur. Bir dizini yalnızca kayıt defterinden yeniden oluşturmak için kullanın; bir yenilemenin kaçırdığı hiçbir şeyi yakalamaz.

Yavaşlamayı isteyen bir kayıt defteri

Resmî hub hub.aggrega.ai, kısa bir süre içinde tek bir adresten kaç istek gelebileceğini sınırlar; bu nedenle bir adresi paylaşan makineler bu kotayı da paylaşır ve herhangi bir kayıt defteri istemcilerini aynı şekilde sınırlayabilir. Sınırını aşan bir kayıt defteri 429 Too Many Requests ile ya da ne kadar bekleneceğini söyleyen bir Retry-After üst bilgisiyle birlikte 503 Service Unavailable ile yanıt verir. Komut satırının bir kayıt defterine yaptığı her istek, komut hangisi olursa olsun, bu yanıtı aynı şekilde karşılar: kayıt defterinin istediği kadar, yanıt bunu belirtmiyorsa on saniye, artı rastgele en fazla bir saniye daha bekler ve sonra yeniden sorar; sabit bir deneme sayısı yoktur. Yalnızca reddedilen değil, o kayıt defterine yapılan her istek onunla birlikte bekler ve ona aynı anda daha az istek gönderilir — her istediğinde yarı yarıya, en az bire kadar —; bu sayı, başarısız olmadan sunduğu her istek dizisinden sonra birer birer yeniden artarak komutun olağan sayısına döner. Bekleme, komutun ilerlemesinin geri kalanıyla aynı koşullarda, hub.aggrega.ai asked to slow down; waiting 11 s gibi bir satır olarak gösterilir: aggrega build, aggrega pull ve aggrega registry update bunu sürmekte olan adımın yanında gösterir; neyi beklediğini gösteren diğer komutlar bunu ayrı bir adım olarak gösterir — birden çok başvuruyu aynı anda imzalayan aggrega sign --jobs hariç; o bu beklemeleri tek bir adım olarak gösterir — ve standart hata bir terminal değilse, komutun --progress seçeneği istemedikçe hiçbir şey gösterilmez. Beş dakika boyunca “yavaşla” dışında hiçbir yanıt vermeyen bir kayıt defteri E0378 altında reddedilir; ret, kayıt defterini, son yanıtını ve ne kadar süredir başka bir yanıt vermediğini belirtir; beş dakika sabittir ve bunu değiştiren bir ayar yoktur. Ardından aggrega registry update, kapanış özetinde o kayıt defterini Not indexed: altında belirtir ve kayıt defteri çalıştırmadan önceki dizinini korur.

Başarısız olan bir okuma

Bir tarama, bir kayıt defterinden çok sayıda küçük nesne okur ve bazı okumalar geçici olarak başarısız olur: kayıt defteri başarısız olduğunu ya da kullanılamaz olduğunu (ne kadar bekleneceğini söyleyen bir 503 dışında bir 5xx durumu) veya isteğin zaman aşımına uğradığını (bir 408) yanıtlar, bağlantı sıfırlanır ya da zaman aşımına uğrar veya bir yanıt tamamlanmadan kesilir. Bu tür her okuma, denemeler arasındaki bekleme giderek uzatılarak birkaç kez yeniden istenir. Taramadan yavaşlamasını isteyen bir kayıt defteri bir okumayı başarısız kılmaz: okuma, Yavaşlamayı isteyen bir kayıt defteri bölümünde açıklandığı gibi bekler ve yeniden istenir; beş dakika boyunca istemeyi sürdüren bir kayıt defteri ise tek bir deponun değil, o kayıt defterinin taramasını sonlandırır.

Hâlâ başarısız olan bir okuma asla bir yanıt olarak kabul edilmez. Okunamayan bir imza, imzasız bir sürüm demek değildir; okunamayan bir kullanımdan kaldırma işareti de hiç geri çekilmemiş bir sürüm demek değildir; bu nedenle tarama bu çalıştırmadan o depo hakkında hiçbir şey kaydetmez. Dizinin o depo için zaten tuttuğu kayıt, şu anda yürürlükte olan kayıt defteri güven ilkesine göre değerlendirilmişse depo bu kaydı korur; aksi hâlde dizinin dışında bırakılır. Her iki durumda da tarama, süregelen açıklamasında depoyu adlandırır, ikisinden hangisinin olduğunu ve hangi okumanın başarısız olduğunu söyler ve kapanış özetinde, kayıt defterinin satırının altında kendine ait bir satırda, okunamayan depolar arasında onu yeniden adlandırır:

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: …

Kayıt defterinin satırı ayrıca kaç okumanın yeniden istendiğini de söyler; her okuma, kaç deneme sürmüş olursa olsun ve ardından başarılı olsun ya da olmasın bir kez sayılır; hiçbiri yeniden istenmediğinde 0 reads retried yazar. Okumalarının tümü sonunda başarılı olan bir tarama, satırında hiçbir depo göstermez; bu nedenle birini dışarıda bırakmaya ne kadar yaklaştığını söyleyen bu sayıdır.

Bu tür her satır, okumanın son başarısızlığının türüyle başlar — kayıt defterinin yanıt verdiği durum, zaman aşımına uğrayan bir okuma, sıfırlanan bir bağlantı ya da yarıda kesilen bir yanıt — ardından hangi okuma olduğunu söyleyen başarısızlığın kendisi gelir. Bu türlerin hiçbirine girmeyen bir başarısızlık, örneğin bir imzayı doğrulamak için gereken güven kökünün edinilememesi, yalnızca başarısızlığın kendisi olarak verilir. aggrega serve komutunun aggrega/registryUpdate yöntemi, her ana makinenin skipped alanı altında aynı depolarla, her biri aynı reason ile ve yeniden istenen okumaların sayısını readsRetried olarak vererek yanıt verir. Aynısı bir yenileme ve --upgrade için de geçerlidir ve sonraki tarama, her depoda olduğu gibi, dizinin o anda tuttuğu şeyden başlar.

Anahtarlı bir politikanın sabitlediği açık anahtar

Anahtarlı bir güven politikası, kayıt defterinin açık anahtarını satır içinde, girdinin public_key değeri olarak sabitler: aggrega registry add --key <file> dosyanın içeriğini oraya kopyalar; kayıt defterinin duyurduğu ve içinde anahtar bulunan bir politikayı sabitlemek de aynısını yapar. Değer bir PEM açık anahtar bloğudur — bir -----BEGIN PUBLIC KEY----- satırından ya da -----BEGIN RSA PUBLIC KEY----- satırından, ona karşılık gelen -----END satırına kadar olan metin — ve bloğun üstündeki her metin yok sayılır.

-----BEGIN … PUBLIC KEY----- satırı içermeyen bir değer, yapılandırma dosyası yüklenirken dosya ve girdi adı belirtilerek reddedilir. registry add yazmadan önce aynı denetimi yapar; bu nedenle başka bir şey içeren bir --key dosyası — bir özel anahtar, bir sertifika ya da başka bir kodlamadaki bir anahtar — reddedilir ve yapılandırma dosyası olduğu gibi bırakılır. Yalnızca bu satır denetlenir: bloğun kullanılabilir bir anahtara çözülüp çözülmediği, kayıt defterinden gelen bir imza bu anahtara karşı doğrulandığında anlaşılır.

Çevrimdışı

aggrega registry update, bu gruptaki işinin tamamı kayıt defterlerini dolaşmak olan tek komuttur ve çevrimdışı duruş altında — bir yapılandırma dosyasındaki üst düzey offline anahtarı, AGGREGA_OFFLINE veya --offline — herhangi bir şeyi dolaşmadan önce reddeder. Ret, duruşu bu üçünden hangisinin belirlediğini adlandırır.

Geri dönülebilecek kısmi bir biçim yoktur, çünkü dizin her kayıt defterinin şu anda neyi sunduğunu kaydeder ve bu, birine sormadan öğrenilemez. Çevrimdışı bir çalışma alanının yapabileceği şey, zaten sahip olduğu dizini okumaktır: aggrega search ve aggrega inspect üzerindeki kullanımdan kaldırma bildirimi, ikisi de yerel anlık görüntüyü okur ve hiç ağ gerektirmez; dolayısıyla duruşun ortadan kaldırdığı tek şey yenilemedir. Çevrimdışı bir çalışma alanından tek bir çalıştırma için yenilemek üzere --offline=false geçirin.

aggrega registry add, --fetch-trust=false, --identity veya --key getirmemesini söylemedikçe, kayıt defterinin duyurduğu güven politikası için ağa bir kez erişir. Çevrimdışı duruş altında bu getirme, herhangi bir bağlantı kurulmadan önce reddedilir; bu nedenle kayıt defterine hiç sorulmaz. Bu durumda resmî hub dışında bir kayıt defteri eklemek reddedilir — bir kayıt defterini eklemek, güveninin sabitlendiği tek andır ve politika olmadan yazılmış bir girdi hiçbir şeye güvenmezken sonraki her çekme işlemi kayıt defterini buna bağlı tutardı. Ret E0310 kısa kodunu taşır ve iki ilerleme yolunu da adlandırır: çevrimiçiyken bir kez kaydedin (--offline=false bunu tek bir çalıştırma için mümkün kılar) ya da politikayı --identity veya --key ile elle sabitleyin; bu, tam olarak sağladığınız şeyi kaydeder ve hiç getirme yapmaz. Resmî hub, yerleşik temel çizgisiyle eklenir; çalışma alanı çevrimdışı olduğu için hub’a güven politikasının sorulmadığını ve bunun yerine temel çizginin kullanıldığını belirten bir bildirimle birlikte. --fetch-trust=false ise girdiyi bayraklarından tam olarak çevrimiçi olduğu gibi kaydeder. aggrega serve veya aggrega mcp üzerinden yapılan aynı kayıt da aynı şekilde davranır: aynı sözcüklerle aynı ret, aksi hâlde aynı girdi. A registry is added offline with no trust policy to pin (Sabitlenecek güven politikası olmadan çevrimdışı bir kayıt defteri ekleniyor) reddi aktarır.

list ve remove yerel yapılandırmayı değiştirir veya okur ve etkilenmez.