Hata sentinel'leri — kanonik başvuru
Derleyicinin verdiği her ölümcül durdurma bir koşulu adlandırır ve her koşul üç tanımlayıcı taşır; çünkü bir koşulu tanımak, kaydetmek ve aktarmak üç ayrı iştir. Sentinel, bildiren paketin dışa aktardığı erişimci çağrılarak elde edilen ve errors.Is ile eşleşen Go değeridir: Go kodunun tanıdığı tanımlayıcıdır. Kod, koşulun altında kaydedildiği dizedir: koşulun kendisini sözcüklerle adlandırır ve çevresindeki Go paketleri geliştikçe sabit kalan odur — bir programın kaydettiği tanımlayıcıdır. Kısa kod, E harfi ve dört rakamdır; sesli okunacak, bir aramaya yazılacak ya da bir rapora yapıştırılacak kadar kısadır: bir kişinin aktardığı tanımlayıcıdır. Tek koşul, üç tanımlayıcı — koşulu Go’dan tanımak için sentinel ile eşleştirin, kaydetmeniz ya da ona göre anahtarlamanız gerektiğinde kodu okuyun ve bir kısa kodu bu sayfanın ilerisindeki tüm koşullar tablosunda çözümleyin.
Kullanıcıya yönelik tanılama (fatal-halts.md ve error-translation.md içinde kataloglanan önekli ileti) geliştiriciye yönelik metni taşır; sarmalanmış sentinel ise programatik tüketicilerde errors.Is ile eşleştirilen değerdir.
Bu sayfa, kataloğun sentinel anahtarlı görünümüdür. Hata türlerini ayırt etmesi gereken CI denetimleri, IDE entegrasyonları ya da derleme düzenleme kodu yazan programcılar, burada listelenen sentinel’lerle standart errors.Is yüklemi aracılığıyla eşleştirme yapar. Verilen hata metnini okuyarak bir derlemede hata ayıklayan yazarlar genellikle ileti anahtarlı görünümleri ister — derlemeyi durduran hatalar için fatal-halts.md, bilgilendirici çıktı için warnings.md.
Aşağıdaki tablolardaki her satır bir erişimci adlandırır — tablonun adlandırdığı paketten dışa aktarılan, argüman almayan ve sentinel’i döndüren bir işlev. O paketi içe aktarıp erişimciyi çağırmak desteklenen entegrasyon yüzeyidir; tabloların her birini parantezleriyle yazmasının nedeni de budur — errors.Is ile eşleşebilecek bir değeri veren çağrıdır ve parantezsiz ad bir hata değil, bir işlevdir:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Üç tanımlayıcı kararlılıklarını ayrı ayrı taşır ve bir koşulun üçüne birden sahip olmasının nedeni bu ayrımdır. Aşağıda listelenen erişimciler yama sürümleri boyunca kararlıdır; yeniden adlandırmalar ya da kaldırmalar, bunları yapan sürümün değişiklik günlüğü girdisinde duyurulur; bir paket içinde yeni bir erişimci eklemek eklemeli bir değişikliktir ve mevcut eşleştiricileri bozmaz. Bir kod, koşulu yayımlandıktan sonra sabittir; bu nedenle bir koşulun kalıcı olarak adlandırılması gereken her yerde kaydedilecek tanımlayıcı odur: bir erişimciyi yeniden adlandırmak, koşulunun altında kaydedildiği kodu değiştirmez ve kaydettiğiniz bir kod Go yüzeyinin yeniden düzenlenmesinden sonra da geçerli kalır. Kısa kod üçünün en kalıcı olanıdır: bir numara bir kez verilir ve sonra sabitlenir; emekliye ayrılmış bir koşulun numarası başka bir koşula verilmek yerine emekli kalır; böylece eski bir raporda kaydedilmiş bir kısa kod, kaydedildiği zaman adlandırdığı koşulu adlandırmaya devam eder. Bu yalnızca amaçlanan değil, uygulanan bir durumdur — emekliye ayrılmış bir numara altında bildirilen bir koşul, her çalıştırmada, derleyici herhangi bir girdiyi okumadan reddedilir — ve emekliye ayrılmış her numara, tüm koşullar tablosunda geçerli olanların yanında yayımlanır. Aşağıdaki kod sütunu kodu taşır ve yapılandırılmış tanılamanın bir istemcisinin bu paketleri bağlamadan okuduğu değer odur. Çıkarsanmak yerine yayımlanır, çünkü bulunduğu satırı yinelemesi gerekmez — yeniden dışa aktarılan bir ad, yönlendirdiği koşulun kodunu bildirir ve bir kuralın kodu erişimciyi değil kuralı adlandırır. İleti sütunu, sentinel’in oluşturduğu birebir metindir; kullanıcıya yönelik tanılama bu metnin önüne köşeli parantezli bir başlık ve kaynak konumunu koyar. Bu başlık koşulun kısa kodunu, oluşumun bir kategorisi varsa onu da yanında taşır; örneğin [DEVELOPER_ERROR E0007] — böylece okuyucu her birini bağımsız olarak çözümleyebilir: kategoriler (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) error-translation.md içinde anlatılır ve kısa kodlar bu sayfadaki tüm koşullar tablosunda çözümlenir. Koşulu bir plugin oluşturduğunda, kod belirteci onu oluşturan plugin ile nitelenir — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — ve kısa kod son bölümdür; niteleyicinin neden orada olduğu ve neden çözümlenmesi gerekenin son bölüm olduğu error-translation.md içinde açıklanır.
Bir koşulun kodunu okuma
Bir kod, koşulu adlandırır ve başka hiçbir şeyi adlandırmaz; kebab-case biçimindedir: parameter-contract-violation, lockfile-drift. Hiçbir önek taşımaz: ne onu bildiren paketi, ne onu üreten aşamayı, ne de herhangi türden bir gruplamayı. Böylece derleyici çevresinde yeniden düzenlendiğinde kod aynı kalır ve bir derlemede birden fazla noktada üretilen bir koşulun yine tek bir adı olur. Her koşulun adı kendi başına benzersizdir; öneki gereksiz kılan budur ve iki koşul tek bir kod altında kaydedilemez. Kodu bir hatadan github.com/aggrega-ai/aggrega-cli/pkg/errors paketindeki CodeOf ile okuyun; bu işlev sarmalama zincirini errors.Is gibi dolaşır, böylece hata size dönerken onu kaç çerçeve sarmalamış olursa olsun kod korunur. Bu paketin kendi adı da errors olduğundan, bir içe aktarma takma adı onu standart kitaplıktan ayrı tutar:
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 ayrıca zincirdeki herhangi bir hatanın bir kod taşıyıp taşımadığını da bildirir; hiç kod taşımayan bir zincir, bir başarısızlık değil, o zincirle ilgili bir olgudur. Arayüzü kendiniz eşleştirmeyi tercih ederseniz, aynı paket onu CodedError olarak dışa aktarır ve errors.As onu aynı dolaşımda bulur.
Bir kod tek yönde ilerler. Kod, bir koşulun bildirdiği şeydir; onu bir eşleştiriciye tanıtan şey asla değildir: dizeyi kendi kodunuza yazmak size bir dize verir ve bir dizeden errors.Is’in eşleştirdiği değere geri dönen bir yol yoktur. Bir koşulu tanımak için sentinel’i eşleştirin; bir koşulu kaydetmek için kodu okuyun.
aggrega’nın terminalde yazdırdığı kod bu değil, kısa koddur. Durduran bir tanılama, koşulun kısa kodunu taşıyan köşeli parantezli bir başlıkla açılır; oluşumun bir kategorisi varsa kategori de yanında yer alır: [DEVELOPER_ERROR E0007], koşulu bir plugin ürettiğinde ve kod onu üreten plugin ile nitelendiğinde [TRANSLATION_ERROR provider/example:1.0.0/E0007] ya da başarısızlığın sizi yönlendireceği bir ilgi alanı olmadığında [E0007]. Ardından kaynak konumu ve fatal-halts.md içinde kataloglanan mesaj metni gelir. Açıklayıcı kod, koşulu sözcüklerle adlandırır ve bu konum için fazlasıyla geniştir: en uzun koşullarda, mesaj başlamadan dar bir terminali doldururdu; ikinci, kısa bir tanımlayıcının var olmasının tüm nedeni budur. Dolayısıyla elinizde yalnızca yazdırılmış çıktı varken üzerinde çalışacağınız belirteç kısa koddur ve bu kod, bu sayfanın ilerisindeki her koşulun tablosu üzerinden çözümlenir: telefonda okuyabileceğiniz bir numaradan koşula, onun erişimcisine ve mesaj metnine ulaşırsınız. aggrega explain <code> bu çözümlemeyi terminalde yapar: koşulun iki kodundan birini alır ve koşulu, yazım düzeltmesini belgeleyen girdiyle birlikte yazdırır; aggrega explain içinde açıklanmıştır. Bir tanımlayıcı yerine ifadeden yola çıkmanın yolu yine fatal-halts.md içindeki mesaja göre düzenlenmiş görünümlerdir.
Bir kodun Go dışına çıktığı yer, hizmet olarak derleyici arka plan sürecinin yayımladığı yapılandırılmış tanılamadır; burada kod, mesaj metnine katılmış bir şey olarak değil, her girdide kendine ait bir code alanı olarak yer alır. Böylece bir düzenleyici uzantısı ya da o protokolün başka herhangi bir istemcisi, bu paketleri bağlamadan ve düzyazı ayrıştırmadan bir girdinin bildirdiğine göre dallanır. Bu tek anahtar, kim atamış olursa olsun makine tarafından eşleştirilebilir bir kod taşır ve girdi onu hangi katmanın ürettiğini belirtir. Oradaki bir kodun üç kaynağı vardır ve üçüncüsü, bu sayfada arayabileceğiniz bir kodun kendi başına bir şeyin başarısız olduğunun işareti olmamasının nedenidir:
- Bir başarısızlığın adlandırdığı koşulun kodu; bu sayfanın katalogladığı budur.
- İşlenmiş çıktıya ilişkin bir uyarının sınıf kodu:
unsupported-fieldbunlardan biridir ve warnings.md onu açıklar. Bir koşul olarak kaydedilmek yerine uyarının üretildiği yerde atanır, bu yüzden burada bir satırı yoktur. - Yazılmış belgelere ilişkin bir uyarının kayıtlı kodu: bildirilmiş bir addan tek düzenleme uzaklıktaki bir ad, hiçbir şeyin okumadığı bir parametre. Böyle bir bulgu, bir koşulu bir başarısızlıkla aynı biçimde adlandırır; bu yüzden kodu kayıtlıdır ve bu sayfada bir satırı vardır; o satırı okumak size bulgunun ne hakkında olduğunu söyler.
Dolayısıyla bir durmadan okuyacağınız aynı kod, tamamlanmış bir derlemeden de, sonuçta hiçbir şeyi değiştirmemiş bir bulgu tarafından taşınarak size ulaşabilir. İkisini ayıran, size verilen sonuç ve girdinin adlandırdığı katmandır; asla kodun kendi biçimi değil ve asla burada çözümlenip çözümlenmediği değil. Girdiyi üreten hiçbir şey bir kod atamadığında alan atlanır: Aggrega’nın kendi koşullarından hiçbirini adlandırmayan bir başarısızlık ve üreticisi kod atamamış bir uyarı. aggrega serve girdi biçimini, katmanı adlandıran anahtarı ve alanın ne zaman bulunduğunu belgeler.
Yapılandırılmış bir tanılama, bir koşulun her iki tanımlayıcısını da taşır ve hangisinin hangisi olduğunu bilmek, üzerinde işlem yapabileceğiniz bir tanımlayıcı ile yapamayacağınız bir tanımlayıcı arasındaki farktır. Yukarıdaki code anahtarı bir program içindir: tirelidir ve koşulu sözcüklerle adlandırır, böylece ona göre dallanan bir uzantı anlamını açıkça ifade eder; Go’da CodeOf’un bildirdiği değer de budur. Yanındaki shortCode anahtarı bir kişi içindir: E harfi ve dört rakam, durduran bir tanılamanın köşeli parantezli başlığında yazdırdığı belirtecin aynısı. Telefonda okuduğunuz, bir arama kutusuna yazdığınız ya da bir sorun kaydına yapıştırdığınız budur ve her koşulun tablosu bu belirtece göre düzenlenmiştir.
Hiçbiri diğerinin kısaltması değildir ve hiçbiri diğerinin yedeği değildir. Açıklayıcı koda göre eşleştirin; okuyucuya kısa olanı gösterin. Yalnızca açıklayıcı kodu sunan bir yüzey, bir yazara eşleştirici için tasarlanmış bir tanımlayıcı vermiş olur; kısa koda göre eşleştiren bir yüzey ise koşul hakkında hiçbir şey söylemeyen bir numaraya göre eşleştirmiş olur; birinin seçilmesi yerine ikisinin de taşınmasının nedeni budur.
Üçüncü bir anahtar olan codeDescription, koşulun yayımlandığı yeri taşır; tanılama hakkında daha fazlası için açılacak bir başvuru olarak. Adresi bu sayfadaki her koşulun tablosuna çözümlenir; böylece onu bir düzenleyiciden izleyen okuyucu, tablonun göre düzenlendiği kısa kod elinde olarak gelir. Bir girdi kısa kodu ve başvuruyu birlikte taşır ya da hiçbirini taşımaz: girdi kayıtlı bir koşulu, yani o tabloda satırı olan bir koşulu adlandırdığında ikisi de bulunur; kod bir uyarı sınıfını ya da Aggrega’nın bildirmediği, size ait bir linter’dan gelen bir uzlaşım kuralının kimliğini adlandırdığında ikisi de bulunmaz, çünkü bunlar için aktarılacak bir numara ve burada onları açıklayan bir şey yoktur.
Diğer yönde, yani elinizdeki bir koddan onun adlandırdığı koşula giderken, aşağıdaki tablolar yayımlanmış listedir. Her satır kodu, Go’da aynı koşulu veren erişimcinin yanında taşır; böylece yapılandırılmış bir tanılamadan okunan bir kod, eşleştirebileceğiniz bir ada ve koşulun oluşturduğu metne çözümlenir. Tablolar, erişimcisini içe aktarabileceğiniz koşulları kapsar ve iki tür kod bunların dışında kalır: bir koşul yerine bir uyarı sınıfını adlandıran ve bu yüzden yanına konacak bir erişimcisi olmayan sınıf kodu; ve koşulu yalnızca içe aktaramayacağınız bir pakette bildirilen ve hiçbir yerde yeniden dışa aktarılmayan, dolayısıyla yanına konacak eşleştirilebilir bir adı olmayan kod. Bu ikinci tür yine bir koşulu adlandırır ve o koşulun yine bir kısa kodu vardır: bu sayfanın ilerisindeki her koşulun tablosu, içe aktarılabilir bir ad yerine kısa koda göre düzenlendiğinden bunları da kapsar.
Bildiren pakete göre eşleştirilebilir yüzey
Aşağıdaki her bölüm, içe aktarabileceğiniz bir pakettir. Bölüm başlığı, github.com/aggrega-ai/aggrega-cli modül yoluna göre paket yoludur; dolayısıyla pkg/resolver başlıklı bölüm github.com/aggrega-ai/aggrega-cli/pkg/resolver olarak içe aktarılır.
Girdiler, sentinel’i bildiren pakete göre gruplanır, çünkü bir eşleştiricinin içe aktardığı paket odur. Koşulun bir derlemenin neresinde oluşturulduğu ayrı bir sorudur ve bu sayfa bu soruyu bilinçli olarak yanıtlamaz: tek bir sentinel sıklıkla birkaç yerden oluşturulur ve bazıları yalnızca modülün dışa aktarmadığı koddan oluşturulur; bu nedenle girdi başına verilen hiçbir yanıt her satır için doğru olmaz. Mesaja göre düzenlenmiş görünümler, derlemenin ne zaman sorusunu gözlemleyebileceğiniz terimlerle yanıtlar — başta fatal-halts.md.
Birkaç ad birden fazla pakette görünür. Bunlar iki ayrı koşul değil, paylaşılan tek bir değerin yeniden dışa aktarımlarıdır; bu nedenle iki addan biriyle eşleştirme başarılı olur. Her iki ad da içe aktarılabildiğinde tablolar bunu belirtir. Her iki satır da aynı kodu taşır; bu, Go dışındaki bir istemcinin elindeki tanımlayıcı üzerinden ifade edilen aynı olgudur: kaç ad ona ulaşırsa ulaşsın, tek koşul, tek kod.
pkg/catalog
| Sentinel | Kod | Mesaj |
|---|---|---|
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(),pkg/resolver.ErrManifestImplementsMismatch()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.
pkg/closure
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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(),pkg/refcycle.ErrCycle()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.
pkg/deprecation
| Sentinel | Kod | Mesaj |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinel | Kod | Mesaj |
|---|---|---|
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(),pkg/oci.ErrFetchNotFound()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.
pkg/egress
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity(),pkg/oci.ErrFetchIntegrity()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.ErrFetchNotFound(),pkg/oci.ErrFetchNotFound()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.
pkg/sourcekind
| Sentinel | Kod | Mesaj |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinel | Kod | Mesaj |
|---|---|---|
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(),pkg/oci.ErrFetchIntegrity()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.ErrFetchNetworkUnreachable(),pkg/oci.ErrFetchNetworkUnreachable()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.ErrFetchNotFound(),pkg/oci.ErrFetchNotFound()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.ErrFetchUnauthorized(),pkg/oci.ErrFetchUnauthorized()ile aynı değerdir; bu nedenle iki addan biriyle eşleştirme başarılı olur.
pkg/sourceresolver/cacheslot
| Sentinel | Kod | Mesaj |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinel | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
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 | Kod | Mesaj |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Başka bir sentinel taşıyan sentinel’ler
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata), bozuk bir kaynak yapıt önbellek yuvasını bildirir. Kendine ait bir kimlik olarak değil, ErrFetchIntegrity() çevresinde bir sarmalayıcı olarak bildirilmiştir; bu nedenle yukarıdaki tablolarda yer almaz ve ErrFetchIntegrity() ile yapılan bir eşleştirme onun için de başarılı olur. Bir sentinel bildirmek yerine bir sentinel’i sarmaladığı için işlev olarak değil, değer olarak dışa aktarılır: onu parantezsiz olarak ErrCacheMetadataInvalid biçiminde eşleştirin. O belirli koşulu istediğinizde sarmalayıcıyı, bütünlük sınıfının tamamını istediğinizde ise sarmalanan sentinel’i eşleştirin.
Tek bir pakette ikinci bir adla erişilebilen sentinel’ler
Bir paketin tek bir koşul için iki erişimci dışa aktardığı durumlarda (ikincisi birinciye yönlendirme olarak bildirilir), yukarıdaki tablolar bildiren erişimciyi içerir ve yönlendiren adı dışarıda bırakır. Her iki ad da aynı paketten dışa aktarılır; bu nedenle birine erişen bir içe aktarma diğerine de zaten erişir ve ikinci bir satır, yeni hiçbir şeyle eşleşmeyen bir ad altında tek bir koşulu iki kez listelemiş olurdu. Adlardan herhangi biriyle eşleştirme başarılı olur: yönlendirme, bildiren erişimcinin döndürdüğü değerin aynısını döndürür.
Bu, paketler arası durum değildir. Başka bir paketten yeniden dışa aktarılan bir sentinel, her paketin tablosunda bir satıra sahiptir; çünkü bu paketlerden birini içe aktaran bir eşleştirici, o paketi de içe aktarmadan diğerinin adına erişemez. Tek bir paket içindeki bir yönlendirme ise ikinci bir satır gerektirmez, çünkü tek bir içe aktarma her iki ada da erişir.
pkg/catalog içindeki ErrDuplicateRecipeIdentity() böyle bir yönlendirmedir: o paketin tablosunda yer alan ad olan ErrDuplicateEntityIdentity() değerini döndürür.
Eşleştirilebilir sentinel’i olmayan koşullar
Bazı derleme aşamaları sentinel’lerini derleyicinin dışa aktarmadığı paketlerde bildirir; bu nedenle errors.Is için başvurulacak bir şey yoktur ve bunlara karşı hiçbir eşleştirici yazılamaz. Bunlar tabloya dökülmek yerine burada açıklanır, çünkü bu sayfadaki bir tablo, sol sütunun başvurusu çözülebilir olduğuna dair bir sözdür.
Bunların tanılamaları, yayılan hata metni ve mesaja göre anahtarlanmış görünümler — özellikle fatal-halts.md — aracılığıyla size eksiksiz ulaşır; bunları tanımanın desteklenen yolu budur:
- Topoloji oluşturma (grafik oluşturma ve alt aggregate düzleştirme), yüklenemeyen bir alt Aggregate’i, ulaşılamayan Aggregate URI’sini adlandırarak; yapısal biçimi şemayla eşleşmeyen bir
uses:bildirimini; aşılan iç içe geçme derinliğini; ve iki alt Aggregate’in aynı düğüm kimliğine derlendiği ve belirsizliği gidermek için bir örnek adının yeniden adlandırılması gereken düzleştirilmiş düğüm kimliği çakışmasını bildirir. - Grafik sonlandırma (Aggregate ve Release yüzeyleri arasında Feature birleştirme), ikisi arasında tutarsız bildirilmiş bir Feature türünü bildirir.
- Statik analiz (seçici değerlendirmesi ve düğümler arası tür güvenliği denetimleri), bir
selector:ihlalini; ötesine geçemediği, ulaşılamayan varlığı adlandıran bir katalog çözümleme başarısızlığını; ve bir yönetişim karar rolüne bağlı bir plugin’in birleştirilmiş derlemeyi reddettiği bir politika reddini bildirir. Politika reddi,POLICY_ERRORkategorisini, reddeden plugin’in adını ve plugin’in sağladığı kural mesajını taşır. - İşleme (provider yönlendirmesi ve provider başına işleme), bilinmeyen bir provider’ı bildirir.
- Gömülü Wasm ana makine yükleyicisi kendi koruma sentinel’lerini yayar: manifest tarafından reddedilen bir koruma (bir plugin, AOT saflık güvenlik duvarının reddettiği bir çalışma zamanı erişim yeteneği talep etmiştir), bir konuk panik kurtarması ve deterministik bir plugin çıkış tuzağı. Bunlar, bir plugin çalıştırılırken (örneğin
aggrega lintaracılığıyla) kullanıcıya yönelik tanılamada görünür. Bir konuğu ana makineye karşı test eden Plugin yazarları, aynı koşullara yukarıda listelenenpkg/plugintestaracılığıyla içe aktarılabilir adlarla ulaşır.
Bir ardışık düzeni özellikle bir politika reddine göre koşullandırmak için, bir sentinel yerine tanılamadaki POLICY_ERROR kategori önekini eşleştirin; kategori, hata yüzeyinin belgelenmiş bir parçasıdır ve error-translation.md içinde açıklanır.
Kısa koda göre tüm koşullar
Aşağıdaki tablo aramayı ters yönden yapar: sol sütunda bir kısa kod, yanında da bu kodun adlandırdığı koşul ve bu koşulun ürettiği metin bulunur. aggrega’nın bildirebileceği her koşulu, yukarıdaki bölümlerin listeleyemedikleri de dahil olmak üzere kapsar.
Bu daha geniş kapsam, bu tablonun bir tesadüfü değil amacıdır. Yukarıdaki bölümler içe aktarabileceğiniz bir ada göre düzenlenmiştir; bu nedenle yalnızca içe aktaramayacağınız bir pakette bildirilen — ve içe aktarabileceğiniz hiçbir yerde yeniden dışa aktarılmayan — bir koşulun bu bölümlerin sol sütununa koyacak bir şeyi yoktur. Bu tablo kısa koda göre düzenlenmiştir ve her koşulun bir kısa kodu vardır; bu nedenle bildirilebilen hiçbir koşul tablonun dışında kalmaz. Elinizdeki bir kısa kod, arkasındaki koşulun eşleştirebileceğiniz bir erişimcisi olsun ya da olmasın burada çözümlenir.
Bu tabloda yer almayı sağlayan şey, derleyicinin koşulu gerçekten bildirebilmesidir. Satırlar koda elle aktarılmaz, koddan türetilir: bir koşul burada, derleyicideki bir şey onu ortaya çıkardığı için yer alır; bu nedenle sol sütundaki her kod aggrega’nın yazdırabileceği bir koddur. Tablonun verdiği söz budur ve bir satırı gerçekten çalışan bir denetim olarak okumanızı sağlayan da budur.
Bilinçli istisna, onu bildiren kod var olmadan önce bildirilen bir koşuldur; böylece kod ve ifade önceden sabitlenir ve bunları zaten alıntılamış bir okuyucu için hiçbir zaman değişmez. Böyle bir koşul bunu tablonun hemen altındaki bir notta belirtir. Gizlenmez, listelenir — elinizdeki bir kod her zaman çözümlenmelidir — ve yanındaki not, henüz hiçbir derlemenin onu ortaya çıkarmadığını ve bunun için neyin var olması gerektiğini size açıkça söyler.
Emekliye ayrılmış bir numara da tablonun altındaki kendi not kümesinde listelenir ve kalıcı olarak listede kalır. Bir koşul zaman zaman geri çekilir — daha geniş bir alanı kapsayan bir koşulla değiştirilir ya da onu hiçbir şey bildirmemiştir — ve o andan itibaren numarası emekliye ayrılır: hiçbir zaman farklı bir koşula verilmez; bu nedenle eski bir rapordan alıntıladığınız bir kısa kod, yalnızca rapor yazıldığında adlandırdığı şeyi adlandırabilir. Bu söz editoryal değil, mekaniktir. Emekliye ayrılmış bir numarayla bildirilen bir koşul, her çalıştırmada derleyici herhangi bir girdiyi okumadan önce reddedilir; bu nedenle hiçbir sürüm böyle bir koşul taşıyamaz — bu, iki etkin koşulun paylaşmaya çalıştığı bir numaranın karşılaşacağı retle aynı türdendir ve ikisinden hangisine denk geldiğinizi ayırt edebileceğiniz biçimde ifade edilmiştir. Emekliye ayrılmış bir kodun notu, emekliye ayırma bunu kaydettiyse size kodun neyi adlandırdığını ve koşulun değiştirildiği durumlarda o alanı artık hangi kodun bildirdiğini söyler.
Bir numaranın hiçbir zaman yeniden kullanılmaması, dizideki kalıcı boşlukların da nedenidir ve bu boşlukları okunabilir kılan notlardır. Eksik bir numara tek başına hiçbir şeyin kanıtı değildir: emekliye ayrılmış olabilir, aynı şekilde henüz hiçbir şeyin ulaşmadığı bir numara da olabilir. Notlar, hangi numaraların emekliye ayrıldığının ve kaydedildiği durumlarda her birinin neyi adlandırdığının kaydıdır; bu nedenle ne bir satıra ne de bir nota çözümlenen bir kod, bu derleyicinin hiç vermediği bir koddur.
Bir kısa kod bilinçli olarak opaktır: dört basamak tek başına bir koşul hakkında hiçbir şey söylemez; bu, sesli okunacak, bir aramaya yazılacak ya da bir rapora yapıştırılacak kadar kısa bir tanımlayıcının bedelidir. Onu kullanılabilir kılan, aşağıdaki eşlemedir. Bir numara tek bir artan diziden yalnızca bir kez verilir ve o andan itibaren sabittir; adlandırdığı koşul hakkında hiçbir şey söylemez. Dolayısıyla bir kısa kod bir tanımlayıcıdır, fazlası değil — değeri bir sınıflandırma değildir ve ne kodun kendisi ne de tabloda fark edebileceğiniz herhangi bir gruplama, bir koşulun nerede bulunduğuna ya da ne hakkında olduğuna dair bir rehberdir.
Tabloda kategori sütunu yoktur ve bu bir eksiklik değildir: kategori, arkasındaki koşulun değil, belirli bir hatanın özelliğidir. Bazı koşullar yapıları gereği tek bir kategoriye aittir. Diğerlerinde kategori, hatanın ilgili olduğu varlık türünden çıkar; bu nedenle bu tür bir koşul bir kez bir Aggregate’e, bir kez bir Release’e karşı bildirildiğinde her seferinde farklı bir kategori taşır — ve burada koşulun yanına yazılan tek bir değer, bu ikinci türdeki her koşul için yanlış olurdu.
Kategorilerin anlatıldığı yer error-translation.md sayfasıdır — her biri, ne anlama geldiği ve düzeltmesinin nerede yapıldığı. Bir kategori ve bir kısa kod, aynı hata hakkında farklı soruları yanıtlar: kategori, düzeltmenin ait olduğu yüzeyi belirtir; kısa kod ise derlemeyi hangi koşulun durdurduğunu belirtir. Hiçbiri diğerinden türetilemez; bu nedenle her birinin kendi yayımlanmış listesi vardır — ve bu nedenle adlandırılacak bir yazım yüzeyi olmayan bir hata bile burada arayabileceğiniz bir kod taşır.
| Kod | Koşul | Mesaj |
|---|---|---|
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 |
E0002emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Grafiğin statik sözleşmeleri denetlenirken başarısız olan bir katalog aramasını adlandırıyordu — yazılmış bir belgedeki değil, derleyicideki bir hata — ve bu durumu artık, bir derleme o sırada okuduğu katalogda kaydı bulunmayan bir bileşen türünü çözümlediğinde ortaya çıkan koşul bildirir; bu koşulun koduE0154’tür.E0134emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Dizini, varlığın bildirdiği sürümün adını taşımayan yayımlanabilir bir varlığı adlandırıyordu; yayımlama bir dizinin adını değerlendirmez ve türünün kendine ait bir dizini olduğu durumda bir varlığın dizinini başka bir varlıkla paylaşması hâlinde ortaya çıkan koşulE0303’tür.E0157emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Yazılmış ad örüntüsüyle eşleşmeyen bir Aggregate anahtarını — bir bileşen, özellik, alt sistem ya da iç içe modül örneği adını — adlandırıyordu. Bu anahtar yüzeylerinin her biri Aggregate şeması tarafından aynı yazımla sınırlandırılmıştır; şema, belgenin zarfını doğrularken belgeyi reddeder ve sorunlu anahtarı satır ve sütunuyla bildirir; bu koşulun koduE0215’tir.E0159emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Noktayla ayrılmış segmentlerinin tümü örnek adı örüntüsüyle eşleşmeyen bir hedef referansını adlandırıyordu ve koşul geri çekilmeden önce hiçbir derleme onu bildirmedi.E0166emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bir Release’inparameters: { $import: … }ifadesinin işaret ettiği dosyanın okunamadığı ya da baytlarının ayrıştırılamadığı durumu adlandırıyordu; belge üretmeyen bir dosya, yol nerede yazılmış olursa olsun tek bir koşuldur ve koduE0175’tir.E0203emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez.evalyeteneği üzerinde bir kaynak, bir values katmanı, bir iş yükü ya da yapıtlar bildiren bir FeatureRecipe’i adlandırıyordu; o yetenek geri çekildi ve artık bu durumu hiçbir şey bildirmez.E0206emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez.evalyeteneği üzerinde bir kaynak, bir iş yükü, yapıtlar ya da bir values katmanı bildiren bir Recipe’i adlandırıyordu; o yetenek geri çekildi ve bunların hiçbirini bildirmeyen bir Recipe her yetenekteE0210altında reddedilir.E0217emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Belirli bir alana karşı bildirilemeyen bir şema doğrulama hatasını adlandırıyordu ve koşul geri çekilmeden önce hiçbir derleme onu bildirmedi.E0219emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Şema birleştirmenin birleştirme adımından ayrı bir zincir taramasının bildirdiği döngüsel birextendszincirini adlandırıyordu; her döngüsel zinciri tek bir zincir taraması bildirir ve koduE0202’dir.E0230emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu bildirmez.E0231emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu bildirmez.E0232emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu bildirmez.E0233emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu bildirmez.E0234kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Compose sağlayıcısı üzerinden işleme sırasında raporlanan, boş bir dize olan bir Recipe kaynağını adlandırıyordu; bunu artık her sağlayıcıyı kapsayan tek bir koşul raporlar ve koduE0251’dir.E0235kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0236kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0237kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0238kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0239kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0240kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0241kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0242kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Helm sağlayıcısı üzerinden işleme sırasında raporlanan, boş bir dize olan bir Recipe kaynağını adlandırıyordu; bunu artık her sağlayıcıyı kapsayan tek bir koşul raporlar ve koduE0251’dir.E0243kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0244kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0245kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0249kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0258kullanımdan kaldırılmıştır: artık hiçbir şey onu raporlamaz ve bu numara hiçbir zaman başka bir koşula verilmez. Bu numaranın adlandırdığı koşul geri çekilmiştir ve hiçbir derleme onu raporlamaz.E0322emekliye ayrılmıştır: artık hiçbir şey onu bildirmez ve numara hiçbir zaman farklı bir koşula verilmez. Bir sınıra eklenmiş bir Feature’ın, bir bileşenin ortamı için, başka bir eklentinin zaten teslim ettiği bir anahtar altında hesapladığı bir değeri adlandırıyordu. Bir sınıra eklenmiş bir Feature, bir bileşene yalnızca FeatureRecipe’inin injectMapping’i aracılığıyla teslim eder ve başka bir eklentinin teslim ettiği bir anahtarı yazan bir eşlemeE0318altında bildirilir.
Eşleştirme rehberi
errors.Is yüklemi sarmalama zincirini dolaşır; bu nedenle hata size geri dönerken birkaç kez sarmalanmış olsa bile sentinel eşleşmesi çalışır. Dışa aktarılan bir fonksiyonun döndürdüğü hatayla eşleştirin:
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}Bütün bir derlemeyi çalıştıran dışa aktarılmış bir giriş noktası yoktur; bu nedenle errors.Is eşleştirmesi bu paketleri doğrudan çağıran kod için geçerlidir. CI’ı bir derlemeye bağlamak için aggrega build komutunu çalıştırın ve çıkış durumunu ve tanılamalarını okuyun: ileti metinleri fatal-halts.md dosyasında, kategorileri error-translation.md dosyasında kataloglanmıştır ve köşeli parantezli başlıklarındaki kısa kod bu sayfadaki tüm koşulların tablosunda çözümlenir.
İki denetim yolu, üç tanımlayıcının farklı uzaklıklara erişmesi nedeniyle vardır. Go ile yazılmış bir denetim bu paketleri bağlar, sentinel’leri eşleştirir ve elindeki herhangi bir hatadan her iki kodu da okuyabilir. Komutun etrafında yazılmış bir denetimin elinde çıkış durumu ve yazdırılan metin vardır — ve yazdırılan metin koşulu adlandırır, çünkü kısa kod köşeli parantezli başlıkta yer alır. Bu nedenle böyle bir denetim ileti ifadesine değil, bu kısa koda dayanır; iletiye dayalı görünümler ise elinde zaten bulunan ifadeden geriye doğru çalışmanın yolu olarak kalır. Go’dan sentinel’i eşleştirin; komutun etrafında kısa koda dayanın; bir istemcinin bu protokolü konuştuğu yerde açıklayıcı kodu yapılandırılmış tanılamadan okuyun.
Farklı paketlerde aynı kısa adla bildirilen sentinel’ler, tek bir koşulun iki yazılışı değil, ayrı koşullardır: errors.Is bunları kimliklerine göre ayırt eder; bu nedenle birine karşı yapılan eşleştirme diğeriyle eşleşmez. Tablolarda belirtilen yeniden dışa aktarımlar istisnadır ve tam da iki adın gerçekten eşleştiği durum oldukları için belirtilirler. Tabloların listelediği paketteki adla eşleştirin ve tek başına bir kısa adı belirsiz kabul edin.
Kullanıcıya yönelik tanılama kataloğu (bir derleme durduğunda geliştiricilerin terminallerinde gördükleri iletiler) için fatal-halts.md dosyasına bakın. Bilgilendirici uyarı kataloğu (durdurmayan warning:, lint: ve notice: çıktısı) için warnings.md dosyasına bakın. Kategori öneki sınıflandırması ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]) için error-translation.md dosyasına bakın.