Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

aggrega registry

Керувати реєстрами та їхньою політикою довіри до підписів

Синтаксис

aggrega registry

Опис

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.

Підкоманди

КомандаОпис
aggrega registry addЗареєструвати реєстр та його політику довіри до підписів
aggrega registry listПоказати налаштовані реєстри та їхній стан довіри
aggrega registry removeВидалити реєстр та його політику довіри з файлу конфігурації
aggrega registry updateПобудувати локальний індекс для пошуку за налаштованими реєстрами

Опис 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.

Прапорці aggrega registry add

ПрапорецьЗа замовчуваннямОпис
--advisoryfalseЗнизити рівень помилок перевірки для цього реєстру до попереджень замість зупинки
--fetch-trusttrueОтримати та закріпити оголошену реєстром політику довіри під час першого використання. Щоб пропустити, використайте —fetch-trust=false; ручні —identity/—key також пропускають отримання.
--globalfalseЗаписати запис у глобальну конфігурацію, спільну для всіх робочих просторів. Реєстр за замовчуванням записується сюди.
--identity[]Довірена безключова ідентичність у форматі identity=issuer, наприклад dev@example.com=https://accounts.google.com (можна повторювати; множина OR). Перевизначає отриману політику довіри.
--key—Шлях до закріпленого PEM-файлу відкритого ключа, сумісного з cosign, для перевірки з ключем. Перевизначає отриману політику довіри.
--name—Необов’язковий зручний псевдонім для цього реєстру. Ідентичністю залишається хост; псевдонім розв’язується в нього всюди, де вказується реєстр (наприклад, —registry). Має бути унікальним серед реєстрів.
--require-signaturesfalseВимагати підпис для кожного артефакту, отриманого з цього реєстру (і надісланого до нього)
--trusted-root—Шлях до закріпленого пакета кореня довіри Sigstore для безключової перевірки в ізольованому середовищі
--workspacefalseЗаписати запис у конфігурацію робочого простору цього проєкту замість глобальної конфігурації.

Опис 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.

Прапорці aggrega registry list

ПрапорецьЗа замовчуваннямОпис
--output, -otableФормат виведення: table|json.

Опис 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.

Прапорці aggrega registry remove

ПрапорецьЗа замовчуваннямОпис
--globalfalseВидалити запис із глобальної конфігурації, спільної для всіх робочих просторів.
--workspacefalseВидалити запис із конфігурації робочого простору цього проєкту замість глобальної конфігурації.

Опис 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.

Прапорці aggrega registry update

ПрапорецьЗа замовчуваннямОпис
--upgradefalseЧитає кожен репозиторій повністю, нічого не порівнюючи з уже записаним індексом (оновлення без цього прапорця й так повторно читає все, що змінилося)

Що registry update повідомляє про позначки застарілості

Обходячи реєстр, aggrega registry update зчитує позначки застарілості кожної опублікованої версії та записує до локального індексу ті з них, які може автентифікувати. Результат цього сканування повідомляється за будь-якого сценарію, тож реєстр, який не опублікував жодної позначки, можна відрізнити від запуску, який їх не шукав.

Кожна позначка, яку читає обхід, дає один рядок із назвою репозиторію, версією та рівнем серйозності, який записав видавець, — warning, error або retracted, — а також відомістю, чи було позначку записано. Версію, вкладення якої не змінилися від останнього оновлення, зберігають у записаному вигляді замість повторного читання, тож її позначку не повідомляють знову; кількість, наведена нижче, усе одно її враховує. Позначку записують лише тоді, коли її власний підпис перевіряється щодо підписантів, яких визнає політика довіри реєстру. Позначку, яка наявна, але не декодується, або наявна, але не визнана, позначають як таку й не включають до індексу, а не записують на підставі даних, які не вдалося автентифікувати, — так само й позначку, про яку реєстр відповідає, що не зберігає її. Позначка, читання якої не вдалося, — інший випадок: див. Читання, яке не вдалося.

