コンテンツにスキップ
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[]信頼するキーレス ID を identity=issuer の形式で指定します。例: dev@example.com=https://accounts.google.com (繰り返し指定可能、OR 集合)。取得した信頼ポリシーを上書きします。
--key—キー付き検証用に固定する、cosign 互換の公開鍵 PEM へのパスです。取得した信頼ポリシーを上書きします。
--name—このレジストリの任意の別名です。ID はホストのままで、レジストリを指定するあらゆる箇所(例:—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 は、レジストリを走査する間に、公開された各バージョンの 非推奨マーカーを読み取り、認証できたものをローカルインデックスに記録します。 このスキャンの結果はどの経路でも報告されるため、マーカーを 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 はローカルの設定を変更または読み取るだけなので、影響を受けません。