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 | [] | 信頼するキーレス ID を identity=issuer の形式で指定します。例: dev@example.com=https://accounts.google.com (繰り返し指定可能、OR 集合)。取得した信頼ポリシーを上書きします。 |
--key | — | キー付き検証用に固定する、cosign 互換の公開鍵 PEM へのパスです。取得した信頼ポリシーを上書きします。 |
--name | — | このレジストリの任意の別名です。ID はホストのままで、レジストリを指定するあらゆる箇所(例:—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 は、レジストリを走査する間に、公開された各バージョンの
非推奨マーカーを読み取り、認証できたものをローカルインデックスに記録します。
このスキャンの結果はどの経路でも報告されるため、マーカーを 1 つも公開していないレジストリと、
マーカーを探さなかった実行とを区別できます。
走査で読み取った各マーカーは、リポジトリ、バージョン、公開者が記録した重大度(warning、error、retracted)と、そのマーカーが記録されたかどうかを示す 1 行を出力します。前回の更新以降に添付物が変化していないバージョンは、読み取られずに記録どおり保持されるため、そのマーカーが再び報告されることはありません。ただし、後述の件数には引き続き含まれます。マーカーが記録されるのは、そのマーカー自身の署名が、レジストリの信頼ポリシーが認める署名者に対して検証された場合に限られます。存在するがデコードできないマーカーや、存在するが認められないマーカーは、その旨が報告され、認証できなかった根拠に基づいて記録されることなく、インデックスから除外されます。レジストリが保持していないと応答するマーカーも同様です。読み取りに失敗したマーカーは別のケースです。失敗した読み取りを参照してください。
その後、各レジストリは、そのインデックスが現在記録しているマーカーの数を報告します。その数が 0 の場合も 報告されます。署名検証が無効になっている場合(グローバルに、または その 1 つのレジストリに対して)、走査はその代わりに、そのレジストリのマーカーは検査されなかったと報告します。 この 2 つは異なる事実です。前者は、このワークスペースが対処できるものをレジストリが何も公開していないことを示し、 後者は、この実行にはマーカーを判断するための信頼の根拠がまったくなかったことを示します。 マーカーが検査されなかったレジストリは、バージョン選択に対して取り下げを一切もたらしません。そのため、 マーカーを付与した作成者がその行を見れば、それが効果を持たない理由がわかります。
各バージョンが記録する公開日
公開されたマニフェストの作成時刻は固定されているため、そのダイジェストは何が公開されたかだけに依存し、いつ公開されたかには依存しません。そのため、バージョンが公開された日付はマニフェストの横から読み取られ、aggrega registry update は各バージョンについてその日付を取得元とともに記録します。
transparency-log— バージョンの署名がキーレスで、レジストリのトラストポリシーに対して検証される場合、透明性ログがその署名を記録した時刻です。これはログの署名付きの約束によって証明されます。バージョンの署名が複数検証される場合は、それらの時刻のうち最も早いものとなり、バージョンについて記録される署名者もその同じ署名のものとなります。これはレジストリが署名をどの順序で列挙していても変わらないため、 再度署名されたバージョンも日付と署名者を保持します。公開と同時に署名されたバージョンでは、これがその公開時刻です。公開後にaggrega signで初めて署名されたバージョンでは、署名された時刻です。 この取得元が存在する場合は、常にこちらが優先されます。publisher— それ以外の場合は、公開物が公開内容の横に記載した時刻です。これはaggrega pushとaggrega push-artifactが書き込む小さな published-at アタッチメントで、公開したマシン自身の時計の値を持ち、何によっても証明されません。これはトラストの判断ではなく公開者の申告であるため、トラストポリシーにかかわらずどのレジストリからも読み取られます。複数添付されている場合は、最も早いものが採用されます。
どちらも持たないバージョンは日付を記録しません。これは日付を記載しておらず、かつその署名がこのポリシーで検証されるキーレス署名ではない公開物です。たとえば、キーレスの ID を一切信頼しないポリシーのもとで読み取られたキーレスの公開物がこれに当たります。キーレスの公開物は自身の日付を記載しないためです。aggrega search -o json は、各バージョンの日付を published に報告します。
更新で再び読み取られるもの
更新は、レジストリが現在提供しているものとインデックスが記録したものを比較し、変化したものをすべて読み直します。その結果は、完全な読み直しで得られるものと同じです。各リポジトリについて、更新は次のことを行います:
- タグの一覧を再検証し、その後に公開または削除されたバージョンを取り込みます。
- 各バージョンのタグを、それが指すマニフェストに解決します。これにより、既存のタグで再度公開された古いバージョンが読み直されます。
- 各バージョンの添付物(署名、公開日の記述、非推奨マーカー)を再検証します。これにより、その後にバージョンに添付された署名、日付、マーカーが読み取られて検証されます。また、以前に判定した非推奨マーカーの署名についても同じことを行います。
- レジストリの信頼ポリシーを、インデックスが構築されたときのポリシーと比較します。これにより、ポリシーが変更されると、すべてのバージョンが新しいポリシーのもとで読み直されます。
非推奨マーカー、署名、公開日は、それぞれ公開済みバージョンを指し返す別個のオブジェクトとしてバージョンに添付されます。これこそが、公開者がバージョンを再公開せずに非推奨にしたり署名したりできる仕組みです。そのため、いずれもタグを追加せず、バージョン自体のマニフェストも変えません。これらが変えるのはバージョンの添付物であり、それを再検証するのが 3 つ目のチェックです。バージョンの除外と aggrega inspect はどちらもこのインデックスを読むため、前回の更新以降に撤回されたバージョンは、次の更新が実行されると選択から除外され、表示されるようになります。
各チェックは小さなリクエストです。マニフェストのダイジェストの解決か、レジストリが何も送らずに変更なしと応答する条件付きリクエストです。そのため、変化していないレジストリの更新では何もダウンロードされません。認められなかった非推奨マーカーを持つバージョンや、今回の実行でその添付物を再検証する手段がなかったバージョンは、次の更新で読み直されます。バージョンの添付物が変化したかどうかを示せないレジストリでは、更新のたびにすべてのバージョンが読み直されます。結果は同じであり、コストも完全な読み直しと同じです。
--upgrade は、すでに書き込まれたインデックスと何も比較せずに、すべてのリポジトリを完全に読み込みます。レジストリだけからインデックスを再構築する場合に使用します。更新で見落とされるものを、これで新たに拾えるわけではありません。
速度を落とすよう求めるレジストリ
公式ハブ hub.aggrega.ai は、1 つのアドレスから短時間に送られるリクエストの数を制限しているため、アドレスを共有するマシンはその許容量を共有します。また、どのレジストリも同じ方法でクライアントを制限できます。上限を超えたレジストリは 429 Too Many Requests、または待つべき時間を示す Retry-After ヘッダー付きの 503 Service Unavailable を返します。コマンドラインがレジストリに送るすべてのリクエストは、コマンドを問わず、この応答に同じ方法で対応します。レジストリが求めた時間 (応答に示されていない場合は 10 秒) に、ランダムに最大 1 秒を加えた時間だけ待機してから再度リクエストし、試行回数に上限はありません。拒否されたリクエストだけでなく、そのレジストリへのすべてのリクエストが一緒に待機し、同時に送られるリクエストの数も減ります。求められるたびに半分になって最小 1 つまで減り、失敗なく処理された一連のリクエストのたびに 1 つずつ増えて、コマンドの通常の数まで戻ります。待機はコマンドのほかの進捗と同じ条件で、hub.aggrega.ai asked to slow down; waiting 11 s のような行として表示されます。aggrega build、aggrega pull、aggrega registry update は進行中のステップの横に表示し、待機対象を表示するほかのコマンドは独立したステップとして表示します。ただし、複数の参照を同時に署名する aggrega sign --jobs は、それらの待機を 1 つのステップとして表示します。標準エラーが端末でない場合は、コマンドの --progress が求めない限り何も表示されません。5 分間「速度を落として」以外に何も応答しないレジストリは E0378 で拒否され、そのレジストリ、最後の応答、およびそれ以外の応答がなかった時間が示されます。5 分という時間は固定されており、変更する設定はありません。その場合 aggrega registry update は終了時の要約で Not indexed: の下にそのレジストリを示し、そのレジストリには実行前のインデックスが保持されます。
失敗した読み取り
走査はレジストリから多数の小さなオブジェクトを読み取り、その一部は一時的に失敗します。レジストリが失敗したまたは利用不可と応答する(待つべき時間を示す 503 を除く 5xx ステータス)、リクエストがタイムアウトしたと応答する(408)、接続がリセットされるかタイムアウトする、あるいは応答が完了する前に途切れる、といった場合です。そのような読み取りはそれぞれ数回再試行され、試行の間の待ち時間は次第に長くなります。走査に速度を落とすよう求めるレジストリは、読み取りを失敗させているわけではありません。読み取りは速度を落とすよう求めるレジストリで説明するとおりに待機して再試行され、5 分間求め続けるレジストリは、1 つのリポジトリの走査ではなく、そのレジストリの走査を終了させます。
それでも失敗した読み取りが応答として扱われることはありません。読み取れなかった署名は署名のないバージョンを意味せず、読み取れなかった非推奨マーカーは一度も取り下げられていないバージョンを意味しません。そのため、走査は今回の実行からそのリポジトリについて何も記録しません。インデックスがそのリポジトリについてすでに保持している記録が、現在有効なレジストリの信頼ポリシーのもとで判定されたものであれば、リポジトリはその記録を保持し、そうでなければインデックスから除外されます。いずれの場合も、走査は進行中の出力でそのリポジトリを示し、2 つのうちどちらが起きたか、どの読み取りが失敗したかを述べ、最後の要約でも、レジストリの行の下に独立した 1 行として、読み取れなかったリポジトリの中で再び示します:
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: …レジストリの行には、再試行された読み取りの数も示されます。各読み取りは、何回試行したか、その後成功したかどうかにかかわらず 1 回として数えられ、再試行がなかった場合は 0 reads retried と示されます。最終的にすべての読み取りが成功した走査では、その行にリポジトリは表示されないため、どれだけリポジトリを除外する寸前だったかを示すのはこの件数です。
そのような各行は、その読み取りの最後の失敗の種類(レジストリが応答したステータス、タイムアウトした読み取り、リセットされた接続、途中で切れた応答)で始まり、その後に失敗そのものが続き、それがどの読み取りだったかを示します。これらのどの種類にも当てはまらない失敗、たとえば署名の検証に使う信頼ルートを取得できなかった場合などは、失敗のみが示されます。aggrega serve の aggrega/registryUpdate メソッドは、各ホストの 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)のもとでは、何かを巡回する前に拒否します。
この拒否は、3 つのうちどれが態勢を設定したかを示します。
代わりに使える部分的な形式はありません。インデックスは各レジストリが現在提供しているものを記録しており、それはレジストリに問い合わせずに知ることはできないからです。オフラインのワークスペースができるのは、すでに持っているインデックスを読むことです。aggrega search と
aggrega inspect の非推奨通知はどちらもローカルのスナップショットを読み、ネットワークをまったく必要としないため、この態勢によって失われるのは更新だけです。オフラインのワークスペースから 1 回の実行だけ更新するには、
--offline=false を渡します。
aggrega registry add は、--fetch-trust=false、--identity、または --key が取得しないよう指示しない限り、レジストリが公開するトラストポリシーのためにネットワークに 1 回アクセスします。オフライン態勢のもとでは、その取得は接続を試みる前に拒否されるため、レジストリに問い合わせることはありません。その場合、公式ハブ以外のレジストリの追加は拒否されます。レジストリの追加はそのトラストが固定される唯一の時点であり、ポリシーなしで書き込まれたエントリは何も信頼しない一方で、以降のすべての pull はレジストリにそのエントリを適用することになるからです。この拒否には短いコード E0310 が付き、次の 2 つの対処方法を示します。オンラインの状態で一度登録するか(--offline=false で 1 回の実行に限りそれが可能です)、--identity または --key で手動でポリシーを固定するかです。後者は指定した内容をそのまま登録し、取得をまったく行いません。公式ハブは組み込みのベースラインで追加され、ワークスペースがオフラインであるためハブにトラストポリシーを問い合わせず、代わりにベースラインを使用したことを示す通知が表示されます。また、--fetch-trust=false はオンライン時とまったく同じようにフラグからエントリを登録します。aggrega serve や aggrega mcp を通じて行う同じ登録も同様に動作します。同じ文言の同じ拒否となり、それ以外の場合は同じエントリになります。A registry is added offline with no trust policy to pin(オフラインでレジストリが追加され、固定するトラストポリシーがありません) にこの拒否の文言が引用されています。
list と remove はローカルの設定を変更または読み取るだけなので、影響を受けません。