Потім для кожного реєстру повідомляється, скільки позначок тепер записано в його індексі, зокрема коли це число дорівнює нулю. Якщо перевірку підписів вимкнено — глобально або для цього одного реєстру, — обхід натомість повідомляє, що позначки для нього не перевірялися. Це два різні факти: перший означає, що реєстр не опублікував нічого, на що цей робочий простір може зреагувати, другий — що цей запуск узагалі не мав підстав довіри, щоб оцінити позначку. Реєстр, позначки якого не перевірялися, не вносить жодного відкликання до вибору версії, тож автор, який додав позначку й бачить цей рядок, знає, чому вона не діє.

Дата публікації, яку записує кожна версія

Час створення опублікованого маніфесту зафіксовано, тож його дайджест залежить лише від того, що опубліковано, і ніколи — від того, коли. Тому дату публікації версії зчитують поруч із маніфестом, і aggrega registry update записує її для кожної версії разом із джерелом, з якого вона походить:

  • transparency-log — якщо підпис версії безключовий і проходить перевірку за політикою довіри реєстру, це час, який журнал прозорості записав для цього підпису і який засвідчує підписана обіцянка журналу. Якщо перевірку проходять кілька підписів версії, це найраніший із їхніх часів, а підписант, записаний для версії, — підписант того самого підпису, незалежно від порядку, у якому реєстр перелічує підписи, — тож версія, підписана повторно, зберігає свою дату і свого підписанта. Для версії, підписаної під час публікації, це момент її публікації; для версії, уперше підписаної пізніше за допомогою aggrega sign, це момент підписання. Це джерело має перевагу всюди, де воно є.
  • publisher — інакше, час, який публікація вказала поруч із тим, що опублікувала: невелике вкладення published-at, яке aggrega push і aggrega push-artifact записують із показами власного годинника машини, що публікує, і яке ніщо не засвідчує. Його зчитують із будь-якого реєстру незалежно від його політики довіри, бо це заява видавця, а не рішення щодо довіри. Якщо таких вкладень кілька, береться найраніше.

Версія без жодного з них не записує дати. Це публікація, яка жодної дати не вказала, а її підпис не є безключовим підписом, який перевіряє ця політика, — наприклад, безключова публікація, зчитана за політики, яка не довіряє жодній безключовій ідентичності, адже безключова публікація не вказує власної дати. aggrega search -o json повідомляє дату для кожної версії в published.

Що оновлення читає повторно

Оновлення порівнює те, що реєстр віддає зараз, із тим, що записав індекс, і повторно читає все, що змінилося, — з тим самим результатом, що й повне повторне читання. Для кожного репозиторію воно:

  • повторно перевіряє список тегів, тож версію, опубліковану або видалену відтоді, буде виявлено;
  • розв’язує тег кожної версії до маніфесту, на який він указує, тож старішу версію, повторно опубліковану під наявним тегом, буде прочитано знову;
  • повторно перевіряє вкладення кожної версії — її підписи, заяви про дату публікації та позначки застарілості, — тож підпис, дату чи позначку, прикріплені до версії відтоді, буде прочитано й перевірено; те саме воно робить для підписів позначки застарілості, яку оцінило раніше;
  • порівнює політику довіри реєстру з тією, за якою було побудовано індекс, тож зміна політики спричиняє повторне читання кожної версії за новою.

Позначку застарілості, підпис і дату публікації прикріплюють до опублікованої версії як окремі об’єкти, кожен із яких посилається на неї, — саме це дає змогу видавцю позначити версію як застарілу або підписати її без повторної публікації, — тож жоден із них не додає тегу і не змінює власний маніфест версії. Вони змінюють вкладення версії, і саме це заново перевіряє третя перевірка. Виключення версій і aggrega inspect обидва читають цей індекс, тож версію, відкликану після останнього оновлення, буде виключено з вибору й показано, щойно відбудеться наступне оновлення.

Кожна перевірка — це невеликий запит: розв’язання дайджесту маніфесту або умовний запит, на який реєстр відповідає, що змін немає, нічого не надсилаючи, — тож оновлення незміненого реєстру нічого не завантажує. Версію з позначкою застарілості, яку не було визнано, або версію, вкладення якої цей запуск не мав змоги повторно перевірити, буде прочитано знову під час наступного оновлення. Для реєстру, який не може сказати, чи змінилися вкладення версії, кожну версію читають знову під час кожного оновлення: відповідь та сама, і вартість така сама, як у повного повторного читання.

