Các sentinel lỗi — tài liệu tham chiếu chuẩn
Mỗi lần dừng nghiêm trọng mà trình biên dịch phát ra đều nêu tên một điều kiện, và mỗi điều kiện mang ba định danh, vì nhận biết một điều kiện, ghi lại nó và trích dẫn nó là ba việc khác nhau. Sentinel là giá trị Go mà errors.Is khớp, có được bằng cách gọi hàm truy cập mà gói khai báo xuất ra: định danh mà mã Go nhận biết. Mã là chuỗi mà điều kiện được đăng ký dưới đó: nó gọi tên chính điều kiện bằng lời, và là thứ giữ cố định khi các gói Go xung quanh thay đổi — định danh mà một chương trình ghi lại. Mã ngắn là chữ E và bốn chữ số, đủ ngắn để đọc to, gõ vào ô tìm kiếm hoặc dán vào báo cáo: định danh mà một người trích dẫn. Một điều kiện, ba định danh — hãy khớp sentinel để nhận biết điều kiện từ Go, đọc mã khi bạn cần ghi lại hoặc dùng nó làm khóa, và tra một mã ngắn trong bảng mọi điều kiện ở phần sau của trang này.
Chẩn đoán hướng tới người dùng (thông điệp có tiền tố được liệt kê trong fatal-halts.md và error-translation.md) mang phần mô tả dành cho nhà phát triển; sentinel được bọc là thứ mà errors.Is khớp với trong các chương trình tiêu thụ.
Trang này là góc nhìn theo sentinel của danh mục. Các lập trình viên viết cổng CI, tích hợp IDE hoặc mã điều phối build cần phân biệt các loại lỗi sẽ khớp với các sentinel liệt kê ở đây bằng vị từ chuẩn errors.Is. Tác giả gỡ lỗi một bản build bằng cách đọc văn bản lỗi được phát ra thường cần các góc nhìn theo thông điệp — fatal-halts.md cho các lỗi làm dừng build, warnings.md cho đầu ra mang tính khuyến nghị.
Mỗi hàng trong các bảng dưới đây nêu tên một hàm truy cập — một hàm không nhận đối số, được xuất từ gói mà bảng nêu tên, trả về sentinel. Nhập gói đó và gọi hàm truy cập là bề mặt tích hợp được hỗ trợ, đó là lý do các bảng viết mỗi hàm kèm dấu ngoặc đơn — lời gọi mới là thứ tạo ra một giá trị mà errors.Is có thể khớp, còn tên không có ngoặc là một hàm chứ không phải một lỗi:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Ba định danh mang tính ổn định riêng biệt, và sự tách biệt đó là lý do một điều kiện có cả ba. Các hàm truy cập liệt kê dưới đây ổn định qua các bản phát hành vá lỗi; việc đổi tên hoặc loại bỏ được công bố trong mục nhật ký thay đổi của bản phát hành thực hiện chúng, còn việc thêm một hàm truy cập mới trong một gói là bổ sung và không làm hỏng các bộ khớp hiện có. Một mã được cố định khi điều kiện của nó được công bố, nên nó là định danh cần ghi lại ở bất cứ đâu một điều kiện phải được gọi tên lâu dài: đổi tên một hàm truy cập không làm thay đổi mã mà điều kiện của nó đã được đăng ký, và một mã bạn đã ghi lại tồn tại lâu hơn một lần tái cấu trúc bề mặt Go. Mã ngắn là định danh bền vững nhất trong ba: một số được cấp một lần rồi cố định, và số của một điều kiện đã ngừng dùng vẫn ở trạng thái ngừng dùng chứ không được cấp cho một điều kiện khác, nên một mã ngắn ghi trong một báo cáo cũ vẫn gọi tên đúng điều kiện mà nó đã gọi tên khi được ghi lại. Điều đó được thực thi chứ không chỉ là ý định — một điều kiện được khai báo dưới một số đã ngừng dùng sẽ bị từ chối trước khi trình biên dịch đọc bất kỳ đầu vào nào, ở mọi lần chạy — và mọi số đã ngừng dùng được công bố bên cạnh các số đang dùng trong bảng mọi điều kiện. Cột mã dưới đây mang mã, và đó là giá trị mà một client của chẩn đoán có cấu trúc đọc mà không cần liên kết các gói này. Nó được công bố chứ không được suy ra, vì nó không nhất thiết lặp lại hàng chứa nó — một tên được xuất lại báo cáo mã của điều kiện mà nó chuyển tiếp tới, và mã của một quy tắc gọi tên quy tắc chứ không phải hàm truy cập. Cột thông điệp là văn bản nguyên văn mà sentinel hiển thị; chẩn đoán hướng tới người dùng đặt một phần đầu trong ngoặc vuông và vị trí nguồn trước văn bản đó. Phần đầu đó mang mã ngắn của điều kiện, kèm hạng mục của lần xảy ra bên cạnh nếu lần xảy ra có hạng mục, như trong [DEVELOPER_ERROR E0007] — nên người đọc có thể tra từng thứ một cách độc lập: các hạng mục (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) được giải thích trong error-translation.md, và các mã ngắn được tra trong bảng mọi điều kiện trên trang này. Khi một plugin phát sinh điều kiện, token mã được định danh kèm plugin đã phát sinh nó — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — và mã ngắn là phân đoạn cuối cùng; error-translation.md giải thích vì sao có phần định danh đó và vì sao phân đoạn cuối cùng là phân đoạn cần tra.
Đọc mã của một điều kiện
Một mã chỉ đặt tên cho điều kiện và không gì khác, theo kiểu kebab-case — parameter-contract-violation, lockfile-drift. Mã không mang tiền tố nào: không phải gói khai báo nó, không phải giai đoạn phát sinh nó, cũng không phải bất kỳ cách nhóm nào. Nhờ vậy, mã giữ nguyên khi trình biên dịch được tổ chức lại xung quanh nó, và một điều kiện được phát sinh tại nhiều điểm trong một lần biên dịch vẫn chỉ có một tên. Tên của mỗi điều kiện tự thân đã khác biệt, đó là điều khiến tiền tố trở nên không cần thiết, và hai điều kiện không thể được đăng ký dưới cùng một mã. Bạn đọc mã từ một lỗi bằng CodeOf, từ github.com/aggrega-ai/aggrega-cli/pkg/errors, hàm này duyệt chuỗi bọc theo cách errors.Is làm, nên mã vẫn còn nguyên dù có bao nhiêu khung đã bọc lỗi trên đường quay về với bạn. Bản thân gói đó cũng có tên errors, nên một bí danh import giúp tách nó khỏi thư viện chuẩn:
package release
import ( "log"
aggregaerrors "github.com/aggrega-ai/aggrega-cli/pkg/errors" "github.com/aggrega-ai/aggrega-cli/pkg/resolver")
// Load reads a Release and reports the code of whatever condition halted it.func Load(path string) error { _, err := resolver.LoadRelease(path) if err == nil { return nil } if code, ok := aggregaerrors.CodeOf(err); ok { // code names the condition in words, such as parameter-contract-violation. log.Printf("%s halted: %s", path, code) } return err}CodeOf cũng cho biết liệu có lỗi nào trong chuỗi mang mã hay không; một chuỗi không mang mã nào là một thực tế về chuỗi đó chứ không phải một thất bại. Nếu bạn muốn tự khớp interface, cùng gói đó xuất nó dưới tên CodedError, và errors.As tìm thấy nó trong cùng lượt duyệt.
Mã chỉ đi theo một chiều. Mã là thứ một điều kiện báo cáo, không bao giờ là thứ nhận diện điều kiện đó cho một bộ khớp: viết chuỗi đó vào mã của bạn chỉ cho bạn một chuỗi, và không có đường nào đi ngược từ một chuỗi về giá trị mà errors.Is khớp. Hãy khớp sentinel để nhận diện một điều kiện; đọc mã để ghi lại một điều kiện.
Mã mà aggrega in ra trên terminal là mã ngắn, không phải mã này. Một chẩn đoán dừng mở đầu bằng một phần đầu trong ngoặc vuông mang mã ngắn của điều kiện, kèm theo hạng mục của lần xảy ra bên cạnh nếu lần xảy ra đó có hạng mục — [DEVELOPER_ERROR E0007], hoặc [TRANSLATION_ERROR provider/example:1.0.0/E0007] khi một plugin phát sinh điều kiện và mã được định danh kèm plugin đã phát sinh nó, hoặc [E0007] khi lỗi không có mối quan tâm nào để chuyển bạn tới — rồi đến vị trí nguồn và văn bản thông báo được liệt kê trong fatal-halts.md. Mã mô tả đặt tên điều kiện bằng lời và quá dài cho vị trí đó: với những điều kiện dài nhất, nó sẽ lấp đầy một terminal hẹp trước khi thông báo bắt đầu, và đó chính là toàn bộ lý do tồn tại một định danh thứ hai, gọn hơn. Vì vậy, khi bạn chỉ có đầu ra đã in, định danh để dựa vào là mã ngắn, và nó được tra cứu trong bảng mọi điều kiện ở phần sau của trang này: từ một con số bạn có thể đọc qua điện thoại, bạn tìm tới điều kiện, accessor của nó và văn bản thông báo của nó. aggrega explain <code> thực hiện việc tra cứu đó ngay tại terminal — lệnh nhận một trong hai mã của điều kiện và in ra điều kiện cùng với mục ghi lại cách sửa khi soạn thảo, và được mô tả trong aggrega explain. Các góc nhìn theo thông báo trong fatal-halts.md vẫn là cách để làm việc từ câu chữ thay vì từ một định danh.
Nơi một mã thực sự đi ra ngoài Go là chẩn đoán có cấu trúc mà daemon compiler-as-service công bố, dưới dạng một trường code riêng trên mỗi mục chứ không phải thứ gì đó gộp vào văn bản thông báo — nhờ vậy một tiện ích mở rộng của trình soạn thảo, hay bất kỳ client nào khác của giao thức đó, phân nhánh dựa trên những gì một mục báo cáo mà không cần liên kết các gói này và không cần phân tích văn xuôi. Khóa đó mang một mã máy có thể khớp, bất kể ai đã gán nó, và mục cho biết tầng nào đã phát sinh nó. Một mã ở đó có ba nguồn gốc, và nguồn thứ ba là lý do một mã bạn có thể tra trên trang này không tự nó là dấu hiệu rằng có gì đó thất bại:
- Mã của điều kiện mà một lỗi nêu tên, là thứ trang này liệt kê.
- Mã lớp của một cảnh báo tư vấn về đầu ra đã render —
unsupported-fieldlà một ví dụ, và warnings.md mô tả nó. Mã này được gán tại nơi cảnh báo được phát sinh thay vì được đăng ký như một điều kiện, nên nó không có hàng nào ở đây. - Mã đã đăng ký của một cảnh báo tư vấn về các tài liệu được soạn — một tên chỉ cách một tên đã khai báo một lần chỉnh sửa, một tham số không có gì đọc. Một phát hiện như vậy nêu tên một điều kiện theo cùng dạng như một lỗi, nên mã của nó được đăng ký và có một hàng trên trang này, và đọc hàng đó cho bạn biết phát hiện đó nói về điều gì.
Vì vậy, cùng một mã bạn đọc được từ một lần dừng cũng có thể đến với bạn từ một bản dựng đã hoàn tất, được mang theo bởi một phát hiện không thay đổi gì về kết quả. Điều phân biệt hai trường hợp là kết quả bạn nhận được và tầng mà mục nêu tên — không bao giờ là dạng của chính mã, và không bao giờ là việc nó có tra được ở đây hay không. Trường này bị bỏ qua khi không có gì tạo ra mục đã gán mã: một lỗi không nêu tên điều kiện nào của chính Aggrega, và một cảnh báo tư vấn mà bên phát sinh không gán mã nào. aggrega serve ghi lại hình dạng của mục, khóa nêu tên tầng, và khi nào trường này có mặt.
Một chẩn đoán có cấu trúc mang cả hai định danh của một điều kiện, và biết cái nào là cái nào chính là sự khác biệt giữa một định danh bạn có thể hành động theo và một định danh bạn không thể. Khóa code ở trên dành cho một chương trình: có gạch nối và đặt tên điều kiện bằng lời, để một tiện ích mở rộng phân nhánh theo nó đọc đúng như ý nghĩa của nó, và đó là giá trị CodeOf báo cáo trong Go. Khóa shortCode bên cạnh dành cho một con người — chữ E và bốn chữ số, cùng định danh mà một chẩn đoán dừng in ra trong phần đầu trong ngoặc vuông. Đó là thứ bạn đọc qua điện thoại, gõ vào ô tìm kiếm, hoặc dán vào một issue, và đó là định danh mà bảng mọi điều kiện dùng làm khóa.
Không cái nào là dạng viết tắt của cái kia, và không cái nào là phương án dự phòng cho cái kia. Hãy khớp theo mã mô tả; hiển thị cho người đọc mã ngắn. Một bề mặt chỉ cung cấp mã mô tả sẽ trao cho người soạn một định danh dành cho bộ khớp, còn một bề mặt khớp theo mã ngắn sẽ khớp theo một con số không nói gì về điều kiện — đó là lý do cả hai cùng được truyền đi thay vì chọn một.
Một khóa thứ ba, codeDescription, mang nơi điều kiện được công bố, như một tham chiếu để mở xem thêm về chẩn đoán. Địa chỉ của nó trỏ tới bảng mọi điều kiện trên trang này, nên người đọc theo nó từ trình soạn thảo sẽ đến nơi với mã ngắn mà bảng dùng làm khóa. Một mục mang mã ngắn và tham chiếu cùng nhau, hoặc không mang cái nào: cả hai có mặt đúng khi mục nêu tên một điều kiện đã đăng ký — một điều kiện có hàng trong bảng đó — và cả hai vắng mặt khi mã nêu tên một lớp cảnh báo tư vấn hoặc danh tính của một quy tắc quy ước từ một linter của riêng bạn mà Aggrega không khai báo, vì không có con số nào để trích dẫn cho những trường hợp đó và không có gì ở đây mô tả chúng.
Theo chiều ngược lại — từ một mã bạn đang có đến điều kiện mà nó nêu tên — các bảng dưới đây là danh sách được công bố. Mỗi hàng mang mã bên cạnh accessor cho ra cùng điều kiện đó trong Go, nên một mã đọc được từ chẩn đoán có cấu trúc sẽ dẫn tới một tên bạn có thể khớp và tới văn bản mà điều kiện hiển thị. Các bảng bao gồm những điều kiện có accessor bạn có thể import, và có hai loại mã nằm ngoài chúng: mã lớp, vốn nêu tên một lớp cảnh báo tư vấn chứ không phải một điều kiện nên không có accessor để đặt cạnh, và mã có điều kiện chỉ được khai báo trong một gói bạn không thể import và không được tái xuất ở đâu, nên không có tên có thể khớp để đặt cạnh. Loại thứ hai đó vẫn nêu tên một điều kiện, và điều kiện đó vẫn có mã ngắn — bảng mọi điều kiện, ở phần sau của trang này, dùng mã ngắn làm khóa thay vì một tên có thể import, nên bao gồm cả những điều kiện đó.
Bề mặt có thể so khớp, theo gói khai báo
Mỗi mục dưới đây là một gói mà bạn có thể import. Tiêu đề của mục là đường dẫn gói tương đối so với đường dẫn module github.com/aggrega-ai/aggrega-cli, vì vậy mục có tiêu đề pkg/resolver được import dưới dạng github.com/aggrega-ai/aggrega-cli/pkg/resolver.
Các mục được nhóm theo gói khai báo sentinel, vì đó là gói mà một bộ so khớp import. Điều kiện được phát sinh ở đâu trong một bản build là một câu hỏi riêng, và là câu hỏi mà trang này cố ý không trả lời: một sentinel thường được phát sinh từ nhiều nơi, và một số chỉ được phát sinh từ mã mà module không export, nên không có câu trả lời theo từng mục nào đúng cho mọi hàng. Các chế độ xem theo thông báo trả lời câu hỏi về thời điểm trong bản build bằng những điều bạn có thể quan sát được — trên hết là fatal-halts.md.
Một vài tên xuất hiện trong nhiều gói. Đó là các bản re-export của cùng một giá trị dùng chung chứ không phải hai điều kiện, nên so khớp với tên nào cũng thành công; các bảng ghi rõ điều này ở nơi cả hai tên đều có thể import. Cả hai hàng mang cùng một mã, đó cũng chính là sự thật ấy được thể hiện trên định danh mà một client bên ngoài Go nắm giữ: một điều kiện, một mã, bất kể có bao nhiêu tên dẫn đến nó.
pkg/catalog
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAllVersionsRetracted() | all-versions-retracted | every published version this reference could select has been withdrawn |
ErrAmbiguousImporterPlugin() | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
ErrAmbiguousParserPlugin() | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
ErrAmbiguousProviderPlugin() | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
ErrAmbiguousTypeMapping() | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
ErrDuplicateEntityIdentity() | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
ErrImporterVersionUnsatisfiable() | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrNameMappingMatchedNothing() | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
ErrNoImporterForFormat() | no-importer-for-format | no importer plugin advertises the requested format |
ErrNoParserForFormat() | no-parser-for-format | no parser plugin advertises the requested format |
ErrNoRecipeResolved() | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
ErrProviderBindingCapabilityUnserved() | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
ErrProviderBindingUnsatisfied() | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
ErrProviderVersionUnsatisfiable() | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
ErrQualifiedPluginReference() | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
ErrUnknownCatalogDocumentKind() | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
ErrUnsatisfiableEntityVersion() | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
ErrUnscopedPluginReference() | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
ErrUnscopedRecipeReference() | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
ErrUnusableSchemaImport() | unusable-schema-import | a schema `$import:` could not be applied |
ErrManifestImplementsMismatch()là cùng một giá trị vớipkg/resolver.ErrManifestImplementsMismatch(), nên so khớp với tên nào cũng thành công.
pkg/closure
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrInvalidLibraryRef() | invalid-library-ref | resolve: invalid library reference URI |
ErrMVSConflict() | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
ErrNoAggregateLoader() | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
ErrNoRecipeLoader() | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
ErrSourceTemplateAtLockTime() | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
ErrSourceTemplateParse() | source-template-not-parsable | resolve: source-template parse error |
ErrSourceTemplateProvidesRef() | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
ErrSubAggregateDepth() | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
ErrUnresolvableURI() | unresolvable-uri | resolve: no entity in the catalog matches this URI |
pkg/compactform
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAmbiguousDispatch() | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
ErrCircularRef() | reference-cycle | circular reference expansion |
ErrConstraintTypeMismatch() | constraint-type-mismatch | compactform: constraint not valid for declared type |
ErrEscapeContentInvalid() | escape-content-invalid | compactform: $jsonschema content invalid |
ErrHostInLibraryRef() | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
ErrReferenceUnresolvable() | reference-unresolvable | compactform: $ref unresolvable |
ErrUnknownKeyword() | unknown-keyword | compactform: unknown keyword |
ErrUnresolvedSchemaLibraryRef() | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
ErrCircularRef()là cùng một giá trị vớipkg/refcycle.ErrCycle(), nên so khớp với tên nào cũng thành công.
pkg/deprecation
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrNotDocsBundle() | not-docs-bundle | docscache: artifact is not a documentation bundle |
ErrPageNotFound() | page-not-found | docscache: page not found in documentation bundle |
ErrFetchNotFound()là cùng một giá trị vớipkg/oci.ErrFetchNotFound(), nên so khớp với tên nào cũng thành công.
pkg/egress
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrNoAnswerInTime() | no-answer-in-time | egress: the server did not answer in time |
ErrOfflineEgress() | offline-egress | egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache |
pkg/externalinputs
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAcquisitionDisabled() | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
ErrDigestMismatch() | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
ErrSchemeNotAllowed() | scheme-not-allowed | externalinputs: URL scheme is not allowed |
ErrStoreCorrupt() | store-corrupt | externalinputs: store blob mismatches its pinned record |
pkg/lockfile
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrLockfileDrift() | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
ErrLockfileInvalid() | lockfile-invalid | lockfile: file failed schema validation |
ErrSignatureNotRecorded() | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
pkg/oci
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAmbiguousContentLayer() | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
ErrBundleAmbiguousEntityDocument() | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
ErrBundleNoEntityDocument() | bundle-no-entity-document | oci: published bundle carries no entity document |
ErrBundleUnreadable() | bundle-unreadable | oci: published bundle cannot be unpacked |
ErrCacheLocationOutsideCache() | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
ErrCachedManifestIntegrity() | cached-manifest-integrity | oci: cached manifest digest mismatch |
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrImmutableTagConflict() | immutable-tag-conflict | oci: tag already published with different content |
ErrNoContentLayer() | no-content-layer | oci: manifest has no layer of the expected content media type |
ErrOCILocationCollision() | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
ErrPublishedArtifactNotAnEntity() | published-artifact-not-an-entity | oci: published artifact is not an entity document |
ErrReferrerDiscoveryUnavailable() | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
ErrRegistryTooBusy() | registry-too-busy | oci: the registry kept asking to slow down |
ErrRetiredMediaType() | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
ErrSignatureBundleDigestMismatch() | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
ErrSignatureForAnotherArtifact() | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
ErrUnknownEntityKind() | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
pkg/pathscope
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrPluginArtifactNotFound() | plugin-artifact-not-found | plugin artifact not found on this machine |
ErrPluginEntityNotFound() | plugin-entity-not-found | plugin reference is not a Plugin entity |
pkg/pluginstrust
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrVerdictAttachmentNotConfigured() | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
pkg/plugintest
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrCommandsMismatch() | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
ErrContractMismatch() | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
ErrHostFunctionsMismatch() | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
ErrRejected() | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
ErrTypeMismatch() | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
pkg/readscope
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrReadLeadsOutOfWorkspace() | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
ErrReferenceLeadsOutOfWorkspace() | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
pkg/recipepin
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrEntityNotPinned() | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
ErrLocalSourceContentMismatch() | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
pkg/refcycle
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrMalformedTrust() | malformed-trust-policy | registrytrust: advertised trust config is malformed |
ErrNoTrustAdvertised() | no-trust-advertised | registrytrust: registry advertises no trust config |
ErrOfflineRegistrationWithoutTrustPolicy() | offline-registration-without-trust-policy | a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>` |
pkg/resolver
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAnnotationBindingPillarOverlap() | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
ErrAnnotationBindingTargetUnresolved() | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
ErrAnnotationScalarNotRoutable() | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
ErrAnnotationSidePillarMismatch() | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
ErrAnnotationSubkeyNotBound() | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
ErrAnnotationSubkeyNotConforming() | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
ErrAttachmentInjectValue() | attachment-inject-value | inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block |
ErrAttachmentSlotNearMiss() | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
ErrAttachmentSlotShape() | attachment-slot-shape | attachment does not conform to its declared slot shape |
ErrConnectionAttachmentSlotUndeclared() | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
ErrDuplicateBoundaryComponent() | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
ErrDuplicateTriadIdentity() | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
ErrFeatureMergeConflict() | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
ErrGuardEntityViewInconsistency() | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
ErrInheritedBoundaryDirectoryIsLiteral() | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
ErrInjectDeliveryShape() | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
ErrInjectEntryAmbiguous() | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
ErrInjectKeyCollision() | inject-key-collision | duplicate delivery key across inject sources |
ErrInvalidInjectKey() | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
ErrInvalidParameterRef() | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
ErrMalformedRecipeReference() | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
ErrManifestCrossBindingPillarCollision() | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrManifestReservedPrefix() | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
ErrMisnamedSlotFill() | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
ErrMissingRequiredFeature() | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
ErrMissingRequiredSocket() | missing-required-socket | required uses socket not populated |
ErrParameterContractViolation() | parameter-contract-violation | parameter contract violated |
ErrParameterMissing() | parameter-missing | required parameter not supplied |
ErrProvidesKeyNotDeclared() | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
ErrReleaseChainComposesBothRoutingKeys() | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
ErrSchemaConformance() | schema-conformance | authored pillar does not conform to its declared schema |
ErrSchemaContractCompileFailure() | schema-contract-compile-failure | declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation |
ErrSelfInjectForbidden() | self-inject-forbidden | self-inject on component without spec.inject allowlist |
ErrTriadRefUnresolvable() | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
ErrUnknownUsesSocket() | unknown-uses-socket | unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare |
ErrUnnormalizedRelease() | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
ErrUnreadParameter() | unread-parameter | declared parameter is read by no reference in the Aggregate |
ErrUsesInjectValue() | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
ErrUsesSocketNearMiss() | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
ErrVerdictPluginTrustMismatch() | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
ErrYAMLLoad() | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
pkg/signing
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrKeylessLive() | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
ErrMixedSigningCredentials() | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
ErrNoSignatureFound() | no-signature-found | signing: no signature found for an artifact that requires one |
ErrNoTrustedIdentities() | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
ErrSignatureInvalid() | signature-invalid | signing: signature does not verify |
ErrSignatureVerificationFailed() | signature-verification-failed | signing: signature bundle does not verify |
ErrSigningPolicyRequiresSignature() | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
ErrTrustRootLoad() | trust-root-not-loadable | signing: cannot load pinned trust root |
ErrUnsignedPushRefused() | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
ErrUnsupportedKey() | unsupported-key | signing: unsupported held-key type |
ErrUntrustedIdentity() | untrusted-identity | signing: signature identity is not trusted for this registry |
pkg/sourcecache
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()là cùng một giá trị vớipkg/oci.ErrFetchIntegrity(), nên so khớp với tên nào cũng thành công.ErrFetchNotFound()là cùng một giá trị vớipkg/oci.ErrFetchNotFound(), nên so khớp với tên nào cũng thành công.
pkg/sourcekind
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrNoAdapterRegistered() | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
ErrFetchIntegrity()là cùng một giá trị vớipkg/oci.ErrFetchIntegrity(), nên so khớp với tên nào cũng thành công.ErrFetchNetworkUnreachable()là cùng một giá trị vớipkg/oci.ErrFetchNetworkUnreachable(), nên so khớp với tên nào cũng thành công.ErrFetchNotFound()là cùng một giá trị vớipkg/oci.ErrFetchNotFound(), nên so khớp với tên nào cũng thành công.ErrFetchUnauthorized()là cùng một giá trị vớipkg/oci.ErrFetchUnauthorized(), nên so khớp với tên nào cũng thành công.
pkg/sourceresolver/cacheslot
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrArtifactEntryShape() | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
ErrArtifactLibraryEntryShape() | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
ErrForbiddenKeyword() | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
ErrLibraryReferenceWhitespace() | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
ErrMalformedVersionPin() | malformed-version-pin | reference carries a malformed version pin |
ErrMappingEntryNotScalar() | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
ErrOrderedMapDecodeDepthExceeded() | document-nesting-depth-exceeded | a document nests too many levels deep |
ErrParametersShape() | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
ErrTemplateNotFound() | template-not-found | schemalibrary: template not found |
ErrTemplateParamMissing() | template-param-missing | schemalibrary: template parameter missing |
ErrTemplateParamTypeMismatch() | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
ErrValuesMappingShape() | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
ErrWellKnownAnnotationScope() | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
ErrWorkloadEntryNotScalar() | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
ErrWorkloadTemplateShape() | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
pkg/usesedge
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAssertionNameCollision() | assertion-name-collision | assertion name declared twice across the extends chain |
ErrCyclicExtension() | cyclic-extension | cyclic extends chain |
ErrDuplicateContainerEnvironmentVariable() | duplicate-container-environment-variable | a container declares one environment variable twice |
ErrEmptySource() | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
ErrExtendsChainTooDeep() | extends-chain-too-deep | extends chain exceeds maximum depth |
ErrFeatureRecipeValuesMappingRequiresSource() | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
ErrInheritanceMerge() | extends-merge-failed | inheritance merge failed |
ErrRecipeFilenameCollisionAcrossInputKinds() | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
ErrRecipeNoInputKind() | recipe-no-input-kind | Recipe: at least one input kind required |
ErrRecipeOutputComponentLabelCollision() | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
ErrRecipeOutputLabelReservedNamespace() | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
ErrRecipeValuesMappingRequiresSource() | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
ErrSlotNotReferenceable() | slot-not-referenceable | workload attachment slot is not referenceable |
ErrUnknownSchemaPillar() | unknown-schema-pillar | a schema block declares a key that names no data pillar |
ErrWorkloadFeaturesSchema() | workload-features-schema | workload featuresSchema cross-check failed |
ErrWorkloadValidation() | workload-not-valid | workload validation failed |
pkg/validator/envelope
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrDuplicatePipelineStepID() | duplicate-pipeline-step-id | a pipeline declares one step id twice |
ErrEntityEnvelope() | entity-envelope-invalid | document envelope validation failed |
ErrRetiredABIVersion() | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
ErrRetiredAPIVersion() | retired-api-version | a document declares an API version this compiler no longer reads |
pkg/validator/jsonschema
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrAmbiguousRegistryAlias() | ambiguous-registry-alias | registry alias matches more than one host |
ErrCapabilityOnCrossCuttingSocket() | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
ErrColonInProviderBindingCapability() | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
ErrConfigInvalid() | workspace-config-invalid | workspace configuration is invalid |
ErrDuplicateImporterAttachment() | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
ErrDuplicateProviderTarget() | duplicate-provider-target | capability is bound to more than one provider plugin |
ErrDuplicateRegistryAlias() | duplicate-registry-alias | registry alias is already used by another host |
ErrGovernanceRoleInvalid() | governance-role-invalid | a governance attachment declares no role or an unknown role |
ErrInertFieldOnProviderSocket() | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
pkg/writescope
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrWriteLeadsOutOfWorkspace() | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
pkg/yamlpos
| Sentinel | Mã | Thông báo |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Các sentinel mang theo một sentinel khác
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) báo cáo một ô bộ nhớ đệm artifact nguồn bị hỏng. Nó được khai báo như một lớp bao quanh ErrFetchIntegrity() thay vì như một định danh riêng, nên nó không xuất hiện trong các bảng ở trên và một phép so khớp với ErrFetchIntegrity() cũng thành công đối với nó. Vì nó bao một sentinel thay vì khai báo một sentinel, nó được xuất dưới dạng một giá trị thay vì một hàm: hãy so khớp nó dưới dạng ErrCacheMetadataInvalid, không có dấu ngoặc đơn. Hãy so khớp lớp bao khi bạn muốn đúng điều kiện cụ thể đó, và so khớp sentinel được bao khi bạn muốn toàn bộ lớp lỗi về tính toàn vẹn.
Các sentinel có thể truy cập dưới một tên thứ hai trong cùng một package
Khi một package xuất hai accessor cho cùng một điều kiện — accessor thứ hai được khai báo như một lời chuyển tiếp tới accessor thứ nhất — các bảng ở trên ghi accessor khai báo và bỏ qua tên chuyển tiếp. Cả hai tên đều được xuất từ cùng một package, nên một import truy cập được tên này thì cũng đã truy cập được tên kia, và một hàng thứ hai sẽ liệt kê một điều kiện hai lần dưới một tên không khớp thêm điều gì mới. Khớp theo tên nào cũng thành công: lời chuyển tiếp trả về đúng giá trị mà accessor khai báo trả về.
Đây không phải trường hợp giữa các package khác nhau. Một sentinel được xuất lại từ một package khác có một hàng trong bảng của mỗi package, vì một matcher import một trong các package đó không thể truy cập tên của package kia nếu không import cả package đó; một lời chuyển tiếp bên trong một package duy nhất không cần hàng thứ hai, vì một import truy cập được cả hai tên.
ErrDuplicateRecipeIdentity() trong pkg/catalog là một lời chuyển tiếp như vậy: nó trả về ErrDuplicateEntityIdentity(), là tên mà bảng của package đó ghi.
Các điều kiện không có sentinel có thể so khớp
Một số giai đoạn biên dịch khai báo sentinel của chúng trong các package mà trình biên dịch không xuất ra, nên không có gì để errors.Is tham chiếu và không thể viết matcher nào cho chúng. Chúng được mô tả ở đây thay vì lập bảng, vì một bảng trên trang này là lời cam kết rằng cột bên trái có thể được giải tham chiếu.
Các chẩn đoán của chúng đến với bạn đầy đủ qua văn bản lỗi được phát ra và qua các khung nhìn theo khóa thông điệp — đặc biệt là fatal-halts.md — đây là cách được hỗ trợ để nhận biết chúng:
- Xây dựng topology (xây dựng đồ thị và làm phẳng sub-aggregate) báo cáo một sub-Aggregate không thể tải, nêu tên URI của Aggregate không truy cập được; một khai báo
uses:có hình dạng cấu trúc không khớp với schema; vượt quá độ sâu lồng nhau; và xung đột node-ID sau khi làm phẳng, khi hai sub-Aggregates biên dịch thành cùng một node ID và phải đổi tên một instance để phân biệt. - Hoàn tất đồ thị (gộp Feature trên các bề mặt Aggregate và Release) báo cáo một kiểu Feature được khai báo không nhất quán giữa hai bề mặt này.
- Phân tích tĩnh (đánh giá selector và kiểm tra an toàn kiểu giữa các node) báo cáo một vi phạm
selector:; một lần tra cứu catalog thất bại mà nó không thể vượt qua, nêu tên thực thể không truy cập được; và một từ chối chính sách, khi một plugin gắn tại vai trò phán quyết quản trị từ chối bản build đã được lắp ráp. Một từ chối chính sách mang danh mụcPOLICY_ERROR, tên của plugin từ chối và thông điệp quy tắc mà plugin cung cấp. - Kết xuất (điều phối provider và kết xuất theo từng provider) báo cáo một provider không xác định.
- Trình tải host Wasm nhúng phát ra các sentinel bảo vệ riêng của nó — một rào chắn từ chối manifest (một plugin đã yêu cầu một khả năng truy cập runtime mà tường lửa AOT-purity từ chối), một cơ chế phục hồi khi guest panic, và một trap thoát plugin có tính tất định. Các điều kiện này xuất hiện trong chẩn đoán hiển thị cho người dùng khi chạy một plugin (ví dụ thông qua
aggrega lint). Plugin authors kiểm thử một guest với host sẽ gặp cùng các điều kiện đó theo tên có thể import quapkg/plugintest, đã liệt kê ở trên.
Để chặn một pipeline riêng đối với từ chối chính sách, hãy so khớp tiền tố danh mục POLICY_ERROR trong chẩn đoán thay vì một sentinel; danh mục là một phần được tài liệu hóa của bề mặt lỗi, được mô tả trong error-translation.md.
Mọi điều kiện, theo mã ngắn
Bảng dưới đây tra cứu theo chiều ngược lại: một mã ngắn ở cột bên trái, và bên cạnh là điều kiện mà mã đó chỉ định cùng văn bản mà điều kiện đó hiển thị. Bảng bao gồm mọi điều kiện mà aggrega có thể báo cáo, kể cả những điều kiện mà các phần ở trên không thể liệt kê.
Phạm vi rộng hơn đó là mục đích của bảng này chứ không phải một sự tình cờ. Các phần ở trên được lập khóa theo một tên mà bạn có thể import, nên một điều kiện chỉ được khai báo trong một package mà bạn không thể import — và cũng không được tái xuất ở bất kỳ nơi nào bạn có thể import — không có gì để đặt vào cột bên trái của chúng. Bảng này được lập khóa theo mã ngắn, và mọi điều kiện đều có một mã, nên không điều kiện có thể báo cáo nào nằm ngoài bảng. Một mã ngắn bạn đang có sẽ được tra ra ở đây, bất kể điều kiện đằng sau nó có hay không có một accessor mà bạn có thể so khớp.
Điều làm một điều kiện có mặt trong bảng này là trình biên dịch thực sự có thể báo cáo điều kiện đó. Các hàng được suy ra từ mã nguồn chứ không phải chép tay vào: một điều kiện xuất hiện ở đây vì có thứ gì đó trong trình biên dịch phát sinh ra nó, nên mọi mã ở cột bên trái đều là mã mà aggrega có thể in ra. Đó là cam kết của bảng, và chính điều đó cho phép bạn đọc một hàng như một phép kiểm tra thực sự được chạy.
Ngoại lệ có chủ ý là một điều kiện được khai báo trước khi mã nguồn báo cáo nó tồn tại, để mã và cách diễn đạt được cố định từ trước và không bao giờ thay đổi đối với người đọc đã trích dẫn chúng. Một điều kiện như vậy nói rõ điều này trong một ghi chú ngay bên dưới bảng. Nó được liệt kê chứ không bị ẩn — một mã bạn đang có phải luôn tra ra được — và ghi chú bên cạnh cho bạn biết rõ rằng chưa có bản build nào phát sinh ra nó, và cần có gì trước khi một bản build làm vậy.
Một số đã ngừng sử dụng cũng được liệt kê, trong nhóm ghi chú riêng bên dưới bảng, và được liệt kê vĩnh viễn. Đôi khi một điều kiện bị rút lại — nó được thay bằng một điều kiện bao quát hơn, hoặc chưa từng có gì báo cáo nó — và từ thời điểm đó số của nó bị ngừng sử dụng: số đó không bao giờ được cấp cho một điều kiện khác, nên một mã ngắn bạn trích từ một báo cáo cũ chỉ có thể chỉ định đúng điều mà nó chỉ định khi báo cáo được viết. Cam kết đó mang tính cơ học chứ không phải biên tập. Một điều kiện được khai báo dưới một số đã ngừng sử dụng sẽ bị từ chối trước khi trình biên dịch đọc bất kỳ đầu vào nào, ở mọi lần chạy, nên không bản phát hành nào có thể chứa nó — cùng loại từ chối mà hai điều kiện đang hoạt động cố dùng chung một số sẽ gặp, được diễn đạt để bạn phân biệt được mình gặp trường hợp nào. Ghi chú cho một mã đã ngừng sử dụng cho bạn biết mã đó từng chỉ định gì, nếu việc ngừng sử dụng có ghi lại điều đó, và, khi điều kiện đã được thay thế, mã nào hiện báo cáo phạm vi đó.
Việc không bao giờ dùng lại một số cũng là điều tạo ra những khoảng trống vĩnh viễn trong dãy số, và các ghi chú là thứ giúp đọc hiểu những khoảng trống đó. Bản thân một số bị thiếu không chứng minh điều gì: nó có thể đã ngừng sử dụng, và cũng có thể là một số chưa có gì dùng đến. Các ghi chú là bản ghi về những số nào đã ngừng sử dụng và, nếu có ghi lại, mỗi số từng chỉ định gì, nên một mã không tra ra được cả hàng lẫn ghi chú là mã mà trình biên dịch này chưa bao giờ cấp.
Mã ngắn được cố ý làm cho không mang nghĩa: bản thân bốn chữ số không nói gì về một điều kiện, đó là cái giá của một định danh đủ ngắn để đọc to, gõ vào ô tìm kiếm hoặc dán vào một báo cáo. Bảng đối chiếu bên dưới là thứ làm cho nó dùng được. Một số được cấp một lần, từ một dãy tăng dần duy nhất, và được cố định từ đó; nó không nói gì về điều kiện mà nó chỉ định. Vì vậy mã ngắn là một định danh và không gì hơn — giá trị của nó không phải là một sự phân loại, và cả nó lẫn bất kỳ cách nhóm nào bạn có thể nhận thấy trong bảng đều không chỉ ra một điều kiện nằm ở đâu hay nói về điều gì.
Bảng không có cột danh mục, và đó không phải là một thiếu sót: danh mục là thuộc tính của một lỗi cụ thể chứ không phải của điều kiện đằng sau nó. Một số điều kiện thuộc về một danh mục ngay từ cấu trúc. Với các điều kiện khác, danh mục phụ thuộc vào loại thực thể mà lỗi liên quan, nên một điều kiện như vậy khi được báo cáo một lần đối với một Aggregate và một lần đối với một Release sẽ mang danh mục khác nhau mỗi lần — và một giá trị duy nhất ghi bên cạnh điều kiện ở đây sẽ sai với mọi điều kiện thuộc loại thứ hai đó.
Các danh mục được giải thích tại error-translation.md — từng danh mục, ý nghĩa của nó, và nơi cần sửa lỗi. Danh mục và mã ngắn trả lời những câu hỏi khác nhau về cùng một lỗi: danh mục xác định bề mặt mà việc sửa lỗi thuộc về, còn mã ngắn xác định điều kiện nào đã dừng bản build. Không cái nào suy ra được từ cái kia, đó là lý do mỗi cái có danh sách công bố riêng — và vì sao một lỗi không có bề mặt soạn thảo nào để chỉ ra vẫn mang một mã mà bạn có thể tra ở đây.
| Mã | Điều kiện | Thông báo |
|---|---|---|
E0001 | no-plugin-resolution-configured | cliplugin: no plugin resolver configured |
E0003 | malformed-attachment-requirement | malformed attachment requirement |
E0004 | overridden-annotation | annotation contribution overridden by an explicit value |
E0005 | policy-violation | policy violation |
E0006 | required-slot-unfilled | required attachment slot unfilled |
E0007 | selector-violation | selector violation |
E0008 | slot-selector-unsatisfied | attachment slot selector unsatisfied |
E0009 | pipeline-contract-violation | pipeline step typed-I/O contract violation |
E0010 | pipeline-step-failed | pipeline step failed |
E0011 | pipeline-target-absent | pipeline patch targets a document not present in the set |
E0012 | pipeline-target-opaque | pipeline patch targets an opaque (non-structured) unit |
E0013 | feature-type-mismatch | feature type mismatch between Aggregate and Release |
E0014 | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
E0015 | uses-inject-forbidden | uses-edge inject dictates a delivery mechanism the socket does not permit |
E0016 | patch-test-operation-failed | jsonpatch: test operation failed |
E0017 | annotation-injection-rejected | annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys |
E0018 | policy-settings-invalid | policy attachment settings do not satisfy the plugin's declared settings schema |
E0019 | endpoint-requires-reference-form | endpoint requires form: reference |
E0020 | invalid-cron-schedule | schedule is not a valid cron expression |
E0021 | persistent-template-requires-stateful-form | persistentTemplate volume requires form: stateful |
E0022 | pipeline-patch-target-not-structured | pipeline PATCH target is not parseable structured YAML/JSON |
E0023 | reference-form-requires-endpoint | form: reference requires an endpoint |
E0024 | schedule-requires-scheduled-form | schedule requires form: scheduled |
E0025 | scheduled-form-requires-schedule | form: scheduled requires a schedule |
E0026 | artifact-content-mismatch | imported artifact content does not match the digest recorded for it in entity.lock |
E0027 | artifact-import-shape | artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>) |
E0028 | artifact-output-collision | artifacts output filename collision: two artifact outputs carry the same filename |
E0029 | artifact-pillar-not-declared | artifact template references a pillar the Recipe does not declare |
E0030 | artifact-library-entry-not-found | artifact-library import references a bundle not present in the ArtifactLibrary |
E0031 | artifact-library-not-found | artifact-library import references an ArtifactLibrary not present in the catalog |
E0032 | assembled-output-collision | assembled output collision: two contributors write the same output path |
E0033 | authored-assertion-failed | assertion failed |
E0034 | attachment-inject-key-collision | duplicate delivery key across attachment-inject and another inject source |
E0035 | boundary-assembly-not-provided | provider expected to assemble its dispatch group provides no boundary assembler |
E0036 | chart-name-mismatch | merged-path assembly has conflicting assembly-name annotation values |
E0037 | cross-provider-link-unsupported | cross-boundary link between endpoints rendered by different providers is not supported |
E0038 | derived-key-collision | derived name collision: one name is derived more than once in one key space |
E0039 | featurerecipe-template-invalid-field | FeatureRecipe template references a per-component-only field with executionScope: boundary |
E0040 | host-in-library-import | library $import: carries a registry host; reference the library by bare-name identity |
E0041 | instance-id-collision | multiple contributors share an instance ID at the same dispatch path |
E0042 | locals-forward-reference | locals entry references a sibling defined later in the same block |
E0043 | locals-unknown-reference | template references a key the locals block does not declare |
E0044 | mapping-entry-not-found | mapping-library import references an entry not present in the MappingLibrary |
E0045 | mapping-import-shape | valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>) |
E0046 | mapping-library-not-found | mapping-library import references a MappingLibrary not present in the catalog |
E0047 | orphan-cross-boundary-link-placeholder | assembled output retains an unresolved cross-boundary link placeholder |
E0048 | path-collision | dispatch path produced multiple provider outputs |
E0049 | path-template-invalid-field | path template references a field not in the documented allowlist |
E0050 | pipeline-host-scope-unavailable | pipeline /host operation from a step with no host component |
E0051 | pipeline-patch-targets-unassembled-fragments | pipeline PATCH targets an assembler provider's pre-assembly fragments |
E0052 | pipeline-target-not-emitted | pipeline PATCH targets a document the node did not emit |
E0053 | plugin-provider-incompatible | pipeline plugin is not compatible with the rendering provider |
E0054 | provider-node-input-invalid | provider rejected node input |
E0055 | provides-contract-unfulfilled | Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares |
E0056 | provides-evaluation-failed | provides template evaluation failed |
E0057 | provides-self-containment | provides block references a root outside the self-contained set |
E0058 | render-nondeterministic | provider render is not deterministic |
E0059 | self-inject-key-collision | duplicate delivery key across self-inject and uses-inject |
E0060 | template-unknown-root | template references a root the render context does not define |
E0061 | unknown-provider | unknown provider |
E0062 | custom-mechanism-has-no-mapping | custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping |
E0063 | workload-entry-not-found | workload-library import references an entry not present in the WorkloadLibrary |
E0064 | workload-import-shape | workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>) |
E0065 | workload-library-not-found | workload-library import references a WorkloadLibrary not present in the catalog |
E0066 | dangling-uses-target | uses edge target does not exist |
E0067 | active-toggle-not-a-boolean | active toggle did not resolve to a boolean |
E0068 | sub-aggregate-nesting-depth-exceeded | max sub-aggregate nesting depth exceeded |
E0069 | mutator-patch-rejected | mutator patch rejected |
E0070 | reexport-cycle | re-exported component alias forms a cycle |
E0071 | release-edge-retarget | release edge retargets a developer-declared edge |
E0072 | sub-aggregate-not-loadable | sub-aggregate load failed |
E0073 | sub-aggregate-name-collision | flattened node ID collision: rename one of the colliding instances so their flattened IDs differ |
E0074 | unbound-release-edge-config | release per-edge configuration has no edge to apply to |
E0075 | aggregate-not-in-canonical-form | aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) |
E0076 | unplaced-sub-module | sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components` |
E0077 | uses-target-not-active | uses edge target was pruned because its active toggle resolved to false |
E0078 | wasm-nested-producer-consumption-denied | producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call |
E0079 | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
E0080 | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
E0081 | wasm-diagnostic-severity-invalid | wasm: guest plugin returned a diagnostic whose severity the contract does not declare |
E0082 | wasm-guest-error | wasm: guest plugin reported an error |
E0083 | wasm-guest-panic | wasm: guest plugin panicked during call |
E0084 | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
E0085 | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
E0086 | wasm-plugin-exited | wasm: plugin invoked proc_exit |
E0087 | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
E0088 | wasm-plugin-version-mismatch | wasm: entity metadata.version does not match plugin describe() |
E0089 | all-versions-retracted | every published version this reference could select has been withdrawn |
E0090 | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
E0091 | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
E0092 | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
E0093 | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
E0094 | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
E0095 | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
E0096 | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
E0097 | no-importer-for-format | no importer plugin advertises the requested format |
E0098 | no-parser-for-format | no parser plugin advertises the requested format |
E0099 | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
E0100 | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
E0101 | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
E0102 | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
E0103 | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
E0104 | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
E0105 | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
E0106 | invalid-library-ref | resolve: invalid library reference URI |
E0107 | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
E0108 | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
E0109 | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
E0110 | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
E0111 | source-template-not-parsable | resolve: source-template parse error |
E0112 | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
E0113 | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
E0114 | unresolvable-uri | resolve: no entity in the catalog matches this URI |
E0115 | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
E0116 | constraint-type-mismatch | compactform: constraint not valid for declared type |
E0117 | escape-content-invalid | compactform: $jsonschema content invalid |
E0118 | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
E0119 | reference-unresolvable | compactform: $ref unresolvable |
E0120 | unknown-keyword | compactform: unknown keyword |
E0121 | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
E0122 | deprecated-entity | deprecation: build consumes a deprecated entity |
E0123 | not-docs-bundle | docscache: artifact is not a documentation bundle |
E0124 | page-not-found | docscache: page not found in documentation bundle |
E0125 | offline-egress | egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache |
E0126 | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
E0127 | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
E0128 | scheme-not-allowed | externalinputs: URL scheme is not allowed |
E0129 | store-corrupt | externalinputs: store blob mismatches its pinned record |
E0130 | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
E0131 | lockfile-invalid | lockfile: file failed schema validation |
E0132 | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
E0133 | cached-manifest-integrity | oci: cached manifest digest mismatch |
E0135 | fetch-integrity | oci: content digest mismatch |
E0136 | fetch-network-unreachable | oci: network unreachable |
E0137 | fetch-not-found | oci: artifact not found at remote source |
E0138 | fetch-unauthorized | oci: authentication required or failed |
E0139 | immutable-tag-conflict | oci: tag already published with different content |
E0140 | no-content-layer | oci: manifest has no layer of the expected content media type |
E0141 | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
E0142 | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
E0143 | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
E0144 | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
E0145 | plugin-entity-not-found | plugin reference is not a Plugin entity |
E0146 | reference-cycle | circular reference expansion |
E0147 | malformed-trust-policy | registrytrust: advertised trust config is malformed |
E0148 | no-trust-advertised | registrytrust: registry advertises no trust config |
E0149 | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
E0150 | attachment-slot-shape | attachment does not conform to its declared slot shape |
E0151 | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
E0152 | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
E0153 | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
E0154 | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
E0155 | inject-key-collision | duplicate delivery key across inject sources |
E0156 | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
E0158 | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
E0160 | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
E0161 | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
E0162 | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
E0163 | missing-required-socket | required uses socket not populated |
E0164 | parameter-contract-violation | parameter contract violated |
E0165 | parameter-missing | required parameter not supplied |
E0167 | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
E0168 | schema-conformance | authored pillar does not conform to its declared schema |
E0169 | self-inject-forbidden | self-inject on component without spec.inject allowlist |
E0170 | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
E0171 | unknown-uses-socket | unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare |
E0172 | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
E0173 | unread-parameter | declared parameter is read by no reference in the Aggregate |
E0174 | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
E0175 | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
E0176 | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
E0177 | no-signature-found | signing: no signature found for an artifact that requires one |
E0178 | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
E0179 | signature-invalid | signing: signature does not verify |
E0180 | signature-verification-failed | signing: signature bundle does not verify |
E0181 | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
E0182 | trust-root-not-loadable | signing: cannot load pinned trust root |
E0183 | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
E0184 | unsupported-key | signing: unsupported held-key type |
E0185 | untrusted-identity | signing: signature identity is not trusted for this registry |
E0186 | unknown-source-kind | no source adapter serves the source kind |
E0187 | empty-workspace-root | cacheslot: empty workspaceRoot |
E0188 | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
E0189 | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
E0190 | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
E0191 | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
E0192 | document-nesting-depth-exceeded | a document nests too many levels deep |
E0193 | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
E0194 | template-not-found | schemalibrary: template not found |
E0195 | template-param-missing | schemalibrary: template parameter missing |
E0196 | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
E0197 | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0198 | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
E0199 | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
E0200 | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0201 | assertion-name-collision | assertion name declared twice across the extends chain |
E0202 | cyclic-extension | cyclic extends chain |
E0204 | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
E0205 | extends-merge-failed | inheritance merge failed |
E0207 | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
E0208 | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
E0209 | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
E0210 | recipe-no-input-kind | Recipe: at least one input kind required |
E0211 | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
E0212 | slot-not-referenceable | workload attachment slot is not referenceable |
E0213 | workload-features-schema | workload featuresSchema cross-check failed |
E0214 | workload-not-valid | workload validation failed |
E0215 | entity-envelope-invalid | document envelope validation failed |
E0216 | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
E0218 | schema-not-resolvable | validator/jsonschema: schema resolution failed |
E0220 | extends-chain-too-deep | extends chain exceeds maximum depth |
E0221 | schema-merge-input-invalid | merger: invalid merge input |
E0222 | ambiguous-registry-alias | registry alias matches more than one host |
E0223 | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
E0224 | workspace-config-invalid | workspace configuration is invalid |
E0225 | duplicate-provider-target | capability is bound to more than one provider plugin |
E0226 | duplicate-registry-alias | registry alias is already used by another host |
E0227 | governance-role-invalid | a governance attachment declares no role or an unknown role |
E0228 | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
E0229 | position-out-of-range | position out of range |
E0246 | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
E0247 | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
E0248 | wasm-output-shape | wasm: guest plugin returned an output that is not the shape the socket reads |
E0250 | nest-segment-not-one-directory | provider named a directory for each contributor's own sub-directory that is not a single directory name |
E0251 | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
E0252 | artifact-library-file-escapes-key | artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under |
E0253 | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
E0254 | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
E0255 | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
E0256 | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
E0257 | schema-contract-compile-failure | declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation |
E0259 | boundary-scope-attachment-not-declared-at-a-boundary | attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it |
E0260 | unplaced-component | component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates` |
E0261 | unresolved-boundary-component | boundary names a component the composition does not hold: correct the name, or remove the entry |
E0262 | unusable-component-identity | component identity cannot be the name its emitted resources are stamped with: rename the component |
E0263 | component-identity-target-refuses | the target will not accept a name derived from this component's authored identity: rename the component |
E0264 | provider-refused-every-component-identity | provider guest never accepted a component identity the compiler composed for it |
E0265 | unsupported-input-kind | provider does not support the node's input kind |
E0266 | unusable-schema-import | a schema `$import:` could not be applied |
E0267 | unknown-schema-pillar | a schema block declares a key that names no data pillar |
E0268 | pipeline-patch-unit-not-carved | reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens |
E0269 | provider-render-duplicate-path | provider guest returned two output files under one path; a conforming guest returns each output path at most once |
E0270 | link-patch-file-not-emitted | link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned |
E0271 | pipeline-emit-file-absent | emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content |
E0272 | pipeline-side-effect-kind-undefined | side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd |
E0273 | rendered-name-unavailable | template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies |
E0274 | verdict-plugin-identity-changed | the plugin identity recorded as trusted no longer matches what this resolution reports |
E0275 | edit-refused-invalid-result | the edit was refused because the resulting document would not be valid, and nothing was written |
E0276 | schema-evolution | the version being published changes the published predecessor in a way the documented evolution rubric objects to |
E0277 | annotation-prefix | an annotation key on the entity uses a prefix the platform reserves |
E0278 | name-shape | the entity's name does not follow the documented name shape for its kind |
E0279 | dynamic-refs | a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow |
E0280 | id-overrides | a schema in the entity declares an identifier of its own, where the platform owns that schema's identity |
E0281 | category-matches-directory | the entity's category label does not match the category directory the entity is filed under |
E0282 | x-aggrega-discouragement | the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema |
E0283 | plugin-default-limits | the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply |
E0284 | secret-slot-declares-sensitive | an attachment slot admits only secret material and does not declare that it handles it |
E0285 | provides-declared-by-component | the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused |
E0286 | publish-bump-below-classification | the version bump being published is smaller than the evolution check's classification of the change requires |
E0287 | import-halting-diagnostic | the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files |
E0288 | plugin-cannot-express-input | a plugin has no expression for a construct this build declares |
E0289 | plugin-required-input-unresolved | a plugin could not resolve something it requires to exactly one value |
E0290 | plugin-output-name-collision | two things a plugin produced occupy one name in its output |
E0291 | plugin-value-not-representable | a plugin has no representation for a value it was given |
E0292 | plugin-failure-unclassified | a plugin reported a failure that none of the declared kinds names |
E0293 | wasm-guest-condition-undeclared | wasm: guest plugin named a condition the socket does not declare |
E0294 | subsystem-component-identity-collision | components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity |
E0295 | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
E0296 | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
E0297 | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
E0298 | bundle-no-entity-document | oci: published bundle carries no entity document |
E0299 | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
E0300 | bundle-unreadable | oci: published bundle cannot be unpacked |
E0301 | published-artifact-not-an-entity | oci: published artifact is not an entity document |
E0302 | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
E0303 | entity-shares-its-directory | the entity shares its directory with another entity, and an entity of its kind has a directory of its own |
E0304 | content-outside-entity-directory | a path names content outside the entity's own directory |
E0305 | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
E0306 | plugin-artifact-not-found | plugin artifact not found on this machine |
E0307 | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
E0308 | conflicting-features-reach-one-component | a Feature reaches a component alongside a Feature it declares a conflict with |
E0309 | symbolic-link-in-entity-files | a symbolic link sits among the files an entity carries |
E0310 | offline-registration-without-trust-policy | a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>` |
E0311 | malformed-version-pin | reference carries a malformed version pin |
E0312 | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
E0313 | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
E0314 | plugin-built-from-uncommitted-changes | plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports |
E0315 | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
E0316 | connection-attachment-written-off-its-connection | a Release attachment takes the name of an attachment one of a component's connections carries |
E0317 | release-connection-attachment-untyped | a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes |
E0318 | attachment-inject-mapping-key-collision | duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered |
E0319 | duplicate-connection-alias | connection alias is already used by another connection of the same component |
E0320 | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
E0321 | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
E0323 | caller-render-facts-not-declared | template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts |
E0324 | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
E0325 | provider-render-fact-not-list | provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entry |
E0326 | pipeline-step-reads-caller-render-facts | pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render facts |
E0327 | index-of-absent-map-key | template indexes a map with a key the map does not hold |
E0328 | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
E0329 | connection-credential-matches-target-key | a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one |
E0330 | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
E0331 | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
E0332 | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
E0333 | recorded-signature-out-of-date | signing: a recorded signature is not the one a pull would record |
E0334 | omit-matched-nothing | an omits entry left out nothing the source rendered |
E0335 | unsupported-omits | provider does not support omits |
E0336 | omit-report-mismatch | a provider's omitted counts do not match the omits entries it was handed |
E0337 | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
E0338 | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
E0339 | ambiguous-import-format | more than one importer recognises the source |
E0340 | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
E0341 | importer-declares-no-file-patterns | the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory |
E0342 | import-directory-matched-nothing | no file in the directory matches the file patterns the importer serving the source's format declares |
E0343 | import-source-name-collision | a file read from the directory and a file named in the importer's `with.sources` have the same name |
E0344 | windows-unusable-entry | an entry this publication carries cannot be used on Windows |
E0345 | duplicate-container-environment-variable | a container declares one environment variable twice |
E0346 | metrics-credential-annotation-matches-provides | a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential |
E0347 | target-render-facts-not-declared | template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts |
E0348 | pipeline-step-reads-target-render-facts | pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render facts |
E0349 | import-target-unbound | no Recipe in the workspace's catalog binds to the capability the import's target names |
E0350 | unrecognised-import-format | no importer recognises the source |
E0351 | unsupported-boundary-artifacts | provider does not support boundary artifacts |
E0352 | boundary-directory-not-beneath-output-root | boundary output directory does not name a directory beneath the output root |
E0353 | boundary-feature-name-not-a-directory | boundary-level Feature instance name is not a directory name |
E0354 | cross-boundary-link-value-not-copied | a template does more than copy a value it reads off a cross-boundary link |
E0355 | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
E0356 | suspend-requires-scheduled-form | suspend requires form: scheduled |
E0357 | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
E0358 | uses-target-not-exported | uses edge target names a component its module does not export |
E0359 | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
E0360 | netrc-file-unreadable | the netrc file could not be read |
E0361 | source-url-carries-credential | the source URL carries a credential |
E0362 | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
E0363 | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
E0364 | value-template-execution-failed | a value template failed while it ran |
E0365 | boundary-contribution-not-assembled | boundary-level Feature's output is routed to a dispatch path nothing assembles |
E0366 | inject-mapping-output-not-parsable | FeatureRecipe injectMapping output could not be read as a dictionary of deliveries |
E0367 | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
E0368 | inject-mapping-output-key-not-delivered | FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads |
E0369 | absent-path-read-and-iterated | template reads a path as a value and iterates it, and the data holds nothing at that path |
E0370 | duplicate-pipeline-step-id | a pipeline declares one step id twice |
E0371 | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
E0372 | attachment-inject-value | inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block |
E0373 | retired-api-version | a document declares an API version this compiler no longer reads |
E0374 | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
E0375 | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
E0376 | no-answer-in-time | egress: the server did not answer in time |
E0377 | repository-listing-too-long | registry: the repository listing did not end in time |
E0378 | registry-too-busy | oci: the registry kept asking to slow down |
E0002đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một lần tra cứu catalog thất bại trong khi các hợp đồng tĩnh của đồ thị được kiểm tra — một lỗi trong trình biên dịch chứ không phải trong một tài liệu được soạn — và điều kiện phát sinh khi một bản build phân giải một kiểu component mà catalog nó đọc khi đó không có mục nào sẽ báo cáo trạng thái đó hiện nay, với mã làE0154.E0134đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một thực thể có thể xuất bản mà thư mục không được đặt tên theo phiên bản mà thực thể khai báo; việc xuất bản không xét tên thư mục, và điều kiện phát sinh khi một thực thể dùng chung thư mục với một thực thể khác trong khi kind của nó có thư mục riêng làE0303.E0157đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một khóa Aggregate — tên instance của một component, feature, subsystem hoặc module lồng nhau — không khớp với mẫu tên soạn thảo. Mọi bề mặt khóa đó đều bị ràng buộc vào cùng cách viết ấy bởi schema của Aggregate, schema này từ chối tài liệu khi xác thực phần bao của nó và báo cáo khóa vi phạm kèm dòng và cột; mã của điều kiện đó làE0215.E0159đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một tham chiếu đích mà các đoạn phân tách bằng dấu chấm không phải đều khớp với mẫu tên instance, và chưa bản build nào báo cáo nó trước khi điều kiện bị rút lại.E0166đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định tệp màparameters: { $import: … }của một Release trỏ tới khi tệp đó không đọc được hoặc nội dung của nó không phân tích được; một tệp không cho ra tài liệu nào là một điều kiện duy nhất bất kể đường dẫn được viết ở đâu, và mã của nó làE0175.E0203đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một FeatureRecipe trên capabilityevalkhai báo một nguồn, một lớp phủ values, một workload hoặc artifact; capability đó đã bị rút lại, và hiện không có gì báo cáo trạng thái này.E0206đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một Recipe trên capabilityevalkhai báo một nguồn, một workload, artifact hoặc một lớp phủ values; capability đó đã bị rút lại, và một Recipe không khai báo thứ nào trong số đó bị từ chối trên mọi capability dưới mãE0210.E0217đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một lỗi xác thực schema không thể báo cáo theo một trường cụ thể, và chưa bản build nào báo cáo nó trước khi điều kiện bị rút lại.E0219đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một chuỗiextendscó vòng lặp, được báo cáo bởi một lượt duyệt chuỗi tách biệt với bước kết hợp của việc hợp nhất schema; một lượt duyệt chuỗi duy nhất báo cáo mọi chuỗi có vòng lặp, và mã của nó làE0202.E0230đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này chỉ định đã bị rút lại, và không bản build nào báo cáo nó.E0231đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này chỉ định đã bị rút lại, và không bản build nào báo cáo nó.E0232đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này chỉ định đã bị rút lại, và không bản build nào báo cáo nó.E0233đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này chỉ định đã bị rút lại, và không bản build nào báo cáo nó.E0234đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ một nguồn Recipe là chuỗi rỗng, được báo cáo khi kết xuất qua provider compose; giờ đây một điều kiện duy nhất áp dụng cho mọi provider báo cáo trường hợp đó, và mã của nó làE0251.E0235đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0236đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0237đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0238đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0239đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0240đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0241đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0242đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ một nguồn Recipe là chuỗi rỗng, được báo cáo khi kết xuất qua provider Helm; giờ đây một điều kiện duy nhất áp dụng cho mọi provider báo cáo trường hợp đó, và mã của nó làE0251.E0243đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0244đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0245đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0249đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0258đã được loại bỏ: hiện không còn gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Điều kiện mà số này từng chỉ đã bị rút lại, và không bản build nào báo cáo nó.E0322đã ngừng sử dụng: hiện không có gì báo cáo nó, và số này không bao giờ được cấp cho một điều kiện khác. Nó từng chỉ định một giá trị mà một Feature gắn vào một boundary tính cho môi trường của một component dưới một khóa mà một attachment khác đã phân phối. Một Feature gắn vào một boundary chỉ phân phối vào một component thông qua injectMapping của FeatureRecipe của nó, và một ánh xạ ghi một khóa mà attachment khác đã phân phối được báo cáo dướiE0318.
Hướng dẫn so khớp
Vị từ errors.Is duyệt qua chuỗi bao bọc, nên việc so khớp sentinel vẫn hoạt động ngay cả khi lỗi bị bao bọc nhiều lần trên đường trả về cho bạn. Hãy so khớp với lỗi mà một hàm được xuất trả về:
package release
import ( "errors" "fmt"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver" "github.com/aggrega-ai/aggrega-cli/pkg/validator/envelope")
// Load reads a Release and reports the distinct failures a caller handles// differently.func Load(path string) error { _, err := resolver.LoadRelease(path) switch { case errors.Is(err, envelope.ErrEntityEnvelope()): return fmt.Errorf("%s is not a Release: %w", path, err) case errors.Is(err, resolver.ErrYAMLLoad()): return fmt.Errorf("%s could not be read as YAML: %w", path, err) case err != nil: return err } return nil}Không có điểm vào được xuất nào chạy toàn bộ một bản build, nên việc so khớp bằng errors.Is áp dụng cho mã gọi trực tiếp các gói này. Để chặn CI dựa trên một bản build, hãy chạy aggrega build và đọc trạng thái thoát cùng các chẩn đoán của nó: văn bản thông điệp của chúng được liệt kê trong fatal-halts.md, danh mục của chúng trong error-translation.md, và mã ngắn trong phần đầu đặt trong ngoặc vuông của chúng được tra cứu trong bảng mọi điều kiện trên trang này.
Hai con đường chặn tồn tại vì ba định danh vươn tới những khoảng cách khác nhau. Một cổng chặn viết bằng Go liên kết các gói này, so khớp sentinel, và có thể đọc bất kỳ mã nào từ bất kỳ lỗi nào nó nắm giữ. Một cổng chặn viết bao quanh lệnh có trạng thái thoát và văn bản được in ra — và văn bản được in ra nêu tên điều kiện, vì mã ngắn nằm trong phần đầu đặt trong ngoặc vuông. Vì vậy, một cổng chặn như thế dựa vào mã ngắn đó thay vì cách diễn đạt của thông điệp, còn các góc nhìn theo thông điệp vẫn là cách để truy ngược từ cách diễn đạt mà nó đã có. Hãy so khớp sentinel từ Go; dựa vào mã ngắn khi bao quanh lệnh; đọc mã mô tả từ chẩn đoán có cấu trúc khi một client dùng giao thức đó.
Các sentinel được khai báo trong các gói khác nhau với cùng một tên ngắn là những điều kiện riêng biệt, không phải hai cách viết của một điều kiện: errors.Is phân biệt chúng theo danh tính, nên một phép so khớp với cái này không khớp với cái kia. Các bản xuất lại được nêu rõ trong các bảng là ngoại lệ, và chúng được nêu rõ chính vì đó là trường hợp hai tên thực sự khớp nhau. Hãy so khớp với tên trong gói mà các bảng liệt kê nó, và coi một tên ngắn đứng riêng là mơ hồ.
Đối với danh mục chẩn đoán hướng tới người dùng (các thông điệp mà nhà phát triển thấy trong terminal khi một bản build dừng lại), xem fatal-halts.md. Đối với danh mục cảnh báo tư vấn (đầu ra không gây dừng warning:, lint: và notice:), xem warnings.md. Đối với phân loại tiền tố danh mục ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), xem error-translation.md.