aggrega registry
Gestionar los registries y su política de confianza de firmas
Sinopsis
aggrega registryDescripción
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.Subcomandos
| Comando | Descripción |
|---|---|
aggrega registry add | Registrar un registry y su política de confianza de firmas |
aggrega registry list | Enumerar los registries configurados y su postura de confianza |
aggrega registry remove | Eliminar un registry y su política de confianza de un archivo de configuración |
aggrega registry update | Construir el índice local consultable de los registries configurados |
Descripción de 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.Flags de aggrega registry add
| Flag | Predeterminado | Descripción |
|---|---|---|
--advisory | false | Rebajar los fallos de verificación de este registry a advertencias en lugar de detenerse |
--fetch-trust | true | Descargar y fijar la política de confianza anunciada por el registry en el primer uso. Usa —fetch-trust=false para omitirlo; —identity/—key manuales también omiten la descarga. |
--global | false | Escribir la entrada en la configuración global compartida por todos los workspaces. Un registry se escribe aquí de forma predeterminada. |
--identity | [] | Identidad keyless de confianza como identity=issuer, por ejemplo dev@example.com=https://accounts.google.com (repetible; conjunto OR). Sobrescribe la política de confianza descargada. |
--key | — | Ruta a un PEM de clave pública fijada y compatible con cosign para la verificación keyed. Sobrescribe la política de confianza descargada. |
--name | — | Alias descriptivo opcional para este registry. El host sigue siendo la identidad; el alias se resuelve en él dondequiera que se nombre un registry (p. ej., —registry). Debe ser único entre los registries. |
--require-signatures | false | Exigir una firma en cada artefacto descargado de (y subido a) este registry |
--trusted-root | — | Ruta a un bundle de raíz de confianza de Sigstore fijado para la verificación keyless en entornos aislados (air-gapped) |
--workspace | false | Escribe la entrada en la configuración del workspace de este proyecto en lugar de en la configuración global. |
Descripción de 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.Flags de aggrega registry list
| Flag | Predeterminado | Descripción |
|---|---|---|
--output, -o | table | Formato de salida: table|json. |
Descripción de 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.Flags de aggrega registry remove
| Flag | Predeterminado | Descripción |
|---|---|---|
--global | false | Eliminar la entrada de la configuración global compartida por todos los workspaces. |
--workspace | false | Eliminar la entrada de la configuración del workspace de este proyecto en lugar de la configuración global. |
Descripción de 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.Flags de aggrega registry update
| Flag | Predeterminado | Descripción |
|---|---|---|
--upgrade | false | Lee cada repositorio completo, sin comparar nada con el índice ya escrito (una actualización sin esta opción ya vuelve a leer todo lo que cambió) |
Qué informa registry update sobre los marcadores de obsolescencia
Mientras recorre un registry, aggrega registry update lee los marcadores de obsolescencia de cada versión publicada y registra en el índice local los que puede autenticar. Informa del resultado de ese examen en todos los casos, de modo que un registry que no publicó ningún marcador se distingue de una ejecución que no buscó ninguno.
Cada marcador que lee el recorrido produce una línea que nombra el repositorio, la versión y la gravedad que registró el publicador — warning, error o retracted — junto con si el marcador se registró. Una versión cuyos adjuntos no han cambiado desde la última actualización se conserva tal como está registrada en lugar de leerse, por lo que su marcador no se vuelve a informar; el recuento de abajo la sigue incluyendo. Un marcador solo se registra cuando su propia firma se verifica frente a los firmantes que acepta la política de confianza del registro. Uno que está presente pero no se decodifica, o presente pero no aceptado, se informa como tal y se deja fuera del índice en lugar de registrarse con pruebas que no se pudieron autenticar — y lo mismo ocurre con uno que el registro responde que no tiene. Un marcador cuya lectura falló es un caso distinto: consulta Una lectura que falla.
A continuación, cada registry informa de cuántos marcadores registra ahora su índice, incluso cuando ese número es cero. Donde la verificación de firmas está desactivada —globalmente o para ese único registry—, el recorrido informa en su lugar de que no se examinaron marcadores para él. Son dos hechos distintos: el primero dice que el registry no publicó nada sobre lo que este workspace pueda actuar; el segundo dice que esta ejecución no tenía ninguna base de confianza con la que juzgar un marcador. Un registry cuyos marcadores no se examinaron no aporta ninguna retirada a la selección de versiones, de modo que un autor que adjuntó un marcador y ve esa línea sabe por qué no tiene efecto.
La fecha de publicación que registra cada versión
La hora de creación de un manifest publicado está fijada, de modo que su digest depende solo de lo que se publica y nunca de cuándo. Por lo tanto, la fecha en que se publicó una versión se lee junto al manifest, y aggrega registry update la registra para cada versión con la fuente de la que procede:
transparency-log: donde la firma de la versión es keyless y se verifica frente a la política de confianza del registry, el momento en que el registro de transparencia registró esa firma, del que da fe la promesa firmada del registro. Donde se verifican varias firmas de la versión, es el más temprano de sus momentos, y el firmante registrado para la versión es el de esa misma firma —sea cual sea el orden en que el registry enumere las firmas—, de modo que una versión firmada de nuevo conserva su fecha y su firmante. Para una versión firmada al publicarse, esa es su publicación; para una firmada por primera vez después conaggrega sign, es el momento en que se firmó. Esta fuente prevalece dondequiera que exista.publisher: en caso contrario, el momento que la publicación declaró junto a lo que publicó: un pequeño adjunto published-at queaggrega pushyaggrega push-artifactescriben con el propio reloj de la máquina que publica, del que nada da fe. Se lee de cualquier registry sea cual sea su política de confianza, porque es la declaración del publicador y no una decisión de confianza. Donde hay varios adjuntos, se toma el más temprano.
Una versión sin ninguno de los dos no registra ninguna fecha. Se trata de una publicación que no declaró ninguna y cuya firma no es una keyless que esta política verifique; por ejemplo, una publicación keyless leída bajo una política que no confía en ninguna identidad keyless, ya que una publicación keyless no declara ninguna fecha propia. aggrega search -o json indica la fecha bajo cada versión en published.
Qué vuelve a leer una actualización
Una actualización compara lo que el registro sirve ahora con lo que registró el índice, y vuelve a leer todo lo que cambió — la misma respuesta que da una relectura completa. Para cada repositorio:
- revalida el listado de tags, de modo que se detecta una versión publicada o eliminada desde entonces;
- resuelve el tag de cada versión al manifest que nombra, de modo que una versión anterior publicada de nuevo con su tag existente se vuelve a leer;
- revalida los adjuntos de cada versión — sus firmas, sus declaraciones de fecha de publicación y sus marcadores de obsolescencia — de modo que una firma, una fecha o un marcador adjuntado a una versión desde entonces se lee y se verifica, y hace lo mismo con las firmas de un marcador de obsolescencia que ya evaluó;
- compara la política de confianza del registro con aquella con la que se construyó el índice, de modo que un cambio en la política hace que cada versión se vuelva a leer con la nueva.
Un marcador de obsolescencia, una firma y una fecha de publicación se adjuntan cada uno a una versión publicada como un objeto independiente que apunta a ella —que es lo que permite a un publicador marcar como obsoleta o firmar una versión sin volver a publicarla—, de modo que ninguno de ellos añade un tag ni cambia el propio manifest de la versión. Cambian los adjuntos de la versión, y eso es lo que revalida la tercera comprobación. La exclusión de versiones y aggrega inspect leen ambos este índice, de modo que una versión retirada desde la última actualización se excluye de la selección, y se muestra, una vez que se ha ejecutado la siguiente actualización.
Cada comprobación es una petición pequeña — la resolución del digest de un manifest, o una petición condicional que el registro responde como sin cambios sin enviar nada — de modo que la actualización de un registro sin cambios no descarga nada. Una versión que lleva un marcador de obsolescencia que no fue aceptado, o cuyos adjuntos esta ejecución no tuvo forma de revalidar, se vuelve a leer en la siguiente actualización. Un registro que no puede decir si los adjuntos de una versión cambiaron hace que cada versión se vuelva a leer en cada actualización: la respuesta es la misma, y también el coste de una relectura completa.
--upgrade lee cada repositorio completo, sin comparar nada con el índice ya escrito. Úsalo para reconstruir un índice solo a partir del registro; no detecta nada que una actualización pase por alto.
Un registro que pide ir más despacio
El hub oficial, hub.aggrega.ai, limita cuántas solicitudes pueden llegar desde una misma dirección en un intervalo breve, de modo que las máquinas que comparten una dirección comparten ese cupo, y cualquier registro puede limitar a sus clientes de la misma manera. Un registro que ha superado su límite responde 429 Too Many Requests, o 503 Service Unavailable con una cabecera Retry-After que indica cuánto esperar. Cada solicitud que la línea de comandos hace a un registro, sea cual sea el comando, reacciona ante esa respuesta de la misma manera: espera lo que el registro pidió, o diez segundos cuando la respuesta no lo indica, más hasta un segundo adicional al azar, y luego vuelve a pedir, sin un número fijo de intentos. Cada solicitud a ese registro espera con ella, no solo la rechazada, y se le envían menos a la vez —la mitad cada vez que lo pide, hasta llegar a una—, número que vuelve a subir de uno en uno tras cada serie de solicitudes que atiende sin fallar, hasta el número habitual del comando. La espera se muestra en las mismas condiciones que el resto del progreso del comando, como una línea del tipo hub.aggrega.ai asked to slow down; waiting 11 s: aggrega build, aggrega pull y aggrega registry update la muestran junto al paso en curso, los demás comandos que muestran lo que esperan la muestran como un paso propio —salvo aggrega sign --jobs firmando varias referencias a la vez, que muestra esas esperas como un solo paso— y no se muestra nada cuando la salida de error estándar no es un terminal, a menos que el --progress del comando lo pida. Un registro que durante cinco minutos no responde otra cosa que «más despacio» se rechaza con E0378, indicando el registro, su última respuesta y cuánto tiempo llevaba sin responder otra cosa; los cinco minutos son fijos y ningún ajuste los cambia. aggrega registry update nombra entonces ese registro bajo Not indexed: en su resumen final, y el registro conserva el índice que tenía antes de la ejecución.
Una lectura que falla
Un recorrido lee muchos objetos pequeños de un registro, y algunas lecturas fallan de forma puntual: el registro responde que ha fallado o que no está disponible (un estado 5xx, salvo un 503 que indique cuánto esperar) o que la solicitud agotó el tiempo de espera (un 408), la conexión se restablece o agota el tiempo de espera, o una respuesta se corta antes de estar completa. Cada una de esas lecturas se vuelve a pedir unas cuantas veces, con una espera creciente entre intentos. Un registro que pide al recorrido ir más despacio no está haciendo fallar una lectura: la lectura espera y se vuelve a pedir como describe Un registro que pide ir más despacio, y un registro que sigue pidiéndolo durante cinco minutos termina el recorrido de ese registro y no el de un solo repositorio.
Una lectura que sigue fallando nunca se toma como respuesta. Una firma que no se pudo leer no es una versión sin firma, y un marcador de obsolescencia que no se pudo leer no es una versión que nunca se retiró, así que el recorrido no registra nada sobre ese repositorio en esta ejecución. El repositorio conserva la entrada que el índice ya tiene para él, cuando esa entrada se evaluó con la política de confianza del registro ahora vigente, y en caso contrario se deja fuera del índice. En ambos casos el recorrido nombra el repositorio en su comentario sobre la marcha, diciendo cuál de los dos casos ocurrió y qué lectura falló, y lo vuelve a nombrar en su resumen final, en una línea propia bajo la fila de su registro, entre los repositorios que no se pudieron leer:
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: …La fila del registro también indica cuántas lecturas se volvieron a pedir, contando cada lectura una sola vez, independientemente de cuántos intentos le llevara y de si después tuvo éxito o no, e indica 0 reads retried cuando no se volvió a pedir ninguna. Un recorrido cuyas lecturas acabaron teniendo éxito todas no muestra ningún repositorio en su fila, así que este recuento es lo que indica lo cerca que estuvo de dejar uno fuera.
Cada una de esas líneas empieza por el tipo del último fallo de la lectura — el estado con el que respondió el registro, una lectura que agotó el tiempo de espera, una conexión que se restableció o una respuesta cortada — seguido del propio fallo, que dice qué lectura era. Un fallo que no es de ninguno de esos tipos, como una raíz de confianza que no se pudo obtener para verificar una firma con ella, se da solo como el fallo. El método aggrega/registryUpdate de aggrega serve responde con los mismos repositorios bajo skipped de cada host, cada uno con el mismo reason, y con el recuento de lecturas que se volvieron a pedir como readsRetried. Lo mismo vale para una actualización y para --upgrade, y el siguiente recorrido parte de lo que el índice tenga entonces, como ocurre con cualquier repositorio.
La clave pública que fija una política keyed
Una política de confianza keyed fija inline la clave pública del registry, como public_key de la entrada: aggrega registry add --key <file> copia allí el contenido del archivo, y lo mismo hace fijar una política que el registry anuncia con una clave incluida. El valor es un bloque PEM de clave pública —el texto desde una línea -----BEGIN PUBLIC KEY-----, o -----BEGIN RSA PUBLIC KEY-----, hasta su línea -----END correspondiente—, y cualquier texto por encima del bloque se ignora.
Un valor que no contiene ninguna línea -----BEGIN … PUBLIC KEY----- se rechaza al cargar el archivo de configuración, nombrando el archivo y la entrada. registry add hace la misma comprobación antes de escribir, de modo que un archivo --key que contiene cualquier otra cosa —una clave privada, un certificado o una clave en otra codificación— se rechaza y el archivo de configuración queda como estaba. Solo se comprueba esa línea: si el bloque se decodifica en una clave utilizable se descubre cuando se verifica frente a él una firma del registry.
Sin conexión
aggrega registry update es el único comando de este grupo cuyo trabajo entero es un recorrido de los registries, y en modo sin conexión —la clave de nivel superior offline en un archivo de configuración, AGGREGA_OFFLINE o --offline— lo rechaza antes de recorrer nada. El rechazo nombra cuál de las tres fuentes estableció el modo.
No existe ninguna forma parcial a la que recurrir, porque el índice registra lo que cada registry sirve actualmente y eso no se puede saber sin preguntar a uno. Lo que un workspace sin conexión sí puede hacer es leer el índice que ya tiene: aggrega search y el aviso de obsolescencia de aggrega inspect leen ambos la instantánea local y no necesitan red alguna, de modo que una actualización es lo único que el modo quita. Para actualizar en una ejecución desde un workspace sin conexión, pasa --offline=false.
aggrega registry add accede a la red una sola vez, para la política de confianza que anuncia el registry, a menos que --fetch-trust=false, --identity o --key indiquen que no se descargue. En modo sin conexión esa descarga se rechaza antes de establecer ninguna conexión, de modo que nunca se pregunta al registry. Añadir un registry distinto del hub oficial se rechaza entonces: añadir un registry es el único momento en que se fija su confianza, y una entrada escrita sin la política no confiaría en nada mientras cada pull posterior sometería el registry a ella. El rechazo lleva el código corto E0310 y nombra las dos opciones para continuar: registrarlo una vez con conexión, lo que --offline=false permite para una ejecución, o fijar la política a mano con --identity o --key, lo que registra exactamente lo que proporcionas y no hace ninguna descarga. El hub oficial se añade con su línea base integrada, con un aviso que indica que no se pidió al hub su política de confianza porque el workspace está sin conexión y que en su lugar se usa la línea base, y --fetch-trust=false registra la entrada a partir de sus flags exactamente igual que con conexión. El mismo registro hecho a través de aggrega serve o aggrega mcp se comporta igual: el mismo rechazo con las mismas palabras y, por lo demás, la misma entrada. A registry is added offline with no trust policy to pin (Se añade un registry sin conexión sin ninguna política de confianza que fijar) cita el rechazo.
list y remove modifican o leen la configuración local y no se ven afectados.