--upgrade читає кожен репозиторій повністю, нічого не порівнюючи з уже записаним індексом. Використовуйте його, щоб перебудувати індекс лише з реєстру; він не виявляє нічого, що пропустило б оновлення.

Реєстр, який просить сповільнитися

Офіційний хаб, hub.aggrega.ai, обмежує кількість запитів, що можуть надійти з однієї адреси за короткий проміжок часу, тож машини зі спільною адресою ділять між собою цю квоту, і будь-який реєстр може так само обмежувати своїх клієнтів. Реєстр, що перевищив свій ліміт, відповідає 429 Too Many Requests або 503 Service Unavailable із заголовком Retry-After, який повідомляє, скільки чекати. Кожен запит, який командний рядок надсилає до реєстру, хоч би яка була команда, реагує на таку відповідь однаково: чекає стільки, скільки попросив реєстр, або десять секунд, якщо відповідь цього не вказує, плюс до однієї секунди випадково, а потім запитує знову, без фіксованої кількості спроб. Разом із ним чекає кожен запит до цього реєстру, а не лише відхилений, і одночасно до нього надсилається менше запитів — удвічі менше щоразу, коли він про це просить, аж до одного, — а після кожної серії запитів, яку він обслуговує без збоїв, їх кількість знову зростає на один, повертаючись до звичайної кількості для команди. Очікування показується на тих самих умовах, що й решта прогресу команди, як рядок на кшталт hub.aggrega.ai asked to slow down; waiting 11 s: aggrega build, aggrega pull і aggrega registry update показують його поруч із кроком, що виконується, інші команди, які показують, на що вони чекають, показують його як окремий крок — окрім aggrega sign --jobs, що підписує кілька посилань одночасно і показує ці очікування як один крок, — а якщо стандартний потік помилок не є терміналом, нічого не показується, хіба що цього вимагає --progress команди. Реєстр, який протягом п’яти хвилин не відповідає нічим, крім «сповільніться», відхиляється з кодом E0378, із зазначенням реєстру, його останньої відповіді та того, як довго він не відповідав нічим іншим; п’ять хвилин фіксовані, і жоден параметр їх не змінює. Тоді aggrega registry update називає цей реєстр під Not indexed: у підсумку наприкінці, а реєстр зберігає індекс, який мав до запуску.

Читання, яке не вдалося

Обхід читає з реєстру багато невеликих об’єктів, і деякі читання принагідно не вдаються: реєстр відповідає, що стався збій або що він недоступний (статус 5xx, окрім 503, який повідомляє, скільки чекати), або що запит перевищив час очікування (408), з’єднання скидається або перевищує час очікування, або відповідь обривається, не завершившись. Кожне таке читання запитують знову кілька разів, зі зростаючим очікуванням між спробами. Реєстр, який просить обхід сповільнитися, не спричиняє збою читання: читання чекає і запитується знову, як описано в розділі Реєстр, який просить сповільнитися, а реєстр, який просить про це п’ять хвилин поспіль, завершує обхід усього цього реєстру, а не одного репозиторію.

Читання, яке все одно не вдалося, ніколи не сприймається як відповідь. Підпис, який не вдалося прочитати, — це не версія без підпису, а позначка застарілості, яку не вдалося прочитати, — це не версія, яку ніколи не відкликали, тож обхід нічого не записує про цей репозиторій за цей запуск. Репозиторій зберігає запис, який індекс уже має для нього, якщо цей запис було оцінено за чинною зараз політикою довіри реєстру, а інакше не включається до індексу. В обох випадках обхід називає репозиторій у своєму поточному коментарі, повідомляючи, що з двох сталося і яке читання не вдалося, і називає його знову в підсумку наприкінці, окремим рядком під рядком свого реєстру, серед репозиторіїв, які не вдалося прочитати:

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

Рядок реєстру також повідомляє, скільки читань запитали знову, — кожне читання враховується один раз, скільки б спроб воно не забрало і чи вдалося воно потім, — і показує 0 reads retried, коли таких не було. Обхід, усі читання якого зрештою вдалися, не показує жодного репозиторію у своєму рядку, тож саме ця кількість свідчить, наскільки близько він був до того, щоб пропустити якийсь.

