aggrega registry
Quản lý các registry và chính sách tin cậy chữ ký của chúng
Cú pháp
aggrega registryMô tả
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.Lệnh con
| Lệnh | Mô tả |
|---|---|
aggrega registry add | Đăng ký một registry và chính sách tin cậy chữ ký của nó |
aggrega registry list | Liệt kê các registry đã cấu hình và trạng thái tin cậy của chúng |
aggrega registry remove | Xóa một registry và chính sách tin cậy của nó khỏi tệp cấu hình |
aggrega registry update | Xây dựng chỉ mục cục bộ có thể tìm kiếm của các registry đã cấu hình |
Mô tả 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.Các cờ của aggrega registry add
| Cờ | Mặc định | Mô tả |
|---|---|---|
--advisory | false | Hạ các lỗi xác minh của registry này xuống thành cảnh báo thay vì dừng lại |
--fetch-trust | true | Tải về và ghim chính sách tin cậy mà registry công bố ở lần sử dụng đầu tiên. Dùng —fetch-trust=false để bỏ qua; việc chỉ định thủ công —identity/—key cũng bỏ qua bước tải về. |
--global | false | Ghi mục vào cấu hình toàn cục dùng chung cho mọi workspace. Một registry mặc định được ghi vào đây. |
--identity | [] | Danh tính keyless được tin cậy dưới dạng identity=issuer, ví dụ dev@example.com=https://accounts.google.com (có thể lặp lại; tập hợp OR). Ghi đè chính sách tin cậy đã tải về. |
--key | — | Đường dẫn tới tệp PEM khóa công khai tương thích cosign đã ghim, dùng cho xác minh bằng khóa. Ghi đè chính sách tin cậy đã tải về. |
--name | — | Bí danh thân thiện tùy chọn cho registry này. Host vẫn là danh tính; bí danh được phân giải thành host ở mọi nơi một registry được nêu tên (ví dụ —registry). Phải là duy nhất giữa các registry. |
--require-signatures | false | Yêu cầu chữ ký trên mọi artifact được kéo từ (và đẩy lên) registry này |
--trusted-root | — | Đường dẫn tới bundle trust-root Sigstore đã ghim, dùng cho xác minh keyless trong môi trường air-gapped |
--workspace | false | Ghi mục vào cấu hình workspace của dự án này thay vì cấu hình toàn cục. |
Mô tả 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.Các cờ của aggrega registry list
| Cờ | Mặc định | Mô tả |
|---|---|---|
--output, -o | table | Định dạng đầu ra: table|json. |
Mô tả 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.Các cờ của aggrega registry remove
| Cờ | Mặc định | Mô tả |
|---|---|---|
--global | false | Xóa mục khỏi cấu hình toàn cục dùng chung cho mọi workspace. |
--workspace | false | Xóa mục khỏi cấu hình workspace của dự án này thay vì cấu hình toàn cục. |
Mô tả 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.Các cờ của aggrega registry update
| Cờ | Mặc định | Mô tả |
|---|---|---|
--upgrade | false | Đọc toàn bộ mọi kho lưu trữ, không so sánh gì với chỉ mục đã được ghi (một lần làm mới không có cờ này vốn đã đọc lại mọi thứ đã thay đổi) |
Những gì registry update báo cáo về các dấu đánh dấu ngừng hỗ trợ
Trong khi duyệt một registry, aggrega registry update đọc các dấu đánh dấu ngừng hỗ trợ của từng phiên bản đã phát hành
và ghi những dấu mà nó xác thực được vào chỉ mục cục bộ.
Nó báo cáo kết quả của lần quét đó trên mọi nhánh, nhờ vậy một registry không phát hành
dấu đánh dấu nào có thể phân biệt được với một lần chạy không tìm kiếm dấu đánh dấu.
Mỗi dấu đánh dấu mà lần duyệt đọc sẽ tạo ra một dòng nêu tên repository, phiên bản và mức độ nghiêm trọng mà bên phát hành đã ghi — warning, error hoặc retracted — cùng với việc dấu đánh dấu đó có được ghi lại hay không. Một phiên bản có các tệp đính kèm không thay đổi kể từ lần làm mới trước được giữ nguyên như đã ghi thay vì được đọc lại, nên dấu đánh dấu của nó không được báo cáo lại; số lượng bên dưới vẫn tính cả nó. Một dấu đánh dấu chỉ được ghi lại khi chữ ký của chính nó được xác minh khớp với các bên ký mà chính sách tin cậy của registry chấp nhận. Một dấu có mặt nhưng không giải mã được, hoặc có mặt nhưng không được chấp nhận, sẽ được báo cáo đúng như vậy và bị loại khỏi chỉ mục thay vì được ghi lại dựa trên bằng chứng không thể xác thực — và một dấu mà registry trả lời là nó không lưu giữ cũng vậy. Một dấu đánh dấu mà việc đọc thất bại là một trường hợp khác: xem Một lần đọc thất bại.
Sau đó, mỗi registry báo cáo chỉ mục của nó hiện ghi lại bao nhiêu dấu đánh dấu, kể cả khi con số đó bằng không. Khi việc xác minh chữ ký bị tắt — trên toàn cục, hoặc chỉ cho riêng registry đó — lần duyệt sẽ báo cáo rằng các dấu đánh dấu không được kiểm tra cho registry đó. Đây là hai sự thật khác nhau: trường hợp thứ nhất cho biết registry không phát hành gì mà workspace này có thể dựa vào, trường hợp thứ hai cho biết lần chạy này hoàn toàn không có cơ sở tin cậy nào để đánh giá một dấu đánh dấu. Một registry có các dấu đánh dấu không được kiểm tra sẽ không góp phần rút lại phiên bản nào trong việc chọn phiên bản, vì vậy một tác giả đã gắn một dấu đánh dấu và thấy dòng đó sẽ biết vì sao nó không có tác dụng.
Ngày xuất bản mà mỗi phiên bản ghi lại
Thời điểm tạo của một manifest đã xuất bản được cố định, nên digest của nó chỉ phụ thuộc vào nội dung được xuất bản chứ không bao giờ phụ thuộc vào thời điểm xuất bản. Vì vậy, ngày một phiên bản được xuất bản được đọc từ bên cạnh manifest, và aggrega registry update ghi lại ngày đó cho từng phiên bản cùng với nguồn mà nó lấy từ đó:
transparency-log— khi chữ ký của phiên bản là keyless và được xác minh theo chính sách tin cậy của registry, đây là thời điểm transparency log ghi nhận chữ ký đó, được chứng thực bởi lời cam kết có ký của log. Khi nhiều chữ ký của phiên bản cùng được xác minh, đó là thời điểm sớm nhất trong các thời điểm của chúng, và người ký được ghi cho phiên bản cũng là người ký của chính chữ ký đó — bất kể registry liệt kê các chữ ký theo thứ tự nào — nên một phiên bản được ký lại vẫn giữ nguyên ngày và người ký của nó. Với một phiên bản được ký ngay khi xuất bản, đó là thời điểm xuất bản của nó; với một phiên bản được ký lần đầu sau đó bằngaggrega sign, đó là thời điểm nó được ký. Nguồn này luôn được ưu tiên ở bất cứ nơi nào nó tồn tại.publisher— nếu không, đây là thời điểm mà bản xuất bản tự khai bên cạnh nội dung nó xuất bản: một attachment published-at nhỏ màaggrega pushvàaggrega push-artifactghi ra, mang theo đồng hồ của chính máy xuất bản, và không có gì chứng thực. Nó được đọc từ bất kỳ registry nào, bất kể chính sách tin cậy của registry đó, vì đây là lời khai của người xuất bản chứ không phải một quyết định tin cậy. Khi có nhiều attachment như vậy, thời điểm sớm nhất được chọn.
Một phiên bản không có nguồn nào trong hai nguồn trên thì không ghi lại ngày nào. Đó là một bản xuất bản không khai ngày, trong khi chữ ký của nó không phải là chữ ký keyless mà chính sách này xác minh — ví dụ một bản xuất bản keyless được đọc theo một chính sách không tin cậy danh tính keyless nào, vì một bản xuất bản keyless không tự khai ngày. aggrega search -o json báo cáo ngày dưới mỗi phiên bản trong published.
Những gì một lần làm mới đọc lại
Một lần làm mới so sánh những gì registry hiện phục vụ với những gì chỉ mục đã ghi, và đọc lại mọi thứ đã thay đổi — cùng một câu trả lời mà một lần đọc lại toàn bộ đưa ra. Với mỗi kho lưu trữ, nó:
- xác thực lại danh sách tag, nhờ đó một phiên bản được phát hành hoặc bị xóa kể từ lần trước sẽ được nhận ra;
- phân giải tag của mọi phiên bản thành manifest mà tag đó trỏ tới, nhờ đó một phiên bản cũ hơn được phát hành lại dưới tag hiện có sẽ được đọc lại;
- xác thực lại các tệp đính kèm của mọi phiên bản — chữ ký, các tuyên bố ngày phát hành và các dấu đánh dấu ngừng hỗ trợ của nó — nhờ đó một chữ ký, một ngày hoặc một dấu đánh dấu được gắn vào một phiên bản kể từ lần trước sẽ được đọc và xác minh, và làm điều tương tự với chữ ký của một dấu đánh dấu ngừng hỗ trợ mà nó đã đánh giá trước đó;
- so sánh chính sách tin cậy của registry với chính sách mà chỉ mục được xây dựng theo, nhờ đó khi chính sách thay đổi, mọi phiên bản sẽ được đọc lại theo chính sách mới.
Một dấu đánh dấu ngừng hỗ trợ, một chữ ký và một ngày phát hành đều được gắn vào một phiên bản đã phát hành dưới dạng một đối tượng riêng, trỏ ngược về phiên bản đó — đó chính là điều cho phép nhà phát hành ngừng hỗ trợ hoặc ký một phiên bản mà không cần phát hành lại — nên không cái nào trong số chúng thêm tag hay thay đổi manifest của chính phiên bản. Chúng thay đổi các tệp đính kèm của phiên bản, và đó chính là thứ mà bước kiểm tra thứ ba xác thực lại. Việc loại trừ phiên bản và aggrega inspect đều đọc chỉ mục này, nên một phiên bản bị thu hồi kể từ lần làm mới trước sẽ bị loại khỏi việc lựa chọn, và được hiển thị, ngay khi lần làm mới tiếp theo đã chạy.
Mỗi bước kiểm tra là một yêu cầu nhỏ — phân giải digest của manifest, hoặc một yêu cầu có điều kiện mà registry trả lời là không thay đổi mà không gửi gì — nên một lần làm mới registry không thay đổi sẽ không tải xuống gì. Một phiên bản mang một dấu đánh dấu ngừng hỗ trợ không được chấp nhận, hoặc có các tệp đính kèm mà lần chạy này không có cách nào xác thực lại, sẽ được đọc lại ở lần làm mới tiếp theo. Với một registry không thể cho biết các tệp đính kèm của một phiên bản có thay đổi hay không, mọi phiên bản sẽ được đọc lại ở mỗi lần làm mới: câu trả lời vẫn như nhau, và chi phí cũng bằng một lần đọc lại toàn bộ.
--upgrade đọc toàn bộ mọi kho lưu trữ, không so sánh gì với chỉ mục đã được ghi. Hãy dùng nó để xây dựng lại chỉ mục chỉ từ registry; nó không nhận ra thêm điều gì mà một lần làm mới bỏ sót.
Registry yêu cầu giảm tốc độ
Hub chính thức, hub.aggrega.ai, giới hạn số yêu cầu có thể đến từ một địa chỉ trong một khoảng thời gian ngắn, nên các máy dùng chung một địa chỉ cũng dùng chung hạn mức đó, và bất kỳ registry nào cũng có thể giới hạn các client của mình theo cách tương tự. Registry vượt quá giới hạn sẽ trả lời 429 Too Many Requests, hoặc 503 Service Unavailable kèm header Retry-After cho biết cần chờ bao lâu. Mọi yêu cầu mà dòng lệnh gửi tới một registry, bất kể lệnh nào, đều xử lý câu trả lời đó theo cùng một cách: chờ đúng khoảng thời gian registry yêu cầu, hoặc mười giây nếu câu trả lời không nói rõ, cộng thêm tối đa một giây ngẫu nhiên, rồi hỏi lại, không có số lần thử cố định. Mọi yêu cầu tới registry đó đều chờ cùng, không chỉ yêu cầu bị từ chối, và số yêu cầu gửi tới nó cùng lúc giảm đi — giảm một nửa mỗi lần nó yêu cầu, xuống tới một — rồi tăng lại thêm một sau mỗi loạt yêu cầu nó phục vụ mà không lỗi, trở về con số thông thường của lệnh. Thời gian chờ được hiển thị theo cùng điều kiện như phần tiến trình còn lại của lệnh, dưới dạng một dòng như hub.aggrega.ai asked to slow down; waiting 11 s: aggrega build, aggrega pull và aggrega registry update hiển thị nó bên cạnh bước đang chạy, các lệnh khác có hiển thị điều chúng đang chờ thì hiển thị nó như một bước riêng — trừ aggrega sign --jobs khi ký nhiều tham chiếu cùng lúc, lệnh này hiển thị các lần chờ đó như một bước duy nhất — và không có gì được hiển thị khi standard error không phải là terminal, trừ khi --progress của lệnh yêu cầu. Registry nào trong năm phút không trả lời gì ngoài “giảm tốc độ” sẽ bị từ chối với E0378, nêu tên registry, câu trả lời cuối cùng của nó và nó đã không trả lời gì khác trong bao lâu; năm phút này là cố định, và không có thiết lập nào thay đổi được. Khi đó aggrega registry update nêu tên registry đó dưới Not indexed: trong bản tóm tắt cuối, và registry đó giữ nguyên chỉ mục nó có trước lần chạy.
Một lần đọc thất bại
Một lần duyệt đọc nhiều đối tượng nhỏ từ registry, và một số lần đọc thất bại tạm thời: registry trả lời rằng nó gặp lỗi hoặc không khả dụng (trạng thái 5xx, trừ 503 có cho biết cần chờ bao lâu) hoặc rằng yêu cầu đã hết thời gian chờ (408), kết nối bị đặt lại hoặc hết thời gian chờ, hoặc câu trả lời dừng lại trước khi hoàn tất. Mỗi lần đọc như vậy được yêu cầu lại vài lần, với thời gian chờ tăng dần giữa các lần thử. Một registry yêu cầu lần duyệt giảm tốc độ không phải là làm thất bại một lần đọc: lần đọc sẽ chờ và được yêu cầu lại như Registry yêu cầu giảm tốc độ mô tả, và một registry tiếp tục yêu cầu như vậy trong năm phút sẽ kết thúc lần duyệt của chính registry đó chứ không phải của một kho lưu trữ.
Một lần đọc vẫn thất bại không bao giờ được coi là một câu trả lời. Một chữ ký không đọc được không phải là một phiên bản không có chữ ký, và một dấu đánh dấu ngừng hỗ trợ không đọc được không phải là một phiên bản chưa bao giờ bị thu hồi, nên lần duyệt không ghi lại gì về repository đó từ lần chạy này. Repository giữ bản ghi mà chỉ mục đã có cho nó, nếu bản ghi đó được đánh giá theo chính sách tin cậy của registry đang có hiệu lực, và nếu không thì bị loại khỏi chỉ mục. Dù trường hợp nào, lần duyệt cũng nêu tên repository trong phần thông báo khi đang chạy, cho biết điều nào trong hai điều đã xảy ra và lần đọc nào thất bại, rồi nêu lại nó trong phần tóm tắt cuối, trên một dòng riêng bên dưới hàng của registry của nó, trong số các repository không đọc được:
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: …Hàng của registry cũng cho biết có bao nhiêu lần đọc đã được yêu cầu lại, mỗi lần đọc được tính một lần bất kể đã mất bao nhiêu lần thử và sau đó có thành công hay không, và ghi 0 reads retried khi không có lần nào. Một lần duyệt mà mọi lần đọc cuối cùng đều thành công sẽ không hiển thị repository nào trên hàng của nó, nên chính con số này cho biết nó đã suýt bỏ sót một repository đến mức nào.
Mỗi dòng như vậy mở đầu bằng loại thất bại cuối cùng của lần đọc — trạng thái mà registry đã trả lời, một lần đọc hết thời gian chờ, một kết nối bị đặt lại, hoặc một câu trả lời bị cắt ngang — theo sau là chính thất bại đó, cho biết đó là lần đọc nào. Một thất bại không thuộc loại nào trong số đó, chẳng hạn như không thể lấy được trust root để xác minh chữ ký, được nêu chỉ bằng chính thất bại đó. Phương thức aggrega/registryUpdate của aggrega serve trả lời với cùng các repository dưới skipped của mỗi host, mỗi repository với cùng reason, và với số lần đọc được yêu cầu lại dưới dạng readsRetried. Điều tương tự áp dụng cho một lần làm mới và cho --upgrade, và lần duyệt tiếp theo bắt đầu từ bất cứ thứ gì chỉ mục đang giữ lúc đó, như với mọi repository.
Khóa công khai mà một chính sách dùng khóa ghim
Một chính sách tin cậy dùng khóa ghim khóa công khai của registry ngay trong cấu hình, dưới dạng public_key của mục đó:
aggrega registry add --key <file> sao chép nội dung của tệp vào đó, và việc ghim một
chính sách mà registry quảng bá có chứa khóa cũng làm như vậy. Giá trị là một khối khóa công khai PEM — phần
văn bản từ một dòng -----BEGIN PUBLIC KEY-----, hoặc -----BEGIN RSA PUBLIC KEY-----, đến dòng
-----END tương ứng — và mọi văn bản phía trên khối đều bị bỏ qua.
Một giá trị không chứa dòng -----BEGIN … PUBLIC KEY----- nào sẽ bị từ chối khi tệp cấu hình
được tải, kèm tên tệp và tên mục. registry add thực hiện cùng phép kiểm tra đó trước khi
ghi, nên một tệp --key chứa bất kỳ thứ gì khác — một khóa riêng tư, một chứng chỉ, hay một khóa ở
mã hóa khác — sẽ bị từ chối và tệp cấu hình được giữ nguyên. Chỉ dòng đó
được kiểm tra: việc khối đó có giải mã được thành một khóa dùng được hay không chỉ được phát hiện khi một chữ ký từ
registry được xác minh bằng khóa đó.
Ngoại tuyến
aggrega registry update là lệnh duy nhất trong nhóm này mà toàn bộ công việc là duyệt qua
các registry, và ở chế độ ngoại tuyến — khóa offline cấp cao nhất trong một
tệp cấu hình, AGGREGA_OFFLINE, hoặc --offline — lệnh này
từ chối trước khi duyệt bất cứ thứ gì. Thông báo từ chối nêu rõ cái nào trong ba cái đó đã thiết lập chế độ này.
Không có dạng một phần nào để dùng thay thế, vì chỉ mục ghi lại những gì mỗi registry
hiện đang phục vụ và điều đó không thể biết được nếu không hỏi registry. Điều một không gian làm việc ngoại tuyến
có thể làm là đọc chỉ mục nó đã có: aggrega search và thông báo ngừng hỗ trợ trên
aggrega inspect đều đọc bản chụp cục bộ và hoàn toàn không cần mạng, nên làm mới là
thứ duy nhất chế độ này lấy đi. Để làm mới cho một lần chạy từ một không gian làm việc ngoại tuyến,
hãy truyền --offline=false.
aggrega registry add truy cập mạng một lần, để lấy chính sách tin cậy mà registry công bố, trừ khi --fetch-trust=false, --identity hoặc --key chỉ định không tải. Ở chế độ ngoại tuyến, việc tải đó bị từ chối trước khi bất kỳ kết nối nào được thực hiện, nên registry không bao giờ được hỏi. Khi đó, việc thêm một registry khác hub chính thức sẽ bị từ chối — thêm một registry là thời điểm duy nhất sự tin cậy của nó được ghim, và một mục được ghi mà không có chính sách sẽ không tin cậy gì cả trong khi mọi lần pull sau đều buộc registry tuân theo nó. Thông báo từ chối mang mã ngắn E0310 và nêu cả hai cách tiếp tục: đăng ký nó một lần khi trực tuyến, điều mà --offline=false cho phép trong một lần chạy, hoặc ghim chính sách thủ công bằng --identity hoặc --key, cách này đăng ký đúng những gì bạn cung cấp và hoàn toàn không tải gì. Hub chính thức được thêm dựa trên đường cơ sở tích hợp sẵn của nó, kèm một thông báo cho biết hub không được hỏi về chính sách tin cậy vì không gian làm việc đang ngoại tuyến và đường cơ sở được dùng thay thế, và --fetch-trust=false đăng ký mục từ các cờ của nó đúng như khi trực tuyến. Cùng một thao tác đăng ký thực hiện qua aggrega serve hoặc aggrega mcp cũng hoạt động như vậy: cùng thông báo từ chối với cùng câu chữ, và nếu không thì cùng một mục. A registry is added offline with no trust policy to pin (Một registry được thêm khi ngoại tuyến mà không có chính sách tin cậy để ghim) trích dẫn thông báo từ chối này.
list và remove thay đổi hoặc đọc cấu hình cục bộ và không bị ảnh hưởng.