aggrega registry
Управление реестрами и их политикой доверия к подписям
Синтаксис
aggrega registryОписание
Manage the OCI registries Aggrega publishes to and resolves from, together withthe signature trust policy for each.
A registry entry records where to reach the registry and what to require of thesignatures on artifacts it serves — which identities are trusted, and whether asignature is required at all. That policy is what "aggrega pull" enforces whenit verifies an artifact and what "aggrega push" honours when it decides whetherto sign.
"aggrega registry add" can fetch a registry's own advertised trust policy ratherthan having you write it out. "aggrega registry update" builds the localsearchable index that "aggrega search" and "aggrega plugin add" read.
A registry entry is written to the global config shared across every workspaceon this machine, because a registry and the identities you trust on it areusually the same wherever you work. That makes adding or removing one amachine-wide change: every project on this machine resolves through the entryyou just wrote or dropped. Pass --workspace to write it to this project's configfile instead. Building the searchable index is the exception — that lands inthis 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 ismade in one spelling: a lowercase host name containing a dot, localhost, a singlename followed by a port (registry:5000), an IPv4 address, or an IPv6 address inbrackets, each with an optional :port. A reference may be given instead — itsscheme, path and credentials are dropped and the entry is keyed under the host itnames — but a host written in capitals, with the default HTTPS port, or as asingle name with no port is refused, naming the spelling to write where there isone.
The entry is written to the global config shared across every workspace, since aregistry and the identities you trust on it are usually the same wherever youwork. Pass --workspace to write it to this project's config file instead; the twoflags are mutually exclusive.
By default the registry's advertised trust policy is fetched once from theregistry's own origin (https://<host>/.well-known/aggrega-trust) and pinnedlocally — trust-on-first-use. Verification at pull time always runs against thepinned local policy, never a live re-fetch. Pass --fetch-trust=false to skip thefetch 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-keyPEM). Manual --identity / --key flags OVERRIDE the fetched set — when either issupplied, 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 keylessverification. Adding the official hub host with no policy flags pins the built-inofficial 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 officialhub writes its built-in baseline instead, and the notice says the baseline waspinned.
When the workspace is offline the advertised policy cannot be fetched, so theregistry is never asked. Adding a registry other than the official hub is thenrefused unless --identity or --key supplies the policy, rather than writing anentry 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 sayingso, and a manual policy registers offline exactly as it does online.
Existing settings in the target config file are preserved.Флаги aggrega registry add
| Флаг | По умолчанию | Описание |
|---|---|---|
--advisory | false | Понизить ошибки проверки для этого реестра до предупреждений вместо остановки |
--fetch-trust | true | Получить и закрепить объявленную реестром политику доверия при первом использовании. Чтобы пропустить, используйте —fetch-trust=false; ручные —identity/—key также отключают получение. |
--global | false | Записать запись в глобальную конфигурацию, общую для всех рабочих пространств. По умолчанию реестр записывается сюда. |
--identity | [] | Доверенная бесключевая идентичность в виде identity=issuer, например dev@example.com=https://accounts.google.com (можно повторять; объединяются по ИЛИ). Переопределяет полученную политику доверия. |
--key | — | Путь к закреплённому PEM-файлу открытого ключа, совместимому с cosign, для проверки по ключу. Переопределяет полученную политику доверия. |
--name | — | Необязательный удобный псевдоним для этого реестра. Идентичностью остаётся хост; псевдоним разрешается в него везде, где указывается реестр (например, —registry). Должен быть уникальным среди реестров. |
--require-signatures | false | Требовать подпись для каждого артефакта, получаемого из этого реестра (и отправляемого в него) |
--trusted-root | — | Путь к закреплённому пакету корня доверия Sigstore для бесключевой проверки в изолированной среде |
--workspace | false | Записать запись в конфигурацию рабочего пространства этого проекта вместо глобальной конфигурации. |
Описание 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 onthe default registry.
This reads the resolved configuration and never contacts a registry. Registriesare 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 discretefields rather than the table's rendered sentence, and whether a credential forthat host is present in the shared credential store. The credential state reportspresence 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 anetwork round trip. Reading it consults the local credential store, which honorsa configured credential helper. The order is the same ascending host order thetable uses.Флаги aggrega registry list
| Флаг | По умолчанию | Описание |
|---|---|---|
--output, -o | table | Формат вывода: table|json. |
Описание aggrega registry remove
Remove a registry's trust-policy entry from a config file, addressed by its hostor its friendly alias.
By default the entry is removed from the global config shared across everyworkspace; pass --workspace to remove it from this project's workspace configinstead. Setting both --global and --workspace is a usage error.
The default_registry pointer is left untouched — removing a registry's trustpolicy reverts that host to default trust; it does not change which registry isthe default. Where default_registry names the removed entry by its alias, thatalias names nothing afterwards, and the configuration is refused untildefault_registry is written as a host or as another entry's name.Флаги aggrega registry remove
| Флаг | По умолчанию | Описание |
|---|---|---|
--global | false | Удалить запись из глобальной конфигурации, общей для всех рабочих пространств. |
--workspace | false | Удалить запись из конфигурации рабочего пространства этого проекта вместо глобальной конфигурации. |
Описание aggrega registry update
Walk each configured registry's repositories, read the latest published versionof each, and write a deterministic local searchable index to the artifact cache.
With no argument, every configured registry is indexed. With a single registryargument (a host or a friendly alias), only that registry is indexed.
This is the one registry command that reaches the network. The index it writeslands in this workspace's own artifact cache, so refreshing it changes nothinganother project on this machine resolves through. Credentials are read from asupplied or ambient source and never asked for: a registry that needs one you donot have fails with a message naming what it wanted.
For each repository the highest strict-SemVer version is selected (pre-releaseversions are skipped) and its catalog facets — kind, description, category,labels, and, for plugins, socket type and capabilities — are recorded from thepublished manifest. A repository with no conforming version is skipped; arepository that cannot be read is skipped with a note, so one unreadablerepository does not abandon the whole index.
A registry that asks the walk to slow down — a 429 answer, or a 503 that sayshow long to wait (Retry-After) — is left alone for as long as it asks, or tenseconds where it does not say, and the walk reads fewer of its repositories atonce until it answers again, then returns to its usual pace; on a terminal thewait 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 beforethe 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 connectionreset or timed out, an answer cut short — is asked again a few times, with agrowing wait between attempts. A repository with a read stillfailing after that is not recorded from this run: it keeps the record the indexalready holds for it, where that record was judged under the trust policy now inforce, and is otherwise left out of the index; either way it is named as arepository that could not be read, as the walk goes and again in the closingsummary under its registry's row, with the kind of the read's last failure — thestatus the registry answered, a timeout, a reset, an answer cut short — and theread 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 readswere asked again, whether or not they then succeeded — a read sent again afterthe registry asked the walk to slow down among them — and says zero when nonewas.
Every signature a registry's walk verifies against the public Sigstore trust rootis verified against the same copy of that root, fetched once for the walk ratherthan once per signature; a registry whose trust policy pins a trust root of itsown is verified against that file.
A registry whose repository listing repeats itself — naming a repository it hasalready named, or answering two pages in a row with no repository while stillpointing to a next page — is not followed round again. That registry is reportedas not indexed, with a message naming it and saying its repository listingrepeated itself; the other registries are still indexed, and the command exitsnon-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 repeateditself, or that was being walked when the command was interrupted. Registriesindexed earlier in the same run keep what this run wrote for them. A registry'snew index is written aside and put in place whole, so a command stopped whilewriting one leaves that registry with a complete index — the one it had beforethe run, or the new one — or with none, never with a partial one.
Every strict-SemVer version a recorded repository publishes is listed too, eachwith the manifest digest its tag resolves to — the address of the exact bytespublished under that version. Where the registry's trust policy pins a public keyor trusted identities, and verification is not switched off, each version's ownsignatures are verified against that policy and the signer is recorded when oneverifies; a version with no signature, or none that verifies, is recorded with nosigner. Where several verify, the signer recorded is the one the transparency logrecorded earliest, whatever order the registry lists them in, so signing a versionagain never changes its recorded signer.
Each version's publication date is recorded too, with its source. Where one of theversion's keyless signatures verified, the date is the time the transparency logrecorded that earliest signature, as the verified log entry attests it (source'transparency-log') — so signing a version again never moves its date. Otherwiseit is the date the publication itself stated beside what it published (source'publisher'), the earliest where several are stated: the publishing machine's ownclock, which nothing attests, read from any registry whatever its trust policy.A version with neither — published without stating a date, and not signedkeyless 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 eachrecord's 'published' field.
The per-repository records are byte-identical across two runs against the sameregistry state; the freshness timestamp is written to a sibling file so it neverdisturbs the records.
A refresh reads again only what changed, and finds every change a full re-readwould. For each repository it revalidates the tag listing with a conditionalrequest, resolves every version's tag to its manifest digest, and revalidates everyversion's attachments — its signatures, publication-date statements and deprecationmarkers — with one conditional request, plus one for the signatures of adeprecation marker it judged before. A version whose digest or attachments changedis read again in full, and its signatures and markers are verified again exactly asa full re-read verifies them; everything else is kept as recorded. A change to thisregistry's trust policy reads every version again under the policy now in force, andso does a repository whose entry in the index records none of these checks. Anunchanged registry therefore costs one conditional request per repository and twosmall requests per version (three where a deprecation marker was judged), withnothing downloaded. A version is read again on the next refresh where it carries adeprecation marker that was not honored, or where this run got no way torevalidate its attachments — which, on a registry that offers none, is everyversion.
Several repositories are read at a time. Everything the command records and printscomes out in repository order, so the index and the output are the same as readingone repository at a time would produce.
While it walks, a terminal shows the walk's progress on standard error, the waybuild and pull show theirs: a row naming each registry, a spinner while thatregistry's repository listing is read, then how many of its repositories the walkhas finished out of how many it lists, counted in repository order, and a bar forthe 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 aterminal, no progress is shown. The progress changes nothing the command prints onstandard output.
Use --upgrade to read every repository in full, comparing nothing with the indexalready written — to rebuild an index from the registry alone. It finds no change arefresh without it would miss.
Each published version's deprecation markers are read as the walk goes, and the oneswhose own signature verifies are recorded into the index. Every marker read isreported, whether or not it was recorded — a version kept as recorded is not read, soits marker is not reported again — and each registry reports how many markers itsindex now records, including when that number is zero. Where signatureverification is disabled for a registry, the walk reports that its markers were notexamined rather than a count, so a registry that published nothing is never confusedwith one this run had no basis to judge.Флаги aggrega registry update
| Флаг | По умолчанию | Описание |
|---|---|---|
--upgrade | false | Читает каждый репозиторий полностью, ничего не сравнивая с уже записанным индексом (обновление без этого флага и так перечитывает всё, что изменилось) |
Что registry update сообщает о маркерах устаревания
Обходя реестр, aggrega registry update читает маркеры устаревания каждой опубликованной версии
и записывает в локальный индекс те из них, подлинность которых может подтвердить.
Результат этого сканирования сообщается на любом пути выполнения, поэтому реестр, не опубликовавший
ни одного маркера, можно отличить от запуска, который их не искал.
Каждый маркер, прочитанный при обходе, порождает одну строку с именем репозитория, версией и уровнем серьёзности, записанным издателем, — warning, error или retracted, — а также сведением о том, был ли маркер записан. Версия, вложения которой не изменились с последнего обновления, сохраняется в записанном виде, а не читается заново, поэтому её маркер повторно не сообщается; приведённое ниже число по-прежнему её учитывает. Маркер записывается, только если его собственная подпись проходит проверку относительно подписантов, признаваемых политикой доверия реестра. Маркер, который присутствует, но не декодируется, или присутствует, но не признаётся, сообщается как таковой и не попадает в индекс, а не записывается на основании данных, подлинность которых не удалось подтвердить, — как и маркер, о котором реестр отвечает, что не хранит его. Маркер, чтение которого не удалось, — другой случай: см. Чтение, которое не удалось.
Затем для каждого реестра сообщается, сколько маркеров теперь записано в его индексе, в том числе когда это число равно нулю. Если проверка подписей отключена — глобально или для этого конкретного реестра, — вместо этого при обходе сообщается, что маркеры для него не проверялись. Это разные факты: первый означает, что реестр не опубликовал ничего, на что это рабочее пространство может опереться, второй — что у этого запуска вообще не было основы доверия, чтобы оценить маркер. Реестр, маркеры которого не проверялись, не исключает никаких версий при выборе версии, поэтому автор, прикрепивший маркер и увидевший эту строку, понимает, почему маркер не действует.
Дата публикации, которую записывает каждая версия
Время создания опубликованного манифеста зафиксировано, поэтому его дайджест зависит только от того, что опубликовано, и никогда — от того, когда. Поэтому дата публикации версии считывается рядом
с манифестом, и aggrega registry update записывает её для каждой версии вместе с источником, из которого
она получена:
transparency-log— если подпись версии бесключевая и проходит проверку по политике доверия реестра, это время, когда журнал прозрачности записал эту подпись, что удостоверяет подписанное обещание журнала. Если проверку проходят несколько подписей версии, берётся самое раннее из их времён, и подписантом версии записывается подписант той же самой подписи — в каком бы порядке реестр ни перечислял подписи, — поэтому повторно подписанная версия сохраняет свою дату и своего подписанта. Для версии, подписанной при публикации, это время её публикации; для версии, впервые подписанной позже с помощьюaggrega sign, — время подписания. Этот источник имеет приоритет везде, где он есть.publisher— в противном случае время, указанное публикацией рядом с опубликованным: небольшое вложение с временем публикации, которое записывают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 изменяют или читают локальную конфигурацию, и автономный режим на них не влияет.