Кожен такий рядок починається з виду останнього збою читання — статусу, яким відповів реєстр, читання, що перевищило час очікування, з’єднання, яке було скинуто, або обірваної відповіді, — після чого йде сам збій, що вказує, яке це було читання. Збій, що не належить до жодного з цих видів, наприклад неможливість отримати корінь довіри для перевірки підпису, наводиться лише як сам збій. Метод aggrega/registryUpdate у aggrega serve відповідає тими самими репозиторіями в skipped кожного хоста, кожен із тим самим reason, і кількістю повторно запитаних читань як readsRetried. Те саме стосується оновлення та --upgrade, а наступний обхід починається з того, що на той момент містить індекс, як і для будь-якого репозиторію.

Відкритий ключ, який закріплює політика з ключем

Політика довіри з ключем закріплює відкритий ключ реєстру безпосередньо, як public_key запису: aggrega registry add --key <file> копіює туди вміст файлу, і так само діє закріплення політики з ключем, яку оголошує реєстр. Значення — це блок відкритого ключа у форматі PEM: текст від рядка -----BEGIN PUBLIC KEY----- або -----BEGIN RSA PUBLIC KEY----- до відповідного рядка -----END; будь-який текст над блоком ігнорується.

Значення без рядка -----BEGIN … PUBLIC KEY----- відхиляється під час завантаження файлу конфігурації, із зазначенням файлу та запису. registry add виконує ту саму перевірку перед записом, тож файл --key, що містить щось інше — закритий ключ, сертифікат або ключ в іншому кодуванні, — відхиляється, а файл конфігурації залишається без змін. Перевіряється лише цей рядок: чи декодується блок у придатний ключ, з’ясовується тоді, коли підпис від реєстру перевіряється за ним.

Офлайн

aggrega registry update — єдина команда цієї групи, уся робота якої полягає в обході реєстрів, і в офлайн-режимі — за ключа верхнього рівня offline у файлі конфігурації, AGGREGA_OFFLINE або --offline — вона відмовляє ще до того, як щось обійде. Відмова називає, котре з трьох увімкнуло цей режим.

Часткової форми, до якої можна було б повернутися, немає, бо індекс фіксує, що кожен реєстр обслуговує зараз, а це неможливо дізнатися, не запитавши реєстр. Що офлайн-робочий простір може робити — це читати індекс, який у нього вже є: aggrega search і повідомлення про застарілість у aggrega inspect обидва читають локальний знімок і зовсім не потребують мережі, тож оновлення — єдине, що забирає цей режим. Щоб оновити індекс для одного запуску з офлайн-робочого простору, передайте --offline=false.

aggrega registry add звертається до мережі один раз — по політику довіри, яку оголошує реєстр, якщо тільки --fetch-trust=false, --identity або --key не вказують не завантажувати її. В офлайн-режимі це завантаження відхиляється ще до будь-якого з’єднання, тож реєстр ніколи не запитується. Додавання реєстру, відмінного від офіційного хабу, тоді відхиляється: додавання реєстру — єдиний момент, коли закріплюється довіра до нього, і запис, створений без політики, не довіряв би нічому, тоді як кожне подальше завантаження перевірялося б за ним. Відмова містить короткий код E0310 і називає обидва шляхи далі: один раз зареєструйте реєстр онлайн, що --offline=false дозволяє для одного запуску, або закріпіть політику вручну за допомогою --identity чи --key, що реєструє саме те, що ви надаєте, і взагалі не виконує завантаження. Офіційний хаб додається на основі вбудованої базової політики з повідомленням, що в хабу не запитували політику довіри, бо робочий простір офлайн, і натомість використано базову, а --fetch-trust=false реєструє запис за його прапорцями так само, як і онлайн. Та сама реєстрація через aggrega serve або aggrega mcp поводиться так само: та сама відмова тими самими словами, а інакше — той самий запис. A registry is added offline with no trust policy to pin (Реєстр додається офлайн без політики довіри для закріплення) наводить текст відмови.

list і remove змінюють або читають локальну конфігурацію, і режим на них не впливає.