Ölümcül durma, herhangi bir çıktı üretilmeden önce derlemeyi durduran bir derleme zamanı hatasıdır. Her durma, hatalı dosyayı, varlığı ve alanı adlandırır, derleyicinin neyi çözümleyemediğini açıklar ve sorunu gideren somut yazım değişikliğini gösterir. Derleyici girdinizi hiçbir zaman sessizce onarmaz veya yeniden yazmaz — bir şey yanlışsa derleme durur ve size nerede olduğunu söyler.
Bu katalog, her durdurmanın tetiklendiği derleme aşamasına göre düzenlenmiştir.
Aşağıdaki her girdi, belgelediği koşul için bir derlemenin yazdırdığı mesajı aktarır: koşulu belirten sabit cümle ve ardından o oluşumun sağladığı bilgiler. Bir terminalde bu mesaj bir çerçevenin içinde görünür — kategoriyi ve koşulun kısa kodunu taşıyan köşeli parantezli bir başlık, hatalı dosyayı ve anahtarı gösteren ve ardından hatanın ilgili olduğu örneği (instance <name>) olarak veren bir işaretçi — ya da hiçbir dosyanın geçerli olmadığı durumlarda yalnızca instance <name> olarak o örnek — ve alttaki satırda mesajın kendisi —; bu nedenle bir derlemeden yapıştırılan satırın tamamı buradaki bir girdiyle eşleşmez, ancak içindeki mesaj eşleşir. Çerçevenin tamamı error-translation.md sayfasında açıklanmıştır.
Elinizde bir derlemeden gelen kısa bir kodla — tanılamanın köşeli parantezli başlığındaki E harfi ve dört rakam — geldiyseniz, bu sayfanın sonundaki Derlemenin yazdırdığı kısa koddan bir durmayı bulma bölümünden başlayın; bu bölüm, burada kataloglanan her koşulu bir derlemenin onun için yazdırdığı kısa kodla birlikte listeler.
Dosyalarınız yüklenirken
Derleyici, derlemenizin başvurduğu her Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin ve Release’i okur, her birini kendi şemasına göre doğrular ve Release’teki tipli parametreleri Aggregate’e yerleştirir.
Kendi içeriği içinde takma adla başvurulan YAML çapası
Bir belge bir düğümü &name ile çapalar, ardından o çapanın kapsadığı içeriğin bir yerinde ona *name ile takma adla başvurur. Takma adın genişletilmesi çapayı yeniden üretir; çapanın içeriği ise takma adı yine taşır, dolayısıyla belge sonu olmayan bir yapıyı tanımlar. Okunacak sonlu bir şey yoktur, doğrulanacak bir şey hiç yoktur; derleme, bitemeyecek bir dolaşmaya başlamak yerine durur.
YAML’ı bir ağaca okumak takma adları genişletmez; bu biçimdeki bir belge itirazsız okunur ve yalnızca bir şey onu dolaştığında başarısız olur. Bu nedenle ret, okuma ile dolaşma arasında yer alır; bir derleme yazılmış YAML’ı birden fazla noktada okuduğundan aynı durumla birden fazla noktada karşılaşılabilir. Dört nokta bunu bildirir; her biri aynı açıklamayı, belgeyi o yüzeyde konumlandıran bilgiyle çerçeveler:
Bir varlık dosyası, okunurken. Derleme, o varlık şemasına göre denetlenmeden önce durur; bu yüzden bu durma bir alan yerine bir çapayı adlandırır ve satır ile sütun taşımaz: o noktada belgede bir tanılamanın yararlı biçimde gösterebileceği bir konum yoktur.
Bir şema gövdesi, derlenirken. Bir spec.schema: sütunu, dosyası okunduktan sonra kompakt biçimden bir JSON Schema belgesine derlenir; bu yüzden bu durma o derlemeden önce değil derleme sırasında tetiklenir ve bir satır taşır. Daha önceki bir okumanın yakalayamadığı biçim bir $jsonschema: kaçış gövdesidir: kaçış gövdesi, çevreleyen dosya okunurken bir blok skalerdir (düz metin, çapa taşımaz) ve çapaları ancak o metnin kendisi bir seviye aşağıda ayrıştırıldığında çapa olur. Döngü böyle bir bloğun içindeyse durma, gövdesi onu taşıyan anahtar sözcük olarak $jsonschema adını da verir.
Bir provider Plugin’inin workload şeması, Plugin yüklenirken.spec.provider.workloadSchema bir blok skaler olarak yazılır: Plugin dosyasının kendisi okunurken düz metindir, o noktada çapa taşımaz ve çapaları ancak o metin bir seviye aşağıda kendi başına bir belge olarak ayrıştırıldığında çapa olur. Bu ayrıştırma ve ardından gelen derleme Plugin yüklenirken gerçekleşir; bu yüzden bu durma dosya okunurken değil orada tetiklenir ve bir satır taşır. Döngü şema gövdesindeki bir $jsonschema: kaçışının içindeyse durma, gövdesi onu taşıyan anahtar sözcük olarak $jsonschema adını da verir. Alanın yazım yüzeyi için bkz. ../entities/plugin.md.
İşlenmiş bir CloudFormation parçası, provider onu okurken. Bir cloudformation Recipe’i bir parça yazar ve bir artifacts: gövdesi bir şablondur; dolayısıyla provider’ın okuduğu, o şablonun işlenmesiyle ortaya çıkan metindir, yani dosyalarınız okunurken var olmayan içeriktir. Bu yüzden bu durma, tüm şema denetimleri geçtikten sonra, çıktı işlenirken tetiklenir. Parça yazım yüzeyi için bkz. ../providers/cloudformation.md.
Reddedilen özyinelemedir; yeniden kullanım ya da derinlik asla reddedilmez. Paylaşılan içeriği çapalayıp birçok yerden ona başvurmak desteklenen bir yazım kalıbıdır (bkz. ../entities/aggregate.md “YAML anchor patterns (defs: block)” ve ../entities/manifest.md “YAML anchors for DRY manifests”); genişleyip sonlanan bir başvuru, kaç kez görünürse görünsün ve belge ne kadar derin iç içe olursa olsun normal biçimde yüklenir; derinlik tek başına bu durmanın nedeni asla değildir. Durmaya yol açan, derleme hâlâ bir çapanın içindeyken o çapaya ulaşılmasıdır; buna, altında bildirilmiş ikinci bir çapa üzerinden dolaylı olarak ulaşılması da dahildir. İleti, döngünün geri kapandığı çapayı adlandırır; bu, belgedeki en dıştaki çapa olmak zorunda değildir.
Yayımlanan iletiler. Dördü de aynı açıklamayı taşır ve bu bilinçlidir: bu, dört noktada karşılaşılan tek bir durumdur ve onu bir kez okumayı öğrenmiş bir yazarın yeniden öğrenmesi gerekmemelidir. Yalnızca belgeyi konumlandıran çerçeve farklıdır.
anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (çapa kendi içeriği içinde bir takma adla yeniden kullanılıyor, bu nedenle belge sonsuza dek genişliyor; o takma adı çapanın dışında bildirilmiş içeriğe yönlendirin ya da içeriği tam olarak yazın)
Bir varlık dosyası, onu okuyan zarf denetimi ve okunduğu yol ile çerçevelenir:
Bir şema gövdesi, şema içindeki konumuyla ve döngü bir $jsonschema: bloğunun içindeyse kaçış anahtar sözcüğüyle çerçevelenir. Derleme bunu bir CATALOG_ERROR etiketi altında bildirir; bu etiket dosyayı, varlığı ve gövdesi derlenemeyen sütunu da adlandırır:
compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above>
Bir provider Plugin’inin workload şeması aynı kompakt biçim çerçevesini taşır; farklı olan, onu çevreleyen CATALOG_ERROR etiketidir; bu etiket varlık ve sütunu yerine Plugin’i ve spec.provider.workloadSchema alanını adlandırır.
İşlenmiş bir parça, onu okuyan provider ile çerçevelenir:
Nasıl düzeltilir: takma adı, şu anda içinde bulunduğu çapanın dışında bildirilmiş içeriğe yöneltin ya da tekrarlanan içeriği kullanıldığı noktada tam olarak yazın. Bir Aggregate ya da Manifest’te kök düzeydeki defs: bloğu paylaşılan çapalar için doğal yerdir: ona başvuran her bloğun dışında durduğundan orada bildirilen bir çapaya kendi içinden ulaşılamaz. defs: bloğu olmayan diğer varlık türlerinde paylaşılan içeriği, başvuran bloğun soyundan gelmediği bir yere çapalayın. Bir çapaya istenen sayıda yerden ve her derinlikten başvurulabilir; alamayacağı tek biçim, çapanın kapsadığı içeriğin içine geri düşen bir başvurudur.
Durmayla nerede karşılaşılmış olursa olsun aynı çözüm geçerlidir ve hangi belgeyi açmanız gerektiğini çerçeve söyler: varlık dosyasının kendisi, bir şema sütunundaki $jsonschema: bloğu, bir provider Plugin’indeki workloadSchema gövdesi ya da işlenmiş çıktısını provider’ın okuduğu artifacts: gövdesi. Son durumda çapa işlenmiş metinde değil, sizin yazdığınız şablondadır; işleme onu aslına uygun biçimde yeniden üretmiştir.
Parameter type mismatch / contract violation (Parametre türü uyuşmazlığı / sözleşme ihlali)
Release, türü veya biçimi Aggregate’in o parametre için bildirdiğiyle eşleşmeyen bir değer sağladı. Parametre sözleşmesi doğrulayıcısı; tür uyuşmazlıklarını, enum ihlallerini, aralık ihlallerini, desen ihlallerini, bildirilen format değerinin geçerli örneği olmayan dizeleri, validate: yüklemi başarısızlıklarını ve eksik zorunlu parametreleri herhangi bir şablon interpolasyonu çalışmadan önce yakalar. Bir format değerinin alabileceği adlar ve her birinin neyi denetlediği Adlandırılmış biçimler altında listelenir.
Üretilen ileti — koşulu belirten cümle, ardından hatalı varlık, alan yolu ve kısıt ayrıntısı:
parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (parametre sözleşmesi ihlal edildi (Aggregate, .spec.parameters.<parameter> konumunda, “<parameter>” parametresi <declared type> türü bekliyordu; <received type> alındı))
required: true olarak bildirilmiş, default: değeri olmayan ve Release tarafından değer sağlanmamış bir parametre için rapor farklı bir koşul ve farklı bir kısa kod taşır:
required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (zorunlu parametre sağlanmadı (Aggregate, .spec.parameters.<parameter> konumunda, “<parameter>” parametresi zorunlu ancak Release tarafından sağlanmadı))
Yalnızca alan yolundan sonraki ayrıntı, karşılanmayan kısıta göre değişir. Cümle ve onu çevreleyen parantezli çerçeve her seferinde aynıdır; bu da cümleyi eşleştirilecek kısım, ayrıntıyı ise okunacak kısım yapar. Bir derlemenin yazdırdığı ayrıntılar, her kısıt türü için bir tane:
parameter "<parameter>" value <value> not in enum [<members>] (parametre değeri enum içinde değil)
parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (parametre değeri desenle eşleşmiyor)
parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (parametre değeri geçerli bir biçim değil)
parameter "<parameter>" value <value> above max <max> (parametre değeri üst sınırın üzerinde)
parameter "<parameter>" failed validate predicate (parametre validate yüklemini geçemedi)
parameter "<parameter>" validate predicate error: <detail> (parametre validate yüklemi hatası)
Bir biçim hatasının <reason> kısmı, değerde neyin yanlış olduğunu o biçimin kendi terimleriyle söyler. İç içe bir sözleşmedeki değer yoluyla adlandırılır; bu nedenle bir items: sözleşmesinin bildirdiği format her öğe üzerinde denetlenir ve rapor başarısız olanı adlandırır: bir hosts parametresinin ikinci öğesi .spec.parameters.hosts.1 konumunda raporlanır ve ayrıntısı "hosts.1" adını verir.
validateMessage: bildiren bir parametre, bu ayrıntının tamamını kendi metniyle değiştirir; böylece rapor parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) biçiminde okunur — çerçeve değişmez ve sizin cümleniz kısıt ayrıntısının yerinde durur.
Aynı koşul, yazıldığı haliyle hiçbir şeyi kısıtlayamayan bir sözleşmeyi de kapsar. Geçerli bir düzenli ifade olmayan bir pattern:, herhangi bir Release değeri denetlenmeden önce, Aggregate’in parametre sözleşmesi okunurken reddedilir; bu nedenle bir Release parametreyi sağlasa da sağlamasa da derlemeyi durdurur. Rapor anahtarı gösterir — .spec.parameters.<parameter>.pattern ya da .spec.parameters.<parameter>.items.pattern gibi iç içe bir sözleşmeden geçen yol — ve ayrıntısı bildirimi, deseni ve nedeni adlandırır:
parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (parametre deseni derlenmiyor)
Desteklenen kümenin dışındaki bir biçimi adlandıran bir format: da hiçbir şeyi kısıtlayamaz ve aynı noktada, herhangi bir Release değeri denetlenmeden önce reddedilir; bu nedenle o da bir Release parametreyi sağlasa da sağlamasa da derlemeyi durdurur. İç içe bir sözleşmenin içinde — items:, properties: veya valuesType: altında — onu reddeden bu koşuldur: rapor .spec.parameters.<parameter>.items.format gibi anahtarı gösterir ve ayrıntısı bildirimi, yazıldığı haliyle biçimi ve desteklenen her adı adlandırır:
parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (biçim desteklenmiyor; desteklenen biçimler email, uri, hostname, ipv4, ipv6, uuid, date-time, date)
Bir parametrenin kendi bildiriminde aynı ad bir adım önce, format alanı yalnızca desteklenen adları kabul eden Aggregate şeması tarafından reddedilir. Bu ret, belgenin kendi türünün şemasını karşılamamasıdır — kendi kısa kodu E0215 olan farklı bir koşul — ve aggrega pull ile aggrega validate --release, adı taşıyan Aggregate yüklenmediği için, bunu Release’in aggregate: başvurusunu çözümlenemez (E0170) olarak raporladıktan sonra listeler:
document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (belge zarfı doğrulaması başarısız oldu; biçim izin verilen değerlerin hiçbirine eşit değil; belgeyi türünün şemasına uyacak şekilde düzeltin)
Yüklem hatası ayrıntısı, bir validate: yükleminin karar üretemediği her iki durumu da kapsar: yüzeyin kaydetmediği bir işlev ve .value dışındaki bir şeye yapılan başvuru. Her biri değere değil yükleme karşı raporlanır ve her biri çözümleyemediği şeyi adlandırır.
Bir validate: yüklemi doğrulanan değeri .value olarak okur ve tanımladığı tek ad budur. Başka bir şeyi adlandıran bir yüklem çalışmadan önce reddedilir; böylece yanlış yazılmış bir başvuru, hiçbir şeye çözümlenip doğrulamayı geçemeyen bir değer olarak ortaya çıkmak yerine, olduğu gibi bir adlandırma hatası olarak raporlanır.
Nasıl düzeltilir: Release değerini parametrenin bildirilen type / enum / min / max / pattern / format kısıtlarına uyacak şekilde değiştirin, eksik bir zorunlu parametreyi sağlayın, derlenmeyen bir pattern: değerini düzeltin, desteklenmeyen bir biçimi adlandıran bir format: değerini adlandırılmış biçimlerden biriyle değiştirin ya da kaldırın, .value dışında bir şeyi adlandıran veya true ya da false dışında bir şey üreten bir validate: yüklemini düzeltin ya da Aggregate’in bildirimini gerçekte ihtiyaç duyduğunuz biçimi kabul edecek şekilde genişletin.
Recipe biçim kuralları
Bir Recipe, çıktısını üç girdi türünden (kaynaklı, sentezlenmiş ve artifacts) oluşturur; bunlar ../../architecture/16-recipe-input-composition.md belgesinde açıklanır. Geçerli bir Recipe’in biçimi aşağıdaki birleştirme kurallarıyla sınırlanır. Bu kurallar ne zaman denetlendikleri bakımından farklılık gösterir: Recipe yüklendiğinde, bir düğüm işlendiğinde ya da çıktı üretildiğinde. Bu nedenle her girdiyi, kendi koşulunun hangi aşamada denetlendiğine dikkat ederek okuyun.
Her kural, neyi kısıtladığıyla adlandırılır. Numaralandırma yoktur ve hiçbir numara ayrılmamıştır: bir ad, Recipe’in hangi kısmının açılacağını söyler ve aşağıdaki liste nasıl büyürse ya da yeniden sıralanırsa sıralansın bunu söylemeye devam eder. Bir koşulu kalıcı olarak kaydetmeniz gerektiğinde — bir CI denetiminde, bir sorun kaydında, bir çalışma kılavuzunda — onun kodunu, yani sentinels.md dosyasının koşul için listelediği ve çevresindeki paketler geliştikçe sabit kalan tanımlayıcıyı kullanın.
Bir Recipe biçimi durdurması da aynı şekilde oluşturulur. Kuralı belirten cümleyle başlar, ardından bu Recipe’in neyi sağladığını, sonra ona özgü ayrıntıyı adlandırır:
Baştaki cümle her kural için sabittir — o kural her durdurduğunda, hangi aşama algılamış olursa olsun aynı metindir — bu nedenle çıktının eşleştirilecek kısmıdır ve sentinels.md dosyasının kuralın koşulu için listelediği metindir. Ondan sonraki her şey hatalı Recipe’e göre değişir: parantez içindeki değerler hangi belge, adıyla hangi kural ve nerede olduğunu söyler; kapanış cümlesi ise o durum için öneridir. Konum, kural belgenin bütünüyle ilgiliyse Recipe’in yüklendiği dosyadır; kural içindeki tek bir şeyle ilgiliyse yazdığınız anahtara giden noktalı bir yoldur — .spec.outputComponentLabels.hosting; kendi noktalarını taşıyan bir anahtar, iki segment gibi okunmadan tek bir segment olarak yazılamaz, bu nedenle yol onu tutan blokta durur ve öneri bunun yerine anahtarı alıntılar.
Derleme satırın tamamını, hatanın Aggregate’e ya da Release’e değil katalog varlığına (Recipe’e ya da bağlandığı provider’a) atfedilebileceğini belirten bir CATALOG_ERROR etiketi altında yazdırır. Recipe’in yüklendiği dosya etiketin yanında yazdırılır; böylece bir anahtarda konumlanan bir kural da hangi dosyayı açmanız gerektiğini söyler.
Bir Recipe valuesMapping bildirir ancak source bildirmez. Üzerine bindirilecek bir kaynak olmadan, eşlenen değerleri alacak hiçbir şey yoktur. Bu kural Recipe yüklenirken denetlenir.
Üretilen ileti:
Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (Recipe: valuesMapping, source gerektirir; valuesMapping ile birlikte bir source: işaretçisi bildirin (ya da bindirme amaçlanmıyorsa valuesMapping’i kaldırın))
Nasıl düzeltilir:valuesMapping ile birlikte bir source: işaretçisi (bir chart, modül ya da compose dosyası başvurusu) ekleyin ya da valuesMapping değerini kaldırıp farklı bir girdi türü benimseyin (sentezlenmiş çıktı için workload:, doğrudan manifest üretimi için artifacts:).
workload: requires a provider that can synthesize (workload:, sentezleyebilen bir provider gerektirir)
Bir Recipe, Workload sentezini uygulamayan bir provider için workload: (sentezlenmiş kip) bildirir. Sentezlenmiş kip desteği provider’ın bir özelliğidir — standart kütüphane kataloğu, uzlaşım gereği sentez yapabilen provider’larda workloadSchema bildirir, ancak denetim o alanın varlığına değil provider yeteneğine dayanır.
Bunu iki yüzey raporlar ve derlemeye yalnızca biri karar verir. Durdurma, işleme zamanında, düğümün provider’ı bağlandıktan ve Recipe’inin bildirdiği girdi türleri okunduktan sonra oluşturulur; bu nedenle bu rapor düğümü adlandırır. aggrega validate aynı bulguyu daha önce, herhangi bir düğüm bağlanmadan, Recipe’i tek başına okuyarak raporlar — bu nedenle bu rapor bunun yerine Recipe’i ve sürümünü adlandırır. İkisi aynı Recipes kümesini okumaz: erken rapor workload: bildiren her Recipe için oluşturulurken, durdurma düğümün bildirdiği ve provider’ının karşılayamadığı her girdi türü için oluşturulur. Dolayısıyla bir workload: ile bir source: değerini eşleştiren bir Recipe yine durur ve workload nedeniyle durur — provider’ın işleyebildiği bir girdi türünü bildirmek, desteklenmeyen birini denetimden geçirmez.
Bunun tek sınırı: artifacts:, standalone-artifacts desteğine karşı yalnızca düğümün bildirilen tek türü olduğunda denetlenir. Bir source: ya da workload: ile birlikte olduğunda dosyaları, o yeteneğin yönetmediği birleştirilmiş çıktı olarak geçer.
İşleme zamanında üretilen ileti. Hatanın atfedildiği kategori size iletinin içinde değil, tanılamanın köşeli parantezli başlığında ulaşır. İleti, koşulu belirten sabit cümleyle başlar, ardından düğümü, provider’ı, reddedilen bildirilmiş türü ve o provider’ın desteklediği türleri adlandırır. Bir düğüm, provider’ının karşılayamadığı iki tür bildirdiğinde, source → workload → artifacts sırasındaki ilki raporlanır; böylece bulgu Recipe’inizin tek bir satırıyla ilgili kalır:
provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode> (provider düğümün girdi türünü desteklemiyor; provider <mode> recipe’lerini desteklemiyor (bu provider şunları destekler: <kinds>); desteklenen girdi türlerinden birini bildirin ya da <mode> destekleyen bir provider’ı hedefleyin)
Başlık, kategoriyi ve bu koşulun kısa kodu E0265 değerini taşır; bu, durdurmayı kalıcı olarak adlandırmanız gerektiğinde — bir sürekli entegrasyon denetiminde, bir sorun kaydında ya da bir çalışma kılavuzunda — kaydedilecek tanımlayıcıdır. Bir numara bir kez verilir ve sonra sabitlenir; bu nedenle çevresindeki ifadeler nasıl iyileşirse iyileşsin aynı kalır; her koşulun tablosu onu çözümler ve bir tanımlayıcı yerine metinle çalışırken eşleştirilecek şey yukarıdaki açılış cümlesidir.
aggrega validate aynı yan cümleyi, bloğu taşıyan Recipe altında, onu okuyan yüzeyin önekiyle ve bu koşulun kısa koduyla başlayarak raporlar, çünkü erken rapor aynı koşuldur:
input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (input-kind: Recipe: provider sentezlenmiş recipe’leri desteklemiyor (bu provider yalnızca listelenen türleri destekler); desteklenen girdi türlerinden birini bildirin ya da sentezlenmişi destekleyen bir provider’ı hedefleyin)
Kataloğun tamamı üzerinde bu tek bir satırdır; --release ile başlık, yan cümlenin üstünde kendi satırında yer alır. Düzenleyicinin aynı bulgu için verdiği tanılama, kod olarak E0265 taşır.
Nasıl düzeltilir: ya Recipe’i sentezleyen bir provider’a (en yaygın olarak helm ya da compose) bağlayın ya da Recipe’i farklı bir girdi türüne taşıyın (doğrudan manifest üretimi için artifacts: ya da bir chart/modül varsa source: + valuesMapping:).
Sağlayıcı başına Workload içeriği doğrulaması. Bugün sağlayıcının workloadSchema alanı yalnızca belgeleme amaçlıdır ve Workload gövdesini doğrulamaz; gövdeler platformun sahip olduğu gömülü Workload şemasına karşı doğrulanır. Wasm tabanlı Workload sentezleyicisi yayımlandığında, workloadSchema sentezleyicinin Workload gövdesini doğruladığı sağlayıcı başına sözleşme olur (ayrı, içerik düzeyinde bir durdurma).
The provider does not support omits (Sağlayıcı omits desteklemiyor)
Bir Recipe veya FeatureRecipe omits: bildirir ve onu işleyen sağlayıcı, işlenmiş belgeleri dışarıda bıraktığını bildirmez. Bir kaynağın işlediklerinden bir belgeyi dışarıda bırakmak yalnızca sağlayıcının yapabileceği bir şeydir — kaynağın hangi belgeleri işlediğini ve her birinin adını yalnızca sağlayıcı bilir — bu nedenle bunu yapmayan bir sağlayıcı, girdilerin adlandırdığı her belgeyi işler ve başarı bildirirdi. Bunun yerine derleme, herhangi bir şey işlenmeden önce reddeder; böylece anahtar hiçbir zaman sessizce etkisiz kalmaz.
Bir sağlayıcının belgeleri dışarıda bırakıp bırakmadığı, derleyicinin tuttuğu bir sağlayıcı listesinden değil, sağlayıcının neyi desteklediğine ilişkin kendi bildiriminden okunur. when: ne işlerse işlesin her girdi sayılır, çünkü sağlayıcının anahtarı karşılayıp karşılayamayacağı bir derlemenin hangi girdileri tuttuğuna bağlı değildir. helm, compose ve cloudformation sağlayıcıları anahtarı karşılar. helm-chart ve terraform kaynaklarını dağıtıldığında işlenmek üzere aktarır; bu nedenle derleme zamanında dışarıda bırakılacak işlenmiş bir belge yoktur ve ikisi de reddedilir.
Ret kararı, her bileşenin Recipe’i ve her eklemenin FeatureRecipe’i bağlandıktan ve her sağlayıcı kendini tanımladıktan sonra verilir — ilk bileşen işlenmeden ve herhangi bir girdi değerlendirilmeden önce; böylece burada reddedilen bir derleme hiçbir şey işlemez. Bu, bir kaynak işleyen her belge için sorulur: bir bileşenin Recipe’i; bir eklemenin bir bileşen üzerinde bağladığı FeatureRecipe, eklemeyi taşıyan her bileşen için bir kez; ve bir sınır için bir kez üreten bir FeatureRecipe, onu bildiren sınırda bir kez. Hatalı her belge tek bir derlemede bildirilir; birden fazla olduğunda bulgular documents declaring omits whose provider does not honour them altında gruplanır. Derlemenin çözümleyemediği bir sağlayıcıya bağlı bir belge burada bildirilmez: o derleme, bağlamayı adlandırarak sağlayıcının seçildiği yerde durur.
Yayımlanan ileti; bir Recipe’in girdileri için components: altındaki bileşenin kendi anahtarında (bir alt sistem içinde yazılmış bir bileşen önce o alt sistemin anahtarı altında konumlandırılır), bir bileşen üzerindeki bir FeatureRecipe’inkiler için onu yazan features: bloğundaki eklemenin anahtarında ve sınırı için bir kez üreten bir FeatureRecipe için Release’teki .spec.boundaries.<boundary>.features.<attachment> konumunda konumlandırılır. Kategori size köşeli parantezli başlıkta ulaşır; ileti önce sağlayıcıyı, ardından belgenin işlendiği bileşeni adlandırır:
provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it
Bir FeatureRecipe’in bulgusu eklemeyi bileşenden sonra adlandırır — node "<node-id>", attachment "<attachment>" — ve sınırı için bir kez üreten bir FeatureRecipe, bileşen yerine sınırı ve eklemeyi adlandırır: boundary "<boundary>", attachment "<attachment>".
Başlık bu koşulun kısa kodunu, E0335’i taşır.
Nasıl düzeltilir:omits: anahtarını kaldırın veya kaynağı onu karşılayan bir sağlayıcı üzerinden işleyin. Bir helm-chart veya terraform Recipe’i yerel bir chart ya da modülü kaynak aldığında, Recipe’in yanındaki .aggregaignore dosyasına eklenen bir satır, Recipe bir sonraki sabitlendiğinden itibaren bunun yerine o kaynağın bir dosyasını dışarıda bırakır — bkz. aggrega pin.
The provider does not support boundary artifacts (Sağlayıcı sınır yapıtlarını desteklemiyor)
Bir Recipe spec.boundary.artifacts bildirir — işlendiği sınırın paylaşılan çıktısı için dosyalar — ve onu işleyen sağlayıcı bu tür dosyaları kabul ettiğini bildirmez. Derleyici bu dosyaları, sağlayıcının sınır için bir araya getirdiklerinin yanına kendisi yazar ve hiçbirini sağlayıcıya vermez; bu nedenle oraya yerleştirilen bir dosyanın bir anlam taşıyıp taşımadığı sağlayıcının hedefinin bir özelliğidir. Onu okumayan bir hedef dosyayı gönderir ve yok sayar, taşıdığı yapılandırma da hiçbir zaman etkili olmaz; bunun yerine derleme, herhangi bir şey işlenmeden önce reddeder.
Bir sağlayıcının dosyaları kabul edip etmediği, derleyicinin tuttuğu bir sağlayıcı listesinden değil, sağlayıcının neyi desteklediğine ilişkin kendi bildiriminden okunur. Neye işlenirse işlensin her girdi sayılır. terraform sağlayıcısı bunları kabul eder ve her birini sınırın kök yapılandırmasının yanına yazar; helm, compose, helm-chart ve cloudformation kabul etmez ve reddedilir.
Ret kararı, her bileşenin Recipe’i bağlandıktan ve her sağlayıcı kendini tanımladıktan sonra verilir — ilk bileşen işlenmeden ve herhangi bir girdi değerlendirilmeden önce; böylece burada reddedilen bir derleme hiçbir şey işlemez. Hatalı her Recipe tek bir derlemede, işlediği her bileşen için bir kez bildirilir; birden fazla bulgu olduğunda bunlar Recipes declaring boundary artifacts whose provider does not accept them altında gruplanır. Derlemenin çözümleyemediği bir sağlayıcıya bağlı bir Recipe burada bildirilmez: o derleme, bağlamayı adlandırarak sağlayıcının seçildiği yerde durur.
Yayımlanan ileti, düzenlemenin yapılacağı yer olan Recipe’teki .spec.boundary konumunda konumlandırılır. Kategori size köşeli parantezli başlıkta ulaşır; ileti önce sağlayıcıyı, ardından Recipe’in işlendiği bileşeni adlandırır:
provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it
Başlık bu koşulun kısa kodunu, E0351’i taşır.
Nasıl düzeltilir:boundary: bloğunu kaldırın veya Recipe’i onu kabul eden bir sağlayıcı üzerinden işleyin. Sınıra değil de bileşene ait bir dosya bunun yerine bir artifacts: girdisidir.
At least one input kind must be present (En az bir girdi türü bulunmalıdır)
Bir Recipe hiçbir girdi türü bildirmez: valuesMapping ile eşleştirilmiş bir source yok, workload: yok, artifacts: yok. Böyle bir Recipe çıktı üretmez ve işleme yüzeyi yoktur. Bu kural Recipe yüklenirken denetlenir.
Bu biçimdeki bir Recipe dosyası önce Recipe şemasına takılır: şema her sağlayıcıda source, valuesMapping, workload ya da artifacts alanlarından birini gerektirir; bu nedenle belge zarfı denetimi, bu kural çalışmadan önce dosyayı her anahtar için bir dal göstererek E0215 altında reddeder:
document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (belge zarfı doğrulaması başarısız oldu (Recipe): spec: hiçbir anyOf dalı eşleşmedi: 0. dalda zorunlu “source” özelliği eksik; 1. dalda zorunlu “valuesMapping” özelliği eksik; 2. dalda zorunlu “workload” özelliği eksik; 3. dalda zorunlu “artifacts” özelliği eksik. Belgeyi türünün şemasına uyacak şekilde düzeltin)
Üretilen ileti:
Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts
Nasıl düzeltilir: Recipe’in yazım amacına uyan girdi türünü ekleyin. Derlemenin sağlamadığı bir servis — başka bir yerde zaten çalışan bir veritabanı ya da API — için bir Recipe, endpoint (ve isteğe bağlı olarak port) değeriyle birlikte form: reference biçiminde bir workload: bildirir ve bağlantı değerlerini her Recipe gibi provides: altında yayımlar: helm bunu bir ExternalName Service olarak işler, compose bunun için hiçbir şey işlemez ve her ikisinde de tüketicileri yayımlanan değerleri okur.
artifacts: entry keys must be unique (artifacts: girdi anahtarları benzersiz olmalıdır)
Bir Recipe, artifacts: altında aynı anahtara sahip iki veya daha fazla girdi bildirir. Anahtar, yayımlanan dosya adını belirler (girdinin gövdesi satır içinde yazılmış ya da girdi başına $import: ile yüklenmiş olsun); yinelenen anahtarlar aynı sınır dizinine aynı adlı bir dosya yayımlardı.
Derleme, belgeyi türlenmiş biçimine çözerken Recipe’i reddeder ve yinelenen anahtarı ile tekrarlandığı satırı adlandırır. Bu adım zarf şeması denetiminden sonra ve biçim kurallarından önce çalışır; bu nedenle yinelenen bir artifacts: anahtarı olan bir Recipe geçerli şema ve ardından bu durmayı bildirir, kalan biçim kuralları ise onun hakkında bildirimde bulunmaz.
Nasıl düzeltilir: her artifacts: girdisinin benzersiz bir dosya adı olması için çakışan girdi anahtarlarından birini yeniden adlandırın.
Emission-time filename collision across input kinds (Yayım anında girdi türleri arasında dosya adı çakışması)
Bir Recipe ve bir FeatureRecipe, her biri dosya üreten girdi türleri bildirir: sağlayıcının işlediği bir source:, sağlayıcının sentezlediği bir workload:, artifacts: girdileri ve adımları çıktı yayabilen bir pipeline:. Bunların her biri çıktı adlarını diğerlerinden bağımsız olarak seçer ve hiçbir şey bu adların birbirinden farklı olduğunu bildirmez; bu nedenle ikisi tek bir ad altında dosya üretebilir ve ikisinden yalnızca biri kalır. Derleme durur ve çıktı adını, onu üreten her blokla birlikte belirtir.
Denetim, yayım yapan her belge için bir kez, o belgenin kendi yayımı tamamlanır tamamlanmaz ve çıktısı herhangi bir birleştirmeye katılmadan önce çalışır. Üç belge yayım yapar ve her biri ayrı denetlenir: bir bileşenin kendi Recipe’i, bir eklentinin bir bileşen üzerinde bağladığı FeatureRecipe ve sınır kapsamlı bir eklentinin bağladığı FeatureRecipe. Tanılamanın doğru belgeyi belirtmesini sağlayan, bunların ayrı tutulmasıdır: bir eklentinin dosyaları ana bileşeninin kimliği altında işlenir, bu nedenle eklentinin FeatureRecipe’indeki bir çakışma ana bileşene karşı değil, o FeatureRecipe’e karşı raporlanır.
Çakışan her ad ayrı raporlanır; bu nedenle blokları iki adda karşılaşan bir belge ikisini de raporlar. Bir bulgu, onu düzeltmek için düzenlediğiniz belgede konumlandırılır: bir Recipe için bileşen örneğinde, bir eklenti için ise FeatureRecipe’in kendisinde; bu bulgu eklentiyi de belirtir, çünkü bir bileşen veya sınır birden fazla eklenti bağlayabilir.
Tek bir ad altında birden fazla dosya yayan tek bir blok bu durma değildir. Bu, iki bloğun karşılaşması değil tek bir katkıdır ve tek bir blok içindeki yinelenen artifacts: anahtarları belge çözümlenirken reddedilir.
Üretilen ileti:
filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (girdi türleri arasında dosya adı çakışması: iki girdi türü bloğu tek bir çıktı adı altında dosya üretti; çıktı adı ve onu üreten bloklar belirtilir)
Bir FeatureRecipe’deki çakışma eklentiyi de içerir:
filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (girdi türleri arasında dosya adı çakışması: iki girdi türü bloğu tek bir çıktı adı altında dosya üretti; çıktı adı, onu üreten bloklar ve ek belirtilir)
Nasıl düzeltilir: çakışan dosyayı denetiminizdeki girdi türünde yeniden adlandırın. Çakışma, Workload’dan çevrilmiş bir dosya adı ile bir artifacts: girdisini içeriyorsa, Workload’dan çevrilmiş adlar sağlayıcının çeviri uzlaşımlarını izler (örneğin helm için <release-name>-deployment.yaml; burada sürüm adı {{ .context.rendered_name }} olur); artifacts: dosya adını sağlayıcının sentezlemediği bir adla değiştirin.
An output-label key uses a reserved namespace (Bir çıktı etiketi anahtarı ayrılmış bir ad alanı kullanıyor)
Bir Recipe, aggrega.ai/ veya app.kubernetes.io/ altında bir etiket anahtarı belirtir: işlenmiş çıktıya değişmez etiketler basan blok olan outputLabels: içinde ya da değerleri çıktıya yükseltilen bileşen etiketi anahtarlarını belirten blok olan outputComponentLabels: içinde. Her iki önek de platformun kendi köken anahtar alanına aittir: bunlar derlemenin kendisinin bastığı anahtarlardır, bu nedenle bunlardan birini basan bir Recipe, bir kaynağın nereden geldiğini söyleyen alana yazmış olur. Bunların ayrılması, bir Recipe’in etiket kümesini köken kümesinden ayrık tutan şeydir de; böylece ikisi birleştirildiğinde hiçbir zaman uzlaştırılmaları gerekmez. Bu kural Recipe yüklenirken denetlenir.
Ayırma yalnızca yalın kök için geçerlidir. Ayrılmış bir kökü yalnızca kendine ait bir ad alanının daha derininde taşıyan bir anahtar (örneğin component.aggrega.ai/hosting), platformun sahip olmadığı farklı bir anahtar alanıdır ve yazılabilir kalır.
Yayımlanan ileti. Tek bir koşul iki bloğu da kapsar, bu nedenle cümlesi ikisinden hangisinin yazıldığını söyleyemez; ardından gelen öneri, yazdığınız anahtarı ve onu yazdığınız bloğu alıntılayarak bloğu belirtir:
recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe output-labels kısıtı: anahtar ayrılmış bir ad alanı kullanıyor; Recipe, kural output-labels ve konum belirtilir. outputLabels içindeki anahtar ayrılmış bir ad alanı kullanıyor; aggrega.ai/ ve app.kubernetes.io/ platform kaynak bilgisi için ayrılmıştır)
Yükseltilen blokta yazılmış bir anahtar, o bloğun kural adı altında raporlanır ve öneride bu bloğu belirtir:
recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe output-labels kısıtı: anahtar ayrılmış bir ad alanı kullanıyor; Recipe, kural output-component-labels ve konum belirtilir. outputComponentLabels içindeki anahtar ayrılmış bir ad alanı kullanıyor; aggrega.ai/ ve app.kubernetes.io/ platform kaynak bilgisi için ayrılmıştır)
Değişmez bloğun anahtarları sıralı düzende, yükseltilen bloğunkiler ise yazdığınız sırayla denetlenir; bu nedenle kuralı birden fazla yerde ihlal eden bir Recipe her zaman aynı ihlali ilk olarak raporlar.
Nasıl düzeltilir: anahtarı sahip olduğunuz bir ad alanına taşıyın (kendi alan adınız ya da component.aggrega.ai/… gibi alt önekli bir ad alanı) veya istediğiniz değer derlemenin zaten bastığı bir değerse anahtarı kaldırın. İşlenmiş bir kaynağın taşıdığı köken anahtarları ../providers/well-known-annotations.md içinde listelenir; bunlardan birini geri okumak için Recipe bildirimi gerekmez.
A promoted component label is also declared literally (Yükseltilen bir bileşen etiketi değişmez olarak da bildirilmiş)
Bir Recipe, bir anahtarı hem outputComponentLabels: hem de outputLabels: içinde belirtir. İki blok aynı etiket yüzeyine farklı kaynaklardan basar: ilki bileşenin taşıdığı değeri yükseltir, ikincisi Recipe yazarının yazdığı değeri yazar; bu nedenle ikisinde de belirtilen bir anahtar iki aday değerle gelir ve hangisinin kazanacağını söyleyen bir şey yoktur. Bu kural Recipe yüklenirken, yukarıdaki ayrılmış ad alanı kuralından sonra denetlenir; bu nedenle ikisini de ihlal eden bir Recipe önce ayrılmış ad alanını raporlar: o hatanın düzeltilmesi diğer bloğun içeriğine bağlı değildir.
Üretilen ileti:
recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (Recipe output-component-labels kısıtı: anahtar outputLabels içinde de bildirilmiş; Recipe, kural output-component-labels ve konum belirtilir. Anahtar outputComponentLabels aracılığıyla yükseltiliyor ve outputLabels içinde de değişmez olarak bildiriliyor; etiketin gelmesi gereken kaynağı tutun ve diğerini kaldırın)
Nasıl düzeltilir: etiketin değerinin nereden geleceğine karar verin ve diğer bildirimi silin. Değer, bileşenin taşıdığı her neyse onu izlemeliyse outputComponentLabels: girdisini tutun; böylece tek bir Recipe’e bağlı iki bileşen kendi değerlerini basar. Değer Recipe’in kendisine aitse ve Recipe nereye bağlanırsa bağlansın aynıysa outputLabels: girdisini tutun.
FeatureRecipe biçim kuralları
Bir FeatureRecipe çıktısını bir Recipe ile aynı girdi türlerinden oluşturur ve aşağıdaki oluşturma kuralı onu bir Recipe’yi kısıtladığı gibi kısıtlar. Kural, FeatureRecipe yüklenirken denetlenir ve bir Recipe biçim durmasının aldığı biçimde raporlanır: kuralın cümlesi, ardından hatalı belge, kuralın adı ve o oluşum için öneri; CATALOG_ERROR etiketi altında.
Burada bilinçli olarak en az bir girdi türü kuralı yoktur ve Recipe’ten farkı budur. Yalnızca bir sağlayıcı ve neyi uyguladığını bildiren bir FeatureRecipe, meşru bir salt bağlantı eklentisidir: hiçbir şey işlemez ve etkisi, uyguladığı Feature’ın taşıdığı bağlantıdır. Yalnızca injectMapping: bildiren bir FeatureRecipe de aynı şekilde meşrudur.
A FeatureRecipe’s valuesMapping requires source (FeatureRecipe’in valuesMapping alanı source gerektirir)
Bir FeatureRecipe, valuesMapping bildiriyor ancak source bildirmiyor. Değer eşlemesi bir katmandır; bu nedenle üzerine bindirilecek bir chart, modül veya dosya olmadan eşlenen değerlerin ulaşabileceği bir yer yoktur.
Üretilen ileti:
FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping, source gerektirir (FeatureRecipe <name>:<version>, kural values-mapping, konum <path>). valuesMapping’in yanında bir source: işaretçisi bildirin (ya da bir overlay amaçlanmıyorsa valuesMapping’i kaldırın))
Nasıl düzeltilir: katmanın yazıldığı source: işaretçisini ekleyin ya da valuesMapping’i kaldırıp eklentinin işini başka bir yolla yapmasına izin verin: kendi dosyalarını üretmek için artifacts:, ilettiği şeyi yeniden biçimlendirmek için injectMapping: ya da salt bağlantı amaçlı bir eklenti için hiçbiri.
A pipeline declares one step id twice (Bir işlem hattı bir adım kimliğini iki kez bildiriyor)
Bir Recipe ya da FeatureRecipe, spec.pipeline alanının iki adımında aynı id değerini bildirir. Bir adım döndürdüğü çıktıları kendi kimliği altında yayımlar ve aynı işlem hattının sonraki bir adımı bunları .steps.<id>.outputs olarak okur; bu nedenle aynı kimliği paylaşan iki adım, sonraki adımın kastettiğiniz adımı değil, ikisinden en son yayımlayanı okumasına yol açar.
Kural, tek bir belgenin kendi işlem hattını kapsar. Bir bileşenin Recipe’si ve ona eklenen FeatureRecipes, işlem hatlarını ayrı ayrı çalıştırır ve her işlem hattı hiçbir adım çıktısı olmadan başlar; bu nedenle bir Recipe adımı ile eklenmiş bir FeatureRecipe adımı aynı kimliği taşıyabilir.
Hiçbir şema bu kuralı ifade edemez — JSON Schema’da girdileri alanlarından birine göre benzersiz olan bir liste için anahtar sözcük yoktur — bu nedenle şemaya duyarlı bir düzenleyici böyle bir belgeyi kabul eder ve denetim, belge okunurken, şema denetiminin hemen ardından çalışır. Bir Recipe ya da FeatureRecipe okuyan her yüzey bunu raporlar: dosya üzerinde ya da tüm katalog üzerinde aggrega validate, kataloğu yükleyen bir derleme, getirilen bir varlığı kabul eden bir pull, düzenleyicinin tanılamaları ve yazılmak yerine reddedilen bir belge düzenlemesi. Şemasını da karşılamayan bir belge önce şemanın bulgularını, bunlar düzeltildiğinde ise bu reddi raporlar.
Her tekrar kendi başına bir bulgudur; tekrarlanan id konumunda yer alır ve kimliği ilk bildiren adımı satır ve sütunuyla birlikte adlandırır. Bir kimlik üç kez geçtiğinde, sonraki iki adımın her ikisi de ilkini adlandırır.
İkinci adımı ilk adımın kimliğini tekrarlayan bir FeatureRecipe için yayılan ileti. Kategori ve bu koşulun kısa kodu E0370, köşeli parantez içindeki başlıkta size ulaşır:
a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (bir işlem hattı bir adım kimliğini iki kez bildiriyor; spec.pipeline[1].id adım kimliği spec.pipeline[0].id konumunda zaten bildirilmiş. işlem hattının her adımına kendi kimliğini verin ve sonraki bir adımın yaptığı her adım başvurusunu kastettiği adıma yönlendirin)
Nasıl düzeltilir: her kimlik bir kez bildirilecek şekilde iki adımdan birini yeniden adlandırın. Ardından sonraki her adımın with: ve when: şablonlarını, koruduğunuz kimliğe yapılan .steps.<id> başvuruları için okuyun ve her birini çıktılarını kastettiği adıma yönlendirin — iki adımın çıktılarını ayrı ayrı erişilebilir kılan şey yeniden adlandırmadır.
A document declares an API version this compiler no longer reads (Bir belge, bu derleyicinin artık okumadığı bir API sürümü bildiriyor)
Bir belgenin apiVersion satırı aggrega.ai/v1alpha1’i bildiriyor. apiVersion satırı taşıyan her belge türü, bu derleyicinin okuduğu tek sürüm olan aggrega.ai/v1beta1’i bildirir ve önceki sürümden herhangi bir dönüştürme yapılmaz: belge, okunurken, başka hiçbir şey denetlenmeden önce reddedilir, çünkü diğer her bulgu, belgenin derleyicinin okumadığı bir sürümüyle ilgili olurdu.
Belge okuyan her yüzey bunu bildirir: aggrega validate, bir derleme, getirilen bir varlığı kabul eden bir pull, düzenleyicinin tanılamaları ve bir belge düzenlemesi. Derleyicinin hiç okumadığı bir sürümü bildiren bir belge ise bunun yerine kendi türünün şeması tarafından E0215 koduyla reddedilir.
Bir Component için verilen ileti. Bu koşulun kategorisi ve kısa kodu E0373, köşeli parantez içindeki başlıkta size ulaşır:
a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (bir belge, bu derleyicinin artık okumadığı bir API sürümü bildiriyor (Component); 1:1: apiVersion: belge aggrega.ai/v1alpha1 bildiriyor ve bu derleyici aggrega.ai/v1beta1 okuyor. apiVersion satırını aggrega.ai/v1beta1 olarak değiştirin)
Nasıl düzeltilir: belgenin apiVersion satırını apiVersion: aggrega.ai/v1beta1 olarak değiştirin. Her türün alanları iki sürüm arasında değişmemiştir, bu nedenle değişikliğin tamamı bu satırdır.
A plugin declares a plugin ABI version this compiler no longer speaks (Bir eklenti, bu derleyicinin artık desteklemediği bir eklenti ABI sürümü bildiriyor)
Bir eklenti, eklenti ABI’si v1alpha1’i bildiriyor. Bu derleyici yalnızca eklenti ABI’si v1beta1’i destekler, başkasını desteklemez; bu nedenle önceki ABI’ye göre derlenmiş bir eklenti çalıştırılmak yerine reddedilir. Bir eklenti ABI’sini iki yerde belirtir ve her biri bu tek koşul altında reddedilir: konuk modülünün yüklendiğinde döndürdüğü describe() raporu ve Plugin varlığının spec.abiVersion alanı; ikincisi, varlık okunurken, başka hiçbir şey denetlenmeden önce reddedilir. Bu derleyicinin hiç desteklemediği bir ABI sürümünü bildiren bir eklenti de tanımlayıcı denetimi (E0085) ya da Plugin şeması (E0215) tarafından reddedilir.
Yükleme sırasında bir konuk modül için verilen ileti. Bu koşulun kategorisi ve kısa kodu E0374, köşeli parantez içindeki başlıkta size ulaşır:
plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (eklenti abi_version “v1alpha1” bildiriyor ve bu derleyici “v1beta1” destekliyor; eklentiyi güncel eklenti kitine göre yeniden derleyin ve yeniden yayımlayın: bir eklenti, bu derleyicinin artık desteklemediği bir eklenti ABI sürümü bildiriyor)
Bir Plugin varlığı için verilen ileti:
a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (bir eklenti, bu derleyicinin artık desteklemediği bir eklenti ABI sürümü bildiriyor (Plugin); spec.abiVersion: Plugin abiVersion v1alpha1 bildiriyor ve bu derleyici v1beta1 destekliyor. eklentiyi güncel eklenti kitine göre yeniden derleyin ve yeniden yayımlayın; ardından Plugin varlığı abiVersion v1beta1 bildirir)
Nasıl düzeltilir: eklentiyi, konuk modülün describe() raporuna v1beta1 yazan güncel eklenti kiti sürümüne göre yeniden derleyin ve yeniden yayımlayın; böylece yanında üretilen varlık da abiVersion: v1beta1 bildirir. Yalnızca varlığın satırını düzenlemek yeterli değildir: konuk modülün kendisi hâlâ önceki ABI’yi bildirir ve yüklendiğinde reddedilir.
An artifact carries a media type this compiler no longer reads (Bir yapıt, bu derleyicinin artık okumadığı bir medya türü taşıyor)
Bir kayıt defterinden getirilen bir yapıt, önceki bir sürümün yayımlarken kullandığı bir medya türü taşıyor — manifestin yapıt türünde, yapılandırmasında ya da katmanlarından birinde, sonekiyle birlikte application/vnd.aggrega.<kind>.v1alpha1. Bu derleyici v1beta1 medya türlerini yayımlar ve okur; bu nedenle yapıt, manifesti okunurken, içeriğinden herhangi bir şey alınmadan önce adıyla reddedilir: bir katalog varlığı, bir eklenti ve yürütülebilir dosyası ya da bir belge paketi fark etmez. Bir kayıt defterinin dizinlenmesi böyle bir yapıtı nedenini belirterek atlar. Aggrega’nın kendi application/vnd.aggrega. ad alanı dışındaki bir medya türü asla bu koşul değildir.
Önceki bir sürüm tarafından yayımlanmış bir Component için verilen ileti. Bu koşulun kategorisi ve kısa kodu E0375, köşeli parantez içindeki başlıkta size ulaşır:
"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (medya türü “application/vnd.aggrega.component.v1alpha1+yaml” taşıyor ve bu derleyici “application/vnd.aggrega.component.v1beta1+yaml” okuyor; yapıtı güncel sürümle yeniden yayımlayın: oci: yapıt, bu derleyicinin artık okumadığı bir medya türü taşıyor)
Nasıl düzeltilir: yapıtı, v1beta1 medya türlerini yazan güncel aggrega sürümüyle yeniden yayımlayın. Başka birinin yayımladığı bir yapıtı yeniden yayımlamak o kişiye düşer; o yapana kadar yapıt okunamaz.
A file cannot be read, or its bytes do not parse (Bir dosya okunamıyor veya baytları ayrıştırılamıyor)
Bir derlemenin okuması gereken bir dosya ya da katalog genelindeki bir denetimin katalog dizinleri altında okuduğu bir Aggrega belgesi, onu adlandıran veya okuyan yüzeyin kullanabileceği hiçbir şey üretmedi. Ya diskten okunamadı ya da baytları ayrıştırıldı ve temiz biçimde ayrıştırılamadı. Sonraki adımların hiçbiri bu dosya üzerinde çalışmaz, çünkü bir şemaya göre denetlenecek içerik, yerleştirilecek bileşen ve işlenecek şablon yoktur.
Bu durum hiçbir biçim adı vermez ve bu bilinçli bir tercihtir. Kapsadığı dosyaların çoğu YAML olarak okunur; bir Recipe’in workload, values-mapping ve artifact gövdeleri ise Go şablon kaynağı olarak okunur ve hiç ayrıştırılmaz. YAML vaat eden bir cümle, bir şablon dosyasıyla ilgili bir tanılamayı o dosyanın biçimine dair bir iddiayla başlatmış olurdu. İki hatadan hangisinin hangi tür dosyada gerçekleştiğini cümleden sonraki ifade söyler.
Bir derlemenin başladığı belgeler — Aggregate, Release ve Manifest — en yaygın öznelerdir ve bu üçünden birinin okunduğu her noktada durdurma tetiklenir. Tanılama, hangi belgenin okunduğunu ve hangi yoldan okunduğunu belirtir. Eksik bir dosyayı bozuk biçimli olandan ayırt ettiren yoldur: bir okuma hatası işletim sisteminin kendi gerekçesini, bir ayrıştırma hatası ise YAML ayrıştırıcısınınkini aktarır; ikincisi ayrıştırıcının vazgeçtiği satırı da içerir.
Dosyanın okunamadığı durumda yayımlanan mesaj:
file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Aggregate, <path> konumunda, dosya okunamadı: <underlying reason>))
ve metninin ayrıştırılamadığı durumda:
file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Aggregate, <path> konumunda, YAML çözümlenemedi: <underlying reason>))
Okunan belge bunlardan biri olduğunda Aggregate yerine Release ve Manifest görünür. Aynı durum, bir Aggregate’in bildirilmiş parameters: bloğundan okunan parametre sözleşmesini de kapsar; bu sözleşme, içine herhangi bir şey yerleştirilmeden önce Aggregate’in kendi metninden okunur.
Derlemenin erişemediği bir dosyayı adlandıran, bir Release’in parameters: { $import: … } ifadesi de burada raporlanır ve bu her iki durum için geçerlidir: yol, derlemenin okuyabileceği hiçbir dosyayı adlandırmaz ya da dosya okunur ve baytları ayrıştırılamaz. Özne Release’tir ve ifade dosyayı gösteren anahtarı belirtir:
file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Release, .spec.parameters.$import: <path> konumunda, dosya okunamadı: <underlying reason>))
file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Release, .spec.parameters.$import: <path> konumunda, YAML çözümlenemedi: <underlying reason>))
Göreli bir yol, komut nereden çalıştırılırsa çalıştırılsın, onu yazan Release’i — bir komutun adlandırdığı Release’i veya extends: zincirinin bir halkasını — barındıran dizinden çözümlenir; böylece komut satırı ve düzenleyici aynı dosyayı okur. Mutlak bir yol ise kendi konumunu belirtir. Derlemenin çalıştığı checkout’un dosyayı orada barındırdığını doğrulayın: sizin makinenizde bulunan ancak sürüm denetiminin dışında bırakılmış bir parametre dosyası, bir sürekli entegrasyon çalıştırması sırasında yoktur ve bu hatayla en sık bu şekilde karşılaşılır. Çalışma alanının — veya çalışma alanı dışında adlandırılmış bir Release için o Release’in kendi dizininin — dışına çıkan bir yol hiç okunmaz ve aşağıdaki “A reference to another file leads out of the directory it must stay inside (Başka bir dosyaya yapılan başvuru, içinde kalması gereken dizinin dışına çıkıyor)” altında raporlanır.
Derlemenin erişemediği bir dosyayı adlandıran bir şema $import: ifadesi de burada raporlanır, çünkü hata aynıdır: yönerge iyi biçimlidir ve adlandırdığı dosya bir belge üretmemiştir. Bu durumda özne üç belgeden biri değil bir katalog varlığıdır; bu nedenle ifade, çözümlemekte olduğu şema yüzeyini — spec.schema, spec.schema.values gibi onun bir sütunu ya da bir usesSchema soketinin valueSchema alanı — belirtir ve kaynak işaretçisi, yönergenin yazıldığı satırdır:
file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı. <surface>: içe aktarılan şema okundu <value>: <the operating system's reason>)
varlığın kendi dizininin hiç belirlenemediği daha seyrek hata için read yerine resolve imported schema path, dosyanın okunduğu ancak metninin iyi biçimli YAML olmadığı durumda ise parse imported schema görünür. Yazdığınız yönergedeki bir hata — yanındaki kardeş bir anahtar, yol olmayan bir değer veya ayrıştırılmış ancak bir eşlem olmayan içe aktarılmış içerik — farklı bir durumdur ve aşağıdaki “A schema $import: cannot be applied (Bir şema $import: ifadesi uygulanamıyor)” altında raporlanır.
Bir Recipe’in veya FeatureRecipe’in valuesMapping:, workload: ya da artifacts.<name>: içe aktarması da burada raporlanır; nedeni ve çözümü aynıdır: yönerge iyi biçimlidir ve adlandırdığı dosya içerik üretmemiştir. Bu üç gövde belge değil Go şablon kaynağıdır, dolayısıyla yalnızca okuma başarısız olabilir — bu noktada hiçbir şey onları ayrıştırmaz. Varlık ve yolu adlandıran anahtar ifadede yer alır; kaynak işaretçisi ise içe aktarılan dosyanın kendi yoludur:
file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Recipe <name> valuesMapping dosya içe aktarması, <the operating system's reason>). dosya yerine bir kitaplık girdisini kastettiyseniz başvurunun parçasına ihtiyacı vardır — parça içermeyen bir $import: dosya yolu olarak okunur ve tırnaksız bir değer, # öncesindeki bir boşluğun yorum başlattığı yerde biter; bu yüzden başvurunun tamamını tırnak içine alın)
file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Recipe workload dosya içe aktarması). dosya yerine bir kitaplık girdisini kastettiyseniz başvurunun parçasına ihtiyacı vardır — parça içermeyen bir $import: dosya yolu olarak okunur ve tırnaksız bir değer, # öncesindeki bir boşluğun yorum başlattığı yerde biter; bu yüzden başvurunun tamamını tırnak içine alın)
file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (dosya yüklenemedi: dosya okunamadı veya baytları ayrıştırılamadı (Recipe artifact dosya içe aktarması). dosya yerine bir kitaplık girdisini kastettiyseniz başvurunun parçasına ihtiyacı vardır — parça içermeyen bir $import: dosya yolu olarak okunur ve tırnaksız bir değer, # öncesindeki bir boşluğun yorum başlattığı yerde biter; bu yüzden başvurunun tamamını tırnak içine alın)
Bir kitaplık başvurusunu bir yoldan ayırt ettiren parçadır: <Library>#/mappings/<entry> kitaplıklara göre çözümlenir; parçası kaldırılmış aynı metin ise sıradan bir göreli yoldur. Parça fark edilmeden kolayca kaybolabilir, çünkü düz bir YAML değeri, # öncesindeki bir boşluğun yorum başlattığı yerde biter — bu yüzden $import: LibBeta:1.0.0 #/workloads/Web derlemeye LibBeta:1.0.0 olarak ulaşır ve derleme ardından Recipe’in yanında bu adda bir dosya arar. Parçayı korumak için başvurunun tamamını tırnak içine alın.
Bir FeatureRecipe üzerindeki aynı üç anahtar aynı durumu raporlar ve aynı şekilde okunur. Bir artifacts içe aktarması bir Release’in ömrü boyunca iki kez okunur — bir kez aggrega pull içerik sabitlemesini dondurduğunda, bir kez de girdi işlendiğinde — bu yüzden aynı eksik dosya bu durumu ikisinden hangisine önce ulaşırsanız orada raporlar. Yönergenin kendisindeki bir biçim hatası, örneğin $import: yanında kardeş bir anahtar veya ana makine içeren bir oci:// başvurusu, farklı bir durumdur ve kendi girdisi altında raporlanır.
Katalog genelindeki aggrega lint ve aggrega validate de burada raporlar; bu, katalog dizinleri altında bir Aggrega apiVersion (girintisiz olarak apiVersion: ile başlayan ve değeri aggrega.ai/ ile başlayan bir satır) bildiren ve okunamayan, ayrıştırılamayan ya da denetimin okuduğu zarfa çözülemeyen, örneğin liste olarak yazılmış bir metadata içeren bir belge içindir. Hiçbir yazar ona bir yol yazmamıştır: denetim onu bir katalog dizininde bulunduğu için okumuştur. Her denetim durmadan önce tüm dosyaları okur; böylece tek bir çalıştırma bu tür belgelerin hepsini adlandırır, başka hiçbir şeyi denetlemez ve özet yazdırmaz. Aggrega apiVersion bildirmeyen YAML (aralarında bir Helm chart’ın şablonları da vardır) atlanır. Başlık belgeleri sayar ve dosyalarını adlandırır; her biri, okumanın ya da ayrıştırıcının kendi nedeniyle birlikte altında listelenir:
<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (katalog dizinleri altındaki belgeler bir Aggrega apiVersion bildiriyor ancak yüklenemedi; bu nedenle hiçbir şey denetlenmedi)
file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (dosya yüklenemedi: dosya okunamadı ya da baytları ayrıştırılamadı (katalog belgesi, YAML çözülemedi))
ayrıştırılan ancak çözülemeyen bir belge için failed to decode the envelope: ile satır ve çözücünün orada bulduğu şeyle (liste olarak yazılmış bir metadata için line 4 (metadata): a list is written where a map is expected), okunamayan bir dosya için ise failed to read file: ve işletim sisteminin nedeniyle. Yüklenen ve hiçbir kataloğun tutmadığı bir tür bildiren bir belge aynı durdurma tarafından adlandırılır, aynı başlıkta sayılır ve kendi koşulu altında listelenir — aşağıdaki “A catalog document declares a kind a catalog does not hold (Bir katalog belgesi, kataloğun tutmadığı bir tür bildiriyor)” bölümüne bakın.
Nasıl düzeltilir: belgenin adını değil mesajdaki yolu okuyun — bir başvuru beklenmedik bir yerde çözümlendiğinde ikisi birbirinden farklıdır. Bir okuma hatasında dosyanın o yolda bulunduğunu, yolun başvuran belgenin yazdığı şekilde yazıldığını ve derlemenin onu okuma iznine sahip olduğunu doğrulayın; yerelde bulunan ancak bir derleme ajanının checkout’unda olmayan bir dosya en yaygın durumdur. Bir ayrıştırma hatasında dosyayı ayrıştırıcının belirttiği satırda açın — iki nokta üst üste içeren tırnaksız bir değer, girinti için kullanılan bir sekme ve yanlış anahtarın altına girintilenmiş bir liste öğesi, bu hataların çoğunu oluşturan üç nedendir.
A catalog document declares a kind a catalog does not hold (Bir katalog belgesi, kataloğun tutmadığı bir tür bildiriyor)
Katalog dizinleri altındaki bir belge bir Aggrega apiVersion’ı — girintisiz olarak apiVersion: ve aggrega.ai/ ile başlayan bir değerle başlayan bir satır — ve hiçbir kataloğun tutmadığı bir kind bildirir: Componnent gibi bir yazım hatası, component gibi yanlış büyük/küçük harfle yazılmış bir tür ya da hiç kind olmaması. Bir katalog her belgeyi bildirdiği türün altında dosyalar; bu nedenle böyle bir belge hiçbir kataloğa girmez: bir derleme, inspect ve kataloğu yükleyen diğer her komut onu atlar ve belgenin bildirmesi amaçlanan varlığa yapılan bir başvuru hiçbir şeye çözümlenmez.
Bir katalog Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate ve Plugin belgelerini tutar. Diğer üç tür meşru olarak onun dizinlerinde bulunur ve burada asla raporlanmaz: varlıkların yanında tutulan bir Manifest ve bir Release ile onu içe aktaran Recipe ya da FeatureRecipe’nin dizinindeki bir Workload.
Tüm katalog için aggrega validate ve aggrega lint ile aynı dizinleri dolaşan Release kapsamlı lint bunu raporlar. Her biri durmadan önce her dosyayı okur; bu nedenle tek bir çalıştırma, böyle her belgeyi hiç yüklenemeyen her belgeyle birlikte, onları sayan ve dosyalarını adlandıran tek bir başlığın altında adlandırır; hiçbir şey denetlenmez ve özet yazdırılmaz. Her belge bildirdiği türle birlikte listelenir ve satır, bir kataloğun tuttuğu türlerle biter:
<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (katalog dizinleri altındaki belgeler bir Aggrega apiVersion’ı bildiriyor ve yüklenemedi, bu nedenle hiçbir şey denetlenmedi) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (katalog belgesi, kataloğun tutmadığı bir tür bildiriyor. bir katalog Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate ve Plugin belgelerini tutar ve bir Workload’u, bir Manifest’i ya da bir Release’i atlar; türü düzeltin ya da dosyayı katalog dizinlerinin dışına taşıyın)
hiç tür bildirmeyen bir belge için kind "<kind>" yerine no kind ile.
Bir derleme böyle bir belgede durmaz: her yüklemenin yaptığı gibi onu atlar ve hiçbir Release’in ulaşmadığı bir belge bir derlemeyi asla başarısız kılmaz. Bir Release varlığa gerçekten ulaştığında derleme, aşağıdaki “A reference names no entity the catalog holds (Bir başvuru, kataloğun tuttuğu hiçbir varlığı adlandırmıyor)” altında başvuruda durur ve dosya başvurunun istediği adı bildiriyorsa bu hatanın altındaki not dosyayı adlandırır — o girdiye bakın.
Nasıl düzeltilir: iletinin adlandırdığı dosyayı açın ve kind değerini belgenin gerçekte olduğu türe göre düzeltin — hem yazım hem de büyük/küçük harf önemlidir. Hiç katalog varlığı olmayan bir dosya katalog dizinleri altında yer almamalıdır; onu dışarı taşıyın ya da başka bir aracın belgesiyse ona Aggrega’ya ait olmayan bir apiVersion verin.
Bir yol, varlığın kendi dizininin dışındaki içeriği adlandırıyor
Bir varlığın içeriği, varlığın kendi dizininde bulunur, çünkü varlığın bir yayınının taşıdığı her dosya oradan alınır. Bu dizinden çıkan bir yol, varlıkla birlikte taşınmayacak bir dosyayı gösterir; bu nedenle dosya, varlığı alan hiç kimse için orada değildir ve üzerine kaydedilen bir sabitleme, onların elde edemeyeceği baytlara kefil olur.
Bu nedenle bir varlığın taşıdığı içerik için yazdığı her yol, varlığın dosyasını tutan dizine göre okunur ve bu dizinin içinde kalmalıdır. Bu, bir Recipe’in ve bir FeatureRecipe’in source: alanını — yalın bir yol ya da yapılandırılmış biçimin url: değeri —, her valuesMapping:, workload: ve artifacts: girdisinin $import: ile içe aktardığı dosyayı ve bir Component’in ya da bir Feature’ın bütün olarak, pillar başına ya da bir usesSchema soketinin valueSchema ve infraSchema alanları için içe aktardığı her şemayı kapsar. Üç biçim dizinden çıkar: dizinin üstüne tırmanan bir yol; yazıldığı makinedeki bir yeri adlandıran mutlak bir yol; ve dizinin içinde yazılmış olup yol üzerindeki bir sembolik bağlantının onu dışarı taşıdığı bir yol — yol boyunca bir dizin ya da yolun sonundaki dosya, varlığın dizininin dışına çıkan bir bağlantı olduğunda. Tırmanıp yeniden içeri dönen bir yol — ./charts/../values.tmpl — dizinin içinde sıradan bir yoldur; dizinin içinde başka bir yere çıkan bir bağlantıdan geçen yol da öyledir. Dizine kendi adıyla yeniden giren bir tırmanış — 1.0.0 adlı bir dizinde yazılmış ../1.0.0/values.tmpl — reddedilir, çünkü dizinin adı taşınan şeyin parçası değildir: yayınlanmış bir varlık, tüketicinin önbelleğinin adlandırdığı bir dizinden okunur ve orada bu ad hiçbir şey bulmaz. Dışarı çıkan bir bağlantıdan geçen yol reddedilir, çünkü aksi halde bir yayın, bağlantının gösterdiği baytları, gösterdiği her yerden, varlığın içindeki bir ad altında taşırdı.
Varlık nerede okunursa okunsun reddedilir. Tüm katalog üzerinde bir aggrega validate, varlığın kendi dosyası üzerinde aggrega validate, aggrega pull ve aggrega build, varlığın dosyası okunurken bunu reddeder; bir Recipe’in ya da bir FeatureRecipe’in aggrega pin işlemi ve dört türden herhangi birinin aggrega push işlemi de herhangi bir şey getirilmeden, yazılmadan ya da yayınlanmadan önce reddeder. Şablon olarak yazılmış bir source:, derleme onu değerlendirene kadar hiçbir şey adlandırmaz; bu nedenle dizinin dışında bir yol üreten şablon, değerin var olduğu anda derleme tarafından reddedilir.
Bir Release farklıdır, bir varlık başvurusu da öyle. Bir Release başka varlıkları gösterir — Aggregate’ini, Manifest’ini, genişlettiği Release’i — ve hiçbir zaman yayınlanmaz; bu nedenle okuduğu hiçbir şey bir yere taşınmaz: bu yollar ve bir Release’in parameters: alanının içe aktardığı dosya yazıldığı gibi okunur. Bir Aggregate’in type alanı, Aggregate’in taşıdığı içeriği değil, kimliğiyle başka bir varlığı adlandırır ve o da kendi koşullarıyla çözümlenir: katalog dizinleri, önbellek ve kayıt defteri üzerinden, hiçbir zaman bir dosya yolu olarak değil.
Yolu yazıldığı gibi adlandıran, verilen ileti:
a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (bir yol, varlığın kendi dizininin dışındaki içeriği adlandırıyor. çözüm: dosyayı varlığı tutan dizine ya da onun altındaki bir dizine taşıyın ve o dizine göreli bir yolla adlandırın. Bir varlığın içeriği, varlığın kendi dizininde bulunur, çünkü bir yayınının taşıdığı her dosya oradan alınır; ondan çıkan bir yol, varlıkla birlikte taşınmayacak bir dosyayı gösterir)
ve bir bağlantının dizinden dışarı taşıdığı bir yol için, bağlantıyı ve nereye çıktığını adlandırarak:
a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (bir yol, varlığın kendi dizininin dışındaki içeriği adlandırıyor; bağlantı başka bir yere çıkıyor. çözüm: bağlantıyı, çıktığı şeyin varlığı tutan dizinin içine yerleştirilmiş bir kopyasıyla değiştirin. Bir varlığın içeriği, varlığın kendi dizininde bulunur, çünkü bir yayınının taşıdığı her dosya oradan alınır; ondan dışarı çıkan bir bağlantı, gösterdiği baytları varlığın içindeki bir ad altında taşırdı)
Okunduğu alan, iletinin üstündeki satırda adlandırılır: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema … ya da şablonlu bir kaynak için node "<name>" source.
Nasıl düzeltilir: dosyayı varlığın dizinine ya da onun altındaki bir dizine taşıyın ve yolunu o dizine göreli olarak yazın. Yolu bir bağlantı dışarı taşıyorsa, bağlantıyı çıktığı şeyin varlığın dizini içindeki bir kopyasıyla değiştirin. Birkaç Recipe’in paylaştığı bir chart, her biri kendi başına yayınlandığından her Recipe’in dizinine kopyalanır; birkaç Component’in paylaştığı bir şema, her Component’in daha sonra kimliğiyle başvurduğu bir SchemaLibrary’ye aittir; birkaç Recipe’in paylaştığı bir eşleme, workload ya da artifact gövdesi de eşleşen kütüphane türüne aittir.
Bir Recipe’in source: alanı, hiçbir şeyin nasıl edinileceğini bilmediği bir tür belirtiyor
Bir Recipe’nin source: alanı neyi işaret ettiğinin türünü söyler (bir chart, bir modül, bir compose projesi) ve her tür, o türe hizmet eden kaynak bağdaştırıcısı tarafından edinilir. Bu koşul, hiçbir kaynak bağdaştırıcısının hizmet etmediği bir türü raporlar; dolayısıyla bu programın içerdiği hiçbir şey kaynağı getiremez. Bir FeatureRecipe’nin source: alanı da aynı kurala tabidir.
Belge okunurken, hiçbir şey getirilmeden önce reddedilir: Recipe’yi tek başına denetlemek onu reddeder, ona ulaşan her Release de reddeder. Hiçbir şey denenmemiştir, çünkü hiçbir şey onu deneyemezdi; onu çalışıp başarısız olan bir edinimden ayıran budur.
Belgeyi, yazıldığı şekliyle türü ve hizmet verilen türleri adlandıran üretilen ileti:
no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (bu kaynak türüne hiçbir kaynak bağdaştırıcısı hizmet etmiyor (Recipe, kural source-kind). kaynak bu türü adlandırıyor; bir kaynak bağdaştırıcısının hizmet ettiği bir türü adlandırın ya da kaynağı, biçimi türünü belirten tek bir URI olarak yazın)
Nasıl düzeltilir:source: üzerindeki türü, araç zincirinin hizmet verdiği bir türe düzeltin. Yazım hatası ile gerçekten bağdaştırıcısı olmayan bir tür aynı iletiyi üretir ve ileti, yazdığınız türü hizmet verilen türlerin yanında aktarır; bu yüzden ilk kontrol edilecek şey yazımın o listeyle karşılaştırılmasıdır; bu liste Recipe sayfasında da açıklanır. Tür istediğiniz gibi yazılmışsa, o tür bu derlemenin edinebileceği bir tür değildir ve Recipe’de yapılacak hiçbir yazım değişikliği bunu değiştirmez; bunun yerine source: alanını hizmet verilen bir biçime yönlendirin ya da onu, biçimi türünü belirten tek bir URI olarak yazın.
No source adapter is registered in this program for a source kind (Bu programda bir kaynak türü için kayıtlı kaynak bağdaştırıcısı yok)
Bir kaynak, türü için kaydedilmiş bağdaştırıcı tarafından getirilir. Bu koşul, hiçbir bağdaştırıcının kayıtlı olmadığı bir türe yönlendirilen bir getirme işlemini raporlar. Hiçbir bağdaştırıcının hizmet etmediği, yazılmış bir tür, Recipe’si okunurken reddedilir (yukarıdaki “A Recipe’s source: names a kind nothing knows how to acquire (Bir Recipe’nin kaynağı, hiçbir şeyin edinmeyi bilmediği bir türü adlandırıyor)” bölümüne bakın); dolayısıyla bir yazarın yazdığı hiçbir şey buraya ulaşmaz: bu koşul, hizmet ettiği bir tür için bağdaştırıcı olmadan derlenmiş bir programı ya da Aggrega’nın Go paketleri üzerine kurulmuş ve kendi derlediği bir türü yönlendiren bir programı raporlar.
Türü adlandıran üretilen ileti:
kind "<kind>": no source adapter is registered in this program for the source kind (bu programda bu kaynak türü için kayıtlı kaynak bağdaştırıcısı yok)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz. Durumu, çalıştırdığınız ikili dosyayı derleyen kişiye bildirin.
A source URL carries a credential (Bir kaynak URL’si kimlik bilgisi taşıyor)
Bir kaynak url değeri yazdığınız gibi kaydedilir (Release’in kilit dosyasında, Recipe’nin yanındaki entity.lock dosyasında ve kaynak önbelleğinde) ve Recipe’nin kendisi de commit ettiğiniz ve yayınlayabileceğiniz bir dosyadır. Bu yüzden URL’ye yazılmış bir kimlik bilgisi, URL’nin gittiği her yere taşınır. Bu koşul, url değeri ana bilgisayardan önce bir kullanıcı yazan bir Recipe source: alanını raporlar: https://user:token@host/… ya da tek başına https://token@host/… olarak yazılmış bir belirteç; çünkü HTTP üzerinden erişilen bir hizmet genellikle kullanıcının yerinde bir belirteç alır. http ve https üzerinde orada yazılmış her kullanıcı sayılır; başka bir şemada yalnızca parola sayılır, çünkü orada tek başına yazılmış bir kullanıcı bir hesabı adlandırır: ssh://git@github.com/… kabul edilir ve anahtarı SSH aracısı sağlar. Bir FeatureRecipe’nin source: alanı da aynı kurala tabidir.
Belge okunurken, hiçbir şey getirilmeden önce reddedilir: Recipe’yi tek başına denetlemek onu reddeder, ona ulaşan her Release de bir doğrulamada, bir pull’da, bir pin’de ya da bir derlemede reddeder. İleti ana bilgisayarı adlandırır, kimlik bilgisini asla adlandırmaz. Denetim URL’nin yalnızca ana bilgisayardan önce yazılan kısmını okur, başka hiçbir şeyi okumaz; bu yüzden bir sorgu dizesinde ya da yolda taşınan bir belirteç algılanmaz ve URL’nin geri kalanı gibi yazıldığı şekliyle kaydedilir.
http ya da https üzerinden, belgeyi, anahtarı ve ana bilgisayarı, ardından kimlik bilgisinin nereye ait olduğunu adlandıran üretilen ileti:
the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (kaynak URL’si bir kimlik bilgisi taşıyor (Recipe, kural source-url). spec.source.url bu ana bilgisayar için bir kullanıcı ya da parola adlandırıyor; onu URL’den kaldırın ve kimlik bilgisini bunun yerine netrc dosyasına machine, login, password girdisi olarak yazın (NETRC’nin adlandırdığı dosya, yoksa giriş dizininizdeki .netrc ya da Windows’ta %USERPROFILE% içindeki _netrc))
ve başka bir şema üzerinden, çözümün parolayı kaldırmak olduğu durumda:
the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (kaynak URL’si bir kimlik bilgisi taşıyor (Recipe, kural source-url). spec.source.url bu ana bilgisayar için bir parola adlandırıyor; onu, kilit dosyasına ve önbelleğe yazıldığı gibi kaydedilen URL’den kaldırın)
Nasıl düzeltilir: kullanıcıyı ve parolayı url değerinden kaldırın; ana bilgisayarı adlandıran URL kalsın. http ya da https üzerinden getirilen bir kaynak için kimlik bilgisini, netrc dosyanızda o ana bilgisayara ait bir machine girdisine koyun; bu dosya, klasik bir Helm chart deposunun, bir compose parçasının ya da HTTP veya HTTPS üzerinden bir Git deposunun her getirilişinde okunur. Hangi dosya ve hangi girdi olduğunu Kimlik doğrulama açıklar. SSH üzerinden bir Git deposu için anahtarı SSH aracısı sağlar ve kullanıcı kalabilir. Recipe kimlik bilgisi içindeyken zaten commit edilmiş ya da yayınlanmışsa, kimlik bilgisi o geçmiştedir: onu sunucuda da değiştirin.
A {{ .parameters.* }} reference cannot be interpolated (Bir {{ .parameters.* }} başvurusu enterpole edilemiyor)
Aggregate’in metni, bir belge olarak okunmadan önce bir şablon olarak değerlendirilir; böylece bir {{ .parameters.<key> }} başvurusu, Release’in onun için sağladığı değerle değiştirilir. Bu durdurma, söz konusu değerlendirme tamamlanamadığında tetiklenir: metin bir şablon olarak ayrıştırılamaz ya da ayrıştırılır ve çalışırken başarısız olur.
Enterpolasyon, Aggregate YAML olarak ayrıştırılmadan önce gerçekleşir; buradaki bir hatanın Aggregate’in içindeki bir anahtarda değil, Aggregate’in bütününe karşı raporlanmasının nedeni budur: o noktada belgenin henüz anahtarı yoktur. Başvurunun tırnaksız bırakılabilmesinin nedeni de budur: yerine koyma ham baytlarda gerçekleşir ve ardından değerin türünü YAML’ın kendi tırnaklama kuralı belirler; böylece çıplak bir başvuru değerin doğal türünü, tırnaklı bir başvuru ise bir dize verir.
Release’in sağlamadığı bir anahtarı adlandıran bir başvuru bu durdurma değildir. Eksik bir anahtar burada boş bir değere çözümlenir ve türü ve sözleşmesiyle birlikte, yukarıda “Parameter type mismatch / contract violation (Parametre türü uyuşmazlığı / sözleşme ihlali)” altında açıklanan parametre denetimleri tarafından yakalanır. Bu durdurmanın raporladığı, şablon motorunun hiç işleyemediği metindir: kapatılmamış bir {{, yanlış yazılmış bir işlev adı, aşamaları birbirine uymayan bir işlem hattı. Release böyle bir parametre sağlamadığında bir parametreyi index aracılığıyla okumak ({{ index .parameters "db_size" }}) çalışma sırasında bir başarısızlıktır ve bu durdurma, anahtarı adlandırarak onu taşır: aşağıda “A template indexes a map with a key the map does not hold (Bir şablon, bir eşlemeyi eşlemenin içermediği bir anahtarla indeksliyor)” bölümünün açıkladığı gibi, index her şablon yüzeyinde eşlemenin içermediği bir eşleme anahtarında durur.
Hiç ayrıştırılamayan metin, Aggregate’in kendi yolu adlandırılarak reddedilir, çünkü o dosya herhangi bir şey onu okumadan önce eldedir. Bileşimin içe aktardığı bir modül de bir düzey içeride aynı şekilde değerlendirilir; orada metni derlemeye verilmek yerine katalogdan okunur. Durdurma her iki durumda da aynı koşuldur ve aynı kodu taşır; bir modül için ayrıca izlediği içe aktarmayı ve modülün metninin okunduğu dosyayı da adlandırır ve taşıdığı ileti yalnızca türü adlandırır; dolayısıyla o iletinin verdiği konum, başladığınız Aggregate’teki değil, modülün kendi metnindeki bir konumdur.
Ayrıştırılamayan bir şablon, bileşimin içe aktardığı bir modüldeki aynı hata ve çalışırken başarısız olan bir şablon için üretilen iletiler:
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (geçersiz parametre başvurusu: {{ .parameters.* }} ifadesinin bildirilmiş bir parametreyi adlandırdığını ve bir Go şablonu olarak ayrıştırıldığını denetleyin)
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (geçersiz parametre başvurusu: {{ .parameters.* }} ifadesinin bildirilmiş bir parametreyi adlandırdığını ve bir Go şablonu olarak ayrıştırıldığını denetleyin)
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (geçersiz parametre başvurusu: {{ .parameters.* }} ifadesinin bildirilmiş bir parametreyi adlandırdığını ve bir Go şablonu olarak ayrıştırıldığını denetleyin)
Bir Aggregate’in metninin tek bir kökü vardır, .parameters; bu yüzden başka bir kök üzerinden yapılan bir başvuru ({{ .values.app_token }} ya da {{ $.values.app_token }}) hiçbir şey okumaz ve çalışırken başarısız olur. Bu durumda neden, okuduğu başvuruyu adlandırarak başlar:
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (geçersiz parametre başvurusu: parameters ifadesinin bildirilmiş bir parametreyi adlandırdığını ve bir Go şablonu olarak ayrıştırıldığını denetleyin (Aggregate; şablon bu başvuruyu okuyor, ancak bir Aggregate’in metni .parameters dışında kök tanımlamaz; şablon yürütme hatası))
Nasıl düzeltilir: Aggregate’i açın ve metindeki konumu ve başarısız olan yapıyı adlandıran temel nedeni okuyun. Her {{ için }} bulunduğunu, çağırdığınız işlevin yüzeyin sunduğu bir işlev olduğunu (parametre enterpolasyonu Sprig’in işlevlerini sunar, başka hiçbir şeyi sunmaz; dolayısıyla optional yardımcısı burada kullanılamaz) ve bir işlem hattının aşamalarının kendilerinden önceki aşamanın ürettiğini kabul ettiğini doğrulayın. Neden, index işlevinin bulamadığı bir anahtarı adlandırıyorsa, ayarlanmamış olabilecek bir parametreyi nokta ile ({{ .parameters.db_size }}) ya da Sprig’in get veya hasKey işlevleriyle okuyun. Neden, başka bir kök üzerinden bir başvuruyu adlandırıyorsa, değeri Aggregate’in bir parametresi olarak bildirin ve {{ .parameters.<key> }} olarak okuyun. Neden, hiçbir zaman şablon olarak düşünmediğiniz bir şeyi adlandırıyorsa (bir n8n ifadesinden gelen undefined variable "$json" ya da adını bir Flowise düğümünden alan bir işlev), metin bir yorum dahil kendi çift süslü parantezlerini taşıyordur: Kendi çift süslü parantezlerini taşıyan metin bölümünün açıkladığı gibi, içindeki her {{ ifadesini {{"{{"}} olarak yazın.
The Release directory declares one Aggregate or Manifest twice (Release dizini bir Aggregate’i veya Manifest’i iki kez bildiriyor)
aggregate: veya manifest: başvurusu çıplak bir kimlik olan bir Release, önce Release’in kendi dizini taranarak çözümlenir ve bu tarama aynı metadata.name değerini taşıyan iki Aggregates (ya da iki Manifests) buldu. Çıplak kimlikli bir başvuru bir varlığı o adla adlandırır; dolayısıyla iki kez sahiplenilen bir adı dizin yanıtlayamaz.
Tarama, yalnızca bir başvurunun istediği adı değil, dizini bütünüyle reddeder. Release’in yanında duran her Aggregate’i ve her Manifest’i okur; dolayısıyla hiçbir başvurunun adlandırmadığı çakışan bir çift de derlemeyi durdurur: bu Release o varlığı okumak üzere olan Release olsun ya da olmasın dizin belirsizdir. Yol olarak yazılmış bir başvuru (./aggregate.yaml, ../shared/manifest.yaml) bir varlığa değil bir dosyaya yönelir ve tarama olmadan çözümlenir; bu nedenle aggregate: ve manifest: değerlerinin ikisi de yol olan bir Release taramayı hiçbir zaman çalıştırmaz.
Bu, kataloğun yinelenen kimlik reddinin aynı dizindeki karşılığıdır ve ikisi ayrı ayrı raporlanır; böylece ileti, aklınızda olmayabilecek bir katalog katmanını değil, içinde bulunduğunuz dizini adlandırır.
Üretilen ileti:
duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (Release dizininde yinelenen Aggregate/Manifest kimliği (metadata.name): Aggregate, Release dizininde birden fazla kez bildirilmiş)
iki Manifests çakıştığında Aggregate yerine Manifest yer alır.
Nasıl düzeltilir: iki varlıktan birine farklı bir metadata.name verin ya da onu Release’in dizininin dışına taşıyın. Aynı adlı farklı Aggregates’i gerçekten dağıtan iki Releases kendi dizinlerine aittir; bir Release’i, taşıdığı şeyi yeniden adlandırmadan kardeş bir dosyaya kopyalamak, bu durumun genellikle ortaya çıkış biçimidir.
A Release’s aggregate: or manifest: reference resolves to nothing (Bir Release’in aggregate: veya manifest: başvurusu hiçbir şeye çözümlenmiyor)
Bir Release, bir Aggregate’i veya Manifest’i çıplak kimlikle adlandırıyor ve çıplak bir kimliğin arandığı yüzeylerin hiçbirinde o adda bir varlık bulunamadı: Release’in kendi dizini, katalog ve kayıt defteri.
Hiçbir yerde eşleşme olmadığında üretilen ileti:
aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (aggregate/manifest başvurusu çözümlenemiyor: Release dizininde, katalogda veya kayıt defterinde bu adı taşıyan bir Aggregate yok)
Release’in dizininde indekslenemeyen bir dosya raporu değiştirir, çünkü dürüstçe öne sürülebilecek şeyi değiştirir. Böyle bir dosya aranan varlık olabilirdi; bu nedenle ileti, kanıtlayamayacağı bir yokluğu ileri sürmek yerine bunu belirtir ve dosyanın okunmasını engelleyen ayrıştırma hatasını taşır:
aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (aggregate/manifest başvurusu çözümlenemiyor: Aggregate bulunamadı; ayrıştırılamayan dosya dizinlenemedi ve aranan varlık bu dosya olabilir)
ve ayrıştırılamayan dosya, başvurunun doğrudan adlandırdığı dosya olduğunda:
aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (aggregate/manifest başvurusu çözümlenemiyor: gereken Aggregate, ayrıştırılamayan dosyadır)
Nasıl düzeltilir: başvuru gerçekten yoksa yazımını düzeltin (kimlik, varlığın dosya adı değil metadata.name değeridir) ya da varlığı Release’in dizinine veya derlemenin okuduğu kataloğa ekleyin. İleti ayrıştırılamayan bir dosyayı adlandırıyorsa önce o dosyayı düzeltin: ayrıştırma hatası iletide alıntılanır ve onu onarmak çoğu zaman başvuruyu aynı düzenlemede çözümler. Bir ./ veya ../ başvurusu kimlik değil yoldur ve yol olarak çözümlenir; dolayısıyla baştaki bir nokta, iki hatadan hangisini aradığınızı değiştirir.
A component is placed in more than one boundary (Bir bileşen birden fazla sınıra yerleştirilmiş)
Bir Release’in sınır ağacı bir bileşeni iki farklı sınıra yerleştiriyor. İki yerleştirme ne birleştirilir ne de sıralanır ve bu mümkün de değildir: bir bileşenin sınırı, çıktısının nereye yazılacağını, hangi alt dizine düşeceğini, hangi senkronizasyon dalgasına katılacağını ve hangi sınır açıklamalarını ve sınır altyapısını devralacağını belirler; kenar başına uses: yüzeyi ise ayrı bir gezinmeyle okunur. İki kez adlandırılan bir bileşen, çıktı konumunu bir yerleştirmeden, kenar başına yapılandırmasını ise diğerinden alırdı.
Bir sınır bileşenleri üç yolla yerleştirir ve üçü de sayılır. Birini doğrudan components: altında, kompozisyon tamamlandığında taşıdığı kimlikle adlandırmak onu yerleştirir. Birini bir yönlendirme girdisinin kendi components: bloğu içinde, o alt modül içinde taşıdığı yerel adla adlandırmak da onu yerleştirir. Bir alt modülün tamamını aggregates: altında yönlendirmek ise o modülün içerdiği her bileşeni yerleştirir. Dolayısıyla bu durdurma, iki sınıra yönlendirilen tek bir alt modülü, bir sınıra yönlendirilen bir modülün içinde iç içe geçmiş bir modülün başka bir sınıra yönlendirilmesini ve bir bileşenin bir sınırda adlandırılırken onu içeren modülün farklı bir sınıra yönlendirilmesini de kapsar.
Bir modülü bir sınıra yönlendirip bileşenlerinden birini de o aynı sınır altında adlandırmak bir çakışma değildir; iki yerleştirme de bileşenin nereye ait olduğunda uyuşur ve derleme başarılı olur. Tek bir sınır altında iki kez yazılan bir kimlik ise orada bile bir çakışmadır: sınırın components: bloğundaki bir girdi ile sınırın yönlendirme girdisi içinde aynı bileşen için bir girdi, tek bir bileşen için yapılandırma taşıyan iki girdidir ve aralarında seçim yapacak bir şey yoktur.
Her hatalı yerleştirme raporlanır. Birkaç bileşeni iki kez yerleştiren bir Release, tek bir derlemede hatalı her girdi için bunlardan biriyle, her biri itiraz ettiği girdinin anahtarında olmak üzere durur; dolayısıyla birkaçı bir arada, birden fazla kez yazılmış tek bir hata değil, bulduğu her şeyi adlandıran tek bir derlemedir.
Bir iletinin zaten geçerli olarak raporladığı yerleştirme her zaman dosyada ilk yazılan değildir. Bir sınırın kendi components: girdileri, yönlendirme girdilerinin adlandırdığı bileşenlerden ve yönlendirdiği alt modüllerden önce okunur; bir sınır da içinde iç içe geçmiş sınırlardan önce okunur; yan yana yazılmış sınırlar göründükleri sırayla okunur. Birden fazla önceki yerleştirme çakıştığında, ilk okunan adlandırılır. Hangi sırayla düşerlerse düşsünler iki konum da adlandırılır ve hiçbiri diğerinin üstünde sıralanmaz.
Yayınlanan ileti. Cümle kuralı belirtir; ardından gelenler hatalı girdiyi, iki yerleştirmenin her birinin bulunduğu sınırı, her birinin yazıldığı bloğu ve ikisini de barındıran dosyayı adlandırır. Bir sınırın components: bloğu altındaki bir girdi, başka bir sınırınkinin altındaki önceki bir girdiyle karşılaştığında:
component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (bileşen birden fazla sınırda bildirilmiş: her bileşeni tam olarak bir sınırda bildirin)
Sınırları adlandıran iki ifade, her girdinin yazıldığı bloğa göre sözcüklendirilir. Hatalı girdi şunlardan birini alır:
named in the components block of boundary "<boundary>" — sınırın kendi components: eşlemesi;
named inside a routing entry in boundary "<boundary>" — o sınırın aggregates: bloğu altındaki bir yönlendirme girdisinin components: eşlemesi;
routed as a sub-module into boundary "<boundary>" — yönlendirme girdisinin kendisi.
Önceki yerleştirme, aynı cümleyi sürdürerek şunlardan birini alır:
while it is already named in the components block of boundary "<boundary>";
while it is already named inside a routing entry in boundary "<boundary>";
while it is already placed by a sub-module routed into boundary "<boundary>".
İki ifade birbirinden bağımsız seçilir, bu nedenle bunların herhangi bir eşleşmesi görünebilir; that earlier entry naming ise o önceki yerleştirmenin neyi adreslediğini taşır: bileşenin kimliğini ya da onu yerleştiren yönlendirilmiş bir alt modülse alt modülün önekini.
Hatalı girdi bir yönlendirme girdisinin kendisi olduğunda, adreslediği şey tek bir bileşen değil bir alt modüldür ve ileti bir modül önekini bileşen adı gibi sunmak yerine bunu belirtir; burada başka bir sınıra yönlendirilmiş önceki bir alt modülle karşılaşıldığında:
component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (bileşen birden fazla sınırda bildirilmiş: her bileşeni tam olarak bir sınırda bildirin)
Nasıl düzeltilir: iki yerleştirmeden kastetmediğinizi silin. İleti ikisini de adlandırır, dolayısıyla seçim derleyicinin değil sizindir. Doğrudan bir bildirim ile yönlendirilmiş bir modül uyuşmadığında, bileşenin modülüyle mi yoksa tek başına mı olacağına karar verin: modülü yönlendirmek onu modülün içerdiği diğer her şeyle birlikte yerleştirir, doğrudan adlandırmak ise onu onlardan ayırır. İki yönlendirme girdisi tek bir modülü sahiplendiğinde, kastetmediğiniz yönlendirmeyi kaldırın; bir modülü bir sınıra yönlendirmek içerdiği her bileşeni oraya yerleştirir, dolayısıyla bu tür iki girdi aynı bileşen kümesini sahiplenir.
A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Bir Manifest açıklama bağlaması ayrılmış aggrega.ai/ önekini sahipleniyor)
Bir Manifest, yalın aggrega.ai/ önekiyle başlayan bir anahtar altında bir açıklama bağlaması bildiriyor. Bu önek, derlemenin kendi yayınladığı anahtarları damgaladığı yerdir; dolayısıyla içinde bir anahtarı sahiplenen bir bağlama, sizin yönlendirmenizi ve platformun kendi çıktısını tek bir anahtar alanına koyar ve aynı adlar için yarıştırır.
Durdurur ve bir uyarı olamazdı. Bu ayırma, o anahtar alanını platformun yapan şeyin tamamıdır; bağlamayı kabul edip sonradan bundan söz etmek çakışmayı derlemede bırakırdı.
Kural, yazılmış bir bağlamanın sahiplendiği anahtar alanıyla ilgilidir; bu nedenle sunulan Manifest’in bağlama bildirmediği bir anahtar raporlanmaz, atlanır; ihlal edecek bir bağlama yoktur.
Yayınlanan ileti. Hatalı anahtar başta gelir, çünkü cümle onunla ilgilidir; ardından gelen değerlerin her biri ne olduklarıyla tanıtılır:
manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (manifest açıklama bağlaması ayrılmış öneki kullanıyor)
Nasıl düzeltilir: bağlama anahtarını denetiminizdeki bir ad alanına yeniden adlandırın. Alt önekli bir anahtar desteklenen biçimdir ve ayrılmış değildir: standart kütüphane kısayolu için feature.aggrega.ai/…, kurumsal bir kısayol için ise kendi alan adınız (acme.aggrega.ai/…, compliance.example.com/…). Anahtarı yeniden adlandırmak, bir yazarın bağlamayı tetiklemek için bir bileşene ne yazdığını değiştirir; bu yüzden onu kullanan açıklamaları aynı düzenlemede güncelleyin. Platformun yalın önek altındaki kendi anahtarları ../providers/well-known-annotations.md sayfasında listelenir.
İki Manifest açıklama bağlaması tek bir yönlendirme yuvası için çakışıyor
Tek bir Manifest içindeki iki açıklama bağlaması aynı sütun üzerinden, aynı yolda aynı Feature’a yönlendiriyor. Bir bağlamanın işi, bir açıklamanın değerinin nereye düşeceğini söylemektir; tek bir hedefi adlandıran iki bağlama, değeri iki rotayla bırakır ve genişletme sırasında aralarında seçim yapacak hiçbir şey olmaz.
Hedef Feature başına belirli bir yol ve sütun çiftini yalnızca bir bağlama bildirebilir. Aynı Feature’ı farklı yollarda hedefleyen iki bağlama olağan bir yazımdır ve derlenir; aynı yolu iki farklı Features’a yönlendiren iki bağlama da öyle.
Bağlamalar Manifest’in onları bildirdiği sırayla gezilir; bu nedenle bir iletinin ilk adlandırdığı bağlama her zaman belgenizde daha önce gelendir.
Üretilen ileti:
manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (Manifest ek açıklama bağlamaları aynı Feature yolu+sütunu üzerinde çakışıyor; Feature başına belirli bir (yol, sütun) çiftini yalnızca bir bağlama bildirebilir)
Nasıl düzeltilir: hedefin hangi bağlamaya ait olduğuna karar verin ve yolu diğerinin maps.infra ya da maps.values listesinden kaldırın veya ikinci bağlamayı tamamen kaldırın. İki bağlama, iki açıklama anahtarının tek bir Feature alanına ulaşmasını istediğiniz için varsa, bir bağlamayı tutun ve her iki açıklama anahtarının onun üzerinden yönlenmesini sağlayın; iki farklı değerin iki ayrı yere düşmesi amaçlandığı için varsa, hangi yol yanlışlıkla yazıldıysa onu düzeltin.
Bir Release, yükleme yolundan geçmeden çözümlemeye ulaştı
Bir Release, çözümlemeye hem boş olmayan bir üst düzey components: yüzeyi hem de sentezlenmiş bir default sınırı taşıyarak ulaştı. Bu birleşim, normal şekilde yüklenmiş bir Release tarafından üretilemez: yükleme yolu üst düzey bir components: bloğunu varsayılan sınırın içine katlar ve onu temizler; ikisini birden doğrudan yazan bir belge ise bu noktaya gelmeden şeması tarafından reddedilir.
Dolayısıyla bu durdurma, yazdığınız hiçbir şeyi bildirmez. Bir şeyin yükleme yolunu atlayarak çözümlemeye ulaştığını bildirir — çoğunlukla bir dosyadan okunmak yerine gömülü bir program tarafından bellekte oluşturulmuş bir Release — ve iki bileşen yüzeyi birbiriyle çelişen bir belge üzerinde derlemenin ilerlemesine izin vermek yerine orada durur. Bunları hangi sırayla okursanız okuyun, bileşenleri sessizce atlayan ya da yineleyen bir çıktı üretilirdi ve sınır gezintisi ile kenar başına gezinti hangileri olduğu konusunda birbiriyle bile uyuşmazdı.
Üretilen ileti:
release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (release normalleştirilmeden çözümlemeye ulaştı (sentezlenmiş bir varsayılan sınırın yanında boş olmayan kök bileşenler): release’leri elle oluşturulmuş bir değişmez yerine normalleştirme çekirdeği üzerinden oluşturun (yükleme yolu aracılığıyla types.NormalizeRelease))
Nasıl düzeltilir: YAML yazıyorsanız hiçbir şey yapmanız gerekmez — bu durdurmaya aggrega build, aggrega validate ya da düzenleyiciden ulaşmak, derleyicide bildirilmeye değer bir kusur olduğu anlamına gelir ve derlediğiniz Release hatalı değildir. Derleyiciyi gömüyor ve kendi kodunuzda bir Release değeri oluşturuyorsanız, kök bileşenleri varsayılan sınıra katlayan normalleştirmenin çalışması için yapıyı doğrudan birleştirmek yerine onu yükleme yolu üzerinden oluşturun.
Bir kütüphane başvurusu kendi içine genişliyor
Belgeler arası bir başvuru zinciri zaten ulaştığı bir belgeye geri döner; bu nedenle onu genişletmek hiçbir zaman bitmez. İki yazım yüzeyi aynı duruma ulaşır ve ikisi de tek bir dosyanın içindeki herhangi bir şey değil, kütüphane varlıkları arasındaki zincirlerdir: bir şema sütunundan, geri dönecek şekilde başvuran bir SchemaLibrary girdisine yapılan bir $ref: ve aynısını yapan bir MappingLibrary ya da WorkloadLibrary girdisine yapılan bir $import:.
Zincir kanonik bir anahtar üzerinden karşılaştırılır — kütüphanenin kimliği ve girdinin adı, kayıt defteri ana bilgisayarı ve sürüm yazımı çıkarılmış olarak — böylece bir döngü, yolu boyunca aynı girdiyi iki farklı şekilde adlandırarak denetimden kaçamaz. Genişleyen ve sonlanan bir başvuru, kaç kez görünürse görünsün ve zincir ne kadar derine inerse insin sorun değildir; derinlik tek başına bu durdurmaya asla yol açmaz ve tek bir kütüphane girdisini birçok yerden yeniden kullanmak, kütüphanelerin var olma nedeni olan kalıptır.
Bir $import: zinciri için yayılan ileti; döngüyü kapatan adımı görebilmeniz için tüm döngüyü gezildiği sırayla adlandırır:
Nasıl düzeltilir: iletideki zinciri okuyun ve onu amaçlanmayan adımda kırın. Bir döngü genellikle iki kütüphane girdisinin her birinin diğerini genişletecek şekilde yazıldığı anlamına gelir; ortak kısmı her ikisinin de başvurduğu üçüncü bir girdiye toplayın ya da onu bunlardan birine satır içi yerleştirin. Gösterilen son adım döngüyü kapatandır, ancak yanlış olan mutlaka o değildir — tüm zincir tam da hangi bağlantının kesileceği sizin kararınız olduğu için yazdırılır.
Aynı durum, yukarıda “YAML anchor aliased inside its own content” altında belgelenen çapa özyineleme reddini de destekler. O, tek bir belgenin kendi metninin içindeki bir döngüdür; bu ise belgeler arasındaki bir döngüdür. İletideki zincir ikisini bir bakışta ayırt eder: belgeler arasındaki bir döngü kütüphane girdilerini, bir belgenin içindeki döngü ise bir çapayı adlandırır.
Bildirilen bir şema çözümlenemiyor
Bir şema, bir şeyi doğrulamak için kullanılacağı noktaya ulaştı ve hiçbir şekilde bir şemaya dönüştürülemedi. En yaygın neden, çözümlenebilir hiçbir şeyi adlandırmayan bir $ref:’tir; JSON Schema meta şemasını karşılamayan bir şema da aynı durdurmaya ulaşır, kendi başına çözümlenemeyen koşullu bir anahtar sözcüğün altındaki bir then: ya da else: dalı da öyle.
Ret, şemaya karşı herhangi bir şey doğrulanmadan önce gelir ve önemli olan da bu sıralamadır. Okunamayan bir şemayı atlamak, derleme başarı bildirirken kapsadığı her şeyi doğrulanmamış bırakırdı — durduğunu söyleyecek hiçbir şey olmadan çalışmayı bırakmış bir denetim.
Şemanın içindeki konumu, çözümlenemeyen anahtar sözcüğü ve çözümlemenin bildirdiğini adlandıran yayılan ileti:
Hata, şemanın içindeki bir anahtar sözcükte değil de kökünde olduğunda konum ve anahtar sözcük çıkarılır ve cümle yalnızca bildirilen nedeni taşır.
Nasıl düzeltilir: şemayı iletinin adlandırdığı konumda açın. Genellikle sorumlu bir $ref:’tir: hedefin var olduğunu, belge içi bir başvurunun #/$defs/… yolunu tam olarak doğru yazdığını ve belgeler arası bir başvurunun, derlemenin bağımlılık kapanışının gerçekten içerdiği bir SchemaLibrary girdisini adlandırdığını doğrulayın. İleti bir then: ya da else: dalını adlandırıyorsa, o dal başlı başına bir şemadır ve kendi koşullarında çözümlenebilir olmalıdır.
An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Bir x-aggrega-when: veya x-aggrega-validate: yüklemi değerlendirilemiyor)
Bir şema, şablon değerli iki uzantı anahtar sözcüğünden birini bildiriyor ve şablon kullanılamadı: bir dize değil, şablon olarak ayrıştırılamıyor, çalışırken başarısız oldu veya true ya da false dışında bir şey üretti.
x-aggrega-when: bir şemanın koşullu dalının uygulanıp uygulanmayacağına karar verir; x-aggrega-validate: bir değerin, şemanın kendi anahtar sözcüklerinin ifade edemediği bir kuralı karşılayıp karşılamadığına karar verir. Her ikisi de hüküm olarak okunur; bu yüzden hüküm olmayan bir sonuç yorumlanmak yerine reddedilir: boş bir dize üreten bir yüklem false olarak okunur ve uygulatmak için yazıldığı kuralı sessizce devre dışı bırakırdı.
hatalı olan koşulun yüklemi olduğunda anahtar sözcüğün yerinde "x-aggrega-when" bulunur ve bildirilen neden şablon hatasını adlandırır: bir ayrıştırma konumu, eksik bir fonksiyon veya şablonun ürettiği boolean olmayan değer.
Nasıl düzeltilir: şemayı mesajın belirttiği konumda açın ve bildirilen nedeni okuyun. Anahtar sözcüğün değerinin bir dize olduğunu, şablonun ayrıştırıldığını ve izlediği her yolun doğrulanan değerde gerçekten bulunduğunu doğrulayın; bir yüklem değeri .value olarak okur ve başka bir şeye uzanmak en yaygın hatadır. Neden, index fonksiyonunun bulamadığı bir anahtarı belirtiyorsa, anahtarı hasKey ile sınayın veya bunun yerine get ile okuyun: aşağıda “A template indexes a map with a key the map does not hold (Bir şablon, map’te bulunmayan bir anahtarla map’i indeksliyor)” bölümünde açıklandığı gibi index, map’te bulunmayan bir anahtarda durur. Şablonun sonunda true veya false ürettiğinden emin olun: bir karşılaştırma bunu yapar, değeri yalnızca işleyen bir şablon ise yapmaz.
A Workload does not satisfy the Workload schema (Bir Workload, Workload şemasını karşılamıyor)
Bir Recipe’in veya FeatureRecipe’in workload: bloğu okundu ve Workload şemasına göre denetlendi; bir veya daha fazla alan şemayı karşılamıyor: yanlış yazılmış bir anahtar, yanlış türde bir değer, atlanmış zorunlu bir alan, bildirilen bir aralığın veya numaralandırmanın dışında bir değer.
Rapor gruplanmıştır: tek bir durma hatalı tüm alanları taşır; böylece dört hatası olan bir Workload, her derlemede bir tane yerine dördünü de tek derlemede bildirir. Başlık; Workload’u, onu bildiren Recipe’i ve dosyayı adlandırır; altındaki her bulgu Workload içindeki alan yolunu, şemanın orada neyi gerektirdiğini ve belirtilebildiği yerde düzeltmeyi adlandırır.
Üretilen ileti:
workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage):
.containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated>.initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated>
Alan başına ayrıntısı olmayan bir hata, yani bloğun okunup yetersiz bulunması yerine hiç okunamaması, bunun yerine nedenin tamamını tek bulgusu olarak taşır.
workload: şablonu hassas olarak bildirilmiş bir değeri okuduğunda hiçbir bulgu bir değer alıntılamaz. İşlenen belgenin hangi alanının o değerden geldiği anlaşılamaz; bu yüzden metni bir değer taşıyabilecek her bulgu, şemanın kısıtını değerin yerinde <redacted> ile belirtir, nedeni adlandıran bir notla kapanır ve değerden türetilmiş hiçbir düzeltme taşımaz:
.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)
Hiçbir değer alıntılamayan bir bulgu (eksik bir anahtar, Workload’un kabul etmediği bir anahtar) diğer tüm şablonlardaki gibi okunur. Bkz. vocabulary/compact-form-authoring.md “Bir reddin bildirilen bir değer hakkında söyledikleri”.
Derleme bu durmayı bir CATALOG_ERROR etiketiyle bildirir, çünkü bir workload: bloğunu Aggregate veya Release değil, Recipe’in yazarı yazar.
Nasıl düzeltilir: Recipe’yi listelenen alan yollarında açın ve her birini düzeltin. Yollar Workload’un kendi kökünden verilir; böylece .containers.main.health.ready, main container’ının health anahtarı altındaki ready bloğudur. Adlandırılmış bir container anahtarıyla, bir init container ise konumuyla adreslenir; ikisinin farklı okunmasının nedeni budur. Her alanın neyi kabul ettiği Workload yazım başvurusunda yer alır.
Şemanın metin olarak beklediği bir alanın, değer bir sayı veya boolean olduğu için reddedilmesi, neredeyse her zaman tırnaksız bir şablon ifadesi anlamına gelir. Bir workload: bloğu denetlenmeden önce işlenir; bu yüzden tırnaksız yazılmış bir ifade çıplak metne genişler ve YAML bu metni neye benziyorsa öyle okur. Tam çekirdekli bir boyutlandırma miktarı, yalnızca rakamlardan oluşan bir sürüm, bir port ve yes, no, on ve off sözcüklerinin tümü metin dışında bir şey olarak okunur. Bulgu YAML’ın hangi türü okuduğunu söyler; çözüm, ifadeyi Recipe’te tırnak içine almaktır (cpu: {{ .infra.compute.cpu }} yerine cpu: "{{ .infra.compute.cpu }}"); böylece operatör ne sağlarsa sağlasın değer metin olarak kalır. Burada operatörün kendi değerinin hatalı olmadığını ve onu Release’te tırnak içine almanın hiçbir şeyi değiştirmediğini unutmayın: tırnaklar Recipe’te, ifadenin çevresinde olmalıdır.
A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Bir Workload eki, varlığın bildirmediği bir yuvayı ya da yuvanın yasakladığı bir teslimatı adlandırıyor)
Bir workload: bloğu içindeki bir konteynerin attachments: girdisi bir ek yuvasına başvurur ve bu başvuru, Component’in ya da Feature’ın featuresSchema içinde bildirdiği yuvalarla — ya da connection: ile bir bağlantıyı adlandıran bir girdi için, o bağlantının soketinin bildirdiği yuvalarla — örtüşmez. Bir bağlantıyı adlandıran envFrom girdisi de aynı bağlantı kurallarına tabidir. Bulgu, bunlardan hangi durumla karşı karşıya olduğunuzu söyler.
Yuva bildirilmemiş. Girdinin from: alanı, varlığın featuresSchema şemasında bulunmayan bir yuvayı adlandırır — bir yazım hatası ya da yalnızca bir tarafta yeniden adlandırılmış bir yuva.
Yuva kara kutu. Yuva boş bir inject: izin listesi bildirir; bu, teslimatı Recipe’nin kendi altyapısına ayırır. Böyle bir yuva dahili olarak doldurulur ve tüketilir, bu nedenle bir Workload ona erişemez.
Teslimat, yuvanın izin listesinin dışında. Girdinin as: alanı, yuvanın inject: listesinin izin vermediği bir mekanizmayı adlandırır.
Bağlantı, bileşenin kurduğu bir bağlantı değil. Girdinin connection: alanı, bileşenin hiçbir bağlantısının altında yazılmadığı bir takma adı adlandırır.
Bağlantının soketi yuvayı bildirmiyor. Girdinin from: alanı (ya da envFrom üzerinde secret: alanı), o bağlantının üzerinden bağlandığı soketin bildirmediği bir yuvayı adlandırır.
Yuva, birleşik adıyla yazılmış. Girdinin from: (ya da secret:) değeri, bir bağlantının ekinin bileşen üzerinde aldığı addır — takma ad, bir nokta ve yuva — ve connection: olmadan yazılmıştır. Bir bağlantının yuvasına yalnızca bağlantı adlandırılarak ulaşılır.
Tüm konteynerlerdeki tüm hatalı girdiler birlikte raporlanır, böylece tek bir derleme hepsini adlandırır. Bulgular, Workload’ı, onun Recipe’sini ve dosyayı adlandıran tek bir başlık altında gruplanır.
Üretilen ileti:
workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage) (Workload featuresSchema çapraz denetimi başarısız oldu):
.containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot (Component’in featuresSchema’sında bildirilmemiş bir slota başvuruyor — slotu Component’in ya da Feature’ın featuresSchema’sında bildirin veya başvuruyu var olan bir slota göre yeniden adlandırın)
.containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended (slot kara kutudur, inject izin listesi yoktur ve bir Workload attachments girdisinden başvurulamaz — kara kutu slotlar Recipe’nin iç tesisatıyla teslim edilir; Workload tarafındaki başvuruyu kaldırın veya Workload tarafında teslim isteniyorsa slotun inject izin listesini genişletin)
.containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema (teslim mekanizmasına slot izin vermiyor — izin listesindeki teslim mekanizmalarından birini kullanın veya Component/Feature featuresSchema’sında slotun inject izin listesini genişletin)
.containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments (slot için bir bağlantı adlandırıyor, ancak bileşen bu takma ad altında bir bağlantı kurmuyor — bileşenin kurduğu bir bağlantıyı adlandırın veya Component’in kendi eklentileri için bildirdiği bir slotu okumak için connection’ı kaldırın)
.containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema (bağlantının, soketin bildirmediği bir slotunu adlandırıyor — soketin bildirdiği bir slotu adlandırın veya slotu o soketin featuresSchema’sında bildirin)
.containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot> (derleyicinin bağlantının slotu için oluşturduğu adı kullanıyor; bir bağlantının soketinin bildirdiği slot, bağlantı adlandırılarak adlandırılır — from: yanına connection: yazın)
Bir envFrom girdisinde aynı bulgular .containers.<name>.envFrom[<i>].connection ve .containers.<name>.envFrom[<i>].secret konumlarında yer alır.
Nasıl düzeltilir: her bulgu iki tarafı da adlandırır; dolayısıyla seçim hangi tarafın değiştirileceğidir. Bildirilmemiş bir slot için from: yazımını düzeltin veya slotu varlığın featuresSchema alanında bildirin — alan yolundaki .from soneki başvuruyu gösterir. Kara kutu bir slot için Workload tarafındaki başvuruyu kaldırın ve malzemeyi Recipe’nin teslim etmesine bırakın; Workload tarafında teslim gerçekten isteniyorsa slota bir inject: izin listesi verin. Reddedilen bir mekanizma için as: değerini izin listesinin adlandırdığı birine çevirin veya kendi mekanizmanızı listeye ekleyin. Bileşenin kurmadığı bir bağlantı için takma adı bulgunun listelediklerinden birine düzeltin veya bağlantıyı Aggregate’te ya da Release’te kurun. Soketin bildirmediği bir slot için bulgunun listelediği slotlardan birini adlandırın veya slotu Component üzerindeki soketin featuresSchema alanında bildirin. Oluşturulmuş bir ad için bağlantıyı ve slotu, bulgunun gösterdiği gibi ayrı ayrı yazın.
A Workload references a slot whose fill publishes no locator (Bir Workload, dolgusu hiçbir konum belirteci yayımlamayan bir yuvaya başvuruyor)
Bir konteynerin attachments: girdisi bir yuvayı başvuruyla adlandırır ve o yuvayı dolduran ek, böyle bir başvurunun okuduğu provides anahtarlarını yayımlamaz. Bir yuvaya adıyla başvurmak, temsil ettiği kaynağın işlenmiş çıktıda adreslenmesini istemek demektir — kaynağın adıyla ve içindeki alanla. İkisini de yayımlamayan bir dolgunun gösterilecek bir konum belirteci yoktur, bu nedenle başvuru hiçbir şeye dönüştürülemez.
Hangi anahtarların gerektiği girdiye bağlıdır ve bulgu hangisini istediğini söyler. Kendi key: alanını adlandıran bir girdi alanı kendisi sağlar, bu nedenle yalnızca kaynağın name değerinin yayımlanması gerekir — çok anahtarlı bir kaynağa başvurabilmesini sağlayan budur. Hiçbir key: adlandırmayan bir girdi, yuvanın yayımlanan tek alanını okur, bu nedenle hem name hem key bulunmalıdır.
Denetim yalnızca anahtarların mevcut olup olmadığını okur; değerlerini asla incelemez. Tüm hatalı girdiler tek bir başlık altında birlikte raporlanır.
Üretilen ileti:
workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage) (Workload eklenti slotuna başvurulamıyor):
.containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference (slota başvurulamıyor: çözümlenmiş provides değeri gereken anahtarı sunmuyor; bir workload eklenti başvurusu name ve key provides anahtarlarını okur — schema.provides değeri bu başvurunun okuduğu anahtarları bildiren bir eklentiyle doldurulmuş bir slota başvurun veya değeri bir workload başvurusu yerine slotun inject borusu üzerinden teslim edin)
Nasıl düzeltilir: iki yön vardır ve hangisinin doğru olduğu ne kastettiğinize bağlıdır. Başvuru doğruysa değiştirilmesi gereken, yuvayı dolduran ektir: schema.provides değeri name anahtarını — ve girdi kendi anahtarını adlandırmıyorsa key anahtarını — bildiren bir Feature ekleyin, böylece gösterilecek bir konum belirteci olur. Malzemenin çıktıda hiçbir zaman adıyla adreslenmesi amaçlanmadıysa başvuruyu kaldırın ve onu bunun yerine yuvanın inject: kanalıyla teslim edin; bu kanal, değerin bulunduğu yere bir işaretçi yerine değerin kendisini taşır.
A container gives one environment variable two values (Bir konteyner bir ortam değişkenine iki değer veriyor)
Bir workload: bloğunun bir konteyneri aynı ortam değişkenini iki kez adlandırır: bir kez variables anahtarlarından biri olarak, bir kez de as: env olarak iletilen bir attachments girdisinin anahtarı olarak. Ana konteyner ve init konteyneri ayrı ayrı denetlenir; bu, bir bileşenin Recipe’inin işlediği Workload’da da bir FeatureRecipe’in işlediği Workload’da da (biri bir bileşene eklenmiş, biri bir sınırda bildirilmiş) aynı şekilde yapılır ve denetim Workload’u şablonunun işlediği hâliyle okur.
Neden birini seçmek yerine durur. Bir konteynerin ortamı bu iki koleksiyondan sabit bir sırayla yazılır: helm ve compose sağlayıcıları önce eklentiden okunan her girdiyi, ardından düz variables girdilerini yazar. Bu nedenle her iki yolla yazılmış bir ad, sürece bu sıranın kazandırdığı değerle ulaşır; bu da sizin yazdığınız bir şeyin değil, iki türün nereye düştüğünün sonucudur; bu yüzden derleme çifti işlemek yerine reddeder. Denetim, Workload’u hangi sağlayıcı işlerse işlesin bir kez çalışır; Workload’un diğer denetimlerinden sonra ve artifacts: girdileri değerlendirilmeden ya da Workload herhangi bir sağlayıcıya verilmeden önce çalıştığı için reddedilen bir çift hiçbir zaman işlenmez. as: file olarak iletilen bir attachments girdisi ortamda ayarlanmak yerine dosya olarak bağlanır, bu yüzden hiçbir zaman çift oluşturmaz.
Denetim yalnızca adları karşılaştırır; hiçbir değeri okumaz, bu yüzden hiçbir bulgu bir değer alıntılamaz. İki tür ortam girdisi karşılaştırdıklarının dışında kalır: bir envFrom girdisi adlandırdığı ConfigMap veya Secret’ın anahtarlarını ayarlar ve bunlar derleme çalışırken bilinmez; bir işlem hattı adımının işlenmiş bir belgeye yazdığı girdi ise denetimin okuduğu Workload’un parçası değildir.
Her çift ayrı bir bulgudur; Workload’u bildiren Recipe’in ya da FeatureRecipe’in workload: anahtarında konumlanır ve değişkeni ve konteyneri adlandırır: ana konteyneri anahtarıyla, init konteynerini initContainers listesindeki yeriyle. Bulgular önce ana konteynerler yazıldıkları sırayla, ardından init konteynerleri konumlarına göre gelir; tek bir konteyner içinde ise attachments girdilerinin yazıldığı sırayla gelir.
Bir Recipe’in Workload’unun ana konteynerindeki bir çift için üretilen mesaj. Kategori ve bu koşulun kısa kodu E0345 size köşeli parantezli başlıkta ulaşır ve konum <path> at .spec.workload şeklinde okunur:
a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (bir konteyner bir ortam değişkenini iki kez bildiriyor. İkisinden birini yeniden adlandırın ya da yalnızca biri işlenecek şekilde tamamlayıcı şablon koşulları altında yazın)
Bir init konteynerindeki çift bunun yerine listedeki yerini adlandırır (init container "initContainers[<i>]") ve bir FeatureRecipe’in bulgusu konteynerden sonra onu bağlayan eklentiyi, attachment "<attachment>", adlandırır; çünkü bir bileşen, FeatureRecipes’i ayrı belgeler olan birden çok eklenti taşıyabilir.
Bir Workload birden çok çift taşıdığında bulgular belgeyi adlandıran bir satırın altında gruplanır: containers of the Workload this Recipe renders name one environment variable twice ya da bir FeatureRecipe için containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice.
Derleme durmayı bir CATALOG_ERROR etiketi altında bildirir, çünkü bir workload: bloğu Aggregate ya da Release tarafından değil, Recipe’in ya da FeatureRecipe’in yazarı tarafından yazılır.
Nasıl düzeltilir: konteynerin ikisinden hangisini alması gerektiğine karar verin. İkisi de isteniyorsa birini yeniden adlandırın; böylece süreç iki değişken görür. Birbirinin alternatifiyse (örneğin hiçbir kimlik bilgisi eklenmediğinde kullanılan düz bir yedek değer), tam olarak biri işlenecek şekilde onları tamamlayıcı koşullarla koruyun: değişkeni {{ if not (hasKey (default dict .features) "<slot>") }} altında, attachments girdisini {{ if hasKey (default dict .features) "<slot>" }} altında ya da tek bir {{ if }}/{{ else }} yapısının iki dalı altında yazın. Bu şekilde korunan bir çift denetime hiç ulaşmaz, çünkü işlenmiş Workload’da ikisinden yalnızca biri bulunur.
A Release’s parameters: block is written in neither of its two shapes (Bir Release’in parameters: bloğu iki biçiminden hiçbiriyle yazılmamış)
Bir Release, bir Aggregate’in bildirdiği parametreleri iki yoldan biriyle karşılar ve blok biçimine göre okunur. Ya yerinde yazılmış değerlere parametre adlarını eşleyen bir eşlemedir ya da değeri bu değerleri tutan bir YAML dosyasının yolu olan tam olarak tek bir anahtarlı, $import:, bir eşlemedir. İkisi de olmayan bir blok, değerler Aggregate’in bildirimlerine karşı denetlenmeden önce, okunurken reddedilir.
Üç biçim reddedilir. Hiç eşleme olmayan bir parameters: değeri: bir skaler ya da bir liste. Başka anahtarların yanında $import: taşıyan bir eşleme; bu, içe aktarılan değerleri ve yazılanları aynı anda ister ve bunları birleştirmek için hiçbir kural vermez. Ve değeri düz bir dize olmayan, dolayısıyla hiçbir dosyayı adlandırmayan bir $import:.
Release şeması da aynı iki biçimi bildirir; bu yüzden üçünden herhangi birini taşıyan bir Release dosyası önce E0215 altında belge zarfı denetimiyle karşılaşır; bu denetim her iki biçimi dener ve her birinin neden başarısız olduğunu söyler. Burada bir liste için:
document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (belge zarfı doğrulaması başarısız oldu (Release); spec.parameters: hiçbir oneOf dalı eşleşmedi (2 dal denendi): branch[0]: tür: nesne bekleniyordu, dizi bulundu; branch[1]: tür: nesne bekleniyordu, dizi bulundu. belgeyi türünün şemasına uyacak şekilde düzeltin)
Başka bir anahtarın yanındaki $import: için ikinci dal additionalProperties: unexpected property: "<key>" ile, dize yerine liste olarak yazılmış bir $import: için ise validation: type: array has type "array", want "string" ile biter.
Değer bir eşleme olmadığında, orada yazılmış olanı adlandıran üretilen ileti; örneğin a list:
parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: biçim satır içi bir nesne ya da yalnızca $import içeren bir eşleme olmalıdır: eşleme beklenen yere başka bir biçim yazılmış)
ve $import: eşlemeyi başka bir şeyle paylaştığında ya da yol olmayan bir şeyi adlandırdığında:
parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (parameters: biçim satır içi bir nesne ya da $import içeren bir eşleme olmalı: $import tek anahtar olmalı)
parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: biçim satır içi bir nesne ya da $import içeren bir eşleme olmalı: $import değeri bir dize skaler olmalı)
Nasıl düzeltilir: Release’i mesajın belirttiği satırda açın. Değerleri parameters: altına yerinde yazın ya da bloğun tamamını, değeri tırnak içinde bir yol olan tek bir $import: girdisiyle değiştirin. Hem yerinde yazılmış değerler hem de paylaşılan varsayılanları içeren içe aktarılmış bir dosya istediğiniz durumda, yazılmış değerleri, içe aktarmayı barındıran Release’i extends: ile genişleten bir Release’e taşıyın; birden çok parametre kaynağını katmanlamak bir extends: zincirinin amacıdır ve bu tek anahtar tasarım gereği tek bir kaynaktan okunur.
Satır içi ya da içe aktarma alanı iki biçimden hiçbiriyle yazılmamış
Bir Recipe veya FeatureRecipe tarafından yazılan üç alan — bir artifacts.<name>: girdisi, bir valuesMapping: ve bir workload: — aynı iki biçimi kabul eder. Ya gövde yerinde, bir dize skaleri olarak yazılır (çok satırlı her şey için olağan yazım bir | bloğudur) ya da değer, gövdenin bunun yerine nerede bulunduğunu adlandıran, tam olarak tek anahtarlı, $import: anahtarlı bir eşlemedir. Bir $import: ifadesinin neyi adlandırabileceği alana göre değişir: bir artifacts girdisi yerel bir yolu ya da bir ArtifactLibrary içinden bir paketi içe aktarırken, valuesMapping: ve workload: alanları yerel bir yolu ya da kimliğiyle bir kütüphaneden bir girdiyi içe aktarır.
Üçünü de tek bir okuyucu denetler; bu nedenle hangi alan hatalı olursa olsun reddedilen durumlar aynı üç durumdur: birden fazla anahtar taşıyan bir eşleme, tek anahtarı $import olmayan bir eşleme ve değeri düz bir dize olmayan bir $import:. Ne skaler ne de eşleme olan bir değer (çoğu zaman bir liste) yalnızca biçimi nedeniyle reddedilir.
Recipe ve FeatureRecipe şemaları üç alanın her biri için aynı iki biçimi bildirir; bu yüzden bunlardan herhangi birini taşıyan bir dosya önce E0215 altında belge zarfı denetimiyle karşılaşır; bu denetim alanı adlandırır ve her biçimin neden başarısız olduğunu söyler. İlk dal yerinde yazılan biçim, ikincisi $import: biçimidir:
document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (belge zarfı doğrulaması başarısız oldu (Recipe); bu spec.artifacts girdisi için hiçbir oneOf dalı eşleşmedi (2 dal denendi): branch[0]: doğrulama: tür nesne, dize bekleniyordu; branch[1]: additionalProperties: beklenmeyen özellik. belgeyi türünün şemasına uyacak şekilde düzeltin)
Bu, $import: yanında bir anahtar taşıyan bir eşlemedir. $import olmayan tek bir anahtar required: missing required property: $import, additionalProperties: unexpected property: "<key>" ile, bir liste type: expected object, got array ile biter; dize olmayan bir $import: ise type: array has type "array", want "string" örneğinde olduğu gibi, dize beklenen yerde bulunan türü adlandırır.
Yayımlanan iletiler. Her biri hatalı alana ait cümleyle başlar, ardından okuyucunun ne bulduğunu ve nerede bulduğunu söyler:
artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (artifacts girdisi: biçim bir dize skaleri ya da {$import: yerel-yol} olmalıdır: belirtilen satırda belirtilen sayıda anahtar bulundu)
valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: biçim bir dize skaleri ya da {$import: yol-veya-kütüphane-kimliği} olmalıdır: belirtilen satırda belirtilen anahtar bulundu)
workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: biçim bir dize skaleri ya da {$import: yol-veya-kütüphane-kimliği} olmalıdır: belirtilen satırda $import değeri bir dize skaleri olmalıdır)
Üç alandan herhangi biri bu bitişlerden herhangi birini bildirebilir; iki biçimden hiçbiri olmayan bir değer line <line>: <shape> is written where text or a map is expected ile biter ve yazılmış olanı adlandırır; en sık a list.
Nasıl düzeltilir: varlığı iletinin belirttiği satırda açın. Gövdeyi yerinde bir blok skaleri olarak yazın ya da değerin tamamını tek bir $import: girdisiyle değiştirin. Hem $import: hem de başka bir şey taşıyan bir eşleme iki biçimden biri değildir — fazladan anahtarları içe aktarılan dosyanın içine taşıyın ya da gövdeyi yerinde yazın. Yanlış yazılmış bir $import — çoğunlukla eksik bir $ — sıradan bir anahtar olarak okunur ve $import olmayan tek anahtar olarak raporlanır.
Bir kütüphane girdisine yapılan başvuru boşluk içeriyor
Bir kütüphanenin içindeki bir girdiyi adlandıran başvuru, kesintisiz tek bir belirteç olarak yazılır: kütüphane, isteğe bağlı bir :<version> alt sınırı, ardından # ve girdinin yolu; örneğin BaseWorkloads:1.0.0#/workloads/StatelessService. Hiçbir parçası boşluk kabul etmez. Kütüphane adları ve girdi adları, kütüphane şemalarınca tanımlayıcı yazımlarıyla sınırlandırılmıştır ve bir sürüm de bir sürümdür; bu nedenle bir başvurunun herhangi bir yerindeki boşluk, sekme ya da satır sonu bu üçünden hiçbirine ait değildir.
Bu ret, bir kütüphane girdisini kimliğiyle adresleyen her yüzeyi kapsar: $import: olarak yazılmış bir valuesMapping:, bir workload: ve bir artifacts.<name>: girdisi ile bir şema $ref: ifadesi. $import: olarak yazılmış yerel bir yol hiçbir # taşımaz ve bir kütüphane girdisine başvuru değildir; bu nedenle içinde boşluk bulunan bir yol etkilenmez.
Bunu toparlamak yerine reddetmeye değer kılan şey, böyle bir değerin baştaki kısmının genellikle başlı başına bir başvuru olmasıdır. Boşluktan kırpmak o başvuruyu çözümler ve yazarın yazdığı geri kalanı sessizce atar; üstelik bir derlemenin iki yarısının aynı miktarı atması gerekmez, dolayısıyla biri diğerinin hiç görmediği bir bağımlılık kaydedebilir. Reddetmek, değerin tek bir anlam taşımasını sağlar.
library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (kütüphane başvurusu: bir kütüphane girdisine yapılan başvuru boşluk ya da satır sonu içermez: belirtilen satırdaki $import hedefi)
Bir başvuru derlemeye bir yerden daha ulaşır: derlemenin zaten çözümlediği bir kütüphane girdisinin gövdesinden; burada ilk satırdaki alan kökü düzeyinde bir $import: başka bir kütüphanenin girdisini gösterir. Bu başvuru derlemenin açtığı bir belgeden hiç okunmadığından satır belirtilmeden bildirilir:
library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (kütüphane başvurusu: bir kütüphane girdisine yapılan başvuru boşluk ya da satır sonu içermez)
Nasıl düzeltilir: varlığı iletinin belirttiği satırda açın ve başvuruyu tek bir belirteç olacak şekilde birleştirin. Olağan neden # öncesindeki bir satır sonudur: bir sütuna sığdırmak için iki satıra bölünmüş bir başvuru, YAML için tek bir değer, burada ise bozuk bir başvuru olarak okunur; bu nedenle ne kadar uzun olursa olsun tek satırda yazın. Diğer neden kapanış tırnağından önceki bir boşluktur: sürüm alt sınırının içine düşer ve orada hiçbir yayımlanmış yapıtın taşımadığı bir sürümü adlandırır. İkinci biçim için başvuru, iletide hemen önünde adı geçen kütüphanenin içindedir; onu o kütüphanenin girdiyi bildirdiği yerde düzeltin.
Bir kütüphane girdisinin gövdesi o kütüphanenin tuttuğu biçimde değil
Bir kütüphane, diğer varlıkların içe aktarması için adlandırılmış gövdeler yayımlar ve her kütüphane türü tek bir biçim tutar. Bir MappingLibrary girdisi ve bir WorkloadLibrary girdisi tek bir şablon gövdesi tutar; bu nedenle girdinin değeri bir skalerdir, pratikte bir | bloğu. Bir ArtifactLibrary girdisi bir paket tutar: tek bir ad altında birlikte bulunan dosyalar; bu nedenle girdi, çıktı dosya adından o dosyanın gövdesine bir eşlemedir ve altındaki her gövde bir skalerdir.
Gövdeler tam olarak yazıldıkları gibi yakalanır ve kütüphane yüklenirken ayrıştırılmaz. İçlerindeki şablon, içe aktarıldığı yerde ayrıştırılır; burada yalnızca biçimin denetlenmesinin nedeni budur: hiç şablon olmayan bir gövde sorunsuz yüklenir ve bir şey onu işlediği noktada başarısız olur.
Her biri satırı ve orada yazılmış olanı adlandıran üretilen iletiler; örneğin a list:
mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: girdi gövdesi bir dize skaleri olmalıdır: metin beklenen yere başka bir biçim yazılmış)
workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: girdi gövdesi bir dize skaleri olmalıdır: metin beklenen yere başka bir biçim yazılmış)
artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: girdi, dosya adından dize gövdesine bir eşleme olmalıdır: eşleme beklenen yere başka bir biçim yazılmış)
ve girdisi bir eşleme olan ancak dosyalarından biri skaler olmayan bir paket için, dosyayı adlandırarak:
artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: girdi, dosya adından dize gövdesine bir eşleme olmalıdır: bu dosyada metin beklenen yere başka bir biçim yazılmış)
Derleme bunları, okuduğu dosyayı adlandıran bir CATALOG_ERROR etiketi altında, yukarıdaki cümle altında yer alacak şekilde bildirir.
Nasıl düzeltilir: gövdeyi anahtarının altında bir blok skaleri olarak yazın. İlk satırı bir YAML anahtarına benzeyen bir gövde (YAML üreten bir şablon genellikle böyledir) blok skaleri yoksa iç içe bir eşleme olarak okunur; yaygın neden budur. Bir ArtifactLibrary için her çıktı dosya adına bir anahtar yazın ve her gövdeyi kendi blok skaleri olarak yazın; tek bir gövde olarak yazılmış bir paket diğer yaygın biçim hatasıdır.
Bir $instantiate: başvurusu çözümlenemiyor
Bir SchemaLibrary, spec.templates altında her birinin kendi $params tanımı olan yeniden kullanılabilir biçimler bildirebilir; bir şema girdisi de bunlardan birini $instantiate: altında adıyla anarak ve parametrelerini $args: altında sağlayarak örnekler. Yerine koyma birebirdir: şablonun gövdesindeki bir $<name> skaleri, argümanın değeriyle değiştirilir. İfade değerlendirmesi, koşul ya da döngü yoktur; yerine konan değer, başka işaretçiler için taranmadan olduğu gibi eklenir.
Üç hata örneklemeyi reddettirir. $instantiate: altındaki ad, kütüphanenin bildirdiği bir ad değildir. Şablonun default: olmadan bildirdiği bir parametrenin $args: altında girdisi yoktur. Ya da bir argümanın değeri, parametresinin bildirdiği türde değildir; bildirilmiş hiçbir parametreyi adlandırmayan bir $args: anahtarı da yok sayılmak yerine aynı biçimde raporlanır, böylece yanlış yazılmış bir argüman adı sessizce varsayılana düşen bir parametre yerine bir ret olur.
Üretilen iletiler:
schemalibrary: template not found: "<template-name>" not declared in spec.templates (şablon bulunamadı: <template-name> spec.templates içinde bildirilmemiş)
schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (şablon parametresi eksik: <parameter-name> (şablon <template-name>))
schemalibrary: template parameter type mismatch: <what the type check found> (şablon parametresi tür uyuşmazlığı: <what the type check found>)
schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (şablon parametresi tür uyuşmazlığı: <argument-name> argümanı <template-name> şablonunun $params alanında bildirilmemiş)
Nasıl düzeltilir: bulunamayan bir şablon için adı, kütüphanenin spec.templates altında bildirdiği bir adla düzeltin ve istediğiniz kütüphaneyi içe aktardığınızı denetleyin. Eksik bir parametre için onu $args: altına ekleyin ya da çağıranların atlayabilmesi için şablonda parametreye bir default: verin. Tür uyuşmazlığı için argümanı bildirilen türe çevirin ya da parametrenin type: değerini genişletin; ileti bildirilmemiş bir argümanı adlandırıyorsa yazımını düzeltin ya da onu kaldırın.
Bir şema, kütüphanenin kabul etmediği bir JSON Schema anahtar sözcüğü kullanıyor
$dynamicAnchor ve $dynamicRef, SchemaLibrary içeriğinde kabul edilmez. Bunlar bir başvurunun hangi şemaya çözümleneceğini değer doğrulanana kadar erteler; bu da bir kütüphane girdisinin anlamını, ne söylediğine değil nereden içe aktarıldığına bağlı kılar. Derleyici ise bir kütüphanenin biçimlerini her türlü doğrulamadan önce çözümler, dolayısıyla ertelenmiş bir başvurunun çözümlenebileceği hiçbir şey kalmaz.
Ret, anahtar sözcüğün gelebileceği iki yolu birlikte kapatan üç noktada uygulanır. Bir şema girdisi, kütüphane yüklenirken taranır. Bir şablonun gövdesi kütüphane yüklenirken taranır; böylece anahtar sözcüğü birebir taşıyan bir şablon, onu ilk örnekleyen derlemede değil bu noktada başarısız olur. Yerine konmuş gövde de bir örneklemeden sonra yeniden taranır; böylece anahtar sözcüğü bir argüman değeri olarak vermek ilk ikisini atlatmaz.
Üretilen ileti:
schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (schemalibrary: yasak JSON Schema anahtar sözcüğü: “$dynamicRef”, satır <line>)
Nasıl düzeltilir: ertelenmiş başvuruyu, bir $defs girdisini doğrudan adlandıran bir $ref ile değiştirin. Biçim gerçekten kullanıma göre değişiyorsa değişimi $params içeren bir şablon olarak ifade edin ve her kullanımda örnekleyin; bu yüzeyin sunduğu yerine koyma budur ve sonuca karşı herhangi bir doğrulama yapılmadan önce çözümlenir.
Bir belge, okuyucunun ineceğinden daha derin iç içe geçiyor
Yazılan her eşleme, anahtarlarının yazıldığı sırayı koruyan bir yapıya okunur; çünkü bu sıra işlenmiş çıktıya ulaşır ve bir derlemeyi çalıştırmalar arasında bayt bayt aynı kılan şeyin bir parçasıdır. Bu okuyucu sınırlı sayıda düzey (yüz) iner ve daha derine inmeyi reddeder; böylece aksi hâlde okuyucunun kendi yığınını tüketecek girdi, olduğu gibi bir ret olarak raporlanır.
Üretilen ileti:
a document nests too many levels deep: it is read at most 100 levels deep (bir belge çok fazla düzey derinliğinde iç içe geçmiş: en fazla 100 düzey derinliğe kadar okunur)
Nasıl düzeltilir: gerçek yazılmış belgeler birkaç düzey iç içe geçer; dolayısıyla yüze ulaşan bir belge üretilmiş, makineyle çevrilmiş ya da yanlışlıkla kendine başvuran bir belgedir. Kendi içine genişleyen bir değer arayın: içinde bulunduğu içeriğe başvuran bir YAML çapası yukarıdaki kendi durdurmasıyla reddedilir, ancak aynı biçimi tekrar tekrar üreten bir üretici reddedilmez. Derinlik gerçekse derin dalı kendi başına bir varlığa taşıyın ve ona adıyla başvurun.
Bir provider, iyi bilinen bir ek açıklamayı işlemediği bir kapsamda bildiriyor
Bir provider’a hizmet eden bir Plugin, kendisi hakkında birbiriyle uyuşması gereken iki şey söyler. spec.provider.wellKnownAnnotations altında üzerinde işlem yaptığı ek açıklamaları, her birini okuduğu kapsamlarla birlikte listeler. contract.inputKinds altında ise hangi girdi türlerini işlediğini söyler. Girdi türünü aynı varlığın sahiplenmediği bir kapsamda bildirilen bir anahtar, bu iki ifadenin tek bir dosyada birbiriyle çelişmesidir; bu yüzden varlık yüklenirken reddedilir.
Denetim, varlığın kendisiyle karşılaştırılmasıdır; bu yüzden hiçbir plugin ikili dosyası gerektirmez ve varlığın okunduğu her yerde tetiklenir; yapıtı hiç getirmemiş bir makinedeki katalog taraması da buna dahildir.
İki girdi kasıtlı olarak karşılaştırılmaz. Sınır kapsamlı bir girdi hiçbir girdi türünü adlandırmaz, çünkü herhangi bir düğümün işleme yolunda değil, tüm sınır için bir kez çözümlenir. Hiç kapsam bildirmeyen bir girdi ise yol başına bir iddiada bulunmaz: yalnızca plugin’in anahtarı bir yerde okuduğunu söyler.
Reddin kanıtlamadığı şey, ayakta kalan bir bildirimin doğru olduğudur. Bir provider’a hizmet eden plugin’in okuduğunu söylediği bir anahtarı gerçekten okuduğunu hiçbir şey kanıtlayamaz; yazılmış iki alanın karşılaştırılmasının yapabileceği, ikisi birden doğru olamayacak çifti reddetmektir. Provider’ın işlediği bir kapsamda bildirilen ancak plugin’inin orada hiçbir şey okumadığı bir anahtar burada geçer.
Üretilen ileti:
provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render (<plugin-name> sağlayıcısı <key> iyi bilinen ek açıklamasını <scope> kapsamında bildiriyor, ancak contract.inputKinds.<field> talep edilmemiş; anahtarı yalnızca sağlayıcının oluşturduğu bir kapsamda bildirin ya da girdi türünü talep edin: wellKnownAnnotations: bir anahtar, sağlayıcının sözleşmesinin oluşturmadığı bir kapsamda bildirilmiş)
Nasıl düzeltilir: ileti iki yarıyı da adlandırır. Ya o kapsamı ek açıklamanın scope: listesinden çıkarıp provider’ın işlediği kapsamları bırakın ya da provider o türü gerçekten işliyorsa girdi türünü contract.inputKinds altında sahiplenin.
A compact-form schema uses a keyword the compact form does not know (Kompakt biçimli bir şema, kompakt biçimin tanımadığı bir anahtar sözcük kullanıyor)
Kompakt biçimde yazılmış bir şema; ne kompakt biçim anahtar sözcüğü, ne biçimin olduğu gibi geçirdiği JSON Schema anahtar sözcüklerinden biri, ne de biçimin ayırdığı üç işaretçiden biri ($jsonschema:, $mode: ve $ref:) olan bir anahtar taşıyor. Bilinmeyen anahtarlar atılmak yerine şema okunurken reddedilir; çünkü yok sayılan, yanlış yazılmış bir kısıtlama hiç kısıtlama olmaz ve uygulanıyor gibi görünüp hiçbir şey uygulamayan bir şema, başarısız olan bir şemadan daha kötüdür.
Bu ret, bir şemanın derlendiği her yerde karşınıza çıkar. Bir SchemaLibrary’nin girdileri katalog yüklenirken derlenir; bir Component’in spec.schema alanı, soket başına valueSchema ve infraSchema alanları ile bir Feature’ın ve bir provider Plugin’inin bildirdiği şemalar katalog okunurken derlenir. Bir Component’in ya da Feature’ın spec.schema alanı bu koşulu kendisi raporlar ve varlığı ve alanı adlandırır; bir soketin valueSchema ya da infraSchema alanı ise aşağıdaki “A declared schema contract cannot be read as a schema (Bildirilen bir şema sözleşmesi şema olarak okunamıyor)” içinde, burada aktarılan cümleyi ayrıntısı olarak taşıyarak raporlanır.
Kompakt biçim derleyicisinin kendi cümlesi, şema içindeki konumu, kaynak satırını ve tanımadığı anahtarı belirtir:
compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (bilinmeyen anahtar sözcük)
Belgeler arası bir $ref: yanına yazılan bir anahtar da kendine ait bir cümleyle aynı koşul altında raporlanır; çünkü böyle bir referansa yalnızca üç kardeş anahtar eşlik edebilir:
compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (belgeler arası $ref yanında kardeş anahtara izin verilmez; izin verilenler: properties, required, description)
ve o kardeş anahtar birleştirilmiş şekli yeniden açmak istediğinde, cümle bunun yerine bunu yapmanın yolunu da içerir:
compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties (belgeler arası $ref yanında kardeş anahtara izin verilmez; izin verilenler: properties, required, description; birleştirilmiş şeklin rastgele özellikleri kabul etmesi gerekiyorsa açık nesne şeması gömmek için $jsonschema: kullanın)
Bunun kaydedildiği koşul compactform: unknown keyword koşuludur; kısa kodu da buna çözümlenir.
Nasıl düzeltilir: cümlenin belirttiği konumdaki anahtarı compact-form-authoring.md içindeki anahtar sözcük dağarcığına göre düzeltin; en yaygın neden bir yazım hatasıdır. Şekil gerçekten kompakt biçimin taşımadığı bir JSON Schema anahtar sözcüğüne ihtiyaç duyuyorsa, o parçayı JSON Schema’yı olduğu gibi gömen $jsonschema: altına yazın. Belgeler arası bir referansın yanında yalnızca properties:, required: ve description: bırakın; geri kalan her şey, referansın işaret ettiği kitaplık girdisinde yer almalıdır.
A compact-form schema declares a field literally named type (Kompakt biçimli bir şema, adı tam olarak type olan bir alan bildiriyor)
Kompakt biçim, bir eşlemenin ne anlama geldiğine içeriğinin şekline bakarak karar verir: bir type: anahtarı bir kısıtlama yaprağını, yapısal JSON Schema anahtar sözcükleri olduğu gibi geçirilecek bir parçayı, düz adlardan oluşan bir eşleme ise alt öğeleri şema olan bir nesneyi belirtir. Adıtype olan bir alan bildiren şema, bu okumaların birbirinden ayıramadığı tek şekildir: bir kısıtlama yaprağı gibi görünür ama tek alanlı bir nesne olarak kastedilmiştir. Bu yüzden biçim, yazardan hangisi olduğunu compact ya da jsonschema değerine ayarlanmış bir $mode: anahtarıyla belirtmesini ister.
Bu koşul, başka herhangi bir değerle yazılmış bir $mode: anahtarının raporladığı koşuldur. İşaretçi belirsizliği gidermek için vardır; bu yüzden hiçbir şeyi gidermeyen bir değer tahmin edilmek yerine reddedilir.
Kompakt biçim derleyicisinin kendi cümlesi:
compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (compactform, <path-inside-the-schema>:<line> konumunda (anahtar sözcük “$mode”): değer compact ya da jsonschema olmalıdır)
Bunun kaydedildiği koşul compactform: ambiguous dispatch — $mode required koşuludur; kısa kodu da buna çözümlenir.
Nasıl düzeltilir: eşleme, alanları arasında tesadüfen type adlı bir alan bulunan kompakt biçimli bir nesneyse $mode: compact, olduğu gibi alınacak bir JSON Schema parçasıysa $mode: jsonschema ayarlayın. İki okuma da kastedilmediyse, alanı yeniden adlandırmak belirsizliği hiç işaretçi kullanmadan giderir.
A $jsonschema: escape carries content that is not a schema (Bir $jsonschema: kaçışı şema olmayan içerik taşıyor)
$jsonschema: anahtarı, kompakt biçimin ifade etmediği şekiller için bir JSON Schema parçasını olduğu gibi gömer. Gömdüğü şey yazıldığı gibi alınır ve hiçbir zaman dönüştürülmez; bu yüzden bir şema olmak zorundadır: YAML olarak ayrıştırılan bir blok skaler ya da iç içe bir eşleme. İkisi de olmayan içerik, doğrulamada kullanılmak üzere aktarılmak yerine burada reddedilir; aksi halde hata şemaya karşı değil, şemanın tüketicisine karşı raporlanırdı.
Bu koşul altında dört şekil raporlanır ve cümle sizde hangisinin olduğunu söyler. Kaçış gövdesi YAML olarak ayrıştırılamıyor. Kaçışın değeri ne blok skaler ne de eşleme. Bir properties: anahtarı, adlardan şemalara bir eşleme olmayan bir şey tutuyor. Ve en dış düzeyde, derleyiciye verilen belge boş ya da okuyucunun kuralı olmadığı bir düğüm taşıyor.
Kompakt biçim derleyicisinin kendi cümleleri:
compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (compactform, <path-inside-the-schema>:<line> konumunda (anahtar sözcük “$jsonschema”): kaçış içeriği YAML olarak ayrıştırılamıyor: <what the parse reported>)
compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (compactform, <path-inside-the-schema>:<line> konumunda (anahtar sözcük “$jsonschema”): blok skaler dize ya da iç içe eşleme bekleniyordu)
compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (compactform, <path-inside-the-schema>:<line> konumunda (anahtar sözcük “properties”): özellik adlarından şemalara bir eşleme bekleniyordu)
compactform: unsupported YAML node kind (compactform: desteklenmeyen YAML düğüm türü)
Bunun kaydedildiği koşul compactform: $jsonschema content invalid koşuludur; kısa kodu da buna çözümlenir.
Nasıl düzeltilir: kaçış gövdesini $jsonschema: altına bir blok skaler olarak yazın; aksi halde ilk satırı bir YAML anahtarı gibi okunan bir gövde çevredeki eşlemeye katılır ki yaygın neden budur. Ayrıca tuttuğu şeyin kendi başına geçerli bir JSON Schema olduğunu denetleyin. Parça kompakt biçimde ifade edilebilecek kadar küçükse, kaçışı kaldırmak daha basit çözümdür.
A compact-form constraint does not apply to the type it was written on (Kompakt biçimli bir kısıtlama, üzerine yazıldığı türe uygulanmıyor)
Kompakt biçim kısıtlamaları alanın bildirilen türüne göre yönlendirilir: min: ve max:, bir sayıda sayısal sınıra, bir dizede uzunluk sınırına, bir dizide ise öğe sayısı sınırına dönüşür. Bu yüzden bir kısıtlama, türü onu kabul eden bir alanda yer almalıdır ve yönlendirmenin bir yanıtı olabilmesi için tür tek bir değer olmalıdır.
Bu koşul altında dört şekil raporlanır. type: bulunmadığı ya da bir birleşim belirttiği bir yere yazılmış kısıtlama; bu durumda hangi sınırın kastedildiğine hiçbir şey karar vermez. O türden sınır almayan bir türe (bir nesneye ya da bir boolean’a) yazılmış kısıtlama. Değeri ne skaler bir ad ne de adlar dizisi olan bir type:. Ve skaler bir addan başka bir şey verilmiş bir valuesType:.
Kompakt biçim derleyicisinin kendi cümleleri:
compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint (kısıt tek bir bildirilmiş türe uygulanır (integer/number/string/array); type: çözümlenmemiş (birleşim ya da yok) — type: değerini tek bir değere daraltın ya da bu kısıtı kaldırın)
compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (kısıt integer/number/string/array türlerine uygulanır; bildirilmiş tür farklı)
compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind (skaler bir tür adı ya da tür adları dizisi bekleniyordu (JSON Schema 2020-12 tür dizisi); desteklenmeyen düğüm türü alındı)
compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name (skaler bir tür adı bekleniyordu)
Bunun kaydedildiği koşul compactform: constraint not valid for declared type koşuludur; kısa kodu da buna çözümlenir.
Nasıl düzeltilir: cümle iki yarıyı da belirtir: kısıtlamayı ve karşılaştığı türü. type: bir birleşim tutuyorsa onu tek bir ada daraltın, eksikse ekleyin ya da alan gerçekten birkaç türden herhangi birini alıyorsa kısıtlamayı kaldırın. Türe göre değişmesi gereken bir sınır, $jsonschema: altında her dalın kendi türünü ve kendi sınırını taşıdığı bir alternatifler kümesi olarak ifade edilir.
A $ref: is not written in a form the compiler can resolve (Bir $ref:, derleyicinin çözümleyebileceği bir biçimde yazılmamış)
Bir şema, başka bir şekle $ref: ile başvurur; bu başvuru ya aynı belgenin içinde ya da belgeler arasında bir SchemaLibrary girdisine yapılır. Bir başvurunun başarısız olabileceği iki yolu iki koşul karşılar ve hangisiyle karşılaştığınızı cümle size söyler: başvuru derleyicinin okuduğu bir biçimde yazılmamıştır ya da iyi biçimlidir ama orada olmayan bir hedefi adlandırır.
Başvuru okunamıyor. Değer boştur ya da belgeler arası biçimi <Library>#/schemas/<Entry> değildir ya da sürümü @ ile ayırır; bu sonuncusu genel bir şikâyet olarak değil, düzeltilmiş yazımla birlikte bildirilir, çünkü bu biçimin en çok çektiği hata budur:
compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL (boş olmayan bir başvuru URL’si bekleniyordu)
compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> (belgeler arası $ref biçimi KütüphaneAdı#/schemas/GirdiAdı olmalıdır)
compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written> (belgeler arası $ref sürüm ayırıcısı ’@’ değil ’:’ karakteridir; düzeltilmiş değeri kullanın)
Bunların kaydedildiği koşul compactform: $ref unresolvable koşuludur.
Hedef orada değil. Başvuru doğru okunur, ancak kitaplık ya da içindeki girdi yoktur veya çözümleme için hiç kitaplık kataloğu sağlanmamıştır:
compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> (SchemaLibrary katalogda bulunamadı)
compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> (girdi SchemaLibrary içinde bulunamadı)
compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written> (belgeler arası $ref var ancak SchemaLibrary kataloğu sağlanmamış)
Bunların kaydedildiği koşul compactform: cross-document $ref target not found koşuludur.
Raporu üzerinde işlem yapılabilir kılan, ikisinin birbirinden ayrı tutulmasıdır: ilki baktığınız belgede yeniden yazılacak bir değerdir, ikincisi ise derlemenin neyi görebildiğine ilişkin bir sorudur. Kendi içine genişleyen bir başvuru ise üçüncü bir durumdur ve yukarıdaki “A library reference expands into itself (Bir kitaplık başvurusu kendi içine genişliyor)” altında bildirilir.
Nasıl düzeltilir: okunamayan bir başvuru için değeri yeniden yazın; belgeler arası bir başvuru için <Library>#/schemas/<Entry>, aynı belgenin içindeki bir başvuru için #/$defs/<name> kullanın ve bir sürüm alt sınırından önce @ yerine : kullanın. Bulunmayan bir hedef için girdinin adını onu yayımlayan kitaplıkla karşılaştırarak doğrulayın ve kitaplığın Release’in bağımlılık kapanışından erişilebilir olduğunu doğrulayın: hiçbir şeyin bağımlılık bildirmediği bir kitaplık yüklenmez, bu yüzden ona yapılan doğru bir başvuru bile hiçbir şeye çözümlenmez.
Kütüphane yalnızca yapıt önbelleğinde bulunduğunda. Önbellek, bir getirme işleminin oraya koyduğu şeyi tutar ve önbellekteki bir kütüphane, yalnızca Release’in lockfile’ındaki bir girdi onun özetine kefil olduğunda katalog içeriği sayılır. Önbellek, hiçbir lockfile girdisinin sabitlemediği ve hiçbir katalog dizininin sağlamadığı bir SchemaLibrary tuttuğunda, raporun ardından bu tür her kütüphaneyi ve raporu veren komut için işe yarayan eylemi belirten bir remediation: satırı gelir:
aggrega build ve aggrega validate --release, Release’in lockfile’ını okur; bu nedenle satırları, kütüphaneyi çözümleyip girdisini kaydeden aggrega pull --release <release> komutunu ya da kütüphaneyi bir katalog dizini altında yazmayı belirtir.
Bağımsız değişken olmadan aggrega validate ve --release verilsin ya da verilmesin bir varlık yoluyla aggrega validate, kütüphaneleri yalnızca katalog dizinlerinden okur ve hiçbir lockfile okumaz; bu nedenle kaydedilmiş bir girdi kararlarını değiştirmez. Satırları bunu belirtir ve kütüphaneyi bir katalog dizini altında yazmayı ya da aggrega pull --release <release> ve ardından Release’i lockfile’ının sabitlediği kütüphanelere göre denetleyen aggrega validate --release <release> komutunu gösterir.
A $ref: addresses a library by registry location (Bir $ref:, bir kitaplığı kayıt defteri konumuyla adresliyor)
Belgeler arası bir $ref:, kitaplığını kimliğiyle adlandırır: önce kitaplığın yalın adı, ardından # ve girdinin yolu gelir; kitaplığı hiçbir zaman yayımlandığı kayıt defteriyle adlandırmaz. Bir adın hangi kayıt defteri üzerinden çözümlendiği çalışma alanı yapılandırmasının, hangi sürümün kullanıldığı ise kilit dosyasının vereceği yanıttır; bu nedenle bir ana makine içeren başvuru, derlemenin karar vermesi gereken iki şeyi şemada sabitler ve şemayı çalışma alanları arasında bozuk bir başvuru olarak taşır.
Ana makine içeren değer yine de bir kitaplığa ve bir girdiye ayrıştırılabiliyorsa, cümle bunun yerine kullanılacak kimlik biçimindeki yazımı içerir:
compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written> (belgeler arası $ref bir kayıt defteri ana makinesi içeriyor; kitaplığa kimliğiyle başvurun)
ayrıştırılamıyorsa cümle değerden sonra biter:
compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written> (belgeler arası $ref bir kayıt defteri ana makinesi içeriyor; kitaplığa kimliğiyle başvurun)
Kaydedildiği koşul compactform: cross-document $ref carries a registry host; reference the library by identity koşuludur ve kısa kodu buna çözümlenir.
Nasıl düzeltilir: ana makineyi ve kitaplık adından önceki her şeyi kaldırın; geriye <Library>#/schemas/<Entry> kalsın. Bir sürüm alt sınırı isteniyorsa bunu kitaplık adından sonra :<version> olarak yazın. Aynı kural bir Recipe’nin ve bir FeatureRecipe’nin $import: alanları için de geçerlidir; bunlar aşağıda “A library $import: addresses its library by registry location (Bir kitaplık $import: alanı kitaplığını kayıt defteri konumuyla adresliyor)” başlığı altında ayrıca raporlanır.
A schema $import: cannot be applied (Bir şema $import: yönergesi uygulanamıyor)
Bir Component’in veya Feature’ın spec.schema alanı (bloğun tamamı ya da tek bir sütunu) ve bir usesSchema soketinin valueSchema: veya infraSchema: alanı, varlığın yanındaki bir dosyayı adlandıran bir $import: olarak yazılabilir. İçe aktarma varlık yüklenirken uygulanır; böylece sonraki her okuyucu işaretçiyi değil, içe aktarılan sözleşmeyi görür. Bu koşul, yazdığınız bir şey hatalı olduğunda oluşur: yönergenin kendisi ya da adlandırdığı dosyanın içerdiği şeyin biçimi.
Bu hatalar tek bir koşuldur, çünkü her biri aynı yüzeyi kullanılamaz bırakır ve size yapılacak aynı işi verir: yönergeyi ya da adlandırdığı dosyayı düzeltmek. Tanılama sabit cümleyle başlar ve ardından hangi hata olduğunu söyler; bu nedenle eşleştirilecek kısım cümledir, üzerinde işlem yapılacak kısım ise ondan sonraki ifadedir:
a schema $import: could not be applied. <surface>: <the clause for this occurrence>
İfade, okuduğu yüzeyi (spec.schema, onun spec.schema.values gibi bir sütunu ya da bir soketin valueSchema alanı) ve ardından belirli hatayı adlandırır. Hatalar ve her birinin anlamı:
$import: must be the only key when a schema is imported from a file. (Bir şema dosyadan içe aktarıldığında $import: tek anahtar olmalıdır.) Yönerge, eşlemesini yazılmış şema içeriğiyle paylaşıyor. $import: bir değerin tamamını değiştirir; bu yüzden kardeş bir anahtarın birleşeceği bir şey yoktur.
$import: value must be a path to a file. ($import: değeri bir dosya yolu olmalıdır.) Değer boş ya da tek bir dize değil.
$import: takes a file path beside this entity, not a registry location <value>. ($import: bir kayıt defteri konumu değil, bu varlığın yanındaki bir dosya yolu alır: <value>.) Değer bir kayıt defterini adresliyor. Bir adın hangi kayıt defteri üzerinden çözümlendiği çalışma alanı yapılandırmasıdır; bu nedenle bir şema yüzeyi hiçbir zaman kayıt defteri taşımaz. Mesaj, bunun yerine kullanılacak başvuru biçimini adlandırır.
$import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. ($import: bu varlığın yanındaki bir dosya yolu alır; SchemaLibrary girdisine bunun yerine $ref: ile başvurun: <value>.) Değer bir kütüphane girdisini adresliyor. Bir kütüphane girdisine başvurulur, içe aktarılmaz; girdiyi çözümleyen anahtar sözcük $ref: olur.
imported schema <value> must be a YAML map of schema content; it is not. (İçe aktarılan şema <value> şema içeriğinden oluşan bir YAML eşlemesi olmalıdır; değil.) Dosya bulundu, okundu ve ayrıştırıldı; ancak ayrıştırma sonucu bir skaler ya da bir dizi, dolayısıyla yerine konacak şema içeriği yok.
Başlık, kategoriyi ve bu koşulun kısa kodu olan E0266’yı taşır; bu kod, bu durmayı kalıcı olarak adlandırmanız gerektiğinde (bir sürekli entegrasyon kapısında, bir sorun kaydında veya bir çalıştırma kılavuzunda) kaydedilecek tanımlayıcıdır. Bir numara bir kez verilir ve sonra sabit kalır; böylece çevresindeki ifade ne kadar iyileşirse iyileşsin aynı kalır. Tüm koşulların tablosu onu çözümler.
İyi biçimlendirilmiş olan ve derlemenin erişemediği bir dosyayı adlandıran bir yönerge başka bir yerde, farklı bir kodla raporlanır. Çözümlenmeyen bir yol, bulunmayan veya okunamayan bir dosya ve YAML olarak ayrıştırılamayan baytlar yazdığınız şeydeki hatalar değildir (değerlendirilecek içe aktarılmış bir belge yoktur); bu yüzden oldukları gibi bir yükleme olarak, yukarıdaki “A file cannot be read, or its bytes do not parse (Bir dosya okunamıyor veya baytları ayrıştırılamıyor)” altında raporlanır; o bölüm her birinin taşıdığı ifadeyi belgeler. Yakalamak istediğiniz şey eksik veya okunamayan bir içe aktarma dosyasıysa o koşulla eşleştirin ve onun kodunu kaydedin.
Bir yol, varlık dosyasını içeren dizine göre çözümlenir; bu, içe aktarma taşıyan diğer tüm alanların kullandığı tabanla aynıdır. İçeriği kendisi bir $import: bildiren bir içe aktarma izlenir; zaten işlenmekte olan bir dosyaya geri dönen bir zincir ise burada değil, yukarıdaki “A library reference expands into itself (Bir kütüphane başvurusu kendi içine genişliyor)” altında raporlanır. Bir içe aktarmanın getirdiği bir dosyanın içine yazılmış bir yönerge, o dosyada ve içindeki satırda raporlanır, çünkü düzeltme oraya yapılır; varlığın içine yazılmış bir yönerge ise varlıkta raporlanır.
Nasıl düzeltilir:$import: öğesini eşlemesindeki tek anahtar yapın ve ona, varlığın yanındaki, en üst düzeyi şema içeriğinden oluşan bir eşleme olan bir YAML dosyasına göreli bir yol verin. Bir SchemaLibrary’nin yayımladığı bir biçimi kullanmak için bunun yerine $ref: <Library>#/schemas/<Entry> kullanın; bir kütüphane girdisine içe aktarılmaz, başvurulur.
A schema block names a key that is not a data pillar (Bir şema bloğu veri sütunu olmayan bir anahtarı adlandırıyor)
Bir Component’in veya Feature’ın spec.schema bloğu varlığın veri sütunlarını taşır ve kabul ettiği şeylerin tamamı üç anahtardır: geliştiricinin her örnek için doldurduğu biçim olan values; operatörün sağladığı fiziksel boyutlandırma olan infra; ve varlığın onu tüketen her şeye açtığı anahtarlar olan provides. Bu koşul, blok en üst düzeyinde başka bir anahtar taşıdığında oluşur.
Küme açık değil kapalıdır; bunun nedeni, her sütunun kendi içeriğinin kapalı olarak doğrulanmasının nedeniyle aynıdır: geçerli bir yüzeyi sıralayan bir blok, o yüzeyin dışındaki her şeyi hata yapar. Hiçbir şeyin tanımadığı bir anahtar, hiçbir şeyin derlemediği, ona göre doğrulamadığı veya bir tüketiciye vermediği bir sözleşme taşırdı; böylece altına yazdığınız şey bildirilmiş gibi görünür ama etkisiz olurdu. Bunu fark etmek, hiç yazmadığınız bir sözleşmeyi fark etmekten daha zordur; bu yüzden başıboş anahtar yok sayılmaz, blok reddedilir.
Tanılama sabit cümleyle başlar, ardından varlığı, kuralı, anahtarın yazıldığı yeri ve bunun yerine ne yazılacağını adlandırır:
a schema block declares a key that names no data pillar (<Kind><name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set.
Başlık, kategoriyi ve bu koşulun kısa kodu olan E0267’yi taşır; bu kod, bu durmayı kalıcı olarak adlandırmanız gerektiğinde (bir sürekli entegrasyon kapısında, bir sorun kaydında veya bir çalıştırma kılavuzunda) kaydedilecek tanımlayıcıdır. Bir numara bir kez verilir ve sonra sabit kalır; böylece çevresindeki ifade ne kadar iyileşirse iyileşsin aynı kalır. Tüm koşulların tablosu onu çözümler.
O konumda yazılan iki şey bu kümenin anahtarı değildir ve hiçbiri burada raporlanmaz. Varlığın yanındaki bir dosyayı adlandıran bir $import:, blok okunmadan önce o dosyanın içeriğiyle değiştirilir; bu yüzden bu koşulun incelediği şey içe aktarılan belgenin kendi en üst düzeyidir: içe aktarılan dosyanın içindeki başıboş bir anahtar burada raporlanır, yönergenin kendisi ise hiçbir zaman raporlanmaz. Ayrıca extends bildiren bir Component, bloğun yerine çıplak inherited dizesini yazar; bu, hiç anahtar taşımayan bir skalerdir.
Nasıl düzeltilir: cümle karşılaştığı anahtarı ve kabul ettiği üç anahtarı adlandırır; bu yüzden en yaygın neden (bir yazım hatası ya da sütun adının çoğul olduğu yerde tekil kullanım) yalnızca tanılamadan görülebilir. Başıboş anahtarın altındaki içerik bir sütuna aitse, sahipliğinin gerektirdiği şekilde values:, infra: veya provides: altına taşıyın; data-pillars.md hangi sütunun neye sahip olduğunu söyler. Kendi başına şema içeriği olarak düşünüldüyse, sütunların yanında değil, bir düzey daha derinde, bir sütunun içinde yer alır. Bir SchemaLibrary’nin yayımladığı bir biçime, blok düzeyinde değil, bir sütunun içine yazılan $ref: <Library>#/schemas/<Entry> ile ulaşılır.
A plugin asks the host to parse a source while a parse is already running for it (Bir eklenti, kendisi için zaten bir ayrıştırma çalışırken ana bilgisayardan bir kaynağı ayrıştırmasını ister)
Bir eklenti, ana bilgisayardan bir kaynağı ayrıştırıp sonucu geri vermesini isteyebilir; böylece belirli bir biçimde bir belgeye ihtiyaç duyan bir eklentinin o biçim için kendi okuyucusunu taşıması gerekmez. Ana bilgisayar, ayrıştırmayı üreten eklentiyi çalıştırır ve ürettiği sonucu döndürür. Bu koşul, bu yolla ulaşılan eklentinin kendisi de bir ayrıştırma istediğinde ortaya çıkar: istek, zaten içinde çalıştığı aynı mekanizmaya yeniden girer ve ana bilgisayar daha derine inmek yerine isteği reddeder. Mekanizmanın sunduğu şey bunun tek bir düzeyidir ve ret, onu tek düzeyde tutan şeydir.
Ret, derlemeye değil eklentiye ulaşır. Ana bilgisayar orada durup geri sarmaz; çağrıyı, aşağıdaki cümleyi ve reddi adlandıran bir kodu taşıyan bir hata zarfıyla yanıtlar ve isteyen eklenti bunu isteğinin yanıtı olarak alır. Derlemenin ardından ne yapacağı, o eklentinin bu yanıtla ne yaptığına bağlıdır: yanıtı ölümcül sayan bir eklenti derlemeyi sonlandırır, raporlayıp devam eden bir eklenti sonlandırmaz. Ret her iki durumda da aynıdır.
Bu, özellikle iki eklentiden hiçbirinin hatası değildir: koruma, adı belli tek bir eşleşmeyi değil, isteğin üzerinden geçtiği herhangi bir eklenti çiftini kapsar; bu nedenle mekanizmaya nerede yeniden girilirse girilsin aynı retle karşılaşılır.
Eklentinin aldığı biçimiyle yayılan ileti:
aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (aggrega_parse_source: üretici tüketimine yeniden giriş reddedildi: ana bilgisayar üzerinden ulaşılan bir üretici başka bir üretici tüketimi çağrısı yapamaz)
Nasıl düzeltilir: buna kendi dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği onu gidermez; bu, derlemenin yapılandırıldığı eklentilerin bir özelliğidir. Düzeltilmesi gereken, bir ayrıştırmanın içinden ayrıştırma isteyen eklentidir; bu nedenle iletiyi aktararak koşulu o eklentiyi yayımlayan kişiye bildirin. O eklenti sizinse, kendisi bir ayrıştırmaya hizmet ederken ana bilgisayardan başka bir kaynağı ayrıştırmasını istemek yerine kendisine verilen kaynağı doğrudan okumasını sağlayın.
The workspace configuration is invalid (Çalışma alanı yapılandırması geçersiz)
Bir çalışma alanı, kökündeki bir .aggrega-config.yaml dosyasıyla tanımlanır: hangi registry’ye yayımladığı ve hangisinden çektiği, artifact önbelleğinin nerede durduğu, hangi plugin’lerin hangi soketlere bağlandığı ve her registry’nin imzalama tutumunun ne olduğu. Bu dosya, herhangi bir entity dosyası açılmadan önce okunur ve şemasına göre denetlenir; çünkü ardından gelen her şey bu dosyadan okunur.
Eksik bir dosya hata değildir. Yapılandırma dosyası olmayan bir çalışma alanı belgelenmiş varsayılanları alır; bu nedenle bu durdurma hiçbir zaman var olmayan bir dosyayı adlandırmaz. Değeri taşıyan dosyayı adlandırır; bir ortam değişkeninin geçersiz kıldığı ve şemanın hiç görmediği bir ayar için ise değişkeni adlandırır.
Denetim, belge türlendirilmiş ayarlara dönüştürülmeden önce çalışır. Bu sıralama, mesajın, daha ileride bir yerden işaret edilecek alan olmadan bir tür uyuşmazlığı bildirmek yerine şemanın itiraz ettiği alan yolunu adlandırabilmesini sağlar.
Şu biçimler, düz bir şema itirazının ötesinde burada bildirilir; her biri, şemanın tek başına ancak üzerine işlem yapılamayacak kadar genel bir şey söyleyebilmesi nedeniyle: altında hiçbir şey olmadan yazılmış bir workspace: anahtarı, yeri en üst düzey olan ama bunun yerine workspace: altına yazılmış bir anahtar, dosyanın kullanmadığı bir ad altında yazılmış bir cache: bloğu, bir registry host’unun yazıldığı biçimde yazılmamış bir registry host’u ve değerlerini şemanın kabul ettiği ama çalışma alanının kullanamadığı üç ayar: mutlak olan ya da çalışma alanı kökünün kendisini adlandıran bir artifact_cache_dir, yayımlanabilir bir artifact türü olmayan bir şeyi adlandıran bir signing.kinds girdisi ve uri değeri oci:// ile yazılmış bir registry konumu olan bir plugins.providers ya da providers_append girdisi. Bir provider bağlaması eklentisini kimliğiyle, isteğe bağlı bir :<version> ile birlikte provider/<name> olarak adlandırır; çünkü bir yetenek çözümlenirken bağlamanın eşleştirildiği şey bu kimliktir. Bir registry konumu bir eklentinin hangi eklenti olduğunu değil, nerede yayımlandığını söyler; bu nedenle böyle yazılmış bir girdi hiçbir zaman hiçbir şey seçemez. Bir giriş işlevini function: ile adlandıran ve uri: adlandırmayan bir girdi de, bir plugins.linter ya da linter_append girdisi veya bir karar rolündeki (ir-verdict ya da render-verdict) bir plugins.governance ya da governance_append girdisi olduğunda burada bildirilir: bu eklemeler eklentilerini uri ile seçer; bu nedenle böyle bir girdi hiçbir eklenti eklemez ve adlandırdığı işlev hiçbir zaman çağrılmaz — bir lint, girdi yokmuş gibi çalışmaya devam eder ve bir derleme ancak daha sonra, girdinin hiç adlandırmadığı bir eklentiyi çözümlemeye geldiğinde durur.
Yapılandırmanın listelediği bir katalog dizini — workspace.catalog_dirs veya catalog_dirs_append altında ya da workspace.releases altında bir Release’in kendi girdisinde, yapılandırmanın okunduğu herhangi bir dosyada — dizin olmadığında da burada raporlanır: o yolda hiçbir şey yoktur ya da orada bir dosya veya hiçbir yere çıkmayan bir bağlantı durur. Bu, bir katalog onun üzerinden okunmak üzereyken değerlendirilir; bu nedenle kataloğu okuyan her komut, herhangi bir şey okumadan veya yazmadan önce onu reddeder, katalog okumayan bir komut ise yine de çalışır. Onsuz okumaya devam etmek, listelediğinizden daha az katalogla derlemek anlamına gelir ve hangilerinin eksik olduğunu söyleyen hiçbir şey olmaz. AGGREGA_CATALOG_DIRS değişkeninin listelediği bir dizin de aynı kurala tabidir ve ret, dosya yerine değişkeni adlandırır.
Bir registry ana makinesi — bir registries girdisinin host değeri ya da default_registry değerinin başladığı ana makine; bu değer söz konusu girdilerden birini name: alanıyla adlandırmıyorsa böyledir, adlandırıyorsa o girdinin ana makinesini temsil eder — ana makinenin kendisi olarak yazılır: küçük harfle ve nokta içeren bir ad, ya da localhost, ya da ardından port gelen tek bir ad, ya da bir IP adresi (IPv6 ise köşeli parantez içinde); her biri isteğe bağlı bir :port ile ve şema ya da kimlik bilgisi olmadan. Bir registries girdisinin ana makinesi yol taşımaz; default_registry ana makinesinin ardından / ve bir depo yolu getirebilir — / ile birleştirilmiş küçük harfli bölümler; etiket, özet (digest) ya da sondaki / olmadan. Bir ana makineyi başka bir yazımla adlandıran değer, yazılması gereken yazım belirtilerek reddedilir — default_registry için yol dahil konumun tamamı — böylece o ana makine altında tutulan güven politikası ona uygulanır; buna HTTPS üzerinden erişilen bir ana makinede 443 numaralı port da dahildir, çünkü bu o ana makinenin varsayılan portudur. Depo yolu olmayan bir yol, ardından geldiği ana makine belirtilerek reddedilir; bir girdinin name: değerinin ardından yol gelmesi ise bunun yerine yazılabilecek iki yazım belirtilerek reddedilir: yalnızca ad ya da girdinin ana makinesi ve ardından yol; çünkü ad, altındaki bir konumu değil girdisinin ana makinesini temsil eder. Hiçbir ana makineyi adlandırmayan bir değer — hiçbir girdinin taşımadığı, portu olmayan tek bir ad ya da boşluk veya süslü parantez içeren bir metin — ana makine olmadığı gerekçesiyle reddedilir ve default_registry için ret mesajı bir girdinin adının da kullanılabileceğini belirtir. AGGREGA_DEFAULT_REGISTRY de aynı okumaya tabidir ve değişken adı belirtilerek aynı şekilde reddedilir.
Yayımlanan mesajlar. Bir şema itirazı dosyayı, alan yolunu ve şemanın ne söylediğini adlandırır:
workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (workspaceconfig: çalışma alanı yapılandırması geçersiz)
Düzeltme önerili biçimler dosyayla başlar ve alan yolu ile şemanın itirazı yerine belirli biçim hakkında bir cümle söyler. Çalışma alanı kökünü adlandıran bir artifact_cache_dir:
<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir çalışma alanı kökünün kendisini adlandırıyor; bu durumda çalışma alanı kökündeki bir katalog dizini önbellek sayılarak atlanır ve yüklenecek bir şey kalmaz — önbelleğe kendi alt dizinini verin (örneğin .aggrega/cache): çalışma alanı yapılandırması geçersiz)
her türü kapsayan joker karakteri de adlandıran, kullanılamaz bir signing.kinds girdisi:
<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (signing.kinds girdisi imzalanabilir bir artefakt türü değil; bir katalog varlığı ya da plugin türü kullanın veya tüm türler için “all” yazın: çalışma alanı yapılandırması geçersiz)
registry konumu olarak yazılmış, girdiyi, yeteneği ve yazılması gereken biçimi adlandıran bir provider bağlaması:
<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (bir plugins.providers girdisi bir yeteneği bir registry konumuna bağlıyor; bu, bir eklentinin hangi eklenti olduğunu değil, nerede yayımlandığını belirtir; bir provider bağlaması eklentisini kimliğiyle adlandırır — uri içine eklentinin kimliğini, isteğe bağlı bir sürümle birlikte yazın: çalışma alanı yapılandırması geçersiz)
bir giriş işlevini adlandıran ama hiçbir eklenti adlandırmayan bir linter ya da karar rolündeki yönetişim eklemesi; mesaj listeyi, girdiyi ve işlevi adlandırır, burada plugins.linter üzerinde:
<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (plugins.linter girdisi giriş işlevini adlandırıyor ama eklenti URI’si yok; bu listedeki bir ekleme eklentisini URI ile seçer, bu nedenle bu girdi hiçbir eklenti eklemez ve işlev hiçbir zaman çağrılmaz — onu dışa aktaran eklentinin URI’sini ekleyin: çalışma alanı yapılandırması geçersiz)
başka bir yazımla yazılmış bir registry host’u, burada HUB.AGGREGA.AI:
<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry “HUB.AGGREGA.AI” adlandırdığı registry host’u olarak yazılmamış; “hub.aggrega.ai” yazın (küçük harfle, şema, yol, kimlik bilgisi veya varsayılan port olmadan); o host’un güven politikası bu yazım altında tutulur: çalışma alanı yapılandırması geçersiz)
host’u depo yolunun önünde başka bir yazımla yazılmış, yazılacak konumun tamamını adlandıran bir varsayılan registry, burada GHCR.io/acme:
<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry “GHCR.io/acme” adlandırdığı registry konumu olarak yazılmamış; “ghcr.io/acme” yazın (küçük harfli registry host’u, şema, kimlik bilgisi veya varsayılan port olmadan, ardından depo yolu); bu, o host’un güven politikasının ona uygulanmasını sürdürür: çalışma alanı yapılandırması geçersiz)
ardından yol gelen bir girdi adı, burada local adlı girdi 127.0.0.1:5000 için olduğunda local/acme:
<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry “local/acme”, ardından yol gelen “local” registries girdisinin adıdır ve bir girdinin adı yalnızca o girdinin host’unu temsil eder; girdiyi kullanmak için “local” ya da host’unu ve ardından yolu, “127.0.0.1:5000/acme” yazın: çalışma alanı yapılandırması geçersiz)
cümlesi bir host’un alabileceği biçimleri listeleyen, hiçbir host adlandırmayan bir değer:
<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (registries[].host değeri bir registry ana makinesi değil; nokta içeren küçük harfli bir ana makine adı (registry.example.com), localhost, ardından port gelen tek bir ad (registry:5000) ya da bir IP adresi (IPv6 ise köşeli parantez içinde) yazın — her biri isteğe bağlı bir :port ile ve başka hiçbir şey olmadan: çalışma alanı yapılandırması geçersiz)
listelenmiş ve yerinde hiçbir şey bulunmayan bir katalog dizini; mesaj dosyayı ve satırı, listeyi, yazıldığı haliyle girdiyi ve çözümlendiği yolu adlandırır — liste workspace.catalog_dirs, workspace.catalog_dirs_append ya da `catalog_dirs` of the `workspace.releases` entry "release.yaml" gibi bir Release girdisinin listesidir:
<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (girdinin adlandırdığı dizin mevcut değil; o dizini oluşturun veya girdiyi kaldırın: çalışma alanı yapılandırması geçersiz)
ve boş bir workspace: işaretçisi:
workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspaceconfig: workspace bir eşleme olmalıdır; katalog dizini olmayan bir çalışma alanı kökünü işaretlemek için workspace: {} yazın: çalışma alanı yapılandırması geçersiz)
İki mesaj daha yanlış yere yazılmış bir anahtarı adlandırır: default_registry, offline, auto_pull ve artifact_cache_dir anahtarlarının tümü workspace: altında değil en üst düzeyde yer alır ve ayrıştırma önbelleğinin bloğu parse_cache: olur. Her biri hangi anahtarı kastettiğini ve o anahtarın nereye ait olduğunu söyler.
Nasıl düzeltilir: mesajın adlandırdığı dosyayı açın ve alıntıladığı alan yoluna gidin. Mesaj bir düzeltme önerisi cümlesi taşıyorsa doğru yazımı veya yerleşimi doğrudan adlandırır ve başka bir şey okumanız gerekmez. Bunun yerine bir şema itirazı taşıyorsa, alan yolu hatalı anahtardır ve itiraz şemanın orada ne beklediğini söyler; entity sayfaları bu dosyayı yönetmez, bu nedenle bir entity sözleşmesi aramak yerine itirazı okuyun. Bir artifact_cache_dir, çalışma alanı köküne göre yazılır ve kendine ait bir alt dizin gerektirir; böylece çalışma alanı kökündeki bir katalog dizini önbellek sanılıp atlanmaz. Registry konumu olarak yazılmış bir provider bağlaması elle eklentinin kimliğine yeniden yazılır — oci://hub.aggrega.ai/plugin/provider/compose, provider/compose olur — çünkü bu yapılana kadar dosyayı okuyan her komut, aggrega plugin remove da dahil, onu reddeder; aggrega plugin add provider kimlik biçimini kendisi yazar. Bir işlevi adlandıran ama hiçbir eklenti adlandırmayan bir linter ya da karar rolündeki yönetişim girdisine, o işlevi dışa aktaran eklentinin uri değeri eklenir; hiçbiri aktarmıyorsa girdiyi kaldırın — linter listesinde standart linter bu durumda hiçbir linter yapılandırılmamış gibi çalışır. Dizin olmayan listelenmiş bir katalog dizini, reddin adlandırdığı yolda oluşturulur ya da girdisi reddin adlandırdığı satırdan kaldırılır; listelediği kardeş çalışma kopyası olmadan alınmış bir proje kopyasında bu girdi kaldırılır.
A plugin binding sets a key the socket it attaches to does not read (Bir plugin bağlaması, bağlandığı soketin okumadığı bir anahtar ayarlıyor)
Çalışma alanı yapılandırmasındaki soketler plugin’leri iki farklı yolla bağlar ve bir yola ait bir anahtar diğerinde hiçbir anlam taşımaz. Anahtarı kabul edip sessizce yok saymak yerine yapılandırma reddedilir; böylece bir operatör, ayarın neden hiçbir etkisi olmadığını sonradan merak etmek yerine ayarın etkisiz olduğunu öğrenir.
Bu iki uyuşmazlık birbirinin ayna görüntüsüdür.
Yetenekle bağlanmış kesişen bir soket. Governance, linter ve importer soketleri bir plugin’i doğrudan uri: ile bağlar. Bir governance veya linter plugin’i hiçbir yetenek sunmaz; bu nedenle oradaki bir capability: bağlaması hiçbir şeye karşı aranır ve hiçbir şeyle eşleşmez: asla çözümlenemeyecek bir bağlantı. Bir importer işlediği biçimleri duyurur, ancak hangi biçimin istendiğini söylemek bağlantının değil içe aktarmanın işidir: bir importer bağlantısı importer’ını uri: ile adlandırır ve bir içe aktarmanın istediği biçimi duyuran importer’lar arasından onu seçen budur.
Karşılığı olmayan bir anahtar ayarlayan bir provider soketi. Bir provider bağlaması bir yeteneği ve onu sunan plugin’i adlandırır; plugin, seçilebilir tek bir giriş yerine sabit bir dışa aktarım kümesini yürütür, bu nedenle function: onun üzerinde hiçbir şeyi adlandırmaz. with: farklı bir nedenle reddedilir: bir provider için render yapılandırması Recipe içinde yazılır; bu yüzden onu çalışma alanı bağlamasına koymak, yapılandırmayı geliştirici ile operatör ayrımının yanlış tarafına yerleştirir.
Yayımlanan mesajlar. Kesişen bir soket üzerindeki bir yetenek:
workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (workspaceconfig: <socket> soketi <capability> yeteneğine göre bağlanmış, ancak kesişen soketler uri ile bağlanır: bunların eklentisi hiçbir yetenek sunmaz, bu nedenle yetenek araması hiçbir şeyle eşleşmez; bunun yerine uri: ile bağlayın: kesişen bir soket yeteneğe göre bağlanmış ama uri ile bağlanır)
bir provider bağlaması üzerindeki etkisiz bir function::
workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: <capability> yeteneği için provider soketi bağlaması function: ayarlıyor, ancak bir provider seçilebilir tek bir giriş yerine aşamaya göre anahtarlanmış sabit bir dışa aktarım kümesini çalıştırır, bu nedenle function: orada hiçbir şeyi adlandırmaz; kaldırın: bir provider soketi bağlaması, o sokette karşılığı olmayan bir alan ayarlıyor)
ve aynı biçimde bildirilen ve yapılandırmanın bunun yerine nereye ait olduğunu adlandıran etkisiz bir with::
workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: <capability> yeteneği için provider soketi bağlaması with: ayarlıyor, ancak provider işleme yapılandırması çalışma alanının provider bağlamasına değil Recipe’e aittir; kaldırın: bir provider soketi bağlaması, o sokette karşılığı olmayan bir alan ayarlıyor)
.aggrega-config.yaml içine yazılmış bir function: yukarıdaki cümlesine ulaşmaz: çalışma alanı yapılandırmasının şeması bir provider bağlamasında böyle bir anahtar bildirmez; bu yüzden dosya önce E0224 altında reddedilir ve çözüm aynıdır: anahtarı kaldırın:
workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: plugins.providers girdisinin function alanı: /$defs/FixedEntryPluginRef’e göre beklenmeyen özellik “function”: çalışma alanı yapılandırması geçersiz)
Nasıl düzeltilir: düzeltme .aggrega-config.yaml içindedir ve her mesaj tam düzenlemeyi adlandırır. Bir governance, linter veya importer bağlantısında capability: yerine bağlamak istediğiniz plugin’in uri: değerini yazın. Bir provider bağlamasında adlandırılan anahtarı kaldırın; bu anahtar with: ise o yapılandırmayı, provider üzerinden render eden ve onu okuyan yüzey olan Recipe’ye taşıyın.
A capability is bound to more than one provider plugin (Bir yetenek birden fazla provider plugin’ine bağlanmış)
Bir yetenek, bir workload’u artifact’lere dönüştürmenin tek bir yolunu adlandırır ve çözümlenmiş bir çalışma alanında onu tam olarak bir plugin sunar. Tek bir yetenek için iki bağlama, hangisinin render edeceği sorusunu yanıtsız bırakır; bir çalışma alanı yapılandırması da birkaç katmandan (paylaşılan bir dosya, bir çalışma alanı dosyası ve her birinin katkıda bulunabileceği ekleme eşlikçileri) bir araya getirilir. Bu nedenle ikinci bağlamaya çoğu zaman, yazarı ilkini göremeyen bir katman katkıda bulunur.
Bunu görünür kılan şey reddetmedir. Bir bağlamanın sessizce kazanmasına izin vermek, render edilen çıktıyı hangi katmanın en son okunduğuna bağımlı kılardı.
Yetenek ile kuralı adlandıran yayımlanan mesaj:
workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (workspaceconfig: <capability> yeteneği birden fazla provider eklentisine bağlanmış; her yetenek için tam olarak bir plugins.providers girdisi tutun: yetenek birden fazla provider eklentisine bağlanmış)
Nasıl düzeltilir: mesajın adlandırdığı yetenek için bir plugins.providers girdisi tutun ve diğerini kaldırın. İkisi farklı yapılandırma katmanlarından geliyorsa düzenlenecek olan sizin denetlediğiniz katmandır: kendi girdinizi kaldırmak paylaşılan katmanın katkıda bulunduğu girdiyi benimser, kendinizinkini tutmak ise bunun yerine paylaşılan katmanın girdisinin kaldırılması gerektiği anlamına gelir. Çalışma alanına gerçekten ikisi birden hizmet eden iki plugin iki farklı yeteneği sunar; bu nedenle ikisi de isteniyorsa, birini iki kez bağlamak yerine her birine kendi yeteneğini verin.
An importer is attached by more than one plugins.importer entry (Bir importer birden fazla plugins.importer girdisiyle bağlanmış)
Bir plugins.importer girdisi, uri değerinin adlandırdığı importer’ı bağlar: o importer bir içe aktarmanın istediği biçimi duyurduğunda, girdi onun hangi sürümünün çalışacağına karar verir ve ona girdinin with.sources ve with.settings değerlerini verir. Bunu bir importer için bir girdi yapar; bu nedenle aynı importer’ı (aynı kimliği, aynı sürümde ya da başka bir sürümde) adlandıran ikinci bir girdiyi hiçbir şey okumaz ve with değeri tek söz söylenmeden hiçbir importer’a ulaşmaz. Bunun yerine yapılandırma, hangi komut okursa okusun, yüklenirken reddedilir.
Bir çalışma alanı yapılandırması birkaç dosyadan bir araya getirilir: genel dosya, proje kökünden bir komutun çalıştığı dizine kadar her .aggrega-config.yaml, her birinin taşıyabileceği importer_append eşlikçisi ve bir pipeline’ın .aggrega-config-append-ci.yaml dosyası. Bu nedenle ikinci girdi çoğu zaman ilkinden farklı bir dosyada yazılır. Mesaj importer’ı ve iki girdiyi, önce gelen önce olmak üzere, her birini altında yazıldığı anahtar ve konumla, yazıldığı dosyayla ve orada yazıldığı biçimiyle uri değeriyle adlandırır.
Yalnızca importer listesi değerlendirilir: governance ve linter listeleri, her bağlantı kendi with değerini taşıyarak birden fazla kez bağlanmış tek bir plugin’i kabul eder. uri değeri bir dosya sistemi yolu olan bir girdi hiçbir importer adlandırmaz, bu nedenle karşılaştırılmaz.
Üretilen ileti:
importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (<identity> içe aktarıcısı bir dosyadaki bir anahtar[konum] ile (uri <uri>) ve yine başka bir dosyadaki bir anahtar[konum] ile (uri <uri>) bağlanmış; her içe aktarıcı için, uri’si istediğiniz sürümü adlandıran tam olarak bir plugins.importer girdisi tutun: içe aktarıcı birden fazla plugins.importer girdisiyle bağlanmış)
Nasıl düzeltilir: mesajın adlandırdığı importer için bir girdi tutun (uri değeri istediğiniz sürümü adlandıran ve o importer’a verilmesini istediğiniz with değerini taşıyan girdi) ve diğerini kaldırın. İkisi farklı dosyalardaysa düzenlenecek olan sizin denetlediğiniz dosyadır: kendi girdinizi kaldırmak diğer dosyanınkini benimser, kendinizinkini tutmak ise bunun yerine diğer dosyanın girdisinin kaldırılması gerektiği anlamına gelir.
A provider binding names a capability containing a colon (Bir provider bağlaması iki nokta içeren bir yetenek adlandırıyor)
Bir Recipe’nin capability: değeri, son iki noktaya kadar yetenek adı ve ondan sonra bir sürüm sabitlemesi olarak okunur: helm:1.0.0, 1.0.0 sürümündeki helm yeteneğini ister. Bir plugins.providers girdisi bu ad altında aranır; bu nedenle bir bağlamanın adlandırdığı yetenek hiçbir zaman iki nokta taşımaz ve yeteneği iki nokta taşıyan bir girdiye hiçbir Recipe asla ulaşamaz. Yapılandırmada okunmadan durmasına izin vermek yerine yapılandırma, hangi komut okumuş olursa olsun, yüklenirken reddedilir.
Yalnızca provider listesi değerlendirilir. Importer listesi aynı girdi biçimini paylaşır, ancak plugin’leri uri: ile bağlanır ve biçimlerini, iki noktanın adın parçası olduğu import:<format> olarak adlandırır. Bir bağlamanın uri: değeri yine de :<version> ile bitebilir; bu, bu kuralın okuduğu kısım değildir.
Yeteneği adlandıran yayımlanan mesaj:
the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (<capability> yeteneği için provider soketi bağlaması: bir Recipe’in yetenek başvurusu, son iki noktaya kadar yetenek ve ondan sonra bir sürüm sabitlemesi olarak okunur, bu nedenle bir bağlamanın adlandırdığı yetenek iki nokta içermez; yalnızca yetenek adını bağlayın ve her Recipe’in ihtiyaç duyduğu sürümü sabitlemesine izin verin: bir provider soketi bağlaması iki nokta içeren, hiçbir Recipe’in seçemeyeceği bir yeteneği adlandırıyor)
Nasıl düzeltilir: girdiye yalnızca yetenek adını yazın (capability: helm) ve sürümleri ait oldukları yerde sabitleyin: bir Recipe ihtiyaç duyduğu provider sürümünü kendi capability: değerinde sabitler; plugin’inin belirli bir sürümünü seçmesi gereken bir bağlama ise bunu plugin kimliğine yazar: uri: provider/helm:1.0.0.
A governance attachment declares no role, or one that is not a known role (Bir yönetişim eki hiçbir rol bildirmiyor ya da bilinen bir rol olmayan bir rol bildiriyor)
Bir yönetişim eki bir rol taşır ve ekin nerede çalışacağını ve ne yapabileceğini, yani bir derlemeyi kabul mü yoksa reddetmi edeceğini ve grafiği mi yoksa işlenmiş yapıtları mı okuyacağını, plugin’in kendi bildirdiği tür değil, bu rol belirler. Ekler bu rol okunarak dağıtılır; bu nedenle hiç rol taşımayan ya da kimsenin tanımadığı bir rol taşıyan bir ek hiçbir yere bağlanmaz ve sessizce atlanır.
Reddin önlediği şey bu sessizliktir. Yapılandırılmış ama hiç danışılmayan bir yönetişim plugin’i, hiç yönetişimden geçmemiş bir derlemeyle tam olarak aynı çıktıyı üretir ve sonuçta elinizdekinin hangisi olduğunu söyleyen hiçbir şey yoktur.
Üretilen iletiler; ikisi de eki adlandırır ve var olan rolleri listeler. Eksik bir rol:
workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: belirtilen yönetişim eki hiçbir rol bildirmiyor; role: alanını bilinen rollerden birine ayarlayın: bir yönetişim eki hiçbir rol ya da bilinmeyen bir rol bildiriyor)
ve tanınmayan bir rol:
workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: belirtilen yönetişim eki bilinmeyen bir rol bildiriyor; bilinen rollerden birini kullanın: bir yönetişim eki hiçbir rol ya da bilinmeyen bir rol bildiriyor)
Nasıl düzeltilir:plugins.governance altındaki ekte role: alanını iletinin listelediği rollerden birine ayarlayın. Hangisinin seçileceği plugin’le değil, plugin’in ne yapmasını istediğinizle ilgili bir karardır: kabul eden ya da reddeden bir rol derlemeyi okur ve bir karar döndürür; dönüştüren bir rol ise plugin’in kendisine verileni değiştirmesine izin veren açık bir talimattır. İleti tüm kümeyi listeler, dolayısıyla kullanılacak yazım iletinin kendisindedir.
A registry alias matches more than one host (Bir kayıt defteri takma adı birden fazla ana bilgisayarla eşleşiyor)
Bir kayıt defterine, komutların ve başvuruların ana bilgisayarını açıkça yazmadan onu adlandırabilmesi için çalışma alanı yapılandırmasında kısa bir takma ad verilebilir. Bir takma ad tam olarak bir ana bilgisayar seçer. Bu koşul, iki kayıt defteri girdisinin takma adıyla eşleşen bir belirtecin bildirdiği durumdur: hangi ana bilgisayarın kastedildiğinin yanıtı yoktur ve birini seçmek, yapıtları yazarın adlandırmadığı bir kayıt defterine sessizce gönderir ya da oradan getirir.
Takma adı, onu kaç girdinin sahiplendiğini ve bunların hangi ana bilgisayarlar olduğunu adlandıran üretilen ileti:
registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (kayıt defteri takma adı birden fazla ana makineyle eşleşiyor; kayıt defterine ana makinesiyle başvurun ya da yinelenen takma adı kaldırın: kayıt defteri takma adı birden fazla ana makineyle eşleşiyor)
Nasıl düzeltilir:.aggrega-config.yaml dosyasını açın ve takma adı iletinin listelediği ana bilgisayarlardan yalnızca birine verin ya da kayıt defterini ana bilgisayarıyla belirtip takma adı başvurudan çıkarın. İleti takma adı taşıyan her ana bilgisayarı adlandırır, dolayısıyla hangi girdilere bakılacağı iletidedir. Girdiler farklı yapılandırma katmanlarından geliyorsa, sahibi olduğunuz katmanı düzenleyin.
The lockfile does not satisfy its schema (Kilit dosyası şemasını karşılamıyor)
Bir release’in kilit dosyası, derlemenin neye çözümlendiğini kaydeder: eriştiği her varlık, kütüphane ve plugin için seçilen sürümü ve o sürümdeki baytların özetini. Dosya, türlenmiş sabitlemelere dönüştürülmeden önce okunur ve şemasına göre denetlenir; böylece uymayan bir belge, sessizce eksik sabitlemeler üretmek yerine başarısız olduğu alan yoluyla birlikte reddedilir.
Kilit dosyası makine tarafından yazılır. Bir release’i çözümleyen pull tarafından üretilir ve aynı derlemenin daha sonra da aynı şekilde çözümlenmesi için commit edilir. Bu nedenle bir şema hatası, bilinçli olarak yazılmış bir şey değil, neredeyse her zaman elle yapılmış bir düzenleme, belgeyi yarı çözümlenmiş bırakan bir birleştirme ya da dosyanın daha eski bir biçimi için yazılmış bir kilit dosyasıdır — örneğin entities öğeleri hiçbir kind taşımayan bir dosya.
Eksik bir kilit dosyası farklı bir koşuldur ve farklı bildirilir: kilit dosyası zorunludur, bu nedenle yokluğu derlemenin onu aradığı yerde, onu oluşturan pull’u çalıştırma talimatıyla birlikte bildirilir.
Dosyayı, alan yolunu ve şemanın kendi itirazını adlandıran üretilen ileti:
Bir derleme ve aggrega pull --verify, kilit dosyasını yeniden yazan komutu ekler:
…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: dosya şema doğrulamasından geçemedi; dosyayı Release’ten yeniden yazmak için komutu çalıştırın)
Tamamen boş bir belge, adlandırılacak bir alan olmadığından ayrı olarak bildirilir:
lockfile: <path>: document is empty (lockfile: <path>: belge boş)
Nasıl düzeltilir: kilit dosyasını elle onarmayın. Release için pull’u yeniden çalıştırın; bu, belgeyi yaptığı çözümlemeden yeniden yazar. Ardından sonucu commit edin: sabitlemeleri release’in gerçekte eriştiği şeyle uyuşan bir belgeyi üreten, yeniden çözümlemedir. Hata bir birleştirmenin ardından ortaya çıktıysa, çakışmayı düzenleyerek değil yeniden pull ederek çözmek, ayrıştırılabilen ama yanlış sürümleri sabitleyen bir belgeden kaçınmayı sağlar. İletideki alan yolunu önce okumaya değer: hasarın tek bir girdide mi yoksa belgenin genel yapısında mı olduğunu size söyler.
Kataloğu çözümlerken
Yüklemeden sonra derleyici, her Component için Recipe’yi seçmek üzere Manifest’in iki katmanını (önce tür haritası, ardından ad haritası) dolaşır ve Manifests, Components veya Features üzerindeki tüm extends zincirlerini izler. Bir Release’in kendi extends zinciri de aynı dolaşmayla, bir adım önce izlenir: zincir, Release çözümlenirken, adını verdiği Manifest ya da Aggregate aranmadan önce izlenir; bu nedenle aşağıdaki koşullar, zincirin sağlayacağı kardeş bir işaretçiye karşı değil, Release’e karşı raporlanır.
Döngüsel extends zinciri
Bir extends işaretçileri zinciri kendi üzerine geri döner. extends bildiren her tür (Component, Feature, Manifest ve Release) tek bir zincir dolaşmasıyla izlenir; bu nedenle bir döngü, nerede bulunursa bulunsun aynı sözcüklerle raporlanır.
Üretilen ileti. İleti, koşulu adlandıran cümleyle açılır; ardından çözümlemenin başladığı varlık ve onu reddeden kural, sonra da döngüyü kapatan kenar gelir: sorunlu extends: değerini taşıyan varlık ve bildirdiği başvuru:
cyclic extends chain (<kind><name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (döngüsel extends zinciri (<kind><name>, extends kuralı). <entity>, zaten zincirde bulunan <reference> öğesini genişletiyor; <entity> üzerindeki extends’i kaldırın veya zincirin dışındaki bir varlığa yönlendirin)
İlk adı verilen varlık ile kenarda adı verilen varlık genellikle farklıdır ve asıl önemli olan da budur: döngü, üzerindeki her varlığa karşı raporlanır; düzenlenmesi gereken extends: satırı ise kenarın adını verdiğidir. Başlığı değil, kenarı izleyin.
Bir Manifest için <kind>Manifest olarak okunur, her varlık kendi metadata.name değeriyle adlandırılır ve <reference>, extends: değerinin tam olarak yazıldığı hâlidir — ./base.yaml gibi göreli bir yol ya da Release’in yanındaki bir Manifest’in yalın metadata.name değeri. İki biçimden hangisini yazdığınız raporlanan şeyi değiştirmez: bir Manifest bağlantısı, çözümlendiği dosyadır; dolayısıyla aynı metadata.name değerini bildiren iki Manifest dosyası iki ayrı bağlantıdır ve her ikisinden geçen bir zincir döngü değildir.
Bir Release de aynı biçimde okunur ve dosya kimliği noktası orada daha da önemlidir, çünkü koruduğu yapı sıradandır: <kind> değeri Release olur, <reference>, extends: alanının adını verdiği göreli yoldur ve bir Release bağlantısı çözümlendiği dosyadır. Ortamı değil, dağıtılan sistemi adlandıran iki Release dosyası (ikisi de metadata.name: shared-release, biri diğerini genişletiyor) iki ayrı bağlantıdır ve ikisinden geçen bir zincir döngü değildir.
Bir döngü, ne kadar uzun olursa olsun döngü olarak raporlanır. Zincir dolaşması derinlik sınırını yalnızca sona eren bir zincire uygular; bu nedenle sınırın izin verdiğinden fazla varlığı kapsayan bir döngü, aşırı derin zincir olarak değil yine burada raporlanır. Bir döngünün çözümü hiçbir zaman onu kısaltmak değildir.
Nasıl düzeltilir: kenarın adını verdiği varlığı açın ve ya extends: alanını kaldırın ya da onu zincirde zaten bulunmayan bir varlığa yönlendirin. Birkaç katmanın içerik paylaşması amaçlandıysa, yinelenen içeriği tek bir temel varlıkta toplamak döngüyü ve yinelemeyi birlikte ortadan kaldırır.
Recipe implements değeri eşlenen bileşen türüyle eşleşmiyor
Manifest’in eşleme girdisi, spec.implements: bildirimi o eşleme girdisinin bileşen türü anahtarıyla eşleşmeyen bir Recipe’yi gösteriyor. spec.implements bir dağıtım mekanizması değil, bir tutarlılık çapasıdır: eşleme değeri Recipe’yi doğrudan adlandırır ve bu denetim, yazarın adlandırdığı Recipe’nin eşlediği türü bildiren bir Recipe olduğunu doğrular.
Denetim, herhangi bir Recipe çözümlenmeden önce birleştirilmiş Manifest’i okur; bu nedenle yazarın yazdığı eşleme girdisini raporlar, onun aşağı akıştaki bir belirtisini değil.
Üretilen ileti:
manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (manifest eşleme girdisinin recipe spec.implements değeri eşlenen bileşen türü / özellik türü anahtarıyla eşleşmiyor)
Bir Release’in bağımlılıklarını okuyan her komut bu denetimi yapar; farklı olan, her birinin sonuçla ne yaptığıdır.aggrega build ve aggrega pull durur, çünkü ikisi de sizin kullanmaya devam edeceğiniz bir şey üretir: işlenmiş yapıtlar ve bir kilit dosyası. aggrega validate ve aggrega lint bulguyu buldukları diğer tüm tanılamalarla birlikte raporlar ve sıfır dışı bir kodla çıkar: görevleri çalışma alanında yanlış olan her şeyi size söylemektir, bu nedenle tek bir hata raporu yarıda kesmez. Düzenleyicide bulgu diğerlerinin yanında bir tanılama olarak yayımlanır ve o belgenin raporlayacağı diğer her şey etkilenmez. Nerede göründüğüne dikkat edin: düzenleyici bulguyu Aggregate’te değil, eşlemenin yazıldığı Manifest’te, adlandırdığı eşleme girdisinin anahtarında yayımlar; Manifest’in açık metni o girdiyi yazmadığında, örneğin extends aracılığıyla devraldığı bir girdide, bulgu Manifest’in ilk satırında yer alır. Release’in, çalışma alanınızdaki hiçbir belgeyi adlandırmayan diğer bağımlılık düzeyindeki bulguları Aggregate’te kalır. aggrega validate çalıştırmak, hangi belge açık olursa olsun bulguyu raporlar.
Kataloğun içermediği bir Recipe’yi adlandıran eşleme girdisi bu koşul değildir: denetimin karşılaştıracağı bir şey yoktur ve girdiyi atlar; çözümlenemeyen Recipe, tarifler çözümlenirken raporlanır.
FeatureRecipe girdileri aynı yapıyı izler; features.type eşleme denetimi manifest feature mapping ... featurerecipe spec.implements is ... (expected ...) iletisini üretir ve özellik kolu doğrudan eşleme anahtarının kendisiyle eşleştiğinden hiçbir extends alternatifi adlandırmaz.
Bir components.type anahtarı, başka bir sürümün örneğine her ulaştığında örnek başına da değerlendirilir. Bir örneğin tam türünü adlandırmayan bir anahtar, o tam türü adlandıran bir anahtar olmadığında ve aynı taban için başka bir anahtar yazılmadığında, ona türün tabanı üzerinden ulaşır; bu nedenle sürümsüz yazılmış bir anahtar ya da başka bir sürümü adlandıran bir anahtar ona ulaşabilir. Dolayısıyla girdi tek başına Recipe’sinin uyup uymadığını söyleyemez; bu yüzden derleme, anahtarın bu şekilde ulaştığı her bileşen örneği için Recipe’yi yeniden değerlendirir ve anahtarın yerine, derlemenin örneği derlediği sürümdeki örneğin kendi türünü koyar: örneğin adlandırdığı sürüm ya da sürüm adlandırmayan bir örnek için katalogdaki o Component’in en yüksek sürümü. Sürümünü Recipe’nin spec.implements: alanının karşılamadığı bir örnek (tam olarak, şapka aralığıyla, sürümsüz olarak ya da örneğin türünün extends ettiği bir taban üzerinden) bu koşulu tetikler ve Manifest dosyasında değil, örneğin .spec.components.<instance> yolunda raporlanır:
manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (Manifest eşleme girdisinin tarifindeki spec.implements, eşlenen bileşen türü ya da özellik türü anahtarıyla eşleşmiyor (Manifest; örneğin türü ve derlendiği sürüm, ulaşılan eşleme anahtarı, eşlenen tarif ve onun spec.implements değeri). bu türü bu sürümde, onu uygulayan bir tarife, sürümü adlandıran bir eşleme anahtarıyla eşleyin)
compiled as değeri yalnızca türü sürüm adlandırmayan bir örnek için görünür; sürüm adlandıran bir örnek sürümünü of type içinde gösterir. Örneğin kendi sürümünü adlandıran bir anahtar ikinci bir değerlendirme gerektirmez, çünkü girdi üzerindeki denetim bunu zaten sormuştur; anahtarı nedeniyle zaten reddedilmiş bir girdi ise her örnek için bir kez daha değil, yukarıdaki gibi bir kez raporlanır. aggrega build ve aggrega pull bunda durur; aggrega validate --release bunu raporlar ve sıfır olmayan bir kodla çıkar. aggrega lint, bir Manifest’in eşleme girdilerini değerlendirir, ulaştıkları örnekleri değil; bu yüzden bunu raporlamaz.
Nasıl düzeltilir: ya Recipe’nin spec.implements: bildirimini Manifest’in bileşen türü anahtarıyla eşleşecek biçimde düzeltin ya da Manifest girdisini, spec.implements: değeri bileşen türü anahtarıyla eşleşen bir Recipe’yi gösterecek şekilde değiştirin. Bir anahtarın başka bir sürümde ulaştığı bir örnek için, örneğin sürümünü adlandıran ve onu uygulayan bir Recipe’ye eşlenen bir eşleme anahtarı ekleyin ya da ulaşan anahtarı böyle bir Recipe’ye yönlendirin.
Manifest mapping value is not a shape a recipe reference accepts (Manifest eşleme değeri, bir tarif başvurusunun kabul ettiği bir biçimde değil)
Bir Manifest eşleme değeri, bir Recipe ya da FeatureRecipe’yi başvuru dilbilgisinin ifade edemeyeceği bir biçimde adlandırıyor. Bir tarif başvurusu yalın bir adı, sürümlü bir adı, yetenekle nitelenmiş bir adı ya da sürümlü ve yetenekle nitelenmiş bir adı kabul eder; en fazla bir / içerebilir. Bundan fazlasını taşıyan bir değer (core/helm/eso-aws-fetcher:1.0.0 gibi bileşen türü tarzında bir yol), katalog ne içerirse içersin hiçbir zaman bir katalog varlığını adlandıramaz.
Biçim, Manifest birleştirilirken, herhangi bir şey aranmadan önce değerlendirilir; karar bir dizedeki ayırıcıları saymaktan gelir, dolayısıyla hiçbir kataloğa ihtiyaç duymaz. Değerlendirmeyi orada yapmak tanılamayı dürüst kılar: değerin kastettiği tarif çoğunlukla mevcuttur ve doğru adlandırılmıştır; eksik olduğunun söylenmesi sizi yanlış şeyi aramaya yöneltir. Bir Release’in bağımlılıklarını çözümleyen her komut bunu aynı şekilde raporlar; dolayısıyla hangisini çalıştırdığınıza bağlı değildir.
Üretilen ileti:
malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (bir Manifest eşleme değerinde hatalı biçimli tarif başvurusu: spec.mappings.components.type.<key>, eğik çizgiyle ayrılmış <n> kesim taşıyan <value> değerine eşleniyor; bir tarif başvurusu “name”, “name:version”, “capability/name” veya “capability/name:version” kabul eder; Manifest’teki eşleme değerini düzeltin)
features bölümü kendi koordinatına karşı aynı iletiyi üretir ve bir özellik tarifi başvurusu bu şekilde adlandırılır.
Yetenek kesimi bir sürüm sabitlemesi taşıyan bir değer (compose:1.2.3/svc:1.0.0) de herhangi bir şey aranmadan önce aynı şekilde reddedilir; bu yüzden bir kayıt defterinden hiçbir şey getirilmez. Sabitleme, Recipe’nin bildirdiği capability üzerine aittir; orada o yeteneğe hizmet eden eklentinin hangi sürümünün onu işleyeceğini seçer. Bir başvuru, Recipe’yi yalın yeteneğiyle adlandırır (compose/svc:1.0.0).
malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (bir Manifest eşleme değerinde hatalı biçimlendirilmiş tarif başvurusu: bu anahtarın değeri yetenek kesiminde bir sürüm sabitlemesi taşıyor; sabitleme tarifin bildirdiği capability üzerine aittir ve bir tarif başvurusu tarifi yalın yeteneğiyle adlandırır; Manifest’teki eşleme değerini düzeltin)
Nasıl düzeltilir: eşleme değerini dilbilgisinin kabul ettiği bir biçime kısaltın. Bir tarif kendi metadata.name değeriyle tanımlanır (isteğe bağlı olarak önüne spec.capability değeri, sonuna sürümü eklenerek); uyguladığı bileşen türü yoluyla asla tanımlanmaz. Eşlemenin anahtarı bileşen türüdür; eşlemenin değeri tariftir.
Şununla karıştırılmamalıdır: kataloğun içermediği bir tarifi adlandıran, biçimi doğru bir değer. Bu gerçekten bulunmayan bir varlıktır ve URI’yi ve ona başvuran eşleme girdisini adlandırarak yine öyle raporlanır.
Birden çok Recipe tek bir Component türünü uygular
İki veya daha fazla Recipe, spec.implements: altında aynı Component türünü bildirir: tek bir tür için kesin sürümlü iki Recipe ya da sabitlenmiş bir Recipe’in yanında sürümsüz bir Recipe.
Bu durum kendi başına bir durdurma oluşturmaz ve derlemenin çözmesi gereken bir belirsizlik değildir. Recipe seçimi yalnızca eşlemeye dayanır: hiçbir şey spec.implements: değerini okuyup adaylar arasından seçim yapmaz; dolayısıyla bir türü kaç Recipe uygularsa uygulasın, bir örneği işleyen, Manifest’in o örneği eşlediği Recipe’tir. spec.implements: bir tutarlılık çapası olarak okunur (yazarın eşlediği Recipe’in, eşlediği türü bildiren bir Recipe olduğunu doğrular) ve bir durdurmanın önerdiği sabitleme adaylarının kaynağı olarak kullanılır. Hiçbir zaman seçim yapmaz.
Bunun yerine karşılaştığınız durum, Manifest’in hiçbir şeye eşlemediği bir örnek için verilen durdurmadır ve bu durdurma, birini sabitleyebilmeniz için türü uygulayan her Recipe’i listeler; aşağıdaki “No Recipe is mapped for a component or feature instance (Bir bileşen veya özellik örneği için hiçbir Recipe eşlenmemiş)” bölümüne bakın. Türü bir Recipe de uygulasa beş Recipe de uygulasa aynı şekilde raporlanır; bu nedenle aranacak ayrı bir belirsizlik koşulu yoktur.
Nasıl düzeltilir: eşlemeyi ekleyin. Tür anahtarlı bir girdi, türün her örneğini yönlendirir; ad anahtarlı bir girdi ise adı verilen tek bir örneği yönlendirir ve önce okunur; bu nedenle bir örneğe kardeşlerinden farklı bir Recipe vermenin yolu da budur.
Bir Release, bir temel Release’ten miras almak için extends: kullanır ama kendi aggregate: işaretçisini de bildirir. Release JSON Schema’sı bu yapıyı şema doğrulamasında (Katman 1, zarf denetimi) bir allOf kısıtıyla reddeder: extends: mevcut olduğunda aggregate: yasaktır; extends: bulunmadığında hem aggregate: hem de manifest: zorunludur.
Sıradan bir zarf ihlali olarak durur; dolayısıyla tanılama bu sınıfın biçimini alır (error-translation.md içindeki “The document-envelope failure class” bölümüne bakın) ve bulgu, burada izin verilmeyen anahtarı gösterir:
document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (belge zarfı doğrulaması başarısız oldu (Release, konum <path>); <line>:<column>: spec.aggregate: değer burada izin verilmeyen bir yapıyla eşleşiyor. belgeyi türünün şemasına uyacak şekilde düzeltin)
Nasıl düzeltilir: alt Release’ten aggregate: alanını kaldırın. Kalıtım, alt öğeyi bilerek üst öğesiyle aynı Developer Intent’i dağıtmaya zorlar; farklı bir Aggregate dağıtmanız gerekiyorsa extends: olmadan yeni bir Release yazın.
A feature attached by both the Aggregate and the Release cannot be merged (Hem Aggregate hem de Release tarafından eklenen bir özellik birleştirilemiyor)
Yerel bir Manifest bir temel Manifest’i extends ile genişlettiğinde, iki katman (type: eşlemi, name: eşlemi) birbirinden bağımsız olarak birleşir. Her katmanda alt anahtarlar üst anahtarların üzerine en üst düzeyde yazılır; bu derin bir birleştirme değil, yüzeysel bir değiştirmedir. Belirli bir anahtar için alt girdi, üst öğenin o anahtara ait girdisinin tamamen yerini alır.
Aynı özellik örneği adı hem Aggregate tarafında hem de Release tarafında, birleştirilemeyen çelişkili bir durumla (izin verilen infra katmanlamasının ötesinde) göründüğünde, derleyici durur ve tanılamayı uzlaştıramadığı eklentinin üzerine konumlandırır. Çelişen iki bildirim sabit bir sırayla gelir (önce Aggregate’in bildirdiği tür, ardından Release’in bildirdiği tür); böylece iki belgeyi de açmadan hangisinin ne dediğini anlayabilirsiniz.
Üretilen ileti:
feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (özellik birleştirme çakışması: özellik için Aggregate ve Release bildirimlerini uzlaştırın (Aggregate’in bildirdiği tür, Release’in bildirdiği tür))
Aynısı bir bağlantının taşıdığı eklenti için de geçerlidir. Aggregate’in bağlantı girdisi ile Release’in aynı bağlantıya ait girdisi bir yuva altında birer eklenti yazıp farklı Features adlandırdığında, derleme, birleşim düzleştirildikten sonra Release’in girdisinde (ikinci türün yazıldığı yerde) durur ve her iki türü, yuvayı, bağlantıyı, soketi ve bileşeni adlandırır:
feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (özellik birleştirme çakışması: özellik için Aggregate ve Release bildirimlerini uzlaştırın. Release girdisinin Aggregate’in bildirdiği eklentiyi boyutlandırması için türü bu girdiden kaldırın ya da her iki belgede aynı Feature’ı adlandırın.)
Nasıl düzeltilir: iki bildirimi uzlaştırın. Aynı özellik örneğinin Aggregate tarafı ve Release tarafı bildirimleri sütuna göre birleşir: Aggregate values katkısını, Release infra katkısını sağlar. Her iki taraf da sütun olmayan aynı alanı (örneğin type:) belirtiyorsa değerler eşleşmelidir; bir tarafı diğeriyle eşleşecek şekilde düzeltin ya da gereksiz bildirimi kaldırın.
Annotation binding does not resolve against its target Feature (Ek açıklama bağlaması hedef Feature’a karşı çözümlenmiyor)
Bir Manifest ek açıklama bağlamasının feature: alanı, kataloğun yüklemediği bir Feature’ı adlandırır ya da bağlamanın maps.infra / maps.values listeleri, adı verilen Feature’ın spec.schema alanının gerçekte taşımadığı noktalı yollar bildirir. Her iki koşul da çalışma alanının yüklenmesini durdurur; bağlama, değerleri çalışma zamanının çözümleyemeyeceği yollara yönlendiren Feature eklentileri sentezlerdi.
Tek bir koşul, bir bağlamanın yolunun çözümlenemediği üç durumu kapsar ve tanılama bunlardan hangisinin gerçekleştiğini belirtir:
Feature bulunamadı.feature: değeri, yüklenen katalogda bulunmayan bir Feature URI’sine başvurur.
Feature şeması çözümlenmiyor. Adı verilen Feature yüklenir, ancak spec.schema: alanı bir JSON Schema 2020-12 gösterimine çözümlenmez: içerik bozuktur ya da izlenemeyen, belgeler arası bir başvuruyu adlandırır. Bu değişken, çözümleme hatasının kendi tanılamasını arkasında taşır; böylece şemanın neden çözümlenmediği aynı durdurmadan okunabilir.
Bağlama yolu hedef şemada yok. Bağlamanın maps.infra veya maps.values girdisi, Feature’ın spec.schema.<pillar>.<path> alanının bildirmediği noktalı bir yolu adlandırır.
Üretilen ileti (Feature bulunamadı değişkeni):
annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (ek açıklama bağlaması hedef Feature’a karşı çözümlenmiyor; bağlama, bu derlemenin kataloğunda bulunmayan bir Feature’a yönlendiriyor; feature altında adı verilen Feature’ı düzeltin veya yayımlayın)
Üretilen ileti (şema çözümlenmiyor değişkeni):
annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (ek açıklama bağlaması hedef Feature’a karşı çözümlenmiyor; bağlama, bildirilen şeması çözümlenmeyen bir Feature’a yönlendiriyor)
Bu değişken Feature’ı ve çözümleme hatasını adlandırır; bağlama anahtarını da kaynak konumunu da taşımaz, çünkü hata, bağlamanın yalnızca adlandırdığı Feature’ın kendi spec.schema: alanındadır. Sorunlu bağlamayı, iletinin alıntıladığı Feature URI’sini mappings.features.annotations içinde arayarak bulun.
Üretilen ileti (yol bulunamadı değişkeni):
annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (ek açıklama bağlaması hedef Feature’a karşı çözümlenmiyor; bağlama, o Feature’ın schema altında özellik bildirmediği bir sütun ve yola yönlendiriyor)
Nasıl düzeltilir: bağlamanın feature: URI’sinin katalogda bulunduğunu ve bir Recipe’in implements: ile belirttiği, büyük/küçük harfe duyarlı URI ile eşleştiğini doğrulayın. Yol bulunamadı değişkeni, Feature şemasının gerçekten bildirdiği bir yolda tetikleniyorsa noktalı yolun yazımını (büyük/küçük harfe duyarlı) ve sütun adını (infra veya values) doğrulayın.
A bound annotation value does not conform to the target Feature’s schema (Bağlanan bir açıklama değeri hedef Feature’ın şemasına uymuyor)
Yazdığınız bir açıklama, bir bağlama aracılığıyla hedef Feature üzerindeki bir yola bir değer yönlendirir ve bu değer, Feature’ın o yolda bildirdiği alt şemayı karşılamaz ya da Feature orada hiç özellik bildirmez. Koşul bağlama yerine değer üzerinden okunur; yukarıdaki bağlama hedefi durdurmasından ayrı olmasının nedeni budur: o durdurma Manifest’in bildirdiğini reddeder, bu ise onun aracılığıyla yazılanı reddeder.
Bulunan yolda tam doğrulama; yalnızca yol bulunamadığında yumuşak atlama. Bağlanan alt anahtarın alt şeması bulunduğunda değer, o yoldaki eksiksiz JSON Schema 2020-12 kısıtlama kümesine (tür, enum, desen, sayısal aralık, iç içe nesne/dizi biçimi) göre doğrulanır; uçtaki bir $ref / allOf / oneOf şemanın tanımlarına göre çözülür ve doğrulanır, atlanmaz. Yumuşak atlama disiplini yalnızca gezinme için geçerlidir: gezgin, bağlanan yaprağa ulaşmadan önce ara bir segmentte bir kaçış yolu ($ref, patternProperties, oneOf/anyOf/allOf ya da şema gövdeli additionalProperties) ile karşılaştığında yol statik olarak çözülemez; bu nedenle doğrulayıcı yanlış bir durdurma riskine girmek yerine hatayı vermeden devam eder ve o bağlamanın doğrulama yüzeyi çalışma zamanı olarak kalır.
Üretilen ileti (değer uygunluğu çeşidi):
annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (açıklama alt anahtarı, yönlendirilen sütunda hedef Feature’ın şemasına uymuyor: açıklama alt anahtarı <subkey> değeri <value>, Feature <feature-uri> spec.schema.<pillar>.<subkey> ile uyumlu değil: <constraint failure>)
Üretilen ileti (bildirilmemiş alt anahtar çeşidi):
annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (açıklama alt anahtarı, yönlendirilen sütunda hedef Feature’ın şemasına uymuyor: açıklama alt anahtarı <subkey>, Feature <feature-uri> spec.schema.<pillar>.<subkey> altında bildirilmemiş)
Durdurma, bir Feature eklentisine genişletilmeden önce, yazıldığı haliyle açıklama üzerinde verilir; bu nedenle tanılama, değerin yazıldığı belgeyi ve kapsamı (Release tarafı bir açıklama için sınır ve bileşen, Aggregate tarafı bir açıklama için bileşen yolu) ve değerin geldiği açıklama anahtarını adlandırır.
Bir yönetişim eklentisinin enjekte ettiği bir açıklama da aynı şekilde değerlendirilir ve tanılama onu kimin yazdığını söyler. Açıklama enjekte etmek için eklenmiş bir eklenti, değerini bir Release bileşenine ayarlar; bu yüzden değer, bir operatörün oraya yazdığı bir değerle tam olarak aynı şekilde denetlenir; ancak tanılamanın işaret ettiği Release satırını kimse yazmamıştır. Bu nedenle tanılama, değeri hangi eklentinin enjekte ettiğini ve eklentinin bağlı olduğu yönetişim rolünü ekler; düzeltme de Release’te değil, o eklentinin kararındadır.
Nasıl düzeltilir: bağlanan değeri bildirilen alt şemayı karşılayacak şekilde düzeltin ya da değer meşruysa o özelliğin şemasını genişletin. Bildirilmemiş alt anahtar çeşidinin önüne genellikle yukarıdaki bağlama hedefi durdurması geçer; bu çeşide ulaşılması, bağlamanın yolu bildirdiği ama Feature’ın şemasının onu taşımadığı anlamına gelir; bu durumda ikisinden hangisi yanlışsa onu düzeltin. Bir ara birleştirme işleci bir yolu çözülemez kıldığında ve çalışma zamanı onu daha sonra reddettiğinde, özelliği doğrudan bağlamanın yolunda ortaya çıkarmak için şemayı daraltın.
An annotation subkey is not routed by its binding (Bir açıklama alt anahtarı bağlaması tarafından yönlendirilmiyor)
Yazdığınız bir açıklama, bir Manifest açıklama bağlamasının sahiplendiği bir anahtarın altında alt anahtarlar taşır ve bu alt anahtarlardan biri, bağlamanın yönlendirmediği bir addır: ne maps.infra ne de maps.values altında listelenmiştir. Her alt anahtar, bağlamanın onun için bildirdiği Feature yoluna ayrı ayrı yönlendirilir; bu yüzden bağlamanın adlandırmadığı bir alt anahtarın gidecek yeri yoktur. Açıklamayı onsuz genişletmek, yazdığınız bir değeri hiçbir şey söylenmeden derlemenin dışında bırakırdı ve olağan neden yanlış yazılmış bir alt anahtardır; bu yüzden derleme bunun yerine durur ve alt anahtarı, altına yazıldığı açıklama anahtarını ve bağlamanın gerçekten yönlendirdiği her alt anahtarı adlandırır.
Durdurma, yanındaki iki koşulda olduğu gibi, bir Feature eklentisine genişletilmeden önce, yazıldığı haliyle açıklama üzerinde verilir: yukarıdaki “A bound annotation value does not conform to the target Feature’s schema (Bağlanmış bir açıklama değeri hedef Feature’ın şemasına uymuyor)”, Feature değerini reddettiğinde bağlamanın yönlendirdiği bir alt anahtarı reddeder; aşağıdaki “An annotation routes through a pillar its authoring side may not use (Bir açıklama, yazan tarafının kullanamayacağı bir sütun üzerinden yönlendiriliyor)” ise yanlış sütun üzerinden yönlendirilen bir alt anahtarı reddeder. Hiçbir bağlamanın sahiplenmediği bir anahtar bu koşul değildir: onu hiçbir şey yönlendirmez ve derleme onu atlar.
Belgeyi ve açıklamanın yazıldığı yeri, alt anahtarı, açıklama anahtarını ve bağlamanın yönlendirdiği alt anahtarları adlandıran üretilen ileti:
annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (açıklama alt anahtarı, açıklamanın bağlaması tarafından yönlendirilmiyor (Release; alt anahtar bu açıklamanın altına yazılmış, ancak bağlaması yalnızca listelenen alt anahtarları yönlendiriyor))
Bir Aggregate’te yazılmış bir açıklama da aynı şekilde, orada yazıldığı yerle adlandırılır; bir alt sistem üzerine yazılmış bir açıklama için (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …). Derleme, onu yazan belgeye göre Release tarafı bir açıklamayı OPS_ERROR etiketi altında, Aggregate tarafı bir açıklamayı ise DEVELOPER_ERROR etiketi altında raporlar.
Nasıl düzeltilir: alt anahtarı iletinin listelediklerle karşılaştırın. Yazım hatasıysa, bağlamanın yönlendirdiği alt anahtara düzeltin. Değerin Feature’a ulaşması amaçlanıyorsa, bağlamanın onu yönlendirmesi gerekir: Manifest’te bağlamanın maps.infra ya da maps.values listesine yolu (Feature’ın şemasının bildirdiği bir yol) ekleyin ya da alt anahtarı açıklamadan kaldırın.
A bare annotation value does not route to exactly one path of its binding (Yalın bir ek açıklama değeri, bağlamasının tam olarak tek bir yoluna yönlenmiyor)
Yalın bir değer olarak yazdığınız bir ek açıklama — alt anahtarlardan oluşan bir eşlem yerine feature.aggrega.ai/monitoring: "30s" — hiçbir alt anahtarı adlandırmaz; bu nedenle içindeki hiçbir şey hangi Feature yolunu doldurduğunu söylemez. Değer, maps.infra ve maps.values birlikte sayılarak bağlamanın bildirdiği tek yola yerleştirilir. Birden fazla yol bildiren bir bağlama, değere gidebileceği birkaç yer bırakır ve aralarında seçim yapacak hiçbir şey bırakmaz; bu nedenle derleme birini seçmek yerine durur. Sayım her iki listeyi kapsar; bu nedenle bir yolu infra üzerinden, diğerini values üzerinden yönlendiren bir bağlama, yalın bir değeri hangi belgede yazılmış olursa olsun reddeder.
Durdurma, yanındaki koşullarda olduğu gibi, ek açıklama bir Feature ekine genişletilmeden önce yazıldığı haliyle ek açıklama üzerinde verilir; bu nedenle tanılama, belgeyi ve değerin yazıldığı yeri belirtir. Denetim, yazdığınız her ek açıklama için bir kez yapılır: bir sınıra ya da bir alt sisteme yazılmış bir değer, içindeki bir bileşen onu alsa da almasa da orada bir kez reddedilir. Derlemedeki bu tür her değer raporlanır, yalnızca ilki değil. Derleme, onu yazan belgeye göre, Release tarafındaki bir ek açıklamayı OPS_ERROR etiketiyle, Aggregate tarafındakini ise DEVELOPER_ERROR etiketiyle raporlar. Koşul a scalar annotation value does not route to exactly one path of its binding olup aggrega explain komutunun kodu için yazdırdığı da budur.
Ek açıklamanın yazıldığı belgeyi ve yeri, ek açıklama anahtarını, değeri ve bağlamanın yönlendirdiği yolları belirten verilen ileti:
a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (skaler bir ek açıklama değeri, bağlamasının tam olarak tek bir yoluna yönlenmiyor: anahtar yalın bir değer taşıyor, bağlaması ise birden fazla yola yönlendiriyor)
Boş bir değer hiçbir şey yazmaz; bu nedenle iki listeden birinin tek bir yol içerdiği her yere yerleştirilir ve yalnızca ikisi de içermediğinde reddedilir. Hiç yol bildirmeyen bir bağlama, Manifest şeması bir yol gerektirdiği için Manifest yüklenirken reddedilir; bu nedenle bir derleme bu koşula bu yoldan ulaşmaz.
Bir yönetişim plugin’inin enjekte ettiği bir ek açıklama da aynı şekilde değerlendirilir; yanındaki koşullarda olduğu gibi, tanılaması değeri hangi plugin’in enjekte ettiğini ve plugin’in hangi yönetişim rolünde eklendiğini ekler.
Nasıl düzeltilir: ek açıklamayı, her değerin hangi alt anahtar için olduğunu adlandıran bir eşlem olarak yazın — feature.aggrega.ai/monitoring: {interval: 30s} — böylece her değer kendi adıyla yönlenir; ya da tek değere, başka bir ek açıklama anahtarı altında, yalnızca doldurduğu yolu bildiren kendine ait bir bağlama verin.
An annotation routes through a pillar its authoring side may not use (Bir açıklama, yazıldığı tarafın kullanamayacağı bir sütun üzerinden yönlendiriliyor)
Açıklamalar yazıldıkları tarafa göre bölümlenir ve bu bölümleme, yazılan diğer her sütunu yöneten bölümlemenin aynısıdır: Aggregate tarafı bir açıklama yalnızca values hedefleyen bir bağlama yolu üzerinden, Release tarafı bir açıklama ise yalnızca infra hedefleyen bir yol üzerinden yönlendirilebilir. Başka her eşleşme durdurur.
Bölümleme, açıklama kısayolunun diğer tarafın sütununu yazmanın bir yoluna dönüşmesini engeller. Bir geliştiricinin açıklaması values katar; bir operatörünki infra boyutlandırması katar. Her iki sütunda yol bildiren bir bağlama kendi başına bir hata değildir: her taraf izin verilen alt kümeyi yönlendirir ve diğer tarafın yollarına o taraftan erişilemez.
Bir yolu her iki sütun listesinde bildiren bir bağlama, bu durdurmaya en sık ulaşan durumdur. Yönlendirmedeki eşitlik bozma kuralı böyle bir yolu infra üzerinden gönderir; bu da yolu Aggregate tarafından erişilemez kılar ve ona yönlendirilen Aggregate tarafı bir açıklama burada durur. Bir derleme bu durdurmaya ulaşmadan önce o bağlama biçimini adlandıran uyarı warnings.md içinde açıklanır.
Üretilen ileti:
annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (açıklama, yazıldığı tarafın kullanamayacağı bir sütun üzerinden yönlendiriliyor: <source> konumundaki <key> açıklaması <path> yolunda <pillar> sütunu üzerinden yönlendiriliyor, ancak <side> tarafı açıklamalar yalnızca <permitted-pillar> sütunu üzerinden yönlendirilebilir)
Bir yönetişim eklentisinin enjekte ettiği bir açıklama bir Release bileşeni üzerinde bulunur; bu yüzden Release tarafı bir açıklamadır ve aynı bölümleme ona da uygulanır. Tanılaması, onu hangi eklentinin enjekte ettiğini ve eklentinin bağlı olduğu yönetişim rolünü ekler, çünkü işaret ettiği Release anahtarını kimse yazmamıştır.
Nasıl düzeltilir: açıklamayı, bağlamanın hedeflediği sütunun ait olduğu taraftan yönlendirin ya da kendi açıklama anahtarı altında, yolları yazan tarafın izinli olduğu sütunu hedefleyen bir bağlama ekleyin. Bir bağlama aynı yolu her iki sütun listesinde bildiriyorsa, her tarafın erişebileceği bir yolu olması için onu iki bağlamaya bölün. Tanılama enjekte eden bir eklentiyi adlandırıyorsa, açıklama o eklentinin kararından gelir: eklentiyi ya da onun altında enjekte ettiği bağlamayı düzeltin.
Authored values or infra do not conform to the declared schema (Yazılan values veya infra bildirilen şemaya uymuyor)
Bir bileşen örneğinin ya da eklenmiş bir Feature’ın çözümlenmiş values: veya infra: değeri, bildirilen katalog şemasına uymuyor. Derleme, işlemeden önce her sütunu bildirilen şemasına göre doğrular; böylece yazım hatalı bir anahtar, yanlış türde bir değer, aralık dışı bir sayı ya da eksik bir zorunlu alan, dağıtım zamanında bozuk bir manifest üretmek yerine kaynağında yakalanır.
Denetim standart şema kısıtlamalarını kapsar: yanlış türde bir değer (şemanın tamsayı bildirdiği yerde bir dize), bildirilen bir aralığın ya da enum dışında kalan bir değer, bildirilen bir pattern ile eşleşmeyen bir değer, bildirilen format için geçerli bir örnek olmayan bir dize (adlandırılmış biçimlerden biri) ve sağlanmamış zorunlu bir alan. Bir biçim hatası anahtar sözcüğü adlandırır ve değeri, biçimi ve sorunun ne olduğunu taşır; aggrega pull ve aggrega validate --release, :::: verilen bir uri alanı için bunu "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:" şeklinde yazdırır. Denetim varsayılanları dikkate alır: şemanın default: verdiği bir alan atlansa bile sağlanmış sayılır; bu nedenle varsayılanı olan zorunlu bir alan “eksik” denetimine asla takılmaz.
values sütunu geliştiricinin yazma yüzeyidir. Kapalı olarak doğrulanır: şemanın bildirmediği bir özellik olası bir yazım hatası olarak reddedilir. Kendi belgesi içinde birleştirme yapan bir values şeması (yerel bir #/$defs$ref ya da allOf) çözülür ve o tanımsal bağlama göre doğrulanır.
infra sütunu operatörün boyutlandırma yüzeyidir ve yalnızca Component bir schema.infra sütunu bildirdiğinde denetlenir; bu bildirim, bileşenin kabul ettiği sözleşmedir. values sütununun schema.values değerine göre doğrulandığı gibi, tam olarak o bildirime göre ve başka hiçbir şeye göre değil, kapalı olarak doğrulanır: Component’in bildirmediği bir anahtar yazım hatası olarak reddedilir, bildirdiği bir anahtarın türü ve aralığı ise uygulanır. replicas gibi sağlayıcı katmanlı bir anahtarın doğrulanmasını isteyen bir bileşen o anahtarı kendi schema.infra değerinde bildirir; bir sağlayıcının kabul ettiği söz varlığına, yazılan infra yüzeyine katmanlanarak değil, Recipe’sinin valuesMapping alanı aracılığıyla ulaşılır.
Denetim, Release’in yerleştirdiği her bileşenin boyutlandırmasını ölçer ve hiç infra: bloğu yazmayan bir girdi de ölçülür: bulunmayan bir blok boş bir bloktur; bu nedenle default: taşımayan bir required: anahtarı eksik olarak bildirilir; böyle bir anahtarın yakalamak için var olduğu durum da budur. Bir bileşeni yerleştirmenin her iki yolu da sayılır. Onu bir sınırın components altında adlandırmak onu yerleştirir; onu katan alt modülü aggregates altında yönlendirmek de öyle. Bir yönlendirme girdisi, herhangi biri hakkında bir şey söylemeden bileşenleri yerleştirir; bu nedenle bu şekilde yerleştirilen bir bileşen boş bir boyutlandırma bloğuyla başlar ve türündeki varsayılanı olmayan bir required: anahtarı eksik olarak bildirilir. Release’in iki yoldan hiçbiriyle yerleştirmediği bir bileşen bu sözleşmeye göre hiç ölçülmez. Onun farklı bir hatası vardır ve derleme bunun yerine o hatayı bildirir: hiçbir sınıra yerleştirilmemiş bir bileşen; onu yerleştirmenin iki yolu da adlandırılır.
Sözleşme bir bileşeni nerede yazılmış olursa olsun bağlar: bir alt modülün kattığı bileşen, Release’in kendi Aggregate’inin bildirdiği bir bileşenle tam olarak aynı şekilde ölçülür. Bir bileşenin ne kadar derinde iç içe olduğu, türünün hangi kısıtlamalarının uygulanacağını değiştirmez.
Feature eklemeleri de aynı şekilde, eklenen Feature’ın bildirilen schema.values / schema.infra şemasına göre doğrulanır. Eklemeler tek bir yüzeyi paylaşır; bu nedenle bir kimlik bilgisi Feature’ı — feature.aggrega.ai/kind: secret etiketini taşıyan bir Feature — diğer tüm eklemeler gibi kendi bildirilen şemasına göre ölçülür. Denetlenen değer, ekleme değerleri kapsamlar (component, alt sistem, sınır ve component’e özgü) boyunca aktarıldıktan sonraki etkin birleştirilmiş sonuçtur; bu nedenle bir kapsamda geçerli biçimde verilen ancak daha özel bir kapsamda geçersiz bir değerle geçersiz kılınan bir değer, parçada değil birleştirilmiş sonuçta yakalanır. Türü hiçbir şema bildirmeyen bir ekleme doğrulanmaz; ekleme infra’sı, eklemenin kendi schema.infra şemasına göre doğrulanır (bir ekleme bir kaplamadır ve provider birleşimi taşımaz).
Bir ekin bulgusu, başarısız olan sütunu yazan belgede raporlanır; o belgenin adı altında raporlanır ve yazarına yazılır. Ekin values değerleri, onları yazan Aggregate bloğunda — bileşeni kapsayan bir alt sistem bloğundan önce, bileşenin kendi features: girdisinde, .spec.components.<component>.features.<attachment>.values.<field> konumunda — bir geliştirici hatası olarak raporlanır. Ekin infra değeri, onu yazan Release bloğunda — bileşeni adlandıran sınırın altında, Release’in bileşen için yazdığı girdide, sınırın kendi features: bloğundan önce — bir operatör hatası olarak raporlanır. Sahibi olan belgenin yazmadığı bir sütun, ekin kendisinin yazıldığı yerde, yani type değerinin adlandırıldığı yerde raporlanır. Dolayısıyla yalnızca Release’in oluşturduğu ve hiç values taşımayan bir ek, Feature’ının values tarafından zorunlu tutulan bir alanı Release’in girdisinde ve bir operatör hatası olarak, Release’in tuttuğu bir yolda raporlar — bileşenin girdisinde ya da sınırın altındaki her bileşen için oluşturduğu bir ekte sınırın features: bloğunda:
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))
Aynı ekleme Aggregate’te component üzerine yazıldığında, Aggregate’in adıyla .spec.components.app.features.check.values.schema konumunda [DEVELOPER_ERROR E0168] raporlar. Bir düzenleyici her birini onu yazan belgede, o yolun belgenin tuttuğu en derin anahtarında gösterir.
Bir bağlantının taşıdığı ek de aynı biçimde ölçülür ve başarısız olan sütunu yazan belgenin bağlantı girdisinde raporlanır; ekin yer almadığı bileşenin kendi features: bloğunda raporlanmaz. Ekin values değerleri Aggregate’in bağlantı girdisinde, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> konumunda — bir alt modülün katkıda bulunduğu bir bileşen için alt modülün kendi belgesinde — raporlanır; infra değeri ise Release’in o bağlantı için yazdığı girdide, Release’in sınırları adlandırdığı durumlarda bileşeni adlandıran sınırın altında raporlanır. Yalnızca Release’in oluşturduğu bir ek, her iki sütun için de Release’in girdisinde raporlanır: böyle bir ek hiç values taşımaz, dolayısıyla values değerleri bir alanı zorunlu tutan bir Feature, o alanı operatörün yazdığı girdide eksik olarak raporlar.
Kenar başına bağlantı yapılandırması da soketin kenar başına sözleşmesine karşı aynı biçimde doğrulanır: bir kenarın geliştirici tarafından yazılan values değerleri soketin valueSchema şemasına, bir kenarın operatör tarafından (bir Release’ten) yazılan infra değeri ise soketin infraSchema şemasına karşı doğrulanır. Bir sütun için kenar başına şema bildirmeyen bir soket, o sütun için doğrulanmış yapılandırma kabul etmez (bildirilmemesi = sözleşme yok, denetlenecek bir şey yok). Tanılama, kenarı tüketici, soket ve takma adla adlandırır. Release’in kendi Aggregate’inin bildirdiği bir bileşende, operatörün infra değeri, Release’in bağlantılarından biri için yazdığı her girdi için ölçülür — hiç infra taşımayan bir girdi de dahil; varsayılanı olmayan bir required: anahtarı bu şekilde eksik olarak raporlanır — ve Release’teki o girdide, Release’in sınırları adlandırdığı durumlarda bileşeni adlandıran sınırın altında, yani operatörün onu düzenlediği yerde raporlanır; geliştiricinin values değerleri ise Aggregate’teki bağlantı girdisinde raporlanır.
sensitive: true olarak bildirilen bir yaprağın kısıt hatası gizlenir. Hata metni sorunlu değeri alıntılar ve bir derleme tanılamasını derlemeyi izleyen herkes okur; bu nedenle duyarlı olarak bildirilmiş bir yaprakta — ya da duyarlı olarak bildirilmiş bir nesnenin içindeki herhangi bir yerde — aşağıdaki <constraint failure> yerine <redacted> yazılır. Aynısı, altında duyarlı olarak bildirilmiş bir yaprak bulunan bir konum için de geçerlidir, sütunun kendisi dahil: başka anahtar sözcüklerin yanına yazılmış bir $ref yazıldığı yerde bütün olarak denetlenir; bu nedenle adlandırdığı tanımın içindeki bir hata o konumda raporlanır ve aksi halde yaprağın değerini alıntılardı. Varlık, alan yolu, sütun ve sözleşme adı yine de belirtilir; bu nedenle tanılama size hatanın nerede olduğunu yine söyler; yalnızca değeri yeniden üretecek metin çıkarılır. Duyarlılık sütun başına okunur; bu nedenle values ve infra içinde aynı şekilde adlandırılan bir yaprak yalnızca onu bildiren sütunda gizlenir.
Üretilen ileti:
authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (yazılan sütun bildirilen şemasına uymuyor)
authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (yazılan sütun bildirilen şemasına uymuyor)
authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (yazılan sütun bildirilen şemasına uymuyor: values sütunu Feature şemasına uymuyor)
authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (yazılan sütun bildirilen şemasına uymuyor: infra sütunu Feature şemasına uymuyor)
authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (yazılan sütun bildirilen şemasına uymuyor: values sütunu Feature şemasına uymuyor)
authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (yazılan sütun bildirilen şemasına uymuyor)
authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (yazılan sütun bildirilen şemasına uymuyor: values sütunu Feature şemasına uymuyor)
authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (yazılan sütun bildirilen şemasına uymuyor: values sütunu Feature şemasına uymuyor)
authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (yazılan sütun bildirilen şemasına uymuyor)
Nasıl düzeltilir: sorunlu değeri bildirilen şemayı karşılayacak şekilde düzeltin ya da — değer meşruysa — onu bildirmek için bildiren şemayı (Component’in schema.values/schema.infra şemasını veya eklenen Feature’ınkini) genişletin. Her sütunun beklediği tam türleri, aralıkları, varsayılanları ve zorunlu alanları görmek için bir Component’in bildirilen şemasını aggrega inspect <component-type> ile inceleyin.
Bildirilen bir şema sözleşmesi şema olarak okunamıyor
Bir Component veya Feature, doğrulama için hiçbir şey üretmeyen bir şema sözleşmesi bildirir; bu nedenle kapsadığı yapılandırma hiçbir şeye karşı ölçülmez. Hatayı üç sözleşme taşıyabilir ve her biri kendi alanında yazılır: varlığın kendi spec.schema alanı ve bir bağımlılık soketinin bildirdiği iki kenar başına sözleşme — bağlantının geliştirici tarafı için valueSchema, operatör tarafı için infraSchema. Bu sözleşmelerin başvurabildiği bir SchemaLibrary girdisi de aşağıdaki hatalardan üçüncüsünü taşıyabilir; bu durumun nasıl raporlandığı aşağıda açıklanmıştır.
Bu durdurmaya üç hata yol açar ve sözleşme düzgün göründüğü için bunlardan ikisi kolayca gözden kaçar. Bir soket sözleşmesi JSON Schema 2020-12’ye hiç derlenemeyebilir — en yaygın neden yanlış yazılmış bir anahtar sözcüktür; bir varlığın derlenemeyen kendi spec.schema alanı ise bunun yerine derlemesinin karşılaştığı kompakt biçim koşulu altında raporlanır (bilinmeyen bir anahtar sözcük için E0120, türünün kabul etmediği bir kısıt için E0116). Ya da sorunsuz derlenip yine de hiçbir doğrulayıcı oluşturmayabilir: gövde kompakt biçim olarak okunabilir ancak hiçbir şeyin doğrulama yapabileceği bir şema değildir; örneğin bir özelliğin şemasının yer alması gereken yerde çıplak bir skaler (items: nonsense). Ya da diğer her açıdan iyi biçimli olup desteklenen kümenin dışında bir biçim adlandırabilir — format: password veya format: emial gibi bir yazım hatası —; bu, alana herhangi bir değer ulaşsın ya da ulaşmasın, hiçbir şeyi denetlemeyen bir kısıt olarak okunmak yerine reddedilir; bir format alanının alabileceği adlar Adlandırılmış biçimlar altında listelenmiştir. Üçü de tek bir koşuldur, çünkü çözüm aynıdır ve herhangi birinin atlanması aynı sonucu doğurur.
Hiçbir sözleşme bildirmemek ile okunamayan bir sözleşme bildirmek farklı durumlardır ve derleme bunları farklı ele alır. Hiçbir şey bildirmeyen bir alan atlanır: sütun başına ve kenar başına uygunluk isteğe bağlıdır, dolayısıyla iki sütunu da kısıtlamayan bir soket olağan bir yazımdır ve tanılama üretmez. Okunamayan bir şey bildiren alan ise reddedilir. Onu atlamak, derleme başarı bildirirken kapsadığı her yükü doğrulanmamış bırakırdı — durduğunu söyleyecek hiçbir şey olmadan çalışmayı bırakmış bir denetim. Bu yüzden ikisini birbirinden ayıran şey retdir: sessizlik denetlenecek bir şey olmadığı anlamına gelir, durdurma ise bir şey olduğu ve okunamadığı anlamına gelir.
Ret, yapılandırmayı yazan belgeyi değil, sözleşmeyi bildiren varlığı adlandırır, çünkü düzeltme oraya yapılır. Sözleşmesi okunamayan bir bileşen türü verilen bir Aggregate yazarının kendi dosyasında değiştireceği bir şey yoktur. Ret, katalog okunurken ortaya çıkar; bu sırada bildiren varlık, sütun, yazılan alan ve kaynak satırı bilinir — bu nedenle aynı hata, ona bir derlemeden, aggrega validate komutundan veya aggrega mcp aracının sunduğu derleme aracından ulaşsanız da aynı biçimde raporlanır. Varlığın $import: aracılığıyla okuduğu bir sözleşme — spec.schema alanının tamamı, onun bir sütunu ya da bir soketin sözleşmesi — içe aktarılan dosyada raporlanır: konum, o dosyayı ve parçanın yazıldığı satırı belirtirken ileti yine sözleşmeyi bildiren varlığı ve alanı adlandırır. Bir varlığın kendi spec.schema alanının karşılaştığı compact-form durdurmaları da aynı şekilde konumlandırılır.
Desteklenen kümenin dışında bir biçim adlandıran bir SchemaLibrary girdisi, kütüphanesi okunurken bu durdurmaya ulaşır; ret kütüphaneyi ve girdiyi adlandırır ve kütüphane dosyasındaki girdiyi gösterir. Kataloğun tamamı üzerinde çalışan aggrega validate her kütüphaneyi okur; bu yüzden herhangi bir şema girdiye başvursun ya da başvurmasın girdiyi raporlar; bağımlılık çözümlemesi kütüphaneye hiç ulaşmayan bir Release ise onu okumaz. Şemaları girdiye bir $ref: üzerinden ulaşan bir Release de reddedilir, ancak ret biçimi adlandırmaz: aggrega pull kütüphaneyi katalogda bulunamadı olarak (E0114), aggrega validate --release ise başvurunun hedefini bulunamadı olarak (E0121) raporlar. Girdiyi ve hatalı adı görmek için katalog üzerinde aggrega validate çalıştırın.
İleti, hatayı onunla karşılaşan aracın raporladığı biçimde taşır: bir derleme hatası için sözleşme içindeki anahtar, kaynak satırı ve hatalı anahtar sözcük; doğrulayıcı oluşturmayan bir gövde için doğrulayıcının reddettiği konum; desteklenen kümenin dışındaki bir biçim adı için alan, format anahtar sözcüğü, yazıldığı biçimiyle ad ve desteklenen her ad. Bir soket sözleşmesindeki, SchemaLibrary girdisi yüklenen kapanışta bulunmayan belgeler arası bir $ref:, aggrega validate varlığı veya Release’i denetlediğinde aynı durdurmaya ulaşır; bir varlığın kendi spec.schema alanında ise yukarıdaki “A $ref: is not written in a form the compiler can resolve (Başvuru, derleyicinin çözümleyebileceği bir biçimde yazılmamış)” bölümünün açıkladığı gibi raporlanır. aggrega pull, bir Release’in ihtiyaç duyduğu kütüphaneler için her iki yeri de okur; bu nedenle katalogda bulunmayan bir kütüphane, iki yerden hangisi ona başvurursa başvursun, “A reference names no entity the catalog holds (Başvuru, kataloğun tutmadığı bir varlığı adlandırıyor)” (E0114) bölümünün açıkladığı gibi çekmeyi daha erken durdurur — kataloğun tuttuğu bir kütüphane ise her ikisi için de kilit dosyasında sabitlenir.
Okunamayan bir kısıtın yanındaki iyi biçimli bir kısıt uygulanmaz. Bir sözleşme tek bir belge olarak okunur, bu yüzden okunamayan tek bir parça yanında bildirilen her kısıtı devre dışı bırakır. Durdurmanın, maliyetine yol açtığı kısıtlardan daha değerli olmasının nedeni budur: alternatifi, uygulanıyor gibi görünen, uygulanıyor gibi okunan ve hiçbir şeyi uygulamayan bir sözleşmedir.
Verilen ileti, önce varlığı sürümüyle ve sözleşmeyi bildiren alanla, ardından o sözleşmenin kısıtladığı sütunu, ardından hatayı adlandırır — burada yanlış yazılmış bir anahtar sözcük taşıyan bir soket sözleşmesi:
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. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (bildirilen şema sözleşmesi kullanılabilir bir şemaya derlenemedi, bu yüzden ona göre hiçbir şey doğrulanmadı: sözleşmeyi bildirildiği yerde düzeltin veya kapsadığı yapılandırma doğrulama gerektirmiyorsa kaldırın. Component: spec.usesSchema içindeki soketin valueSchema alanı, hiçbir doğrulayıcının oluşturulamayacağı bir şema bildiriyor, bu yüzden kısıtladığı değerler ölçülmeden kalırdı: belirtilen anahtar ve satırdaki compactform (belirtilen anahtar sözcük): bilinmeyen anahtar sözcük)
ve bir Component’in values sütununda desteklenen kümenin dışında bir biçim adı:
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. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date)
Bir Feature Feature "<name>:<version>" olarak, bir soketin sözleşmesi spec.usesSchema.<socket>.infraSchema gibi kendi alanıyla, sütun ise sözleşmenin kısıtladığı sütunla — values, infra veya provides — adlandırılır. Varlığın kendi dosyası verilen aggrega validate, varlığı sürümü olmadan adlandırır. Bir SchemaLibrary girdisi kütüphanesi ve girdisiyle adlandırılır:
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. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date)
Nasıl düzeltilir: tanılamanın adlandırdığı alanı açın ve raporlanan anahtar ile satırdaki parçayı düzeltin — çoğunlukla vocabulary/compact-form-authoring.md içindeki anahtar sözcük dağarcığına göre denetlenecek yanlış yazılmış bir anahtar sözcük ya da iç içe bir şemanın yer alması gereken yere yazılmış bir değerdir. Hata desteklenmeyen bir biçimi adlandırıyorsa adlandırılmış biçimlerden birini yazın veya format: alanını kaldırın; gizli malzeme taşıyan bir alan bunun yerine sensitive: true bildirir, çünkü password bir biçim değildir. Bir SchemaLibrary girdisi için düzeltme, tanılamanın adlandırdığı kütüphane dosyasında yapılır. Hata belgeler arası bir başvuruyu adlandırıyorsa SchemaLibrary girdisinin var olduğunu ve kütüphaneye Release’in bağımlılık kapanışından ulaşılabildiğini doğrulayın. O alanın kapsadığı yapılandırma gerçekten doğrulama gerektirmiyorsa, hiçbir şeyin okuyamadığı bir sözleşme bırakmak yerine alanı kaldırın.
Recipe source: boş bir dizedir
Bir Recipe source: "" bildirir: boş bir dize. Bir Recipe’in source: alanı iki yazım kipi arasında seçim yapar: harici bir yapıtın olmadığı ve çıktının tamamen Recipe’in diğer girdi türlerinden üretildiği kaynaksız kip ve source: alanının işlenecek harici bir chart, modül veya dosyayı adlandırdığı kaynaklı kip. Alanı atlamak birincisini, boş olmayan bir değer ikincisini seçer; boş bir dize ise hiçbirini seçmez. Bu nedenle anlamı olan bir değer değil, bir belirsizliktir. Değeri null olarak yazılan bir source: alanı, alanı atlamakla aynıdır.
Derleyici iki okumadan birini sizin yerinize seçmek yerine Recipe reddedilir. Boş bir source: yazmanın en yaygın yolu, bir URI’yi silip anahtarı geride bırakmaktır: kaynaklı kip amaçlanmıştır ve boş dizeyi kaynaksız olarak kabul etmek, bileşeni yapıt olmadan gönderir ve iki okumadan hangisini seçtiğini hiçbir zaman söylemez.
Bu kural, değer tam olarak yazdığınız gibi okunarak Recipe yüklendiğinde denetlenir; bu nedenle Recipe’i yükleyen her komut, herhangi bir şey boş değeri kullanmaya çalışmadan önce bu koşulu adlandırır. Recipe dosyası üzerinde aggrega validate onu reddeder; aggrega pull, bir derleme, aggrega validate --release ve aggrega mcp komutunun sunduğu derleme aracı ise bunu, Recipe’e ulaşan bir Release için, bu yüzden artık çözümlenemeyen Recipe başvurusundan önce bildirir. Bu nedenle bir pull, boş başvuruyu source türünü belirleyemediği bir başvuru olarak bildirmek yerine bu koşulu adlandırır. Kural, bir source’un bildirilip bildirilmediğini okuyan kurallardan önce denetlenir; bu nedenle source: alanı boş olan bir Recipe’e, üzerine bindirecek hiçbir şeyi olmayan bir valuesMapping ya da eksik bir girdi türü hakkında değil, source: hakkında bilgi verilir.
Üretilen ileti, Recipe’i bağlayan bir bileşende değil, boş source: alanının yazıldığı Recipe dosyasında ve onun içindeki anahtarda — .spec.source — konumlandırılır; çünkü girdi, onu bağlayan her bileşen tarafından paylaşılır:
recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (recipe source boş bir dizedir; bu ne kaynaksız kipi ne de kaynaklı kipi adlandırır. kaynaksız kip için source alanını atlayın veya kaynaklı kip için boş olmayan bir yol ya da URI adlandırın)
Derleme, satırı bu koşulun kısa kodu E0251 ile birlikte bir CATALOG_ERROR etiketi altında ve yanında Recipe dosyasıyla yazdırır.
Nasıl düzeltilir: Recipe kaynaksızsa source: alanını tamamen atlayın (veya null olarak ayarlayın); Recipe kaynaklıysa boş olmayan bir yol / URI / yapılandırılmış kaynak nesnesi sağlayın.
No Recipe is mapped for a component or feature instance (Bir bileşen veya özellik örneği için hiçbir Recipe eşlenmemiş)
Bir örneğin türünün, kataloğun tuttuğu bir Recipe’e çözümlenen Manifest eşlemesi yoktur. Recipe seçimi yalnızca eşlemeye dayalıdır: derleyici hiçbir zaman spec.implements: alanını okuyup adaylar arasından seçim yaparak bir Recipe seçmez; bu nedenle eşlenmemiş bir tür, onu kaç Recipe uygularsa uygulasın durur. implements seçime bilgi sağlar; seçimi yazar yapar; Manifest onu kaydeder.
Aynı koşul, var olan ancak hiçbir yere götürmeyen bir eşlemeyi de kapsar: kabul edilen bir başvuru biçimindeki, kataloğun tutmadığı bir Recipe’i adlandıran bir değer; buna, değerin sabitlediğinden farklı bir sürümde bulunan bir Recipe ve yalın adını iki yeteneğin birden sunduğu bir Recipe de dahildir. Bunların hiçbiri, yazarın seçtiği söylenebilecek bir Recipe’e çözümlenmez. Biçimini hiçbir başvurunun ifade edemediği bir eşleme değeri, yukarıda “Manifest mapping value is not a shape a recipe reference accepts (Manifest eşleme değeri, bir recipe başvurusunun kabul ettiği bir biçimde değil)” altında ayrıca bildirilir; böylece bir varlığın bulunmadığı iddiası yalnızca çözümlenebilecek bir başvuru için ileri sürülür.
Bir bileşen örneği için üretilen iletiler. Bir eşleme var olduğunda ve bulunmayan bir şeyi adlandırdığında:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names
Hiçbir eşleme olmadığında ve türü uygulayan Recipes mevcut olduğunda, bunlar sabitlenecek adaylar olarak listelenir:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest
Türü hiçbir şey uygulamadığında ise listelenecek bir şey yoktur:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it
Hiçbir katalog dizini adlandırmayan bir çalışma alanında aranan Recipes yalnızca lockfile’ın sabitledikleridir: bir kayıt defterindekiler listelenmez ve tür için hiçbirini eşlemeyen bir Manifest hiçbirini sabitlemez. Orada, sabitlenmiş hiçbir Recipe türü uygulamadığında, yokluk iddiası katalog için değil sabitlenenler için yapılır ve ileti bunu belirtir:
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (bileşen/özellik örneği için hiçbir tarif çözümlenmedi: türü için Manifest’e açık bir eşleme ekleyin (Manifest, belirtilen konumda, belirtilen örnek ve tür için). lockfile’ın sabitlediği hiçbir tarif bu türü uygulamıyor; katalog dizini olmadığından aranan tarifler yalnızca lockfile’ın sabitledikleridir, bir kayıt defterininkiler değil; Manifest’te bir kayıt defterinin yayımladığı birini sabitleyin ya da bir tane yazın, ardından türü ona eşleyin)
Aggregate’in sürüm belirtmeden yazdığı bir türe, derlemenin onu derlediği sürümü (kataloğun tuttuğu o Component’in en yüksek sürümü) uygulayan Recipes sunulur. Katalog o Component’i 1.0.0 sürümünde tutarken core/datastore/postgres türündeki bir örneğe, spec.implements: core/datastore/postgres:1.0.0 bildiren her Recipe’in yanı sıra sürümsüz türü veya 1.0.0 sürümünü kabul eden bir şapka aralığını bildiren her Recipe de sunulur. Kataloğun hiçbir Component’ini tutmadığı bir türe yalnızca o sürümsüz türün kendisini bildiren Recipes sunulur.
Bir özellik örneği bu durumları kendine özgü bir biçimde, her birini koşulun cümlesinden sonra bildirir. Aggregate’in sürüm belirtmeden yazdığı bir özellik türü, bir bileşen türü gibi, derlemenin onu derlediği sürümde — kataloğun barındırdığı o Feature’ın en yüksek sürümünde — eşleştirilir ve <type>:<version> değerini adlandıran bir ileti, türü o sürümde, yani katalogda aranan şeyi adlandırır. Bir eklemenin bileşeninin eşlendiği Recipe biliniyorsa FeatureRecipes, o Recipe’in bağlandığı yeteneğe göre ayırt edilir: bileşenin yeteneğine bağlananlar önce sunulur ve başka bir yeteneğe bağlanan bir FeatureRecipe de bileşenin çıktısının içine değil, onun yanında kendi çıktısı olarak yine işlenir; bu nedenle hiçbiri bileşenin yeteneğine bağlanmıyorsa bunun yerine onlar sunulur. Hiçbir yere çıkmayan bir eşleme feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog şeklinde okunur. FeatureRecipes türü bileşenin yeteneği için uyguluyorsa yalnızca onlar listelenir: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. Türü yalnızca başka yetenekler için uyguluyorlarsa: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. Türü hiçbiri uygulamıyorsa: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. Yetenek bilinmediğinde ise — bileşenin kendi eşlemesi hiçbir Recipe’e çözümlenmez ve bu ayrıca bildirilir ya da ekleme, bileşenleri birkaç yetenek üzerinden işlenebilen bir sınır üzerine yazılmıştır — her uygulayıcı listelenir: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. Hiçbir katalog dizini adlandırmayan bir çalışma alanında aranan FeatureRecipes yalnızca lockfile’ın sabitledikleridir: bir kayıt defterindekiler listelenmez ve tür için hiçbirini eşlemeyen bir Manifest hiçbirini sabitlemez. Orada yokluk iddiaları katalog için değil sabitlenenler için yapılır ve iletiler bunu belirtir. Türü hiçbiri uygulamıyorsa: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — yetenek bilinmediğinde ise ileti hiçbir yetenek adlandırmaz ve pin one a registry publishes in the Manifest, or write one, then map the type to it ile biter. Sabitlenmiş FeatureRecipes türü yalnızca başka yetenekler için uyguluyorsa, o durumun iletisi no feature recipe in the catalog implements yerine no feature recipe the lockfile pins implements olarak okunur ve yetenekten sonra aynı yan cümle gelir.
Nasıl düzeltilir: iletinin istediği eşlemeyi Manifest’te spec.mappings.components.type altına, bileşen türünü anahtar ve Recipe’i değer olarak ekleyin. İleti adayları listelediğinde bunlardan birini seçin: bu liste, türü derlemenin onu çözümlediği sürümde uyguladığını bildiren Recipes’in tam kendisidir. İleti katalogda olmayan bir Recipe’i adlandırdığında, ya değeri düzeltin ya da Recipe’i derlemenin okuduğu bir katalog dizinine ekleyin; değerdeki bir sürüm, kataloğun tuttuğu bir sürümle eşleşmelidir. Türü hiçbir şey uygulamadığında eksik parça Recipe’in kendisidir. İleti, aranan tariflerin ya da özellik tariflerinin yalnızca lockfile’ın sabitledikleri olduğunu söylediğinde, çalışma alanı hiçbir katalog dizini okumaz; bu nedenle bir kayıt defteri, türü uygulayan bir Recipe ya da FeatureRecipe yayımlıyor olabilir: pull’un onu getirip sabitlemesini sağlayan, türü Manifest’te ona eşlemektir.
A Manifest name mapping names nothing in the build (Bir Manifest name eşlemesi derlemedeki hiçbir şeyi adlandırmıyor)
spec.mappings.components.name veya spec.mappings.features.name altındaki bir anahtar, derlemenin tuttuğu hiçbir bileşen örneğini ya da eki adlandırmıyor. name katmanı, gerçekleştirilen şeyin tam adıyla eşleştirilir: bir components.name anahtarı, Aggregate’in yazdığı biçimiyle bir bileşen örneğinin adıyla; bir features.name anahtarı ise bir ekin kendi adıyla — bir bileşenin features: bloğunda altında yazıldığı anahtarla ya da bir bağlantı üzerinde yazılmış bir ek için <alias>.<slot> ile — eşleştirilir; ekin üzerinde bulunduğu bileşenin adıyla asla eşleştirilmez. Hiçbir şeyi adlandırmayan bir anahtara hiçbir zaman başvurulmazdı: hedeflediği her örnek type katmanı üzerinden çözümlenir ve derleme, yok saydığı girdi hakkında tek söz etmeden biterdi. Bu yüzden derleme, herhangi bir şey işlenmeden önce durur.
İleti; Manifest’i, anahtarı ve yazıldığı bölümü, derlemenin gerçekten tuttuğu o türdeki adları — girdinin Recipe’inin veya FeatureRecipe’inin uyguladığı tür biliniyorsa ve derleme o türden birini tutuyorsa o türe daraltılmış olarak — ve anlaşılabildiğinde muhtemelen kastettiğiniz adı belirtir: bir bileşenin adı olan bir features.name anahtarı için o bileşenin taşıdığı o türdeki ekler; bir ekin adı olan bir components.name anahtarı için onu taşıyan bileşen; diğer durumlarda ise bir düzenleme uzaklıktaki bir ad.
Ekin üzerinde bulunduğu bileşenin adı olarak yazılmış bir features.name anahtarı için verilen ileti:
a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (bir Manifest name eşlemesinin anahtarı bu derlemedeki hiçbir bileşen örneğini ya da eki adlandırmıyor, bu yüzden girdi hiçbir şeyi bağlamıyor: Manifest’in mappings.features.name altındaki anahtarı: bu derlemede bu adı taşıyan bir ek yok; bir features.name anahtarı bir eki kendi adıyla — bir bileşenin features bloğunda altında yazıldığı anahtarla ya da bir bağlantı üzerinde yazılmış olan için takma ad ve yuvayla — adlandırır, eklendiği bileşeni asla adlandırmaz; bu derlemedeki belirtilen türdeki ekler listelenmiştir; belirtilen ad bir bileşendir ve bir features.name anahtarı eklendiği bileşeni değil eki adlandırır — belirtilen eki mi kastettiniz?)
Ve bir örneğin adından bir düzenleme uzaklıktaki bir components.name anahtarı için:
a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (bir Manifest name eşlemesinin anahtarı bu derlemedeki hiçbir bileşen örneğini ya da eki adlandırmıyor, bu yüzden girdi hiçbir şeyi bağlamıyor: Manifest’in mappings.components.name altındaki anahtarı: bu derlemede bu adı taşıyan bir bileşen örneği yok; bir components.name anahtarı bir bileşen örneğini tam olarak Aggregate’in yazdığı biçimde adlandırır; bu derlemedeki belirtilen türdeki bileşen örnekleri listelenmiştir; belirtilen örneği mi kastettiniz?)
Hiçbir şeyi adlandırmayan her anahtar, Manifest’in onları yazdığı sırayla tek bir derlemede raporlanır.
Nasıl düzeltilir: anahtarı iletinin önerdiği ada ya da listelediği adlardan birine yeniden adlandırın — bir ek için bu, bileşeninin adı değil, ekin altında yazıldığı addır. Girdi artık istenmiyorsa kaldırın; o türdeki örnekler bu durumda type katmanı üzerinden çözümlenir.
A Manifest maps two version-distinct keys onto one type (Bir Manifest, sürümü farklı iki anahtarı tek bir türe eşliyor)
Bir tür araması birden fazla Manifest eşleme anahtarıyla eşleşti. Tür anahtarları sürüme toleranslı biçimde eşleştirilir; bu nedenle ayrı eşleme anahtarları olarak yazılmış core/api-server, core/api-server:1.0.0 ve core/api-server:2.0.0 hepsi aynı temel tür için yanıt verir. Bunlardan ikisine ulaşan bir aramanın seçim yapacağı iki Recipe vardır ve birini tercih etmek için hiçbir kural yoktur.
Derleme, ilk okuduğu anahtarı çözümlemek yerine durur. Birini seçmek, işlenen çıktıyı eşlemenin dolaşıldığı sıraya bağımlı kılar; bayt düzeyinde aynı çıktı da tam olarak bunu dışlar.
Üretilen ileti:
manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (manifest, sürümü farklı birden çok anahtarı aynı temel türe eşliyor; türden recipe’e arama belirsiz: tür sürümü farklı anahtarlarla eşleşiyor; yazılan türün sürümünü sabitleyin veya yinelenen eşleme anahtarlarını kaldırın)
Nasıl düzeltilir: iki yön vardır ve ileti ikisini de adlandırır. Yinelenen eşleme anahtarlarını kaldırın ve tür için yanıt vermesi gerekeni tutun; fazladan anahtarlar bir sürüm artırımından kalmışsa doğru olan budur. Ya da sürümü yazım tarafında sabitleyin; böylece bileşenin bildirdiği tür tam olarak kastettiğiniz anahtarı adlandırır. Birden çok anahtar bilinçliyse ve farklı bileşenler gerçekten farklı Recipes istiyorsa doğru olan budur.
Two catalog entities in one directory share an identity (Bir dizindeki iki katalog varlığı aynı kimliği paylaşıyor)
Aynı katalog dizininden yüklenen aynı türden iki varlık aynı kimliği taşıyor. Kimlik, bir başvurunun adlandırdığı şeydir; bu nedenle tek bir kimliği sahiplenen iki dosya, o kimliğe yapılan her başvuruyu iki yanıtla bırakır.
Bir dizin içinde bu durum derlemeyi durdurur; dizinler arasında durdurmaz. İki farklı katalog dizininde bulunan aynı kimlik, ilk gelenin kazandığı bir gölgeleme olarak çözümlenir (önce listelenen dizin kazanır); yerel bir dizinin yayımlanmış bir varlığı bilinçli olarak geçersiz kılmasını sağlayan da budur. Yalnızca tek bir dizinin içindeki çakışma, onu kasıtlı kılacak hiçbir yorumu olmayan bir yazım hatasıdır.
Kural, dizinlenen her tür için aynıdır: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary ve Aggregate. Durdurma ikinci dosyada konumlanır ve çakışan türü ve kimliği adlandırır.
Üretilen ileti:
duplicate entity identity within a single catalog directory (Component identity "<identity>") (tek bir katalog dizini içinde yinelenen varlık kimliği)
Component yerine türün kendi sözcüğüyle: recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity vb.
Nasıl düzeltilir: iki varlıktan birini yeniden adlandırın ya da kendine ait bir dizine taşıyın. Bir Recipe veya FeatureRecipe için kimlik, sağlayıcı kapsamını ve sürümü içerir; bu nedenle yalnızca sürümde farklılaşan iki dosya çakışmaz. Orada gerçek bir çakışma, aynı sürümün iki kez yayımlandığı anlamına gelir. Yeni bir varlığa başlamak için bir varlık dosyasını kopyalayıp metadata.name değerini değiştirmeyi unutmak olağan nedendir.
A file the operation reads leads through a link out of the directory it must stay inside (İşlemin okuduğu bir dosya, bir bağlantı aracılığıyla içinde kalması gereken dizinin dışına çıkıyor)
İki yer, her seferinde tek bir dosya yerine bir bütün olarak okunur: altındaki her belgeden ada göre bir aramanın yanıt verebileceği bir katalog dizini ve bir Release’i barındıran dizin; bu dizindeki Aggregates ve Manifests, onları kimlikleriyle adlandıran bir Release’in çözümlendiği yerdir. Bu dosyalar arasındaki bir sembolik bağlantı makinedeki herhangi bir yere yönlendirebilir; bu nedenle bu türden her dizinin, okumalarının içinde kalması gereken bir dizini vardır ve bunun dışına çıkan bir bağlantı okunmaz. Çalışma alanı sınırı, burada uygulanan kuralı ve kapsadığı diğer yolları açıklar.
Bunun hangi dizin olduğu, okunan dizinin nerede bulunduğuna bağlıdır:
Çalışma alanı, içindeki bir katalog dizini ya da bir Release’in dizini için. Bu, çalışma alanının uzlaşımsal catalog dizini için de, kimse onu adlandırmadığında, yani yalnızca orada olduğu için okunduğunda geçerlidir: bu durumda dizin çalışma alanının kendisine aittir, bu nedenle kendisi çalışma alanının dışına çıkan bir bağlantı olan bir catalog okunmaz.
Sizin adlandırdığınız ve çalışma alanının dışında bulunan bir dizin, altında bulunanlar için: --catalog ile verdiğiniz ya da çalışma alanı yapılandırmasının (çalışma alanı için veya tek bir Release için) catalog_dirs altında listelediği bir katalog dizini ve sizin ya da yapılandırmanın adlandırdığı, çalışma alanının dışında bulunan bir Release’in dizini. Dizinin kendisi adlandırdığınız şekliyle kullanılır (bağlantı olan bir dizin, gösterdiği yerde okunur) ve altında okunanlar onun içinde kalır. Buna, siz adlandırdığınızda uzlaşımsal catalog dizini de dahildir: catalog_dirs altında listelenen ya da --catalog ile verilen, çalışma alanının dışına çıkan bir bağlantı olan bir catalog, adlandırdığınız diğer her dizin gibi gösterdiği yerde okunur. Bunun yerine gösterdiği yeri herhangi bir yazımla ya da o yerin üstündeki bir dizini adlandırmak da onu adlandırır: adlandırdığınız dizin orada bulunanları zaten okur, bu nedenle o dizin üzerinden bir kez okunur. Yapılandırmada bir dizini adlandırmak, bir çalışma alanının kendi dışında tutulan varlıkları okumasının yoludur.
Değerlendirilen, okumanın bir şey alacağı her girdidir: YAML belgesi gibi adlandırılmış bir dosyaya giden bağlantı ve kendi belgelerini barındırabilecek bir dizine giden bağlantı. Okumanın içinde kalması gereken dizinin içinde bir yere giden bağlantı, taramanın ona rastladığı yerde okunur. Hiçbir katalog okumasının bir şey almadığı bir dosyaya (bir not dosyası, bir chart arşivi) giden bağlantı burada değerlendirilmez ve hiçbir yere gitmeyen bir bağlantının arkasında okunacak bir şey yoktur.
Bir derlemenin bağlı olduğu bir arama, böyle bir bağlantının üzerinden geçmek yerine onda durur. Bağlantının arkasındaki varlık, bir başvurunun adlandırdığı varlık olabilir ve onun üzerinden sessizce geçmek, sonraki bir katalog dizininden aynı ada sahip başka bir varlığın onun yerine çözümlenmesine izin verir. Bu nedenle aggrega build, aggrega pull, aggrega validate, kataloğu okuduğu her yerde aggrega inspect, tek bir Release’in lint işlemi ve düzenleyicinin ve bir asistanın bir Release’i derleyen, önizleyen, grafiğini çıkaran, doğrulayan veya tanımlayan istekleri, herhangi bir şey çözümlenmeden önce bağlantıyı adlandırarak durur. Tüm kataloğun lint işlemi de aynı şekilde durur: kararı, katalog dizinlerinin barındırdığı her belge için geçerlidir; bu nedenle bunlardan biri okunamazken temiz bir katalog bildirmez. Bir Release, Aggregate’ini veya Manifest’ini kimliğiyle adlandırdığında ya da bir Manifest, genişlettiği Manifest’i bu şekilde adlandırdığında Release’in dizini de aynı kurala tabidir ve tarama, bağlantı bir başvurunun adlandırdığı bağlantı olmasa bile Release’in yanındaki belgeler arasındaki bir bağlantıda durur; bunun nedeni, orada bir yinelemenin taramayı durdurma nedeniyle aynıdır: belgelerinden biri okunamazken dizin bir ad için yanıt veremez. İşleme adı verilen Release (ya da kendi başına incelediğiniz bir Manifest) bu belgelerden biri değildir: adlandırıldığı yerde okunmuştur; bu nedenle kendisi dışarı çıkan bir bağlantı olan bir Release işaret ettiği yerde okunur ve adlandırdığı şeyler bağlantının yanında, onu adlandırdığınız dizinde aranır (Bağlantı aracılığıyla adlandırılan bir Release veya Manifest).
Bir listeleme ise böyle bir bağlantının üzerinden geçer ve arkasındaki hiçbir şeyi listelemez. Düzenleyicinin varlık dizini, tamamlamaları ve sunduğu adaylar, dışarı çıkan bir bağlantının temsil ettiği bir varlığı listelemez ve varlık dizini, çalışma alanı içindeki böyle bir bağlantıyı okumadığı bağlantılar arasında adlandırır.
Çalışma alanının yapılandırma dosyaları da aynı şekilde çalışma alanına bağlı tutulur. Çalışma alanı kökünden bir komutun çalıştığı dizine kadar her .aggrega-config.yaml ve bir işlem hattının bunlardan herhangi birinin yanında tuttuğu .aggrega-config-append-ci.yaml, çalışma alanının kendi içeriğidir. Bunlardan çalışma alanının dışına çıkan bir bağlantı olan (ya da dışarı çıkan bir dizin bağlantısı üzerinden ulaşılan) biri okunmaz ve her komut, düzenleyicinin dil sunucusu ve bir asistanın araçları yapılandırmayı her şeyden önce okuduğundan, her biri geri kalanlardan oluşturulmuş bir yapılandırmayla çalışmak yerine orada bağlantıyı adlandırarak durur. Dil sunucusu ve kendi akışları üzerinden konuşan bir asistan sunucusu böyle bir çalışma alanında yine de başlar: Release’lerinin ve varlıklarının listeleri hiçbir şey yapılandırılmadan okunarak yanıt verir ve dosyayı okumadıkları bağlantılar arasında adlandırır; yapılandırmanın belirlediği diğer her istek ise bağlantıyı adlandırarak bu koşulla reddedilir. Bu iletinin adlandırdığı çözüm yapılandırmanın kendisine özgüdür: genel yapılandırma dosyası, nerede tutulursa tutulsun okunan tek yapılandırmadır ve --config ya da AGGREGA_CONFIG ile adlandırılır.
Bir Release’in kilit dosyası da aynı şekilde, yazıldığı yerde olduğu gibi okunduğu yerde de tutulur. Bir Release’in yanındaki kilit dosyası; bir derlemenin, bir çekmenin, bir doğrulamanın, bir lint işleminin, bir incelemenin, aggrega cache prune komutunun ve düzenleyicinin ve bir asistanın isteklerinin çözümlendiği sabitlemeler için okunur ve yazılmasının bağlı tutulduğu dizine bağlı tutulur: çalışma alanı ya da çalışma alanının dışında adlandırılan bir Release için Release’in kendi dizini. Dışarı çıkan bir bağlantı olan kilit dosyası okunmaz ve bunların her biri, makinenin başka bir yerinde tutulan sabitlemelere göre ya da onlar olmadan çözümlemek yerine bağlantıyı adlandırarak durur. Bu iletinin adlandırdığı çözüm kilit dosyasına özgüdür: kilit dosyasının tek bir yeri vardır, o da bir çekmenin onu yazdığı Release’in yanıdır.
Bir varlığın yanında okunan bir dosya da aynı şekilde sınırlanır. İki işlem, bir başvurunun adlandırdığı bir dosyayı değil, bir varlığın kendi belgesinin yanında duran bir dosyayı okur. Bir varlığı sabitlemek ya da yayımlamak, varlığın dizinini başka bir varlığın paylaşıp paylaşmadığını anlamak için o dizindeki diğer her YAML belgesini okur. Bir katalog dizininde yazılmış bir Plugin varlığını yüklemek, yanına konmuş derlenmiş .wasm dosyasını okur. Her biri, varlığın kendi belgesinin altında okunduğu dizinle sınırlanır: çalışma alanı, onun dışında adlandırdığınız bir katalog dizini ya da belgesini çalışma alanı dışında adlandırarak sabitlediğiniz veya yayımladığınız bir varlık için o belgenin kendi dizini; bunlardan dışarı çıkan bir bağlantı olan dosya okunmaz. aggrega pin, --dry-run ile ya da onsuz aggrega push, sabitleme yapan bir çekme ve düzenleyicinin ve bir asistanın sabitleme ve yayımlama işlemleri bağlantıyı adlandırarak durur, çünkü okunmadan bırakılan bir belge engel oluşturan varlık olabilir. Plugin’i yükleyen bir derleme ya da çekme de makinenin başka bir yerinde tutulan baytları çalıştırmak ya da Plugin’i başka bir yerde aramak yerine bağlantıyı adlandırarak durur. Bu iletinin adlandırdığı çözüm, bir varlığın yanındaki dosyaya özgüdür: dosyanın kendisini orada tutun.
Çalışma alanının yapıt önbelleği de, yazıldığı yerde olduğu gibi okunduğu yerde de aynı şekilde sınırlanır.artifact_cache_dir altındaki önbellekten okunan her şey (önbelleğe alınmış bir varlık, Plugin ya da kitaplık ve yanındaki manifest, bir kaynak arşivi ve meta verileri, sabitlenmiş bir dış girdi, bir imza paketi, bir kayıt defterinin yerel arama dizini) ve aggrega cache status, aggrega cache prune ile aggrega cache clear komutlarının listelediği her çalışma alanı girdisi, önbelleğe yazmanın sınırlandığı dizinle sınırlanır: önbellek dizininin kendisi; varsayılan .aggrega/cache de, yapılandırmanın çalışma alanı kökünden dışarı çıkarak adlandırdığı bir dizin de. İçindeki, önbellek dizininin dışına çıkan bağlantı olan hiçbir şey (çalışma alanının başka bir yerine de olsa, başka herhangi bir yere de olsa) okunmaz; çalışma alanı kökü içinde yazılmış ve kendisi çalışma alanının dışına çıkan bir bağlantı olan bir önbellek dizininin arkasındaki hiçbir şey de okunmaz: bir derleme, bir çekme, bir doğrulama, bir arama, üç önbellek komutu ve düzenleyicinin ve bir asistanın önbelleği okuyan istekleri bağlantıyı adlandırarak durur. Önbelleğin kaydedilmiş bir özet altında tuttuğu içerik de buna dahildir, çünkü bir özet baytların ne olduğunu söyler, nereden okunabileceklerini değil. Çalışma alanı kökü içinde yazılmış ve çalışma alanının başka bir yerine giden bir bağlantı olan önbellek dizini, gittiği yerde okunur. aggrega inspect komutunun yazdırdığı ve hiçbir şeye karar vermeyen kullanımdan kaldırma bildirimi bunun dışında tutulur. Bir budama ya da temizleme, önbelleğin kendi dizinlerinden önbellek dizininin dışına çıkan bir bağlantı olan birine ya da kendisi çalışma alanının dışına çıkan bir bağlantı olan bir önbellek dizinine rastladığında, bunu herhangi bir şeyi listelemeden önce, olacağı silme işlemi olarak “A path the operation writes leads through a link out of the directory it must stay inside (İşlemin yazdığı bir yol, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor)” altında ele alır. Bu iletinin adlandırdığı çözüm önbelleğe özgüdür: bağlantı kaldırıldığında bir çekme önbelleği yeniden doldurur; başka bir yerde tutulan bir önbellek ise bir bağlantı üzerinden ulaşılmak yerine çalışma alanı köküne göre artifact_cache_dir ile adlandırılır.
Bir kaynağın getirdiği depo kendi çalışma kopyasıyla sınırlanır. Bir çekme (aggrega pull ya da bir Release’in bağımlılıklarını çözen bir derleme veya düzenleyicinin ya da bir asistanın isteği) bir git-repository kaynağını getirdiğinde, depoyu çalışma kopyası olarak çıkarır ve kaynağın adlandırdığı dizini arşivler; çalışma kopyası kendi başına bir dizindir: deponun taşıdığı her bağlantı, module_subdir de dahil, onunla sınırlanır. Depo içindeki bir dosyaya ya da dizine giden bir bağlantı, bağlantının adı altında, gösterdiği şey olarak arşivlenir. Deponun dışına çıkan bir bağlantı (çekmeyi çalıştıran makinedeki herhangi bir dosyayı gösterebilir) okunmaz: çekme, bağlantıyı ve gittiği yeri adlandırarak durur ve hiçbir şey önbelleğe alınmaz. Çalışma kopyası, çekme durduğunda kaldırılan geçici bir dizindir; bu yüzden ileti bağlantıyı depodaki yeriyle (komut satırının ilk satırında ve cümlede chart/secret.txt olarak), içinde kalması gereken dizini ise deponun ve kaynağın adlandırdığı revizyonun adıyla belirtir: which must stay inside the repository <url> at <ref> (commit <commit>) ya da kaynak hiçbir ref adlandırmadığında veya commit’in kendisini adlandırdığında at commit <commit>. Bağlantının gittiği yer, makinenizdeki yeri olarak adlandırılır. Bu iletinin adlandırdığı çözüm depoya özgüdür: bağlantı orada commit edilmiştir, dolayısıyla orada değiştirilir (depo içini gösterecek şekilde ya da dosyanın kendisiyle değiştirilerek) ve kaynak ardından değişikliği taşıyan bir revizyonu adlandırır. Arşivin zaten onun üzerinden okuduğu bir dizine geri dönen bir dizin bağlantısı da çekmeyi durdurur, çünkü temsil ettiği ağacın sonu yoktur; bu ret bu koşul değil, sıradan bir hatadır.
Bir katalog üretiminin okuduğu katmanlar da aynı şekilde sınırlanır.aggrega plugin gen-catalog --from-embedded, kendisine verilen katman dizininin (--overlay ile yazılan, düzenleyicide seçilen ya da bir asistanın adlandırdığı) altındaki her katmanı okur ve her birini o katman dizininin altında okunduğu dizinle sınırlar: içindeki bir katman dizini için çalışma alanı, çalışma alanı dışında adlandırılan bir katman dizini için ise katman dizininin kendisi. Katman dizini adlandırdığınız gibi kullanılır: bağlantı olan bir dizin gösterdiği yerde okunur. Altındaki, sınırlandığı dizinin dışına çıkan bir bağlantı olan bir katman okunmaz; kendi katmanlarını barındırabilecek, dışarı çıkan bir dizin bağlantısı da okunmaz: üretim, katman olmadan üretmek yerine bağlantıyı adlandırarak ve hiçbir şey yazmadan durur. Sınırlandığı dizinin içinde başka bir yere giden bir bağlantı olan katman gösterdiği yerde okunur; içeriye giden bir dizin bağlantısına girilmez. Bu iletinin adlandırdığı çözüm bir katmana özgüdür: katmanın kendisini katman dizininin altında tutun ya da katman dizini olarak her katmanı barındıran bir dizini adlandırın.
İçe aktardığınız bir dizin kendisiyle sınırlanır. Bir dizin verilen aggrega import, asistanın içe aktarma aracı ve oturumun aggrega/import yöntemi, içe aktarıcıya dizinin dosya kalıplarının seçtiği dosyaları, her birini dizindeki yeri altında verir; bu nedenle bu okumaların içinde kaldığı dizin, nerede bulunursa bulunsun (çalışma alanının içinde de dışında da) o dizindir. Değerlendirilen, içe aktarmanın bir şey alacağı her girdidir: ilgili kalıplardan birinin seçtiği bir dosyaya giden bağlantı (adlandırılan biçime hizmet eden içe aktarıcının kalıpları ya da biçim tanındığında, derleyicinin çekirdek içe aktarıcıları dahil, içe aktarmanın aralarından seçim yaptığı her içe aktarıcının kalıpları) ve hiçbir zaman girilmeyen bir dizine giden bağlantı. Dizinin dışına, çalışma alanının başka bir yerine ya da herhangi bir yere çıkan bağlantı okunmaz: içe aktarma, dizinin herhangi bir dosyası açılmadan önce, hiçbir şey yazmadan bağlantıyı adlandırarak durur. Dizinin içinde başka bir yerdeki dosyaya giden seçilmiş bir bağlantı, bağlantının kendi adı altında gösterdiği yerde okunur; hiçbir kalıbın seçmediği bir dosyaya giden bağlantı ise ne değerlendirilir ne okunur. Dizinin kendisi adlandırdığınız gibi kullanılır: bağlantı olan bir dizin gösterdiği yerde okunur. Bir dinleyici üzerinden ulaşıldığında asistanın aracı bağlantıyı çalışma alanındaki yeriyle adlandırır ve nereye gittiği hakkında hiçbir şey söylemez. Bu iletinin adlandırdığı çözüm içe aktarılan bir dizine özgüdür: dosyaya giden bir bağlantı yerine dosyanın kendisini dizinde tutun ya da bağlantının gittiği dizini içe aktarın.
Üretilen ileti. Koşulun kendi cümlesiyle açılır, ardından okumanın ulaştığı yol, içinde kalması gereken dizin, yolda rastladığı bağlantı ve bu bağlantının gittiği yer, ardından da çözüm gelir:
bu işlemin okuduğu bir dosya, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor (okunan <workspace>/catalog-local/component/app/1.0.0/component.yaml, içinde kalması gereken dizin <workspace>; bağlantı <workspace>/catalog-local/component/app/1.0.0/component.yaml, <elsewhere>/component.yaml konumuna gidiyor). o bağlantı üzerinden hiçbir şey okunmadı. Bağlantıyı kaldırın ya da bağlantının <workspace> içindeki bir konuma gitmesini sağlayın. Dışarıda tutulanı okumak için, onu içeren dizini bir katalog dizininin altındaki bir bağlantı üzerinden erişmek yerine çalışma alanı yapılandırmasında bir katalog dizini olarak listeleyin: listelenen bir dizin, kendisi bir bağlantı olsa bile gittiği yerde okunur
Tanılama bir kategori taşımaz: hatalı olan, yazdığınız herhangi bir belge değil, diskteki düzendir.
Nasıl düzeltilir: bağlantıyı, yönlendirdiği şeyin bir kopyasıyla değiştirin ya da kaldırın; veya varlığın çalışma alanının dışında kalması amaçlanıyorsa, onu barındıran dizini çalışma alanı yapılandırmasında catalog_dirs altında listeleyin ya da --catalog ile verin; böylece dizin kendi başına bir katalog dizini olarak okunur. Bağlantının bulunduğu dizini değil, yönlendirdiği dizini listeleyin: bir dizinin altında karşılaşılan bir bağlantı, o dizin nasıl okunmaya başlanmış olursa olsun aynı şekilde değerlendirilir, dolayısıyla onu listelemek hiçbir şeyi değiştirmez. Bağlantı, çalışma alanının uzlaşımsal catalog dizininin kendisiyse, catalog dizinini — ya da işaret ettiği dizini — catalog_dirs altında listelemek veya ikisinden birini --catalog ile vermek yeterlidir, çünkü adını verdiğiniz bir dizin işaret ettiği yerde okunur. Bağlantı bir Release’in kilit dosyasıysa, onu kaldırın ve Release’i yeniden çekin; bu, yanına yeni bir kilit dosyası yazar. Bir Manifest’in katalog katmanı yoktur, bu nedenle Release’in okuduğu bir Manifest, Release’in kendisinin yanında tutulur. Bağlantı bir yapılandırma dosyasıysa, onu çalışma alanında tutulan bir kopyayla değiştirin; çalışma alanları arasında paylaşmak istediğiniz bir yapılandırma, --config veya AGGREGA_CONFIG ile genel yapılandırma dosyası olarak adlandırılarak her çalışma alanının kendi dosyalarının altında okunur. Bağlantı, sabitlenen ya da yayımlanan bir varlığın yanında duruyorsa, onu dosyanın kendisiyle değiştirin ya da varlık olan bir belgeyi kendine ait bir dizine taşıyın; bağlantı bir Plugin varlığının yanındaki .wasm ise, derlenmiş .wasm dosyasının kendisini oraya koyun. Bağlantı yapıt önbelleği dizini ya da içindeki bir şeyse, onu kaldırın — bir çekme önbelleği yeniden doldurur — ya da önbelleği başka bir yerde tutmak için artifact_cache_dir değerini, çalışma alanı köküne göreli yazılmış olarak (../shared-cache) o dizine ayarlayın. Bağlantı, bir git-repository kaynağının getirdiği bir depoda commit edilmişse, onu o depoda değiştirin — deponun içini göstermesini sağlayın ya da dosyanın kendisini commit edin — ve değişikliği taşıyan revizyonu belirtin. Bağlantı, bir katalog üretiminin overlay dizininin altındaki bir overlay ise, onu overlay’in kendisiyle değiştirin ya da tüm overlay’leri barındıran bir dizini overlay dizini olarak belirtin. Bağlantı, içe aktardığınız bir dizinde duruyorsa, dizinde dosyaya bir bağlantı yerine dosyanın kendisini tutun ya da bağlantının yönlendirdiği dizini içe aktarın.
A reference to another file leads out of the directory it must stay inside (Başka bir dosyaya yapılan başvuru, içinde kalması gereken dizinin dışına çıkıyor)
Bir Release ve bir Manifest başka bir dosyayı bir yolla adlandırabilir: bir Release’in ./… veya ../… olarak yazılmış aggregate: ve manifest: anahtarları, onun extends: anahtarı, bir Manifest’in yol olarak yazılmış extends: anahtarı ve bir Release’in parameters: { $import: … } değeri. Çalışma alanındaki bir belge bu yolla yalnızca çalışma alanı içindeki dosyalara ulaşır. Çalışma alanının dışında bulunan bir Release — komut satırında adlandırdığınız ya da çalışma alanı yapılandırmasının adlandırdığı — ve çalışma alanının dışında komut satırında tek başına adlandırdığınız bir Manifest yalnızca kendi dizinlerinin içindeki dosyalara ulaşır: o dizin, çalışma alanı dışında adlandırdığınız bir dizin gibi, kendi başına bir köktür ve extends: zincirinin ulaştığı her Release aynı dizinle sınırlanır. Yazıldığı haliyle o dizinden dışarı çıkan bir yol da, yazıldığı haliyle içeride kalıp yolda dışarı götüren bir sembolik bağlantıya rastlayan bir yol da reddedilir ve adlandırdıkları dosyadan hiçbir şey okunmaz. Dizinin altında henüz var olmayan bir dosyaya giden bir yol burada reddedilmez; okunamayan bir dosya olarak raporlanır. Çalışma alanı sınırı, adlandırdığınız yolun yanı sıra bir referansın neden sınırlandığını açıklar.
Bir yolun nereden çözümlendiği, dil başvurusunun her anahtar için öğrettiği kuralla aynıdır: bir Release’in aggregate: ve manifest: anahtarları ile bir Manifest’in extends: anahtarı, bir komutun veya isteğin adlandırdığı Release’in yanından — ya da tek başına adlandırdığınız bir Manifest için o Manifest’in yanından; bir Release’in extends: anahtarı ve bir parameters $import: ifadesi ise onu yazan Release’in yanından çözümlenir; böylece bir extends: zincirinin her halkası üst öğesini kendi yanında adlandırır. Tanılama, yolun çözümlendiği dizini adlandırır.
Yol yerine bir ad burada değerlendirilmez: aggregate: payments, extends: base-manifest. Ad, Release’in yanındaki belgeler arasında ve bir Aggregate için katalog dizinlerinde aranır; bu dizinler yukarıdaki “A file the operation reads leads through a link out of the directory it must stay inside (İşlemin okuduğu bir dosya, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor)” bölümündeki kurala bağlıdır.
Bir Release’in adlandırdığını çözümleyen her yüzey, dosya okunmadan önce bu durumda durur: aggrega pull, aggrega build, aggrega validate, bir Release veya Manifest için aggrega inspect, tek bir Release’in lint işlemi ve bir Release’i derleyen, önizleyen, grafiğini çıkaran, doğrulayan veya tanımlayan düzenleyici ve asistan istekleri. Düzenleyicide tanılama, Release’te dosyaya götüren anahtarın üzerine yerleştirilir.
Üretilen ileti. İleti, durumun kendi cümlesiyle açılır; ardından yazıldığı haliyle başvuru, bir extends: ve bir parameters $import: için yazıldığı belge, çözümlendiği dizin, ulaştığı yer, içinde kalması gereken dizin ve onu dışarı taşıyan bir bağlantı varsa o bağlantı gelir; sonra çözüm. Çalışma alanındaki bir belge için:
a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (bir belgenin başka bir dosyaya yaptığı başvuru, içinde kalması gereken dizinin dışına çıkıyor (.spec.aggregate: ../shared/app.yaml, <workspace> dizininden çözümlendi, <elsewhere>/shared/app.yaml konumuna gidiyor, <workspace> çalışma alanının dışında). o dosyadan hiçbir şey okunmadı. Çalışma alanındaki bir belge yalnızca <workspace> içindeki dosyalara ulaşır: dosyayı oraya taşıyın — ya da başvuruyu bir bağlantı dışarı taşıyorsa bağlantıyı oraya yönlendirin — veya çalışma alanını her iki belgeyi de içeren bir dizinde açın. O dizinin dışında tutulan bir Aggregate’e, yol yerine adıyla, çalışma alanı yapılandırmasının listelediği bir katalog dizininden ulaşılır)
ve çalışma alanının dışında adlandırılan, içinde kalması gereken dizin kendi dizini olan bir Release veya Manifest için:
a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (bir belgenin başka bir dosyaya yaptığı başvuru, içinde kalması gereken dizinin dışına çıkıyor (.spec.aggregate: ../aggregates/app.yaml, <directory> dizininden çözümlendi, <parent>/aggregates/app.yaml konumuna gidiyor, <workspace> çalışma alanının dışında adlandırılan bir belgenin dizini olan <directory> dışında). o dosyadan hiçbir şey okunmadı. Çalışma alanının dışında — komut satırında ya da çalışma alanı yapılandırmasıyla — adlandırılan bir Release veya Manifest yalnızca kendi dizini <directory> içindeki dosyalara ulaşır: dosyayı oraya taşıyın — ya da başvuruyu bir bağlantı dışarı taşıyorsa bağlantıyı oraya yönlendirin — veya belgeyi her iki belgeyi de içeren bir çalışma alanından adlandırın. O dizinin dışında tutulan bir Aggregate’e, yol yerine adıyla, çalışma alanı yapılandırmasının listelediği bir katalog dizininden ulaşılır)
bir extends: veya bir parameters $import: için başvurudan sonra written in <document> ve yolu bir bağlantı dışarı taşıdığında sonda the link <link> leads to <place> eklenir. Bir aggregate: veya manifest: başvurusu belge adlandırmaz: başka bir Release’i genişleten bir Release bunu zincirin daha yukarısındaki bir Release’ten devralmış olabilir ve her iki durumda da komutun adlandırdığı Release’in yanından çözümlenir.
Tanılamanın kategorisi [OPS_ERROR]’dır: başvuru bir Release veya Manifest içinde yazılmıştır.
Nasıl düzeltilir: çalışma alanının dışında tutulan bir Aggregate için yol yerine metadata.name değerini yazın ve onu içeren dizini çalışma alanı yapılandırmasında catalog_dirs altında listeleyin ya da --catalog ile verin — bir çalışma alanı, dışında tutulan varlıklara katalog dizini aracılığıyla ulaşır. Bir Manifest, bir extends: değerinin adlandırdığı Release ve bir parametre dosyası Release’in yanından okunur ve hiçbir zaman adla aranmaz; bu yüzden bunları çalışma alanı içinde tutun ya da çalışma alanını hem Release’i hem de dosyayı içeren bir dizinde açın. Çalışma alanının dışından adlandırdığınız bir Release veya Manifest için adlandırdığı şeyleri kendi dizininde tutun ya da onu, hem kendisini hem de adlandırdıklarını içeren çalışma alanında derleyin. Yolu bir bağlantı dışarı taşıyorsa bağlantıyı gösterdiği şeyin bir kopyasıyla değiştirin ya da dizinin içine yönlendirin.
No catalog version satisfies a version constraint (Hiçbir katalog sürümü sürüm kısıtını karşılamıyor)
Bir başvuru, kataloğun barındırdığı bir varlığı adlandırır ve kataloğun barındırmadığı bir sürümü sabitler: bulunmayan tam bir sürüm ya da mevcut hiçbir şeyin eşleşmediği bir şapka aralığı. Bu, adın kendisinin bilinmediği düz bir bulunamama durumundan farklıdır — burada varlık mevcuttur ve yalnızca sürüm karşılanamaz; bu yüzden ileti, varlığı eksik olarak raporlayıp sizi adda yazım hatası aramaya göndermek yerine bunu açıkça söyler.
Her tür bu duruma tek bir seçim üzerinden ulaşır; bu nedenle karşılanamayan bir sabitleme nerede yazılırsa yazılsın aynı davranır: bir Manifest’in Recipe eşlemesindeki sürüm yazım hatası, bir component türündeki aynı yazım hatası gibi reddedilir.
Durum kurtarılabilirdir; bu da düzenleyicinin belgeyi bırakmak yerine siz yazmaya devam ederken onu bir tanılama olarak göstermesini sağlar. Komut satırında ise bir durdurmaya dahil edilir.
Bir Release’in bağımlılıklarının ulaştığı bir başvuru — bir bileşen türü, bir Manifest eşleme değeri — için verilen, nerede toplandığını adlandıran ileti:
no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (hiçbir katalog sürümü başvurulan sürüm kısıtını karşılamıyor: belirtilen varlık ve ona başvuran konumlar)
Bir extends: işaretçisindeki sabitleme için üretilen ileti:
no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (hiçbir katalog sürümü başvurulan sürüm kısıtını karşılamıyor (Component <name>, .extends konumunda, hiçbir katalog sürümü extends üst öğesi “<reference>” değerini karşılamıyor))
sabitlemeyi bir Feature’ın zinciri taşıdığında Component yerine Feature yazılır.
Nasıl düzeltilir: sabitlemeyi kataloğun barındırdığı bir sürüme değiştirin ya da o sürümü kataloğa ekleyin. aggrega inspect, bir varlığın hangi sürümlerde mevcut olduğunu listeler. Hiçbir şeyle eşleşmeyen bir şapka aralığı genellikle mevcut sürümlerin hepsinin aralığın belirttiği alt sınırın altında olduğu anlamına gelir — aralığı genişletin ya da başvurunun beklediği sürümü yayımlayın.
Bir sabitlemenin aldığı biçimlerin hiçbirine uymayan bir sabitleme farklı bir durumdur ve aşağıda “A version pin is none of the forms a pin takes (Sürüm sabitlemesi, bir sabitlemenin aldığı biçimlerin hiçbirine uymuyor)” başlığı altında açıklanır.
A version pin is none of the forms a pin takes (Bir sürüm sabitlemesi, sabitlemenin alabileceği biçimlerin hiçbirinde değil)
Bir başvuru başka bir varlığı adlandırır ve istediği sürümü iki nokta üst üsteden sonra iki biçimden birinde sabitleyebilir: 1.0.0 gibi bir anlamsal sürüm olan tam sabitleme (her varlığın metadata.version değerinin aldığı biçim) ya da ^ ve ardından ^1.0.0 gibi bir sürümden oluşan, onunla uyumlu en yüksek sürümü seçen şapka sabitlemesi. Bunların hiçbiri olmayan bir sabitleme (metni bir sürüm aralığı olarak okunamayan ^garbage gibi bir şapka ya da 1.x, 1.0 veya v1.0.0 gibi anlamsal sürüm olmayan bir tam sabitleme) hiçbir sürümü adlandırmaz; bu yüzden hiçbir katalog istediği şeyi barındıramaz.
Böyle bir sabitleme, kataloğun barındırmadığı bir varlık ya da sürüm olarak değil, hatalı biçimlendirilmiş olarak bildirilir; böylece tanılama, var olmayan bir şeyi aramanız yerine sizi yazdığınız metne yönlendirir. Sabitleme nerede yazılmış olursa olsun aynı durumdur: bir bileşen ya da özellik type değeri, bir Component’in ya da Feature’ın extends: değeri, bir Manifest eşleme anahtarı ya da değeri, bir Release’in spec.aggregate değeri, bir Recipe’nin ya da FeatureRecipe’nin implements: değeri, bir Recipe’nin capability: değerinin ona hizmet eden plugin seçilirken sabitlediği sürüm ve bir işlem hattı adımının plugin: değeri.
Çözümlenemeyen bir başvurunun bildirildiği yerde bildirilir; bu nedenle hatalı biçimlendirilmiş bir sabitleme hangi başvuruların çözümlendiğini hiçbir zaman değiştirmez, yalnızca hatanın ne söylediğini değiştirir. Biçimi doğru olan ancak hiçbir kullanılabilir sürümün karşılamadığı bir sabitleme, o yüzeyin onun için bildirdiği durumu korur: yukarıdaki “No catalog version satisfies a version constraint (Hiçbir katalog sürümü bir sürüm kısıtını karşılamıyor)” ya da yazıldığı yüzeyin bulunamadı durumu.
Yalnızca son iki nokta üst üsteden sonraki metin bir sabitlemedir ve yalnızca / içermediğinde. Bu nedenle localhost:5000/core/api-server gibi bağlantı noktası içeren bir kayıt defteri ana bilgisayarına yapılan başvuru sabitleme taşımaz (bağlantı noktasının iki nokta üst üstesinden sonraki metin başvurunun devamıdır) ve hiçbir zaman hatalı biçimlendirilmiş sabitleme olarak bildirilmez.
Bir bileşen türündeki şapka sabitlemesi için üretilen ileti:
reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (başvuru hatalı biçimlendirilmiş bir sürüm sabitlemesi taşıyor (başvuru, sabitleme, ^ işaretinden sonraki metin bir sürüm aralığı değil, başvurulduğu yazım konumu). başvuruyu yalnızca adıyla, adından sonra iki nokta üst üste ve 1.0.0 gibi bir anlamsal sürümle ya da kendisiyle uyumlu en yüksek sürüm için adından sonra iki nokta üst üste, ^ ve sürümle yazın)
Tam bir sabitlemede şapka yan cümlesinin yerinde an exact pin must be a semantic version yazar. Ondan sonraki değer, başvurunun nereye yazıldığını onu bildiren yüzeyin sözcükleriyle söyler: referenced from ve yazım konumu, in the Release's spec.aggregate ya da in the recipe's spec.implements. Bir Manifest eşlemesi kendi Recipe’inin implements: alanına göre değerlendirildiğinde, bunun yerine başvurudan önce eşleme girdisi ve sabitlemeyi bu girdinin hangi tarafının taşıdığı (in the mapping key ya da in the recipe's spec.implements) gelir; bir Component’in ya da Feature’ın extends: alanı ise genişleten varlığı ve alanı başvurudan önce adlandırır.
Nasıl düzeltilir: sabitlemeyi iki biçimden birinde yeniden yazın ya da kullanılabilir en yüksek sürümü seçmek için kaldırın. 1.x gibi bir joker karakter, şapka sabitlemesi olarak ^1.0.0 biçiminde yazılır; başında v bulunan ya da üçten az sayı içeren bir sürüm tam olarak 1.0.0 biçiminde yazılır.
Every version a reference could select has been withdrawn (Bir başvurunun seçebileceği her sürüm geri çekilmiş)
Bir başvuru, kayıt defterinin barındırdığı bir depoya çözümlenir ve keşfin o depodan seçebileceği her sürüm geri çekilmiş olarak işaretlenmiştir. Seçilebilecek uygun hiçbir şey kalmamıştır.
Bu, bilerek eksik bir varlık olarak bildirilmez. Depo vardır ve bu sürümleri hâlâ barındırır; onu yok saymak yanlış sorunu adlandırır, sizi bir yazım hatası aramaya yönlendirir ve aslında olduğu gibi bir ret yerine sessiz bir geri dönüş gibi okunur. İleti, geri çekilen her sürümü ona karşı kaydedilmiş gerekçeyle adlandırır; böylece size söylenen, yayımcının kaydettiği şeydir.
Geri çekilmiş bir sürümü doğrudan adlandırmak bu durdurma değildir. Tam sürüm keşfi tamamen atlar; dolayısıyla onu sabitlemek, bilerek kullanmaya devam etmenin yoludur; derleme geri çekmeyi bildirir ve devam eder.
Üretilen ileti:
every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (bu başvurunun seçebileceği yayımlanmış her sürüm geri çekilmiş: <reference>: geri çekilenler: <version> (<recorded reason>), <version> (<recorded reason>))
Nasıl düzeltilir: kaydedilmiş gerekçeleri okuyun; bunlar genellikle neye geçileceğini adlandırır. Geri çekilen varlığın yerini alan şeye geçin; bir geri çekmenin istediği sonuç budur. Eskisini şimdilik korumanız gerekiyorsa başvuruda tam bir sürüm sabitleyin: sürümü adlandırmak onu kabul ettiğinizi söyler ve derleme bundan sonra reddetmek yerine her seferinde geri çekmeyi bildirir.
A plugins.providers binding names a plugin that does not serve the capability (Bir plugins.providers bağlaması, yeteneğe hizmet etmeyen bir plugin’i adlandırıyor)
Çalışma alanının plugins.providers bloğu bir yetenek için bir plugin kimliği seçer ve o yeteneğe hizmet eden hiçbir provider-rendering Plugin bu kimliği taşımaz. Bağlama, kataloğun karşılayamadığı açık bir seçimdir; bu yüzden sessizce başka bir plugin’e geri dönmek yerine durur: geri dönüş, çıktınızı kullanılmamasını söylediğiniz bir plugin üzerinden işler ve hiçbir şey söylemezdi.
Bağlama, plugin’in koordinat kimliğine göre seçer (plugin türü ve plugin’in adı; lockfile’ın sabitlediği de budur) ve ardından bir sürüm taşıyabilir.
Bir Recipe’nin yeteneği isteyip istemediğinden bağımsız olarak değerlendirilir. Bağlama aksi hâlde yalnızca bir Recipe’nin capability: değeri onu adlandırdığında okunur; bu yüzden yeteneği yanlış yazılmış bir bağlamaya hiçbir şey başvurmaz ve onu hiçbir şey bildirmezdi. Bu nedenle her derleme ve her aggrega validate --release, bir plugin adlandıran her bağlamayı denetler: bir pull, böyle bir bağlamayı bir Recipe kullansa da kullanmasa da çözümler; böylece derleme plugin’i barındırır ve neye hizmet ettiğini bilir, o plugin’in hizmet etmediği bir yetenek de kesinlikle yanlıştır. Denetim lockfile’ı değil, çalışma alanı yapılandırmasındaki bağlamaları okur ve bir Recipe’yi hangi plugin’in işlediği konusunda hiçbir şeyi değiştirmez; bu lockfile’a aittir. Derlemenin barındırmadığı bir plugin’i (henüz hiçbir pull’un getirmediği bir kayıt defteri plugin’i) adlandıran bağlama, bir pull onu getirene kadar değerlendirilmez. Hiçbir plugin adlandırmayan bağlama ise farklı biçimde, bir öneri olarak değerlendirilir: aşağıda “Conditions that do not halt a build” altındaki “A provider binding names a capability no plugin the build reads serves (Bir provider bağlaması, derlemenin okuduğu hiçbir plugin’in hizmet etmediği bir yeteneği adlandırıyor)” bölümüne bakın.
Adlandırılan plugin’in neye hizmet ettiğini ve bağlamanın yeteneği tek düzenleme uzaklıktaysa bir yazımı ekleyen üretilen ileti:
plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (plugins.providers girdisi, yeteneğe hizmet eden hiçbir provider-rendering plugin’in eşleşmediği bir plugin adlandırıyor: “<capability>” yeteneği “<plugin-identity>” plugin’ine bağlı, ancak “<capability>” yeteneğine hizmet eden hiçbir provider-rendering plugin bu kimlikle eşleşmiyor; “<plugin-identity>”, “<served capability>” yeteneğine hizmet ediyor ve “<capability>”, “<served capability>” yeteneğinden tek düzenleme uzaklıkta)
Bağlamanın adlandırdığı plugin derlemenin okuduğu katalogda değilse, neye hizmet ettiği hakkında söylenecek bir şey olmadığından ileti “matches that identity” ifadesinden sonra biter.
Nasıl düzeltilir: önce bağlamanın yazımını plugin’in kendi koordinatıyla karşılaştırın; plugin’i adlandırması gereken yerde yeteneği adlandıran bir bağlama yaygın bir hatadır. İleti, yazdığınızdan tek düzenleme uzaklıktaki bir yeteneği adlandırıyorsa yazım hatası bağlamanın capability: değerindedir. Ardından plugin’in derlemenin okuduğu katalogda olduğunu ve bu yeteneği spec.provider.capabilities altında listelediğini doğrulayın; bir zamanlar yeteneğe hizmet eden ve artık onu bildirmeyen bir plugin tam olarak bu iletiyi üretir. Yeteneğe yalnızca tek bir plugin hizmet ediyorsa doğru düzeltme bağlamayı kaldırmaktır, çünkü bu durumda bağlamanın ayırt edeceği bir şey yoktur.
No provider plugin version satisfies a Recipe’s provider pin (Hiçbir provider plugin sürümü bir Recipe’nin provider sabitlemesini karşılamıyor)
Bir Recipe, sürümü sabitlenmiş bir provider bağlar (helm:1.0.0 ya da helm:^1.0.0) ve hiçbir provider-rendering Plugin sürümü bu sabitlemeyi karşılamaz. Sabitleme açık bir istektir; bu yüzden derleme onu yok sayıp provider’a o anda hangi sürüm hizmet ediyorsa onun üzerinden işlemek yerine durur: bir sabitlemeyi sessizce geçersiz kılmak, yazarın kendi bildiriminin var olmaması gerektiğini söylediği bir çıktı üretirdi.
Buna iki durum yol açar ve ileti bunları birbirinden ayırır: yeteneğe hiçbir şey hizmet etmiyordur ya da bir şey hizmet ediyordur ama sürümlerinden hiçbiri kısıtı karşılamıyordur.
Bu, yukarıdaki karşılanamayan varlık sürümünden farklıdır. O durum, kataloğun barındırmadığı bir sürümle adlandırılan bir katalog varlığıyla ilgilidir; bu ise bir yeteneği işleyen plugin’in seçilmesiyle ilgilidir.
Üretilen iletiler:
no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (hiçbir provider-rendering plugin sürümü recipe’nin provider sürüm sabitlemesini karşılamıyor: “<capability>” yeteneği “<version>” sürümünü sabitliyor ancak ona hiçbir provider-rendering plugin hizmet etmiyor)
no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (hiçbir provider-rendering plugin sürümü recipe’nin provider sürüm sabitlemesini karşılamıyor: “<capability>” yeteneği “<version>” sürümünü sabitliyor ancak hizmet eden hiçbir plugin sürümü onu karşılamıyor)
Nasıl düzeltilir: Recipe’nin capability: alanındaki sabitlemeyi genişletin ya da düzeltin veya istediği plugin sürümünü kataloğa ekleyin. Şapka sabitlemesi, aynı ana sürüm içinde alt sınırdaki ya da onun üzerindeki sürümlerle eşleşir; bu yüzden ^2.0.0 sabitlemesini, ne kadar yeni olursa olsun bir 1.x plugin karşılamaz. İleti yeteneğe hiçbir şeyin hizmet etmediğini söylüyorsa sorun sabitleme değildir: plugin tamamen eksiktir ve sabitlemeyi kaldırmak işe yaramaz.
No plugin advertises a requested parse or import format (Hiçbir plugin istenen ayrıştırma ya da içe aktarma biçimini duyurmuyor)
Bir biçim istendi ve hiçbir plugin onu duyurmuyor. Biçime göre yönlendiren iki soketin her birinin kendi durumu vardır ve yalnızca hangi işin istendiği bakımından farklılaşırlar: parser plugin yabancı bir kaynak biçimini okur, importer plugin ise yabancı içeriği Aggrega varlıkları olarak içeri alır.
Biçim alanı açıktır ve tamamen plugin’lere aittir. Soketlerin hiçbiri derleyicinin bildiği biçimlerin bir listesini tutmaz: bir plugin işlediği biçimleri yetenek olarak bildirir ve yeni bir biçim, derleyicide hiçbir değişiklik olmadan yeni bir plugin olarak gelir. Bu yüzden bu durdurma, sabit bir numaralandırma yerine duyurulan kümeyi olduğu hâliyle bildirir ve her ıska açıkça bildirilir: isteğin ya bir duyuranı vardır ya da karşılanamaz. Aşağıda açıklanan, derleyicinin taşıdığı parser’lardan oluşan tek istisna dışında eksik bir plugin’in yerini hiçbir şey tutmaz.
Üretilen iletiler:
no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (hiçbir parser plugin istenen biçimi duyurmuyor: hiçbir parser plugin “parse:<format>” duyurmuyor)
no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (hiçbir importer plugin istenen biçimi duyurmuyor: hiçbir importer plugin “import:<format>” duyurmuyor)
Biçimi duyuran ancak çözümlenemeyen bir sürüm biçimi taşıyan tek bir parser plugin, sessizce geçilmek yerine hiç duyuran yokmuş gibi ele alınır ve bunu belirtir:
no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (hiçbir parser plugin istenen biçimi duyurmuyor: “parse:<format>” için hiçbir parser plugin sürümü çözümlenmiyor)
Bir ayrıştırma, derleyicinin taşıdığı parser’lara geri döner. Bir derleme, bir render-verdict ilkesine verdiği ve ilkenin yerel olarak okumadığı bir biçimdeki her dosyayı ayrıştırır; bir importer kaynağını adlandırdığı sözdiziminin parser’ı üzerinden okur; hiçbir biçim adlandırmayan bir içe aktarma ise kaynağı her uygulanabilir imzanın adlandırdığı sözdiziminde ayrıştırır. Her sözdizimi için çalışma alanı kataloğunun sunduğu parser, katalog hiçbirini sunmuyorsa derleyicinin o sözdizimi için kendisinin taşıdığı parser kullanılır; bir derlemenin Terraform çıktısını üzerinden okuduğu HCL parser’ı ve derleyicinin çekirdek importer’larının üzerinden okuduğu JSON parser’ı da bunlar arasındadır, bu yüzden ne Terraform çıktısı üzerindeki bir ilke ne de bir çekirdek importer üzerinden yapılan bir içe aktarma katalogda parser gerektirir. Katalog bir sözdizimi için parser sunuyorsa derleyicinin kendi parser’ı hiçbir rol oynamaz ve katalogdaki farklı adlı iki parser, A parse or import format is advertised by more than one plugin (Bir ayrıştırma ya da içe aktarma biçimi birden fazla plugin tarafından duyuruluyor) bölümünün açıkladığı gibi reddedilir. Dolayısıyla bu durdurma, ne kataloğun ne de derleyicinin parser sunduğu bir sözdizimini adlandırır.
Nasıl düzeltilir: biçimin plugin’in duyurduğu gibi yazıldığını doğrulayın; yetenek soketin önekinden ve biçim adından oluşur, bu yüzden parse:hcl duyuran bir plugin hcl biçimine hizmet eder, başka hiçbir şeye değil. Ardından plugin’in derlemenin okuduğu katalogda bulunduğunu doğrulayın. Biçim için hiçbir plugin yoksa eksik parça o plugin’dir; derleyici hiçbir şeyin duyurmadığı bir biçimi okuyamaz.
A parse or import format is advertised by more than one plugin (Bir ayrıştırma ya da içe aktarma biçimi birden fazla plugin tarafından duyuruluyor)
İki ya da daha fazla farklı plugin aynı biçimi duyurur ve istek hangisinin kullanılacağı tahmin edilmeden yönlendirilemez.
İkisini birden barındıran bir katalog geçerlidir ve sorunsuz yüklenir. İki yayımcının her biri bir biçim için bir parser ya da importer sunabilir ve kataloglarını birleştirmek desteklenen bir işlemdir. Belirsizlik bir kullanım noktası durumudur: çekişmeli biçim gerçekten istendiğinde durur; bu yüzden bir derlemenin erişimi dışında duran rakip bir çift onu hiçbir zaman engellemez.
Her aday sıralanmış olarak adlandırılır; böylece ileti her çalıştırmada aynıdır.
Üretilen iletiler:
format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (biçim birden fazla parser plugin tarafından duyuruluyor: “<format>” biçimi [<plugin-names>] parser plugin’leri tarafından duyuruluyor)
format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (biçim birden fazla importer plugin tarafından duyuruluyor: “<format>” biçimi [<plugin-names>] importer plugin’leri tarafından duyuruluyor)
Bir importer için durdurma bir biçimde daha ortaya çıkar: çalışma alanının plugins.importer girdileri biçimi duyuran importer’lardan birden fazlasını bağlar ve bu durumda adlandırılan importer’lar bağlanmış olanlardır.
Bir içe aktarmanın aralarından seçim yaptığı importer’lar, çalışma alanının kataloğundakiler ve biçimlerini her çalışma alanında duyuran derleyicinin çekirdek importer’larıdır. Bu yüzden bir çekirdek importer’ın hizmet ettiği bir biçim (import:langflow ya da import:flowise) için başka adlı kendi importer’ını barındıran bir katalog, ikisini de bağlamayan bir içe aktarmada bu durdurmayla karşılaşır ve ileti çekirdek importer’ı kataloğunkinin yanında adlandırır. Kataloğun bir çekirdek importer’ın kendi adı altında barındırdığı bir importer ikinci bir duyuran değildir: tek bir ad içinde en yüksek sürüm seçilir ve çekirdek importer’ın kendi sürümünde olup yanında modülü bulunan bir importer onun yerine çalışır. Yanında modülü olmayan bir importer ise, o adı taşıyan ve çalışabilen bir importer biçimi duyurduğunda aday değildir; bu, Kendi içe aktarıcılarınızın yanında hangisi çalışır bölümünde anlatılır.
Nasıl düzeltilir: bir importer için ikisini de katalogda tutun (ya da kendinizinkini çekirdek importer’ın yanında tutun) ve istediğinizi bağlayın: uri değeri onu kimliği ve sürümüyle adlandıran bir plugins.importer girdisi, yani aggrega plugin add importer komutunun yazdığı gibi uri: importer/<name>:<version>. Bağlanan importer, biçimi duyuranlar arasından seçilir; tıpkı aşağıda “A capability is served by more than one provider plugin (Bir yeteneğe birden fazla provider plugin hizmet ediyor)” altında açıklandığı gibi bir plugins.providers girdisinin provider soketinde bir yeteneğe hizmet eden plugin’ler arasından seçim yapması gibi. Adlandırılan importer’lar girdilerinizin bağladıklarıysa istediğinizin girdisini tutun ve diğerini kaldırın. Ayrıştırma soketinde böyle bir seçim yoktur; bu yüzden bir parser için çözüm, derlemenin okuduğu kataloğu yalnızca istediğiniz plugin içinde kalacak şekilde daraltmaktır; --catalog seçeneğini seçtiğiniz plugin’i barındıran dizine yöneltmek bunun doğrudan yoludur.
A plugins.importer entry pins a version of its importer the catalog does not hold (Bir plugins.importer girdisi, importer’ının kataloğun içermediği bir sürümünü sabitliyor)
Bir plugins.importer girdisi bir importer’ı kimliği ve bir sürümüyle bağlar — tam bir sürüm, uri: importer/<name>:1.2.0, ya da bir aralık, uri: importer/<name>:^1.2.0 — ve bu importer içe aktarmanın istediği biçimi duyurur; ancak içe aktarmanın aralarından seçim yaptığı sürümlerin hiçbiri sabitlemeyi karşılamaz. Bu sürümler çalışma alanının kataloğunun içerdiği sürümlerdir; bir çekirdek importer için derleyicinin kendi sürümü de bunlara dahildir. Tam sürüm orada yoktur ya da sürümlerinin hiçbiri aralığa düşmez. Sürüm açık bir seçimdir; bu nedenle importer’ın yerine başka bir sürümü çalıştırılmaz, içe aktarma herhangi bir importer çalışmadan önce reddedilir.
Bu durum, yukarıda açıklanan, biçimi hiçbir importer’ın duyurmaması durumundan farklıdır: burada importer, içe aktarmanın aralarından seçim yaptığı importer’lardan biridir ve biçimi duyurur; eksik olan yalnızca girdinin adlandırdığı sürümdür. :latest gibi, bir sürüm sabitlemesinin aldığı biçimlerin hiçbirine uymayan bir sabitleme ise “A version pin is none of the forms a pin takes (Bir sürüm sabitlemesi, bir sabitlemenin aldığı biçimlerin hiçbirine uymuyor)” bölümünün açıkladığı gibi hatalı biçimli olarak bildirilir.
Biçimin yeteneğini ve girdinin sabitlediği sürümü adlandıran, üretilen ileti:
no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it (hiçbir importer eklenti sürümü plugins.importer girdisinin sürüm sabitlemesini karşılamıyor: import:<format> yeteneği <version> sürümünü sabitliyor, ancak onu sunan hiçbir eklenti sürümü bunu karşılamıyor)
Nasıl düzeltilir: girdinin uri alanındaki sürümü kataloğun içerdiği bir sürümle değiştirin — bir çekirdek importer için derleyicinin kendi sürümü de bunlardan biridir — ya da aralığı genişletin veya girdinin adlandırdığı sürümü kataloğa ekleyin. Şapka (caret) aralığı, aynı ana sürüm içinde alt sınırına eşit veya ondan büyük sürümlerle eşleşir; bu nedenle ^2.0.0, ne kadar yeni olursa olsun bir 1.x importer tarafından karşılanmaz.
A plugin reference carries a registry host or an artifact path (Bir plugin başvurusu bir kayıt defteri ana bilgisayarı veya bir yapıt yolu içeriyor)
Bir Plugin başvurusu, kayıt defteri ana bilgisayarı biçimli bir segmentle — bir DNS adının veya ana bilgisayar-ve-port çiftinin yaptığı gibi nokta ya da iki nokta üst üste içeren bir segmentle — veya bir yapıt yoluyla başlar. Bir Plugin, koordinat kimliği ile adreslenir: plugin türü, bir eğik çizgi, adı ve isteğe bağlı olarak bir sürüm. Çekme işlemi, yapılandırılmış kayıt defterini ve plugin yolunu kendisi öne ekleyerek bu kimliği fiziksel bir konuma bağlar; dolayısıyla bunlardan birini zaten içeren bir başvuruya iki kez önek eklenir ve başvuru getirilemeyen bir konuma bağlanır.
Başvuru, getirme sırasında değil konumun oluşturulduğu yerde reddedilir; böylece ileti, daha sonra okunamaz bir etiket hatası olarak ortaya çıkmak yerine sizin yazdığınızı adlandırır.
Konumu oluşturan çekme işlemiyle çerçevelenen ve çözümü alt satırda veren, üretilen ileti:
catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" (katalog: 3. katman çekme işlemi: wasm eklenti başvurusu, kayıt defteriyle nitelenmiş bir yol veya yapıt yolu değil, eklentinin koordinat kimliği olmalıdır: <identity>)
remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice (çözüm: kayıt defteri ana bilgisayarını ve yapıt yolunu kaldırıp yalnızca koordinatı bırakın — <pluginType>/<name>:<version>; çekme işlemi yapılandırılmış kayıt defterini kendisi öne ekler, bu nedenle zaten bir tane taşıyan başvuruya iki kez eklenir)
Nasıl düzeltilir: plugin türünden önceki her şeyi silin ve koordinatı tek başına bırakın — hub.example.com/plugin/provider/helm:1.0.0 değil, provider/helm:1.0.0. Bir derlemenin çektiği kayıt defteri bir kimliğin parçası değil, çalışma alanı yapılandırmasıdır; bir kataloğun, içindeki varlıklar düzenlenmeden birden fazla kayıt defterinden sunulabilmesini sağlayan da budur.
A plugin or recipe reference carries no scope (Bir plugin veya recipe başvurusu kapsam içermiyor)
Bir Plugin veya Recipe başvurusunun başında kapsam segmenti yoktur — ya hiç eğik çizgi yoktur ya da /name örneğinde olduğu gibi eğik çizgiden önce boş bir segment vardır. Her iki tür de iki parçayla tanımlanır ve aynı adlı iki varlığı birbirinden ayıran ilk parçadır: bir Plugin plugin türü ve adıyla, bir Recipe ise provider’ı ve adıyla. İki soket her biri redact adlı bir plugin barındırabilir ve iki provider her biri postgres adlı bir recipe sunabilir; bu nedenle kapsam, kimliğin üzerinde bir süsleme değil, kimliğin bir parçasıdır.
Boş bir kapsamdan oluşturulan bir konum boş bir yol segmenti — çift eğik çizgi — içerir ve çözümlenemez; bu nedenle başvuru, daha sonra okunamaz bir getirme olarak başarısız olmaya bırakılmak yerine konumun oluşturulduğu yerde reddedilir.
İki çözüm, yukarıdaki nitelenmiş plugin durumunun ve birbirlerinin tersidir; her birinin ayrı ifade edilmesinin nedeni budur: burada başvuruda bir segment eksiktir ve siz bir segment eklersiniz, nitelenmiş bir başvuru ise fazladan bir segment içerir ve siz onu kaldırırsınız.
Her biri çekme işlemiyle çerçevelenen ve kendi çözümünü altında taşıyan, üretilen iletiler:
catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" (katalog: 3. katman çekme işlemi: wasm eklenti başvurusu bir pluginType kapsamı taşımalıdır (<pluginType>/<name>); boş bir kapsam bir OCI konumuna bağlanamaz: <identity>)
remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType (çözüm: eksik pluginType bölümünü ekleyin — başvuruyu, eklenti varlığının metadata.pluginType altında bildirdiği pluginType’ı kullanarak <pluginType>/<name> biçiminde yazın; örneğin provider/helm veya governance/redact)
catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (katalog: 3. katman çekme işlemi: recipe başvurusu provider kapsamlı olmalıdır (<provider>/<name>); boş bir provider bir OCI konumuna bağlanamaz: <identity>)
remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable) (çözüm: hiçbir yerel katalog dizini bu başvuruyu içermediği için başvuru, provider bölümünün zorunlu olduğu kayıt defterinde arandı; onu içeren dizinin önce aranması için komutu aggrega pull —release <release> —catalog <dir> biçiminde yeniden çalıştırın (—catalog tekrarlanabilir))
Nasıl düzeltilir: bir plugin için, Plugin varlığının metadata.pluginType altında bildirdiği plugin türünü öne ekleyin. Bir recipe için, Recipe’nin spec.capability altında bildirdiği provider’ı öne ekleyin. Recipe çözümü, okunmaya değer ikinci bir olasılığı da adlandırır: kayıt defterine hiç ulaşılmış olması, yerel katalog dizinlerinin önce arandığı ve hiçbirinin başvuruyu içermediği anlamına gelir; dolayısıyla recipe’nin yerel bir dizinden gelmesi amaçlanıyorsa, kapsam eklemek yerine derlemeyi o dizine yönlendirin.
The build consumes an artifact its publisher has deprecated (Derleme, yayıncısının kullanımdan kaldırdığı bir yapıtı tüketiyor)
Bu derlemenin çözümlediği bir başvuru, yayıncısının kaydettiği bir kullanımdan kaldırma işareti taşır ve bu işaretin önem düzeyi, çalışma alanının durdurma eşiği olarak yapılandırdığı önem düzeyine eşit ya da ondan yüksektir. İşaret, yayımlanmış bir yapıta sonradan eklenir; bu nedenle dün sorunsuz derlenen bir yapıt, sizin dosyalarınızda hiçbir şey değişmeden bugün bir işaret taşıyabilir.
Raporlama ve durdurma ayrıdır ve yalnızca durdurma yapılandırılabilir. Kaydedilmiş her işaret, her önem düzeyinde raporlanır ve hiçbir yapılandırma bunu susturmaz. Bir işaretin derlemeyi ayrıca durdurup durdurmayacağına halt_on_deprecated_severity karar verir; kaydedilmiş önem düzeyini yapılandırılmış eşikle warning < error < retracted sırasına göre karşılaştırır. Hiçbir eşik yapılandırılmamışsa hiçbir şey durmaz ve her işaret bir uyarı niteliğindedir. Bu üçünün dışındaki bir önem düzeyi ya da eşik hiçbir zaman karşılanmaz: hatalı biçimlendirilmiş bir değer ne durdurmaya neden olabilir ne de bir durdurmayı bastırabilir.
Derleme durmadan önce yalnızca durduran bildirim değil, her bildirim yazdırılır; bu nedenle eşiği yükseltmek size hiçbir bulguyu kaybettirmez — durdurmanın kendisi, üzerinde durduğu tek başvuruyu adlandırır. Bulgular başvuruya göre sıralanır; böylece aynı lockfile her çalıştırmada aynı sırayı raporlar ve durduran bulgu her zaman aynıdır.
İki depo denetlenir ve ikisi de aynı şekilde raporlar: lockfile’ın sabitlediği başvurular ve kabul-ret kararı için güvenilir olarak kaydedilmiş plugin’ler. Denetimlerin hiçbiri bir registry’ye ulaşmaz — ikisi de önceden kaydedilmiş olanı okur — böylece derleme önceden derlemeli (ahead-of-time) kalır.
Üretilen ileti. Her bulgu dolaşıldıkça yazdırılır; ardından durdurma, eşiği karşılayanı yineler ve derlemeyi durduran ayarı adlandırır:
deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)
deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error"
İki uyarı niteliğindeki önem düzeyinden birindeki bir işaret, retracted yerine deprecated (warning) ya da deprecated (error) olarak belirtilir. Bu ayrım korunur, çünkü ikisi farklı anlamlar taşır — önerilmeyen ama hâlâ seçilebilir olan ile seçimden dışlanmış olan — ve güçlü olanı zayıf olan gibi raporlamak olanı olduğundan hafif gösterirdi.
Nasıl düzeltilir: yayıncının neye geçileceğine ilişkin kendi açıklaması olan kaydedilmiş iletiyi okuyun ve geçişi yapın. Henüz geçiş yapamıyorsanız halt_on_deprecated_severity değerini yükseltmek — ya da ayarı kaldırmak — durdurmayı, görmeye devam ettiğiniz bir uyarıya geri dönüştürür; bu bir geçici çözüm değil, bilinçli bir kabuldür ve bildirim yazdırılmaya devam eder. Artık kullanmadığınız bir sürüme karşı kaydedilmiş bir işaret, lockfile aggrega pull ile yenilendiğinde kaybolur.
A trusted plugin’s recorded digest disagrees with the cached artifact (Güvenilir bir plugin’in kaydedilmiş özeti önbellekteki yapıtla uyuşmuyor)
Bir derlemeyi kabul eden ya da reddeden bir rolde eklenmiş bir plugin için güvenilir olarak kaydedilmiş bir özet vardır ve plugin’in önbellekteki manifest’i farklı bir özet bildirir. İkisi, plugin’in yürütülebilir dosyası okunmadan önce karşılaştırılır ve bir uyuşmazlık çözümlemeyi orada durdurur.
Kaydedilmiş özeti bir yeniden ifadeden öte bir otorite yapan, bu karşılaştırmadır. Karşılaştırma olmadan bir plugin’in baytları yalnızca, baytlarını daha sonra doğruladığı manifest’in kendisinden türetilen bir sabitlemeye karşı denetlenir — yapısı gereği kendi içinde tutarlıdır ve yapıtın tümüyle değiştirildiğini fark edemez. Kaydedilmiş olanı manifest’in şimdi bildirdiğiyle karşılaştırmak, bu denetime dışarıdan bir görüş kazandırır.
Bu, çözümlenmiş baytların onlar için öne sürülen özetle uyuşmadığını raporlayan içerik özeti uyuşmazlığından farklıdır. Burada hiçbir şey okunmamıştır ve baytlar manifest’le pekâlâ uyuşuyor olabilir; uyuşmayan, hangi yapıtın çözümlendiğinin ta kendisidir. İkisini ayrı tutmak önemlidir, çünkü çözümler birbirinin tersidir — biri bozulmuş ya da kurcalanmış bir yapıttır, diğeri ise yeni kimliği henüz gözden geçirilmemiş, meşru biçimde değiştirilmiş bir plugin’dir.
Üretilen ileti:
resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports
Nasıl düzeltilir: herhangi bir şeyi yeniden kaydetmeden önce neyin değiştiğini öğrenin — bu, derlemelerinizi reddedebilen bir plugin’dir ve kaydedilmiş özet, birinin ona baktığının beyanıdır. Değişiklik bekleniyorsa, örneğin plugin’i bilerek yükselttiyseniz, yeni yapıtı gözden geçirin ve onun için güvenilir özeti yeniden kaydedin. Beklenmiyorsa, kaydın adlandırdığı yapıtı geri yükleyin; uyuşmazlık size kimliğin, kimse buna karar vermeden değiştiğini söylüyordur.
An extends: chain cannot be assembled (Bir extends: zinciri birleştirilemiyor)
Bir Component’in, Feature’ın, Manifest’in veya Release’in extends: zinciri çözümlenemeyen bir üst öğeyi adlandırıyor; bu nedenle zincir tek bir çözümlenmiş varlığa dönüştürülemiyor.
Bu durum, kendi koşulu ve kendi çözümü olan döngüden (yukarıdaki “Cyclic extends chain (Döngüsel extends zinciri)” bölümüne bakın), aşağıda kendi koşulu bulunan derinlik sınırını aşan zincirden ve üst öğenin var olduğu, yalnızca sürümün bulunmadığı karşılanamaz bir sürüm sabitlemesinden farklıdır.
Çözümlenemeyen extends: değerini taşıyan varlığı ve bildirdiği başvuruyu adlandıran üretilen ileti:
inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (kalıtım birleştirmesi başarısız oldu (Component <name>, .spec.extends konumunda, <entity>, hiçbir katalog varlığının sağlamadığı <reference> öğesini genişletiyor). extends başvurusunun katalogda bulunan bir varlığı adlandırdığını doğrulayın)
Bunu bildiren denetim bir üst öğeyi bir kilit dosyasının sabitlemesi altında yapıt önbelleğinden okuduğunda — bir derlemenin ve aggrega validate --release komutunun extends denetimi, tüm katalog üzerinde aggrega validate ve aggrega inspect ile düzenleyiciden ve asistanın validate aracından çalıştırılan aynı denetimler — öneri ayrıca pull işlemini adlandırır: “a base published to a registry is fetched by aggrega pull --release <release>” (bir kayıt defterinde yayımlanan bir temel, gösterilen komutla getirilir). Tek bir varlık dosyasını doğrulamak hiçbir kilit dosyası okumaz; bu nedenle bir pull işlemi onun okuduğu hiçbir şeyi değiştirmez ve iletisi katalogda sona erer.
Başarısız olan zincir bir Feature’ın zinciriyse Component yerine Feature görünür. Döngüde olduğu gibi, ilk adlandırılan varlık çözümlemenin başladığı varlıktır; kenarda adlandırılan varlık ise extends: satırını açmanız gereken varlıktır. Çok katmanlı bir zincirde bu ikisi farklıdır.
Bir Manifest’in extends: değeri farklı bir yere göre yanıtlanır, bu nedenle farklı bir öneriyle yanıtlanır. Manifest, katalog içeriği değil, Release’in yanında yazılan operatör yapılandırmasıdır; extends: değeri göreli yollu bir dosyayı ya da Release’in kendi dizinindeki bir Manifest’in metadata.name değerini adlandırır, hiçbir zaman bir katalog varlığını değil. Bu nedenle iletisi, başvurunun neye çözümlenemediğini ve bunun yerine nereye bakılacağını belirterek biter:
inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (kalıtım birleştirmesi başarısız oldu (Manifest <name>, .spec.extends konumunda, <entity>, çözümlenemeyen <reference> öğesini genişletiyor: <what looking produced>). extends başvurusunun göreli bir yol veya Release’in dizinindeki bir Manifest’in adı olduğunu doğrulayın)
Sondaki bu ayrıntı, aramanın kendisinin bildirdiği hatadır (okunamayan dosya ya da o ad altında hiçbir Manifest dizinlemeyen tarama); bu nedenle genellikle iki biçimden hangisinin denendiğini ve neden boş döndüğünü söyler.
Bir Release’in extends: değeri bir dizine göre yanıtlanır ve tek bir biçim kabul eder. Release, üst öğesini göreli bir yol olarak adlandırır: ./base-release.yaml veya ../shared/base-release.yaml. Yanıtlamanın yapıldığı dizin, başvuruyu yazan Release’i içeren dizindir ve zincirdeki her bağlantı kendi dizinine göre yanıtlanır; bu nedenle bir alt dizinde tutulan zincir ortasındaki bir Release, bir komutun adlandırdığı Release nerede olursa olsun, üst öğesini kendi yanında adlandırır. Yalın bir belirteç bir yol değildir ve derleyicinin arayacağı bir Release’i adlandırmaz; bu nedenle bulunamayacağı bir yerde aranmak yerine burada bildirilir:
inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (kalıtım birleştirmesi başarısız oldu (Release <name>, .spec.extends konumunda, <entity>, çözümlenemeyen <reference> öğesini genişletiyor: <what looking produced>). extends başvurusunun, bu Release’i içeren dizinden çözümlenen, ./base-release.yaml gibi bir Release dosyasına göreli yol olduğunu doğrulayın)
Nasıl düzeltilir: Bir Component veya Feature için extends: değerinin, katalogda bulunan bir varlığı o varlığın kendi metadata.name değeriyle, büyük/küçük harf dahil aynı yazımla adlandırdığını doğrulayın. Bir kayıt defterinde yayımlanan bir temel, Release’in kilit dosyasının onun için kaydettiği sabitleme altında yapıt önbelleğinden okunur; bu nedenle temel bir kayıt defterinde bulunuyorsa aggrega pull --release <release> komutunu çalıştırın: pull zinciri izler, temeli getirir ve sabitler. Bir Manifest için dosyanın göreli yolun gösterdiği yerde olduğunu ya da o metadata.name değerine sahip bir Manifest’in Release’in dizininde bulunduğunu ve ayrıştırıldığını doğrulayın. Bir Release için değerin ./ veya ../ ile başladığını ve gösterdiği dosyanın orada olduğunu ve Release olarak ayrıştırıldığını doğrulayın.
An extends: chain runs past the depth bound (Bir extends: zinciri derinlik sınırını aşıyor)
Bir Component’in, Feature’ın, Manifest’in veya Release’in extends: zinciri düzgün biçimde sona eriyor, ancak on olan sınırın izin verdiğinden fazla varlıktan geçiyor.
Yukarıdakiyle aynı koşulu paylaşmak yerine kendi koşulunu taşır, çünkü iki çözümün ortak hiçbir yanı yoktur: eksik bir üst öğe düzeltilecek bir başvurudur, aşırı derin bir zincir ise düzleştirilecek bir yapıdır. Sınır yapısal bir kısıt değil, yazım kazasına karşı bir korumadır: mimarlar genellikle bir temeli bir veya iki katman genişletir ve on derinliğindeki bir zincir çoğunlukla bilinçli bir tasarım değil, büyümüş bir temel ağaçtır.
Bu sınıra yalnızca SONA EREN bir zincir ulaşır. Kendi üzerine dönen bir zincir, uzunluğu ne olursa olsun döngü olarak bildirilir; bu nedenle bu koşul hiçbir zaman bir döngünün yerini almaz ve önerisi (zinciri kısaltın) hiçbir zaman döngü için verilmez.
Sınırı ve zincirin ulaştığı uzunluğu adlandıran üretilen ileti:
extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (extends zinciri en büyük derinliği aşıyor (Component <name>, kural extends). sınır 10’dur ve bu zincir <length> uzunluğuna ulaşıyor; zinciri kısaltın veya köküne daha yakın bir temeli genişletin)
Başarısız olan zincir bunlardan birinin zinciriyse Component yerine Feature, Manifest veya Release görünür. Sınır, extends bildiren her tür için aynı ondur ve aradaki bağlantıları değil, zincirdeki varlıkları sayar: tam on varlıklı bir zincir derlenir ve bu durumun bildirdiği şey on birinci varlıktır. Dolayısıyla bir temeli genişleten bir temeli genişleten bir varlık (üç varlık, iki bağlantı) üçe ulaşmıştır.
Nasıl düzeltilir: Zincirin ortasını daraltın. Bu kadar derin bir zincir genellikle her katmanın az şey eklediği anlamına gelir; birkaç katmanı tek bir temel varlıkta birleştirmek hem çözümdür hem de daha anlaşılır bir yapıdır. Katmanlar gerçekten farklıysa, zincirin aşağısındaki bir varlık aradaki her katmandan kalıtım almak yerine köke daha yakın bir temeli doğrudan genişletebilir. Bu kadar derin bir Manifest zinciri genellikle ortam başına bir katman yığınıdır; kimsenin değiştirmediği katmanları üzerine bindirildikleri temelde birleştirin.
An assertion name is declared twice along an extends: chain (Bir doğrulama adı bir extends: zinciri boyunca iki kez bildirilmiş)
Bir varlık ve genişlettiği bir öğe aynı ad altında birer doğrulama bildiriyor ve ikisi farklı kurallar bildiriyor. Genişleten bir varlığın doğrulamaları temelinkilere eklenir, hiçbirinin yerini almaz. Dolayısıyla iki farklı kuralla iki kez bildirilen bir ad, temelin değişmezini sessizce devre dışı bırakırdı; bu da bir varlığı genişletmenin amacının tam tersidir.
Aynı adı özdeş kuralla bildirmek bir çakışma değildir ve derlenir. Denetimi zincir boyunca idempotent tutan budur: bu olmasaydı, üç derinlikli bir zincir her seferinde kendi orta katmanıyla çakışırdı.
Sıra rastlantısal değil, sözleşmenin bir parçasıdır. Doğrulamalar birleştirilmiş sırayla değerlendirilir ve başarısız olan ilk doğrulama derlemeyi durdurur; bu nedenle temelin değişmezi alt öğeninkinden önce denetlenir ve zincir boyunca küme kökten aşağıya doğru birikir.
Üretilen ileti:
assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (doğrulama adı extends zinciri boyunca iki kez bildirilmiş (Component <name>:<version>, kural assertions, .spec.assertions.<key> konumunda). “<key>” doğrulaması, farklı bir kural taşıyan temel Component “<base>” tarafından zaten bildirilmiş; genişleten varlığın doğrulamasını yeniden adlandırın; genişleten bir varlığın doğrulamaları temelinkilere eklenir ve hiçbirinin yerini almaz)
Nasıl düzeltilir: Genişleten varlığın doğrulamasını yeniden adlandırın; ileti bu doğrulamayı, onu zaten bildiren temelle birlikte adlandırır. Temelin kuralını değiştirmeyi amaçladıysanız, genişletme bunu desteklemez: temelin doğrulamasını, onu genişleten her varlık için geçerli olacak şekilde daraltın ya da kuralı gerçekten ihtiyaç duyan varlıklara taşıyın. İki kuralın aynı olması amaçlanıyorsa, onları metin olarak özdeş yapın; çakışma ortadan kalkar.
A Release chain’s links disagree about the routing shape (Bir Release zincirinin halkaları yönlendirme biçimi konusunda uyuşmuyor)
Bir Release, Aggregate’inin bileşenlerini iki yoldan biriyle yönlendirir: boundaries: altında adlandırılmış sınırlar veya components: altında üst düzey bileşenler. İkisi birbirini dışlar ve ikisini birden bildiren tek bir belge okunurken reddedilir. Bu durum, aynı kuralın bir extends: zinciri boyunca uygulanmasıdır: adlandırılmış sınırlar bildiren bir taban ile üst düzey bileşenler bildiren bir alt öğe tek başlarına iyi biçimlidir; iki seçimi tek bir çözümlenmiş Release’te bir araya getiren yalnızca onların birleştirilmesidir.
Belgelerin hiçbiri tek başına yanlış değildir; bu nedenle ileti ikisini de ve iki anahtarı da adlandırır. Yalnızca derlemenin işaret ettiği Release’i adlandıran bir tanılama sizi içinde hiçbir yanlış olmayan dosyaya gönderirdi.
Halkaları uyuşan bir zincir etkilenmez. Adlandırılmış sınırlar bildiren her halka normal şekilde birleşir; üst düzey bileşenler bildiren her halka da öyle. Duran yalnızca karışımdır.
Üretilen ileti; iki dosyayı ve her birinin bildirdiği anahtarı adlandırır:
release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (release extends zinciri hem adlandırılmış sınırları hem de üst düzey bileşenleri birleştiriyor: zincir boyunca tek bir yönlendirme biçimi bildirin, asla ikisini birden değil; Release dosyası, sınırları bildiren dosya ve bileşenleri bildiren dosya belirtilir)
Nasıl düzeltilir: zincirin kullanması gereken yönlendirme biçimini seçin ve onu baştan sona yazın. Taban adlandırılmış sınırlar bildiriyorsa, bileşenleri yapılandırmak isteyen bir alt öğe onlara Release kökünde değil, onları barındıran sınırın içinde başvurur — bu aynı zamanda topolojiyi yeniden belirtmeden bir bileşenin boyutlandırmasını değiştirmesini sağlar. Taban üst düzey bileşenler bildiriyorsa, adlandırılmış sınırlara ihtiyaç duyan bir alt öğe tabanından farklı bir yönlendirme biçimi tanımlıyordur ve o tabanın alt öğesi olarak değil, kendi Release’i olarak yazılması daha iyidir.
An external input’s URL uses a scheme that is not allowed (Bir dış girdinin URL’si izin verilmeyen bir şema kullanıyor)
Bir varlığın işaret ettiği URL, izin verilen kümenin dışında bir şema kullanıyor. Üç şemaya izin verilir: https; http, ancak yalnızca bir loopback ana makinesine, böylece şifrelenmemiş trafik yalnızca yerel makineye ulaşabilir; ve bir kayıt defterinden çekilen içerik için oci.
Loopback olmayan bir http URL’si ve diğer her şema için üretilen iletiler:
externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: URL: düz http yalnızca loopback ana makineleri için izinlidir (izin verilen şemalar: https, loopback ana makinesine http, oci): externalinputs: URL şemasına izin verilmiyor)
externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: URL: şemaya izin verilmiyor (izin verilen şemalar: https, loopback ana makinesine http, oci): externalinputs: URL şemasına izin verilmiyor)
Nasıl düzeltilir: URL’yi https’ye ya da içerik bir kayıt defterinde yayımlanmışsa oci’ye çevirin. Uzak bir ana makineye giden düz bir http URL’si düşürülmek yerine reddedilir, bu yüzden çözüm onu güvenli şemaya yönlendirmektir; loopback ana makinesine izin verildiği için yerel bir geliştirme sunucusu http üzerinden çalışmaya devam eder.
A render requests an external input the lockfile does not pin (Bir işleme, kilit dosyasının sabitlemediği bir dış girdi istiyor)
Bir derlemenin ihtiyaç duyduğu bir şey, kilit dosyasının sabitlemediği bir URL’den getiriliyor. Bir derleme, kilit dosyasının kaydettiği kapanışı işler ve hiçbir şey getirmez; bu nedenle bu çalıştırmanın URL’yi bunun yerine edinmesine izin verecek bir ayar yoktur: derlemeyi yeniden üretilebilir kılan dondurulmuş kapanıştır ve girdi kümesini sessizce genişletmek, yapmaması gereken tek şeydir.
Bu nedenle bu durdurmaya ulaşmak bir yapılandırma hatasından çok bilgi verir. Release çözümlendiğinde sabitlemeler eksiksizdi; dolayısıyla sabitlenmemiş bir URL, o zamandan beri bir şeyin değiştiği anlamına gelir: bir işlemenin hangi başvuruları isteyeceğini yönlendiren bir değer, yeni bir yere işaret etmeye başlayan bir chart ya da farklı bir Release’e göre çözümlenmiş bir kilit dosyası.
Üretilen ileti:
"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (URL lockfile’da sabitlenmemiş; bu Release’in render işleminin tükettiği her dış girdiyi sabitlemek için aggrega pull —release komutunu çalıştırın, ardından yeniden derleyin: externalinputs: sabitlenmemiş girdiler için edinme devre dışı)
Nasıl düzeltilir: girdiyi sabitleyin. aggrega pull --release <path>, hangi dış girdileri tükettiğini bulmak için Release’i işler, her birini getirir ve özetini kilit dosyasına bağımlılık sabitlemelerinin yanına kaydeder; bundan sonra her derleme onu sabitlenmiş kayıttan sunar ve hiç ağa ihtiyaç duymaz. URL, yazdığınız bir şey ona işaret etmeye başladığı için yeniyse, atlanan adım Release’i yeniden çözümlemektir; beklenmedikse, onu sabitlemeden önce onu getiren başvuruyu bulmaya değer.
Fetched bytes do not match a pinned digest (Getirilen baytlar sabitlenmiş bir özetle eşleşmiyor)
Sabitlenmiş bir URL, saklanan kopyası eksik olduğu için yeniden getirildi ve dönen içerik kilit dosyasının sabitlediği değil. Kaydedilen özet her zaman kazanır: depoya hiçbir şey yazılmaz ve hiçbir bayt döndürülmez.
Yeniden doldurma, URL’nin etiketiyle değil kaydedilen özetle getirilir; bu nedenle farklı içeriğe işaret edecek şekilde taşınmış bir etiket, sabitlenmiş bir girdinin sunduğunu değiştiremez. Dolayısıyla bu durdurmaya ulaşmak, özetin arkasındaki içeriğin kendisinin bozulmadan geri gelemediği anlamına gelir.
Bir kayıt defterinden çekilen içerik ve HTTPS üzerinden getirilen içerik için üretilen iletiler:
externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: URL: yeniden doldurulan manifest özeti, sabitlenmiş özetten farklı: externalinputs: getirilen baytlar sabitlenmiş özetle eşleşmiyor)
externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: URL: yeniden getirilen baytların özeti, sabitlenmiş özetten farklı: externalinputs: getirilen baytlar sabitlenmiş özetle eşleşmiyor)
Nasıl düzeltilir: bunu, yenilenecek bir kilit dosyası olarak değil, önce bir tedarik zinciri sorusu olarak ele alın: sabitleme, derlediğiniz şeyin tam olarak bu baytlar olduğu beyanıdır ve ret bu beyanın geçerliliğini korumasıdır. Kaynağın özetin adlandırdığı içeriği hâlâ yayımladığını doğrulayın ve sizinle kaynak arasındaki bir şeyin yanıtları yeniden yazıp yazmadığını denetleyin; yerine başka içerik sunan bir proxy ya da yansı yaygın bir nedendir. Ancak neyin değiştiğini bilip bunu kabul ettiğinizde, yeni özeti kaydeden aggrega pull ile yeniden sabitleyin.
A stored external input no longer matches its record (Saklanan bir dış girdi artık kaydıyla eşleşmiyor)
Sabitlenmiş bir girdi yerel depodan geri okundu ve onun için sabitlenmiş kayıtla eşleşmiyor. Denetim, baytlar sunulmadan önce her okumada çalışır; böylece bozulmuş ya da kurcalanmış bir depo, bir derlemeyi sessizce beslemek yerine kullanım noktasında ortaya çıkar.
Neyin karşılaştırıldığı, girdinin nasıl sabitlendiğine bağlıdır. HTTPS üzerinden getirilen içerik, yükün özeti alınarak sabitlenir; bu yüzden her okumada yeniden özetlenir ve iki özet de raporlanır. Bir kayıt defterinden çekilen içerik, yükü doğrudan özetleyerek değil kayıt defterinin kendi manifest’i aracılığıyla bağlayan manifest özetiyle sabitlenir; bu yüzden saklanan kopya kaydedilen boyuta göre denetlenir; tam özet doğrulaması bunun yerine edinimde ve özetle adreslenen her yeniden doldurmada yapılır.
Üretilen iletiler:
externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: URL: depodaki blob’un sha256 değeri sabitlenmiş özetten farklı: externalinputs: depodaki blob sabitlenmiş kaydıyla eşleşmiyor)
externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: URL: depodaki blob’un boyutu sabitlenmiş kayıttaki boyuttan farklı: externalinputs: depodaki blob sabitlenmiş kaydıyla eşleşmiyor)
Nasıl düzeltilir: sorunlu blob’u depodan silin ve bir sonraki çalıştırmanın onu kaynaktan yeniden doldurmasına izin verin; bu içerik, herhangi bir şey yazılmadan önce kaydedilen özete göre doğrulanır. Ardından yeniden doldurma da bir özet uyuşmazlığı bildirirse, anlaşmazlık yerel değil yukarı akıştadır ve okunması gereken yukarıdaki girdidir. Makineler arasında paylaşılan bir depo ya da yazma ortasında alınmış bir yedekten geri yüklenen bir depo, olağan yerel nedendir.
A guard needs a catalog entity the build resolved and cannot see (Bir koruyucu, derlemenin çözümlediği ancak göremediği bir katalog varlığına ihtiyaç duyuyor)
Anlamsal bir koruyucu, bir bileşenin türünün arkasındaki katalog varlığına ulaşmaya çalıştı ve varlık, koruyucuya verilen görünümde yok; oysa çözümleme bu türü bir katalog başvurusu olarak çözümlemişti. Gerçekten çözümlenemeyen bir başvuru daha önce, çözümlemede durur; bu yüzden varlık eksikken bir koruyucuya ulaşmak, derlemenin çözümlenmiş kümesi ile koruyucunun görünümünün birbirinden ayrıldığı anlamına gelir.
Derleme, koruyucuyu atlamak yerine durur. Atlamak, bir denetimi ortadan kalktığını söyleyecek hiçbir şey olmadan devre dışı bırakırdı ve koruyucunun ilgilendiği bileşenler, derleme başarı bildirirken incelenmeden geçerdi.
Göreli yol olarak yazılmış bir tür (./ ya da ../ ile başlayan) burada değerlendirilmez: bir tür hiçbir zaman dosya olarak okunmaz; bu nedenle böyle bir değer hiçbir katalog varlığını adlandırmaz ve daha önce, Release’in bağımlılıkları çözümlenirken, hiçbir kataloğun tutmadığı bir başvuru olarak reddedilir. Bu durdurmaya yalnızca yalın simgeli bir katalog başvurusu ulaşır.
Koşul nerede karşılanırsa karşılansın aynı sözcüklerle raporlanır; bu yüzden metin, onu tetikleyen denetimi değil türü ve hatayı adlandırır.
Ayrıca hiçbir belgeyi ve belge içindeki hiçbir anahtarı adlandırmaz; bu kasıtlıdır ve bu durdurmanın diğer tüm durdurmalardan farklı okunduğu tek yerdir. Diğer her durdurma, kendini onu gidermek için düzenleyeceğiniz dosya ve alan üzerinde konumlandırır; burada böyle bir dosya yoktur, bu nedenle bir konum sizi hatalı olmayan bir anahtara gönderirdi. Bunun yerine iki görünümün üzerinde anlaşamadığı tür raporlanır, çünkü ayrışmayı araştıran kişi için yeniden üretilebilir kılan budur.
Üretilen ileti:
the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (derleyicinin kataloğa ilişkin kendi görünümleri uyuşmuyor (iç hata: bu derleme, okuduğu kataloğun o sırada hiçbir kaydını tutmadığı bir bileşen türünü çözümledi. Bu, yazılmış bir belgedeki değil derleyicideki bir hatadır; dolayısıyla Aggregate’te, Release’te veya katalogda düzeltilecek bir şey yoktur. Lütfen bu derlemeyi üreten komutu ve görünümlerin uyuşmadığı türü belirterek bildirin))
Nasıl düzeltilir: kendi dosyalarınızda hiçbir şey; bu, yazdığınız şeydeki bir hatayı değil derleyici içindeki bir tutarsızlığı raporlar ve iletinin adlandırdığı türle birlikte bir kusur olarak raporlanmaya değer. Bileşenin türü büyük olasılıkla sorunsuzdur.
A reference names no entity the catalog holds (Bir başvuru, kataloğun tuttuğu hiçbir varlığı adlandırmıyor)
Bir derleme herhangi bir şey işlemeden önce, bir Release’in bağımlı olduğu varlık kümesinin tamamı dolaşılır ve her biri sabitlenir; böylece kilit dosyası derlemenin okuyacağı şeyi tam olarak kaydeder. Kataloğun yanıtlayamadığı bir başvuru bu dolaşmayı durdurur: onun için hiçbir şey sabitlenemez ve devam etmek, derlemenin daha sonra ihtiyaç duyacağı bir girdisi eksik olan bir kilit dosyasını, bunu belirten hiçbir şey olmadan yazmak anlamına gelir.
Ret, başvuruyu ve nerede toplandığını adlandırır; çünkü bir varlığa birçok yerden ulaşılır ve onu adlandıran yer, düzeltmenin yapılacağı yerdir. Bir kütüphane başvurusu, toplama yolu olmadan tek başına raporlanır: bir kütüphaneye onu $ref veya $import ile kullanan varlıklardan ulaşılır ve hatanın tamamı başarısız olan addır.
Bir katalog varlığı için üretilen ileti; sondaki kısım ona başvuran yerleri listeler:
resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: katalogdaki hiçbir varlık bu URI ile eşleşmiyor: varlığa, belirtilen yollardan başvurulmuş)
bir kütüphane için:
resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: katalogdaki hiçbir varlık bu URI ile eşleşmiyor: kitaplık)
ve bir provider soketine bağlanmış, bir katalog belgesiyle değil onu taşıyan çalışma alanı yapılandırma anahtarıyla adlandırılan bir plugin için:
resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: katalogdaki hiçbir varlık bu URI ile eşleşmiyor: varlığa .aggrega-config.yaml.plugins.providers konumundan başvurulmuş)
Katalog dizinleri altındaki bir dosya, başvurunun istediği adı hiçbir kataloğun tutmadığı bir tür altında bildirdiğinde — örneğin yanlış yazılmış bir kind — bu hatanın altındaki not o dosyayı, bildirdiği türü ve bir kataloğun tuttuğu türleri adlandırır ve yerel varlıkların nereden okunduğuna ilişkin öneriyi dışarıda bırakır; bu, kilit dosyasını dolduran bir derlemede de onu okuyan bir derlemede de ve bu hatayı raporlayan diğer her yüzeyde de böyledir; bkz. Reddedilen bir katalog dosyası ve açıkladığı hata.
Nasıl düzeltilir: başvuruyu tam olarak iletinin alıntıladığı şekilde okuyun. Var olmayan bir ad, hiç yayımlanmamış bir sürüm ve çalışma alanının kayıt defterine hiç yönlendirilmediği yalın bir ad buraya aynı biçimde ulaşır; bu nedenle üçünü bu sırayla denetleyin: yazımı düzeltin; sürümün var olduğunu doğrulayın; onu tutan kayıt defterinin yapılandırılmış ve erişilebilir olduğunu doğrulayın. Varlık yerel olarak sizin yazdığınız bir varlıksa, dosyanın derlemenin dolaştığı kataloğun içinde olduğunu doğrulayın.
aggrega pull ya da aggrega build --auto-pull, yapıt önbelleği hiçbir lockfile girdisinin sabitlemediği ve hiçbir katalog dizininin sağlamadığı bir SchemaLibrary tutarken bir kütüphane başvurusunda durduğunda, iletinin ardından bu tür her kütüphaneyi belirten bir remediation: satırı gelir. Önbellekteki bir kütüphane, yalnızca bir lockfile girdisi onun özetine kefil olduğunda katalog içeriği sayılır ve pull bu girdiyi kütüphaneyi sunan kayıt defterinden kaydeder. Çevrimdışı duruşta pull ne kütüphaneyi getirebilir ne de onun için bir girdi kaydedebilir; bu nedenle satır, bir kayıt defterine erişilebilen yerde aggrega pull --release <release> çalıştırmayı ya da kütüphaneyi bir katalog dizini altında yazmayı söyler. Bağlıyken, pull’un okuduğu hiçbir katalog dizini veya kayıt defteri kütüphaneyi sunmaz; bu nedenle kaydedilecek bir girdi yoktur ve satır kütüphaneyi bir katalog dizini altında yazmayı gösterir.
A library reference is not written in the identity form (Bir kütüphane başvurusu kimlik biçiminde yazılmamış)
Kütüphaneler arası bir $ref: veya $import:, kütüphaneyi kimliğiyle ve ardından içindeki girdiyi adlandırır: kütüphanenin yalın adı, isteğe bağlı olarak bir : ve bir alt sürüm sınırı, ardından # ve alanın okuduğu yüzeydeki girdinin yolu. Bu biçimde kayıt defteri ana bilgisayarı yoktur. Bir adın hangi kayıt defteri üzerinden çözümleneceği çalışma alanı yapılandırmasıdır ve bir derlemenin hangi sürümü kullanacağı kilit dosyasının yanıtıdır; bu nedenle bunlardan birini taşıyan bir başvuru, derlemenin karar vermesi gereken bir şeyi belgede sabitlemiş olur.
Burada reddedilenler: kayıt defteri ana bilgisayarı taşıyan bir değer; kütüphaneler arası bir başvuru beklenen yere yazılmış belge içi bir çapa; boş bir kütüphane adı; ve sürüm ayırıcısı olarak yazılmış @. Sonuncusu genel bir biçim şikâyeti olarak değil düzeltilmiş yazımla raporlanır, çünkü bu biçimde en sık yapılan hata budur.
Üretilen ileti:
resolve: invalid library reference URI: "<the value as written>" (resolve: geçersiz kitaplık başvurusu URI’si)
ve ayırıcı olarak @ kullanıldığında, değerin bunun yerine ne olması gerektiğini alıntılayarak:
resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: geçersiz kitaplık başvurusu URI’si: sürüm ayırıcısı ’@’ değil ’:’ — düzeltilmiş değeri kullanın)
Nasıl düzeltilir: değeri <Library>#<entry-path> olarak yeniden yazın; kütüphane adından sonra :<version> ekini yalnızca hangi sürümün seçilebileceğine bir alt sınır koymanız gerektiğinde ekleyin. Kayıt defteri ana bilgisayarlarını kaldırın. Başvuru aynı belgenin içini göstermek için yazıldıysa, belge içi çapa kütüphane başvurusundan farklı bir şeydir ve onu yazdığınız alan kütüphane biçimini bekler.
Two consumers of one library require incompatible versions (Bir kütüphanenin iki tüketicisi uyumsuz sürümler gerektiriyor)
Birkaç varlık aynı kütüphaneye başvurabilir; her biri bir alt sürüm sınırı belirtir ya da hiç belirtmez ve derlemenin seçtiği sürüm, bunlardan herhangi birinin belirttiği en yüksek sınırdır. Daha azını isteyen bir tüketicinin yine de kendisini karşılayan bir sürüm almasını sağlayan budur; daha yüksek sınırlı bir tüketici eklemenin derlemeyi iki kopyaya bölmek yerine herkesi yukarı taşımasının nedeni de budur.
Bu kural yalnızca sınırlar baştaki sürüm numarasında uyuştuğu sürece geçerlidir. Farklı ana sürümler belirten iki tüketici, aynı adı paylaşan iki ayrı kütüphane istemektedir ve hiçbir tek seçim ikisini birden karşılamaz; bu yüzden birini seçip diğer tüketicinin kendisi için yazılmadığı bir biçimi okumasına izin vermek yerine derleme durur ve uyuşmazlığı adlandırır. Sınır belirtmeyen bir tüketici burada hiçbir şeye katılmaz: seçimi sabitleme yapan tüketiciler belirler.
Üretilen ileti. Tüketiciler sıralı düzende karşılaştırılır: sınır belirten ilk tüketici ana sürümü belirler ve ileti, sınırı farklı bir ana sürüm belirten ilk tüketici de dahil olmak üzere karşılaştırılan her tüketiciyi gerektirdiği sürümle birlikte listeler; böylece aynı belgeler her zaman aynı tüketicileri adlandırır:
resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (resolve: en küçük sürüm seçimi çakışması — uyumsuz kitaplık sürümü gereksinimleri: kitaplığın uyumsuz ana sürümler gerektiren tüketicileri var)
Nasıl düzeltilir: alt tüketicinin sınırını aynı ana sürüme yükseltin; daha yeni biçim herkesin istediği şey olduğunda olağan yanıt budur. Her iki ana sürüme gerçekten aynı anda ihtiyaç varsa, bunlar iki ayrı kütüphanedir: eski biçimi kendine ait bir adla yayımlayın ve ona ihtiyaç duyan tüketiciyi oraya yönlendirin; böylece her başvuru kendisi için yazıldığı şeyi adlandırır.
The chain of module imports is deeper than the pin walk descends (Modül içe aktarma zinciri, sabitleme dolaşmasının indiği derinlikten daha derin)
Sabitleme, bir Aggregate’in içe aktardığı her modülü, ardından bunların içe aktardığı her modülü dolaşır; böylece yalnızca ilk düzey değil kümenin tamamı kilit dosyasına ulaşır. Zaten kaydedilmiş bir modül ikinci kez dolaşılmaz; olağan bir döngüyü sonlandıran budur: kendisini geri içe aktaran bir modülü içe aktaran bir Aggregate, her birini bir kez kaydederek şikâyet olmadan sonlanır.
On düzeylik bir derinlik sınırı, yineleme algılamanın göremediği zinciri yakalar: her adımda yeni bir sürümle yeniden yayımlanan bir modülde olduğu gibi, her düzeyde yeni bir kimlik sunan zincir. Bu sınır, graf oluşturucunun uyguladığı sınırın aynısıdır; böylece sabitlenebilen bir bileşim aynı zamanda derlenebilen bir bileşimdir.
Üretilen ileti:
resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (resolve: alt aggregate dahil etme derinliği aşıldı)
Nasıl düzeltilir: zinciri kısaltın. Bu kadar derin bir zincir genellikle dağıtımın değil kuruluşun nasıl düzenlendiğini yansıtır; bu nedenle kendine ait hiçbir bileşen katmayan düzeyleri arayın ve bunları üst düzeylerine katlayın. Her düzey yalnızca altındaki düzeyi yeni bir sürümle yeniden yayımlamak için varsa, zinciri oluşturan sürümlerdir: gerçekten istediğiniz modülü, istediğiniz sürümde doğrudan içe aktarın.
Bu, sabitleme dolaşmasının sınırıdır. Graf oluşturucu kendi sınırını uygular ve bu aşağıda “Sub-aggregate nesting depth exceeded” altında raporlanır; ikisi, aynı sınıra iki noktada ulaşılmasının ayrı raporlarıdır: ilki kilit dosyası doldurulurken, ikincisi graf oluşturulurken.
The catalog view a build was given cannot load the bodies pinning needs (Bir derlemeye verilen katalog görünümü, sabitlemenin ihtiyaç duyduğu gövdeleri yükleyemiyor)
Sabitlemenin dolaştığı eksenlerden ikisi, katalogdan bir sürüm yanıtından fazlasına ihtiyaç duyar: belgelerin kendilerine ihtiyaç duyarlar. Bir Aggregate’in içe aktardığı modüller, onların sırayla neyi içe aktardığını bulmak için okunmalıdır. Bir derlemenin bağladığı Recipes, FeatureRecipes ve Plugins, onların adlandırdığı yapıtları ve kütüphaneleri bulmak için okunmalıdır. Bir sürümü çözümleyebilen ama bu gövdeleri geri veremeyen bir katalog görünümü, her iki ekseni de okunacak hiçbir şey olmadan bırakır.
Her ikisi de atlanmak yerine en baştan reddedilir ve nedeni, atlamanın üreteceği sonuçtur: bütün bir girdi sınıfı eksik, şikâyet olmadan yazılmış, sonraki bir derlemenin aslına uygun şekilde yeniden kurup eksik bulduğu bir kilit dosyası. İletilerin hiçbiri kendine ait değer taşımaz, çünkü hiçbiri sizin yazdığınız bir belgeyle ilgili değildir; her biri hangi eksenin hesaplanamadığını belirtir:
Nasıl düzeltilir: dosyalarınızdaki hiçbir şey bunlardan birini üretmez ve birini gideren bir yazım değişikliği yoktur; hata, derlemeden ne istendiğinde değil derlemenin nasıl bağlandığındadır. Çalıştırdığınız komutu ve komutun çalıştığı çalışma alanı yapılandırmasını belirterek raporlayın.
An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Bir annotation-transform eklentisi kendisine verilmemiş bir bileşeni adlandırıyor veya hiçbir annotation’ın kabul etmediği bir değer enjekte ediyor)
Bir operatör, annotation ekleyen bir rolde bir yönetişim eklentisi bağlayabilir ve bu bağlama bir bildirimdir: dönüşümü operatör istemiştir, dolayısıyla eklentinin ekledikleri kimseden habersiz enjekte edilmiş değil, açıkça istenmiştir. Rol de buna uygun biçimde sınırlandırılmıştır. Eklentiye belgelerinizin bildirdiği bileşen koordinatları verilir ve eklenti bunlara annotation’lar ekleyebilir; her biri, o annotation’a kendinizin de yazabileceği bir değer taşır: bir dize ya da alt anahtarlardan oluşan bir nesne. Döndürdüğü biçim başka hiçbir alana izin vermez; bu yüzden çıktısı uygulanırken denetlenecek olan, her enjeksiyonun kendisine verilen bir koordinatı adlandırıp adlandırmadığı ve her değerin bir annotation’ın kabul ettiği bir değer olup olmadığıdır.
Bu kümenin dışındaki bir sınır ve bileşen çiftini adlandıran bir enjeksiyon derlemeyi durdurur. Belgelerinizin hiç açığa çıkarmadığı bir bileşene uzanan bir eklenti, kimsenin bildirmediği altyapıyı yapılandırıyor olurdu; eklediği annotation’lar da tam olarak yazılmış olanlar gibi Feature bağlamalarına genişletildiğinden, sonuç operatörün eklentinin önüne koymadığı bir bileşenden kaynakların ortaya çıkması olurdu.
Değeri null, bir liste, bir sayı, bir boolean ya da alt anahtarı olmayan bir nesne olan bir enjeksiyon da derlemeyi durdurur. Null ve boş bir nesne, bir bileşeni devralacağı bir annotation’dan çıkarmak için yazdığınız değer olarak okunur; bu rol ise annotation ekler, kaldırmaz; diğer biçimler bir annotation’ın kabul ettiği değerler değildir. Çıktının tamamı, herhangi bir kısmı uygulanmadan önce denetlenir; bu yüzden reddedilen bir çıktı hiçbir şeyi değiştirmez.
Kabul edilen her enjeksiyon, onu yapan eklentiyi adlandıran aggrega.ai/injected-by adlı eşlik eden bir annotation da taşır. Bu annotation’ı host yazar; eklenti bunu sağlayamaz, dolayısıyla enjekte edilen bir annotation’ın nereden geldiği konusunda söyledikleri eklentinin biçimlendirebileceği bir şey değildir.
Eklentiye verilmemiş bir koordinat ve hiçbir annotation’ın kabul etmediği bir değer için verilen ileti:
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: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (annotation-transform eklentisinin çıktısı reddedildi: bir enjeksiyon, ana bilgisayarın sağlamadığı bir bileşen koordinatını hedefliyor ya da dize veya alt anahtarlardan oluşan nesne olmayan bir değer taşıyor: enjeksiyon belirtilen sınırdaki belirtilen bileşeni hedefliyor (belirtilen annotation)) 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: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (annotation-transform eklentisinin çıktısı reddedildi: bir enjeksiyon, ana bilgisayarın sağlamadığı bir bileşen koordinatını hedefliyor ya da dize veya alt anahtarlardan oluşan nesne olmayan bir değer taşıyor: belirtilen sınırdaki belirtilen bileşen için enjeksiyon (belirtilen annotation) bir liste taşıyor; enjekte edilen bir annotation değeri bir dize ya da alt anahtarlardan oluşan bir nesnedir)
Nasıl düzeltilir: hata belgelerinizde değil eklentidedir — eklentiyi yalnızca kendisine verilen ve her biri girdisinde gelen koordinatlara, değer olarak da yalnızca bir dize ya da alt anahtarlardan oluşan bir nesne enjekte edecek biçimde düzeltin. İletideki bileşen, eklentinin görmesini beklediğiniz bir bileşense, Release’in onu bir sınırın içinde bildirdiğini denetleyin: yalnızca bildirilmiş bileşen koordinatları aktarılır. Eklenti düzeltilirken bir derlemenin önünü açmanın hemen uygulanabilecek yolu, bağlamayı plugins.governance içinden kaldırmaktır.
A plugin reference is not a Plugin entity (Bir eklenti başvurusu bir Plugin varlığı değil)
Bir eklentiye, her zaman eklentinin kendi soket türüyle kapsamlandırılmış Plugin varlığı üzerinden başvurulur: <pluginType>/<name>, isteğe bağlı olarak bir sürümle, parser/yaml veya parser/yaml:1.0.0 örneklerinde olduğu gibi. Kapsam birkaç biçimden biri değil, zorunludur — kapsamsız bir name:version reddedilir, çünkü iki soket aynı adlı bir eklenti barındırabilir ve varlığı çözümlenebilir kılan kapsamdır. Varlığın işaret ettiği ikili dosyaya varlık üzerinden ulaşılır, hiçbir zaman doğrudan adlandırılmaz; dolayısıyla yetenek iddiasını, çalışma zamanı sınırlarını ve yüklemenin ikili dosyayı karşılaştırdığı kayıtlı komut kümesini taşıyan varlıktır. Bu nedenle hiçbir Plugin varlığını adlandırmayan bir başvurunun ikili dosyayı karşılaştıracağı bir şey yoktur ve derleme, denetlenmemiş bir başvuruyla baytları yüklemek yerine durur.
Burada iki biçim raporlanır ve bunlar farklı anlarda denetlenir. Biçimi bir varlık olamayan bir başvuru — bir dosya sistemi yolu ya da oci:// URL’si, yalın bir .wasm veya bir @sha256: özeti gibi bir yapıt başvurusu — yalnızca varlık başvurusu kabul eden yüzeylerde en başta reddedilir. Hiçbir yerin barındırmadığı bir varlığı adlandıran bir başvuru ise aramadan sonra reddedilir ve iletinin ne söylediği başvurunun nasıl yazıldığına bağlıdır: bir Plugin varlık URI’si — <pluginType>/<name>, isteğe bağlı olarak sürümlü — hiçbir katalog dizininin barındırmadığı, ikili dosyanın taşımadığı ve hiçbir pull’un getirmediği bir varlık olarak raporlanır; başka her başvuruya ise bu biçimi alması söylenir. Her iki biçim de aynı koşulu raporlar, dolayısıyla bir derlemenin ikisine verdiği yanıt aynıdır.
Bir pull, ikinci biçimi bir derleme onunla karşılaşmadan önce reddeder. Bir Recipe’in veya FeatureRecipe’in pipeline alanının adlandırdığı her Plugin, Release’in diğer bağımlılıklarıyla birlikte çözümlenir — bir katalog dizininden, derleyici ikili dosyasının içindeki kopyadan, içerik önbelleğinden veya bir registry’den — ve bunların hiçbirinin barındırmadığı biri, aggrega pull komutunu lockfile’ı yazmadan önce bu koşulla ve aynı iletiyle durdurur; ileti, pipeline’ı onu adlandıran Recipe’i veya FeatureRecipe’i adlandırır.
Her yüzey varlık olmayan bir biçimi reddetmez. Pipeline eklentisi yüzeyi yalnızca varlık başvurularını kabul eder; bir operatörün bir eklentiyi doğrudan bağladığı yüzeyler ise her biçimi kabul eder ve varlık olmayan bir başvuruyu bir yapıt olarak çözümlenmek üzere iletir. Dolayısıyla aynı başvuru bir bağlama noktasında kabul edilip başka birinde reddedilebilir ve bu fark başvurudan değil yüzeyden kaynaklanır.
Üretilen iletiler. Bir dosya sistemi yolu:
plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (eklenti başvurusu bir Plugin varlığı değil: <reference> bir dosya sistemi yoludur, ancak bir işlem hattı eklentisi eklenti türüyle kapsamlanmış bir Plugin varlık URI’si olmalıdır (<pluginType>/<name>, isteğe bağlı olarak sürümlü; örneğin parser/yaml veya parser/yaml:1.0.0))
bir yapıt başvurusu:
plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (eklenti başvurusu bir Plugin varlığı değil: <reference> bir yapıt başvurusudur (bir oci:// şeması, yalın bir .wasm veya bir @sha256: özeti), ancak bir işlem hattı eklentisi eklenti türüyle kapsamlanmış bir Plugin varlık URI’si olmalıdır (<pluginType>/<name>, isteğe bağlı olarak sürümlü; örneğin parser/yaml veya parser/yaml:1.0.0))
hiçbir yerin barındırmadığı bir Plugin varlık URI’si:
plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (eklenti başvurusu bir Plugin varlığı değil: <reference> bir Plugin varlık URI’sidir, ancak adlandırdığı varlığı hiçbir katalog dizini barındırmıyor, ikili dosya onu taşımıyor ve hiçbir çekme işlemi onu içerik önbelleğine getirmemiş; Plugin varlığını bir katalog dizinine yerleştirin ya da bir kayıt defterinde yayımlayıp aggrega pull komutunu çalıştırın)
ve hiçbir varlığı adlandırmayan başka her başvuru — eklenti türü kapsamı olmayan, sürümünden önce birden fazla / içeren veya bir registry host’u taşıyan:
plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (eklenti başvurusu bir Plugin varlığı değil: <reference> eklenti türüyle kapsamlanmış bir Plugin varlık URI’si olmalıdır (<pluginType>/<name>, isteğe bağlı olarak sürümlü; örneğin parser/yaml veya parser/yaml:1.0.0); yalın bir .wasm başvurusu veya bir yapıt başvurusu hiçbir Plugin varlığını adlandırmaz)
Nasıl düzeltilir: başvuruyu Plugin varlığının soket türüyle kapsamlandırılmış kimliği olarak, isteğe bağlı olarak sürümüyle yazın — <pluginType>/<name> veya <pluginType>/<name>:<version>. Doğrudan bir dosyaya veya yapıta işaret ediyorsanız, onun için bir Plugin varlığı yayımlayın ya da yazın ve bunun yerine ona başvurun — yüklemenin denetlediği iddialar varlıkta bulunur, dolayısıyla onu atlayan eşdeğer bir biçim yoktur. İleti başvurunun bir Plugin varlık URI’si olduğunu söylüyorsa biçim doğrudur ve eksik olan varlıktır: Plugin varlığını, derlenmiş .wasm dosyası yanında olacak şekilde çalışma alanının listelediği bir katalog dizinine yerleştirin ya da eklentiyi çalışma alanının okuduğu bir registry’ye yayımlayıp onu içerik önbelleğine getiren aggrega pull komutunu çalıştırın — ve adlandırdığınız sürümün var olan bir sürüm olduğunu denetleyin.
A cached signature bundle does not match the digest recorded for it (Önbellekteki bir imza paketi, kendisi için kaydedilen özetle eşleşmiyor)
İmzası getirildiğinde doğrulanmış bir yapıt, bu olguyu lockfile girdisinde — ya da bir karar rolünde eklenmiş bir plugin için plugins-trust.yaml içindeki girdisinde — imza malzemesinin kaydedilmiş bir özeti olarak taşır; bu malzeme yapıtın yanında önbelleğe alınır. Herhangi bir şey işlenmeden önce derleme, okuduğu ve böyle bir kayıt taşıyan her girdi için — her türden bir katalog varlığı, bir kütüphane, bir plugin — önbellekteki bu malzemeyi yeniden okur ve yeniden hash’ler; hash’in kaydedilmiş olanla aynı olması gerekir. Lockfile’ın sabitlediği bir plugin’in ve bir karar rolünde eklenmiş bir plugin’in malzemesi, baytları yüklendiğinde yeniden denetlenir; bu da bir plugin’i derleme dışında yükleyen komutlara — aralarında aggrega lint --release ve aggrega validate --release — ulaşan denetimdir. Eksik, okunamayan ya da başka bir değere hash’lenen bir paket, gözden geçirilmiş malzemenin şu anda diskte olan malzeme olmadığı anlamına gelir ve çalıştırma, imza kanıtı kaydın altında değişmiş bir yapıtı kullanmak yerine durur.
Yeniden denetim bir hash karşılaştırmasıdır, fazlası değil. Hiçbir imzayı yeniden doğrulamaz, ağa bağlanmaz ve hiçbir güven malzemesine başvurmaz; bu nedenle hiç ağ erişimi olmayan bir derlemede de geçerlidir — bir kez doğrulanmış bir yapıtın sonraki çevrimdışı derlemelerde de doğrulanmış kalmasını sağlayan budur.
Sonraki pull bunu onarır. Bir pull, içerik önbelleğinin sunduğu her girdiyi aynı denetime tabi tutar ve denetimin bir girdiyi reddettiği yerde, imzalama gereksinimi ne derse desin, yapıtın registry’sine imzayı yeniden sorar — getirdiği bir yapıtın geçtiği doğrulamanın aynısıyla —, bunun doğruladığını girdiye kaydeder ve adını verdiği paketi önbelleğe alır; özetiyle artık eşleşmeyen önbellekteki bir kopyanın üzerine yazar. Bir karar rolünde eklenmiş bir plugin, girdisi ne kaydederse kaydetsin her pull’da yeniden doğrulanır ve paketi aynı şekilde önbelleğe alınır. Bu nedenle içerik önbelleğinin sunduğu bir girdinin iletisi o pull’u adlandırır. Bir katalog dizininden, derleyici ikilisinin içindeki kopyadan ya da Release’in yanından okunan bir girdi hiçbir zaman bir registry’ye sorulmaz; bu yüzden bir pull, üzerine kaydedilmiş bir imzayı olduğu gibi bırakır ve iletisi hiçbir pull adlandırmaz.
Üretilen iletiler; yapıtı, önbellekteki dosyayı ve — içerik önbelleğinin sunduğu bir girdi için — bunu onaran pull’u, imzayı kaydettiği dosyayı ve çektiği Release’i adlandırır. Derlemenin denetiminden, okunamayan ya da bulunmayan:
artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (yapıt “<reference>”: önbellekteki imza paketi <path> okunamıyor: önbellekteki imza paketi kaydedilmiş özetiyle eşleşmiyor. çözüm: yapıtın imzasını registry’sinde yeniden doğrulamak, <file> içine kaydetmek ve adını verdiği paketi önbelleğe almak için aggrega pull —release <release> komutunu çalıştırın)
ve kaymış:
artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (yapıt “<reference>”: önbellekteki imza paketi <path> özeti <actual>, kaydedilmiş özet <recorded>: önbellekteki imza paketi kaydedilmiş özetiyle eşleşmiyor. çözüm: yapıtın imzasını registry’sinde yeniden doğrulamak, <file> içine kaydetmek ve adını verdiği paketi önbelleğe almak için aggrega pull —release <release> komutunu çalıştırın)
ve bir plugin’in baytlarının içerik önbelleğinden yüklendiği yerde, nereden geldiklerini de adlandırarak:
plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (<source> kaynağından çözümlenen plugin “<reference>”: önbellekteki imza paketi <path> okunamıyor: önbellekteki imza paketi kaydedilmiş özetiyle eşleşmiyor. çözüm: yapıtın imzasını registry’sinde yeniden doğrulamak, <file> içine kaydetmek ve adını verdiği paketi önbelleğe almak için aggrega pull —release <release> komutunu çalıştırın)
plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (<source> kaynağından çözümlenen plugin “<reference>”: önbellekteki imza paketi <path> özeti <actual>, kaydedilmiş özet <recorded>: önbellekteki imza paketi kaydedilmiş özetiyle eşleşmiyor. çözüm: yapıtın imzasını registry’sinde yeniden doğrulamak, <file> içine kaydetmek ve adını verdiği paketi önbelleğe almak için aggrega pull —release <release> komutunu çalıştırın)
<file>, Release’in lockfile’ı ya da Release’in dizinindeki plugins-trust.yaml dosyasıdır. Hiçbir pull’un sormadığı bir girdi için ileti remediation: öncesinde biter.
Soracak registry’si olmayan bir pull bunun yerine durur. Bir katalog varlığı ya da bir kütüphane registry belirtilmeden adlandırılır ve çalışma alanının default_registry ayarıyla bir registry’ye bağlanır. Çalışma alanı hiçbirini adlandırmıyorsa — imza kaydedildiğinde adlandırıyordu, artık adlandırmıyor — girdiyi yeniden sormak için yapılandırılmış bir registry yoktur; bu yüzden pull, sonraki derlemenin reddedeceği bir lockfile yazmak yerine bu koşulla durur ve lockfile’ı olduğu gibi bırakır. İletisi, pull’un attığı adımdan sonra şunu taşır:
verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (doğrulama: “<reference>” bir derlemenin kabul etmediği bir imza kaydediyor ve bunu yeniden sormak için yapılandırılmış bir registry yok: önbellekteki imza paketi <path> okunamıyor: önbellekteki imza paketi kaydedilmiş özetiyle eşleşmiyor)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz; önbellek sizin değil, derlemenindir. İletinin adını verdiği komut olan aggrega pull --release <release> komutunu çalıştırın: bu komut yapıtın imzasını yeniden doğrular ve imzayı ile paketini birlikte yazar; böylece paketi önbelleğe alan çekme işleminden bu yana kaldırılmış veya değiştirilmiş bir paket onarılır. Çevrimdışı duruşta bu çekme işlemi durur: onarmak kayıt defterine sormak anlamına geldiği için çevrimdışı reddiyle ya da bir karar rolüne eklenmiş bir eklenti için, ondan önce, eklentinin .wasm dosyasını çözümleyemediği bir dosya olarak adlandırarak, çünkü çekme işlemi o .wasm dosyasını eklentinin kayıt defterinden çözümler; yalnızca o tek çalıştırma için ağa izin vermek sorunu onarır. Çekme işlemi, girdi hakkında sorulacak bir kayıt defteri yapılandırılmadığını söyleyerek durursa default_registry değerini yapıtın çekildiği kayıt defterine ayarlayın ve yeniden çekin. Çalışma alanı yapıt için imza doğrulamasını atlıyorsa çekme işlemi bunun yerine girdiye hiçbir imza kaydetmez ve derleme bunu aynı ayar altında kabul eder. Kayıt defterinin sunduğu imza doğrulanmazsa çekme işlemi o doğrulamanın kendi reddiyle durur: kaydedilmiş imza ile yayıncının sunduğu malzeme gerçekten uyuşmuyordur ve bu, yapıtı yayımlayan kişiye sorulacak bir sorudur. İletisi hiçbir çekme işlemini adlandırmayan bir girdi için (bir katalog dizininden, derleyici ikili dosyasının içindeki kopyadan ya da Release’in yanından okunan bir girdi) girdisindeki signature alanını kaldırın: böyle bir girdi hiçbir zaman bir imzalama gereksinimine tabi tutulmaz, bu nedenle derleme ardından devam eder.
A recorded signature was made for a different artifact (Kayıtlı imza farklı bir yapıt için oluşturulmuş)
Bir imza, hangi yapıt için oluşturulduğunu belirtir. Bir pull, bir yapıtın imzasını doğruladığında bu olguyu yapıtın lockfile girdisine — ya da bir karar rolünde eklenmiş bir plugin için plugins-trust.yaml içindeki girdisine — kaydeder ve doğruladığı imzayı önbelleğe alır. Herhangi bir şey işlenmeden önce derleme, içerik önbelleğinin sunduğu her girdinin önbellekteki imzasından o imzanın hangi yapıt için oluşturulduğunu okur ve bu, derlemenin o girdi için kendisinin okuduğu yapıt olmalıdır: manifest’i içerik önbelleğinde baytlarının yanında tutulan yapıt; girdinin kaydettiği herhangi bir şey asla değil. Farklı bir yapıt için oluşturulmuş bir imza derlemeyi durdurur. Bir girdiden diğerine kopyalanmış bir signature tam olarak böyle görünür: adını verdiği önbellekteki imza bozulmamıştır — hâlâ onun için kaydedilmiş özetle eşleşir — ve diğer girdinin yapıtı için oluşturulmuştur.
Bir imzalama gereksinimine bağlı değildir. Kayıtlı bir imza, önbellekteki imzanın kayıtlı özetiyle eşleştiği denetiminde olduğu gibi, bir imza gerekli olsun ya da olmasın iddia ettiği şeye tabi tutulur.
Bir plugin, nerede yüklenirse yüklensin aynı şekilde tabi tutulur. Lockfile’ın sabitlediği bir plugin ve bir karar rolünde eklenmiş bir plugin, baytları içerik önbelleğinden yüklendiğinde kayıtlı imzası baytlarının okunduğu yapıta göre denetlenir; bu da bir plugin’i derleme dışında yükleyen komutlara ulaşır — bunlar arasında aggrega lint --release ve aggrega validate --release ile aggrega serve ve aggrega mcp üzerinden ulaşılan aynı işlemler vardır.
Denetimin okudukları ve ayırt edemedikleri. Denetim, önbellekteki imzayı ve yapıtın yanındaki manifest’i okur ve özetleri karşılaştırır: hiçbir imzayı doğrulamaz, ağa bağlanmaz ve hiçbir güven materyaline başvurmaz; bu nedenle hiç ağ erişimi olmayan bir derlemede de geçerlidir. Bir imzanın hangi yapıt için oluşturulduğunu, bir pull’un kabul ettiği iki biçimin her ikisinde de okur — yapıtın kendisi üzerinde oluşturulmuş bir imza (araç zincirinin kendi imzalayıcılarının oluşturduğu budur) ve yapıtı adlandıran imzalı bir beyan —; böylece bir girdiden diğerine kopyalanmış bir imza her iki biçimde de reddedilir. Bu, bir pull’un kabul ettiği her imzaya uyguladığı okumanın aynısıdır: bir pull, doğrulanan ama okumanın yapıt için oluşturulmuş bulmadığı ya da yapıtı hiç okuyamadığı bir imzayı reddeder; dolayısıyla bir pull’un kaydettiği hiçbir imza denetimin okuyamayacağı bir imza değildir. Bir katalog dizininden, derleyici ikili dosyasının içindeki kopyadan ya da Release’in yanından okunan bir girdi manifest olmadan gelir; bu yüzden kayıtlı imzası yalnızca kayıtlı özetine göre denetlenir; önbelleğe elle, bu iki biçimden hiçbiri olmayan bir biçimde yerleştirilmiş bir imza için de durum aynıdır. Ve hiçbir imza doğrulanmadığından, önbelleğe elle yazılmış ve girdinin kendi yapıtı için düzenlenmiş bir imza, bir pull’un doğruladığı bir imzadan ayırt edilemez.
Sonraki pull bunu onarır. Bir pull, içerik önbelleğinin sunduğu her girdiyi aynı denetime tabi tutar ve denetimin bir girdiyi reddettiği yerde — imzalama gereksinimi ne derse desin — yapıtın registry’sine imzayı yeniden sorar ve bunun doğruladığını kopyalanmış imzanın yerine girdiye kaydeder. Bir karar rolünde eklenmiş bir plugin, girdisi ne kaydederse kaydetsin her pull’da yeniden doğrulanır. Yalnızca içerik önbelleğinin sunduğu bir girdi, imzasının hangi yapıt için oluşturulduğu denetimine tabi tutulur; bu nedenle bu koşulun bir derleme ya da bir plugin yüklemesi tarafından her reddi o pull’u adlandırır.
Girdiyi, imzayı kaydeden dosyayı, önbellekteki imzayı, derlemenin girdi için okuduğu manifest’i ve bunu onaran pull’u adlandıran üretilen iletiler. Derlemenin denetiminden:
artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names
ve bir plugin’in baytlarının yüklendiği yerde, ayrıca nereden geldiklerini de adlandırarak:
plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names
<file>, Release’in lockfile’ı ya da Release’in dizinindeki plugins-trust.yaml dosyasıdır.
Sorabileceği bir registry’si olmayan bir pull bunun yerine durur; tıpkı artık özetiyle eşleşmeyen önbellekteki bir imza paketi için yaptığı gibi: bir katalog varlığı ya da bir kütüphane kopyalanmış bir imza taşıdığında ve çalışma alanı onu bağlamak için artık bir default_registry adlandırmadığında, pull bu koşulla durur ve lockfile’ı olduğu gibi bırakır. İletisi, pull’un attığı adımdan sonra şunu içerir:
verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz — girdinin kaydettiği imza başka bir yapıta aittir. İletinin adlandırdığı komut olan aggrega pull --release <release> komutunu çalıştırın: bu komut, girdinin kendi imzasını registry’sinde doğrular ve kopyalanmış imzanın yerine kaydeder; bu, bir lockfile girdisi için de bir karar rolünde eklenmiş bir plugin için de aynıdır. Dosyanın commit edildiği yerde girdinin kendi kayıtlı imzasını sürüm denetiminden geri yüklemek de işe yarar. Çevrimdışı duruşta pull durur — onarmak registry’ye sormak anlamına geldiği için çevrimdışı reddiyle ya da bir karar rolünde eklenmiş bir plugin için bundan önce, plugin’in .wasm dosyasını çözümleyemediği bir dosya olarak adlandırarak, çünkü bir pull o .wasm dosyasını plugin’in registry’sinden çözümler; o tek çalıştırma için ağa izin vermek bunu onarır. Pull, girdiyi yeniden sormak için yapılandırılmış bir registry olmadığını söyleyerek durduğunda default_registry değerini yapıtın çekildiği registry olarak ayarlayın ve yeniden pull yapın. Çalışma alanı yapıt için imza doğrulamasını atladığında, pull bunun yerine girdiye hiçbir imza kaydetmez; derleme de bunu aynı ayar altında kabul eder.
No verified signature is recorded for an artifact that requires one (İmza gerektiren bir yapıt için doğrulanmış imza kaydedilmemiş)
Bir yapıtı bir kayıt defterinden getiren pull, yapıtın imzasını o kayıt defterinin güven politikasına göre doğrular ve doğrulanan olguyu yapıtın lockfile girdisine kaydeder. Bir derleme hiçbir kayıt defterine erişmez; bu yüzden yeniden doğrulamak yerine kaydedilen olguyu okur ve herhangi bir şey işlenmeden önce okuduğu her girdiyi, pull’un yapıtı getirirken uyguladığı gereksinime tabi tutar. İçerik önbelleğinin sunduğu, imza gerektiren bir yapıta ait ve doğrulanmış imza kaydetmeyen bir girdi derlemeyi durdurur: derlemenin elindeki hiçbir şey, işlemek üzere olduğu yapıtın hiç doğrulandığını söylemez.
Gereksinim, ayar ayar pull’un gereksinimidir. Çalışma alanı genelindeki imzalama politikası yapıtın türünü kapsadığında ya da kayıt defterinin .aggrega-config.yaml içindeki kendi girdisi — veya kendi girdisi olmayan hub.aggrega.ai için resmî hub’ın yerleşik politikası — imza gerektirdiğinde imza gereklidir; türü belirlenemeyen bir yapıt, etkin bir politika altında imza gerektiren sayılır. Bir pull’un imzasız bir yapıtı kabul etmesini sağlayan şey, derlemenin de onun girdisini kabul etmesini sağlar: en üst düzeydeki skip_signature_verification, çalışma alanı genelindeki politikanın gerektirdiği bir tür dışında kayıt defterinin kendi girdisindeki aynı anahtar ve advisory olarak işaretlenmiş bir kayıt defteri.
Bir girdinin nereden geldiği lockfile’dan değil, her zaman derlemeden okunur. İçerik önbelleğinin sunduğu her girdi, girdi başka ne kaydederse kaydetsin denetime tabi tutulur; bu nedenle bir girdinin manifest özetini imzasıyla birlikte kaldırmak onu muaf kılmaz. Bir katalog dizininden, derleyici ikili dosyasının içindeki kopyadan veya Release’in yanından okunan bir girdi hiçbir zaman denetime tabi tutulmaz, çünkü bir kayıt defterinden gelmeyen baytlar için kayıt defteri imzası yoktur. Her bölümün girdileri — katalog varlıkları, kütüphaneler ve eklenti yapıtları — aynı şekilde denetlenir ve denetimin reddettiği her girdi aynı çalıştırmada adlandırılır.
Bir karar rolüne bağlanmış eklenti, plugins-trust.yaml aracılığıyla aynı denetime tabi tutulur. Bir ir-verdict veya render-verdict rolündeki plugins.governance bağlantısı ve her plugins.linter bağlantısı işlenen hiçbir baytı biçimlendirmez; bu yüzden lockfile girdisi yoktur ve doğrulanmış imzasını bunun yerine lockfile’ın yanındaki kayıt taşır. Derlemenin içerik önbelleğinden okuduğu bu tür her eklenti, aynı ayarlar aracılığıyla aynı gereksinime tabi tutulur: o kayıtta imza kaydetmeyen bir girdi derlemeyi durdurur, eklenti için hiç girdi olmaması da durdurur — kaydı silmek onu muaf kılmaz. Bir katalog dizininden veya derleyici ikili dosyasının içindeki kopyadan sunulan bir eklenti denetime tabi tutulmaz. Gereksinim, böyle bir eklentiyi yalnızca bir derlemede değil, bir Release için yüklendiği her yerde bağlar: aggrega lint --release ve aggrega validate --release ile aggrega serve ve aggrega mcp üzerinden erişilen aynı işlemler, eklentiyi yüklediklerinde bu koşulla başarısız olur.
Girdiyi, onun için imza kaydetmeyen dosyayı, imzasını gerektiren ayarları ve imzayı o dosyaya kaydeden komutu adlandıran mesajlar yayımlanır. Bir lockfile girdisi için lockfile adlandırılarak:
signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (imzalama: imza gerektiren bir yapıt için doğrulanmış imza kaydedilmemiş (“<reference>”, <lockfile-path> onun için imza kaydetmiyor, gerektiren: <the settings that require it>). çözüm: yapıtın imzasını kayıt defterinde doğrulamak ve <lockfile-path> içine kaydetmek için aggrega pull —release <release> komutunu çalıştırın)
ve bir karar rolüne bağlanmış eklenti için, onun kaydı adlandırılarak:
signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (imzalama: imza gerektiren bir yapıt için doğrulanmış imza kaydedilmemiş (“<plugin>”, <record-path> onun için imza kaydetmiyor, gerektiren: <the settings that require it>). çözüm: eklentinin imzasını kayıt defterinde doğrulamak ve <record-path> içine kaydetmek için aggrega pull —release <release> komutunu çalıştırın)
Her iki dosya da komuta verilen Release’in yanındaki yollarıyla adlandırılır: <lockfile-path> Release’in lockfile’ıdır, <record-path> ise Release’in dizinindeki plugins-trust.yaml dosyasıdır.
Ayarlar, yapılandırma dosyasının kendi sözcükleriyle adlandırılır: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>" veya the official hub's built-in signature requirement for "hub.aggrega.ai"; birden fazlası geçerli olduğunda bunlar birleştirilir.
Nasıl düzeltilir: iletinin adlandırdığı pull’u çalıştırın. İçerik önbelleğinin sunduğu ve imzanın gerektiği yerde imza kaydetmeyen bir girdi için pull, yapıtın registry’sine, girdinin kaydettiği manifest özetiyle, getirdiği bir yapıt için yaptığının tam aynısı gibi imzasını sorar ve doğrulanan imzayı girdiye kaydeder — böylece sonraki derleme onu okur. Bir karar rolünde eklenmiş bir plugin her durumda her pull’da sorulur ve pull doğruladığını plugin’in plugins-trust.yaml içindeki girdisine kaydeder; girdi yoksa oluşturur. Hiç imza eklemeyen bir registry ya da güven yapılandırmasının kabul etmediği bir imza ise bunun yerine o pull’u yapıtı adlandırarak durdurur ve bu, yapıtı yayımlayan kişiye sorulacak bir sorudur. Çevrimdışı duruşta pull soramaz: bir lockfile girdisinde ağa tek bir çalıştırma için nasıl izin verileceğini adlandırarak reddeder; bir karar rolünde eklenmiş bir plugin’de ise sormadan önce durur ve plugin’in .wasm dosyasını çözümleyemediği bir dosya olarak adlandırır, çünkü bir pull o .wasm dosyasını plugin’in registry’sinden çözümler. Önbellek o kaydın adlandırdığı imza materyalini hâlâ tutuyorsa girdinin kayıtlı imzasını sürüm denetiminden geri yüklemek durumu ağ olmadan giderir. Yapıtın imzalanması amaçlanmıyorsa değiştirilmesi gereken gereksinimdir ve ileti bunun hangi ayar olduğunu adlandırır — ancak onu gevşetmek, o registry’nin yapıtlarının bir pull’da da artık denetlenmemesi anlamına gelir; bu yüzden bir gereksinimi kapatmak yerine çalışma alanı genelindeki politikanın türlerini daraltmayı tercih edin.
A recorded signature is not the one a pull would record (Kaydedilen imza, bir pull işleminin kaydedeceği imza değil)
aggrega pull --verify, aggrega pull komutunu şimdi çalıştırmanın bir pull işleminin işlediği dosyaları değiştirip değiştirmeyeceğini bildirir; bir pull işleminin bir yapıt için doğruladığı imza da yazdıklarının bir parçasıdır: lockfile girdisindeki signature ve karar rolünde eklenmiş bir plugin için plugins-trust.yaml girdisindeki imza. Bu durum, bir verify işleminin, düz bir pull işleminin farklı yazacağı her kayıtlı imza için bildirdiği şeydir: hiç imza kaydedilmemiş yerde kaydedeceği, değiştireceği ya da temizleyeceği bir imza. Verify işlemi iki dosyadan hiçbirine yazmaz ve her iki dosyadaki bu tür her girdiyi aynı çalıştırmada adlandırır.
İki lockfile girdisi bir registry’ye sorulmadan bildirilir, çünkü pull işlemi registry ne yanıt verirse versin bunları yeniden yazar; bu yüzden çevrimdışı duruşta da bildirilirler: içerik önbelleğinin sunduğu ve güven yapılandırmasının imza gerektirdiği yerde imza kaydetmeyen bir girdi (pull işlemi yapıtın imzasını kaydeder ya da bir imza saptayamadığı yerde durur) ve kayıtlı imzası başka bir yapıt için yapılmış, pull işleminin yapıtın kendi imzasıyla değiştirdiği bir girdi.
Bir pull işleminin yeniden arayacağı diğer her girdi sorulur, çünkü pull işleminin onu değiştirip değiştirmeyeceğini yalnızca registry’nin yanıtı söyler: içerik önbelleği tutmadığı için baytlarını verify işleminin getirdiği bir girdi ve önbellekteki imza paketi kaldırılmış, okunamayan ya da değiştirilmiş bir girdi. Verify işlemi registry’ye pull işleminin soracağı gibi sorar, yanıtın imzasını kaydettiği, değiştirdiği ya da temizlediği girdiyi bildirir ve doğruladığı paketi bir pull işleminin önbelleğe aldığı gibi önbelleğe alır. Çevrimdışı duruşta böyle bir girdi sorulmaz ve bildirilmez: verify işlemi onu adlandıran ve imzasının denetlenmediğini söyleyen bir satır yazdırır.
Plugin güven kaydı için, her pull işlemi karar rolünde eklenmiş her plugin’in imzasını kendi registry’sinde doğrular; bir verify işlemi de öyle: bu doğrulamanın imzasını kaydedeceği, değiştireceği ya da temizleyeceği bir girdi bildirilir; kaydın girdi tutmadığı ve bir build’in imza kaydetmediği için reddettiği bir plugin de bildirilir, çünkü pull işlemi imzasını taşıyan bir girdi yazar ve build o zamana kadar plugin’i reddeder. Kaydın henüz tutmadığı diğer her plugin ilk görülmedir ve bildirilmez. Çevrimdışı duruşta verify işlemi bu plugin’ler hakkında hiçbir registry’ye sormaz: her birini bir build’in okuduğu gibi içerik önbelleğinden okur ve kimliğini ve host işlevlerini bağlı bir verify işleminin yaptığı gibi denetler. Bir build’in imza kaydetmediği için reddettiği bir plugin’i (girdisi imza kaydetmiyordur ya da kayıt onun için girdi tutmuyordur) ve girdisinin kaydettiği imza başka bir yapıt için yapıldığından bir build’in reddettiği bir plugin’i sormadan bildirir, çünkü pull işlemi registry ne yanıt verirse versin o girdiyi yeniden yazar; diğer her girdiyi adlandıran ve imzasının denetlenmediğini söyleyen bir satır yazdırır.
Kullanımdan kaldırma işaretleri karşılaştırılmaz. Pull işleminden sonra bir yapıta eklenen işaret registry’nin durumudur ve çalışma alanında hiçbir şey değişmeden değişir; bu yüzden işaret yüzünden başarısız olan bir verify, kimsenin dokunmadığı dosyalar üzerindeki bir denetimi başarısız kılardı; kayıtlı bir işaretin bir build’i durdurmak yerine ona uyarıda bulunmasının nedeni budur.
Yayılan iletiler, girdi başına bir tane; girdiyi, dosyayı ve kaydettiğini, bir pull işleminin bunun yerine kaydedeceğini ve dosyayı güncelleyen pull işlemini adlandırır. Registry’nin yanıtının ya da kaydın kendi doğrulamasının bir pull işleminin kaydedeceği imzayı verdiği yerde:
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (imzalama: kaydedilen imza, bir pull’un kaydedeceği imza değil (“<reference>”, <file><signature> kaydediyor, bir pull <signature> kaydederdi). çözüm: <file> dosyasını güncellemek için aggrega pull —release <release> komutunu çalıştırın)
imzanın gerektiği yerde imza kaydetmeyen bir girdi için (bir lockfile girdisi ya da çevrimdışı duruşta plugin güven kaydının bir girdisi):
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (imzalama: kaydedilen imza, bir pull’un kaydedeceği imza değil (“<reference>”, <file> hiçbir imza kaydetmiyor, bir pull bir gerekliliğin istediği imzayı kendi registry’sinden ister ve kaydederdi). çözüm: <file> dosyasını güncellemek için aggrega pull —release <release> komutunu çalıştırın)
kayıtlı imzası başka bir yapıt için yapılmış bir girdi için (bir lockfile girdisi ya da çevrimdışı duruşta plugin güven kaydının bir girdisi):
signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (imzalama: kaydedilen imza, bir pull’un kaydedeceği imza değil (“<reference>”, <file> başka bir yapıt için oluşturulmuş <signature> imzasını kaydediyor, bir pull bu yapıtın kendi imzasını kendi registry’sinden ister ve kaydederdi). çözüm: <file> dosyasını güncellemek için aggrega pull —release <release> komutunu çalıştırın)
ve kaydın girdi tutmadığı, bir build’in imza kaydetmediği için reddettiği bir plugin için (ikinci biçim, verify işleminin hiçbir registry’ye sormadığı çevrimdışı duruşta):
signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (imzalama: kaydedilen imza, bir pull’un kaydedeceği imza değil (“<plugin>”, <record-path> onun için hiçbir girdi kaydetmiyor ve onun için bir imza gerekli, bir pull <signature> kaydederdi). çözüm: <record-path> dosyasını güncellemek için aggrega pull —release <release> komutunu çalıştırın)
signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (imzalama: kaydedilen imza, bir pull’un kaydedeceği imza değil (“<plugin>”, <record-path> onun için hiçbir girdi kaydetmiyor ve onun için bir imza gerekli, bir pull bir gerekliliğin istediği imzayı kendi registry’sinden ister ve kaydederdi). çözüm: <record-path> dosyasını güncellemek için aggrega pull —release <release> komutunu çalıştırın)
<signature> bir imzayı kipi, imzalayanı ve paketinin özetiyle belirtir (a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>; anahtarsız bir imza için imzalayandan sonra issued by <issuer> gelir) ya da no signature olur. <file>, Release’in lockfile’ı olan <lockfile-path> ya da Release’in dizinindeki plugins-trust.yaml olan <record-path>’tir.
Nasıl düzeltilir: mesajın belirttiği pull’u çalıştırın. Pull, mesajın kaydedeceğini söylediği imzayı adı geçen dosyaya yazar ve paketini önbelleğe alır; böylece sonraki doğrulama başarılı olur. Mesaj bir pull’un registry’ye soracağını söylüyorsa pull, registry’nin doğruladığını kaydeder — registry güven yapılandırmasının kabul etmediği bir imza eklediğinde ya da imza gerekliyken hiç imza eklemediğinde ise bunun yerine yapıtı adlandırarak durur; bu, yapıtı yayımlayan kişiye sorulacak bir sorudur. Çevrimdışı duruşta bu pull durur: bir lockfile girdisinde, registry’ye sorması gerektiği için çevrimdışı reddiyle; bir hüküm rolüne bağlı bir plugin’de ise bundan önce, plugin’in .wasm dosyasını çözümleyemediği bir dosya olarak adlandırarak, çünkü bir pull bu .wasm dosyasını plugin’in registry’sinden çözümler. Yalnızca o tek çalıştırma için ağa izin vermek dosyayı günceller. Mesaj bir pull’un hiçbir imza kaydetmeyeceğini söylüyorsa registry artık bir imza eklemiyordur ve hiçbir şey imzayı gerektirmiyordur: pull, girdinin imzasını temizler ve bir derleme bunu aynı ayarlar altında kabul eder — registry’nin yapıtı imzalamayı bırakmasını beklemiyorsanız bu da yayımlayıcısına sorulacak bir sorudur.
Bir eklentinin .wasm dosyası bu makinede değil
Bir eklentinin .wasm dosyası dört yerden birinden, şu sırayla okunur: derleyici ikili dosyasına yerleşik eklentiler, bir katalog dizininde eklentinin Plugin varlığının yanındaki dosya, başvurunun adlandırdığı açık bir dosya sistemi yolu ve aggrega pull komutunun doldurduğu çalışma alanı içerik önbelleği. Bir eklentiyi çözümlemek yalnızca makinede zaten bulunanı okur ve hiçbir şey indirmez; bu nedenle bu durum, dördünden hiçbirinin baytları barındırmadığını bildirir; bir indirmenin başarısız olduğunu değil. Tek bir eklenti istisnadır: bir içe aktarmanın ihtiyaç duyduğu çekirdek içe aktarıcı. Modülü yalnızca ikili dosyadan veya içerik önbelleğinden okunur, hiçbir zaman bir katalog varlığının yanından okunmaz; ikisi de onu barındırmıyorsa içe aktarma onu çalışma alanının varsayılan kayıt defterinden bir kez getirir. Bu durumda koşul, getirmenin de mümkün olmadığını bildirir: çalışma alanı çevrimdışıdır, kayıt defterine ulaşılamamıştır veya kayıt defteri modülü barındırmıyordur ya da çalışma alanı hiçbir varsayılan kayıt defteri adlandırmıyordur. Getirilen ve doğrulanmayan bir modül bunun yerine kendi koşulu altında, bir özet uyuşmazlığı veya bir imza reddi olarak reddedilir ve hiçbir şey saklanmaz.
Varlığın yanındaki dosya, varlığın eklenti türünden ve adından adlandırılır ve aşağıdaki pull reddi bu adı verir: pipeline-step/patch için bu ad, varlığın belgesinin bulunduğu dizinde pipeline-step--patch.wasm olur.
Katalog dizinlerinizden birinde yazılmış bir Plugin varlığı, pull onu çözümlediğinde reddedilir. Bir pull böyle bir varlığın .wasm dosyasını hiçbir zaman getirmez: tam olarak bir derlemenin baktığı yerlere, yukarıdaki dört yere bakar. Bir işlem hattı adımı, bir provider veya bir karar rolüne bağlı bir eklenti hiç sabitlenmez ve bir derleme varlığını her seferinde katalog dizininden okur. Bir dönüştürme rolüne bağlı bir eklenti sabitlenir, çünkü baytları oluşturulan çıktıyı biçimlendirir: pull, varlığını ve orada bulduğu .wasm dosyasının içerik özetini kaydeder ve bir derleme artık eşleşmeyen bir .wasm dosyasını reddeder. Bu nedenle yapıtı dört yerin hiçbirinde bulamayan bir pull, bir derlemenin daha sonra eklentiyi yükleyen adımda başarısız olmasına bırakmak yerine, kilit dosyasını veya herhangi bir entity.lock dosyasını yazmadan önce orada durur. İkili dosyanın taşıdığı veya içerik önbelleğinde zaten bulunan bir .wasm, pull’u tam olarak derlemeyi karşıladığı gibi karşılar; bu nedenle derleyicinin içinde gelen bir eklentiye ait bir varlığın yanında dosyaya ihtiyaç yoktur.
Yayılan iletiler. Pull’un reddi; dosyayı beklediği dizini gösterir ve altında sorduğu çözümlemeyi verir:
plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (plugin yapıtı bu makinede bulunamadı (Plugin varlığı <reference> bir katalog dizininde yazılmış, <directory> içinde <file> bekleniyordu). Derlenmiş .wasm dosyasını bu adla varlığın yanına yerleştirin ya da plugin’i yayımlayıp katalog dizinindeki yerine yayımlanmış Plugin varlığına başvurun)
bir derlemenin veya bir içe aktarmanın, baytlarını barındıran hiçbir kaynak olmadan yüklediği bir eklenti ve çevrimdışı duruş altında aggrega pull --verify komutunun bir derleme gibi içerik önbelleğinden okuduğu, bir karar rolüne bağlı bir eklenti için. Eklentinin Plugin varlığı bir katalog klasöründe bulunuyorsa ileti, bulunduğu sürümü ve modülünün nereye konacağını adlandırır:
plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (belirtilen sürümdeki eklenti bu makinede yok; modülünü belirtilen adla, belirtilen dizindeki Plugin varlığının yanına koyun: eklenti yapıtı bu makinede bulunamadı)
diğer durumlarda ise modülün arandığı her yeri adlandırarak:
plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (eklenti bu makinede yok: ikili dosya modülünü taşımıyor, hiçbir katalog klasörü Plugin varlığını tutmuyor ve bir çekmenin içine getirdiği içerik önbelleği de onu tutmuyor: eklenti yapıtı bu makinede bulunamadı)
Yalnızca ikili dosyanın içine bakan bir lint, bu yerlerden yalnızca ilkini adlandırır.
ve bir kayıt defteri konumu olarak yazılmış bir başvuru için aynısı:
plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (plugin <reference> çözümlenemiyor: bir OCI plugin URI’si önceden bir aggrega pull —release <release> çalıştırılmasını (baytlarının önbelleğe alınması için) ya da açık bir yerel yol gerektirir; plugin çözümlemesi bir kayıt defterinden getirme yapmaz: plugin yapıtı bu makinede bulunamadı)
bir içe aktarmanın ne okuyabildiği ne de getirebildiği bir çekirdek içe aktarıcı için; içe aktarıcıyı, sürümünü ve nedenini (burada çalışma alanının çevrimdışı olması) ve ardından modülünü makineye neyin koyacağını adlandırır:
core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (<version> sürümündeki <importer> çekirdek içe aktarıcısı bu makinede değil ve çalışma alanı çevrimdışı, bu yüzden kayıt defteri <host>’a sorulmuyor; içe aktarmayı ağ erişilebilirken bir kez çalıştırın; bu, onu çalışma alanının varsayılan kayıt defterinden getirir, doğrular ve sonraki her içe aktarma için içerik önbelleğinde tutar; ya da <file> adlı modülünü bir katalog klasöründe <version> sürümündeki <importer> için bir Plugin varlığının yanına yerleştirin: plugin yapıtı bu makinede bulunamadı)
Diğer nedenler its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version> ve the workspace names no default registry to fetch it from biçiminde okunur; son ikisi yalnızca ikinci çözümü adlandırır, çünkü ağ kullanılabilirken yapılan bir çalıştırma bunları değiştirmez.
Nasıl düzeltilir: varlık sizin yazdığınız bir varlıksa plugin’i derleyin ve .wasm dosyasını mesajın verdiği adla varlığın yanına yerleştirin — ya da plugin’i aggrega push ile yayımlayıp katalog kopyası yerine yayımlanmış varlığa başvurun; çünkü ne pull ne de derleme, kataloğunuzdaki bir varlığın .wasm dosyasını getirir. Plugin bir kayıt defterinden tükettiğiniz bir plugin ise release için aggrega pull çalıştırın; bu onu önbelleğe alır. Plugin’i derleyicinin kendisinin taşımasını bekliyorsanız çalıştırdığınız ikili dosyanın onu taşıdığını denetleyin: aggrega plugin list yerleşik plugin’leri listeler. Bir çekirdek içe aktarıcıysa içe aktarmayı çalışma alanının varsayılan kayıt defterine erişebildiği bir yerde bir kez çalıştırın — bu çalıştırma onu getirir, doğrular ve önbelleğe alır, sonraki her içe aktarma çevrimdışı olur — ya da o kayıt defteri onu barındırmıyorsa modülünü bir katalog klasöründe o sürümdeki o içe aktarıcının bir Plugin varlığının yanına, mesajın verdiği adla yerleştirin; bu durumda o varlık çekirdek içe aktarıcının yerine çalışır.
A plugin recorded as a trusted gate is no longer attached (Güvenilir kapı olarak kaydedilmiş bir eklenti artık bağlı değil)
Bir derleme üzerinde kabul ya da ret kararı döndüren bir eklenti, çözümlendiği anda kaydedilir; böylece çalışma alanı hangi kapıların incelendiğine dair bir kayıt tutar. Bu durum, artık hiçbir şeyin bağlamadığı kayıtlı bir kapının bildirdiği durumdur. Sessizce geçmek yerine derlemeyi durdurmasının nedeni, aksi hâlde çıktısının kapının onayladığı çıktıdan ayırt edilemeyecek olmasıdır: kapının sessizce eksik olduğu bir derleme ile kapının geçirdiği bir derleme aynı dosyaları üretir ve sonucu inceleyen hiç kimse hangisini elinde tuttuğunu anlayamaz.
Bu, baytları kaymış bir eklentiden farklı bir sorudur. O durum, incelenmiş olan olmayan bir eklentiyi çalıştırmayı reddeder; bu bir kimlik sorusudur. Bu durum ise incelenmiş bir kapı tamamen eksikken derlemeyi reddeder; bu bir varlık sorusudur. Çözümler de buna göre farklıdır: yapıtı geri getirmek ile bağlamayı geri getirmek.
Neyi kanıtladığı ve neyi kanıtlamadığı. Yapılandırmayı kayda bağlı tutmak, kayıtlı her kapının hâlâ bağlı olduğunu ve her birinin yapıtının kayıtlı yapıt olduğunu kanıtlar. Bağlı bir kapının herhangi bir karar döndürüp döndürmediği hakkında ise hiçbir şey kanıtlamaz: giriş işlevi, karar döndürmeyen bildirilmiş bir dışa aktarımı adlandıran bir bağlama çalışır, hiçbir şey bildirmez ve derlemeyi geçirir; kayıtla yapılan hiçbir karşılaştırma bunu fark etmez, çünkü çalışan eklenti tam olarak kayıtlı olandır ve yalnızca hiçbir şey çalıştırmamıştır. Komşu iki durum ise derlemeyi durdurur ve bu sınırın olduğundan daha geniş okunmaması için adlandırılmıştır: eklentinin bildirmediği bir dışa aktarımı adlandıran bir giriş işlevi, eklenti yüklenirken reddedilir; karar biçiminin bildirmediği bir anahtar taşıyan bir çıktı da boş bir karar listesi olarak okunmak yerine reddedilir.
Kaydı, düşürülen kapıları ve iki çözümü de adlandıran üretilen ileti:
a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (kabul ya da ret kararı için güvenilir olarak kaydedilmiş bir eklenti artık hiçbir karar rolünde bağlı değil: record-path, plugin’i güvenilir olarak kaydediyor, ancak çalışma alanı yapılandırmasındaki hiçbir karar bağlaması onu adlandırmıyor; incelenmiş ve artık eksik olan bir kapı, o kapının onayladığı çıktıdan ayırt edilemeyen bir çıktı bırakır. Eklentiyi plugins.governance altında bir ir-verdict ya da render-verdict rolünde veya plugins.linter altında yeniden bağlayın; ya da kaldırılması amaçlandıysa kayıttan düşürmek için aggrega pull —upgrade —release release plugin komutunu çalıştırın — sıradan bir aggrega pull kaydı olduğu gibi bırakır, bu yüzden yalnızca açık bir yükseltme bir girdiyi kaldırır)
Birden fazla kapı düşürüldüyse, her biri için ayrı bir komut yerine tek bir yükseltme komutunda birlikte adlandırılırlar: hedefli bir yükseltme birden çok hedef alır ve adlandırmadığı her sabitlemeyi olduğu gibi bırakır; bu yüzden onları birlikte adlandırmak, alternatifin gerektireceği tam yenilemeden hem daha kısa hem de daha dardır.
Nasıl düzeltilir: ileti iki çözüm sunar, çünkü hangisinin geçerli olduğunu yalnızca siz bilirsiniz. Kapı yanlışlıkla kaldırıldıysa eklentiyi plugins.governance altında bir karar rolünde veya plugins.linter altında yeniden bağlayın. Kaldırılması amaçlandıysa, bunu iletinin açıkça yazdığı hedefli yükseltmeyle açıkça belirtin; girdisini düşüren budur. Bunu temizlemek için kaydı düzenlemeyin ya da silmeyin: kayıt, neyin incelendiğine dair commit edilmiş bir kayıttır ve sıradan bir pull onu kasıtlı olarak olduğu gibi bırakır, çünkü bir kaldırmayı sessizce benimsemek tam da bu reddin önlemek için var olduğu şeydir.
A gate recorded as trusted resolves to a different identity (Güvenilir olarak kaydedilmiş bir kapı farklı bir kimliğe çözümleniyor)
Bir derleme üzerinde kabul ya da ret kararı döndüren bir eklenti, çözümlendiği anda, çözümlendiği sürüm ve yapıt özetiyle birlikte kaydedilir. Bu durum, sonraki bir çözümlemenin, kaydın zaten tuttuğu bir kapı için farklı bir sürüme ya da farklı baytlara ulaştığında ve çalıştırma o kimliğin benimsenmesini hiç istemediğinde bildirdiği durumdur.
Tek bir durum hem değişen sürümü hem de değişen baytları kapsar, çünkü kayıt eklentinin kimliğiyle adreslenir ve sürümü ve özeti tek bir girdinin alanları olarak taşır: bir çözümlemeyi onunla karşılaştırmak, tek sonuçlu tek bir karşılaştırmadır. Hiçbir baytı değiştirmeyen yeniden yayımlama ile aynı sürümde yeniden gönderme, bir inceleyici açısından aynı olaydır: kimlik artık incelenmiş olan değildir.
Bu, artık hiçbir şeyin bağlamadığı kayıtlı bir kapıdan farklı bir sorudur; o, kimlik değil varlık sorusudur. Önbellekteki baytları kayıtlı özetle uyuşmayan bir eklentiden de farklıdır: o durum, incelenmiş olan olmayan bir eklentiyi çalıştırmayı reddeder ve çözümü yapıtı geri getirmek ya da yeniden kaydetmektir; bu durum ise istenmeden yeni bir kimliği benimsemeyi reddeder ve çözümü eklentiyi bir yükseltmede adlandırmaktır. İki çözüm, iki durum.
Yeni kimliği istemek, bir pull’un zaten sunduğu şeydir ve bunu istemenin iki yolu vardır. Tam yenileme her şeyi yeniden çözümler, hedefli yükseltme ise adlandırdığı eklentileri yeniden çözümler; her ikisi de yeni kimliğin istendiği şeklinde okunur ve kayıt güncellenir. Diğer her pull kayıtlı kimliği korur ve durur; kaydetmenin amacı budur: bir sonraki çözümlenen şeyi benimseyen bir kayıt, çözümlemeyi yönetmek yerine onu izlerdi. İlk görülme bir uyuşmazlık değildir: kaydın henüz tutmadığı bir kimlik yalnızca doldurulur.
Karşılaştırma, yalnızca doğrulama yapan bir pull’da da çalışır; böyle bir pull ne kaydı ne de kilit dosyasını yazar. Yanındaki kilit dosyasını denetlerken kaydı atlayan bir doğrulama, hiç aramadığı bir uyuşmayı bildirmiş olurdu.
Eklentiyi, iki kimliği ve iki çözümü de adlandıran üretilen ileti:
plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (eklenti “plugin-identity”: record-path onun için recorded-digest özetli recorded-version sürümünü güvenilir olarak kaydediyor, ancak bu çözümleme resolved-digest özetli resolved-version sürümünü bildiriyor; neyin değiştiğini inceleyip aggrega pull —upgrade —release release plugin ile benimseyin ya da kayıtlı kimliği geri getirin: güvenilir olarak kaydedilmiş eklenti kimliği artık bu çözümlemenin bildirdiğiyle eşleşmiyor)
Nasıl düzeltilir: iki kimlikten hangisini kastettiğinize karar verin, çünkü buna yalnızca siz karar verebilirsiniz. Değişiklik amaçladığınız bir değişiklikse (kapı yeniden yayımlandı ve neyin değiştiğini incelediniz), iletinin açıkça yazdığı hedefli yükseltmeyle benimseyin; bu, o eklentiyi yeniden çözümler ve girdisini yeniden yazar. Beklemediyseniz incelenmiş olan, kayıtlı kimliktir: kaydın adlandırdığı sürümü ya da yapıtı geri getirin ve başvurunun neden artık başka bir yere çözümlendiğini araştırın. Bunu temizlemek için kaydı düzenlemeyin: kayıt, neyin incelendiğine dair commit edilmiş bir beyandır ve sıradan bir pull onu kasıtlı olarak olduğu gibi bırakır, çünkü değişmiş bir kapıyı sessizce benimsemek tam da bu reddin önlemek için var olduğu şeydir.
Bir Plugin varlığının iddiaları, plugin’in kendi öz bildirimiyle uyuşmuyor
Bir Plugin varlığı, işaret ettiği plugin’in neler sunduğunu belirtir: hangi dışa aktarımlara sahip olduğunu, her birinin neyin üzerinde ve hangi kapsamda çalıştığını ve bir provider’a hizmet eden bir plugin için render sırasında nasıl davrandığını. Plugin, yüklendiğinde aynı bilgileri kendisi hakkında bildirir. Bu durum, ikisi arasındaki bir uyuşmazlığın bildirdiği şeydir.
Karşılaştırma dışa aktarım başına, ada göre yapılır ve tek yönde çalışır: varlığın iddia ettiği her şey eşleşmelidir ve plugin daha fazlasını sunabilir. Plugin’in yüzeyinin bir kısmını tanımlayan bir varlığın geri kalanını listelemesi gerekmez; bu nedenle plugin’in bildirdiği ancak varlığın atladığı bir dışa aktarım uyuşmazlık değildir. Uyuşmazlık olan, plugin’in bildirmediği iddia edilmiş bir dışa aktarım ya da operates veya scope değeri plugin’in bildirdiğinden farklı olan iddia edilmiş bir dışa aktarımdır. Serbest biçimli seçici karşılaştırılmaz.
Varlık ayrıca bir render davranışı bloğu da yazıyorsa, bu bloğun alanları tek tek karşılaştırılır (girdi türleri, birleştirme modu, artifact şablonu ayraç çifti, birleştirme adı ek açıklaması, yeniden kullanılabilir örnek iddiası, sınır ötesi bağlama iddiası, girdi çıkarma iddiası ve iç içe yerleştirme dizini) ve uyuşmayan ilk alan adlandırılır. Böyle bir blok yazmayan bir varlık bu karşılaştırmayı tamamen atlar.
Aynı denetim yayımlama sırasında da çalışır, bu nedenle bir uyuşmazlık normalde bir derleme varlığı yüklediğinde değil, varlık yayımlanmadan önce ortaya çıkar.
Üretilen iletiler. Plugin’in sahip olmadığı, iddia edilmiş bir dışa aktarım:
entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (varlık, eklentinin describe() çıktısının bildirmediği bir dışa aktarımı talep ediyor: wasm: varlık sözleşmesi talebi eklentinin describe() çıktısıyla eşleşmiyor)
iddia edilmiş bir dışa aktarımdaki bir alan:
entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (varlığın dışa aktarımı bir operates değeri bildiriyor, ancak eklentinin describe() çıktısı farklı bir değer raporluyor: wasm: varlık sözleşmesi talebi eklentinin describe() çıktısıyla eşleşmiyor)
ve uyuşmayan alanı adlandırarak aynı biçimde bildirilen bir render davranışı alanı:
entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (varlık bir boundary_assembly değeri bildiriyor, ancak eklentinin describe() çıktısı farklı bir değer raporluyor: wasm: varlık sözleşmesi talebi eklentinin describe() çıktısıyla eşleşmiyor)
Nasıl düzeltilir: düzeltilmesi gereken, Aggregate’iniz ya da Release’iniz değil, Plugin varlığının iddiasıdır. İddiayı plugin’in bildirdiğiyle uyumlu hale getirin; ileti her iki değeri de adlandırır, bu nedenle hangi yöne değişmesi gerektiği iletinin kendisinde görülür. Varlığı siz yayımlıyorsanız, onu ikili dosyadan yeniden üretmek ikisini uyuşturmanın güvenilir yoludur; yayımlanmış bir varlığı tüketiyorsanız, iddiası işaret ettiği ikili dosyayla eşleşen bir sürüm seçin ve uyuşmazlığı onu yayımlayan kişiye bildirin.
Bir Plugin varlığının kaydedilmiş komut kümesi plugin ile eşleşmiyor
Terminal komutları sağlayan bir plugin’in bu komutları Plugin varlığında kaydedilir. Bu kayıt elle yazılmaz, makine tarafından yazılır: plugin’den okunur ve kaydedilir, bu nedenle ikili dosyayı tam olarak yansıtır. Bu durum, onu yansıtmayı bırakmış bir kaydın bildirdiği şeydir: bir komutun adında, kısa yardım metninde ya da komutların bildirilme sırasında bir fark.
Karşılaştırma tam eşitliktir ve bu bilinçli bir tercihtir. Varlık üzerindeki yetenek ve dışa aktarım iddiaları özenle seçilir: bir yazar yüzeyin bir kısmını meşru olarak tanımlayıp geri kalanını dışarıda bırakabilir, bu nedenle bunlar bir alt küme olarak denetlenir. Komut kaydı seçilmiş değildir; bu nedenle tam uyuşmanın altında kalan her şey, kaydın plugin’in gerçekte sunduğundan saptığı anlamına gelir ve yakın ama doğru olmayan bir komut listesi, bir çağrıyı yanlış yönlendirecek olan şeydir.
Varlık olmadan yüklenen bir plugin burada denetlenmez. Kayıt varlık üzerinde bulunur; bu nedenle doğrudan yüklenen baytlar kayıt taşımaz ve karşılaştırmanın karşısına koyabileceği bir şey yoktur.
Her iki kümeyi ve bunların nasıl yeniden kaydedileceğini adlandıran üretilen ileti:
wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: eklenti: kaydedilmiş komut yansısı, eklentinin describe() komutlarıyla eşleşmiyor; eşitleme komutunu yeniden çalıştırın ve sonucu commit edin: wasm: kaydedilmiş komut yansısı eklentinin describe() çıktısıyla eşleşmiyor)
Yayımlama sırasındaki aynı karşılaştırma, kümeleri yeniden kaydetme talimatı olmadan bildirir:
plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (eklenti: kaydedilmiş komut yansısı, eklentinin describe() komutlarıyla eşleşmiyor: wasm: kaydedilmiş komut yansısı eklentinin describe() çıktısıyla eşleşmiyor)
Nasıl düzeltilir: kümeyi ikili dosyadan yeniden kaydedin ve sonucu commit edin; ileti bunu yapan komutu adlandırır. Kaydı eşleşecek şekilde elle düzenlemeyin: kayıt makineye aittir ve bugün tesadüfen uyuşan bir elle düzenleme, bir sonraki kayıtta yeniden türetilir ve üzerine yazılır. Yayımlanmış bir varlığı yayımlamak yerine tüketiyorsanız, varlık kendi ikili dosyasının desteklemediği bir kayıtla yayımlanmıştır ve bu, yayımcısının ilgileneceği bir konudur.
Bir Plugin varlığının kaydedilmiş sürümü plugin ile eşleşmiyor
Bir plugin, derlemesinin kendisine kaydettiği sürümü bildirir ve Plugin varlığı da bir sürüm kaydeder; ikisinin aynı dize olması gerekir. Aggrega’nın plugin’lerinin derlendiği derleme tarifleri bu sürümü plugin’i yayımlayan etiketten alır (derleyiciyle birlikte gelen bir plugin için derleyicinin kendi etiketi, derleyicinin dışında gelen bir plugin için plugin’in kendi etiketi); bu nedenle etiketin adlandırdığı commit’in derlemesi yayım sürümünü, başka herhangi bir commit’in derlemesi ise 1.0.0-3-g1a2b3c4 gibi bir geliştirme sürümünü bildirir. Bu durum, birbirinden ayrılmış bir çiftin bildirdiği şeydir ve hiçbir bayt yayımlanmadan önce denetlenir; böylece ayrışmış bir çift bir kataloğa ulaşmaz.
Karşılaştırma tam bir dize eşleşmesidir. Kaydedilmiş bir derleme sürümü olmadan derlenen bir plugin boş bir sürüm bildirir ve bu durumda varlığın sürümünün eşit olması gereken değer bu boş değerdir. Denetim “sürüm bildirilmedi” durumunu “her sürüm kabul edilir” olarak ele almaz, çünkü amacı, yayımlanmış bir varlığın sürümünün her zaman ikili dosyasının gerçekte bildirdiğini söylemesidir.
Üretilen ileti:
plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (eklenti: kaydedilmiş metadata.version, eklentinin describe() sürümüyle eşleşmiyor: wasm: varlığın metadata.version değeri eklentinin describe() çıktısıyla eşleşmiyor)
Yayımlama sırasında ret, ayrıca varlık dosyasını, .wasm dosyasını ve onarımı da adlandırır:
Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (Plugin: varlık dosyasındaki metadata.version, .wasm dosyasının describe() sürümüyle eşleşmiyor — metadata.version değerini yayımladığınız sürüme ayarlayın ve eklentiyi o sürümün etiketinin gösterdiği commit’in temiz bir checkout’undan derleyin, böylece o sürümü kendisi raporlasın; yeni bir sürüm için önce varlığı yayımladığı kaynakla birlikte commit edin ve o commit’i etiketleyin: eklenti: kaydedilmiş metadata.version, eklentinin describe() sürümüyle eşleşmiyor: wasm: varlığın metadata.version değeri eklentinin describe() çıktısıyla eşleşmiyor)
Nasıl düzeltilir: varlığın metadata.version değerini yayımladığınız sürüm yapın ve plugin’i o sürümün etiketinin adlandırdığı commit’in temiz bir checkout’undan derleyin, böylece o sürümü kendisi bildirsin. Yeni bir sürüm için önce varlığı yayımladığı kaynakla birlikte commit edin ve o commit’i etiketleyin; etiketin, varlığı zaten taşıyan bir commit’i adlandırması gerekir. Plugin’in bildirdiği sürümü varlığa kopyalamayın: başka herhangi bir commit’in derlemesi bir geliştirme sürümü bildirir ve onu kopyalamak, o derlemeyi hiçbir sürüm etiketinin adlandırmadığı bir sürüm altında yayımlar. Plugin hiç sürüm bildirmiyorsa, sürümü kaydedilmeden derlenmiştir; onu sürümü kaydedilecek şekilde derleyin.
A plugin was built from a working tree with uncommitted changes (Bir plugin, commit edilmemiş değişiklikler içeren bir çalışma ağacından derlendi)
Bir plugin’in derlemesi, sürümünü derlendiği commit’ten kaydeder ve commit edilmemiş değişiklikler içeren bir çalışma ağacından yapılan derleme, bu sürümün sonunda -dirty işaretini taşır: bir etikette 1.0.0-dirty, bir etiketin ötesinde 1.0.0-3-g1a2b3c4-dirty. Böyle bir sürüm geçerli bir anlamsal sürümdür, ancak derlenen baytları içermeyen bir commit’i adlandırır; bu nedenle yayımlanacak olanı, altında yayımlanacağı sürümden kimse yeniden derleyemez. Bir Plugin’i yayımlamak, kendi sürümü bu işareti taşıyan bir plugin’i herhangi bir bayt yayımlanmadan ve registry ile iletişim kurulmadan önce reddeder; deneme çalıştırması da onu reddeder.
Yalnızca işaret reddedilir. 1.0.0-3-g1a2b3c4 gibi bir commit’ten derlenmiş bir geliştirme sürümü, derleneni gerçekten içeren bir commit’i adlandırır ve yayımlanır; 1.0.0-rc.1 gibi bir ön sürüm de öyle. Bir plugin’i yayın dışında varlığına karşı doğrulamak bu durumu ortaya çıkarmaz, çünkü geliştirme aşamasındaki bir derleme olağan olarak düzenlenmiş bir ağaçtan yapılır.
Denetim, plugin’in kendi derlemesi hakkında bildirdiği sürümü okur ve varlığın metadata.version değeriyle yapılan karşılaştırmadan önce çalışır; bu nedenle temiz sürümü kaydeden bir varlık altında commit edilmemiş değişikliklerle derlenmiş bir plugin, plugin ile eşleşmeyen kayıtlı bir sürüm olarak değil, burada bildirilir.
Plugin’i, bildirdiği sürümü ve çözümü adlandıran üretilen ileti:
Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty")
Nasıl düzeltilir: plugin’i, release etiketinin adlandırdığı commit’in temiz bir checkout’undan derleyin; böylece varlığın kaydettiği release sürümünü bildirir. Değişikliğin kendisini yayımlamak için varlığın metadata.version değerini yeni release’e ayarlayın, varlığı değişiklikle birlikte commit edin, o commit’i etiketleyin ve orada derleyin. Yalnızca değişikliği commit edip yeniden derlemek bir release’in önünü açmaz: yeniden derlenen plugin bir geliştirme sürümü bildirir ve bunu varlığa kopyalamak, derlemeyi hiçbir release etiketinin adlandırmadığı bir sürüm altında yayımlar.
A Plugin entity’s recorded host functions do not match the binary (Bir Plugin varlığının kayıtlı host işlevleri ikili dosyayla eşleşmiyor)
Bir plugin, host’un kendi çağrılarından hangilerini kullandığını bildirir ve bu küme, plugin yayımlandığında Plugin varlığına kaydedilir; yazılarak değil, ikili dosyanın kendisinden okunarak. Plugin getirildiğinde küme, içeriği az önce doğrulanmış baytlardan yeniden türetilir ve kayıtla karşılaştırılır. Her iki yöndeki bir fark da getirme işlemini durdurur.
Bu, içerik sabitlemesini tekrarlamak yerine onun üzerine eklenir ve sabitlemenin tek başına yakalamadığı iki şeyi yakalar: olağan yayımlama yolu dışında bir şeyle yayımlanmış, hiç kayıt taşımayan ya da kendi baytlarını tanımlamayan bir kayıt taşıyan bir ikili dosya; ve kaydetme adımının kendisindeki bir hata. Sabitleme, baytların sabitlenen baytlar olduğunu kanıtlar; bu ise onlar hakkında yazılanın onlar için doğru olduğunu kanıtlar.
Kayıt taşımayan bir varlık boş bir kümeyle karşılaştırılır; bu da host’un çağrılarından hiçbirini kullanmayan bir plugin ile eşleşir. Her iki yönden de aynı zararsız uyum söz konusudur; bu nedenle kaydı olmayan bir varlık, kaydı olmadığı için reddedilmez.
Plugin’i, her iki kümeyi ve baytların geldiği yapıtı adlandıran üretilen ileti:
plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports
Bir plugin doğrulanırken çalıştırılan aynı karşılaştırma, iki kümeyi yapıt olmadan bildirir:
plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği onu gidermez. Plugin’i, kaydı ikili dosyadan türetip ikisini birlikte yazan olağan yayımlama yolu üzerinden yeniden yayımlayın. Yayımlanmış bir plugin’i kullandığınız durumda, varlık ve işaret ettiği ikili dosya birbirinden ayrı yayımlanmıştır; bu nedenle uyumsuzluğu, iletideki her iki kümeyi aktararak yayımlayan kişiye bildirin. Kaydı uyması için elle düzenlemeyin; çünkü kayıt yazılmaz, türetilir ve sonraki türetme düzenlemeyi siler.
The lockfile no longer matches what the release resolves to (Lockfile artık release’in çözümlendiği sonuçla eşleşmiyor)
Bir release’in lockfile’ı, release’in ulaştığı her varlığı, kütüphaneyi ve plugin’i seçilen sürümü ve bir özetle birlikte sabitler; release dosyalarının kendisini de (release’i ve genişlettiği her release’i) içeriklerinin özetiyle kaydeder. Bir varlığın özeti, onun bir yayınının taşıdıklarını kapsar: belgesini ve yanında adlandırdığı her dosyayı, her birini yolu ve baytlarıyla. Bir kütüphanenin ve bir plugin’in özeti ise baytlarını kapsar. Release’i yeniden çözümlemek aynı kümeyi üretir ve ikisi karşılaştırılır. Bu durum, bir uyuşmazlığı bildirir.
Her uyuşmazlık, herhangi biri bildirilmeden önce toplanır; bu, lockfile’ın sabitlediği her şey için geçerlidir; böylece tek bir çalıştırma size her seferinde tek bir girdi yerine tüm tabloyu gösterir.
Şu uyuşmazlık biçimleri bildirilir ve çözümleri farklı olduğu için bunları ayırt etmeye değer:
Lockfile’ın sabitlemediği bir başvuru. Release artık lockfile’da girdisi olmayan bir şeye ulaşıyor: lockfile’ı yazan pull’dan bu yana eklenmiş bir bağımlılık. Girdi, release’in onu nerede istediğini adlandırır; bu nedenle Manifest’in bağladığı bir Recipe ya da FeatureRecipe, onu bağlayan eşleme girdisiyle bildirilir; name katmanının bağladığı ise seçildiği örneği ya da eki adlandırır.
Release’in artık ulaşmadığı sabitlenmiş bir başvuru. Lockfile, release’teki hiçbir şeyin artık bağımlı olmadığı bir şeyi hâlâ sabitliyor.
Pull’dan bu yana düzenlenmiş bir release dosyası. Release ya da genişlettiği bir release, lockfile’ın onun için kaydettiği baytları artık içermiyor. Release’in istediği her şey (hangi kaynak sürümünün getirileceği, hangi bileşenlerin nereye yerleştirileceği) dosyanın içeriğinden çözümlenir; bu nedenle kaydedilen sabitlemeler artık onun istediğini tanımlamıyor olabilir. Bu, render’ın başarısız olacağı şey olarak değil, herhangi bir şey render edilmeden önce burada bildirilir: düzenlenmiş bir kaynak sürümü aksi takdirde daha sonra sabitleme bulamayan bir getirme olarak ortaya çıkardı. Hiç release dosyası kaydetmeyen bir lockfile, release’i kaydedilmemiş olarak bildirir; release’in artık genişletmediği bir release dosyası ise artık okunmuyor olarak bildirilir.
Uzak kaynağında değişmiş bir kaynak başvurusu. Bir git ref: ile yazılmış bir kaynak, ref’in çözümlendiği commit’te kaydedilir. Yükseltme olmayan her pull, ref’in şimdi nereyi gösterdiğini uzak kaynağa sorar; ağa ulaşılabildiği durumda aggrega pull --verify de öyle yapar; farklı bir commit’e çözümlenen bir ref benimsenmek yerine burada bildirilir. Bunu yalnızca bu ikisi bildirir: bir derleme kaydedilen commit’i okur ve sormaz.
Karşılaştırma içerik üzerindedir; bu nedenle farklı bir yoldan ulaşılan özdeş içerik sapma oluşturmaz: bunun tetiklenmesi için farklı olması gereken şey baytlardır. Bir release dosyası için buna bir yorum ya da boşluk değişikliği de dahildir; release’in adlandırdığı Aggregate ve Manifest için olduğu gibi. Bir varlık için ise taşıdığı şeyin içeriğidir; bu nedenle bir katalog dizininden okunan ve bir registry’den getirilen aynı varlık sapma oluşturmaz; dosyaları yalnızca izin bitlerinde (çalıştırma biti dahil) farklı olan bir checkout ya da arşivi farklı sıkıştırılmış bir yayın da oluşturmaz.
Üretilen ileti. Koşulun kendi cümlesiyle başlar ve toplanan her uyuşmazlık ardından gelir; her biri kendi eksenini — ve bir varlık için çeşidini — adlandırır, çünkü bir varlık çeşidi ve URI’si birlikte tanımlanır; bu nedenle Aggregate’i ve Manifest’i aynı adı paylaşan bir Release’in iki girdisi olur ve bunlardan birinde yapılan bir düzenleme, düzenlenmiş olana karşı bildirilir:
lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (kilit dosyası: güncel değil; artık Release’inin çözümlendiği sonuçla eşleşmiyor: çeşidiyle birlikte belirtilen varlık kilit dosyasında yok; başvurulduğu yer de belirtilir) <axis>"<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (belirtilen eksendeki belirtilen başvuru değişti: kilit dosyasındaki sürüm ve özet güncel olanlardan farklı) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (belirtilen çeşitteki belirtilen varlık değişti: kilit dosyasındaki sürüm ve özet güncel olanlardan farklı) <axis>"<uri>" no longer used by the release (belirtilen eksendeki belirtilen başvuru artık sürüm tarafından kullanılmıyor) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (belirtilen sürüm belgesi kilit dosyası yazıldıktan sonra düzenlendi: içeriği artık kaydedilen özetle eşleşmiyor, bu nedenle sabitlemeler artık onun istediği şeyi tanımlamıyor olabilir; Release’i yeniden çözümlemek, okuduğu dosyaları şu anki halleriyle kaydeder)
<site>, release’in başvuruyu istediği yerdir ve onu adlandıran girdiye giden yol olarak yazılır (örneğin manifest.spec.mappings.components.name.db-primary); bu tür en fazla üç yer sıralı olarak listelenir, daha fazlası varsa ardından ... gelir. Çözümlemesi böyle bir yer kaydetmeyen bir başvuru parantez olmadan bildirilir.
Değişmiş bir kaynak başvurusunu bildiren bir pull, yapıtı yazarının yazdığı şekliyle, kaynağın adlandırdığı yerlerde chart= ve module_subdir= ile birlikte adlandırır:
source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release>
Bir derleme, çözümü girdilerden sonra yazdırır:
run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile
Hangi komutlar bir sürümü kilit dosyasına bağlı tutar.aggrega build işlemeden önce karşılaştırır ve durur. aggrega validate --release ve bir sürümü çözümleyen her aggrega inspect seçimi — varsayılan görünüm, --resolved, --ir-graph ve --closure — sürümün bağımlılıkları çözümlenir çözümlenmez aynı karşılaştırmayı yapar ve standart çıktıya hiçbir şey yazmadan aynı ileti ve çözümle durur; böylece hiçbiri, bir derlemenin kaymış olarak reddettiği bir kilit dosyasını geçirmez. Asistan araçlarından build, bir release ile validate ve bir release ile describe aynı koşullarda reddeder. aggrega pull karşılaştırmayı yazmak üzere olduğu kilit dosyasına karşı, aggrega pull --verify ise diskteki dosyaya karşı yapar. Hiçbir sürümü çözümlemeyen bir komut — bağımsız değişken olmadan (bu durumda kilit dosyası sabitlemelerini yalnızca bir extends üst öğesini bulmak için okur) ya da bir varlık yoluyla çalıştırılan aggrega validate ve --ir-graph olmadan aggrega inspect --raw veya --output yaml — bir kilit dosyasına bağlı tutulmaz; yanında kilit dosyası bulunmayan bir sürüm de tutulmaz. Düzenleyicinin dil sunucusu bu durumda derlemelerini durdurur ve bir grafik isteğinde, grafiği yine de çizerken bunu kilit dosyası üzerinde bir uyarı olarak bildirir.
Nasıl düzeltilir: release’i yeniden çözümleyin ve yeniden yazılan lockfile’ı commit edin. Bir derlemenin bildirdiği her şey için düz bir aggrega pull --release <release> (derlemenin yazdırdığı komut) düzeltmenin tamamıdır: release’i şimdiki hâliyle çözümler, değişen sabitlemeleri yeniden yazar ve diğerlerinin hepsini korur; böylece dokunmadığınız hiçbir şey kaymaz. Değişen şey bir Recipe’in ya da FeatureRecipe’in yerel kaynağı altındaki bir dosya olduğunda, bu pull önce varlık için aggrega pin komutunu adlandırarak durur, çünkü yeni sabitlemeyi onun yanına kaydetmek yazarın adımıdır; bunu çalıştırın ya da pull’a --pin-sources verin; pull sapmayı giderir. Düz bir pull’ın gidermediği tek girdi, uzak kaynağında değişmiş bir kaynak başvurusudur, çünkü onu gidermek başvurunun şimdi adlandırdığı commit’i benimsemek anlamına gelir: aggrega pull --upgrade --release <release> bunu yapar ve girdi de bunu söyler; Recipe’in entity.lock dosyası o kaynağı kaydediyorsa yükseltme, yeni commit onun yanına sabitlenene kadar aynı şekilde durur. Bunu yapmadan önce girdileri okuyun, çünkü üzerinde durmaya değer olan üçüncü biçimdir: release’in artık ulaşmadığı bir başvuru genellikle bilerek kaldırdığınız bir bağımlılıktır; ancak onu siz kaldırmadıysanız, başka bir şey değişmiş ve onu ulaşılamaz kılmıştır. Dokunmadığınız bir başvuruda değişmiş bir çift, o sürümdeki içeriğin incelenen içerik olmadığı anlamına gelir; bu, bakmadan benimsenecek bir şey değil, onu sağlayan kişiye sorulacak bir sorudur.
Bir pull bu aynı karşılaştırmayı yazmak üzere olduğu lockfile’a karşı çalıştırır ve karşılaştırmanın reddettiği bir lockfile’ı yazmaz; bu nedenle bir pull’ın az önce yazdığı lockfile, aynı girdiler verilen bir derlemede bu denetimi geçer. Bu durum tamamlanmış bir pull’ın hemen ardından yeniden ortaya çıkıyorsa, iki çalıştırmaya farklı girdiler verilmiştir: birine verilip diğerine verilmeyen bir katalog dizini ya da aralarında düzenlenmiş bir çalışma alanı yapılandırması. Pull’ı ve derlemeyi aynı girdiler üzerinde çalıştırın.
An artifact is not at the source the build was told to find it (Bir yapıt, derlemeye bulunacağı söylenen kaynakta değil)
Bir katalog başvurusu bir yapıtı ve bir sürümü adlandırır. Bu koşul, bu çifte hiçbir şeyin karşılık vermediğini bildirir: ya başvurunun çözümlendiği kayıt defterinde ya da derlemenin okuduğu yerel yapıt önbelleğinde.
Bir derleme önbelleği okur; kendiliğinden dışarıya erişmez. Edinme ayrı bir adımdır: bir release’i çözümleyen pull, release’in ihtiyaç duyduklarını getirir ve önbelleğe yazar, ardından derleme orada olanı okur. Bu nedenle bu koşul bir derlemeye önbellek ıskalaması olarak, bir pull’a ise böyle bir yapıtı olmayan bir kayıt defteri olarak ulaşır. Bir derleme, başlarken lockfile’ını dolduracak şekilde yapılandırıldığında, çalıştırdığı edinme aynı pull’dur.
Yayılan iletiler. Böyle bir etiketi olmayan bir kayıt defteri ve içerik blob’u bulunmayan bir manifest çözümleyen bir getirme:
oci: "<reference>:<version>": oci: artifact not found at remote source (oci: <reference>:<version>: oci: yapıt uzak kaynakta bulunamadı)
oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: <reference>:<version> için içerik: oci: yapıt uzak kaynakta bulunamadı)
hiçbir girdi bulamayan bir önbellek okuması; bir derlemenin karşılaştığı biçim budur:
oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: <reference>@<version> için önbellekte kayıt yok: oci: yapıt uzak kaynakta bulunamadı)
ve manifest’i yanında bulunmayan önbelleğe alınmış bir yapıt için de aynısı:
oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: <reference>@<version> için manifest önbellekte yok: oci: yapıt uzak kaynakta bulunamadı)
Nasıl düzeltilir: önce başvuruyu ve sürümü denetleyin; artık var olmayan bir sürüm ile yazım hatası içeren bir ad aynı yanıtı üretir ve ileti, katalogla karşılaştırılabilmeleri için ikisini de aktarır. Başvuru doğruysa yapıt edinilmemiştir: release için pull’u çalıştırın; bu, release’in ulaştıklarını getirir ve önbelleği doldurur. Çalışma alanı çevrimdışıysa bu pull’un ağ erişimi olan bir yerden çalışması gerekir; çevrimdışı bir derleme yalnızca zaten önbellekte olanı okur ve önbellek onu içermediğinde söylediği budur.
The registry will not serve an artifact without credentials it accepts (Kayıt defteri, kabul ettiği kimlik bilgileri olmadan bir yapıtı sunmaz)
Kayıt defteri yanıt verdi ve reddetti: ya hiçbir kimlik bilgisi sunulmadı ya da sunulanlar kabul edilmedi. Bu, hiç ulaşılamayan bir kayıt defterinden farklıdır: burada iletişim gerçekleşti ve yanıt hayırdı.
Bunu, tümü yapıtlar edinilirken ya da yayımlanırken olmak üzere dört an bildirir: bir başvuruyu çözümlemek, içeriğini çekmek, bir deponun hangi sürümleri içerdiğini listelemek ve bir kimlik bilgisini saklandığı anda denetlemek.
Her biri ne istendiğini adlandıran ve kayıt defterinin ne dediğini aktaran yayılan iletiler:
oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: <reference>:<version> çözümlemesi: <what the registry replied>: oci: kimlik doğrulaması gerekli ya da başarısız oldu)
bir deponun sürümlerini listelemek; bu, onun yerine durum kodunu adlandırır:
oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list <repository>: durum <code>: oci: kimlik doğrulaması gerekli ya da başarısız oldu)
ve bir kimlik bilgisini saklanırken denetlemek:
oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: <host> için kimlik bilgisi doğrulaması: <what the registry replied>: oci: kimlik doğrulaması gerekli ya da başarısız oldu)
Hata, düzeltme önerisi sunan bir adım tarafından ortaya çıkarıldığında satır, türettiği ana makineye karşı çalıştırılacak oturum açma komutuyla biter:
remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (düzeltme: aggrega pull —release komutunu yeniden çalıştırmadan önce belirtilen ana bilgisayar için aggrega login (ya da docker login) çalıştırın)
ve bir içe aktarma derleyicinin çekirdek içe aktarıcılarından birini getiriyorsa, içe aktarmayı yeniden çalıştırmadan önce aynı oturum açma komutuyla:
remediation: aggrega login <host> (or docker login <host>) before re-running the import (düzeltme: içe aktarmayı yeniden çalıştırmadan önce aggrega login (ya da docker login))
http ya da https üzerinden getirilen klasik bir Helm chart deposu ya da chart arşivi, bir compose parçası ve bir Git deposu da sunucu isteği yetkisiz olarak reddettiğinde bu koşulu bildirir; bunların çözüm önerisi bir oturum açma yerine eklenecek netrc girdisini adlandırır, çünkü bu getirme işlemleri kimlik bilgilerini o dosyadan okur:
remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (çözüm önerisi: netrc dosyasına ana makine için bir girdi ekleyin (machine, login ve password ile), ardından komutu yeniden çalıştırın)
Nasıl düzeltilir: bu, entity yazarının değil operatörün işidir; bir Aggregate, Component ya da Recipe içindeki hiçbir şey buna yol açmaz. Resmî hub hub.aggrega.ai, yayımladığını herkese sunar; bu nedenle ondan okumak kimlik bilgisi gerektirmez, ona yayımlamak ise gerektirir; başka bir kayıt defteri okuma için de kimlik bilgisi isteyebilir. İletinin adlandırdığı ana makinede oturum açın — ya da http veya https üzerinden getirilen bir kaynak için çözüm önerisinin adlandırdığı netrc girdisini ekleyin — ve edinmeyi yeniden çalıştırın. Zaten oturum açtıysanız, depodaki kimlik bilgisi o ana makinenin o depo için kabul ettiği bir kimlik bilgisi değildir: yenilemek için yeniden oturum açın ve hesabın, başvurunun çözümlendiği depoya okuma erişimi olduğunu denetleyin; çünkü özel bir depo, onu göremeyen bir hesaba tam olarak bu şekilde yanıt verir. Başvuru beklemediğiniz bir ana makineye çözümleniyorsa, .aggrega-config.yaml içindeki kayıt defteri takma adı ya da varsayılan kayıt defteri başka bir yeri gösteriyordur.
The netrc file cannot be read (Netrc dosyası okunamıyor)
Klasik bir Helm chart deposu veya chart arşivi, bir compose parçası ve http ya da https üzerinden getirilen bir Git deposu, kimlik bilgilerini netrc dosyasından alır; bu dosya böyle bir kaynak getirildiğinde — bir çekme, bir sabitleme ya da kilit dosyasını dolduran bir derleme tarafından — okunur. Hangi dosyanın okunduğu ve bir isteğe hangi girdinin yanıt verdiği Authentication bölümünde açıklanmıştır. Bu koşul, var olan ancak kullanılamayan bir netrc dosyasını raporlar: okunamıyordur — örneğin bir dizindir ya da okuma izniniz yoktur — veya netrc biçimine uymuyordur. Biçim katı biçimde okunur, çünkü yanlış yerde okunan bir sözcük ondan sonraki her sözcüğü kaydırır: yanlış yazılmış bir anahtar sözcük, ardındaki parolayı bir sonraki anahtar sözcüğe dönüştürür ve dosya sorunsuz görünürken istek kimlik bilgisi olmadan ya da yanlış kimlik bilgisiyle gönderilir.
Var olmayan bir dosya bu koşula girmez: hiçbir kimlik bilgisi tutmaz ve kimlik bilgisi gerektiren bir isteğe sunucunun reddi yanıt verir. Makinenin diğer kullanıcılarının okuyabildiği bir dosya da bu koşula girmez: Linux ve macOS’ta dosyayı adlandıran tek bir uyarıya yol açar ve yine de okunur.
İleti dosyayı ve bir biçim hatası için satırı adlandırır ve neyin yanlış olduğunu yalnızca biçim açısından söyler — dosyanın içerdiği hiçbir sözcüğü asla göstermez, çünkü yanlış yere konmuş bir sözcük bir parola olabilir. Tanılamanın kategorisi yoktur: netrc dosyası, derlemenin okuduğu bir belge değil, sizin kendi kimlik bilgisi dosyanızdır.
Bir biçim hatası için verilen ileti; biçim hatası şunlardan biridir: bir anahtar sözcük beklenen yerde duran bir sözcük, ardından değeri gelmeyen bir anahtar sözcük, herhangi bir machine ya da default girdisinden önce duran bir login, password ya da account ve açıldığı satırda kapatılmamış tırnaklı bir sözcük:
the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (netrc dosyası okunamadı (belirtilen dosya ve satırda bir anahtar sözcük (machine, default, login, password, account veya macdef) beklenen yerde bir sözcük duruyor). Dosyayı düzeltin ya da NETRC’yi bunun yerine okunacak başka bir netrc dosyasının yoluna ayarlayın)
ve okunamayan bir dosya için, nedenini aktararak:
the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (netrc dosyası okunamadı (belirtilen dosya ve okunamama nedeni). Dosyayı düzeltin ya da NETRC’yi bunun yerine okunacak başka bir netrc dosyasının yoluna ayarlayın)
Nasıl düzeltilir: iletinin adlandırdığı dosyayı açın. Bir biçim hatası için adlandırdığı satıra gidin: her girdi machine <host> — ya da default — ve ardından gelen login <user> ile password <secret> biçimindedir; yanlış yazılmış ya da değeri olmayan bir anahtar sözcük olağan nedendir. Okunamayan bir dosya için onu okuyabileceğiniz ve yalnızca sizin okuyabileceğiniz bir dosya yapın (chmod 600). Dosya okunmasını istediğiniz dosya değilse NETRC değişkenini istediğiniz dosyanın yoluna ayarlayın.
The registry could not be reached (Kayıt defterine ulaşılamadı)
Kayıt defteriyle iletişim hiç gerçekleşmedi: ad çözümleme, bağlantı ya da güvenli el sıkışma başarısız oldu. Bu, yanıt verip reddeden bir kayıt defterinin karşılığıdır: burada her iki yönde de hiçbir şey kurulmadı, bu nedenle yapıtın uzak uçtaki durumu eksik olduğu bilinen değil, bilinmeyendir.
Bu aynı zamanda bir Recipe’nin kaynağı edinilirken daha belirli bir nedeni olmayan bir aktarım hatasının bildirdiği şeydir; dolayısıyla hangi katmanın başarısız olduğuna dair bir iddia değil, o yoldaki genel “uzak uca ulaşılamadı” yanıtıdır.
Edinilen kaynağı adlandıran, alttaki aktarım hatasını aktaran ve koşulun taşıdığı düzeltme önerisini içeren yayılan ileti:
sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported (sourceresolver: kind=<kind> url=<url> version=<version>: oci: ağa ulaşılamıyor (neden: <the transport failure>); düzeltme: <host> ile ağ bağlantısını denetleyin; kurumsal proxy’ler genellikle HTTPS_PROXY’nin dışa aktarılmasını gerektirir)
Nasıl düzeltilir: düzeltme operatörün işidir ve kataloğunuzun dışındadır. İletideki ana makineye komutun çalıştığı yerden ulaşılabildiğini denetleyin. Ortam ağa bir proxy üzerinden ulaşıyorsa, proxy’nin ortama dışa aktarılması gerekir; düzeltme önerisi bunu adlandırır. Yalnızca bir tarayıcı ya da paket yöneticisi için yapılandırılmış bir proxy algılanmaz. Ana makineye elle ulaşılabiliyor ancak buradan ulaşılamıyorsa, fark genellikle bir proxy’deki kimlik bilgileri ya da el sıkışmanın kabul etmediği bir araya girme sertifikasıdır. Yapıtlar önbelleğe alındıktan sonra sonraki derlemeler önbelleği okur ve ağa hiç ihtiyaç duymaz.
A server did not answer in time (Bir sunucu zamanında yanıt vermedi)
Bir istek, yöneldiği sunucuyu — bir kayıt defterini ya da bir komutun ulaştığı başka herhangi bir sunucuyu, örneğin bir imzanın kaydedildiği şeffaflık günlüğünü — beklemeyi sürdürdü ve geri çekildi. Bir istek, tamamen gönderildikten sonra sunucunun yanıtına başlaması için en fazla 30 saniye, zaten gelmekte olan bir yanıtın sonraki parçası için de en fazla 30 saniye bekler; ikisinden biri aşıldığında, sunucuyu ve bekleme süresini belirterek bu koşul altında reddedilir. Bir bağlantıyı kabul edip hiç yanıt vermeyen bir sunucunun ve hiçbir bağlantıyı kabul etmeyen bir adresin ürettiği sonuç budur; sonu gelmeden bekleyen bir komut değil. Bir kayıt defterinin tüm depo listesinin taranması ise her sayfada, taramanın sürebileceği süre boyunca bekler ve kendi koşulu olan E0377 ile sınırlandırılır.
Yalnızca bekleme sınırlıdır. İlerlemeyi sürdüren bir indirme ya da yükleme ne kadar sürerse o kadar sürer, çünkü bekleme yalnızca hiçbir şey gelmezken ölçülür. Bir Recipe’nin source: alanının HTTPS üzerinden getirdiği bir Helm chart’ı yalnızca yanıtının başlamasını bekleme süresine tabidir ve bu sürenin dolması bu koşul altında değil, ağ kitaplığının kendi sözcükleriyle bildirilir. Bir komutun zaman aşımına uğradığında zaten yeniden gönderdiği bir istek — aggrega registry update sırasında bir okuma, bir yayımlama sırasında bir yazma — önce yeniden gönderilir; böylece ret, son denemesinden sonra kalan sonuçtur.
Kayıt defterinin yanıt vermediği bir sürüm listelemesi için yayılan ileti:
aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: plugin/cli/mo için sürümleri listele: oci: etiketleri listele: Get: 127.0.0.1:18471 30s içinde yanıt vermedi: egress: sunucu zamanında yanıt vermedi)
ve yarıda kesilen bir yanıt için:
<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (yanıt vermeyi bıraktı: yanıtının devamı 30s boyunca hiç gelmedi: egress: sunucu zamanında yanıt vermedi)
Nasıl düzeltilir: düzeltme operatöre aittir ve kataloğunuzun dışındadır. İletinin adını verdiği sunucunun çalışır durumda ve komutun çalıştığı yerden erişilebilir olduğunu denetleyin; yük altındaki ya da bakımdaki bir kayıt defteri daha sonra yeniden yanıt verir ve komut yeniden çalıştırılabilir. Ortam ağa bir proxy üzerinden ulaşıyorsa, proxy’nin isteği tutmak yerine ilettiğini denetleyin. Bekleme süresi sabittir; onu uzatan bir ayar yoktur.
A registry’s repository listing did not end in time (Bir kayıt defterinin depo listesi zamanında sona ermedi)
Bir kayıt defterinin tüm depo listesinin taranması, listenin sonuna ulaşmadan beş dakika sürdü ve durduruldu. Listeyi iki komut tarar: yalnızca hiçbir eklenti kendisine verilen adı tam olarak taşımadığında ve adı bunu içeren bir eklenti aradığında aggrega plugin add ile her birini okumadan önce bir kayıt defterinin depolarını listeleyen aggrega registry update. Sonu gelmeden yeni depolar adlandırmayı sürdüren bir liste de, bir kayıt defterinin bitmesine yetmeyecek kadar yavaş sunduğu bir liste de komutu bekletmek yerine burada sona erer; tarama hiç depo üretmez, böylece yarıda kesilen bir listeden hiçbir şey seçilmez ya da dizinlenmez. İleti, durdurulduğu anda listenin kaç depo adlandırmış olduğunu belirtir.
Sorgusu bir adın parçası olan bir eklenti ekleme işlemi için yayılan ileti:
aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: “mo” adında bir cli eklentisi yok ve her depoda bunu içeren bir adın aranması tamamlanmadı; eklentiyi tam adıyla belirtin, örneğin aggrega plugin add cli ve ardından adı: tarama, liste bitmeden önce 5m0s sonra durduruldu (şimdiye kadar adlandırılan depolar: 146): registry: depo listesi zamanında sona ermedi)
Nasıl düzeltilir:aggrega plugin add için eklentiyi tam adıyla belirtin — aggrega plugin add cli mo yerine aggrega plugin add cli moo — böylece eklenti tek bir istekle o adla aranır ve liste hiç taranmaz. aggrega registry update için neden kayıt defterinin listesidir: kayıt defterini işleten kişiyle listesinin sona erdiğini doğrulayın ve sona erdiğinde güncellemeyi yeniden çalıştırın. Beş dakikalık sınır sabittir; onu uzatan bir ayar yoktur.
A registry kept asking to slow down (Bir kayıt defteri yavaşlamayı istemeyi sürdürdü)
Fazla meşgul bir kayıt defteri 429 Too Many Requests ile ya da ne kadar bekleneceğini söyleyen bir Retry-After üst bilgisiyle birlikte 503 Service Unavailable ile yanıt verir. Bir komutun bir kayıt defterine yaptığı her istek, kayıt defterinin istediği kadar — belirtmiyorsa on saniye — bekler ve yeniden sorulur; o kayıt defterine yapılan her istek onunla birlikte bekler ve kayıt defteri yeniden yanıt verene kadar ona aynı anda daha az istek gönderilir. Beş dakika boyunca “yavaşla” dışında hiçbir yanıt vermeyen bir kayıt defteri bu koşul altında reddedilir; ret, kayıt defterini, son yanıtını ve ne kadar süredir başka bir yanıt vermediğini belirtir; beklerken kendi süre sınırı dolan bir istek de aynı şekilde reddedilir. Ardından aggrega registry update o kayıt defterini dizine alınmamış olarak bildirir ve kayıt defteri çalıştırmadan önceki dizinini korur.
Beş dakika boyunca yavaşlamayı isteyen bir kayıt defteri için üretilen ileti:
<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (yavaşlamayı istemeyi sürdürdü: son yanıtı 429 Too Many Requests idi ve 5m0s boyunca başka hiçbir yanıt vermemişti: oci: kayıt defteri yavaşlamayı istemeyi sürdürdü)
ve kendi süre sınırı beklemeyi sona erdiren bir istek için:
<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (yavaşlamayı istemeyi sürdürdü: son yanıtı 429 Too Many Requests idi ve isteğin kendi süresi dolduğunda başka hiçbir yanıt vermemişti: oci: kayıt defteri yavaşlamayı istemeyi sürdürdü)
Nasıl düzeltilir: neden, yazdığınız herhangi bir şey değil, kayıt defterinin hız sınırıdır. Bir istemcinin ne kadar hızlı istek yapabileceğini sınırlayan bir kayıt defteri genellikle aynı adresten gelen her şeyi sınırlar; bu nedenle o adresin arkasındaki başka komutların veya makinelerin aynı anda ona istek yapıp yapmadığını denetleyin ve onlar bittiğinde komutu yeniden çalıştırın. Kayıt defterini siz işletiyorsanız hız sınırını denetleyin. Beş dakikalık sınır sabittir; onu uzatan bir ayar yoktur.
Getirilen veya önbellekteki baytlar, onlar için taahhüt edilen özetle eşleşmiyor
Her yapıt, içeriğinin özetini taahhüt eden bir manifest taşır ve kilit dosyası bu manifestin özetini bağımsız olarak sabitler. Her iki taahhüt de eldeki baytlar yeniden özetlenip karşılaştırılarak denetlenir. Başarısız olan bir karşılaştırmanın bildirdiği budur ve yeni getirilmiş baytlarda da önbellekten geri okunan baytlarda da aynı şekilde tetiklenir.
İki koşul vardır ve hangisinin tetiklendiği, hangi katmanın uyuşmadığını söyler. Biri, kendi manifestinin taahhüt ettiği özetle eşleşmeyen içeriği belirtir. Diğeri, kilit dosyasının kendisi için sabitlediği özetle eşleşmeyen önbellekteki bir manifesti belirtir; bu, kurcalanmış bir manifestin sonraki bir içerik denetiminin güvendiği otorite hâline gelmesini önleyen denetimdir. İkinci denetimi anlamlı kılan sabitlemedir: manifesti önbellekteki baytlardan yeniden türetmek yerine kilit dosyasından gelir, bu nedenle ikisi gerçekten bağımsızdır.
Ardından bir varlık, baytların taşıdığı şeyin üzerinde kendi satırına tabi tutulur. Önbellekteki bir varlığın baytları manifestleriyle uyuştuğunda, kilit dosyasının varlık için kaydettiği özetle karşılaştırılır; bu özet sıkıştırılmış baytları değil, yayınının taşıdığı dosyaları (her birini yolu ve baytlarıyla) kapsar. Böylece farklı bir sıkıştırmayla yayınlanan aynı dosyalar yine uyuşur, aynı sürüm altındaki farklı dosyalar ise uyuşmaz ve uyuşmazlık içerik koşulu altında bildirilir. Bir sabitlemeye uyan bir pull da bir kayıt defterinin sabitlenmiş sürüm altında sunduğu şey üzerinde aynı karşılaştırmayı yapar.
Bu denetimlerin hiçbiri ağa ihtiyaç duymaz. Her biri zaten eldeki baytlar üzerinde bir özet karşılaştırmasıdır; tamamen çevrimdışı bir derlemenin okuduğu şeyin sabitlenmiş olan şey olduğunu yine de doğrulayabilmesini sağlayan budur.
satırına karşı önbellekteki bir varlık ve sabitlenmiş bir sürüm altında başka içerik sunan bir kayıt defteri:
catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch (katalog: önbellekteki <uri> içerik özeti <computed>, kilit dosyası sabitlemesi <pinned> ile eşleşmiyor: oci: içerik özeti uyuşmazlığı)
oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin (oci: içerik özeti uyuşmazlığı: sabitlenmiş varlık "<uri>": kayıt defteri artık sabitlenmiş sürüm için sabitlenmiş özeti değil, başka bir özeti sunuyor; sabitlemeyi güncellemek için aggrega pull —upgrade —release komutunu çalıştırın)
Her ikisi de o sırada okunan şey tarafından çerçevelenir. Hiçbir kaynağın sabitlemesinde tutmadığı sabitlenmiş bir varlık; önbellek girdisinin manifesti uyuşmadıysa manifest koşulu, aksi hâlde içerik koşulu:
pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above>
Arşivin dışına kaçan bir yolu belirten bir arşiv girdisi de içerik koşulu altında bildirilir, çünkü bunu deneyen bir paket, taahhüt edilen paket değildir:
Bildiren adım bir düzeltme sağladığında her ikisi de aynı düzeltmeyi taşır:
remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz ve hiçbir yazım değişikliği onu gidermez. Önbelleği ve kilit dosyasını birlikte aggrega pull --upgrade --release <release> ile yenileyin; bu, kaynaktan yeniden getirir ve ikisini de yeniden yazar. Bu sorunu gideriyorsa, önbellekteki kopya yazıldığından beri değiştirilmiş veya kesilmiştir. Uyuşmazlık yenilemeden sonra da sürüyorsa, yayıncının sunduğu baytlar sabitlenmiş olandan gerçekten farklıdır: yeniden yayınlanmış bir sürümdür; bu, onu yayınlayan kişiye sorulacak bir sorudur ve yeni özeti benimsemeden önce sorulmaya değer, sonra değil.
Bir manifest beklenen türde hiçbir katman taşımıyor ya da birden fazla taşıyor
Bir yapıtın manifesti katmanlarını listeler ve içeriği taşıyan katman konumuna göre değil, ortam türüne göre seçilir. Bir yapıtın birden fazla katmanı (örneğin yanında ayrı bir köken katmanı bulunan bir chart) paketleyip yine de içeriğin güvenilir biçimde seçilmesini sağlayan budur.
İki biçim seçilecek hiçbir şey bırakmaz. Beklenen türde hiçbir katman olmaması, manifestin, referansın okunduğu şeyden başka bir şeyi tanımladığı anlamına gelir. Birden fazla olması, seçimin yanıtı olmadığı anlamına gelir ve ilkini seçmek bazen doğru, bazen de sessizce yanlış olurdu.
Yayılan iletiler, her biri beklenen ortam türünü belirtir. Hiçbiri:
oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type (oci: manifestte bu ortam türünde katman yok: oci: manifestte beklenen içerik ortam türünde katman yok)
ve kaç tane olduğunu da belirten birden fazla:
oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type (oci: manifestte bu ortam türünde <count> katman var; tam olarak bir tane bekleniyordu: oci: manifestte beklenen içerik ortam türünde birden fazla katman var)
Nasıl düzeltilir: düzeltme sizin değil yayıncının işidir; manifest bir katalog yazarının yazdığı bir şey değildir. Önce referansın kastettiğiniz yeri gösterdiğini denetleyin: farklı bir yapıt türüne çözümlenen bir referans ilk biçimi üretir, çünkü manifest başka bir şey için gerçek bir manifesttir. Referans doğruysa, yapıt onu iddia edildiği tür olarak tanımlamayan bir manifestle yayınlanmıştır; bu nedenle iletideki ortam türünü onu yayınlayan kişiye iletin. Olağan yayınlama yolu üzerinden yayınlamak tam olarak bir içerik katmanı olan bir manifest üretir; dolayısıyla bu biçimlerden birindeki bir yapıt başka bir yolla bir araya getirilmiştir.
A published bundle holds no entity, or holds two (Yayımlanmış bir paket hiç varlık içermiyor ya da iki varlık içeriyor)
Belgesinin yanında dosyalar bildiren bir varlık (bir Recipe’in yerel chart’ı ya da kilidi, bir Component’in içe aktarılmış şeması), varlığı bu dosyalarla birlikte paketleyen bir .tar.gz olarak yayımlanır. Böyle bir paketi geri okumak, varlığı bu dosyalar arasında yeniden bulmak demektir; varlığın yazıldığı dosyanın adı herhangi bir şey olabileceğinden, onu tanımlayan şey adı değil taşıdığı varlık önsözüdür. Paketin en üst düzeyinde kind: değeri yayımlanabilir bir varlık türü olan belge varlığın kendisidir; yanındaki bir compose parçası, bir chart şablonu ya da bir Kubernetes manifest’i varlık değildir. Bir source/ ağacının daha altındaki bir varlık belgesi de varlık değildir; bu, varlığın kendisi değil, varlığın taşıdığı içeriktir.
İki biçim seçilecek hiçbir şey bırakmaz ve ikisi de yapıtın nasıl yayımlandığına ilişkin özelliklerdir.
Paketin en üst düzeyinde varlık belgesi yok. Paket, en üst düzeyinde varlık olmadan paketlenmiştir: belgesi dışarıda bırakılmış ya da taşıdığı dosyaların yanına değil bir alt dizine yerleştirilmiştir. İleti, paketin en üst düzeyinde gerçekte neler bulunduğunu listeler; bu, genellikle hangisinin olduğunu görmek için yeterlidir.
Paketin en üst düzeyinde iki varlık belgesi var. Paket, içinde iki varlığın yazıldığı bütün bir dizinden paketlenmiştir. aggrega push bunu hiçbir zaman yapmaz, çünkü her varlık yalnızca bildirdiği dosyaları taşır; ancak başka bir istemci yapabilir. Bu şekilde paketlendiğinde, her iki varlığın yayımlanmış koordinatları aynı baytları taşır; bu nedenle herhangi biriyle yanıt vermek, istenen adın altında öteki varlığı geri döndürür ve sonraki adımlardan hiçbiri bunu fark edemez. Yapılabilecek güvenli bir seçim olmadığından hiçbir seçim yapılmaz.
Yayımlanan iletiler, bulunanları listeleyerek. Paket başka dosyalar taşıdığında hiç varlık yoksa:
bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (paket kökü, listelenen dosyalar arasında hiçbir varlık belgesi taşımıyor: oci: yayımlanan paket hiçbir varlık belgesi taşımıyor)
paket hiçbir şey taşımadığında hiç varlık yoksa:
bundle root carries no files at all: oci: published bundle carries no entity document (paket kökü hiç dosya taşımıyor: oci: yayımlanmış paket hiçbir varlık belgesi taşımıyor)
ve hem sayıyı hem de çakışan belgeleri adlandıran birden fazla varlık durumunda:
bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (paket kökü <count> varlık belgesi taşıyor (<file>, <file>): oci: yayımlanan paket birden fazla varlık belgesi taşıyor)
Nasıl düzeltilir: her iki durumu da sizin değil yayımcının gidermesi gerekir ve düzeltme, varlığın yayımlandığı sürüm dizinindedir. Her varlığa kendine ait bir sürüm dizini verin; böylece bu dizin tek bir varlığı ve ona ait dosyaları barındırır. Bu, yayımlanmış her varlığın zaten izlediği düzendir: dizin, varlığın metadata.version değerine göre adlandırılır ve varlığın kendi adının altında yer alır. Ardından yeni bir sürümle yeniden yayımlayın: yayımlanmış baytlar dondurulmuştur, bu nedenle mevcut sürümün üzerine yeniden yayımlama düzeltilmez, reddedilir. Yayımlamak yerine tüketiyorsanız iletiyi yapıtı yayımlayan kişiye iletin; içindeki dosya adları bölünmesi gereken dizini belirtir.
A published artifact cannot be read as an entity (Yayımlanmış bir yapıt varlık olarak okunamıyor)
Bir varlığı yayımlandığı koordinattan okumak, kayıt defterinin orada sunduğu baytlardan başlar: aggrega inspect oci://… bunları incelemeniz için okur ve bir bağımlılık çekme işlemi de sabitlediği sürümü bulmak için bir arşivin baytlarını aynı şekilde okur. Bu baytların iki biçimi okunacak hiçbir varlık içermez.
Açılmayan bir arşiv. Bildirdiği dosyalarla yayımlanan bir varlık bir .tar.gz olarak yayımlanır ve baytlar da böyle başlar, ancak sıkıştırma akışı ya da içindeki arşiv düzgün biçimli değildir; çoğu zaman bunun nedeni kesik kalmış olmasıdır. Baytlar yine de yapıtın kendi manifest’inin onlar için kaydettiği özetle eşleşir, yani tam olarak yayımlanan şeydir: hasar size ulaşırken değil, yayımlamadan önce ya da yayımlama sırasında oluşmuştur.
Varlık olmayan bir belge. Koordinat tek bir belge taşır ve bu belge ayrıştırılamaz, hiçbir kind: bildirmez ya da Release veya Manifest gibi hiçbir zaman yayımlanmayan bir tür bildirir. Bu durumda başvuru bir varlığı değil, kataloğun yanında yayımlanmış başka bir şeyi, örneğin aggrega push-artifact ile yayımlanmış bir veri yapıtını adlandırır.
Yayımlanan iletiler. Sıkıştırma akışı düzgün biçimli olmayan bir arşiv, onu durduran hatayla birlikte:
oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: gzip paketi açılamadı: <archive error>: oci: yayımlanan paket açılamıyor)
bir dosyanın ortasında duran bir arşiv:
read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (yayımlanan paketten <file> okunurken: <archive error>: oci: yayımlanan paket açılamıyor)
hiçbir zaman yayımlanmayan bir tür bildiren bir belge:
the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (yayımlanan belge, bir kayıt defterinin yayımlamadığı <kind> türünü bildiriyor: oci: yayımlanan yapıt bir varlık belgesi değil)
ve hiç belge olmayan baytlar:
the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (yayımlanan baytlar bir belge olarak ayrıştırılamıyor (<parse error>): oci: yayımlanan yapıt bir varlık belgesi değil)
Nasıl düzeltilir: açılmayan bir arşivi yayımcının değiştirmesi gerekir. Yayımlanmış baytlar dondurulmuştur, bu nedenle çözüm varlığı yeni bir sürümle yeniden yayımlamaktır; onu tüketiyorsanız iletiyi yayımlayan kişiye iletin. Varlık olmayan bir belge neredeyse her zaman başvurunun kastettiğiniz başvuru olmadığı anlamına gelir: başvurunun bir varlığın yayımlandığı koordinatı adlandırdığını denetleyin; bu, aggrega push bir varlığı yayımladığında yazdırdığı başvurudur.
The registry could not answer what is attached to an artifact (Kayıt defteri bir yapıta neyin ekli olduğunu yanıtlayamadı)
İmzalar ve diğer ekler bir yapıtın içinde durmaz, ona bağlı olarak asılı durur ve bunları bulmak kayıt defterine yöneltilen bir sorudur. Bu durum, sorunun yanıtsız kaldığını söyler: kayıt defteri bu sorguyu sunmuyordur, eklerin bağlı olduğu yapıt bulunamamıştır ya da isteğin kendisi başarısız olmuştur.
Bu, “hiçbir şey ekli değil” yanıtıyla aynı şey değildir ve bu ikisinin karıştırılmasını önlemek tam da bu durumun var olma nedenidir. Gerçekten hiç imza taşımayan bir yapıt normal biçimde çözümlenir ve boş bir liste verir. Bu durum ise listenin hiç elde edilmediğini, dolayısıyla neyin ekli olduğu hakkında hiçbir şeyin bilinmediğini söyler.
Derlemenin durup durmadığı imzanın zorunlu olup olmadığına bağlıdır ve her iki yön de bilinçli olarak seçilmiştir:
İmza zorunludur. Derleme durur. Çalıştırılamayan zorunlu bir denetim geçilmiş sayılmaz ve yapıtı kabul etmek, kimsenin soramadığı bir soruya dayanmak olur.
İmza zorunlu değildir. Derleme devam eder ve bunu sessizce değil, açıkça bildirir. Sorgu her iki durumda da doğrulanacak bir şey üretmemiştir; bu nedenle reddetmek, bir yapıtı yanıtsız bir soruya dayanarak geri çevirmek olur. Ancak sessiz kalmak, temiz ve imzasız bir çekme işlemi gibi okunur; oysa durum bu değildir.
Yayımlanan iletiler. Sorguyu sunmayan bir kayıt defteri:
oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: hedef, başvuran keşfini desteklemiyor: <target kind>: oci: başvuran keşfi tamamlanamadı)
yapıtın kendisinin bulunamaması:
oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: “<reference>” öznesi çözümlenemedi: <the underlying failure>: oci: başvuran keşfi tamamlanamadı)
ve sorgunun başarısız olması:
oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: “<reference>” başvuranları listelenemedi: <the underlying failure>: oci: başvuran keşfi tamamlanamadı)
İmza zorunlu olmadığında aynı metin bunun yerine bir bildirim olarak görünür:
signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (<uri> için imza doğrulaması çalıştırılamadı (kayıt defteri imza sorgusunu yanıtlayamadı ve imza gerekmiyor; devam ediliyor): yukarıdaki ileti)
Nasıl düzeltilir: düzeltme operatöre düşer ve sorun kataloğunuzda değil kayıt defterindedir. Kayıt defteri ek sorgularını hiç sunmuyorsa imza taşıyamaz; bu durumda ya yapıtı bunu yapabilen bir kayıt defterine yansıtın ya da .aggrega-config.yaml içinde o ana makineden imza istemeyi bırakın. Hangisini seçtiğinizi not edin, çünkü ikincisi o ana makineden gelen imzaların artık denetlenmediği anlamına gelir. Sorguyu sunan bir kayıt defterinde sorgu başarısız olduysa bu, özellikle ek uç noktasındaki bir aktarım ya da izin sorunudur ve kayıt defterine erişilebildiğinde yeniden çalıştırmak çözümün tamamıdır.
An artifact that must be signed carries no signature (İmzalanması gereken bir yapıt imza taşımıyor)
Bir yapıt için imza, çalışma alanının kendi imzalama politikası yapıtın türünü kapsadığında ya da yapıtın geldiği kayıt defteri imza gerektirecek şekilde yapılandırıldığında gereklidir. Bu durum, kayıt defterinin ek arama sorgusunu yanıtladığını, hiçbir şeyin ekli olmadığını ve bir imzanın gerekli olduğunu bildirir.
İki gereklilik, iki kapsamda okunan tek bir tutumdur. Çalışma alanı genelindeki politika, kapsamdaki bir tür için, kendi girdisi imza gerektirmeyen bir ana makineden gelse bile imzayı zorunlu kılar; dolayısıyla hiçbir şey gerektirmeyen bir ana makine, çalışma alanı genelindeki politikanın kapsadığı bir yapıtı muaf tutmaz.
İmza gerekmediğinde bu hiç de bir hata değildir. Yapıt, imza varsa doğrulanır, yoksa sessizce geçer; yapılandırılmış bir tutumu olmayan bir ana makinenin törensiz kullanılabilmesini sağlayan da budur.
Çalışma alanı genelinde bir politika etkinken türü belirlenemeyen bir yapıt, muaf değil imza gerektiren bir yapıt olarak ele alınır; böylece sınıflandırılamayan bir yapıt, açık olan bir politikanın gözünden kaçamaz.
Denetlediği başvuruyla çerçevelenen, yayımlanan ileti:
verifying the signature of <uri>: signing: no signature found for an artifact that requires one (<uri> imzası doğrulanıyor: signing: imza gerektiren bir yapıt için imza bulunamadı)
Nasıl düzeltilir: düzeltme varlık yazarının değil, operatörün ya da yayımcının işidir. Yapıtın imzalı olmasını bekliyorsanız yapıt imzasız yayımlanmıştır; başvuruyu yapıtı yayımlayan kişiye iletin, çünkü imzayı yalnızca o ekleyebilir. Yapıtın imzalanması amaçlanmıyorsa değiştirilmesi gereken şey gerekliliktir: gereklilik ya kayıt defterinin .aggrega-config.yaml içindeki girdisinden ya da çalışma alanı genelindeki imzalama politikasından gelir ve iletideki başvuru hangi ana makineye bakmanız gerektiğini söyler. Bir gerekliliği kapatmak, o ana makineden gelen yapıtların artık denetlenmemesi anlamına gelir; bu nedenle politikayı tamamen kapatmak yerine kapsamını bir türe daraltmayı tercih edin.
A signature does not verify (Bir imza doğrulanmıyor)
Bir imza bulunmuş ve denetlenmiş, denetim başarısız olmuştur. Bu, söz konusu denetimin genel olumsuz sonucudur: güven malzemesine kök salmayan bir sertifika zincirini, gerektiği hâlde şeffaflık günlüğü kaydı olmayan bir imzayı, eldekinden farklı bir yapıt üzerine atılmış bir imzayı, değiştirilmiş bir paketi ve sabitlenmiş bir anahtara karşı denetlenip o anahtarla doğrulanmayan bir paketi kapsar.
Bu durum, imzalayanı güvenilir olmayan bir imzadan bilerek ayrı tutulur. O imza yapısal olarak sağlamdır ve yanlış imzalayan tarafından atılmıştır; bu ise hiç doğrulanamamıştır. İkisini ayrı tutmak, “yapıt imzalanan şey değil” ile “yapıt, kabul etmediğiniz biri tarafından imzalanmış” durumlarını ayırt etmenizi sağlar.
Bir imzanın hangi yapıt için atıldığı iki kez denetlenir. İmzanın kriptografik denetimi geçtiğinde araç zinciri, imzanın hangi yapıt için atıldığını imzanın kendisinden okur — sonraki her derlemenin kaydedilmiş imzayı tuttuğu aynı okumadır bu ve bir derlemenin, hiçbir şeyi doğrulamadan bir yapıttan diğerine kopyalanmış bir imzayı reddetmesini sağlayan da budur — ve bu okuma eldeki yapıtı adlandırmadığında ya da imza, okumanın yapıtı ayırt edemediği bir biçimde olduğunda imzayı reddeder. Bir çekme işleminin kabul ettiği her iki biçim de okunur: yapıtın kendisi üzerine atılmış bir imza ve onu adlandıran imzalı bir beyan. Okuma, kriptografik denetimin kendi kurallarını izler; dolayısıyla bu denetimin kabul ettiği bir imza üzerinde ikisi uyuşur. Bu türden bir ret, uyuşmadıkları anlamına gelir ve yapılandırmayla etrafından dolaşmak yerine başvuru ve iletiyle birlikte bildirilmeye değerdir.
Bir kayıt defterinin girdisi doğrulamayı tavsiye niteliğinde olarak işaretlediğinde aynı metin bir bildirim olarak raporlanır ve çalıştırma sürer.
Yayımlanan iletiler. Doğrulayıcının bildirdiğini aktaran, denetimin kendisinden gelen ileti:
signing: signature bundle does not verify: <what the verifier reported> (signing: imza paketi doğrulanmıyor: doğrulayıcının raporladığı)
ve kriptografik denetim geçtiği hâlde imzanın hangi yapıt için atıldığına ilişkin okuma uyuşmadığında:
signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (signing: imza paketi doğrulanmıyor: kriptografik denetimi geçiyor, ancak belirtilen manifest özetini atıldığı yapıt olarak adlandırmıyor)
signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (signing: imza paketi doğrulanmıyor: kriptografik denetimi geçiyor, ancak atıldığı yapıtın okunamadığı bir biçimde)
her biri doğrulanan başvuruyla çerçevelenir:
verifying the signature of <uri>: <the message above>
ve kayıt defterinin girdisi doğrulamayı tavsiye niteliğinde kıldığında, durdurma yerine bir bildirim olarak:
signature verification failed for <uri> (advisory; continuing): <the message above>
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz ve hiçbir yazım değişikliği bunu gidermez. Bunu yapılandırmanız hakkında değil, yapıt hakkında bir beyan olarak ele alın: eldeki baytlar imzalanan baytlar değildir ya da imza, yapılandırılmış güven malzemesinin denetleyebileceği bir imza değildir. Önce yapıtı yeniden edinin; kesilmiş ya da değiştirilmiş bir önbellek kopyası tam olarak bu şekilde başarısız olur ve yeni bir getirme bunu giderir. Yeni bir getirmeden sonra da sürüyorsa başvuruyu ve doğrulayıcının kendi sözlerini yapıtı yayımlayan kişiye iletin. Bunu aşmak için tavsiye ayarına başvurmayın — bu ayar denetimi çalışır tutar ve durdurmasını engeller; bu, bir hatayı düzeltmenin yolu değil, o ana makineden gelen doğrulanmamış yapıtları kabul etmeye yönelik bilinçli bir seçimdir.
A signature verifies but its signer is not one the registry trusts (Bir imza doğrulanıyor ancak imzalayanı kayıt defterinin güvendiği biri değil)
İmza doğrulanmıştır — sertifika zinciri güven malzemesine kök salar ve şeffaflık kaydı mevcuttur — ancak o sertifikadaki kimlik, kayıt defteri için kabul edilebilir olarak yapılandırılmış kimliklerin hiçbiriyle eşleşmez. Yapıt, kabul edilmemiş gerçek bir imzalayan tarafından imzalanmıştır.
Bir kimliğin iki yarısı da karşılaştırılır: özne ve ona kefil olan veren; eşleşmeyen herhangi biri olabilir. İleti, sertifikadan okunabildiğinde ikisini de adlandırır; çünkü kimsenin kabul etmediği bir veren altında beklenen bir özne sunan imzalayan, ikisi de gösterilmedikçe yanlış bir özneden ayırt edilemez.
Yayımlanan iletiler. İki yarı da okunabildiğinde:
signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (signing: imza kimliği bu kayıt defteri için güvenilir değil: doğrulayıcının raporladığı; imzalayan belirtilen vereni belirtilen kimlikle sundu, ancak hiçbir güvenilir kimlik bu verene izin vermiyor)
ve okunamadıklarında, doğrulayıcının kendi raporuna geri dönülerek:
signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: imza kimliği bu kayıt defteri için güvenilir değil: doğrulayıcının raporladığı)
Nasıl düzeltilir: bu operatörün kararıdır ve bir formalite değil, gerçek bir karardır. İletideki vereni ve kimliği, .aggrega-config.yaml içinde o kayıt defteri için yapılandırılmış güvenilir kimliklerle karşılaştırın. İmzalayan kabul etmek istediğiniz biriyse onu ekleyin — bir girdi, veren ile birlikte bir kimliği ya da onunla eşleşen bir deseni adlandırır ve ikisinin de doğru olması gerekir. Değilse yapıt, kabul etmediğiniz biri tarafından imzalanmıştır ve derlemeyi geçirmek için kimliği eklemek kaçınılması gereken tek tepkidir. Kendi güven politikasını duyuran kayıt defterlerinde bu politika, kayıt defteri eklenirken sabitlenebilir; amaçlanan kimlikleri elle yazmadan eklemenin yolu budur.
A keyless trust policy names no acceptable signer (Anahtarsız bir güven ilkesi kabul edilebilir hiçbir imzacı belirtmiyor)
Anahtarsız doğrulama, bir yapıtın kabul edilip edilmeyeceğine, imzalama sertifikasındaki kimliği kabul edilebilir olarak yapılandırılmış bir kimlikler kümesiyle eşleştirerek karar verir. Boş bir küme bir ilke olarak ele alınmaz, reddedilir: hiçbir şeyle eşleştirme ya her imzacıyı kabul eder ya da hepsini reddeder ve doğrulamayı yapılandıran bir operatörün kastettiği bunların hiçbiri değildir.
Koşulun kendi cümlesi olan, verilen ileti:
signing: keyless verification requires at least one trusted identity (signing: anahtarsız doğrulama en az bir güvenilir kimlik gerektirir)
Nasıl düzeltilir:.aggrega-config.yaml içinde kayıt defteri için en az bir güvenilir kimlik yapılandırın. Bir girdi, kimliği — tam bir özne ya da onunla eşleşen bir desen olarak — ona kefil olan yayımcıyla birlikte belirtir ve ikisi de gereklidir. Kayıt defteri kendi güven ilkesini duyuruyorsa, kayıt defteri eklenirken bu ilkeyi sabitlemek kümeyi kayıt defterinin yayımladıklarıyla doldurur. Bu kayıt defterinden gelen imzaları hiç doğrulamak istemiyorsanız, bu boş bir kimlik kümesinden farklı bir ayardır ve bunu açıkça ayarlamak bunu ifade etmenin yoludur.
The pinned trust root cannot be read (Sabitlenmiş güven kökü okunamıyor)
Çalışma alanında sabitlenmiş bir güven kökü, anahtarsız bir denetimin nerede çalışırsa çalışsın ağ erişimi olmadan doğrulama yapmasını sağlayan şeydir: içeriği, her imzanın karşısında denetlendiği malzeme olan bir dosya. Bu koşul, yapılandırılmış yoldaki dosyanın kullanılabilir güven malzemesine dönüştürülemediğini bildirir — dosya yoktur, okunamaz ya da içeriği bir güven kökü değildir.
Bir yedeğe dönmek yerine durur. Sabitlenmiş bir kök, imzaları sizin denetiminizdeki malzemeye karşı denetlemek için bilinçli bir seçimdir; bu yüzden onun yerine sessizce bir kök getirmek bu seçimi başka biriyle değiştirir ve kimsenin istemediği bir doğrulama sonucu üretir.
Yolu belirten ve okumanın bildirdiğini aktaran, verilen ileti:
Nasıl düzeltilir: bu operatörün işidir. Güven kökü için yapılandırılan yolun var olduğunu ve komutu çalıştıran kişi tarafından okunabildiğini denetleyin — başka bir çalışma dizinine göreli bir yol da, var olan ama okunamayan bir dosya da burada bildirilir. Dosya var ve okunabiliyorsa içeriği bir güven kökü değildir; bu durumda dosyayı düzenlemek yerine onu edindiğiniz kaynaktan güncel bir paketle değiştirin. Sabitlenmiş bir kök amaçlanmadıysa değiştirilmesi gereken yapılandırmadır: sabitlemeyi kaldırın; doğrulama aksi hâlde kendisine verilecek malzemeyi kullanır.
A pinned verification key is not the key profile the verifier accepts (Sabitlenmiş bir doğrulama anahtarı, doğrulayıcının kabul ettiği anahtar profilinde değil)
Elde tutulan bir anahtarla imzalama ve doğrulama tek bir anahtar profili kullanır; başka türden bir anahtar denenmez, reddedilir. Bu, anahtarın türüyle ilgili bir ifadedir; anahtarın herhangi bir şeyi doğrulayıp doğrulamadığıyla ilgili değildir.
Bildirildiği iki an farklı işlerdir. Biri, imzalamak için bir anahtar yüklemektir ve bir yapıtın yayımlandığı yerde olur; diğeri, bir imzayı bir kayıt defteri için sabitlenmiş bir anahtara karşı denetlemektir ve bir yapıtın doğrulandığı yerde olur. Ret ikisinde de aynıdır.
Verilen iletiler; her biri gerçekte sağlanan anahtarın algoritmasını belirtir — an RSA key ya da an Ed25519 key. Sabitlenmiş bir doğrulama anahtarı için:
signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: desteklenmeyen tutulan anahtar türü: tutulan anahtar belirtilen algoritmayı kullanıyor, beklenen ECDSA P-256)
Nasıl düzeltilir: iletinin belirttiği profilde bir anahtar sağlayın. Doğrulama yapıyorsanız anahtar, .aggrega-config.yaml içinde kayıt defteri için sabitlenmiş olandır ve yayımcının imzaladığı anahtarın açık yarısı olmalıdır — buradaki bir uyumsuzluk genellikle yanlış dosyanın sabitlendiği anlamına gelir, çünkü türü doğru ama kendisi yanlış olan bir anahtar bunun yerine doğrulanmayan bir imza olarak bildirilir. İmzalama yapıyorsanız belirtilen profilde bir anahtar üretin ya da hiç tutulan anahtar gerektirmeyen anahtarsız yolu kullanın.
The workspace is offline and the step needs the network (Çalışma alanı çevrimdışı ve adım ağa ihtiyaç duyuyor)
Bir çalışma alanı çevrimdışı olarak işaretlenebilir ve bu ayar bir tercih değil, bir rettir: ağa ulaşacak her adım, herhangi bir bağlantı kurulmadan önce, oluşturulduğu yerde reddedilir. Erken reddetmek, hatanın daha sonra açıklamasız bir zaman aşımı olarak ortaya çıkması yerine “bu çalışma alanı çevrimdışı” demesini sağlar.
Tek bir karar, tek bir yerde okunur. Ağa ulaşılıp ulaşılamayacağını önceden bilmesi gereken bir adım, getirmenin kendisinin sorduğu soruyu sorar; böylece bir denetim ve koruduğu işlem farklı sonuçlara varamaz.
Birkaç türde işi etkiler ve hepsi aynı rettir: bir kayıt defterinden yapıt edinmek, bir Recipe’in kaynağını ağ üzerinden edinmek, bir dış girdiyi getirmek, imzalamak için bir kimlik edinmek ve güven malzemesi getirmek. Dolu bir önbelleği okuyan bir derleme bunların hiçbirine ulaşmaz; ayarın amacı da budur.
Komutun tamamı bir ağ gidiş dönüşü olduğunda ret sonda değil, başta gelir.push, push-artifact ve registry update bir kayıt defterine ulaşmak için vardır; bu yüzden varlığınızı okumadan ya da depolarınızı dolaşmadan önce bunu söylerler ve duruşu üç yerden hangisinin ayarladığını belirtirler — yazdığınız bayrak, ortam değişkeni ya da dosya ve içindeki anahtar. --dry-run istisnadır ve adı nedeniyle değil, yaptığı iş nedeniyle istisnadır: neyi yayımlayacağını bildirir ve hiçbir şey çağırmaz; bu yüzden bir yayımlamanın çevrimdışı güvenli biçimidir ve çalışmaya devam eder.
Kendi çözümünü taşıyan ve koşulun kendi cümlesi olan, verilen ileti:
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 (egress: çalışma alanı çevrimdışı olduğu için ağ erişimi reddedildi; çözüm: yalnızca bu çalıştırma için ağa izin vermek üzere —offline=false verin ya da bundan sonra izin vermek için yapılandırma dosyasındaki üst düzey offline anahtarını (veya AGGREGA_OFFLINE’ı) temizleyin; iş, makinede bulunmayan içeriğe ihtiyaç duyan bir derlemeyse önbelleği doldurmak için önce bağlı bir ortamdan aggrega pull —release <release> çalıştırın)
Ağa ihtiyaç duyan şeyle çerçevelenir — örneğin bir Recipe’in kaynağını edinmek:
Çevrimdışı bir çalışma alanında resmi hub’ı eklemek reddedilmez: hub yerleşik temel yapılandırmasıyla eklenir ve bildirim, çalışma alanı çevrimdışı olduğu için hub’dan güven ilkesinin istenmediğini söyler.
Nasıl düzeltilir: ileti üç yol belirtir ve hangisinin geçerli olduğuna siz karar verirsiniz. Duruş ayarlıysa ve yalnızca bu komut için onu aşmak istiyorsanız --offline=false verin; bayrak bunun içindir ve yapılandırma dosyasını kendisi yazmamış biri için mevcut tek yanıttır. Çalışma alanının çevrimdışı olması amaçlanıyorsa düzeltilmesi gereken eksik içeriktir: önbellek, sürümün ulaştığı her şeyi tutsun diye çekmeyi ağ erişimi olan bir yerden çalıştırın; bundan sonra çevrimdışı derleme başka bir şeye ihtiyaç duymaz. Hiç çevrimdışı olması amaçlanmıyorsa ayarı kaynağında temizleyin — .aggrega-config.yaml içindeki üst düzey offline anahtarı ya da iletinin belirttiği ortam değişkeni; herhangi bir dosyada bulunmadığı için insanları şaşırtan genellikle değişkendir. Çevrimdışı bir çalışma alanının anahtarsız yolla hiç imzalayamayacağını unutmayın; çünkü bir sertifika düzenlemek ve onu kaydetmek, çevrimdışı biçimi olmayan ağ işlemleridir.
Topoloji oluşturulurken
Her Component çözümlenmiş bir Recipe’e sahip olduğunda derleyici, her Component’in uses: bloğunu okuyup hedefleri ve feature eklerini çapraz denetleyerek Components’i IR grafiğinde birbirine bağlar.
Boşta kalan uses hedefi
Bir uses: kenarı, çözümlenmiş topolojide bulunmayan bir hedef bileşeni adlandırır. Bu durdurma kaynaktan bağımsızdır: geliştiricinin yazdığı bir Aggregate kenarı ile Release tarafından bağlanan bir kenar aynı biçimde yakalanır. Boşta kalan bir hedef sessizce atlanmaz, ölümcül bir durdurmadır: aksi halde var olmayan bir hedefe giden kenar kaybolur ve tüketicinin enjekte edilen değerleri dağıtım anında sessizce boş kalırdı. Bu durum, aşağıdaki bildirilmemiş soket durdurmasının yapısal kardeşidir: bir bağlantı hangi sokete bağlanırsa bağlansın, kenarın tür denetimi yapılmadan önce hedefinin var olan bir bileşene çözümlenmesi gerekir.
Üretilen ileti. Önce ret gelir, ardından hiçbir şeye karşılık gelmeyen hedef ve bağlantının bağlandığı soket, ardından ne yapılacağı:
uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (uses kenarının hedefi mevcut değil (<target>, <socket> soketine bağlı). Hedefi Aggregate’in bildirdiği bir bileşene yönlendirin veya bu adla bir bileşen bildirin.)
Bulgu, ilgili olduğu yazılmış girdinin konumunda, o girdinin yazıldığı belgede gösterilir; böylece bir bileşenin kendi uses: bloğunun çizdiği bağlantı, bir ekin yansıttığı bağlantı ve bir Release’in bağladığı bağlantı her biri kendi bloğunda raporlanır. Kurala aykırı her bağlantı ayrı bir bulgu olarak raporlanır; böylece tek bir derleme ilkinde durmak yerine hepsini adlandırır.
Nasıl düzeltilir: eksik hedef bileşeni bildirin ya da uses: girdisindeki hedef adını var olan bir bileşenle eşleşecek biçimde düzeltin.
Bir bileşenin tek bir takma ad altındaki iki bağlantısı
Bir bileşen, bağlantılarının her birini takma adıyla okur: bağlantının altında yazıldığı anahtar ya da liste girdisi olarak yazılmış bir bağlantı için hedefinin kendi adı. Bir Recipe şablonu bir bileşenin bağlantılarını yalnızca takma ada göre anahtarlanmış olarak, bir doğrulama ise önce sokete sonra takma ada göre anahtarlanmış olarak okur; dolayısıyla bir bileşenin tek bir takma ad altındaki iki bağlantısı bu görünümlerden en az birinde tek bir yuvayı paylaşırdı: sonraki yuvayı alır, diğeri ise şablonun ya da doğrulamanın gördüğünden eksik kalırdı. Bu nedenle bir takma ad, bir bileşenin tek bir bağlantısını adlandırır; her birinin hangi sokete bağlı olduğundan, onu neyin çizdiğinden (bileşenin kendi uses: bloğu, herhangi bir kapsamdaki bir ekin uses: bloğu ya da bir Release kenar başına girdisi) ve hedefinin ne olduğundan bağımsız olarak. Böyle bir çift, grafik kesinleştiğinde, herhangi bir doğrulama çalışmadan ve herhangi bir şey işlenmeden önce derlemeyi durdurur.
Çift, her yüzeyde tek başına geçerli olan yazımdan doğar: bir bileşenin kendi girdisi ile bir ekin girdisinin tek bir soket ve takma adda olması; bir hedefi iki kez adlandıran bir liste (models: [llama, llama]); iki sokette yazılmış tek bir takma ad (databases: { local: … } yanında models: { local: … }); tek bir takma adı bağlayan iki ek; ya da Aggregate’in bağlanmamış bıraktığı bir sokette, Aggregate’in başka bir sokette zaten kullandığı bir takma ad altında bağlantı çizen bir Release girdisi. Komşu iki biçim bu durdurmaya hiç ulaşmaz: anahtarlı girdilerden oluşan tek bir blokta iki kez yazılmış tek bir anahtar belgenin yüklenmesini başarısız kılar; başka bir bloğun zaten çizdiği bir soket ve takma addaki bir Release girdisi ise ikinci bir bağlantı çizmek yerine o bağlantıyı yapılandırır ya da farklı bir hedef adlandırıyorsa yeniden hedefleme olarak durdurur.
Üretilen ileti. Önce ret gelir, ardından takma ad ve bileşen, ardından bu bağlantının soketi, hedefi ve girdisinin yazıldığı yer, ardından takma adı zaten tutan bağlantı için aynıları, ardından ne yapılacağı:
connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (bağlantı takma adı aynı bileşenin başka bir bağlantısı tarafından zaten kullanılıyor (<alias>, <component> bileşeninde, bu bağlantı <socket> soketine bağlı, hedefi <target>, <file> içinde, <key path> konumunda yazılmış; takma adı zaten tutan bağlantı <socket> soketine bağlı, hedefi <target>, <file> içinde, <key path> konumunda yazılmış). İki bağlantıdan birine kendine ait bir takma ad verin: bir bileşen, hangi sokete bağlı olursa olsun her bağlantıyı takma adıyla okur. Bir liste girdisi takma ad olarak hedefinin adını alır; bu nedenle iki kez listelenen bir hedef bir kez listelenir ya da iki takma ad altında iki anahtarlı girdi olarak yazılır.)
Her iki bağlantı tek bir anahtar yolunda yazılmışsa (bir hedefi iki kez adlandıran bir liste), her biri o listedeki yeriyle de adlandırılır: list entry "1" yanında list entry "2"; iki girdiyi birbirinden ayıran tek şey budur.
Bulgu, sonraki bağlantının kendi girdisinin konumunda (ikinci çizilen, yani aksi halde takma adın yuvasını almış olacak girdi), o girdinin yazıldığı belgede gösterilir. Dolayısıyla bir Release girdisi ya da Release’in yazdığı bir ek bir operasyon hatası, Aggregate’teki bir girdi ise bir geliştirici hatası olarak kaydedilir. Kurala aykırı her bağlantı ayrı bir bulgu olarak raporlanır; böylece tek bir derleme hepsini adlandırır.
Bazı biçimler daha az kesin adlandırılır. Birden fazla kapsamda bildirilmiş bir ek adı (örneğin bir bileşende ve onu tutan alt sistemde) bildiren her bloktan bir bağlantı çizer ve derleme ikisini de yalnızca ekin adı altında kaydeder. Bu durumda iki bağlantı da bildiren bloklardan birinde (ad orada bildirilmişse bileşenin kendi ek bloğunda) adlandırılır ve hiçbiri liste konumu taşımaz. Aynısı içe aktarılmış bir Aggregate içinde de geçerlidir; orada bildiren bloklar (bir bileşenin bloğu ve modülün kendi alt sistemlerinden birinin bloğu) modülün kendi belgesinde adlandırılır. Bu biçimlerin her birinde çift yine reddedilir.
Nasıl düzeltilir: iki bağlantıdan birine kendine ait bir takma ad verin. Bir hedefi iki kez adlandıran bir liste için hedefi bir kez listeleyin ya da iki bağlantıyı iki takma ad altında anahtarlı girdiler olarak yazın. İki soketteki tek bir takma ad için iki anahtardan birini yeniden adlandırın. Bileşenin zaten kullandığı bir takma ad altında bir soketi bağlayan bir ek, kendi uses: bloğunda farklı bir anahtar alır.
uses: socket not declared in the owning entity’s usesSchema (uses soketi sahip varlığın usesSchema alanında bildirilmemiş)
Bir uses: bloğu, yüzeyin sahibi olan varlığın kendi usesSchema alanında bildirmediği bir soketi adlandırıyor; bu, yalnızca bildirilmiş bir soketin adlandırılabildiği iki yüzeyden birinde olur: soketin eklenen Feature üzerinde bildirilmiş olması gereken bir Feature ekininuses: bloğu ve soketin tüketen Component üzerinde bildirilmiş olması gereken bir Release’in kenar başına uses: bloğu. Bir Release, kenarları yalnızca Component’in usesSchema alanının zaten bildirdiği soketler içinde bağlayabilir veya yapılandırabilir.
Ek yüzeyi, bir ekin yazıldığı her kapsamda denetlenir: bir bileşende, bir alt sistemde (Aggregate’in ya da onun içe aktardığı bir modülün), bir Release sınırında ve bir Release bileşen girdisinde; bir modülün katkıda bulunduğu bileşenin girdisi de buna dahildir. Bir modülün kendi bildirimleri, onu içe aktaran bileşim derlendiğinde denetlenir ve bulgu, modülün Aggregate’ini ve onun belgesindeki anahtarı adlandırır.
Bir bileşenin kendiuses: bloğu bilerek bu yüzeylerden biri değildir; bu nedenle bu durdurma onun için tetiklenmez. Aggregate’in bildirdiği topolojinin sahibi geliştiricidir ve kataloğun bildirmediği bir soketi adlandırabilir; kataloğun bir soket hakkında sessiz kalması, bağlantının öngörülmediği anlamına gelir, yasak olduğu anlamına gelmez. Böyle bir soket geçerlidir ve kenarı oluşturulur; vazgeçilen şey, bildirilmiş bir soketin taşıdığı seçici ve kenar başına sözleşmedir. Dolayısıyla orada yanlış yazılmış bir soket adı bir durdurma değil, kendi başına geçici bir bağlantıdır ve her iki yazımı da adlandıran bir uyarı olarak raporlanır; bkz. warnings.md “Uses-socket near-miss lint”.
Üretilen ileti:
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 (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (bilinmeyen uses soketi: varlığın usesSchema’sında bildirdiği bir soketi adlandırın — kataloğun bildirmediği bir soketi yalnızca bir bileşenin kendi uses bloğu adlandırabilir; Release, konum, bileşen türü, soket adı ve bildirilmiş soketler belirtilir)
Ek kolu, bileşen türü yerine özellik türünü adlandırır; hiç usesSchema bildirmeyen eklenmiş bir Feature ise bunun yerine kendisi için uses: bildirimlerine izin verilmediğini raporlar.
Nasıl düzeltilir: bir ekte, soket adını eklenen Feature’ın bildirdiği bir soketle düzeltin veya o soketi Feature’ın usesSchema alanında bildirin. Bir Release kenar başına girdisinde, soket adını tüketen Component’in bildirdiği bir soketle düzeltin; bir Release, Component’in bildirmediği bir soketi ekleyemez ve desteklenen yol, bildirimi katalog varlığına taşımaktır. Katalog varlığı hiç usesSchema bildirmiyorsa, o yüzeyde hiçbir uses: bildirimini kabul etmez; bloğu kaldırın.
A connection carries an attachment under a name its socket declares no slot for (Bir bağlantı, soketinin hiçbir yuva bildirmediği bir ad altında bir ek taşıyor)
Bir bağlantı girdisinin features: bloğu, bağlantının soketindeki hiçbir yuvanın bildirmediği bir eki adlandırıyor. Bir bağlantının taşıdığı ekler kapalı bir kümedir: bağlantının üzerinden bağlandığı soket, tüketen Component’in usesSchema girdisindeki bir featuresSchema içinde, üzerindeki bir bağlantının doldurabileceği her yuvayı bildirir ve başka herhangi bir ad altındaki ek, derleme yüklenirken reddedilir. Hiç featuresSchema bildirmeyen bir soket, bağlantılarında hiçbir eke izin vermez; Aggregate’in adlandırdığı ama Component’in bildirmediği bir soket de izin vermez, çünkü böyle bir soket hiçbir yuva bildirmez.
Kural, bir bağlantının eklerini yazan her iki belgede de geçerlidir: Aggregate’in bir bileşenin uses: altındaki bağlantı girdisi ve Release’in kenar başına uses: girdisi. Bir alt aggregate’in katkıda bulunduğu bir bileşen için geliştiricinin adları, alt aggregate’in kendi belgesi okunduktan sonra denetlenir ve bulgu, o belgenin dosyasını ve bileşenin oradaki girdisini adlandırır. Release’in adları, kompozisyon düzleştirildikten sonra Release’in hedef aldığı her bileşen için denetlenir ve bulgu, Release’in kendi girdisini adlandırır: girdinin bulunduğu sınırın içinde ya da bir alt aggregate’in bileşenine ulaşan yönlendirme girdisinin altında. Component’in bildirmediği bir sokete ilişkin bir Release girdisi, bu durdurma yerine, var olan soketleri listeleyen yukarıdaki bildirilmemiş soket durdurması tarafından raporlanır.
Üretilen ileti. Önce ret gelir, ardından belge ve girdi, ekin adı, bağlantı, soket, bileşen ve soketin bildirdiği yuvalar; sonra da ne yapılması gerektiği:
a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (bir bağlantı, soketinin hiçbir yuva bildirmediği bir ad altında bir ek taşıyor. Eki soketin bildirdiği yuvalardan birinin altına yazın veya bu yuvayı Component üzerindeki soketin featuresSchema alanında bildirin.)
Ad, soketin bildirdiği bir yuvadan tek bir düzenleme uzaklıktaysa (yer değiştirmiş, düşmüş, ikilenmiş veya yanlış bir karakter; yani bir yazım hatasının aldığı biçim), o yuva hemen ardından adlandırılır; böylece büyük olasılıkla amaçlanan yazım aynı cümlede yer alır:
a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …)
Böyle bir ad için ayrı bir tavsiye üretilmez. Bir bileşenin kendi features: bloğunda, bildirilmiş bir yuvadan tek düzenleme uzaklıktaki bir ad geçerlidir ve yalnızca aşağıdaki “An attachment name is one edit from a declared slot” başlığı altındaki tavsiyeyi doğurur; bir bağlantıda ise ad reddedilir ve eşleştirmeyi retin kendisi taşır.
Soket hiçbir yuva bildirmiyorsa liste yer almaz ve öneri şöyledir: “The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component.” (Soket hiçbir yuva bildirmiyor, bu nedenle üzerinden bağlanan hiçbir bağlantı ek taşımaz: eki kaldırın veya yuvayı Component üzerindeki soketin featuresSchema alanında bildirin.) Component soketi hiç bildirmiyorsa öneri şöyledir: “The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema.” (Bileşenin türü bu soketi bildirmiyor, bu nedenle soket hiçbir yuva bildirmez ve üzerinden bağlanan hiçbir bağlantı ek taşımaz: eki kaldırın veya soketi ve yuvasını Component’in usesSchema alanında bildirin.)
Kurala uymayan her ek ayrı bir bulgu olarak raporlanır; böylece tek bir derleme hepsini adlandırır.
Nasıl düzeltilir: eki soketin bildirdiği bir yuvanın altına yazın; bağlantı soketin sahip olmadığı bir yuvaya ihtiyaç duyuyorsa, onu Component üzerindeki soketin featuresSchema alanında bildirin. Component’in bildirmediği bir sokette, soketi ve yuvasını Component’in usesSchema alanında bildirin veya eki kaldırın.
Release retargets a developer-declared edge (Release, geliştiricinin bildirdiği bir kenarın hedefini değiştiriyor)
Bir Release kenar başına uses: girdisi, geliştiricinin aynı soket ve takma ad için zaten bağladığı hedeften farklı bir hedef adlandırıyor. Bir Release, geliştiricinin bildirdiği bir kenarı yapılandırabilir (kenar başına infra ayarlayarak, aynı hedefi adlandırarak ya da hedefi atlayarak) ve bildirilmiş ama bağlanmamış bir sokete bir kenar bağlayabilir, ancak geliştiricinin bildirdiği bir kenarın hedefini değiştiremez; yazdığı mimarinin sahibi geliştiricidir.
İki hedef, çözümlendikleri hâliyle değil, yazıldıkları hâliyle karşılaştırılır. Bir target:, bir bileşen kimliği yerine bir alt Aggregate’in yayımladığı bir takma adı adlandırabilir ve bu takma ad, modülün onu yayımladığı bileşene çözümlenir; bu nedenle geliştiricinin yazdığı takma adın aynısını yineleyen bir Release girdisi bir yapılandırmadır ve tıpkı düz bir bileşen kimliğini yinelemek gibi kabul edilir.
Bu durdurma tetiklense de tetiklenmese de kenar, geliştiricinin ona verdiği hedefi korur ve Release girdisinin infra: değeri ona uygulanmaz. Reddedilen bir hedef değişikliği hiçbir zaman yarım uygulanmaz.
Üretilen ileti. Önce ret gelir, ardından geliştiricinin bildirdiği hedef, Release’in adlandırdığı hedef ve soket; ardından bu konuda yapılması gereken:
release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (release kenarı, geliştiricinin bildirdiği bir kenarı yeniden hedefliyor (bildirilen hedef "<declared-target>", Release’in adlandırdığı hedef "<release-target>", bağlandığı soket "<socket>"). Bağlantıyı bildirildiği gibi yapılandırmak için hedefi Release girdisinden kaldırın ya da hedefi bağlantının bildirildiği yerde değiştirin.)
Bulgu, bağlantının bildirildiği yazılmış girdiye, onu bildiren belgede konumlandırılır. Her sorunlu girdi ayrı bir bulgu olarak raporlanır; böylece tek bir derleme, her çalıştırmada bir tane yerine hepsini adlandırır.
Nasıl düzeltilir: mevcut kenarı yapılandırmak için (yalnızca kenar başına infra) farklı olan target değerini Release uses: girdisinden kaldırın ya da bağlantı gerçekten farklı bir sokete aitse onu geliştiricinin bağlanmamış bıraktığı bir soket üzerinden bağlayın. Hedefin kendisini değiştirmek için onu, topolojinin yazıldığı Aggregate’te değiştirin.
Release per-edge configuration has no edge to apply to (Release kenar başına yapılandırmasının uygulanacağı bir kenar yok)
Bir Release kenar başına uses: girdisi infra:, features: altında ekler ya da her ikisini ayarlıyor, ancak derlemedeki her kenar çizildikten sonra adlandırdığı tüketici, soket ve takma adda hiçbir kenar bulunmuyor.
Bir Release girdisinin yapabileceği iki şey bir kenarı bağlamak ve bir kenarı yapılandırmaktır; hangisini yaptığı, bir target: adlandırıp adlandırmadığına göre belirlenir. Hedefi olan bir girdi, yapılandırdığı kenarı oluşturur. Hedefi olmayan bir girdi ise zaten var olması gereken bir kenarı yapılandırır: geliştiricinin Aggregate’te bildirdiği ya da eklenmiş bir Feature’ın katkıda bulunduğu bir kenarı. Bu nedenle hiçbir hedef adlandırmayan ve var olan hiçbir kenarla eşleşmeyen bir girdi hiçbir şeye uygulanmaz: infra: bloğu ve altındaki ekler hiçbir çıktıya ulaşmaz. Derleme, hiçbir şey yapmayan bir yazımı kabul etmek yerine durur; çünkü aksi hâlde başarılı bir derleme, altyapının uygulandığının ve bağlantının girdinin ona koyduğunu taşıdığının onayı olarak okunur.
Takma ad, bir girdinin adlandırdığı şeyin parçasıdır; bu nedenle geliştiricinin hiç bildirmediği bir takma adı yapılandıran bir girdi, soket farklı bir takma ad altında bağlanmış olsa bile hiçbir kenara ulaşmaz. Aggregate’in bildirmediği bir bileşeni adlandıran bir girdi de öyle.
Yakın iki durum bu durdurmayla değil kendi durdurmalarıyla raporlanır, çünkü her birinin size söyleyecek daha fazlası vardır. Tüketen Component’in usesSchema içinde bildirmediği bir soket, var olan soketleri listeleyebilen bildirilmemiş soket olarak raporlanır. Hiçbir bileşeni adlandırmayan bir target:, sarkan hedef olarak raporlanır. Bir active: anahtarıyla kapatılan bir bileşen tasarım gereği kenarlarını da beraberinde götürür; bu nedenle onun üzerinde geride kalan bir girdi durdurulmak yerine kabul edilir.
Her sorunlu girdi raporlanır. Hiçbir kenara ulaşmayan birkaç girdisi olan bir Release, ilkini raporlayıp gerisini sonraki derlemeye bırakmak yerine, tek bir derlemede girdi başına bunlardan biriyle, belgenin onları bildirdiği sırayla durur.
Girdinin var olan bir bileşeni adlandırdığı durumda üretilen ileti. Girdinin kendisine giden yolu taşır; böylece onu içeren bileşen yerine düzenlenecek satır adlandırılır:
release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (release kenar başına yapılandırmasının uygulanacağı bir kenar yok (Release, .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias> konumunda, “<consumer>”, “<socket>” soketinde, “<alias>” takma adı altında). Kenarı bağlamak için girdiye bir hedef verin ya da girdiyi kaldırın: hedefi olmayan bir girdi, zaten var olması gereken bir kenarı yapılandırır.)
Bileşenlerini sınırlar altında değil en üst düzeyde adlandıran bir Release, yazarının yazdığı biçimi taşır (.spec.components.<consumer>.uses.<socket>.<alias>) ve bir aggregates: yönlendirme girdisi içinde adlandırılan bir bileşen, o girdi üzerinden, orada taşıdığı yerel ad altında adlandırılır.
Girdinin Aggregate’in bildirmediği bir bileşeni adlandırdığı durumda durdurma derlemenin daha erken bir aşamasından gelir ve girdinin ayarladığı şeyi (infra, features ya da infra and features) adlandırarak şöyle okunur:
release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology
Nasıl düzeltilir: girdiye, kenarı bağlayıp yapılandırmayı ona uygulayan bir target: ekleyin; girdinin var olan kenarı yapılandırması için takma adı Aggregate’in o bağlantı için bildirdiği takma adla düzeltin; bileşen adını Aggregate’in bildirdiği bir adla düzeltin ya da yapılandırma artık istenmiyorsa girdiyi kaldırın.
A Release attachment takes the name of a connection’s attachment (Bir Release eki, bir bağlantının ekinin adını alıyor)
Bir Release, bir ekü, bir component’in bağlantılarından birindeki bir ekin aldığı adla yazar: bağlantının takma adı, bir nokta ve ekin doldurduğu yuva — gpt bağlantısında credential yuvasını dolduran ek için gpt.credential. Bir bağlantının eki kendi bağlantı girdisine yazılır — component’in uses: altındaki Aggregate bağlantısına ya da aynı bağlantı için Release’in kenar başına uses: girdisine — ve bu birleştirilmiş adla tüketen component’in eki olur. Release, anahtarları nokta içerebilen iki başka kapsamda da ek yazar; bu nedenle birleştirilmiş ad oraya da yazılabilir:
Bir bileşen girdisinin kendi features: bloğu; bu blok o bileşene eklenir.
Bir sınırın kendi features: bloğu; bu blok o sınıra veya onun içine yerleştirilmiş bir sınıra yerleştirilen her bileşene eklenir; sınırın adlarını vermeden içeri yönlendirdiği bir alt aggregate’in bileşenleri de buna dahildir. Oradaki bir anahtar, ulaştığı herhangi bir bileşendeki birleşik ada eşit olduğunda, bir type: belirtse de belirtmese de derlemeyi durdurur.
Derleme, bunlardan birini bağlantının ekine katmak yerine durur; çünkü o zaman iki belgeden hiçbiri derlemenin bu ekle yaptığı şeyin tamamını göstermez. Bir soketin yuvası bağlantı başına, bağlantının kendi girdisiyle doldurulur; hiçbir zaman daha geniş bir kapsamdan üzerine basamaklanan bir ekle doldurulmaz. Ulaştığı bileşenlerin hiçbir bağlantı ekinin almadığı noktalı bir anahtar sıradan bir ek adıdır ve reddedilmez.
Denetim, iki belgeden herhangi birinin bağlantıya koyduğu eki kapsar; ayrıca Aggregate’in bildirdiği bileşen kadar bir alt aggregate’in katkıda bulunduğu bileşeni de kapsar.
Bir bileşen girdisindeki anahtar için yayımlanan ileti. Önce ret gelir, ardından Release ve bileşen girdisi, Release’in yazdığı anahtar, bileşen, bağlantı, soket ve yuva; sonra da anahtarın yazılacağı bağlantı girdisi:
a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (bir Release eki, bir component’in bağlantılarından birinin taşıdığı bir ekin adını alıyor (Release <release-name>, .spec.components.<component> konumunda, “<alias>.<slot>”, “<component>” component’inin, “<alias>” bağlantısında, “<socket>” soketi üzerinden, “<slot>” yuvasında). Bunu bağlantı girdisine, uses.<socket>.<alias>.features.<slot> altına yazın ve “<alias>.<slot>” öğesini bu girdinin features’ından kaldırın: bir bağlantının taşıdığı ek o bağlantıya yazılır, başka hiçbir yere yazılmaz.)
Bir sınırdaki anahtar için yayımlanan ileti. Sınırın ek bloğunu ve bağlantısı eki taşıyan bileşeni adlandırır:
a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (bir Release eki, bir component’in bağlantılarından birinin taşıdığı bir ekin adını alıyor (Release <release-name>, .spec.boundaries.<boundary>.features konumunda, “<alias>.<slot>”, “<component>” component’inin, “<alias>” bağlantısında, “<socket>” soketi üzerinden, “<slot>” yuvasında). Bunu “<component>” component’inin bağlantı girdisine, uses.<socket>.<alias>.features.<slot> altına yazın ve “<alias>.<slot>” öğesini bu sınırın features’ından kaldırın: bir bağlantının taşıdığı ek o bağlantıya yazılır, başka hiçbir yere yazılmaz.)
Bağlantıları birleşik adı taşıyan birden çok bileşene ulaşan bir sınır anahtarı, her biri için bir kez bildirilir; çünkü her bağlantı ayrı bir düzenlemedir.
Bulgu, anahtarın yazıldığı bloğa (bileşen girdisine ya da sınırın features: bloğuna) konumlandırılır; çünkü anahtarın kendisi nokta içerir ve bir konum böyle bir anahtarı adresleyemez; bunun yerine anahtar iletide adlandırılır. Sınırları adlandıran bir Release’te bileşen girdisi .spec.boundaries.<boundary>.components.<component> biçiminde okunur, bir aggregates: yönlendirme girdisinin içinde adlandırılan bileşen o girdi üzerinden, orada taşıdığı yerel adla adlandırılır ve iç içe bir sınırın bloğu .spec.boundaries.<outer>.boundaries.<inner>.features biçiminde okunur.
Nasıl düzeltilir: eki, Release’in o bağlantıya ait girdisine — component altındaki uses.<socket>.<alias>.features.<slot> — taşıyın; Aggregate’in bildirdiği bir ekü boyutlandırmak için oraya yalnızca infra:, yalnızca Release’in oluşturduğu bir ek için ise type: ve infra: yazın; ardından noktalı anahtarı component’in ya da sınırın features: bloğundan kaldırın. Birden çok component’in bağlantıları için düşünülmüş sınır genelindeki bir anahtar, bu bağlantıların her birine birer kez yazılır.
A Release connection attachment names no Feature type (Bir Release bağlantı eki hiçbir Feature türü belirtmiyor)
Bir Release’in kenar başına uses: girdisi, bir bağlantıya, Aggregate’in o bağlantıda ek bildirmediği bir yuva altında ek koyuyor ve hiçbir type: belirtmiyor. Bir Release’in bir bağlantıya yazdığı ek iki şeyden biridir. Ya Aggregate’in aynı bağlantıda zaten bildirdiği bir eki boyutlandırır ve türü Aggregate’in bildirimi belirttiği için tür belirtmez; ya da yalnızca Release’in oluşturduğu bir ektir ve o durumda Feature türünün gelebileceği tek yer Release girdisidir. Tür olmadan, ek için hiçbir şey bir FeatureRecipe seçemez.
Denetim, Aggregate’in bildirdiği bileşen kadar bir alt aggregate’in katkıda bulunduğu bileşeni de kapsar. Bir active: anahtarıyla kapatılan bileşen bağlantılarını da beraberinde götürür; bu nedenle onun üzerinde geride kalan bir girdi denetlenmez.
Yayımlanan ileti. Önce ret gelir, ardından Release ve bağlantı girdisi, yuva, bağlantı, soket ve bileşen; sonra da ne yapılacağı:
a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (bir Release bağlantı eki hiçbir Feature türü adlandırmıyor ve tür, yalnızca Release’in oluşturduğu bir ek için gereklidir (Release <release-name>, .spec.components.<component>.uses.<socket>.<alias> konumunda, “<slot>”, “<alias>” bağlantısında, “<socket>” soketi üzerinden, “<component>” component’inin). Bu ekin eklediği Feature’ı type altında adlandırın ya da eki Aggregate’in bağlantı girdisinde bildirip burada boyutlandırın.)
Kurala uymayan her ek ayrı bir bulgu olarak raporlanır; böylece tek bir derleme hepsini adlandırır.
Nasıl düzeltilir: ekin eklediği Feature’ı belirten bir type: ekleyin; ya da ekin bildirimi geliştiriciye aitse, eki Aggregate’in bağlantı girdisinde values: ile bildirin ve Release girdisinde yalnızca infra: bırakın.
Component identity cannot be stamped on what it emits (Bileşen kimliği, ürettiklerine damgalanamıyor)
Bir bileşenin kimliği yalnızca Aggregate’inizdeki bir anahtar değildir; aynı zamanda küme içindeki bir addır. Bir bileşenin ürettiği her kaynak, aggrega.ai/component-id ve app.kubernetes.io/name altında bu kimlikle damgalanır ve iş yükü sentezleyicileri ürettiklerini bu kimliğe göre adlandırır. Bu nedenle kimliğin, hedefin kabul edeceği bir ad olması ve söylediği şeyi ifade eden bir ad olması gerekir.
Yazdığınız bir ad, çıktısına tam olarak yazdığınız gibi ulaşır; Aggregate’inizdeki adı kümenizde arayabileceğiniz ad yapan da budur. Bu değerli bir özelliktir ve hedefin reddedeceği bir kimliğin, hiç yazmadığınız bir şeye sessizce onarılmak yerine burada bildirilmesinin nedeni de budur.
Tek bir karakter istisnadır ve bu sizin yazamayacağınız bir karakterdir: bir modülün adını içindeki bir bileşenin adına bağlayan nokta. Bu birleştirme belirsiz olmasın diye yazdığınız her addan özellikle ayrılmıştır ve kimlik damgalanmadan önce kimlikten çıkarılır: data-layer.main-db, data-layer-zdmain-db olarak damgalanır. Bu, kimsenin yazdığı bir ada mal olmaz ve içe aktarılan bir Aggregate’in sağladığı bir bileşenin damgalanabilmesini sağlayan da budur: nokta, bir Service adının kabul ettiği bir karakter değildir ve bir küme adresinde bir servisi ad alanından ayırır; dolayısıyla bir tüketiciye ana makine olarak verilen noktalı bir ad, hata vermek yerine başka bir servise çözümlenirdi.
İki biçim reddedilir.
Damgalama alfabesinin taşıyamayacağı bir kimlik. Kimlik, üretilen her kaynağın taşıdığı etiket değerine yazılır; bu alfabe harflere, rakamlara, -, _ ve . karakterlerine izin verir ve değerin bir harf ya da rakamla başlayıp bitmesini gerektirir. Yazılan adlara ilişkin kurallar buna yakındır ama aynı değildir; bir adın - ya da _ ile başlamasına veya bitmesine izin verirler. Bu nedenle _api ve api- yazabileceğiniz adlardır, ancak ikisi de damgalanamaz.
Bir adın ne kadar uzun olabileceği burada sorgulanmaz. Bu, bileşenin dağıtıldığı hedefe aittir ve farklı hedefler farklı yanıt verir: bu koşul hiçbir hedefin taşıyamayacağı biçimleri kapsar. Uzunluğu nedeniyle reddedilen bir ad bunun yerine hedefin kendi reddi tarafından bildirilir; bu ret o hedefin gerekçesini ve kabul edeceği uzunluğu içerir.
Oluşturulmuş bir kimlik gibi başlayan bir kimlik. Bir Feature’ın ürettiği kaynaklar, yazdığınız bir bileşen adıyla damgalanamaz; bu yüzden Aggrega onlar için, sizin yazdığınız parçalardan, Feature’ın nereye eklendiğini belirten sabit bir başlangıcın ardından bir kimlik oluşturur. Feature tek bir bileşene eklendiğinde kimlik o bileşenden ve Feature’ın altına eklendiği anahtardan oluşturulur ve cfr-- ile başlar. Bütün bir sınıra eklendiğinde hiçbir bileşenin adı geçerli olmaz; bu yüzden kimlik sınırın yolundan ve Feature’ın altına eklendiği addan oluşturulur ve bfr-- ile başlar. Bir okuyucuya bir kaynağın bir bileşenden değil de bu ikisinden hangisinden geldiğini söyleyen bu başlangıçtır. Bu nedenle bfr-- ve cfr--, bir bileşen kimliğinin başında ayrılmıştır.bfr--api ya da cfr--api adlı bir bileşen, oluşturulmuş bir kimlikle aynı şekilde damgalanır ve üretilen çıktıdaki hiçbir şey ikisini ayırt edemezdi. Yalnızca tam başlangıç ayrılmıştır: bfr, cfr, bfr-api ya da bfrontend adlı bir bileşen sıradan bir addır ve derlenir.
Denetim, bir bileşenin gerçekte taşıdığı kimliği okur; içe aktarılan bir Aggregate’in sağladığı bir bileşen için bu nitelikli kimliktir: modülün adı, bir nokta ve bileşenin kendi adı. Dolayısıyla tek başına her biri kabul edilebilir iki ad, kabul edilemeyen bir kimlikte birleşebilir: bfr--x adlı bir modül ve içindeki y adlı bir bileşen bfr--x.y olarak birleşir; bu da oluşturulmuş bir kimlik gibi başlar. Durma, sizin yazdığınız anahtarı gösterirken birleşik kimliği adlandırır.
Hedefin reddedeceği bir kimlik için üretilen ileti:
component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>")
ve oluşturulmuş bir kimlik gibi başlayan bir kimlik için; burada <opening>, adın eşleştiği ayrılmış başlangıçlardan hangisiyse odur:
component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>")
Nasıl düzeltilir: bileşeni, onu adlandıran her yüzeyde yeniden adlandırın: onu bildiren Aggregate’te ve onu yerleştirip yapılandıran Release’te. Ona bir harf ya da rakamla başlayıp biten ve ne bfr-- ne de cfr-- ile başlayan bir ad verin. Bir bileşeni yeniden adlandırmak, kaynaklarının kümede taşıdığı adı değiştirir; bu nedenle zaten dağıtılmış bir uygulamada bunu diğer herhangi bir kaynak yeniden adlandırması gibi ele alın.
The target will not accept a name derived from an authored identity (Hedef, yazılmış bir kimlikten türetilen adı kabul etmiyor)
Her hedef kendi adlarını bir bileşenin kimliğinden türetir: bir chart yükleyicisi bir release adı, bir konteyner orkestratörü servis adları türetir. Bu durdurma, o hedefin bunlardan birini kullanamadığını söylemesidir.
Aggrega hiçbir hedefin adlandırma kurallarını tutmaz. Bir adın ne kadar uzun olabileceğini, bir hedefin hangi karakterleri kabul ettiğini ya da bir hedefin dilbilgisinin bir adın başında neyi gerektirdiğini bilmez; ve bunu bilerek bilmez, çünkü bunlar hedefe, bir adın düştüğü kaynağın türüne ve bazen tek bir sağlayıcı içindeki tek bir servise göre değişir. Bu nedenle bir ad kesinleşmeden önce derleyici bileşeni oluşturacak sağlayıcıya sorar ve bu durdurma sağlayıcının yanıtını bildirir. İletinin, derleyiciye yazılmış bir kural yerine, reddedenin hedefteki kendi adını (release name, Service name) ve hedefin kendi gerekçesini taşımasının nedeni budur.
Adın neden kısaltılmak yerine reddedildiği. Yazdığınız bir ad, workload’unuzun dağıtılmış adıdır: onu kısaltmak, mevcut her çıktıdaki her kaynağı yeniden adlandırır ve bunu siz istemeden sizin adınıza yapar. Farklı bir ad seçebilecek kişi bu adı yazan kişidir; bu yüzden durdurma, yazdığınız spec.components anahtarını gösterir ve adı olduğu gibi bırakır. Aggrega’nın kendisinin oluşturduğu adlar ise (örneğin bütün bir sınıra eklenmiş bir Feature’ın kimliği) kısaltılır, çünkü bunlar birkaç belgeye dağılmış parçalardan bir araya getirilir ve hiçbir yazar ulaştıkları uzunluğu tek başına göremez.
Bir hedefin verebileceği iki yanıt vardır ve bunlar farklı yerlere götürür. Daha kısa bir ad kabul edilecekse, durdurma işe yarayacak uzunluğu belirtir; böylece yeni ad iki kez değil bir kez seçilir. Hiçbir uzunluğun yardımcı olmadığı durumda (hedefin dilbilgisinin, düştüğü konumda reddettiği bir karakter) uzunluk belirtilmez, çünkü kısaltma ona ulaşamaz. İkinci türün en yaygın örneği: adları yalnızca küçük harfli olan bir hedef, kabul etmediği her karakteri kaçışlar ve her kaçış bir kısa çizgiyle başlar; bu yüzden ilk karakteri kaçışlanan bir ad, kısa çizgiyle başlayan bir ad üretir. Orada küçük harf ya da rakam gerektiren bir hedef, adın geri kalanı ne kadar kısa olursa olsun onu reddeder. Bir hedef, bir adın başlangıcını ondan adlandırılan kaynakların daha katı kuralına da tabi tutabilir: helm hedefi rakamla başlayan bir adı Service name olarak bildirerek reddeder, çünkü Helm böyle bir release adını kabul ederken küme ondan adlandırılan bir Kubernetes Service’ini reddeder.
Üçüncü bir biçim yalnızca oluşturulmuş bir ad için görülür: bir hedef, derleyicinin kendisine verilen parçalardan oluşturabileceği en kısa kimlikten daha kısa bir uzunluk belirtebilir, çünkü oluşturulmuş bir kimlik bir ayırt edici için yer ayırır. Durdurma, sağlayıcıyı hatalı olarak bildirmek yerine bunu söyler ve çözümü adlandırır: yazılmış parçaları kısaltın.
Bazı adlar yalnızca bir bileşenin işlediği iş yükü için vardır. Sağlayıcıya, o bileşenin Workload’u çözümlendiğinde sorulur ve soru Workload’un form değerini ve Service anahtarlarını taşır; böylece bir hedef bunlardan oluşturduğu adları da değerlendirebilir. helm hedefinde bu iki ad ekler: en fazla 52 karakter olan ve yalnızca scheduled bir Workload için değerlendirilen bir CronJob name, çünkü küme her çalıştırmanın Job’unu, sonuna bir sonek eklenmiş CronJob adıyla adlandırır; ve her biri en fazla 63 karakter olan her Service name, yani <release name>-<service key>. Bir Service adı iki yazarın parçalarından oluşur — sizin bileşen adınız ve iş yükünün Recipe’te ya da bir FeatureRecipe’te bildirdiği anahtar —; bu nedenle gerekçesi, yazdığınız alanın yanında anahtarı ve iş yükünün onu nerede bildirdiğini (spec.workload.services.<key>) adlandırır. Hiçbir bileşen adına yer bırakmayacak kadar uzun bir anahtar, içinde seçim yapılacak bir uzunluk belirtmez ve gerekçe, kısaltılması gerekenin anahtar olduğunu söyler. Bu adlar, bütün bir sınıra eklenmiş bir Feature için değerlendirilmez: onun kimliği Workload’u çözümlenmeden önce belirlenir, çünkü çıktısının nerede birleştirileceği buna bağlı olabilir.
Yazılmış bir kimlik için üretilen ileti:
the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (hedef, bu bileşenin yazılmış kimliğinden türetilen bir adı kabul etmiyor: bileşeni yeniden adlandırın (bileşen “<identity>”, yazıldığı yer <field-path>, hedefin bunu <name-kind> olarak kullanamaması, <the target's reason>). hedefin kabul ettiği, en fazla <n> karakterlik bir ad seçin)
Nasıl düzeltilir: bileşeni, onu adlandıran her yüzeyde (onu bildiren Aggregate’te ve onu yerleştirip yapılandıran Release’te) hedefin kabul ettiği bir adla yeniden adlandırın. İleti bir uzunluk belirtiyorsa, onun içinde kalın. Belirtmiyorsa, hedefin gerekçesini okuyun: bu genellikle hedefin kabul etmediği bir karakterdir ve çoğunlukla adın başındaki bir büyük harftir ya da helm hedefinde oradaki bir rakamdır. Sözcükler arasında kısa çizgi bulunan küçük harfleri ve rakamları tercih edin; adlandırma bölümü her hedef türünde bir adın neye mal olduğunu açıklar. Gerekçe bir Service anahtarını adlandırıyorsa, uzunluk o anahtarı iş yükünün onu bildirdiği yerde kısaltarak da kazanılabilir; gerekçe anahtarın yer bırakmadığını söylüyorsa yalnızca bu işe yarar. Bir bileşeni yeniden adlandırmak, kaynaklarının taşıdığı adı değiştirir; bu nedenle zaten dağıtılmış bir uygulamada bunu diğer herhangi bir kaynak yeniden adlandırması gibi ele alın.
Kimlik sizin yazdığınız değil de derleyicinin oluşturduğu bir kimlikse, aynı durdurma oluşturulmuş değeri bildirir ve sizden onun oluşturulduğu parçaları kısaltmanızı ister: bir Feature’ı eklediğiniz ad ve onu eklediğiniz sınır yolu.
A provider never accepted a name the compiler composed (Bir sağlayıcı, derleyicinin oluşturduğu bir adı hiç kabul etmedi)
Bu, sizin yazdığınız herhangi bir şeydeki değil, bir plugin’deki kusuru bildirir.
Oluşturulmuş bir adı kesinleştirmek bir alışveriştir: derleyici bir kimlik önerir, sağlayıcı onu ya kabul eder ya da ne kadar kısa olması gerektiğini söyler, derleyici daha kısa bir kimlik oluşturur ve sağlayıcıya yeniden sorulur. İkinci bir ret normaldir ve beklenir: bir uzunluğa kısaltmak, bir karakteri o hedefin dilbilgisinin kabul etmeyeceği bir yere düşürebilir ve sağlayıcının bunu söylemesi, hiçbir hedefin dilbilgisini bilmeyen bir derleyici ile bilen bir sağlayıcının uzlaşmaya varma yoludur.
Normal olmayan, hiçbir şeyi kabul etmeyen bir sağlayıcıdır: bir uzunluk belirten, o uzunlukta bir ad verilen ve onu yine reddeden. Alışveriş sınırlıdır ve sınıra ulaşıldığında derleme, sağlayıcının hiç onaylamadığı bir adı kullanmak yerine durur ve sağlayıcıyı adlandırır. Vazgeçilerek kesinleştirilen bir ad, çıktıda uzlaşmaya varılmadığını kaydeden hiçbir şey olmadan gerçek kaynaklara damgalanır ve sonucu, onu üreten derlemede değil uygulama anında ortaya çıkar.
Üretilen ileti:
provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (provider konuğu, derleyicinin onun için oluşturduğu bir bileşen kimliğini hiç kabul etmedi (provider konuğu “<provider>”, <n> öneriyi reddetti, sonuncusu “<identity>”). kusuru o provider plugin’ini kim sürdürüyorsa ona bildirin)
Nasıl düzeltilir: iletideki son öneriyi aktararak durumu adı geçen provider plugin’ini sürdüren kişiye bildirin. Bunu aşan bir yazım değişikliği yoktur: derleyici, sağlayıcının istediği her uzunluğu zaten sunmuştur. Sağlayıcıyı siz sürdürüyorsanız, yapılacak denetim şudur: belirttiği bir sınıra göre kesilen bir adı ardından kabul etmesi.
Required uses: socket not populated (Zorunlu uses: soketi doldurulmamış)
Bir Component, usesSchema içinde required: true olarak işaretlenmiş bir soket bildirir ve derlemedeki hiçbir şey, o Component’in örneklerinden biri için bu sokete bir bağlantı bağlamaz.
Bağlantıyı üç yüzey kurabilir ve bu durdurma yalnızca üçü de boş olduğunda tetiklenir. Örneğin Aggregate içindeki kendi uses: bloğu; bir target: adlandıran ve bildirilmiş ancak bağlanmamış bir sokete bağlantıyı oluşturan, Release’teki kenar başına uses: girdisi; ve bileşimin ürettiği bağlantı kümesi. Sonuncusu, içe aktarılan bir Aggregate’in katkıda bulunduğu bir bileşen için yanıt veren yüzeydir: böyle bir bileşenin uses: bloğu o Aggregate’in kendi belgesinde bulunur ve ancak bileşim bir araya getirildiğinde okunur. Üçüncü yüzey en son tamamlanan olduğundan, denetim iki yazılmış belge okunurken değil, bileşimin tamamı oluştuğunda çalışır ve hangi belge bildirmiş olursa olsun her bileşene aynı soruyu sorar.
Soketi dolduracakmış gibi görünen iki biçim doldurmaz. target: adlandırmayan bir Release girdisi, bağlantı oluşturmak yerine zaten var olması gereken bir bağlantıyı yapılandırır; bu nedenle hiçbir şey bağlamaz (ve infra: taşıdığında yukarıdaki kendi durdurmasıyla bildirilir). Bir Feature ekinin uses: alanı ise eklenen Feature üzerinde bildirilmiş soketleri, yani ayrı bir varlık üzerindeki ayrı bir soket kümesini adlandırır; bu nedenle bir ek, bir Component’in kendi soketini hiçbir zaman dolduramaz.
Üretilen ileti:
required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (zorunlu uses soketi doldurulmamış: belirtilen konumdaki soket, belirtilen bileşen türü tarafından zorunlu olarak bildirilmiş)
Bulgu, yazarın yazması gereken soket girdisine, .spec.components.<instance>.uses.<socket> konumuna yerleştirilir. İçindeki örnek adı, bileşenin onu bildiren belgede taşıdığı addır; bu nedenle içe aktarılan bir Aggregate’in katkıda bulunduğu bir bileşen için konum belirteci, kompozisyonun ona verdiği önekli adı değil, o Aggregate’in kendi dosyasında bulunan bir anahtarı adlandırır.
Doldurulmamış her zorunlu soket, her bileşende bildirilir: tek bir derleme size yalnızca ilkini değil, hepsini bildirir.
Nasıl düzeltilir: zorunlu soket için bir uses: girdisi ekleyin ve onu soketin selector: alanının kabul ettiği bir hedefe bağlayın; ya da soketi Release’ten bir target: adlandıran bir girdiyle bağlayın. Soketin artık zorunlu olmaması gerekiyorsa Component’in usesSchema tanımını güncelleyerek required: false ayarlayın veya required bildirimini kaldırın.
Bir alt aggregate içe aktarma zinciri, derleyicinin en büyük iç içe geçme derinliğini aşıyor. Bu sınır, derin iç içe topolojilerin denetimsiz düzleştirilmesini önler ve bir eşiğin üzerinde mimari ayrıştırmayı zorunlu kılar.
Üretilen ileti:
max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (en büyük alt aggregate iç içe geçme derinliği aşıldı: önek <flattened-prefix> konumunda derinlik <depth>.)
Nasıl düzeltilir: iç içe geçmeyi azaltmak için aggregate topolojisini yeniden yapılandırın. Bu kadar derin bir iç içe geçme genellikle Aggregate biçiminin dağıtım topolojisini değil, kurumsal hiyerarşiyi yansıttığını gösterir; alt aggregate gruplarını tek bir üst Aggregate içinde eş alt sistemlere düzleştirmeyi düşünün.
Feature type mismatch between Aggregate and Release (Aggregate ile Release arasında Feature türü uyuşmazlığı)
Aggregate ve Release aynı örnek adıyla bir feature ekler, ancak her biri farklı bir type: bildirir ve Release’in eki bileşene bir sınırın features: bloğundan ulaşır. Release onu bunun yerine bileşen için kendi girdisine yazdığında aynı çakışma daha önce reddedilir ve yukarıdaki “A feature attached by both the Aggregate and the Release cannot be merged (Hem Aggregate hem de Release tarafından eklenen bir feature birleştirilemiyor)” altında E0153 olarak raporlanır.
Üretilen ileti:
feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (Aggregate ile Release arasında feature türü uyuşmazlığı (düğüm <node-id>, ek <instance-name>, mevcut tür <type-in-aggregate>, <type-in-release> ile çakışıyor))
Nasıl düzeltilir: ya Release’ten type: alanını kaldırın (türü Aggregate’ten devralır) ya da her ikisi aynı türü bildirecek şekilde taraflardan birini değiştirin. Release’in type: alanını atlamasına veya Aggregate’in türünü yinelemesine izin verilir, ancak onun yerine farklı bir tür koyamaz.
Cyclic extends on Components or Features (Components veya Features üzerinde döngüsel extends)
Bir Component’in extends: zinciri veya bir Feature’ın extends: zinciri kendi üzerine geri döner.
Üretilen ileti; döngüye giren bir Feature zinciri olduğunda Component yerine Feature yazılır:
cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (döngüsel extends zinciri: bir varlık zaten zincirde bulunan bir başvuruyu genişletiyor; o varlık üzerindeki extends’i kaldırın veya onu zincirin dışındaki bir varlığa yönlendirin)
Nasıl düzeltilir: kenarın adlandırdığı varlığı açın (üç veya daha fazla öğeli bir zincirde bu, iletinin başında adı geçen varlık değildir) ve onun extends: alanını kaldırın ya da yeniden yönlendirin.
A component the composition holds is placed in no boundary (Kompozisyonun içerdiği bir bileşen hiçbir sınıra yerleştirilmemiş)
Bir Release bir bileşeni bir sınıra iki yolla yerleştirir ve ikisinden biri yeterlidir. Bileşeni bir sınırın components alanı altında, bileşenin kompozisyonun tamamı düzleştirildiğinde taşıdığı kimlikle adlandırır. Ya da bileşene katkıda bulunan modülü aggregates altında bir sınıra yönlendirir; bu, o modülün içerdiği her bileşeni tek seferde yerleştirir.
Bunların hiçbirine ulaşmayan bir bileşen, Release’in bildirdiği her sınırın dışında işlenir. Bu durumda çıktı dizini, senkronizasyon dalgası, ek açıklamaları ve bileşen başına infra değeri hiçbir yerden gelmez; derleme ise aksi hâlde başarılı olur, yapıtları üretir ve operatörün yapılandırmasının ona hiç uygulanmadığı konusunda hiçbir şey söylemez. Bu çizgiyle ayrılan iki bileşen ayrıca farklı çıktılara işlenir ve birlikte yerleştirildiklerinde sahip oldukları sıralamayı kaybeder.
İki biçim bilinçli olarak bu duruma girmez. Adlandırılmış sınırlar yerine üst düzey components bildiren bir Release, adlandırdığı her şeyi yerleştirir: böyle bir Release’i normalleştirmek ona tam olarak bu bileşenleri tutan kendine ait bir sınır verir. Modülünün tamamını Release’in hiçbir yere yerleştirmediği bir bileşen ise kendi bildirimi doğru olan her bileşen için ayrı ayrı değil, aşağıdaki girdi altında modül için bir kez bildirilir: tek hata, tek çözüm, düzenlenecek tek anahtar.
Üretilen ileti. Sondaki değer, bileşenin kompozisyon düzleştirildiğinde taşıdığı kimliktir; bir modülün katkıda bulunduğu bir bileşen için bu, o modülün adı, bir nokta ve bileşenin kendi adıdır:
component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (hiçbir sınıra yerleştirilmemiş bileşen: onu bir sınırın components alanı altında adlandırın veya ona katkıda bulunan alt modülü aggregates altına yerleştirin)
Nasıl düzeltilir: bileşeni bir sınırın components alanı altında, tam olarak iletinin aktardığı kimliği kullanarak adlandırın; bir modülün katkıda bulunduğu bir bileşen için bu, modülün kendi dosyasında yazılan ad değil, önekli kimliktir. Ya da modülün tamamı tek bir sınıra aitse onu oraya aggregates altında yönlendirin ve içerdiği her bileşenin tek seferde yerleştirilmesini sağlayın.
Bir alt modülün bileşenleri hiçbir sınıra yerleştirilmemiş
Yukarıdaki kuralın modül ölçeğindeki biçimi: bileşimin içeri aldığı bir modül bileşenler katmıştır ve hiçbir sınır bunlardan hiçbirini tutmaz. Bileşen başına bir kez değil, modül için bir kez raporlanır; çünkü hiçbir yere yerleştirilmemiş bir modül, tek bir anahtarda tek bir çözümü olan tek bir yazım hatasıdır ve bunu bileşen başına raporlamak, kendi bildirimleri tamamen doğru olan bileşenleri adlandırmak olurdu.
Kural yazılışa değil yerleşime bakar; bu nedenle bileşenlerinin her biri bir sınırın components alanında tek tek adlandırılmış bir modül yerleştirilmiş sayılır ve geçer: bir yönlendirme girdisi eksik diye onu reddetmek, dilin kabul ettiği bir yazım biçimini reddetmek olurdu. Yalnızca kısmen yerleştirilmiş bir modül de geçer; bileşenlerinden hangilerinin kendi girdileri olduğu bileşen kuralının sorusudur ve dışarıda bıraktıkları orada, her biri kendi anahtarında raporlanır.
Hiç bileşen katmamış bir modül bu durumla karşılaşmaz: yerleştirilecek bir şey yoktur. false değerli bir active: anahtarının kaldırdığı ve hiç bileşime katılmamış bir modül de karşılaşmaz.
Modülü bildiren aggregates girdisinde, içeri alan belgenin yazdığı yerel ad altında konumlandırılmış üretilen ileti:
sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (alt modül hiçbir sınıra yerleştirilmemiş: onu aggregates altında bir sınıra yönlendirin ya da bileşenlerini orada components altında adlandırın)
Nasıl düzeltilir: modülün ait olduğu sınırın altına modül için bir aggregates girdisi ekleyin; bu, modülün kattığı her bileşeni yerleştirir. Ya da bileşenleri farklı sınırlara aitse, her birini ait olduğu sınırın altında, düzleştirildikten sonra taşıdıkları önekli kimlikleri kullanarak adlandırın.
Bir sınır, bileşimin tutmadığı bir bileşeni adlandırıyor
Yukarıdaki iki kuralın fazla adlandırma karşılığıdır ve bunlardan birinin dalı değil, ayrı bir sorudur: onlar bir bileşen için onu bir şeyin yerleştirip yerleştirmediğini sorar, bu ise Release’in yazdığı bir girdi için ona bir şeyin karşılık gelip gelmediğini sorar. Biri ötekini gerektirmez. Bir Release, var olan her bileşen düzgünce yerleştirilmişken var olmayan bir bileşeni adlandırabilir ve yazdığı her girdi çözümlenirken gerçek bir bileşeni yerleştirilmemiş bırakabilir.
Hiçbir şeyi adlandırmayan girdi hiçbir şeyi yapılandırmaz: directory, subDirectory, syncWave, ek açıklamalar ve bileşen başına infra değerleri orada olmayan bir bileşen için yazılmıştır; bu nedenle altlarında hiçbir şey işlenmez ve derleme, operatörün yapılandırması sessizce etkisiz kalırken aksi hâlde başarılı olurdu.
Bir sınır bir bileşeni iki yolla adlandırır ve her ikisi de denetlenir. components altında bir girdi, bileşeni bileşim düzleştirildikten sonra taşıdığı kimlikle adresler; bu nedenle bir modülün kattığı bileşen, kendi adının önünde o modülün önekiyle yazılır. Bir aggregates yönlendirme girdisinin içinde ise bir girdi, bileşeni o modülün içinde taşıdığı yerel adla adresler ve bu ad aynı kimliğe çözümlenir. İleti, girdinin adreslediği kimliği aktarır; bu, yönlendirilen eksende dosyanın yazdığı ad değildir: dosya yerel yarıyı taşır, geri kalanını modül sağlar.
Bir alt sistem bir bileşenin kimliğine hiçbir şey katmaz; bu nedenle bir alt sistemin içinde bildirilen bileşen yalın adıyla adreslenir. Alt sistem kimliğin parçasıymış gibi yazılmış bir girdi hiçbir şeyi adreslemez ve bu durumla karşılaşır.
false değerli bir active: anahtarıyla kapatılmış bir bileşen bu durumla karşılaşmaz. Bir bileşeni kapatmak bir yazım eylemidir ve onu yapılandıran Release’in aynı düzenlemede yeniden yazılması beklenmez; girdiyi reddetmek, herhangi bir Release bileşeni adlandırdığı sürece anahtarı kullanılamaz kılardı.
Üretilen ileti:
boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (sınır, kompozisyonun içermediği bir bileşeni adlandırıyor: adı düzeltin ya da girdiyi kaldırın)
Nasıl düzeltilir: iletinin aktardığı kimliği bileşimin gerçekte tuttuğu bileşenlerle karşılaştırın. Eksik bir modül öneki ve kimliğe yazılmış bir alt sistem adı en yaygın iki nedendir; alt sistemi çıkarın, modül önekini ekleyin ya da yazımı düzeltin. Girdi, o zamandan beri kaldırılmış ya da yeniden adlandırılmış bir bileşenden kalmışsa silin.
Bir uses kenarı, bir active: anahtarının kaldırdığı bir bileşeni hedefliyor
Yukarıdaki sarkan hedef durdurmasının kardeşidir; yazara hedefin neden eksik olduğunun söylenmesi için ayrı raporlanır. Hedef hiç bildirilmediği için yok değildir: bildirilmiştir ve active: anahtarı false olarak çözümlendiği için bu derlemeden bilerek, kenarlarıyla birlikte kaldırılmıştır. Kalan bir bileşen hâlâ ona bağımlıdır ve kenarın kaybolmasına izin vermek, o tüketicinin enjekte edilen değerlerini dağıtım anında sessizce boş bırakırdı.
Üretilen ileti. Önce ret gelir, ardından anahtarın kaldırdığı hedef ve bağlantının bağlandığı soket, sonra da bu konuda ne yapılacağı:
uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (uses kenarının hedefi, active anahtarı false olarak çözümlendiği için budandı. Hedefin active anahtarını true tutun ya da ona olan bağımlılığı kaldırın.)
Bulgu, ilgili olduğu yazılmış girdide, yukarıdaki sarkan hedef durdurmasının adlandırdığı yollarla aynı yollarda konumlandırılır ve yalnızca ilki değil, sorunlu her bağlantı raporlanır.
Nasıl düzeltilir: ikisinden hangisinin bu ortama ait olduğuna karar verin. Hedefi yeniden açın; anahtarı bir parametre okuyorsa bu, parametreyi bu Release için sağlamak demektir. Ya da tüketiciyi aynı anahtarın arkasına alın; böylece ikisi birlikte ayrılır ve hiçliği gösteren bir kenar kalmaz. Ya da tüketicinin buna gerçekten artık ihtiyacı yoksa kenarı tüketicinin uses: bloğundan kaldırın.
A uses target names a module’s component the module does not export (Bir uses hedefi, modülün dışa aktarmadığı bir modül bileşenini adlandırıyor)
Bir modül arayüzünü exportedComponents: altında yayımlar ve modülü içe aktaran bir belge modülün bileşenlerine yalnızca bu adlar üzerinden ulaşır: modülün adı, bir nokta ve takma adlarından biri. Bir modülün içindeki bir bileşene başka herhangi bir yolla — bileşenin modül içindeki adıyla ya da modülün içinden geçerek onun içine yerleştirilmiş bir modüle giden bir yolla — ulaşan bir uses: hedefi derlemeyi durdurur, çünkü bağlantı, modülün yazarının yayımlamadığı ve serbestçe yeniden adlandırabileceği ya da kaldırabileceği bir şeye bağlanırdı. Bir bileşenin kendi uses: bloğu, bir ekin bloğu ve Release tarafından bağlanan bir bağlantı buna eşit biçimde tabidir. Bir bağlantının hangi modüllere girdiği, tüketicisinin bulunduğu yerden okunur; bu yüzden bir modülün iki bileşeni arasındaki bir bağlantı — Release’in onları birbirine bağlaması da dahil — hiçbir arayüzü geçmez ve reddedilmez. Hiçbir bileşene karşılık gelmeyen bir hedef bunun yerine boşta kalan hedef durdurması tarafından raporlanır; böylece yanlış yazılmış bir ad bir kez raporlanır.
Verilen ileti. Önce ret gelir, ardından yazıldığı biçimiyle hedef, girdiği modül ve o modülün dışa aktardığı takma adlar ve soket — ardından bu konuda ne yapılacağı:
uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (uses kenarının hedefi, modülünün dışa aktarmadığı bir bileşeni adlandırıyor (hedef, modül ve dışa aktardığı takma adlar ile bağlandığı soket belirtilir). Bileşeni modülün dışa aktardığı takma adlardan biri üzerinden adlandırın ya da modülün exportedComponents alanı altında listeleyin.)
Hiçbir şey dışa aktarmayan bir modül "nothing" dışa aktarıyor olarak adlandırılır. Bulgu, bağlantıyı çizen belgedeki yazılmış girdiye konumlandırılır.
Nasıl düzeltilir: bileşeni modülün dışa aktardığı bir takma ad üzerinden adlandırın — finance-db-subsystem.internal-pg-primary yerine finance-db-subsystem.primary_db — ya da modülü siz yazıyorsanız ve bileşeni yayımlamak istiyorsanız, onu modülün exportedComponents alanı altında, içe aktaranların kullanması gereken ad buysa kendi adıyla listeleyin.
Bir active: anahtarı true ya da false olarak çözümlenmiyor
Bir active: anahtarı grafik oluşturucuya bir değişmez olarak çözümlenmiş hâlde ulaşır: doğrudan yazılmış bir boolean ya da belge okunmadan önce Release’in değerlerinin yerleştirildiği bir parametre başvurusu. Ardından katı biçimde okunur: boolean olmayan bir değişmez, herhangi bir varsayılana düşmek yerine derlemeyi durdurur. Kural bir bileşenin anahtarı için de bir modülünkü için de aynıdır.
Adlandırılmaya değer durum boş bir değişmezdir, çünkü karşılanmamış bir parametrenin ürettiği budur. {{ .parameters.<key> }} okuyan bir anahtar, o parametrenin değeri yokken hiçbir şeye çözümlenir ve hiçbir şeyi “mevcut” olarak okumak, yazarın parametrenin arkasına aldığı varlığın ta kendisini dağıtırdı. Yalnızca kimsenin yazmadığı bir anahtar varsayılan olarak mevcut sayılır ve bu, anahtarın değerinden değil yokluğundan okunur; active: yazıp ardından hiçbir şey yazmamanın, anahtarı hiç yazmamakla aynı olmamasının nedeni budur.
Üretilen ileti:
active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (active anahtarı bir boolean değere çözümlenmedi)
ve hiçbir şeye çözümlendiği durumda, olağan nedeni adlandıran öneriyle:
active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (active anahtarı bir boolean değere çözümlenmedi. Bir parametreyi okuyan anahtar, o parametre karşılanana kadar hiçbir şeye çözümlenmez)
Nasıl düzeltilir:true ya da false yazın. Anahtar bir parametre okuyorsa o parametreyi Release’te sağlayın ya da her ortamın bir yanıtı olması için Aggregate’te bildirildiği yerde ona bir default: verin. Bir varlığı koşulsuz olarak mevcut kılmak için active: anahtarını boş bırakmak yerine kaldırın.
Bir bileşimin içeri aldığı bir modül yüklenemiyor ya da kendini içeri alıyor
Bir Aggregate, başka Aggregates’i aggregates: altında adlandırarak bileşimine katar ve her biri sırayla yüklenip dolaşılır; böylece bileşenleri grafiğe katılır. Bu dolaşmayı burada iki şey durdurur.
Modül hiç yüklenemez: başvuru, kataloğun geri verebileceği hiçbir şeye çözümlenmez ya da arkasındaki belge okunamaz. Yükleyicinin verdiği neden durdurmanın içine katılmaz, altında taşınır; böylece neyin başarısız olduğu yükleyicinin kendi sözcükleriyle raporlanır.
Ya da modül, dolaşılan zincirde zaten bulunan bir türü adlandırır. Bunu genişletmek, onu içeren zinciri sonsuza dek yeniden üretirdi. Başvurunun döngüyü kapattığı noktada, hem türü hem de bileşimde nerede durduğunu adlandırarak raporlanır.
Döngüsel bir başvuru için üretilen ileti:
sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (alt aggregate yüklenemedi (döngüsel alt aggregate başvurusu “<module-type>”, konum “<path in the composition>”))
ve bir yükleme hatası için; burada durdurma yalnızca cümleden oluşur, modülün yolunda konumlandırılır ve yükleyicinin kendi nedeni altında yer alır:
Nasıl düzeltilir: bir yükleme hatasında durdurmanın altındaki nedeni okuyun; kataloğun yanıtlayamadığı bir ad ya da sürüm yaygın durumdur ve düzeltme onu adlandıran aggregates: girdisine yapılır. Döngüsel bir başvuruda döngüyü kırın: iletideki yol zincirin kapandığı yerdir ve bu yol üzerindeki modüllerden biri, kendisini içeri alanı içeri almayı bırakmalıdır. İki modül gerçekten birbirinin bileşenlerine ihtiyaç duyuyorsa paylaşılan kısım, ikisinin de içeri aldığı üçüncü bir modüle aittir.
İki örnek tek bir tanımlayıcıya düzleşiyor
Bir Aggregate’in bileşimi her bileşeni tek bir kümeye düzleştirir ve bir modülün kattığı bileşen o modülün adını, bir noktayı ve kendi adını taşır. Küme tek bir tanımlayıcı altında iki girdi tutmayı reddeder: ikincisi ilkinin yerini alır ve iki bileşenden biri, hakkında hiçbir şey söylenmeden çıktıdan kaybolurdu.
Bu durdurma, bir modülün bileşenleri birleştirilirken oluşturulan durdurmadır ve yazım yüzeyi onu üretecek adları sunmaz. Bir modülün kattığı her bileşen kendi adının önünde o modülün adını taşır; bir örnek adı harflerden, rakamlardan, - ve _ karakterlerinden yazılır, bu nedenle ikisini birleştiren noktayı taşıyamaz ve farklı modül adlarından oluşturulan iki tanımlayıcı çakışamaz. Tek bir ad altında içeri alınan iki modül tek bir yinelenen anahtardır ve belge yüklenirken reddedilir. Dolayısıyla bu, olağan yazım yolu dışında bir şeyin oluşturduğu bir bileşime karşı son güvencedir ve bununla karşılaşmak, etrafından dolaşmak yerine raporlanmaya değer.
flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (düzleştirilmiş düğüm kimliği çakışması: düzleştirilmiş kimlikleri farklı olsun diye çakışan örneklerden birini yeniden adlandırın (kimlik “<identifier>”, yol “<path in the composition>”, “<the other contributor>” kaynaklı mevcut girdiyle çakışıyor))
Nasıl düzeltilir: iletinin adlandırdığı iki örnekten birini, onu bildiren belgede ve onu adresleyen her Release girdisinde yeniden adlandırın.
İki alt sistem tek bir ad altında bir bileşen bildiriyor
Alt sistemler bir Aggregate’in bileşenlerini okuyucu için ve onlara basamaklanan şeyler için gruplar; bir bileşenin yanıt verdiği adı nitelemez. subsystems.frontend altında bildirilen bir bileşen frontend.api olarak değil api olarak adreslenir ve bir modülün kattığı bileşen alt sistemin değil o modülün adını taşır. Bu nedenle bir Aggregate’in iki alt sisteminin her biri api adlı bir bileşen bildirebilir ve ikisi bu durumda aynı tanımlayıcıya yanıt verir.
Belge iyi biçimlidir (ikisi ayrı bloklarda ayrı anahtarlardır, daha önce hiçbir şeyin onu reddetmemesinin nedeni de tam olarak budur), ancak bir tanımlayıcıyı yalnızca bir bileşen taşıyabilir. Derleme, en son okunanı tutup tek bir bileşen bildirilmiş gibi işlemek yerine durur.
Tek bir alt sistemin içinde aynı adın iki kez geçmesi farklı bir hatadır: bunlar tek bir anahtar altında iki girdidir ve belge okunurken reddedilir.
Üretilen ileti:
components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (farklı alt sistemlerdeki bileşenler aynı kimliği alıyor: alt sistem bir bileşenin kimliğine hiçbir şey katmadığından birini yeniden adlandırın)
Nasıl düzeltilir: iki bileşenden birini, onu bildiren belgede ve onu adresleyen her Release girdisinde yeniden adlandırın. İkisi gerçekten iki yerde istenen aynı bileşense onu bir kez bildirin ve diğer alt sistemden ona bağımlı olun. Alt sistemi yeniden adlandırmak işe yaramaz: alt sistem adın parçası değildir.
Yeniden yayımlanan bir bileşen takma adı kendini gösteriyor
Bir modül, bileşenleri takma adlar altında dışa aktararak kendinin bir kısmını yayımlar ve onu içeri alan bir Aggregate bu takma adlardan birini kendi adı altında yeniden yayımlayabilir. Böyle bir takma adı çözümlemek, yeniden yayımlama zincirini nihai olarak adlandırdığı bileşene kadar izler; böylece genel adı gösteren bir kenar gerçek bir bileşene ulaşır.
Bir bileşene ulaşmadan önce bir takma adı yeniden ziyaret eden zincir hiçbir yere varmaz. Dolaşma onu sonsuza dek izlemek yerine durur ve döngüyü kapatan halka görünsün diye dolaştığı zinciri adlandırır.
Yazabileceğiniz hiçbir şey böyle bir zincir üretmez. İçeri alma ağacı döngüsüzdür ve her halka, kendinden önceki halkadan daha derinde iç içe geçmiş bir şeyi adlandırır; bu nedenle içeri almalardan oluşturulan bir zincir aşağı iner ve sona erer. Dolayısıyla bu, bir Aggregate’in bildirebileceği bir biçime değil, olağan yazım yolu dışında bir şeyin oluşturduğu bir takma ad tablosuna karşı son güvencedir.
Üretilen ileti:
re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (yeniden dışa aktarılan bileşen takma adı bir döngü oluşturuyor (takma ad zinciri <first> -> <second> -> <first>))
Nasıl düzeltilir: dosyalarınızdaki hiçbir şey bunu üretmez ve onu gideren bir yazım değişikliği yoktur. Çalıştırdığınız komutla ve iletinin adlandırdığı, döngünün nerede kapandığını söyleyen ayrıntı olan takma ad zinciriyle birlikte raporlayın.
An Aggregate reached graph building without being normalised (Bir Aggregate normalleştirilmeden grafik oluşturmaya ulaştı)
Üst düzeyinde bileşenlerle yazılmış bir Aggregate ile adlandırılmış alt sistemlerle yazılmış bir Aggregate, okunurken aynı biçime dönüşür: üst düzey bileşenler derleyicinin sağladığı bir alt sisteme katlanır ve üst düzey temizlenir. Aşağı akıştaki her şeyin tek bir biçime tek bir soru sormasını sağlayan bu katlamadır.
Grafik oluşturmaya her ikisi de doluyken ulaşan bir Aggregate bu okumayla üretilmemiştir. İki biçim yazıldıkları yerde birbirini dışlar (ikisini birden bildiren bir belge yüklenirken reddedilir) ve onları sonradan tek biçim yapan katlamadır; bu nedenle bir yazarın yazabileceği hiçbir şey buraya ulaşmaz. Bu, olağan yükleme yolu dışında bir şeyin oluşturduğu bir Aggregate’e karşı son güvencedir ve bununla karşılaşmak, etrafından dolaşmak yerine raporlanmaya değer.
İletisi şöyle başlar:
aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (aggregate topolojiye normalleştirilmeden ulaştı (sentezlenmiş varsayılan alt sistemin yanında boş olmayan kök bileşenler))
ve derleyicinin beklediği oluşturma yoluyla devam eder; bu bir yazım talimatı değil, derlemede hata ayıklayan kişi için bir nottur.
Nasıl düzeltilir: dosyalarınızdaki hiçbir şey bunu üretmez ve onu gideren bir yazım değişikliği yoktur. Çalıştırdığınız komutla birlikte raporlayın.
Bir etiket dönüştürme eklentisinin yaması düğüm etiketlerinin dışına uzanıyor
Etiket dönüştürme rolünde bağlanan bir yönetişim eklentisine grafiğin bir izdüşümü verilir (her düğüm için bir girdi; her biri o düğümün etiketlerini ve örneğinin bildirdiği değerleri taşır, Component’inin hassas olarak bildirdiği her değer gizlenir) ve eklenti düğüm etiketlerine karşı yamalar döndürür. Ana bilgisayar bunları yalnızca etiketlere uygular ve ardından geri gelenin hâlâ o etiket görünümü olduğunu denetler: aynı düğümler, her biri yalnızca etiket taşıyor, her etiket değeri bir dize.
Bunun dışındaki her şey reddedilir ve derleme durur. Bir düğüm eklemek ya da kaldırmak veya bir düğümün etiketleri dışındaki bir alanını değiştirmek, tam olarak kimsenin bildirmediği altyapının sessizce ortaya çıkmasıdır; bu nedenle derleme, rolün kapsamadığı bir değişikliği içine almak yerine yamanın hangi sınırlama kuralını ihlal ettiğini söyler. Etiketler rolün yüzeyinin tamamıdır ve eklentiyi bağlayan bir operatör bu kadarını bildirmiştir, fazlasını değil.
Üretilen iletiler. Yama uygulanmadan önce reddedildi:
mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (mutator yaması reddedildi: yama <n> bir JSON Patch belgesi olarak çözümlenemiyor: <what the reader could not do>)
mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (mutator yaması reddedildi: yama <n> düğüm etiketi yüzeyine uygulanamıyor: <what the patch engine refused>)
ya da uygulamanın sonucu, ana bilgisayarın verdiği görünüm değildi:
mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (mutator yaması reddedildi: değiştirilen düğüm kümesinin boyutu değişti (bir mutator düğüm ekleyemez veya kaldıramaz))
mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (mutator yaması reddedildi: değiştirilen düğüm kümesi <node> düğümünü ekledi (bir mutator düğüm ekleyemez))
mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (mutator yaması reddedildi: <node> düğümü “labels” dışında bir alan kazandı (bir mutator yalnızca etiketlere dokunabilir))
mutator patch rejected: node "<node>" lost its "labels" field (mutator yaması reddedildi: <node> düğümü “labels” alanını kaybetti)
mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (mutator yaması reddedildi: <node> düğümü yama sonrasında dize olmayan bir etiket değeri taşıyor: okuyucunun bulduğu)
Nasıl düzeltilir: hata sizin belgelerinizde değil, eklentidedir. Eklentiyi, döndürdüğü her işlem bir düğümün labels altındaki bir girdiyi hedefleyecek ve yalnızca dize değerler atayacak şekilde düzeltin; yüzey yalnızca dizeleri kabul ettiğinden yaygın durum sayısal veya boolean bir etiket değeridir. Eklenti düzeltilirken bir derlemenin önünü açmanın hemen uygulanabilecek yolu, bağlamayı plugins.governance içinden kaldırmaktır.
Kasıtlı eksiklik: topolojinin döngüsüz olması gerekmez
Aggrega topolojide döngülere izin verir: bağımlılık grafiğinin bir Yönlü Döngüsüz Grafik olmasını gerektirmez. Ajandan ajana mimariler, geri çağırma kalıpları ve karşılıklı kimlik doğrulama çiftlerinin tümü döngüsel kenarlar üretir ve derleyici bunları kabul eder. Dağıtım zamanındaki sıralama IR grafiğinin değil, işleyicinin sorumluluğudur (sınır başına syncWave veya eşdeğeri aracılığıyla).
Inject sözleşmeleri denetlenirken
Derleyici her inject: bloğunu — hem self-inject (bir Component’in kendine enjekte etmesi) hem de uses-inject (Component’ler arası bağlantı) — dolaşır ve teslim sözleşmesini hedef Component’in provides: şemasına, Feature’ın etiket bölümlemesine ve bildirilen teslim anahtarları kümesine karşı doğrular. Aggregate’in kendi bileşeninin yazdığı bir bloktaki from: anahtarı katalog çözümlenir çözümlenmez denetlenir, dolayısıyla sizin yazdığınız satıra karşı başarısız olur; bir modülün katkıda bulunduğu bir bileşenin bloğundaki anahtar, modülü içe aktaran bileşim derlendiğinde denetlenir ve modülün kendi belgesindeki satıra karşı başarısız olur; ekli bir Feature’ın katkıda bulunduğu bir bağlantıdaki from: anahtarı ise bağlantı çizebilen her yüzey katkısını yaptıktan sonra denetlenir; bu, böyle bir bağlantının denetlenmek üzere var olduğu en erken noktadır.
Inject from key is not in the target’s provides (Inject from anahtarı hedefin provides alanında yok)
Bir inject: girdisi, okuduğu kaynağın yayımlamadığı bir from: anahtarına başvurur: bir bileşenin kendi bloğu veya bir bağlantı için bu kaynak hedef Component’in provides: şemasıdır; eklenmiş bir Feature’ın kendi inject: bloğu için ise eklenmiş Feature’ın FeatureRecipe’sidir.
Denetim, bağlantı nerede yazılmış olursa olsun uygulanır. Bir uses: bağlantısı derlenmiş topolojiye birden fazla yazım yüzeyinden ulaşır: bir Component’in kendi uses: bloğundan ve ona eklenmiş bir Feature’ın uses: bloğundan; bu ekleme ister bileşen üzerinde, ister bir alt sistem üzerinde, ister bir Release sınırı üzerinde, ister bir Release sınırının bileşen girdisi üzerinde yazılmış olsun. Aynı yanlış yazılmış anahtar bunların her birinde reddedilir. Tanılama, anahtarı yazan yazarın bloğunu gösterir: tüketen bileşenin katkıyla gelen bir bağlantı için hiçbir şey içermeyen uses: bloğunu değil, eklemenin kendi uses: girdisini, eklemenin bildirildiği yerde gösterir.
Başvurunun nereye çözümlendiği, nerede bulunduğuna bağlıdır. Component düzeyindeki bir self-inject from:, aynı Component’in kendi provides: şemasına göre çözümlenir. Bir uses: bağlantısı üzerindeki from:, o bağlantının işaret ettiği bileşenin provides: şemasına göre çözümlenir; iki yüzey tek bir soket ve tek bir takma ad yazdığında ise her bağlantı, çifti takma adı paylaştığı için reddeden aynı derlemede, kendisinin adlandırdığı hedefe göre çözümlenir. Hiç provides: bildirmeyen bir Component, kendisine yöneltilen her from: başvurusunu reddeder.
Eklenmiş bir Feature’ın kendi inject: bloğu. Oradaki bir from:, Feature’ın FeatureRecipe’sinin provides: içinde yayımladığı anahtarlara göre, Feature’ın eklendiği bileşen için değerlendirildiği şekliyle çözümlenir ve o bileşen işlenirken denetlenir. FeatureRecipe’nin yayımlamadığı bir anahtar bileşenin ortamına, dosyasına veya argümanına hiçbir şey koymayacağından derleme bunun yerine durur — FeatureRecipe, eklenmiş Feature’ın girdilerini .inject konumunda, eklenmiş Feature’ın kendi işleme bağlamına göre değerlendirdiği bir şablonda kendisi okumadıkça; bu bağlam .inject taşıyan bağlamdır: değer eşlemesi, iş yükü, yapıtları, çıkarma bildirimleri veya bir işlem hattı adımının with: ya da when: alanı, satır içi yazılmış veya içe aktarılmış olarak. locals:, provides:, source: ve assertions: alanları .inject taşımaz ve injectMapping: alanı bileşenin bağlamına göre değerlendirilir, bu nedenle bunlardan herhangi birindeki okuma sayılmaz. Böyle bir FeatureRecipe her girdiyi yazıldığı gibi alır ve kendi yöntemiyle teslim eder; bu yüzden girdileri reddedilmez ve yayımlamadığı bir anahtar, bileşenin kendi teslimi aracılığıyla hiçbir şey teslim etmez ve FeatureRecipe’nin kullanımına kalır. Bir FeatureRecipe’nin .inject okuyup okumadığı, şablonlarının adlandırdığı yollardan belirlenir: tüm bağlamını aktaran (toJson .) veya girdilere index . "inject" gibi bir işlev aracılığıyla ulaşan bir şablon girdileri okumak sayılmaz ve yayımlanmamış bir anahtarı adlandıran girdileri reddedilir. FeatureRecipe’si o sınır için bir kez işlenen, bir sınıra eklenmiş bir Feature, o tek değerlendirmeye göre denetlenir; bileşeni içeren hiçbir sınır böyle bir değerlendirme üretmediyse anahtarlarının denetleneceği bir şey yoktur ve reddedilmezler. Yayımlanmış bir anahtarı adlandıran bir from: eskisi gibi teslim eder. Bulgu, eklenmiş Feature’ın kendi girdisinde, onu yazan belgede konumlandırılır — örneğin Aggregate’teki .spec.components.<component>.features.<attachment> — ve teslim anahtarını başka bir inject kaynağının da zaten tuttuğu bir girdi, her biri kendi düzeltmesini gerektirdiğinden “An attachment delivers a key another inject source already claimed (Bir ek, başka bir inject kaynağının zaten sahiplendiği bir anahtarı teslim ediyor)” altında da raporlanır.
Bir bileşenin kendi inject: bloğunda bir value: girdisi bir sabit değer taşır ve hiçbir şeye karşı çözümlenmez; bu nedenle bir provides anahtarına benzeyen bir sabit değer orada reddedilmez; bir bağlantı üzerinde ise bir value: girdisi, aşağıdaki “An inject: entry on a connection carries a literal (Bir bağlantı üzerindeki inject girdisi bir sabit değer taşıyor)” bölümünün açıkladığı gibi reddedilir. Bir anahtarı yalnızca from: adlandırır.
Release’in kendi kenar başına uses: yüzeyi target ve infra taşır, inject: taşımaz; dolayısıyla orada bağlanan bir bağlantı hiçbir teslimi dayatmaz ve denetlenecek bir from: anahtarı yoktur.
Bir Component’in kendi inject: bloğunda okunan bir from: için üretilen ileti. Önce ret gelir, ardından hatalı anahtar, karşısında çözümlendiği bileşen türü ve o türün sıralanmış bildirilen anahtarları — seçilebilecek alternatifler:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (geçersiz inject anahtarı: from-key, kaynağının yayımladığı bir provides anahtarını adlandırmalıdır)
Bir uses: bağlantısında okunan bir from: için aynı ret başta gelir ve girdinin altında yazıldığı mekanizma ile teslim anahtarı, hatalı anahtardan önce gelir:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (geçersiz inject anahtarı: from-key, kaynağının yayımladığı bir provides anahtarını adlandırmalıdır)
Eklenmiş bir Feature’ın kendi inject: bloğunda okunan bir from: için önce hatalı anahtar gelir, ardından girdinin in: değeri ve mekanizması, çözümlendiği FeatureRecipe ve o FeatureRecipe’nin yayımladığı her anahtar, sıralı biçimde:
invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (geçersiz inject anahtarı: from-key, kaynağının yayımladığı bir provides anahtarını adlandırmalıdır)
Hedef hiç provides: anahtarı bildirmediğinde listelenecek alternatif yoktur, bu nedenle ileti bileşen türünden sonra — ya da eklenmiş bir Feature’ın bloğunda FeatureRecipe’den sonra — biter.
Nasıl düzeltilir: ya from: anahtarını iletide listelenen bildirilmiş anahtarlardan biriyle eşleşecek şekilde değiştirin ya da hedef Component’in provides: şemasını ihtiyaç duyduğunuz anahtarı bildirecek şekilde genişletin. Eklenmiş bir Feature’ın bloğunda from: anahtarını FeatureRecipe’nin yayımladığı bir anahtarla değiştirin ya da — FeatureRecipe sizinse — anahtarı onun provides: alanında yayımlayın ya da değeri kendi yöntemiyle teslim ediyorsa girdiyi .inject konumunda kendisinin okumasını sağlayın.
Required feature not attached (Gerekli feature eklenmemiş)
Component, bir varlık zorunluluğu — bir features.aggrega.ai/requiredType.<label> ek açıklaması — bildirir ve bu zorunluluk, her kapsam sayıldığında bu bileşen örneğinin sonunda sahip olduğu eklemeler arasında bulunmayan bir Feature türünü adlandırır: Aggregate’in bileşen düzeyindeki ve alt sistem düzeyindeki blokları, Release’in sınır düzeyindeki ve bileşen düzeyindeki blokları ve ek açıklama güdümlü genişletme.
Üretilen ileti:
missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (eksik gerekli feature: bileşene gerekli türde bir Feature ekleyin; component-type bileşen türünce, label gereksinim etiketi altında gerekli)
Üç değer şunlardır: zorunluluğun talep ettiği Feature türü — yukarıdaki cümle onu zaten adlandırdığı için yalın durur — ardından zorunluluğu bildiren bileşen türü ve zorunluluğun taşıdığı etiket; okuyucunun iki varlık başvurusunu birbirinden ayırabilmesi için her biri başlıkla verilir. İki farklı tür talep eden bir bileşen birbirinden farklı iki ileti bildirir ve zorunluluğu farklı türlerden bildiren iki bileşene her talebi hangi türün yaptığı söylenir. Rapor, bileşenin components: altındaki kendi anahtarında konumlandırılır; bir alt sistem içinde yazılmış bir bileşen ise önce o alt sistemin anahtarı altında konumlandırılır.
Bir eklemenin hangi ad altında yazıldığı burada önemli değildir: zorunluluk, adlandırılan türde bir eklemenin bulunup bulunmadığını sorar. Bir yuvayı bağlamak onu karşılar, başka herhangi bir ad altındaki bir ekleme de karşılar.
Nasıl düzeltilir: gerekli türde bir Feature’ı Aggregate’te ya da Release’te bileşene veya bileşenin miras aldığı daha geniş bir kapsama ekleyin. Component artık bunu gerektirmemeliyse, zorunluluk ek açıklamasını katalog bildiriminden kaldırın.
Bir varlık zorunluluğunun bildirimi değerlendirilemez. Bir ek açıklama değeri opak bir dizedir, bu nedenle derleyici onu okumadan önce biçimini hiçbir şey doğrulamaz: Feature türü URI’si olmayan bir değer ya da önekten sonra etiket olmadan zorunluluk ailesini adlandıran bir anahtar, karşılanmamış bir gereksinim olarak değil bozuk bir bildirim olarak bildirilir — bir yazım hatası asla karşılanmış bir gereksinim gibi okunmamalıdır.
Üretilen iletiler:
malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (hatalı biçimlendirilmiş ekleme gereksinimi: component-type bileşen türünce bildirilmiş, değerlendirilemiyor çünkü değer, core/prometheus-exporter örneğindeki gibi küçük harfli kebab bölümlerinden oluşan publisher/name biçiminde bir Feature türü URI’si olmalıdır. Bileşen türünün katalog varlığındaki o ek açıklamayı düzeltin.)
malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (hatalı biçimlendirilmiş ekleme gereksinimi: component-type bileşen türünce bildirilmiş, değerlendirilemiyor çünkü anahtarın, features.aggrega.ai/requiredType.database örneğindeki gibi gereksinimi adlandıran bir etikete ihtiyacı var. Bileşen türünün katalog varlığındaki o ek açıklamayı düzeltin.)
İleti, ek açıklama anahtarıyla — durmanın konusu olan bildirimle — başlar ve ardından bildirimi bozuk olan bileşen türünü adlandırır; böylece rapor o türü kullanan bileşen örneğinde konumlandırılmış olsa da düzeltilecek varlığı adlandırır: örnek, hatayı gördüğünüz yerdir; katalog varlığı ise çözümün bulunduğu yerdir.
Bu durma, kompozisyon bir araya getirilir getirilmez tetiklenir; bu, tamamlanmış grafiği okuyan her denetimden daha erkendir. Bu nedenle bozuk bir zorunluluk taşıyan bir derleme bunu tek başına bildirir: daha sonra çalışacak denetimlere ulaşılmaz, çünkü bu denetimler bildirimin ne söylediği üzerine akıl yürütür ve bildirim okunamaz. Geri kalanını görmek için düzeltip yeniden derleyin.
Nasıl düzeltilir: Component katalog varlığını düzeltin. Çözüm Aggregate’te değil katalogdadır — bu durmanın, kendi belgelerinizin değiştirilmesi gereken “Required feature not attached (Gerekli feature eklenmemiş)” durumundan ayrı olmasının nedeni budur.
Required attachment slot not bound (Zorunlu ek yuvası bağlanmamış)
Bir katalog varlığı, featuresSchema içinde required: true ile bir ek yuvası bildirir ve varlığın bir örneğinde hiçbir şey o yuvanın adını bağlamaz. Denetim, örneğin her kapsam katlandıktan sonra sahip olduğu eklere karşı çalışır: Aggregate’in bileşen düzeyindeki ve alt sistem düzeyindeki features: blokları, Release’in sınır düzeyindeki ve bileşen düzeyindeki blokları ve açıklama güdümlü genişletmenin ürettiği ekler. Bu nedenle örneğin miras aldığı bir kapsamda bir kez eklenen bir kimlik bilgisi, yuvayı tam olarak örnekte yazılmış bir doldurma gibi bağlar.
Üretilen ileti:
required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (zorunlu ek yuvası doldurulmamış (<slot>, <component-type> bileşen türü tarafından zorunlu olarak bildirilmiş). O ada, Aggregate’te veya Release’te, bileşende ya da onun üstündeki bir kapsamda bir Feature ekleyin.)
İki değer, slotun kendi adı ve onu bildiren component türüdür; bu nedenle iki slotu bağlanmamış bırakan bir örnek, birbirinden farklı iki ileti raporlar. Rapor, Aggregate’te component’in features: bloğu altındaki slot anahtarına konumlandırılır; bu anahtar tam olarak eksik olan şey olduğundan, bir düzenleyici raporu var olan en yakın anahtara yerleştirir: component’in bir features: bloğu yazdığı yerde bu bloğa, yazmadığı yerde ise component’in kendisine. Eksik eki hiçbir şey yazmadığından, bu rapor hiçbir belgenin yazarını işaret etmez: rapor component’te kalır ve bir geliştirici hatası olarak kaydedilir; çözüm de her iki belgeyi adlandırır, çünkü slotu ikisinden biri doldurabilir: Aggregate, component’te ya da onu içeren bir alt sistemde; Release ise component için olan girdisinde ya da onu içeren bir sınırda.
Bir soketin bildirdiği yuva (bir usesSchema girdisinin featuresSchema alanında), bileşenden değil, soket üzerinden bağlanan her bağlantıdan zorunlu olarak istenir: her bağlantı yuvayı kendisi için, Aggregate’teki veya Release’teki kendi girdisinde doldurur ve üstteki hiçbir kapsam ona ulaşmaz. Bu nedenle biri yuvayı dolduran iki bağlantılı bir soket yalnızca diğerini, onu adlandırarak raporlar:
required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (Zorunlu ek slot’u doldurulmamış (<slot>, <component-type> bileşen türünün <socket> soketi tarafından zorunlu olarak bildirilmiş, <alias> bağlantısı tarafından doldurulmamış bırakılmış). Bu bağlantının features’ında, Aggregate’teki ya da Release’teki girdisinde, o slot altında bir Feature ekleyin.)
Bu rapor, bağlantıyı çizen belgedeki bağlantı girdisine konumlandırılır: Aggregate’in uses: girdisi ya da Release’in bağladığı bir bağlantı için Release’in kenar başına girdisi. Eklenmiş bir Feature’ın çizdiği bağlantı, bileşenin soketlerinden birine değil, Feature’ın bildirdiği bir sokete bağlanır; bu nedenle bileşenin soket yuvalarını doldurmak ona düşmez.
Nasıl düzeltilir: yuvanın adı altında, Aggregate’te veya Release’te bir Feature ekleyin: bileşende ya da yuvanın her tüketicisinin paylaştığı daha geniş bir kapsamda; bir soketin yuvası için ise raporun adlandırdığı bağlantıda. Farklı bir ad altındaki ek yuvayı bağlamaz: yuva adlandırılmış bir bağlama noktasıdır, dolayısıyla bağlamayı ad yapar. Yuva artık zorunlu olmamalıysa, required bildirimini kaldırmak için katalog varlığının featuresSchema alanını (bileşenin kendisininkini ya da soketinkini) güncelleyin.
Two Features declared to conflict reach one component (Çakıştığı bildirilen iki Feature tek bir bileşene ulaşıyor)
Bir Feature’ın interoperability.conflictsWith alanı, onunla birlikte eklenemeyeceği Features’ı adlandırır ve bir bileşen sonunda hem Feature’ı hem de onun adlandırdığı birini taşır. Denetim, bileşenin her kapsam katlandıktan sonra sahip olduğu eklere karşı çalışır: Aggregate’in bileşen düzeyindeki ve alt sistem düzeyindeki features: blokları, Release’in sınır düzeyindeki blokları (iç içe olanlar dahil, bileşenin içinde bulunduğu her sınır) ve bileşen düzeyindeki girdileri ve açıklama güdümlü genişletmenin ürettiği ekler. Bu nedenle bir çift, ikisi de bileşende yazıldığında, biri onu içeren bir sınırda veya alt sistemde olduğunda ya da biri dış bir sınırda, diğeri onun içine yerleşmiş bir sınırda bulunduğunda durdurur. Ortak bileşeni olmayan kardeş sınırlara eklenen iki Features hiç karşılaşmaz ve hiç bileşen içermeyen bir sınır hiçbir şeye ulaşmaz; dolayısıyla ikisi de durdurmaz.
Tek bir bildirim yeterlidir: durma, Feature’lardan birinin listesi diğerini adlandırdığında tetiklenir. Adlar iki tarafta da sürüm çıkarılarak karşılaştırılır; bu nedenle bir girdi, adlandırdığı Feature’ın her sürümüyle eşleşir. Derleyici, Feature yazarının bildirdiği adları bileşenin taşıdığı Features ile karşılaştırır ve ikisine de bundan fazla anlam yüklemez.
Üretilen ileti:
a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (Bir Feature, çakıştığını bildirdiği bir Feature ile birlikte bir bileşene ulaşıyor (<feature>, Release’te <boundary-path> sınırı üzerinde eklenmiş, Aggregate’te <component> bileşeni üzerinde eklenmiş <other-feature> ile çakışıyor, <component> bileşeni üzerinde). Buluştukları yerde ikisinden yalnızca birini ekleyin: eklerden birini kaldırın ya da bu bileşeni barındırmayan bir kapsama taşıyın.)
İlk değer, listesi diğerini adlandıran Feature’dır (yukarıdaki cümlenin adlandırdığı Feature) ve eklendiği her yer onu izler; ardından çakıştığı Feature ve onun eklendiği her yer gelir; en son da ikisinin buluştuğu component gelir. Her yer, onu değiştirmek için açacağınız belgenin sözcükleriyle yazılır: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (iç içe bir sınırın yolu düzeylerini / ile birleştirir), ardından in boundary gelen attached in the Release on the entry for component ya da ardından yazıldığı yeri belirten declared at gelen, ek açıklamayla birlikte attached by annotation-driven expansion of. Bir bağlantı üzerine yazılmış bir ek, o bağlantının girdisi olarak yazılır, çünkü düzenlendiği yer component’in kendi bloğu değil bu girdidir: ardından through socket ve of component gelen attached in the Aggregate on the connection ya da ardından through socket, of the entry for component ve in boundary gelen attached in the Release on the connection. İki yerde eklenmiş bir Feature her ikisini de listeler. Rapor, component’in components: altındaki kendi anahtarına konumlandırılır ve birden çok component üzerinde buluşan bir çift, Aggregate’in component’leri bildirdiği sırayla her biri için bir kez raporlanır.
Nasıl düzeltilir: karşılaştıkları yerde ikisinden yalnızca birini ekleyin: eklerden birini kaldırın ya da birini, kardeş bir sınır gibi, bu bileşeni içermeyen bir kapsama taşıyın. Ek açıklama güdümlü genişletmeden geldiyse, değiştirilecek olan genişletildiği blok değil, açıklamadır. İki Features aslında birleştirilebiliyorsa, hatalı olan bildirimdir: bildiren Feature’ın katalog varlığındaki conflictsWith listesinden diğer Feature’ı kaldırın.
Attachment does not conform to its declared slot shape (Ek, bildirilen yuva biçimine uymuyor)
Bir ek, bildirilmiş bir yuvayı bağlar ancak o yuvanın bildirdiği biçimle eşleşmez. Yaygın durum teslimattır: bir yuvanın inject izin listesi, bir doldurmanın malzemesini teslim edebileceği mekanizmaları adlandırır ve boş bir izin listesi kara kutudur — Recipe malzemeyi dahili olarak teslim eder ve bir doldurma hiçbir teslimat dayatamaz. Boş bir inject: {} bloğu hiçbir teslimat dayatmaz; bu nedenle izin listesi boş olan dahil her yuvanın biçimine uyar ve ek nerede yazılırsa yazılsın aynı kararı alır: Aggregate’in bildirdiği bir bileşende, içe aktarılan bir modülün katkıda bulunduğu bir bileşende ya da daha geniş bir kapsamda. Hiçbir yuvanın bildirmediği bir ad altındaki ek serbest bir ektir ve hiçbir yuva kısıtı taşımaz.
Ekin, yuvasının kabul etmediği bir teslimi dayattığı durumda verilen ileti — önce yuva, sonra mekanizma, ardından yuvanın inject izin listesinin kabul ettiği her mekanizma, yuvanın onları bildirdiği sırayla (boş bir izin listesinde ardından hiçbiri gelmez):
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (ek, bildirilmiş yuva biçimine uymuyor)
İçe aktarılan bir modülün katkıda bulunduğu bir bileşen, onu içe aktaran kompozisyon oluşturulduktan sonra denetlenir ve ikinci bir biçimde raporlanır. Bu biçim, modülün Aggregate’ini ve modülün belgesinde yuvanın bildirmediği anahtarı belirtir — ekin inject: bloğu altındaki bir mekanizma ya da izin listesi boş olan bir yuvada herhangi bir mekanizma adlandırdığında inject: bloğunun kendisi:
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (ek, bildirilen yuva şekline uymuyor: bu anahtar yuvanın bildiriminin parçası değil)
burada <remedy> anahtara bağlıdır:
remove it, izin listesi boş olan bir yuvada bir mekanizma adlandıran bir inject: bloğu için;
remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, bir yuvanın izin listesinin adlandırabileceği bir mekanizma için — env, file veya arg;
remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, hiçbir yuvanın bildiremeyeceği diğer herhangi bir mekanizma için.
Daha geniş bir kapsamda bildirilen bir ek — alt sistem genelinde, altındaki her bileşene basamaklanarak — aynı biçime tabidir ve ulaştığı her bileşendeki yuvaya karşı denetlenir. Bu nedenle aynı ek bir bileşen için biçime uygun, bir başkası için uygunsuz olabilir; bu yüzden bu biçim, bileşeni ve başarısız olduğu yuvayı adlandırır ve eki, teslimat bloğu içindeki bir anahtarda değil, bildirildiği kapsamda konumlandırır:
attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (ek, bildirilen yuva şekline uymuyor: bu ek, bir bileşene ulaşan bir kapsamda bildirilmiş ve bu bileşenin ek yuvası, ekin taşıdığı teslimatı kabul etmiyor: eki, onu alabilecek bileşenlere indirin)
Bir bağlantının taşıdığı ek bu durdurmaya asla ulaşmaz. Biçimi yazıldığı yerde kapalıdır: Aggregate’in bağlantı girdisinde type, description ve values alır, Release’inkinde ise type, description ve infra; dolayısıyla hiçbir teslimat dayatamaz — orada yazılan bir inject: belge yüklenirken anahtar adlandırılarak reddedilir — ve onu teslim eden Workload girdisi bunun yerine soket yuvasının inject izin listesine tabidir. Hiçbir kapsam bir soketin yuvasına da ulaşmaz, bu yüzden yukarıdaki kapsam genelindeki biçimin bir bağlantıda karşılığı yoktur.
Nasıl düzeltilir: bu biçimler iki farklı düzenleme gerektirir ve hangisiyle karşı karşıya olduğunuzu alan yolu söyler. Bir bileşendeki bir eki ya da onun içindeki bir anahtarı adlandırıyorsa hata teslimattadır: onu kaldırın ya da girdilerini yuvanın inject izin listesinin adlandırdığı bir mekanizmanın altına taşıyın. Malzemenin gerçekten yuvanın listelemediği bir mekanizma üzerinden iş yüküne ulaşması amaçlanıyorsa, katalog varlığının featuresSchema alanındaki izin listesi genişletilebilir — ancak yalnızca bir yuvanın bildirebileceği mekanizmalar olan env, file veya arg ile; orada başka bir mekanizmayı adlandıran bir Component yüklenirken doğrulamada başarısız olur; bu nedenle başka herhangi bir mekanizma için tek düzeltme onu kaldırmaktır. Bir kapsamdaki eki adlandırıyorsa ek iyi biçimlidir ve hata yerleşimindedir: eki, yuvası teslimatı kabul eden bileşenlere indirin; teslimatı kendi Recipe’lerine ayıran bileşenleri erişiminin dışında bırakın.
Duplicate delivery key across inject sources (Inject kaynakları arasında yinelenen teslim anahtarı)
Aynı teslim anahtarı (örneğin aynı ortam değişkeni adı), bir bileşen için geliştiricinin yazdığı inject kaynakları arasında iki kez talep edilmiştir: Component düzeyinde ve bir uses[] girdisi altında, aynı bileşendeki iki uses[] girdisinde ya da Component’in kendi inject: bloğunun iki teslim mekanizması altında. Teslim aynı anda iki yerden gelemez; bu nedenle iki kez talep edilen bir anahtar, hangisinin kazanacağı sorusu değil, bir çelişkidir.
Derleme bunu dört yerde okur; çünkü bu yerler farklı yazılmış kaynak ve bağımlılık bağlantısı kümelerini görür ve bunlara farklı sorular sorar. Her biri kendi biçiminde raporlar.
Birincisi Aggregate’te yazdığınız bağlantıları okur ve dosyalarınız çözümlenirken raporlar. Teslim mekanizmasını, anahtarı, ardından da yazım sırasında bu anahtarı talep eden ilk bağlantının soketini ve takma adını belirtir:
duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (inject kaynakları arasında yinelenen teslim anahtarı: Aggregate <name>, konum .spec.components.<component>.inject.<mechanism>.<key>, “<mechanism>”, “<key>”, “<socket>”, “<alias>”)
İkincisi aynı yazılmış bloğu okur ve ona farklı bir soru sorar: bileşenin, hiçbir bağlantı söz konusu olmadan, kendi teslim mekanizmalarından ikisi altında aynı anahtarı talep edip etmediği. Anahtarı talep eden her mekanizma için bir kez, o mekanizmanın kendi girdisinde konumlanarak raporlar; raporun ilgili olduğu mekanizmayı, anahtarı ve ardından anahtarı talep eden diğer tüm mekanizmaları yazım sırasıyla belirtir:
duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (inject kaynakları arasında yinelenen teslim anahtarı: Aggregate <name>, konum .spec.components.<component>.inject.<mechanism>.<key>, “<mechanism>”, “<key>”, “<other-mechanism>”)
Mekanizmalardan hiçbiri suçlu değildir ve her iki raporu da sizin düzeltmeniz gerekir: anahtarı bunlardan birinin altında yeniden adlandırın ya da iki teslimden birini kaldırın. Bir bileşenin hangi mekanizmaları kullanabileceği ayrı bir sorudur ve bunu bileşenin spec.inject izin listesi yanıtlar; aşağıdaki “Self-inject mechanism not in the component’s allowlist (Öz-inject mekanizması bileşenin izin listesinde değil)” bölümüne bakın.
Bir modülün katkıda bulunduğu bir bileşen de bu ilk iki biçimle karşılaşır; bunlar, onu içe aktaran bileşim derlendiğinde modülün kendi belgesinden okunur ve bu durumda modülün Aggregate’ini ve onun belgesindeki anahtarı adlandırır.
Üçüncüsü, tamamlanmış topolojinin taşıdığı bağlantıları okur; buna bir Feature ekinin sizin adınıza eklediği bağlantılar da dahildir. Hiçbir şey işlenmeden önce çalışır ve yazdığınız teslim anahtarını, onu aynı zamanda teslim eden bağımlılık soketiyle birlikte belirtir:
duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (self-inject ile uses-inject arasında yinelenen teslim anahtarı: “<key>”, soket “<socket>”)
İki bağımlılık soketi üzerinden teslim edilen tek bir yazılmış anahtar her soket için bir kez raporlanır; böylece tek bir derleme, yalnızca ilk ulaşılanı değil, hepsini size bildirir.
Dördüncüsü aynı tamamlanmış topolojiyi okur ve ona farklı bir soru sorar: bileşenin kendisi hiçbir şey talep etmezken, bileşenin kendi bağımlılık bağlantılarından ikisinin aralarında tek bir anahtarı teslim edip etmediği. Her bağlantıda bir kez, o bağlantının kendi teslim girdisinde konumlanarak raporlar ve girdinin yolunu, ardından anahtarı teslim eden her soketi belirtir:
duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (inject kaynakları arasında yinelenen teslim anahtarı: “inject.<mechanism>.<key>”, “<socket>”, “<socket>”)
İki kez adı geçen bir soket, iki bağlantının farklı takma adlar altında tek bir sokette durduğunu size gösterir; bu durumda onları ayıran tek şey konumdur, bu yüzden soket adlarını değil, iki raporun her birinin alan yolunu okuyun.
Bağlantılardan hiçbiri suçlu değildir ve her ikisini de sizin düzeltmeniz gerekir: anahtarlardan birini yeniden adlandırın ya da iki teslimden birini kaldırın.
Anahtar bir yol olduğunda, alan yolu bunun yerine mekanizmanın bloğunu belirtir. Bir teslim anahtarının ne yazdığı mekanizmanın kendi işidir ve bir file mekanizması bir bağlama yoluna teslim eder; dolayısıyla böyle bir anahtar nokta içerir, alan yolu ise kendi adımlarını noktalarla ayırır. Alan yolu, belgenizde bulunmayan anahtarlar arasında bir gezinti gibi okunacak bir yol yazmak yerine belirsizlik olmadan adlandırabileceği son adımda durur; bu yüzden /etc/app/config.yaml gibi bir anahtar için .spec.components.<component>.inject.<mechanism> olarak okunur ve orada durur. İleti her iki durumda da anahtarı belirtir ve raporu aynı ölçüde uygulanabilir kılan budur; ancak iletinin neresinde okunacağı yukarıdaki dört biçimde farklıdır. Bu yüzden blok için alan yolunu okuyun, ardından anahtarı elinizdeki biçimden alın: ayrıntı teslim mekanizmasıyla başlıyorsa anahtar hemen ardından gelen tırnaklı değerdir; ayrıntı tek başına anahtarla başlıyorsa ilk tırnaklı değerdir; ayrıntı teslim girdisinin kendi yoluyla başlıyorsa anahtar o yolun son adımıdır.
Nasıl düzeltilir: çakışan anahtarlardan birini yeniden adlandırın veya yinelenen bildirimi kaldırın. Bir FeatureRecipe’in injectMapping alanının, bileşenin kendi inject: bloğunun ya da bağlantılarından birinin inject: bloğunun teslim ettiği bir anahtarı yeniden yazmasının kasıtlı bir araya girme olduğunu ve ne burada ne de başka bir yerde işaretlendiğini unutmayın.
Bileşene eklenmiş bir Feature’ın talep ettiği bir anahtar, aynı ortak alanla üç yazım yüzeyinden üçüncüsünden karşılaşır ve aşağıdaki “An attachment delivers a key another inject source already claimed (Bir ek, başka bir inject kaynağının zaten talep ettiği bir anahtarı teslim ediyor)” altında raporlanır; eklenmiş iki Feature’ın teslim ettiği ve ikisinden sonrakinin onu FeatureRecipe’inin injectMapping alanı üzerinden teslim ettiği bir anahtar ise “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Eklenmiş iki Feature tek bir anahtarı teslim ediyor, sonraki FeatureRecipe’inin injectMapping alanı üzerinden)” altında raporlanır.
Self-inject on a component without an allowlist (İzin listesi olmayan bir bileşende öz-inject)
Geliştirici bileşen düzeyinde bir inject: bloğu yazmış, ancak Component katalog varlığı spec.inject bildirmiyor. spec.inject izin listesi olmayan Components, Black-Box türleridir: geliştiricinin yazdığı hiçbir enjeksiyonu almazlar.
Üretilen ileti:
self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (spec.inject izin listesi olmayan bileşende self-inject)
Rapor, kaldırılması gereken öğe olan inject: bloğunun kendisinde konumlanır.
Nasıl düzeltilir:inject: bloğunu bu Component örneğinden kaldırın ya da katalog bildirimi spec.inject içeren bir White-Box Component türüne geçin.
Self-inject mechanism not in the component’s allowlist (Öz-inject mekanizması bileşenin izin listesinde değil)
Geliştirici, Component’in spec.inject izin listesinde yer almayan bir mekanizmayı (örneğin env ya da belirli bir dosya bağlama biçimi) kullanan, bileşen düzeyinde bir inject: bloğu yazmıştır.
Üretilen ileti:
self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (spec.inject izin listesi olmayan bileşende self-inject)
Türün izin verdiği mekanizmalar, dayatılan mekanizmanın ardından gelir; böylece ileti hem yazılanı hem de türün izin verdiklerini taşır. Hiç izin listesi bildirmeyen bir tür, dayatılan mekanizmayı ardından hiçbir şey olmadan raporlar.
Hem bu kural hem de yukarıdaki kural, modülü içe aktaran bileşim derlendiğinde, bir modülün katkıda bulunduğu bileşen için de geçerlidir; bu durumda rapor, modülün Aggregate’ini ve onun belgesindeki anahtarı adlandırır.
Nasıl düzeltilir: izin listesindeki bir mekanizmaya geçin ya da Component’in ihtiyaç duyduğunuz mekanizmayı desteklemesi gerekiyorsa, katalogdaki spec.inject izin listesini genişletin.
uses kenarı, hiçbir mekanizmaya izin vermeyen bir sokette teslimatı dayatıyor
Bir uses: kenarındaki inject: bloğu, usesSchema girdisi hiçbir inject: izin listesi bildirmeyen ya da boş bir liste bildiren bir sokete bağlanıyor. Böyle bir soket bir Black-Box bağlantısıdır: onu bildiren varlık, bağımlılığın değerlerini kendi içinde işler; bu nedenle tüketici, üreticinin Recipe’inin ürettiği her şeyi alır ve teslimat biçimini seçmez. Bulunmayan bir inject: anahtarı ile inject: [] aynı bildirimdir.
Soket, onu hangi varlık bildirdiyse onun üzerinde okunur: bir Feature eklentisi üzerinde yazılmış bir kenar, eklenen Feature’ın usesSchema bildirimine göre çözümlenir; diğer her kenar ise tüketen Component’inkine göre.
Üretilen ileti. Önce ret gelir, ardından kenarın dayattığı mekanizmalar, soket ve bildirimi okunan varlık; sonra da bu konuda ne yapılacağı:
uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (uses kenarındaki inject, soketin izin vermediği bir teslim mekanizması dayatıyor (“<mechanism>”, “<socket>” soketinde, “<component-type>” bileşen türünde bildirilmiş). Soket hiçbir teslim izin listesi bildirmiyor, bu nedenle hiçbir dayatmaya izin vermez; onu bildiren varlık bağımlılığın değerlerini kendisi teslim eder. Bu bağlantıdan inject bloğunu kaldırın ve değerleri tüketen Recipe içinde bağlantının provides’ından okuyun ya da soketin izin verdiği mekanizmaları usesSchema girdisinde bildirin.)
Bulgu, ilgili olduğu yazılmış girdide, o girdinin yazıldığı belgede konumlanır: bir bileşenin kendi uses: bloğunun çizdiği kenar için .spec.components.<consumer>.uses.<socket>.<alias>, bir eklentinin çizdiği kenar için ise .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias>; bu yol, eklentiyi bildiren bloktan başlar ve bu blok bileşenin kendisininki yerine bir alt sistemin ya da bir sınırın bloğu olabilir. Soket eklenen Feature üzerinde bildirilmişse ileti, bileşen türü yerine feature türünü adlandırır. Her sorunlu kenar ayrı bir bulgu olarak bildirilir; böylece tek bir derleme hepsini adlandırır.
Nasıl düzeltilir: kenardan inject: bloğunu kaldırın ve bağımlılığın değerlerini bunun yerine tüketen Recipe’te .context.uses.<alias>.provides.<name> üzerinden okuyun; ya da bağlantının saydam olması amaçlanıyorsa, soketin izin verdiği teslimat mekanizmalarını usesSchema girdisinin inject: izin listesinde bildirin.
Bildiren varlığın hiç bildirmediği bir soket farklı bir durumdur ve burada reddedilmez: geçici bir soket hiçbir izin listesi taşımaz, dolayısıyla kenarın dışında kalabileceği bir şey yoktur.
uses kenarı, soketin izin listesi dışında bir teslimat mekanizması dayatıyor
Bir uses: kenarındaki inject: bloğu, soketin inject: izin listesinde yer almayan bir teslimat mekanizmasını adlandırıyor. İzin listesi, bildiren varlığın, giriş noktasının bağımlılığın değerlerini gerçekte hangi teslimat biçimlerinden okuyabildiğine dair beyanıdır; bu nedenle listenin dışındaki bir mekanizma, hiçbir şeyin tüketmediği değerleri teslim ederdi.
Bloğun adlandırdığı her mekanizma denetlenir ve izin listesi dışındaki her biri bildirilir; böylece her çalıştırmada bir tane yerine tek bir derleme hepsini adlandırır.
Üretilen ileti. Önce ret gelir, ardından reddedilen mekanizma, soket, o soketin izin verdikleri ve bildirimi okunan varlık:
uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (uses kenarındaki inject, soketin izin vermediği bir teslim mekanizması dayatıyor (“<mechanism>”, “<socket>” soketinde, izin verdikleri “<mechanism-1>, <mechanism-2>”, “<component-type>” bileşen türünde bildirilmiş). Soketin izin verdiği mekanizmalardan birini dayatın ya da bildiren varlığın usesSchema girdisinde o soketin inject izin listesini genişletin.)
Bulgu, ilgili olduğu yazılmış girdide, yukarıdaki retin adlandırdığı yollarla aynı yollarda konumlanır. Soket eklenen Feature üzerinde bildirilmişse ileti, bileşen türü yerine feature türünü adlandırır.
Nasıl düzeltilir: izin listesindeki mekanizmalardan birine geçin ya da varlığın ihtiyaç duyduğunuz mekanizmayı desteklemesi gerekiyorsa, katalogdaki usesSchema girdisinde o soketin inject: izin listesini genişletin.
Bir inject: girdisi hem bir değişmez değer hem de bir kaynak anahtar taşıyor
Bir inject: girdisi iki şeyden birini teslim eder: value: altında yazılan bir değişmez değer — bir bileşenin kendi bloğunda, değişmez değerin teslim edildiği tek yerde — ya da from: altında yazılan, bağlantının işaret ettiği bileşenden okunan bir anahtar. İkisini birden taşıyan bir girdi aynı anda iki şey söyler ve aralarında seçim yapmak için hiçbir kural sunmaz; bu nedenle ikisinden birinin sessizce kazanması yerine reddedilir.
Yazım şemaları bu ikiliden tam olarak birini kabul eder; bu nedenle bir dosyadan okunan belge yüklenirken reddedilir. Bu, o denetimin arkasında duran denetimdir: iki belge çözümlenirken Aggregate ve Release’in taşıdığı her inject: bloğunu okur; böylece dosya dışında başka bir yoldan oluşturulan bir belge de sessizce bir alanın seçilmesi yerine, ondan herhangi bir şey oluşturulmadan önce yine reddedilir. Aşağıdaki biçim denetimiyle aynı blokları kapsar.
Sorunlu bir girdi barındıran her teslimat mekanizması, onu yazan belgedeki o mekanizmanın konumunda — bir bileşenin kendi bloğu için .spec.components.<component>.inject.env — ayrı bir bulgu olarak bildirilir ve derlemedeki tüm bulgular tek seferde bildirilir. Bulgu mekanizmayı, ardından o mekanizmanın listesindeki her sorunlu girdinin in: değerini adlandırır.
Üretilen ileti:
inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (inject girdisi hem değişmez değer hem kaynak anahtar taşıyor; şema tam olarak birini gerektirir)
Nasıl düzeltilir: iletinin adlandırdığı her girdiyi açın ve ikisinden ihtiyaç duymadığını silin. Değer bağlantının işaret ettiği bileşenden gelmeliyse from: alanını tutun; bu alan, o bileşenin provides: alanının bildirdiği bir anahtarı adlandırır. Değer, bir bileşenin kendi bloğunda bu tarafın sağladığı bir değişmez değerse value: alanını tutun; bir bağlantıda ve eklenmiş bir Feature’ın kendi bloğunda değişmez değer reddedilir, bu nedenle orada from: alanını tutun.
An inject: entry on a connection carries a literal (Bir bağlantıdaki enjeksiyon girdisi değişmez değer taşıyor)
Bir bağlantı, tüketen bileşene işaret ettiği bileşenin yayımladığı şeyi teslim eder: bağlantının inject: bloğundaki her girdi, from: altında o bileşenin provides: anahtarlarından birini adlandırır. value: altında yazılan bir değişmez değer, hedefin yayımladığı hiçbir şeyi adlandırmaz; bu nedenle bir bağlantıda yeri yoktur ve girdi atılmak yerine reddedilir. Bir bileşenin kendisine teslim ettiği değişmez değer, value: alanının kabul edildiği, bileşenin kendi inject: bloğuna aittir.
Hangi belge çizmiş olursa olsun her bağlantı denetlenir: bir bileşenin kendi uses: bloğundaki bağlantı, Aggregate içinde eklenmiş bir Feature’ın çizdiği bağlantı ve Release içinde yazılmış bir ekin çizdiği bağlantı. Herhangi bir şey işlenmeden önce reddedilir; bu nedenle aggrega build gibi aggrega validate --release de bunu bildirir.
Her sorunlu girdi, bağlantıyı çizen belgedeki bağlantının girdisinde konumlanan ayrı bir bulgu olarak bildirilir — bir bileşenin kendi bağlantısı için .spec.components.<component>.uses.<socket>.<alias>, bir ekin çizdiği bağlantı için .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> ve Release’te ekin girdisinin altındaki aynı yol, örneğin .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias> — ve derlemedeki tüm bulgular tek seferde bildirilir. Aggregate’teki bir bulgu DEVELOPER_ERROR altında, Release’teki bir bulgu OPS_ERROR altında kaydedilir. Bulgu mekanizmayı ve girdinin in: değerini adlandırır.
Üretilen ileti:
inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (bir bağlantıdaki inject girdisi değişmez değer taşıyor; bağlantı hedefin yayımladığı anahtarları teslim eder ve her biri kaynak anahtarla adlandırılır)
Nasıl düzeltilir: değer hedefin yayımladığı bir değerse, value: alanını o provides: anahtarını adlandıran from: ile değiştirin. Tüketen bileşenin ihtiyaç duyduğu bir değişmez değerse, girdiyi o bileşenin kendi inject: bloğuna taşıyın; bu bloğun mekanizmalarını Component türünün spec.inject izin listesi belirler.
An inject: entry on an attached Feature carries a literal (Eklenmiş bir Feature üzerindeki enjeksiyon girdisi bir değişmez değer taşıyor)
Eklenmiş bir Feature üzerine yazılan inject: bloğu, o ekin FeatureRecipe’sinin yayımladığını bileşene teslim eder: her girdi, FeatureRecipe’nin provides: alanının yayımladığı anahtarlardan birini from: altında adlandırır. value: altında yazılan bir değişmez değer, ekin yayımladığı hiçbir şeyi adlandırmaz, bu nedenle o girdinin in: değeri altında bileşene hiçbir şey ulaşmaz; girdi, oluşturulup atılmak yerine reddedilir. Bileşenin ihtiyaç duyduğu bir değişmez değer, bileşenin kendi inject: bloğuna aittir; orada value: kabul edilir ve teslim edilir.
Bir Aggregate’in üzerine inject: bloğu yazdığı her ek denetlenir: bir bileşenin kendi features: bloğundaki ek ve alt sistemin içerdiği her bileşene ulaşan bir alt sistemin features: bloğundaki ek — Release’in adlandırdığı Aggregate’te ve o Aggregate’in aggregates: altında içe aktardığı her modülde, her derinlikte. Bir ekin çizdiği bağlantı kendi inject: bloğunu taşır ve oradaki bir değişmez değer yukarıdaki bağlantı reddine girer. Bir Release eki kendine ait bir inject: bloğu yazmaz. Girdi, herhangi bir şey işlenmeden önce reddedilir; bu nedenle aggrega validate --release de aggrega build gibi bunu raporlar.
Her hatalı girdi kendi bulgusu olarak raporlanır; bloğu yazan belgenin ait olduğu Aggregate’e karşı DEVELOPER_ERROR olarak kaydedilir — bir modülde yazılmış bir ek için modülün kendi belgesi — ve o belgede ekin bloğu içindeki teslim mekanizmasında konumlandırılır: .spec.components.<component>.features.<attachment>.inject.<mechanism> veya bir alt sistemin eki için .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism>. Bir belgedeki tüm girdiler aynı anda raporlanır; içe aktarılan bir modüldekiler, içe aktaran Aggregate denetimden geçtiğinde raporlanır. Bulgu, mekanizmayı ve girdinin in: değerini adlandırır. Hem value: hem from: taşıyan bir girdi, yukarıdaki “An inject: entry carries both a literal and a source key (Bir enjeksiyon girdisi hem bir değişmez değer hem bir kaynak anahtarı taşıyor)” altında yalnızca bir kez raporlanır.
Üretilen ileti:
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 ("<mechanism>", "<in>") (bir ekteki inject girdisi bir değişmez değer taşıyor; bir ek, FeatureRecipe’sinin yayımladığı anahtarları her birini kaynak anahtarı olarak adlandırarak teslim eder ve bir değişmez değer bileşenin kendi inject bloğuna aittir)
Nasıl düzeltilir: değer ekin FeatureRecipe’sinin yayımladığı bir değerse value: alanını o provides: anahtarını adlandıran from: ile değiştirin. Bileşenin ihtiyaç duyduğu bir değişmez değerse girdiyi bileşenin kendi inject: bloğuna taşıyın; bu bloğun mekanizmalarını Component türünün spec.inject izin listesi belirler:
components:
api:
type:core/api
inject:
env:
-in:LITERAL_NAME
value:a-literal# the literal, delivered by the component's own block
features:
token:
type:core/token
inject:
env:
-in:TOKEN_NAME
from:name# a key the attachment's FeatureRecipe publishes
An inject: delivery is not a list of entries (Bir enjeksiyon teslimatı girdi listesi değil)
Bir inject: bloğundaki her teslimat mekanizması — env, file, arg ya da bunların yanında adlandırılan bir mekanizma — her biri in: ile from: veya value: alanlarından tam olarak birini taşıyan girdilerden oluşan bir listedir. Adlardan anahtarlara bir eşleme gibi başka bir şey barındıran bir mekanizma, derleyicinin okuyabileceği hiçbir şey teslim etmez; bu nedenle atılmak yerine reddedilir. Hiç değer yazılmamış bir mekanizma hiçbir şey teslim etmez ve reddedilmez.
Yazım şemaları yalnızca listeyi kabul eder; bu nedenle bir dosyadan okunan belge, türünün şemasıyla eşleşmeyen bir belge olarak yüklenirken reddedilir. Bu, o denetimin arkasında duran denetimdir: iki belge çözümlenirken Aggregate ve Release’in taşıdığı her inject: bloğunu okur; böylece dosya dışında başka bir yoldan oluşturulan bir belge de teslimatın kaybolması yerine, ondan herhangi bir şey oluşturulmadan önce yine reddedilir. Her iki belgenin taşıdığı her bloğu kapsar: Aggregate’te bir bileşenin kendi bloğunu, bir ekin bloğunu ve ikisinden birinin çizdiği bağlantılardaki blokları; Release’te eklerinin çizdiği bağlantılardaki blokları.
Her sorunlu mekanizma, onu yazan belgedeki o mekanizmanın konumunda ve mekanizmayı adlandıran ayrı bir bulgu olarak bildirilir ve derlemedeki tüm bulgular tek seferde bildirilir. Aggregate’in bulguları Release’inkilerden önce bildirilir.
Üretilen ileti:
inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (inject teslimatı: biçim, her biri bir hedef konum ile kaynak anahtar veya değişmez değerden tam olarak birini taşıyan girdilerden oluşan bir liste olmalıdır)
Konum, yazarın yazdığı anahtar yoludur. Aggregate’te bir bileşenin kendi bloğu için .spec.components.<component>.inject.<mechanism>, bağlantılarından birindeki blok için .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> ve bir ekin bloğu için .spec.components.<component>.features.<attachment>… kullanılır; bir bileşenin veya ekin bildirildiği her alt sistem için .subsystems.<name> eklenir. Release’te, bir ekin çizdiği bağlantıdaki blok o ek üzerinden gösterilir — sınır genelinde eklenmiş bir ek için .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism>, bir bileşene eklenmiş bir ek için .spec.boundaries.<boundary>.components.<component>.features.<attachment>…; her iç içe sınır için .boundaries.<name> ve bir bileşenin üzerinden adlandırıldığı her yönlendirme girdisi için .aggregates.<module> eklenir.
Nasıl düzeltilir: iletinin adlandırdığı her mekanizmayı bir liste olarak yazın. env: altındaki DB_URL: host girdisi, host bir provides: anahtarını — bir bağlantıda bağlı bileşeninkini, kendi bloğunda bileşenin kendisininkini — adlandırdığında from: host ile birlikte - in: DB_URL olur; ya da bileşenin kendi bloğunda, bu tarafın sağladığı bir değişmez değerse value: host ile birlikte.
The Feature filling an attachment slot does not satisfy the slot’s selector (Bir ek yuvasını dolduran Feature, yuvanın seçicisini karşılamıyor)
Bir Component, beklediği Features için adlandırılmış bağlama noktaları bildirir ve bir yuva, onu dolduran her şeyin etiketlerini kısıtlayan bir selector: bildirebilir. Bir ek, yuvanın adını taşıyarak o yuvayı bağlar; bu durumda adını verdiği Feature’ın etiketleri bu kısıta göre eşleştirilir ve kısıtı karşılamayan bir dolgu derlemeyi durdurur. Kısıt bildirmeyen bir yuva her dolguyu kabul eder.
Bir yuvanın hiç bağlanmadan bırakılıp bırakılamayacağı, farklı bir çözümü olan farklı bir sorudur ve yukarıdaki kendi durdurmasıyla raporlanır: bu durdurma bir dolgunun var olduğunu varsayar ve dolgunun kabul edilebilir olup olmadığını sorar; bu nedenle bağlanmamış bir yuva onu ilgilendirmez.
Bu tek koşul altında iki sonuç raporlanır ve ileti bunları son değerinin ne söylediğine göre ayırt eder. Kısıtı karşılamayan bir dolgu, etiketleri eşleşmeyen Feature’ı adlandırır. Hiç okunamayan bir kısıt ise bunun yerine nedeni adlandırır — etiket eşleştiricisinin değerlendiremediği bir ifade —; bu, yuvaya eklenen şeydeki değil, yuvanın kendi bildirimindeki bir hatadır.
Dolgunun etiketlerinin kısıtı karşılamadığı durumda üretilen ileti:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (ek yuvası seçicisi karşılanmadı ("<selector>", "<slot>" yuvasında bildirildi, onu dolduran Feature’ın etiketleri tarafından karşılanmadı, "<feature-type>"). Yuvanın seçicisinin gerektirdiği etiketleri Feature’ın etiketlerine ekleyin veya yuvayı bu etiketleri zaten taşıyan bir Feature ile doldurun.)
ve kısıtın kendisinin değerlendirilemediği durumda:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (ek yuvası seçicisi karşılanmadı ("<selector>", "<slot>" yuvasında bildirildi, değerlendirilemedi: "<why it could not be evaluated>"). Bileşenin katalog varlığındaki yuva bildiriminde seçiciyi düzeltin.)
Bulgu, dolguyu yazan belgedeki dolgunun anahtarında konumlandırılır ve o belgenin yazarına atfedilir: Aggregate’teki bileşenin features: bloğu bir geliştirici hatasıdır; yalnızca Release’in yaptığı bir dolgu — bileşene ait girdisinde veya onu içeren bir sınırda — bir operatör hatasıdır ve Release’in kendi yolunda raporlanır:
[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.
Aggregate’te bileşene yazılan aynı dolgu [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity raporlar.
Bir soketin bildirdiği yuva — bir usesSchema girdisinin featuresSchema alanında — her bağlantının dolgusunu aynı şekilde kendi selector: kısıtına tabi tutar. Bir bağlantının yuvada taşıdığı ek kısıta göre eşleştirilir ve kısıtın kabul etmediği bir dolgu derlemeyi durdurur; ileti yuvanın yanı sıra soketi ve bağlantıyı da adlandırır:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (ek yuvası seçicisi karşılanmadı ("<selector>", "<socket>" soketinin "<slot>" yuvasında bildirildi, "<alias>" bağlantısında dolduruldu, onu dolduran Feature’ın etiketleri tarafından karşılanmadı, "<feature-type>"). Yuvanın seçicisinin gerektirdiği etiketleri Feature’ın etiketlerine ekleyin veya yuvayı bu etiketleri zaten taşıyan bir Feature ile doldurun.)
Bulgu, dolguyu yazan belgede o bağlantının features: alanı altındaki ekin anahtarında konumlandırılır: Aggregate’in bağlantı girdisi veya yalnızca Release’in yaptığı bir dolgu için Release’in kenar başına girdisi.
Dilbilgisinin okuyamadığı bir yuva seçicisi de yuvayı herhangi bir şey doldurmadan önce reddedilir.aggrega validate, tüm katalog ya da tek bir Component veya Feature üzerinde çalıştırıldığında, varlığın kendi belgesinin bildirdiği her yuva seçicisini — bir Component’in kendi yuvalarını, soketlerinin bildirdiği yuvaları ve bir Feature’ın yuvalarını — okur ve dilbilgisinin okuyamadığı bir seçiciyi, yuvayı bir şey doldursun ya da doldurmasın, bu aynı koşul altında reddeder. İleti, yukarıdaki “değerlendirilemedi” biçimidir; bir soketin bildirdiği bir yuva, soketi de ekler:
attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (ek yuvası seçicisi karşılanmadı; bir soketin yuvasında bildirildi ve değerlendirilemedi. Seçiciyi, bileşenin katalog varlığında soketin featuresSchema alanındaki yuva bildiriminde düzeltin.)
Bir Feature’ın yuvasında ise çözüm, bunun yerine Feature’ın katalog varlığını adlandırır. Yuvayı hiçbir şey doldurmamıştır; bu nedenle hata katalog varlığınındır: CATALOG_ERROR olarak kaydedilir ve varlığın dosyasını adlandırır.
Nasıl düzeltilir: kısıtı karşılamayan bir dolgu için etiketleri kısıtı karşılayan bir Feature ekleyin — iletideki seçici hangi etiketlerin istendiğini söyler — veya yuvayı bildiren Component’teki yuvanın selector: kısıtını genişletin. İleti kısıtın değerlendirilemediğini söylüyorsa hata seçici ifadesindedir: bunu Component’in yuva bildiriminde veya soketinkinde düzeltin.
An attachment written under another name fits a slot its component leaves empty (Başka bir ad altında yazılan bir ek, bileşeninin boş bıraktığı bir yuvaya uyuyor)
Bir Component’in kendi ek yüzeyi açıktır: hiçbir yuvanın bildirmediği bir ad altındaki ek serbest bir ektir ve geçerlidir. Bu yüzeydeki tek bir biçim derlemeyi durdurur, çünkü bu, bir yuva için tasarlanan dolgunun yanlış ad altında yazıldığında aldığı biçimdir. Bir ek için aşağıdakilerin tümü geçerli olduğunda derleme durur:
ek bileşenin kendisine yazılmıştır — Aggregate’teki bileşenin kendi features: bloğunda veya Release’in o tek bileşene ait girdisinde;
adı, bileşenin türünün bildirdiği bir yuva değildir;
Feature’ının etiketleri, türün bildirdiği bir yuvanın selector: kısıtını karşılar;
tüm kapsamlar birleştirildikten sonra bileşende o yuvayı hiçbir şey bağlamaz.
Kendi hâline bırakılırsa böyle bir ek serbest bir ek olur, tasarlandığı yuva ise boş kalır — ve boş bırakılan isteğe bağlı bir yuva başarıyla derlenir ve hiçbir şey teslim etmez. Kural yalnızca kimlik bilgileri için değil, her Feature için geçerlidir.
Yüzeydeki diğer her şey serbest kalır. Feature’ı bildirilmiş hiçbir yuvaya uymayan bir ek derlenir; uyduğu başka hiçbir yuva boş bırakılmadığı sürece, bir şeyin zaten bağladığı bir yuvanın yanındaki fazladan bir ek de derlenir. Bileşenin bir alt sistemden veya bir Release sınırından devraldığı bir ek hiçbir zaman değerlendirilmez; bu nedenle paylaşılan biçim — birkaç bileşenin bulunduğu bir kapsamda bir kez eklenen ve yuvayı hiçbir bileşenin doldurmadığı tek bir kimlik bilgisi — derlenir. selector: bildirmeyen bir yuva hangi Feature için olduğu hakkında hiçbir şey söylemez; bu nedenle hiçbir ek bu şekilde ona tabi tutulmaz. Bir bağlantının taşıdığı ek de burada değerlendirilmez: bir soketin yuvaları kapalı bir kümedir ve bir bağlantıdaki başka herhangi bir ad “A connection carries an attachment under a name its socket declares no slot for (Bir bağlantı, soketinin yuva bildirmediği bir ad altında bir ek taşıyor)” altında derlemeyi durdurur.
Üretilen ileti. Önce koşulun cümlesi, ardından ekin yazıldığı ad, bileşen, eklediği Feature ve uyduğu boş yuva — sonra da ne yapılması gerektiği gelir:
attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (hiçbir yuvanın bildirmediği bir ad altında yazılan ek, bileşeninin boş bıraktığı bir yuvaya uyuyor ("<attachment>", "<component>" bileşeninde, "<feature-type>" Feature’ını ekliyor, boş "<slot>" yuvasına uyuyor). Yuvayı doldurmak için "<slot>" olarak ekleyin.)
Feature birden fazla boş yuvaya uyduğunda ileti her birini bileşenin türünün bildirdiği sırayla adlandırır ve seçimi size bırakır:
attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (hiçbir yuvanın bildirmediği bir ad altında yazılan ek, bileşeninin boş bıraktığı bir yuvaya uyuyor ("<attachment>", "<component>" bileşeninde, "<feature-type>" Feature’ını ekliyor, boş "<slot>" yuvasına ve boş "<another-slot>" yuvasına uyuyor). Eki, doldurması amaçlanan yuvanın adı altında ekleyin.)
Bulgu, eki yazan belgedeki ekin anahtarında konumlandırılır ve o belgenin yazarına atfedilir. Aggregate’teki bileşenin kendi features: bloğundaki bir ek .spec.components.<component>.features.<attachment> konumunda bir geliştirici hatası olarak raporlanır; yalnızca Release’in bileşene ait girdisinde yazdığı bir ek orada — bileşeni adlandıran sınırın altında, .spec.boundaries.<boundary>.components.<component>.features.<attachment> — bir operatör hatası olarak raporlanır:
[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.
Boş yuvanın kendisi, gerekli olduğu durumda ayrı bir bulgudur ve Aggregate’teki bileşende “Required attachment slot not bound (Gerekli ek yuvası bağlanmamış)” altında raporlanır.
Bunun yakın eşleşme önerisinden farkı. “An attachment name is one edit from a declared slot (Bir ek adı, bildirilmiş bir yuvaya bir düzenleme uzaklıkta)” altındaki öneri bir adın nasıl yazıldığıyla ilgilidir: ekin Feature’ının selector: kısıtını karşılamadığı bir yuvaya bir düzenleme uzaklıktaki bir ad; bu derlenir ve bir uyarı raporlar. Bu durdurma ise ad ne olursa olsun Feature’ın neye uyduğuyla ilgilidir: ad herhangi bir şey olabilir ve uyduğu yuva boş bırakılmış olmalıdır. Bir ad bir yuvaya bir düzenleme uzaklıktaysa ve Feature’ı o yuvaya gerçekten uyuyorsa öneri üretilmez; yuva boş bırakılırsa raporlanan tek bulgu bu durdurmadır.
Nasıl düzeltilir: eki yuvanın adı altında ekleyin; böylece yuvayı doldurur — ileti yuvayı veya birden fazla aday varsa her birini adlandırır. Gerçekten ayrı bir ekse yuvayı da doldurun, çünkü fazladan bir ek, uyduğu her yuva bağlandığında serbesttir; ya da birkaç bileşene ulaşması amaçlanıyorsa onu bu bileşenlerin bulunduğu alt sistemde veya Release sınırında ekleyin. Feature o yuvayı hiçbir zaman doldurmamalıysa yuvayı bildiren Component’teki yuvanın selector: kısıtını daraltın.
An attachment delivers a key another inject source already claimed (Bir ek, başka bir inject kaynağının zaten sahiplendiği bir anahtarı iletiyor)
Üç yazım yüzeyi, bir inject: bloğu aracılığıyla tek bir bileşenin enjeksiyon hattına iletim yapar: bileşenin kendi inject: bloğu, bağımlılık bloğundaki girdilerin inject: blokları ve bileşene eklenen her Feature’ın üzerindeki blok. Bunlar her iletim mekanizması için anahtarlı tek bir alanı paylaşır; bu nedenle ikisinin sahiplendiği bir anahtar, hangi değerin ulaşacağı konusunda belirsizdir ve derleme, bir yüzeyin diğerini sessizce geçersiz kılmasına izin vermek yerine durur. Eklenmiş bir Feature ikinci bir yolla da iletim yapabilir: FeatureRecipe’inin injectMapping alanı aracılığıyla. Bu yol, tüm bloklar iletimini tamamladıktan sonra aynı alana ulaşır ve aşağıda “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Eklenmiş iki Features tek bir anahtarı iletiyor, sonraki FeatureRecipe’inin injectMapping’i aracılığıyla)” altında raporlanır.
Bu koşul, o alanın ek bloğu tarafıdır. Bir ekin kendi inject: bloğu, daha önceki bir iletimin zaten tuttuğu bir anahtarı sahiplendiğinde raporlanır. Yukarıdaki “Duplicate delivery key across inject sources (Inject kaynakları arasında yinelenen iletim anahtarı)” girdisi, aynı kuralın geliştirici tarafından yazılan taraftan okunmuş hâlidir ve ikisi birlikte her bloğun sahiplenmesini kapsar.
Kimin çakıştığına sıra karar verir. Bir anahtar altındaki ilk sahiplenme o anahtarı tutar ve raporlanan, sonraki sahiplenmelerdir. Bu nedenle anahtarı alınmış bir eke bu bildirilir; ilk sahiplenen eke ise hiçbir şeyi geçersiz kılmamış sonraki bir sahiplenme bildirilmez. Hiçbir şey iletmeyen bir sahiplenme anahtarı serbest bırakır ve bunların hiçbirine katılmaz.
Bulgu, ekin bileşenin bloğu içindeki kendi girdisinde konumlandırılır; düzenlenecek konum burasıdır. İleti, anahtarı ve anahtarın içinde bulunduğu anahtarlı alanın ait olduğu mekanizmayı adlandırır. Çakışan her anahtar ayrı ayrı raporlanır; bu nedenle iki anahtarı yineleyen bir ek size ikisini de bildirir.
Üretilen ileti:
duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (attachment-inject ile başka bir inject kaynağı arasında yinelenen iletim anahtarı ("<key>", mekanizma "<mechanism>"))
Nasıl düzeltilir: iki taraftan hiçbiri suçlu değildir ve ikisini de değiştirebilirsiniz. Anahtarı denetiminizdeki tarafta yeniden adlandırın (çoğunlukla bileşenin kendi inject: girdisi, çünkü Feature’ın eşlemesi bir katalog belgesinde yazılıdır) ya da iki iletimden birini kaldırın. Ek değeri gerçekten sağlamak üzere tasarlandıysa, ekin sahiplenmesini değil geliştirici tarafından yazılan sahiplenmeyi kaldırın. Bir Feature’ın FeatureRecipe injectMapping alanının bir anahtar yazmasının farklı bir yol olduğunu ve burada raporlanmadığını unutmayın: bileşenin kendi inject: bloğunun veya bağlantılarından birinin ilettiği bir anahtarı yeniden yazmak araya girmedir ve hiç raporlanmaz; eklenmiş başka bir Feature’ın ilettiği bir anahtarı yazmak ise aşağıdaki girdi altında raporlanır.
Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Eklenmiş iki Feature tek bir anahtarı iletiyor, sonraki FeatureRecipe’inin injectMapping’i aracılığıyla)
Eklenmiş bir Feature, bileşeninin enjeksiyon hattına iki yolla iletim yapar: ekin üzerine yazılan inject: bloğu ve çıktısı iletim anahtarını adlandıran FeatureRecipe’inin injectMapping alanı. Bu anahtar çoğunlukla ekin taşıdığı bir değerden, örneğin bir kimlik bilgisi için seçilen ortam değişkeninden gelir. Eklenmiş iki Features tek bir iletim mekanizması altında tek bir anahtara ulaştığında ve ikisinden sonraki oraya eşlemesi aracılığıyla ulaştığında derleme durur. Çalışmaya bırakılsaydı bileşen, en son hangi değer yazıldıysa onu okurdu; böylece bir kimlik bilgisi, çıktıda bunu belirten hiçbir şey olmadan başka birinin yerine sunulabilirdi.
Bu, nereye eklenmiş olursa olsun eklenmiş her Feature’ı kapsar: bileşenin kendi features: bloğu, bir alt sistem, bir Release sınırı veya bileşen girdisi, bir ek açıklamanın genişletilmesi ve bir bağlantının features: girdisi. İki iletimden önceki, diğer Feature’ın eşlemesi veya kendi inject: bloğu olabilir; derleme her iki eşleşmeyi de bu tek koşul altında raporlar.
Kimin çakıştığına sıra karar verir. Her inject: bloğu, herhangi bir eşleme işlenmeden önce iletim yapar ve eşlemeler sabit bir sırayla işlenir (derleme hattında açıklanan, inject eşlemesinin bir bileşenin eklenmiş Features’ını dolaştığı sıra); böylece bir anahtar altındaki ilk iletim o anahtarı tutar ve raporlanan, sonraki Feature’dır. Yalnızca varlık belirleyicidir: değerler karşılaştırılmaz, bu nedenle tek bir anahtar altında aynı değeri ileten iki Feature yine de raporlanır. Bir eşlemenin çıktısının hiç taşımadığı bir anahtar iletim değildir; boş bir değerle taşıdığı bir anahtar ise iletimdir, çünkü boş değer orada bulunanın yerini alır. İki farklı iletim mekanizması altındaki tek bir anahtar iki anahtardır, çakışma değildir.
Raporlanmayanlar. Bir FeatureRecipe’in injectMapping alanının, bileşenin kendi inject: bloğunun veya bağlantılarının inject: bloklarından birinin ilettiği bir anahtarı yeniden yazması araya girmedir (bir ana makineyi niteleyen bir yönlendirme Feature’ı, bir yukarı akışı yeniden yönlendiren bir koruma) ve eşlemenin değeri o tek girdinin yerini alır. Bir Feature’ın eşlemesinin, kendi inject: bloğunun ilettiği bir anahtarı yeniden yazması, o Feature’ın kendi iletimini dönüştürmesidir ve o da raporlanmaz.
Bulgu, sonraki Feature’ın kendi girdisinde konumlandırılır: bileşenin features: bloğunun içinde ya da bir bağlantının taşıdığı bir Feature için, onu yazan belgede o bağlantının altındaki girdisinde, örneğin Aggregate’te .spec.components.<component>.uses.<socket>.<alias>.features.<slot>. İleti; anahtarı, iletim mekanizmasını ve her iki Feature’ı bileşen üzerinde taşıdıkları adlarla adlandırır. Bir bağlantının taşıdığı Feature, bağlantının takma adı ve doldurduğu yuvanın bir noktayla birleştirilmesiyle adlandırılır. Çakışan her anahtar ayrı ayrı raporlanır.
Üretilen ileti:
duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (iki ek arasında yinelenen teslim anahtarı: bir ekin FeatureRecipe’i, başka bir ekin zaten teslim ettiği bir teslim anahtarını yazar. İki ekten birine kendine ait bir anahtar verin ya da bir ek daha az ekleyin: bu ekin teslim ettiği anahtarı, ekin kendi values ve infra değerlerini okuyabilen FeatureRecipe’i seçer; diğerininki de aynı şekilde ya da bir inject bloğu üzerinden teslim ettiyse kendi inject bloğu tarafından seçilir. Bir Release, bir ekin infra değerlerini ayarlar, values değerlerini ise asla ayarlamaz; bu nedenle bir anahtar bir değerle seçiliyorsa, o eki değerle birlikte Aggregate’te ekleyin ve geri kalanını Release’ten vermeye devam edin.)
Nasıl düzeltilir: iki Feature’dan birine kendine ait bir anahtar verin (bir kimlik bilgisi Feature’ı için bu genellikle değerlerinin adlandırdığı anahtardır) ya da iki ekten birini kaldırın. Her ikisi de tek bir değişkeni sağlamak üzere tasarlandıysa, bileşenin hangisini okuması gerektiğine karar verin ve yalnızca onu ekleyin. Bir Release’in kendi başına eklediği iki kimlik bilgisi de Feature’larının varsayılan olarak adlandırdığı anahtar altında gelir, çünkü bir Release bir ekin values alanını yazamaz: bunlardan birini, anahtarını adlandıran değerle birlikte Aggregate’te ekleyin ve kaynağını aynı girdide Release’ten verin.
A component declares an inject mechanism the attached Feature maps nothing to (Bir bileşen, eklenmiş Feature’ın hiçbir şey eşlemediği bir inject mekanizması bildiriyor)
Bir Component’in spec.inject izin listesi standart olanların ötesinde teslim mekanizmaları adlandırabilir: bileşenin kendi altyapısının anladığı ve içine teslim yapan her şeyin bir değer üretmesi gereken bir mekanizma. Böyle bir bileşene bir Feature eklendiğinde, ürettiği her değerin hangi mekanizma altında teslim edileceğini FeatureRecipe’in injectMapping’i belirtir. Bileşenin bildirdiği ama eşlemenin hiçbir anahtar üretmediği bir mekanizma, sessizce hiç gerçekleşmeyecek bir teslimattır; bu yüzden derleme bunun yerine durur.
Mekanizmalar hakkında hiçbir şey söylemeyen bir eşleme, hiçbirini söylemeyen bir eşleme değildir. Eşlemesi düz bir teslimat sözlüğü olarak işlenen bir FeatureRecipe, mekanizmalar hakkında hiçbir iddiada bulunmaz (ortam değişkeni teslimatları üreten bir Feature için olağan yazım budur); değerlendirilecek eşlemesi olmayan bir FeatureRecipe’i bağlayan bir ek de öyle. Hiçbiri burada bildirilmez; bu koşul yalnızca mekanizmaları adlandıran ve bileşenin bildirdiği birini atlayan bir eşlemeyle ilgilidir.
Eşlenmemiş her mekanizma ayrı bir bulgudur; dolayısıyla bir ekin hiçbirini eşlemediği iki mekanizma bildiren bir bileşen size ikisini de bildirir. Bulgu, kendi dosyanızdaki ekin girdisinde konumlanır ve FeatureRecipe’i de adlandırır; çünkü eşlemenin yazıldığı belge odur ve tamamen başka bir yerdedir.
Üretilen ileti:
custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (özel inject mekanizmasının injectMapping çıktısında eşleşen bir anahtarı yok; mekanizmanın anahtarını Recipe injectMapping’ine ekleyin)
Nasıl düzeltilir: ileti her iki yarıyı da adlandırır. Feature’ın mekanizma için bir değer üretmesi amacıyla mekanizmanın anahtarını FeatureRecipe’in injectMapping’ine ekleyin ya da altında hiçbir şeyin teslim etmesi beklenmiyorsa mekanizmayı Component’in spec.inject izin listesinden çıkarın. FeatureRecipe başka birinin kataloğuna aitse, eşlemesi mekanizmayı kapsayan bir Feature eklemek üçüncü yanıttır.
An attached Feature’s injectMapping output cannot be read (Eklenmiş bir Feature’ın injectMapping çıktısı okunamıyor)
Bir FeatureRecipe’nin injectMapping alanı bir şablondur ve ürettiği şey YAML olarak okunur: teslim mekanizmasına göre anahtarlanmış bir sözlük — env, file, arg ya da bileşenin kendine ait bir mekanizması — veya ortam teslimlerinden oluşan düz bir sözlük. Çıktı bunlardan hiçbiri olarak okunamadığında anahtarlarının hiçbiri teslim edilemez; bu nedenle derleme, bileşeni eklenmiş Feature hiçbir şey teslim etmemiş gibi işlemek yerine durur. En çok önem taşıyan durum bir kimlik bilgisidir: hiç almadığı bir parolayı bekleyen bir bileşen aksi halde parolasız çalışabilir ve çıktıdaki hiçbir şey bunu söylemezdi.
Olağan neden, şablonun tırnak içine olduğu gibi yazdığı bir değerdir. İçindeki bir çift tırnak, tırnaklı skaleri erken sonlandırır ve bir ters eğik çizgi YAML’ın tanımayabileceği bir kaçış dizisi başlatır; bu nedenle değerlerin çoğu için doğru işlenen bir eşleme, böyle bir karakter içeren değerde — çoğu zaman bir parolada — bozulur. Boş olan ya da hiçbir şey teslim etmeyen bir sözlük olarak ayrıştırılan bir çıktı bu koşul değildir: hiçbir şey teslim etmez ve söylediği de budur.
Mesajın üstündeki çerçeve, işlenen bileşeni, ardından eklemeyi bileşen üzerinde taşıdığı adla ve eşlemenin yazıldığı FeatureRecipe’yi feature "<attachment>" (recipe "<featurerecipe>") injectMapping output biçiminde adlandırır. Mesajın altında çıktının neden okunamadığı yer alır: satır ve YAML’ın orada bulduğu şey, örneğin yaml: line 2: found unknown escape character. Şablon, bir yazarın hassas olarak bildirdiği bir değeri okuduğunda ve neden o değerin içeriğine bağlı olduğunda, neden gizlenir ve yerine bunu belirten bir cümle konur; böylece durdurma, çıktıyı bozan değeri hiçbir zaman alıntılamaz. Eşleme FeatureRecipe’nin yazarı tarafından yazıldığı için derleme bu durdurmayı bir CATALOG_ERROR etiketi altında bildirir.
Üretilen ileti:
FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (FeatureRecipe injectMapping çıktısı bir teslimler sözlüğü olarak okunamadı)
Nasıl düzeltilir: FeatureRecipe’nin injectMapping alanında her değeri toJson üzerinden yazın ({{ .values.key }}: {{ .values.origin | toJson }}); bu yöntem, değeri hangi karakterleri içerirse içersin YAML’ın tam olarak geri okuduğu bir JSON dizesi olarak yazar. FeatureRecipe başka birinin kataloğuna aitse, eşleme düzeltilene kadar değer, çift tırnak veya ters eğik çizgi içermeyecek şekilde de değiştirilebilir.
An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Eklenmiş bir Feature’ın injectMapping çıktısı, hiçbir şeyin teslim etmediği bir anahtar altına teslimler yazıyor)
Bir FeatureRecipe’nin injectMapping çıktısı, üst düzey anahtarlarına göre bileşenin enjeksiyon hattıyla birleştirilir. env, file ve arg bu mekanizmalar olarak teslim edilir; diğer her anahtar ise o ad altında kendine ait bir mekanizma olarak teslim edilir ve bileşenin Recipe’si bunu .context.inject.<name> konumunda okur. all görünümü farklıdır: birleştirmeden sonra mekanizmalardan oluşturulur, hiçbir zaman bir çıktıdan birleştirilmez; bu nedenle bir eşlemenin all: altına yazdığı değerler hiçbir yere ulaşmaz. Çıktı yine de sorunsuz okunur; bu nedenle bu durdurma olmasaydı, bu değerleri isteğe bağlı olarak okuyan bir derleme onlar eksikken başarılı olurdu: oraya yazılan bir kimlik bilgisi bileşene hiçbir zaman ulaşmaz ve derlemedeki hiçbir şey onu kaybeden eşlemeyi adlandırmaz.
Bu koşul, all: tek başına ya da başka mekanizmaların yanında en az bir girdi taşıdığı her yerde geçerlidir; aynı çıktıdaki diğer mekanizmalar sorun değildir ve boş yazılmış bir all: hiçbir şey kaybetmez ve bildirilmez. Tek bir değerle all adlı bir anahtar taşıyan düz bir sözlük, bu koşul değil, all adlı bir ortam teslimidir.
Bulgu, sizin kendi dosyanızdaki ekleme girdisinde konumlandırılır ve anahtarı ve eşlemenin yazıldığı FeatureRecipe’yi — çünkü değiştirilecek belge odur ve bambaşka bir yerdedir — bir çıktının taşıyabileceği anahtarlarla birlikte adlandırır. Bu tür her anahtar ayrı bir bulgudur. Derleme bunu bir CATALOG_ERROR etiketi altında bildirir.
Üretilen ileti:
FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (FeatureRecipe injectMapping çıktısı, ana bileşenin hiçbir teslim mekanizmasının okumadığı bir anahtar yazıyor)
Nasıl düzeltilir: FeatureRecipe’nin injectMapping alanında girdileri all: altından, bileşenin onları okuduğu mekanizmaya taşıyın — genellikle env: ya da bileşenin Recipe’sinin okuduğu mekanizmanın adı. FeatureRecipe başka birinin kataloğuna aitse, bunun yerine eşlemesi değeri teslim eden bir Feature ekleyin.
Çıktı işlenirken
Her sözleşme doğrulandıktan sonra derleyici, Component değerlerindeki, FeatureRecipe injectMapping bloklarındaki ve Recipe ile FeatureRecipe kaynaklarındaki Go şablonlarını değerlendirir, ardından sonucu işleyiciye verir.
provides: şablonu kendi kendine yeterli olmayan bir köke başvuruyor
Bir Recipe’in provides: şablonu, kendi kendine yeterli kümenin dışındaki bir köke başvuruyor. provides bloğu, provides değerlendirmesi sırasında, inject hattı doldurulmadan ve düğümler arası kenarlar dolaşılmadan önce değerlendirilir; bu nedenle yalnızca kendi düğümüne ait verilere başvurabilir: .context.instance_id, düğümün provider’ı bir ad bildirdiğinde .context.rendered_name, .values, .infra, düğümün çözümlenmiş .locals değerleri ve statik dizgeler. Denetim pozitif bir izin listesidir, dolayısıyla başka her kök durdurur: .context.inject ve .context.uses (düğümler arası), .context.annotations.*, .context.labels, .context.metadata ve .metadata.* (provides yüzeyinin sunmadığı, yerleşime ya da dağıtıma bağlı veriler) ve .attachment_name (temel bir Recipe’in provides geçişi hiçbir eklemeyi çözümlemez). Bunlardan birine başvurmak, sessizce boş bir değer işlemek yerine açıkça durdurur.
.locals yüzeydedir: bir düğümün locals değerleri aynı aşamanın başlangıç bölümünde, provides’tan önce çözümlenir; bu nedenle bir provides şablonu bunları okur ve çözümlenmiş değerleri alır.
Üretilen ileti:
provides block references a root outside the self-contained set ("<expression>") (provides bloğu kendi kendine yeterli kümenin dışındaki bir köke başvuruyor ("<expression>"))
Durdurma, girdiyi bildiren Recipe’te ve onun içindeki yazılmış anahtarda (.spec.provides.<name>) konumlanır; böylece Recipe’i bağlayan bileşeni değil, düzenlenecek bloğu adlandırır. Yüzeyin dışına uzanan her girdi aynı derlemede bildirilir; birden fazla girdi bunu yaptığında bulgular provides entries that reach outside the data they are evaluated against başlığı altında gruplanır.
Nasıl düzeltilir: şablonu yalnızca Recipe’nin kendi sütunlarından veri alacak şekilde yeniden düzenleyin. Değer başka bir düğümün çıktısına bağlıysa bu bağımlılık hedefin provides bloğuna değil, çağıranın uses[].inject bloğuna aittir. Değer hesaplanıyorsa ifadeyi bir locals: girdisine koyun ve onu provides içinden okuyun; böylece ifade tek bir yerde durur. Namespace’ler arası bir host oluşturmak için dağıtım namespace’ine (ya da başka yerleşim verilerine) erişmeye çalışıyorsanız, burada yalın host’u yayımlayın ve onu tüketici tarafında bir yönlendirme özelliğiyle niteleyin; üreticinin provides bloğu nereye dağıtıldığına bağlı olmamalıdır.
Bir FeatureRecipe’in provides: bloğu da aynı locals kuralını izler: kendi locals: değerleri provides: bloğundan önce çözümlenir, dolayısıyla bir FeatureRecipe provides girdisi de .locals okur.
locals: girdisi aynı blokta daha sonra tanımlanan bir kardeşe başvuruyor
Bir locals: bloğu, girdilerinin yazıldığı sırayla çözümlenir ve bir girdi yalnızca kendisinin üstünde tanımlanan bir kardeşi okur. Bloğun daha sonra tanımladığı bir girdiye doğrudan .locals.<key> başvurusu durdurur: derleyici, başvurunun çözümlenmesi için bloğu asla sıralamaz ya da yeniden düzenlemez, çünkü o durumda üretilen çıktı yazılmış olanı değil bir çıkarımı izlemiş olurdu. Durdurma olmasaydı başvuru, eksik anahtar ilkesi üzerinden boş bir dizgeye çözümlenirdi; böylece türetilmiş bir ana makine adı ya da gizli bilgi adı, oluşturulduğu parçayı sessizce kaybederdi.
Bu hatayı bir locals: bloğunun her iki çözümlemesi de belirler ve bunlardan biri sabitlemedir. Bir blok iki farklı amaçla çözümlenir: Recipe’nin kendi şablonları bir artifact render edilirken onu okuyabilsin diye ve yapılandırılmış bir source: koordinatı çözümlenip adlandırdığı artifact sabitlenebilsin diye. Hata, bildirilen anahtar sırasından ve yazılan metinden belirlenir; ihtiyaç duyduğu her şey bunlardır. Bu nedenle her iki çözümleme de ona ulaşır ve aynı durumu bildirir: aggrega pull ve lockfile’ı dolduran bir derleme, bloğu tam olarak bir render işleminin yaptığı gibi reddeder. Yazarken bilinmesi gereken iki sonuç vardır. Bir koordinat çözümlenirken bloğun tamamı okunur; bu yüzden sırası bozuk bir girdi, her alanı literal olan ve hiçbir local okumayan bir source: durumunda bile derlemeyi durdurur. Ayrıca source: değeri düz bir dize olan ya da hiç source: bildirmeyen bir Recipe hiçbir koordinat çözümlemez; bu nedenle o Recipe’de hata, çıktı render edilirken bildirilir.
Bir bileşen Recipe’inin kendi locals: bloğundaki bir girdi için üretilen ileti. Recipe içindeki yazılmış anahtarda konumlanır ve hatalı her girdi tek bir derlemede bildirilir; birden fazlası olduğunda bulgular locals entries that read a sibling they cannot başlığı altında gruplanır:
locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (locals girdisi aynı blokta daha sonra tanımlanan bir kardeşe başvuruyor (<expression>, adlandırdığı anahtar <referenced>, bu noktada çözümlenmiş olanlar <the locals available here>, <component> bileşeni üzerinden ulaşıldı). locals bloğunda <referenced> öğesini <key> öğesinin üstünde tanımlayın)
Kendine başvuru da aynı durumdur (anahtar bildirilmiştir ve çözümlenmemiştir) ve hiçbir yeniden sıralama bunu düzeltmez; bu nedenle ileti, taşıma talimatı yerine bunu belirtir:
locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (locals girdisi aynı blokta daha sonra tanımlanan bir kardeşe başvuruyor (<expression>, adlandırdığı anahtar <key>, bu noktada çözümlenmiş olanlar <the locals available here>, <component> bileşeni üzerinden ulaşıldı). bir locals girdisi kendini okuyamaz; değeri doğrudan .values ve .infra üzerinden hesaplayın)
Bir Recipe’i birçok bileşen bağlar; bu yüzden paylaşılan bir bloktaki tek bir hata, onu bağlayan her bileşen için bir kez bildirilir ve bu bulguları birbirinden ayıran reached through the component ifadesidir. Bulgular aynı konumu paylaşır, çünkü hepsi aynı belgedeki aynı yazılmış girdiyle ilgilidir; konum nerede düzenleme yapılacağını, bileşen adı ise her bulgunun bileşenlerinizden hangisini temsil ettiğini gösterir. Bulgular tek bir bulguda birleştirilmez, çünkü birleştirmek, bir şeyin yanlış olduğunu hangi bileşenlere ulaştığını söylemeden söylemek olurdu; oysa üzerinde işlem yapmanız gereken kısım budur.
Bir Feature’ın recipe’sinin bildirdiği bir locals: bloğundaki aynı hata da aynı şekilde bildirilir: o recipe içindeki yazılmış anahtarda konumlanır, eklemenin bulunduğu bileşenle adlandırılır ve aynı hatayı taşıyan kardeş girdilerle gruplanır. Recipe birden fazla yere eklendiğinde hata her biri için bir kez bildirilir; her ekleme o bloğu bağımsız olarak bağlar, dolayısıyla her biri tek bir hatanın tekrarı değil, kendi başına bir oluşumdur.
Bu biçim bir kendine başvuruyu bildirdiğinde, konum yan tümcesi daha sonraki bir girdiyi değil başvuran girdinin kendisini adlandırır, çünkü anahtar oradadır.
Nasıl düzeltilir: başvurulan girdiyi, onu okuyan girdinin üstüne taşıyın. Bir girdinin başka bir girdiyi okuduğu her yerde bir locals: bloğunu yeniden sıralamak davranışsal bir değişikliktir; bu nedenle düzeltme tam olarak iletinin adlandırdığı yeniden sıralamadır. Kendine başvuru (kendi anahtarını adlandıran bir girdi) yeniden sıralamayla düzeltilemez; bunun yerine değeri doğrudan .values ve .infra üzerinden hesaplayın; ileti de taşıma talimatı yerine bunu belirtir.
locals: anahtarı mevcut değil
Bir şablon, locals: bloğunun hiç bildirmediği bir anahtar için .locals.<key> okur: bir yazım hatası ya da yeniden adlandırılmış veya kaldırılmış bir anahtar. Bu sütunu okuyan her yüzey bu durdurmayı tetikler: bir locals: girdisi, bir provides: şablonu, bir Recipe source: şablonu ve koordinatın adlandırdığı yapıtı sabitlemek için bloğun tamamını okuyan yapılandırılmış bir source: koordinatının çözümlenmesi. locals sütunu açık, anahtarlı bir eşlemedir; bu nedenle altındaki bilinmeyen bir anahtar kök denetiminden geçer ve aksi hâlde boş bir dizeye çözümlenirdi. Bu boş değerin üretilen bir yapıta ulaşmasını engelleyen şey bu durdurmadır.
Sorunlu başvuru bir provides: şablonunda yer aldığında üretilen ileti:
template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (şablon, locals bloğunun bildirmediği bir anahtara başvuruyor (Recipe <recipe> provides[<key>], <expression> ifadesine başvuruyor, locals bloğu <referenced> bildirmiyor, <the keys it does declare> bildiriyor). anahtar adını düzeltin)
Başvuru bir locals: girdisinin kendisinde yer aldığında üretilen ileti. İleti, yukarıdaki sıralama durdurmasının belirttiği nedenle bloğun bağlandığı bileşeni taşır: paylaşılan bir blok, onu bağlayan her bileşen için bir kez bildirilir ve bu bulguları birbirinden ayıran şey budur:
template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (şablon, locals bloğunun bildirmediği bir anahtara başvuruyor ("<expression>", eksik anahtar "<referenced>", blok "<the keys it does declare>" bildiriyor, "<component>" bileşeni üzerinden ulaşıldı). anahtar adını düzeltin)
Nasıl düzeltilir: anahtar adını bloğun bildirdiği anahtarlardan birine düzeltin; ileti bunları listeler. Bu durdurma yukarıdaki sıralama durdurmasından ayrıdır, çünkü çözümleri farklıdır: hiçbir yeniden sıralama, var olmayan bir anahtarın çözümlenmesini sağlamaz.
Denetim, bir başvurunun tuş vuruşlarını değil çözümlendiği yolu okur; bu nedenle bloğa verilen bir takma ad izlenir: bir with .locals gövdesinin yeniden bağladığı nokta üzerinden ya da .locals bloğuna bağlanmış bir değişken üzerinden ulaşılan bir anahtar, doğrudan yazımla tam olarak aynı koşullarda denetlenir ve aynı şekilde durdurur; parantez içindeki bloktan okunan bir anahtar da öyledir ({{ (.locals).nope }} ya da {{ ($.locals).nope }}), çünkü parantezler bloğun kendisini verir, fazlasını değil. Bir yazım denetimin dışında kalır: sonucunu şablon metninin adlandıramadığı bir çağrı üzerinden ulaşılan bir anahtar ({{ index .locals "nope" }} ya da {{ (default dict .locals).nope }}), çünkü böyle bir çağrının ne döndüreceği yazılana göre değil şablon çalıştığında belirlenir. Böyle bir çağrının sonucundan alan olarak okunan eksik bir anahtar ((default dict .locals).nope biçimi) durdurmaz ve şablon motorunun yer tutucu metni olan <no value> metnini işler. index üzerinden ulaşılan eksik bir anahtar durdurur, ancak bu denetim olarak değil, aşağıdaki “A template indexes a map with a key the map does not hold (Bir şablon, bir eşlemeyi eşlemenin içermediği bir anahtarla dizinliyor)” olarak: index, eşlemenin içermediği her eşleme anahtarında durdurur. Bu nedenle index, adı kendisi hesaplanan bir anahtara ulaşmanın yolu olmaya devam eder ve bloğun bildirmediği hesaplanmış bir ad yine de anahtarıyla bildirilir.
Template references a root the render context does not define (Şablon, render bağlamının tanımlamadığı bir köke başvuruyor)
Bir şablon, render bağlamının tanımlamadığı bir üst düzey köke — baştaki noktadan sonraki ilk yol bölümüne — başvurur: {{ .valeus.port }} gibi bir yazım hatası ya da yazılmakta olan yüzeyde bulunmayan bir kök. Denetim, kök adları üzerinde pozitif bir izin listesidir ve kabul edilen küme, yanında ayrı bir liste olarak tutulmak yerine render bağlamının kendi biçiminden türetilir; böylece derlemenin reddettiği küme ile bağlamın gerçekte sunduğu küme birbirinden ayrışamaz. Tanılama, sorunlu başvuruyu adlandırır ve o bağlamın tanımladığı kökleri listeler.
Bu durdurma, başvuru yalın olsa da bir default, if, with veya range yedeğiyle sarılmış olsa da aynı şekilde tetiklenir ve en önemli olan sarılmış yazımdır: bir sarmalayıcı, tanımlı bir kök altındaki eksik bir anahtar için yedek sağlayabilir, ancak eksik bir kök için asla sağlayamaz; dolayısıyla bu durdurma olmasaydı sarılmış biçim sessizce boş bir değere çözümlenir ve derlemenin başarıyla bitmesine izin verirdi. Tanımlı bir kök altındaki eksik bir anahtar etkilenmez ve aşağıda “Missing template key — asymmetric policy (Eksik şablon anahtarı — asimetrik ilke)” bölümünde açıklanan, değer şablonlarına yönelik missingkey=zero ilkesini izlemeye devam eder; böylece {{ .values.optional_field | default "fallback" }} gibi isteğe bağlı anahtar kalıpları çalışmaya devam eder.
Aynı durdurma, biçimi bildirilmiş bir sütun altında, bir düzey aşağıdaki yanlış yazılmış bir anahtarı da kapsar. Bazı sütunların derleyicinin tanımladığı bir anahtar kümesi vardır: Recipe ve FeatureRecipe render bağlamında .context, .metadata, .inject, .workload ve .boundary, bir yol şablonunda ise .manifest. Bu sütunlardan birinin tanımlamadığı bir anahtara yapılan başvuru — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — tam olarak yanlış bir kökte olduğu gibi durur ve tanılama o sütunun tanımladığı anahtarları listeler. Bir Feature ekinin kendi şablonlarında .inject, env, file, arg ve all yanında, ekin kendi inject: bloğunun adlandırdığı her teslim mekanizması için bir anahtar daha tanımlar: vault_ref: mekanizması yazan bir ek {{ .inject.vault_ref.VAULT_PATH }} konumunda okunur ve tanılama .inject.vault_ref anahtarını .inject sütununun tanımladığı anahtarlar arasında listeler. Ekin adlandırmadığı bir mekanizma, bir if ya da with içinde bile durdurur, çünkü başvuru şablon çalışmadan önce denetlenir. Ekin adlandırmayabileceği bir mekanizmayı okumak için onu koruma altına alın: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Korumalı çift, ek mekanizmayı adlandırsa da adlandırmasa da ve hiç inject: bloğu yazsa da yazmasa da derlenir — bu durumda .inject hiçbir şey tutmaz, bu yüzden with gövdesini atlar; oysa doğrudan .inject üzerinde kullanılan hasKey, eşleme olmayan bir değerde durdururdu. Koruma içinde index, adlandırılan mekanizmanın tutmadığı bir anahtarda yine durdurur. Diğer sütunlar açıktır, çünkü tuttukları şey derleyicinin bildirdiği bir küme değil, anahtarlı verilerdir — bunlar arasında render bağlamında .values, .infra, .locals, .provides, .features ve .steps, bir yol şablonunda ise .parameters ve .parent_boundary bulunur. Açık bir sütun her anahtarı kabul eder. Açık bir sütun altındaki eksik bir anahtar bu durdurma değildir — aşağıda “Missing template key — asymmetric policy (Eksik şablon anahtarı — asimetrik ilke)” bölümünde açıklanan yüzeyin eksik anahtar ilkesini izler; böylece {{ .values.optional_field | default "fallback" }} ve diğer tüm isteğe bağlı anahtar kalıpları çalışmaya devam eder.
Hangi sütunların bildirilmiş, hangilerinin açık olduğu yüzeyin bir özelliğidir, bir şablonun etkileyebileceği bir şey değildir: derleyici bunu sunmak üzere olduğu render bağlamının biçiminden okur. Yazım hatası durdurmasının ve isteğe bağlı anahtarın aynı şablonda render edilebilmesini sağlayan budur.
Bir yüzey, sütununun aksi hâlde tanımladığı bir anahtarı da daraltabilir ve böyle bir rapor yazım hatası değildir. Bir anahtarın taşıdığı yanıt belirli bir yüzeyde anlamsız olduğunda — ya da başka bir düğüme ait olduğunda — o yüzey başvuruyu yanlış şeye çözümlemek yerine reddeder ve tanılama tanımladığı anahtarları listeler. Bilinmesi gereken iki durum vardır, ikisi de {{ .context.rendered_name }}. Bir Feature ekinin kendi şablonlarında anahtar, ana bileşenin adını ana bileşenin kendi sağlayıcısının bildirdiği şekliyle taşır; bu nedenle sağlayıcısı ad bildirmeyen bir ana bileşenin ekinde — tek başına bir yapıt kümesi yerleştiren bir ana bileşen ya da böyle bir ad türetmeyen bir sağlayıcı üzerinden render eden bir ana bileşen — reddedilir ve diğer her ana bileşende kabul edilir. {{ .context.instance_id }} bu yüzeyde kabul edilir ve ekin kendisi için çözümlendiği ana bileşeni adlandırır; böyle bir ana bileşende ana bileşenin kendi kaynaklarının adı da buna göre verilir. Bir Recipe’in locals: girdilerinde anahtar, düğümün sağlayıcısı ne bildirirse bildirsin reddedilir: bir yerel değer bağlamını Recipe’in source: şablonuyla paylaşır ve düğümün kaynak sağlayıp sağlamadığı adın bağlı olduğu şeylerden biridir; bu yüzden ad orada sunulmaz. Tanılama, .context alanının orada tanımladığı tek anahtar olarak .context.instance_id anahtarını listeler; render edilen adı bunun yerine bir provides: girdisinde ya da satır içi bir şablonda okuyun. İki anahtarın her birinin neyi adlandırdığı ve nerede okunabildiği için ../templates/rendered-resource-names.md sayfasına bakın.
Kökün kendisi tanımlı olmadığında yayımlanan ileti:
template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (şablon, render bağlamının tanımlamadığı bir köke başvuruyor (şablon <template-name>, <dotted-path> yoluna başvuruyor; render bağlamı <the roots that context defines> tanımlıyor))
Kök doğru olduğunda ancak bildirilmiş bir sütun altındaki anahtar doğru olmadığında ise:
template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (şablon, render bağlamının tanımlamadığı bir köke başvuruyor (şablon <template-name>, <dotted-path> yoluna başvuruyor; <pillar>, <the keys that pillar defines> tanımlıyor))
Nasıl düzeltilir: başvuruyu tanılamanın listelediklerinden birine düzeltin — raporların çoğu .values, .infra veya .context ya da .context veya .metadata altındaki bir anahtarın yazım hatasıdır. Yedek sarmalayıcıyı kaldırmak durdurmayı gidermez, bir tane eklemek de onu hiçbir zaman bastırmamıştır; sarmalayıcı yalnızca hangi başvurunun yanlış olduğunu gizliyordu. Veri gerçekten başka bir düğüme aitse, bu şablona kendine ait bir kök üzerinden değil, inject borusu üzerinden ulaşır — tüketicide bir uses[].inject girdisiyle bağlayın ve .context.inject üzerinden okuyun.
Denetim, renderer’ın değerlendirdiği her şablon yüzeyini, her birini kendi yüzeyinin tanımladığı başvuru kümesine göre kapsar: Recipe ve FeatureRecipe valuesMapping, injectMapping, workload, artifacts: gövdeleri, provides: ve locals: girdileri, source:, pipeline adımının when: ve with: gövdeleri, assertions:, bir Aggregate içindeki bileşen düzeyi self-inject value: şablonları ve Release sınır yolu şablonları (directory: / subDirectory:). Bu yüzeylerden ikisi bazı retleri kendi tanılamalarıyla adlandırır, çünkü tanımladıkları hata “bu başvuru mevcut değil” durumundan daha özgüldür: kendisine verilmeyen bir değişkene uzanan bir yol şablonu aşağıdaki “Path-template references a variable outside the allowlist (Yol şablonu izin listesi dışındaki bir değişkene başvuruyor)” kapsamındadır; bileşen başına bir sütuna uzanan sınır kapsamlı bir FeatureRecipe ise “FeatureRecipe template references a field outside its scope’s allowlist (FeatureRecipe şablonu kapsamının izin listesi dışındaki bir alana başvuruyor)” kapsamındadır. Bu iki yüzeyin reddettiği diğer her şey — kabul ettikleri bir sütun altındaki yanlış yazılmış bir anahtar dahil — bu durdurmayı bildirir; böylece hiçbir tanılama size başvurunuzun olmadığı bir şey olduğunu söylemez.
An artifacts: template reads a pillar the Recipe does not declare (Bir artifacts: şablonu, Recipe’nin bildirmediği bir sütunu okuyor)
Bir artifacts: girdisinin şablonu, workload: bildirmeyen bir Recipe içinde .workload değerini ya da onun altındaki bir anahtarı okur; veya source: bildirmeyen bir Recipe içinde .source değerini ya da onun altındaki bir anahtarı okur. Her iki sütun da artifacts işleme bağlamında her zaman bulunur — bunlar yüzeyin tanımladığı köklerdir —, bu nedenle başvuru iyi biçimlidir ve durdurma, başvurunun yanlış olmasıyla değil bildirimin bulunmamasıyla ilgilidir. Sentezlenmiş iş yükünden bir Deployment işleyen bir Recipe ile bir kaynaktan chart işleyen bir Recipe farklı biçimlerdir ve bunlardan biri için yazılmış bir artifacts: gövdesi, diğerinin hiç doldurmadığı bir sütuna uzanır.
Denetim, girdi değerlendirilmeden önce çalışır ve raporu yararlı kılan da bu sıralamadır. Eksik bir sütun şablona boş bir değer olarak ulaşır; bu yüzden değerlendirmeye bırakılırsa derleme ya üretilen dosyaya hiçbir şey eklemez ya da şablon motorunun boş bir şeyden anahtar okuma hakkında söylediği hatayla başarısız olur — bunların hiçbiri sütunu veya eksik bildirimi adlandırmaz. Önce reddetmek, durmanın sütuna uzanan ifadeyi tam olarak, sizin yazdığınız biçimde alıntılayarak adlandırmasını sağlar.
Bildirilmiş ancak boş bir dizeye işlenen bir source:, hiç kaynak yokmuş gibi okunur; çünkü denetimin okuduğu, kendi şablonu değerlendirildikten sonraki kaynaktır. Bu, sağlayıcının ardından işlemede kullandığı değerin aynısıdır; dolayısıyla source: değeri hiçbir şeye çözümlenen bir Recipe’nin bir artifacts: gövdesine sunacağı bir kaynağı da yoktur.
Üretilen ileti, artifacts: girdisi nerede yazılmış olursa olsun tek bir biçimdedir. Değişen cümle değil, ardından gelen ve girdiyi hangi belgenin tuttuğunu söyleyen açıklamalardır.
Şablondaki sorunlu başvuruların her biri adlandırılır; böylece iki eksik sütuna uzanan bir gövde size yalnızca önce geleni değil, ikisini de bildirir. Her başvuru, girdiyi bildiren belgede, sizin yazdığınız biçimde alıntılanarak ve ait olduğu çıktıyla açıklanarak raporlanır:
artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>)
İfade, sütunu ilk segmentinde adlandırır ve hangi bildirimin eksik olduğunu size bu söyler: .source.chart, source: bildirimine; .workload.containers ise workload: bildirimine uzanır.
Bir component’in kendi Recipe’sinin bildirdiği bir girdi, o Recipe’nin artifacts: bloğuna karşı raporlanır.
Bir FeatureRecipe’nin bildirdiği bir girdi — bir component’e feature olarak eklenmiş ya da bir sınırda bildirilmiş — ana component’in değil o FeatureRecipe’nin bildirdiği sütunlara karşı denetlenir, FeatureRecipe’nin artifacts: bloğuna karşı raporlanır ve onu bağlayan eki adlandıran bir açıklama daha taşır:
artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>)
Ek açıklaması, konumun tek başına söyleyemediği şeydir: bir component birden çok ek taşıyabilir ve bir sınırda bildirilen bir ek, sınırın tuttuğu her component’e ulaşır. Cümlenin kendisi her iki yolda da bir Recipe adlandırır; hangi belgenin açılacağını konum ve ek açıklaması birlikte söyler.
Bir şablon birden çok başvuru adlandırdığında, her biri paylaştıkları girdiyi adlandıran bir satırın altında kendi raporunu alır ve bu satır belgeyi de adlandırır:
artifact <output-name> references pillars its Recipe does not declare
artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare
Bu raporların her biri, hangi belgeyle ilgili olursa olsun aynı durma koşulunu taşır; bu nedenle metin yerine koşula göre eşleştirme yapan herhangi bir şey aralarında fark görmez.
Nasıl düzeltilir: ya şablonun okuduğu sütunu bildirin ya da onu okumayı bırakın. artifacts: gövdesi o Recipe biçimine aitse düzeltme onu bildirmektir — şablonun container, port veya volume başvurularının beklediği workload: alanını ya da şablonun chart veya modül yolunu ara değerlediği source: alanını ekleyin. Gövde farklı bir Recipe için yazılmışsa ve burada geçerli olmayan bir parçayı yeniden kullanıyorsa düzeltme başvuruyu kaldırmaktır; değer gerçekten başka bir yerden geliyorsa, bu Recipe’in doldurmadığı bir sütuna uzanmak yerine değeri üreten düğümün provides: alanı aracılığıyla yayımlayın ve inject hattından okuyun. Başvuruyu bir yedek sarmalayıcıyla korumak durdurmayı kaldırmaz — eksik olan altındaki anahtar değil, sütunun kendisidir — ve başvuruyu aynı Recipe içindeki başka bir girdiye taşımak da kaldırmaz, çünkü tek bir artifacts: bloğundaki her girdi aynı sütunlara karşı değerlendirilir.
Bu durma, yukarıdaki “Template references a root the render context does not define (Şablon, işleme bağlamının tanımlamadığı bir köke başvuruyor)” durmasından farklıdır ve çözümler farklı olduğu için ikisini ayırt etmeye değer. O durma, yüzeyin hiç tanımlamadığı bir kökte ya da biçimi sabit bir sütunun altındaki yanlış yazılmış bir anahtarda tetiklenir — bir workload’u bildiren bir Recipe’de {{ .workload.containres }} gibi. Bu durma ise doğru yazılmış ama yalnızca orada bulunmayan bir sütuna yapılan başvuruda tetiklenir.
Bir şablon, düğümün provider’ının bildirmediği bir işlenmiş adı okuyor
Bir şablon, provider’ı böyle bir ad bildirmeyen bir düğümde {{ .context.rendered_name }} değerini okur; bu, bağlı provider’ın düğüm için işlediği çıktıya verdiği addır ve yazarın sağladığı kaynaktan ya da provider’ın sentezlediği bir workload’dan gelir. Başvuru iyi biçimlidir ve anahtar, işleme bağlamının tanımladığı bir anahtardır; eksik olan, bu düğüm için bir yanıttır.
Reddin nedeni, alternatifin bir durmadan daha kötü olmasıdır. Ad şablona düz bir dize olarak ulaşır; bu nedenle adı olmayan bir düğüm başvuruyu yok ederek işler ve bir segment eksik bir adres üretir (bir ana makine adı kastedilirken .svc.cluster.local); bunu sıfır çıkış koduyla yapar ve derlemede okunacak hiçbir şey kalmaz. Bu yapıt dağıtılır, ancak adlandırdığı şey mevcut değildir. Herhangi bir şey değerlendirilmeden önce reddetmek, hatayı bunun yerine yazarın yazdığı şablona karşı bildirir.
Bir düğümün provider’ının böyle bir ad bildirip bildirmediği, her değerlendirmeden önce Recipe bağlamasıyla belirlenir; bu nedenle burada hiçbir şey tahmin edilmez.
İki rapor vardır ve hangisini alacağınız, başvuruyu nereye yazdığınıza değil düğüme bağlıdır. Kendi kaynağını sağlamayan ve kendisi için ad bildirmeyen bir provider altındaki bir düğümün kaynakları kimliğine göre adlandırılır; dolayısıyla doğru bir değer vardır ve rapor onu adlandırır. Kaynak sağlayan ve kendisi için ad türetmeyen bir provider altındaki bir düğümün yerine geçecek bir değeri yoktur; orada kimliği önermek sizi o düğümün kaynaklarından hiçbirini adlandırmayan bir değere yönlendirir, bu yüzden rapor bunun yerine bunu söyler.
Düğüm kendi kaynağını sağlamadığında üretilen ileti:
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 (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (şablon, hedefin düğüm için işlediği kaynaklara verdiği adı okuyor ve bu düğümün provider’ı böyle bir ad bildirmiyor; uyumlu bir şablon, düğümün kendi provider’ının sağladığı bir değeri okur (“.context.rendered_name”, provider “<provider>”). bunun yerine .context.instance_id değerini okuyun: bu düğüm kendi kaynağını sağlamıyor, bu yüzden kaynakları düğümün kimliğine göre adlandırılır)
Kaynak sağladığında ve böyle bir ad türetmeyen bir provider altında olduğunda ise:
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 (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (şablon, hedefin düğüm için işlediği kaynaklara verdiği adı okuyor ve bu düğümün provider’ı böyle bir ad bildirmiyor; uyumlu bir şablon, düğümün kendi provider’ının sağladığı bir değeri okur (“.context.rendered_name”, provider “<provider>”). bu hedefin türettiği bir ada bağlı olmayan bir değer yazın: hedef, sağlanan kaynaktan işlediği çıktı için ad bildirmiyor, bu yüzden burada okunacak bu türden bir şey yok)
Başvuru bir provides: girdisi dışındaki bir şablondaysa rapor ayrıca yazıldığı alanı da adlandırır (field "valuesMapping", field "artifacts[probe.tf.json]"); çünkü bir artifacts: girdisinin anahtarı bir çıktı dosya adıdır ve konumun kendi segmentlerini ayırmakta kullandığı karakteri içerir, bu yüzden konum girdiyi tutan blokta durur.
Kapsadığı şablonlar: bir Recipe’in satır içinde yazdığı her şablon: provides: girdileri, valuesMapping: alanı, workload: gövdesi, her artifacts: girdisi ve her pipeline adımının with: ve when: alanları. Bir şablon yüzeyi bunun dışındadır: $import: aracılığıyla sağlanan bir valuesMapping:, workload: veya artifacts: girdisi (içe aktarma ister yerel bir dosyayı ister bir kütüphane girdisini adlandırsın) render onu çözümleyene kadar Recipe’te hiçbir metin taşımaz; bu nedenle böyle bir gövdedeki bir başvuru, derlemeyi durdurmak yerine boş bir değer olarak render edilir.
Nasıl düzeltilir: raporun adlandırdığı anahtarı okuyun. Düğümünüzün çıktısı ad bildirmeyen bir provider altında onun için oluşturulmuş bir şeyse (sentezlenmiş bir workload, yerleştirilmiş bir yapıt kümesi) {{ .context.instance_id }} bu kaynakların gerçekte taşıdığı addır ve bir yedek değil, doğru değerdir. Düğümünüz kendi chart’ını ya da modülünü sağlıyorsa ve rapor yerine geçecek bir değer önermiyorsa, ulaşmaya çalıştığınız ad o provider’ın türettiği bir ad değildir: ona bağlı olmayan bir şey yayımlayın ya da kaynağı sağladığınız kaynak içinde adlandırıp bu adı ayarladığınız bir değerden geri okuyun. ../templates/rendered-resource-names.md hangi provider’ların ad bildirdiğini ve diğerlerinin her biri için neden bildirilecek bir ad olmadığını açıklar.
Bir şablon, çağıranlarının işleme olgularını bildirmeden okuyor
Bir component’e eklenmiş bir FeatureRecipe içindeki bir şablon, .context.used_by altındaki render_facts değerini (eklentinin ana bileşenine bağlanan component’lerin kendi işlemeleri hakkında bildirdikleri) okur ve FeatureRecipe readsCallerRenderFacts: true ayarını yapmaz.
Eklentinin ne zaman işleneceğini bu anahtar belirler. Anahtar olmadan eklenti, eklendiği component’ten hemen sonra işlenir; derleme sırasında daha sonra gelen bağlanan bir component o noktada henüz işlenmemiştir, dolayısıyla ürettiği şey okunmak üzere orada olamaz. Şablonu herhangi bir şey işlenmeden önce reddetmek, şablonu çağıranlarının bir kısmının ürettiğini okuyup diğerlerininkini okumayan bir derleme yerine, eksik bildirimi yazdığınız alana karşı bildirir.
Üretilen ileti:
template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (şablon çağıranlarının işleme olgularını okuyor, ancak FeatureRecipe readsCallerRenderFacts ayarını yapmıyor (<reference>, <field> içinde yazılmış))
Başvuru, okunduğu bağlantıya göreli olarak alıntılanır (.render_facts ya da .render_facts.<name>); çünkü bir şablon çağıranları birer bağlantı hâlinde, {{ range .context.used_by }} içinde ya da seçtiği tek bir bağlantı üzerinden okur. Alan, şablonun yazıldığı bloğu adlandırır: valuesMapping, workload ya da artifacts[<output-name>]. Aynı olguları okuyan bir pipeline adımının with: ya da when: alanı, FeatureRecipe ne ayarlarsa ayarlasın bunun yerine sonraki girdi tarafından bildirilir; çünkü anahtarı ayarlamak bir adımın onları okumasını sağlamaz. Olguları birden çok alan okuyorsa, her biri ortak noktalarını adlandıran bir satırın altında kendi raporunu alır:
attachment templates reading their callers’ render facts without declaring it (çağıranlarının işleme olgularını bildirmeden okuyan eklenti şablonları)
Nasıl düzeltilir: FeatureRecipe’nin spec alanında readsCallerRenderFacts: true ayarını yapın. Bu, eklentilerini her component işlendikten sonra işler ve işledikleri şey hakkında başka hiçbir şeyi değiştirmez; bkz. FeatureRecipe varlık sayfası. Sözleşme anahtarın kendisidir; bu durma yalnızca ona açıkça ihtiyaç duyan bir şablonu bulmanıza yardım eder: denetim şablonu yazıldığı gibi okur, bu nedenle şablon çalışırken oluşturulan bir başvuru ya da bir dosyadan veya kütüphaneden içe aktarılan içerikte yazılmış bir başvuru durmaya yol açmaz; böyle bir FeatureRecipe’de de anahtarı yine de ayarlayın. .context.used_by yanında başka bir listeden render_facts adlı bir alanı okuyan bir şablon da durur; yanındaki {{ with .context }} içinde ana bileşenin kendi olgularını .render_facts olarak okuyan bir şablon da öyle. Ana bileşenin kendi olgularını tam olarak .context.render_facts biçiminde yazın; bu asla çağıranlarınki sanılmaz. Anahtarı ayarlamak, daha geç işleme dışında hiçbir maliyet olmadan her iki durumu da giderir.
Bir sınır için bir kez işlenen bir FeatureRecipe (executionScope: boundary) burada denetlenmez: kaynaklarını üreten şablonların okuyacağı bir .context yoktur ve buna yapılan bir başvuru bunun yerine kapsamının izin listesi dışındaki bir alan olarak reddedilir.
A pipeline step reads its callers’ render facts (Bir pipeline adımı, çağıranlarının render olgularını okuyor)
Bir bileşene eklenmiş bir FeatureRecipe içindeki bir pipeline adımının with: veya when: alanı, .context.used_by altındaki render_facts değerini okur; bu, eklentinin barındırıcısına bağlanan bileşenlerin kendi render işlemleri hakkında bildirdikleridir.
Bir pipeline adımı bu bağlantıları hiçbir zaman görmez. Bir adım barındırıcı bileşenin kendi belgelerini yeniden yazabilir ve bir bileşenin kendi çıktısı ona kim bağlanırsa bağlansın aynı kalır; bu nedenle bir adımın şablonları, readsCallerRenderFacts: true ayarlı olsun ya da olmasın her FeatureRecipe için .context.used_by olmadan değerlendirilir. Bu anahtar eklentinin ne zaman render edileceğini belirler, bir adımın ne gördüğünü asla belirlemez. Bu yüzden çağıranlarının olgularını okuyan bir adım hiçbir şey okumaz ve derleme, bu okumayı boş bir değer olarak render etmek yerine herhangi bir şey render edilmeden önce durur.
Üretilen ileti:
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 (<reference>, written in <field>) (pipeline adımı çağıranlarının render olgularını okuyor, ancak bir pipeline adımı barındırıcısına bağlanan bileşenleri okumaz; yalnızca barındırıcının kendi render olgularını okur (<reference>, <field> içinde yazılmış))
Başvuru, yukarıdaki girdide olduğu gibi okunduğu bağlantıya göre aktarılır (.render_facts veya .render_facts.<name>) ve alan, adımı kimliğiyle adlandırır: pipeline[<step>].with veya pipeline[<step>].when. Birden fazla adım olguları okuduğunda, her biri ortak noktalarını adlandıran bir satırın altında kendi raporunu alır:
Nasıl düzeltilir: bir adımda barındırıcının kendi render olgularını .context.render_facts konumunda, tam olarak yazarak okuyun; bunlar barındırıcının kendi render işleminden gelir, bu yüzden onları okumak hiçbir şeyi barındırıcıya kimin bağlandığına bağımlı kılmaz. Çağıranların olgularını bunun yerine eklentinin kendi kaynaklarını üreten şablonlarda, yani valuesMapping:, workload: veya artifacts: içinde, FeatureRecipe varlık sayfasının açıkladığı gibi readsCallerRenderFacts: true ayarlanmış olarak okuyun. Anahtarı tek başına ayarlamak bu durmayı gidermez. Denetim şablonu yazıldığı haliyle, yukarıdaki girdinin açıkladığı sınırlarla okur: şablon çalışırken oluşturulan bir başvuru veya bir dosyadan ya da kütüphaneden içe aktarılan içerikte yazılmış bir başvuru durmaya yol açmaz; .context.used_by yanındaki başka bir listeden render_facts adlı bir alanı okuyan ya da barındırıcısının kendi olgularını yanındaki {{ with .context }} içinde .render_facts olarak okuyan bir adım da durmaya yol açar.
Bir sınır için bir kez render edilen bir FeatureRecipe (executionScope: boundary), yukarıdaki girdinin verdiği nedenle burada denetlenmez.
A template reads its targets’ render facts without declaring it (Bir şablon, bunu bildirmeden hedeflerinin render olgularını okuyor)
Bir bileşene eklenmiş bir FeatureRecipe içindeki bir şablon, .context.uses altındaki render_facts değerini okur (eklentinin barındırıcısının bağlı olduğu bileşenlerin kendi render işlemleri hakkında bildirdikleri) ve FeatureRecipe readsTargetRenderFacts: true ayarını yapmaz.
Anahtar iki şeyi belirler. Birincisi, eklentinin her bileşen render edildikten sonra render edilmesini sağlar: anahtar olmadan eklenti, eklendiği bileşenden hemen sonra render edilir ve derleme sırasında daha sonra gelen bir hedef o noktada henüz render edilmemiştir. İkincisi, her hedefin olgularını eklentinin okuduğu bağlantılara koyan odur: anahtar olmadan .context.uses girdilerinin hiçbiri .render_facts taşımaz. Şablonu herhangi bir şey render edilmeden önce reddetmek, şablonu bir hedefin olgularını beklediği yerde hiçbir şey okumayan bir derleme yerine, eksik bildirimi yazdığınız alana karşı raporlar.
Üretilen ileti:
template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (şablon, barındırıcısının bağlı olduğu bir bileşenin render olgularını okuyor, ancak FeatureRecipe readsTargetRenderFacts ayarını yapmıyor (<reference>, <field> içinde yazılmış))
Başvuru, şablonun yazdığı başvurudur: tek bir bağlantının takma adı altında tam olarak (.context.uses.<alias>.render_facts veya .context.uses.<alias>.render_facts.<name>) ya da şablonun bağlantıları birer birer okuduğu yerde, {{ range .context.uses }}, {{ with .context.uses.<alias> }} içinde veya seçtiği tek bir bağlantıdan, o bağlantıya göre: .render_facts veya .render_facts.<name>. Alan, şablonun yazıldığı bloğu adlandırır: valuesMapping, workload veya artifacts[<output-name>]. Aynı olguları okuyan bir pipeline adımının with: veya when: alanı ise, FeatureRecipe ne ayarlarsa ayarlasın bir sonraki girdi tarafından raporlanır. Birden fazla alan olguları okuduğunda, her biri ortak noktalarını adlandıran bir satırın altında kendi raporunu alır:
attachment templates reading the render facts of the components their host is wired to, without declaring it (bunu bildirmeden, barındırıcılarının bağlı olduğu bileşenlerin render olgularını okuyan eklenti şablonları)
Nasıl düzeltilir: FeatureRecipe’in spec alanında readsTargetRenderFacts: true ayarını yapın; readsCallerRenderFacts: true bu durmayı gidermez, çünkü olguları barındırıcının bağlı olduğu bileşenlere değil, barındırıcıya bağlanan bileşenlere koyar. Bu ayar, eklentilerini her bileşen render edildikten sonra render eder ve her hedefin olgularını kendi bağlantısına koyar; render ettikleri şeyle ilgili başka hiçbir şeyi değiştirmez; bkz. FeatureRecipe varlık sayfası. Sözleşme anahtarın kendisidir; bu durma yalnızca ona açıkça ihtiyaç duyan bir şablonu bulmanıza yardımcı olur: denetim şablonu yazıldığı haliyle okur, bu nedenle şablon çalışırken oluşturulan bir başvuru veya bir dosyadan ya da kütüphaneden içe aktarılan içerikte yazılmış bir başvuru durmaya yol açmaz; böyle bir FeatureRecipe’te de anahtarı yine de ayarlayın. .context.uses değerini herhangi bir şekilde okuyan ve ayrıca başka bir değerden render_facts adlı bir alanı okuyan bir şablon (bunlar arasında {{ range .context.used_by }} içindeki bir çağıranın olguları da vardır) da durmaya yol açar; anahtarı ayarlayın ve şablonun çağıranlarının olgularını okuduğu yerde readsCallerRenderFacts anahtarını da ayarlayın.
Bir sınır için bir kez render edilen bir FeatureRecipe (executionScope: boundary), yukarıdaki çağıranlar girdisinin verdiği nedenle burada denetlenmez.
A pipeline step reads its targets’ render facts (Bir pipeline adımı, hedeflerinin render olgularını okuyor)
Bir bileşene eklenmiş bir FeatureRecipe içindeki bir pipeline adımının with: veya when: alanı, .context.uses altındaki render_facts değerini okur; bu, eklentinin barındırıcısının bağlı olduğu bileşenlerin kendi render işlemleri hakkında bildirdikleridir.
Bir adım, barındırıcısının kurduğu bağlantıları barındırıcının kendi Recipe’inin okuduğu gibi okur ve readsTargetRenderFacts: true ayarlı olsun ya da olmasın her FeatureRecipe için bunların hedeflerinin render olgularını asla okumaz. Bir adım barındırıcı bileşenin kendi belgelerini yeniden yazabilir ve barındırıcının kendi render işlemi hedeflerinin yayımladığını okur, ürettiklerini asla okumaz; bu nedenle bir adımın şablonları bu olgular olmadan değerlendirilir. Bu yüzden onları okuyan bir adım hiçbir şey okumaz ve derleme, bu okumayı boş bir değer olarak render etmek yerine herhangi bir şey render edilmeden önce durur.
Üretilen ileti:
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 (<reference>, written in <field>) (pipeline adımı, barındırıcısının bağlı olduğu bir bileşenin render olgularını okuyor, ancak bir pipeline adımı yalnızca barındırıcının kendi render olgularını okur (<reference>, <field> içinde yazılmış))
Başvuru yukarıdaki girdide olduğu gibi aktarılır ve alan, adımı kimliğiyle adlandırır: pipeline[<step>].with veya pipeline[<step>].when. Birden fazla adım olguları okuduğunda, her biri ortak noktalarını adlandıran bir satırın altında kendi raporunu alır:
pipeline steps reading the render facts of the components their host is wired to (barındırıcılarının bağlı olduğu bileşenlerin render olgularını okuyan pipeline adımları)
Nasıl düzeltilir: bir adımda barındırıcının kendi render olgularını .context.render_facts konumunda, tam olarak yazarak okuyun. Hedeflerin olgularını bunun yerine eklentinin kendi kaynaklarını üreten şablonlarda, yani valuesMapping:, workload: veya artifacts: içinde, FeatureRecipe varlık sayfasının açıkladığı gibi readsTargetRenderFacts: true ayarlanmış olarak okuyun. Anahtarı tek başına ayarlamak bu durmayı gidermez. Denetim şablonu yazıldığı haliyle, yukarıdaki girdinin açıkladığı sınırlarla okur.
Bir sınır için bir kez render edilen bir FeatureRecipe (executionScope: boundary), yukarıdaki çağıranlar girdisinin verdiği nedenle burada denetlenmez.
Cross-node type safety violation via selector: (selector: üzerinden düğümler arası tür güvenliği ihlali)
Tek bir durma, bir katalog yazarının neyin bağlanabileceğini veya eklenebileceğini kısıtlamak için yazdığı iki etiket ifadesini kapsar, çünkü ikisi de aynı şekilde başarısız olur: bir katalog varlığının bildirdiği bir ifadeyi karşılamayan bir etiket kümesi.
Hedefi soketinin selector: alanını karşılamayan bir uses: kenarı. Bir usesSchema soketi, kenarın diğer ucunda bağlı hedef Component’i dışlayan bir selector: alanı bildirir. Seçici, katalog yazarının “bu soket yalnızca etiketleri bu ifadeyle eşleşen hedefleri kabul eder” deme yoludur; soket adı aramasını karşılayan ancak seçici ifadesini karşılamayan bir kenar bir tür güvenliği ihlalidir.
Üretilen ileti:
selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (seçici ihlali: soket üzerinde bildirilen seçici, hedefin etiketleri tarafından karşılanmıyor. Seçicinin gerektirdiği etiketleri hedefin bileşen türüne ekleyin ya da soketi bu etiketleri zaten taşıyan bir bileşene bağlayın.)
Bileşeni Feature’ın appliesTo: alanını karşılamayan bir eklenti. Bir Feature, hangi bileşenlere eklenebileceğini appliesTo: ve appliesToAnyOf: üzerinde bildirir. Tekil ifadenin gereksinimleri birlikte geçerli olur, alternatifler ise seçenekli olarak geçerli olur ve herhangi biri yeterlidir; her iki yüzey de sağlanmalıdır ve Feature’ın atladığı bir yüzey her şeyle karşılanır. Bileşeni, Feature’ın bildiriminin kabul etmediği etiketler taşıyan bir eklenti, yukarıdaki kenar durumuyla aynı sınıfta bir ihlaldir.
Üretilen ileti:
selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (seçici ihlali: Feature tarafından bildirilen appliesTo ifadesi, bileşenin etiketleri tarafından karşılanmıyor. Feature’ın appliesTo ifadesinin gerektirdiği etiketleri bu bileşenin türüne ekleyin ya da uygulanabilirlik koşulunu bileşenin zaten karşıladığı bir Feature ekleyin.)
Her iki ifade de etiket dilbilgisinin hiç okuyamadığı bir biçimde yazılmış olabilir. Bu, son değeri karşılanmadığı etiket kümesi yerine okunamama nedeni olan aynı durma olarak raporlanır; değerlendirilemeyen bir ifadeyi değerlendirilip yanlış çıkan bir ifadeden ayıran budur:
selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (seçici ihlali: Feature tarafından bildirilen appliesTo ifadesi değerlendirilemedi. Feature’ın katalog varlığındaki appliesTo seçicisini düzeltin.)
Dilbilgisinin okuyamadığı bir soket seçicisi de soketi herhangi bir şey bağlamadan önce reddedilir.aggrega validate, tüm katalog ya da tek bir Component veya Feature üzerinde çalıştırıldığında, varlığın kendi belgesinin bildirdiği her soket seçicisini okur ve dilbilgisinin okuyamadığı bir seçiciyi, soket üzerinden herhangi bir kenar bağlansın ya da bağlanmasın, bu aynı koşul altında reddeder:
selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (seçici ihlali; bir sokette bildirildi ve değerlendirilemedi. Seçiciyi, bileşen türünün usesSchema alanındaki soket bildiriminde düzeltin.)
Bir Feature’ın soketinde ise çözüm, bunun yerine Feature’ın usesSchema alanını adlandırır. Soketi hiçbir şey bağlamamıştır; bu nedenle hata katalog varlığınındır: CATALOG_ERROR olarak kaydedilir ve varlığın dosyasını adlandırır.
Durdurma, ilgili olduğu yazım anahtarını — uses: soket girdisini ya da eklemeyi adlandıran features: girdisini — onu bildiren dosyayla birlikte taşır; böylece bildirdiği konum, belgenin başı değil, sizin düzenlediğiniz girdidir. Bir alt sistem içinde yazılmış bir Component, altında yazıldığı alt sistemde, düzey düzey konumlandırılır. Bir ekleme, onu yazan belgede onu yazan features: girdisinde konumlandırılır ve o belgenin yazarına göre sınıflandırılır: Aggregate içindeki bileşenin kendi bloğu ya da bir alt sistemin bloğu, bir geliştirici hatasıdır; yalnızca Release’in yaptığı bir ekleme için ise bileşene ait girdisi ya da bileşeni barındıran bir sınırın features: bloğu, bir operatör hatasıdır. Eklemeyi her iki belge de yazıyorsa, ekleme type değerinin adlandırıldığı yerde konumlandırılır; Aggregate bunu her zaman yapar. Bir bağlantı üzerine yazılmış bir ekleme, onu yazan belgede o bağlantının features: anahtarı altındaki kendi anahtarında konumlandırılır — Aggregate’in bağlantı girdisi ya da yalnızca Release’in yaptığı bir ekleme için Release’in kenar başına girdisi. Yalnızca Release’in, bildirimi kabul etmeyen bir bileşene eklediği bir Feature şöyle okunur:
[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.
aynı ekleme Aggregate içinde bileşen üzerine yazıldığında ise [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics olarak okunur. Annotation güdümlü genişletmenin ürettiği bir ekleme hiçbir features: girdisi tarafından yazılmamıştır; bu nedenle bileşeni bildiren belgede bileşenin kendi features: anahtarında, bir geliştirici hatası olarak konumlandırılır.
Kenar ihlali nasıl düzeltilir: ya uses: kenarını etiketleri seçiciyi karşılayan bir Component’e yönlendirin ya da katalog varlığındaki seçici ifadesini amaçlanan hedef sınıfını kabul edecek şekilde ayarlayın. Hangi etiketleri taşıdığını doğrulamak için hedef Component’in metadata.labels alanını aggrega inspect ile inceleyin.
Eklenti ihlali nasıl düzeltilir: ya Feature’ı etiketlerini bildiriminin kabul ettiği bir bileşene ekleyin ya da Feature’ın appliesTo: alanını genişletin; Feature gerçekten birden fazla bileşen sınıfına hizmet ediyorsa appliesToAnyOf: altına bir alternatif ekleyin. Bileşenin uygun olması amaçlanıp olmuyorsa, eksik parça genellikle bir etikettir: onu aggrega inspect ile inceleyin ve ifadenin istediğini Component’in metadata.labels alanına ekleyin.
Unknown provider (Bilinmeyen sağlayıcı)
Bir Recipe capability: <name> bildirir; burada <name>, derleyicinin sunduğu hiçbir sağlayıcıyı adlandırmaz. Derleyici, render işlemini hiç duymadığı bir sağlayıcıya yönlendiremez.
Nasıl düzeltilir: sağlayıcı adının doğru yazıldığını doğrulayın; cloudformation, compose, helm, helm-chart ve terraform, gömülü sağlayıcı eklentilerinin sunduğu adlardır. Özel bir kurumsal sağlayıcı amaçladıysanız, o adı sunan bir Provider-rendering Plugin’inin (pluginType: provider ve adı spec.provider.capabilities içinde) derlemenin gösterdiği katalog çalışma alanında bulunduğundan emin olun.
A capability is served by more than one provider plugin (Bir yetenek birden fazla sağlayıcı eklentisi tarafından sunuluyor)
Bir derleme, birden fazla Provider-rendering Plugin tarafından (pluginType: provider, her biri o yeteneği kendi spec.provider.capabilities alanında listeler) sunulan bir yeteneğe ulaşır ya da bir çekme işlemi böyle bir yeteneği çözümler ve çalışma alanı onu hangisinin render edeceğini seçmemiştir. Derleme, bir sağlayıcıyı keyfi olarak seçmek yerine durur ve her iki adayı adlandırır. Aynı yetenek için iki eklenti taşıyan bir katalog geçerlidir: iki yayıncı helm veya compose için birer eklenti yayımlayabilir ve katalog ikisini de kabul eder. Belirsizlik yalnızca kullanım noktasında ortaya çıkar: durma, yükleme zamanında değil, bir derleme veya çekme işlemi tartışmalı yeteneğe gerçekten ulaştığında tetiklenir.
Üretilen ileti. Derlemeyi durduran kural başta gelir, ayrıntılar (hangi yetenek, hangi adaylar ve yazılacak bağlama) onu izler:
capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (yetenek birden fazla sağlayıcı eklentisi tarafından sunuluyor; birini seçmek için bir plugins.providers girdisi ekleyin: "<capability-name>" yeteneği birden fazla sağlayıcı eklentisi tarafından sunuluyor (<plugin-1>, <plugin-2>); "<capability-name>" için birini seçen bir plugins.providers girdisi ekleyin)
Nasıl düzeltilir: çalışma alanı yapılandırmasına, anahtarı yetenek olan ve değeri onu render eden eklenti kimliğini seçen bir plugins.providers girdisi ekleyin. Her iki eklentiyi de federe katalogda tutun; bağlama, bu çalışma alanına tartışmalı yetenek için hangisine yönlendirileceğini söyler.
The plugin serving a provider cannot assemble what that provider combines (Bir sağlayıcıya hizmet eden eklenti, o sağlayıcının birleştirdiğini derleyemiyor)
Bir sağlayıcı, bir dağıtım grubunun düğüm başına çıktısına ne olacağını belirtir: her düğümün çıktısı doğrudan dağıtım yoluna yazılır, parçalar tek bir belgede birleştirilir ya da her düğüm tek bir kapsayıcı yapı içinde kendi konumuna yerleştirilir. Bir sağlayıcının çıktının birleştirildiğini belirttiği yerde — birleştirilmiş bir compose dosyası, bir şemsiye chart — ona hizmet eden eklentinin birleştirmeyi yapan dışa aktarımı sunması gerekir. Bu durdurma, eklentinin bunu sunmadığı yerde tetiklenir: eklenti düğüm başına işlemeyi (render_node) duyurur ama buna karşılık gelen bir assemble_boundary duyurmaz; bu nedenle grubun düğümleri işlenebilir, ancak çıktıları birleştirilemez.
Bu uyuşmazlığın iki yarısı da eklentiye aittir. Bir dağıtım grubunun çıktısına ne olacağı, eklentinin yüklendiğinde kendisi hakkında bildirdiklerinin bir parçasıdır; birleştirmeyi yapacak dışa aktarım ise bir Plugin varlığının spec.exports altındaki girdilerinden biridir ve aynı bildirime göre çapraz denetlenir. Bu nedenle durdurma, dışa aktarım yüzeyinin sağlamadığı bir derlemeyi üstlenen bir eklentiyi adlandırır.
Derleme, birleştirmeyi atlamak yerine durur. Atlamak, her düğümün parçasını tek bir yapıtın beklendiği yola yazar ve başarı bildirirdi; sonraki hiçbir adım bu parçaları, hiçbir derleme üstlenmeyen bir sağlayıcının tasarım gereği ürettiği düz, düğüm başına çıktıdan ayırt edemez. Böylece eksik bir yapıt, derleme zamanında değil, çıktının uygulandığı yerde ortaya çıkardı.
Hiçbir dağıtım yolunda bulunmayan bir dağıtım grubu atlanır. Hiçbir yola yazılmayan çıktı düğüm başına çıktıdır; dolayısıyla orada birleştirmeye ilişkin bir iddianın yöneteceği hiçbir şey derlenmez.
Üretilen ileti — sorunlu her dağıtım grubu için bir bulgu; sağlayıcıyı ve o grubun derlendiği yolu adlandırır:
provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (dağıtım grubunu birleştirmesi beklenen sağlayıcı hiçbir sınır birleştiricisi sunmuyor)
Birden fazla dağıtım grubu sorunlu olduğunda bulgular dispatch groups whose provider offers no boundary assembler (sağlayıcısı hiçbir sınır derleyicisi sunmayan dağıtım grupları) raporu altında birlikte gelir.
Nasıl düzeltilir: yeteneği hem render_node hem de assemble_boundary duyuran bir eklentiyle sunun — spec.exports yazım yüzeyi için ../entities/plugin.md sayfasına, derleme dışa aktarımının ne aldığı için ../schema/plugins/wasm-provider.md sayfasına bakın. Eklentiyi siz yazıyorsanız iki tarafı uyumlu hâle getirmek size düşer: derleme dışa aktarımını ekleyin ya da hiçbir derleme iddiası bildirmeyin ve her düğümün çıktısının dağıtım yoluna birleştirilmeden yazılmasına izin verin. Yayımlanmış bir eklenti kullanıyorsanız her iki dışa aktarımı da sunan bir sürüm seçin ya da sağlayıcısı o yetenek için hiçbir derleme iddia etmeyen bir eklenti seçin.
A boundary-level Feature’s output reaches no assembled file (Sınır düzeyindeki bir Feature’ın çıktısı hiçbir birleştirilmiş dosyaya ulaşmıyor)
Bir sınırın features: alanı altında eklenmiş ve FeatureRecipe’i executionScope: boundary bildiren bir Feature, sınırın tamamı için bir kez işlenir ve çıktısı, sınırın kendi directory: ve subDirectory: alanlarının onun için değerlendirildiği dizine gider. Çıktısını tek bir belgede toplayan bir sağlayıcı — compose tek bir docker-compose.yaml içinde, cloudformation tek bir yığında — böyle bir Feature’ın katkısını yalnızca orada sınırın bileşenlerinden birleştirdiği dosyanın bir parçası olarak yazar. Bu dosya, yalnızca en az bir bileşenin çıktısı aynı sağlayıcı altında aynı dizine düştüğünde var olur.
Sınırın bileşenleri başka bir yere düştüğünde bu dosya yoktur: bileşenler, subDirectory: alanı onları başka bir yere gönderen iç içe sınırlarda bulunduğunda — örneğin her bileşenin kendi dosyasını alması için "{{ .component_id }}" — ya da Feature’ın çıktısının paylaşmadığı bir dizin altında olduğunda. Feature’ın dizininde hiçbir şey birleştirilmez; bu nedenle çıktısı hiçbir yere yazılmaz — compose köprüsü için, hiçbir dosyanın taşımadığı bir ağ geçidi hizmeti — ve derleme başarı bildirirdi. Bunun yerine derleme durur.
Sağlayıcısı her katkıyı kendi dosyaları olarak yazan bir Feature — helm, helm-chart ve terraform — etkilenmez: bu dosyalar, yanlarında herhangi bir şey birleştirilsin ya da birleştirilmesin yazılır.
Üretilen ileti — sorunlu her Feature için bir bulgu; sınırın features: alanı altındaki girdisinde konumlanır ve sınırı, Feature’ı, çıktısının yönlendirildiği gönderim yolunu ve sağlayıcıyı adlandırır:
boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (sınır düzeyindeki Feature’ın çıktısı, hiçbir şeyin birleştirilmediği bir gönderim yoluna yönlendiriliyor. Feature’ı çıktı yolu bileşenlerini de alan bir sınıra ekleyin ya da sınırın bileşenlerine Feature’ın çıktısının yönlendirildiği dizini verin)
Tek alt sınırı her bileşeni subDirectory: "{{ .component_id }}" altına yerleştiren bridge adlı bir üst sınıra eklenmiş bir compose köprüsü şunu yazdırır:
[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to
Birden fazla Feature sorunlu olduğunda bulgular, boundary-level Features whose output is routed to a dispatch path nothing assembles raporu altında birlikte gelir.
Nasıl düzeltilir: Feature’ın dizinini, sınırının bileşenlerinin de düştüğü bir dizin yapın. Ya Feature’ı kendi çıktı yolu bu bileşenleri alan bir sınıra ekleyin ya da bileşenlere Feature’ın çıktısının yönlendirildiği dizini verin — alt sınırlar için, kendilerine ait bir subDirectory: olmadan directory: "{{ .parent_boundary.directory }}" kullanın; böylece üst sınırın dosyasını paylaşırlar. İleti, Feature’ın çıktısının yönlendirildiği dizini adlandırır; paylaşılması gereken dizin odur.
Path-template references a variable outside the allowlist (Yol şablonu izin listesi dışındaki bir değişkene başvuruyor)
Bir directory: ya da subDirectory: şablonu, yol şablonu değişken izin listesinin içermediği bir değişken adına başvuruyor; örneğin {{ .parmaeters.region }} gibi bir yazım hatası ya da Recipe işleme bağlamında bulunan ama yol şablonlarına açılmayan bir alan (.context.inject veya .values gibi). Aynı durdurma, bir directory: şablonundaki {{ .component_id }} için de geçerlidir: değişken vardır ve subDirectory: şablonları onu okuyabilir, ancak bir sınırın directory: değeri bileşen başına bir kez değil, tüm sınır için bir kez değerlendirilir; dolayısıyla orada bileşen başına bir değişken, üretilen yolu hangi bileşenin ilk değerlendirildiğine bağlı kılardı.
Yol şablonları, herhangi bir işleme başlamadan önce ayrıştırma zamanında, yol şablonu bağlamının tanımladığı değişkenlerden ilgili yüzeyin reddettikleri çıkarılarak doğrulanır. Derleyici ayrıca yol şablonlarını missingkey=error semantiğiyle değerlendirir; böylece izin listesinde olup değerlendirme zamanında tanımsız olan bir başvuru, bir dizin yoluna sessizce boş bir dize işlemek yerine açık bir hata üretir.
Bu durdurma değişkenle ilgilidir. İzin verilen bir değişkenin altında yanlış yazılmış bir anahtar — {{ .manifest.recipe_nmae }} — bunun yerine yukarıdaki “Template references a root the render context does not define (Şablon, işleme bağlamının tanımlamadığı bir köke başvuruyor)” durumunu bildirir ve .manifest içinde tanımlı anahtarları adlandırır; çünkü değişkenin kendisi kabul edilmiştir ve yalnızca anahtar yanlıştır.
Üretilen ileti:
path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (yol şablonu belgelenmiş izin listesinde olmayan bir alana başvuruyor)
Nasıl düzeltilir: alan adını yol şablonu izin listesindeki bir adla düzeltin ya da başvuruyu kaldırın. directory: için izin listesi {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }} ve {{ .parent_boundary.* }} değerlerinden oluşur; subDirectory: buna {{ .component_id }} ekler. Diğer yüzeyler (Recipe valuesMapping, FeatureRecipe injectMapping vb.) farklı bir bağlam yapısı kullanır; .context.*, .values, .infra veya .locals başvuruları yol şablonlarına bilerek açılmaz, çünkü yol üretimi değer işlemeyle değil, yapıyla ilgili bir konudur.
Path collision: two contributors emit at incompatible paths (Yol çakışması: iki katkıda bulunan uyumsuz yollara üretiyor)
Yol bildirimleri aynı derleme yoluna değerlendirilen iki sınır farklı sağlayıcılar üzerinden yönlendirilir. İkisi de orada derlenir ve her biri diğerinin hiçbir şey bilmediği dosyalar yazar; böylece biri diğerini diskte sessizce yerinden eder ve yerinden edilen çıktıyı üreten derleme başarılı olmuş gibi görünür.
Varsayılan subDirectory: her sağlayıcıya kendine ait bir alt yol verir; bu nedenle iki sağlayıcı yalnızca bildirimler aynı sonuca değerlendirilecek şekilde yazıldığında tek bir yola ulaşır: örneğin bir directory: değerini paylaşan ve ikisi de subDirectory: değerini aynı sabit değere sabitleyen iki sınır.
Üretilen iletiler. Katkıda bulunan her sınır için bir bulgu bildirilir; böylece çıktısı yola ulaşan her sınır, tek bir ileti içindeki bir listeye katlanmak yerine ayrı ayrı adlandırılır. Hata, iki sağlayıcının tek bir yolda buluşmasıdır; bu nedenle her zaman en az iki bulgu vardır ve bunlar ortak noktalarını belirten bir rapor altında birlikte gelir:
assembly paths reached by more than one provider (birden fazla sağlayıcının ulaştığı derleme yolları)
Her bulgu yolu, çıktısı o yola ulaşan sınırı ve o sınırın üzerinden yönlendirildiği sağlayıcıyı adlandırır:
dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (dağıtım yolu birden çok sağlayıcı çıktısı üretti)
api-net ve db-net sınırlarının ikisinin de directory: ./dist/shared ve subDirectory: merged bildirdiği, birinin helm diğerinin compose üzerinden yönlendirildiği bir derleme şunu yazdırır:
Rapor kısa kodu taşır ve altındaki her bulgu yalnızca kendi kategorisini taşır; bu, toplanan hataları bildiren her raporun kullandığı yapıdır — bu dilbilgisi için error-translation.md sayfasına bakın.
Nasıl düzeltilir: ya her sınıra ayrı bir directory: verin (böylece ayrı yollara derlenirler) ya da subDirectory: alanını varsayılanında bırakın ki her sağlayıcının çıktısı kendine ait bir alt yola yazılsın. compose-bridge örüntüsü iki alt sınırı bilerek tek bir derleme yolunda birleştirir; bu örüntü, iki sınırın da aynı sağlayıcıyı hedeflemesini ve kademeli olarak çözümlenen uyumlu ek açıklamalar taşımasını gerektirir.
A boundary’s output directory is not a directory beneath the output root (Bir sınırın çıktı dizini, çıktı kökünün altındaki bir dizin değil)
Bir sınırın directory: ve subDirectory: değerleri değerlendirilir ve çıktısının altına yazılacağı dizinde birleştirilir; bu yol bir kez temizlenir: out/a, out//a, ./out/a ve out/a/ tek bir dizindir. Temizlenmiş yol çıktı kökünün altındaki bir dizin değilse, derleme hiçbir şey yazılmadan durur. Bu, çıktı kökünün dışına tırmanan bir yol (.., ../escape, a/../..), mutlak bir yol (/srv/out) ya da hiçbir dizini adlandırmayan bir yoldur: boş bir değer veya alt dizin devre dışıyken directory: "." gibi çıktı kökünün kendisine temizlenen bir değer.
Yol değerlendirildiği haliyle denetlenir; yani yazılan metin değil, bir şablonun sonucu değerlendirilir. İleti, hatanın kaynaklandığı alanı adlandırır — dizin tek başına çıktı kökünün dışına çıkıyorsa ya da üzerine hiçbir alt dizin eklenmiyorsa directory:, aksi halde subDirectory: — ve bununla birlikte o alanın değerlendirildiği değeri ve ürettiği yolu verir.
Üretilen ileti:
boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (sınır çıktı dizini, çıktı kökünün altında bir dizini adlandırmıyor. Çıktı kökünün altında bir dizin yazın, örneğin “deploy/prod”: başında “/” olmadan, kökün üstüne çıkan “..” olmadan ve çıktı kökünün kendisi olmadan)
Hata alt dizindeyse, üçüncü değer bunun yerine subDirectory: "<value>" olarak okunur.
Nasıl düzeltilir: iletinin adlandırdığı alanı çıktı kökünün altındaki bir dizin olarak yazın. Çıktı kökünün yanında durması amaçlanan bir dizin bunun yerine onun içine konmalıdır. Bir sınırın çıktısını doğrudan directory: dizinine yazmak için subDirectory: "." ayarlayın — dizinin kendisi yine de kendine ait bir dizini adlandırmalıdır.
A boundary-level Feature is named . or .. (Sınır düzeyindeki bir Feature . veya .. olarak adlandırılmış)
Her katkıda bulunana kendine ait bir dizin veren bir provider — modules/ altında terraform ve charts/ altında helm-chart — bir sınıra eklenmiş bir Feature’ı, sınırın bileşenlerinin yanında, yalnızca örneğin adını taşıyan bir dizine yerleştirir. Bir sınırın features: anahtarı . ve .. değerlerini kabul eder ve bunların hiçbiri bir dizin adı değildir: . Feature’ın dosyalarını tüm katkıda bulunanları barındıran dizine, .. ise onun bir üstündekine koyar; böylece dosyalar provider’ın Feature’a verdiği konumun dışına düşer. Bunun yerine derleme durur. Diğer adlara dokunulmaz; audit.v2 gibi noktalı bir ad da buna dahildir.
Üretilen ileti:
boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (sınır düzeyindeki Feature örneğinin adı bir dizin adı değil. Sınırın features anahtarı altındaki Feature örneğini “audit” gibi sıradan bir adla yeniden adlandırın)
Nasıl düzeltilir: sınırın features: altındaki örneği sıradan bir adla yeniden adlandırın.
Instance-ID collision across boundaries assembling to the same path (Aynı yola birleştirilen sınırlar arasında örnek kimliği çakışması)
Aynı (yol, provider) demetine birleştirilen iki sınır, aynı örnek kimliklerine sahip bileşenler katar. Birleştirilmiş derleme iki bileşen parçasını ayırt edemez — tek bir Helm chart’ı web-server adlı iki Deployment taşıyamaz ve tek bir docker-compose dosyası api adlı iki servis taşıyamaz.
Üretilen ileti:
multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (birden fazla katkıda bulunan aynı dağıtım yolunda bir örnek kimliğini paylaşıyor: dağıtım yolu ve sağlayıcı bu düğümü zaten içeriyor; bileşen örnek kimlikleri bir birleştirme grubu içinde benzersiz olmalıdır)
Nasıl düzeltilir: Aggregate’teki çakışan bileşenlerden birini yeniden adlandırın ya da her bileşen örneği kendi birleştirmesine düşsün diye iki sınırı ayrı directory: yollarına bölün.
Two contributors write the same output path (İki katkıda bulunan aynı çıktı yoluna yazıyor)
Tek bir birleştirmeye katkıda bulunan iki taraf aynı çıktı yolunda bir dosya üretir. Bu, yukarıdaki örnek kimliği çakışmasından farklıdır: bileşenler farklı adlandırılmıştır ve birleştirme onları ayırt edebilir — tek bir yola düşen, onların ürettiği dosyalardır. En çok, bir provider’ın her katkıda bulunanın çıktısını bileşen başına bir konum altında değil yan yana yazdığı durumlarda olur; böylece Recipes’i aynı dosya adını üreten iki bileşen (örneğin ikisi de main.tf adlı iki artifacts: girdisi) tek bir yolda buluşur. Birleştiricinin kendi çıktısı da bir katkıda bulunanın dosyasıyla aynı şekilde çakışabilir.
Aynı dosya adını üreten iki katkıda bulunanın çakışıp çakışmayacağı, provider’larının onları nereye yerleştirdiğine bağlıdır. Her katkıda bulunanı birleştirmede kendi konumu altına yerleştiren bir provider, aynı adlı iki dosyayı ayrı tutar; katkıda bulunanları yan yana yazan bir provider tutmaz. Karşılaştırma, katkıda bulunanın ürettiği ad üzerinden değil, bir dosyanın yazılacağı son yol üzerinden yapılır; bu nedenle iç içe durum raporlanmaz.
Derleme, iki dosyadan birini yazıp diğerini atmak yerine durur. Doğru bir sessiz çözüm yoktur: dosyalardan birini yeniden adlandırmak ya da ona sonek eklemek kimsenin yazmadığı bir ad uydurur, içeriklerini birleştirmek ise kimsenin yazmadığı bir belge uydurur. Her çakışan yol raporlanır ve ona yazan her katkıda bulunan adlandırılır; böylece tek bir derleme size çakışmaları tek tek değil, tablonun tamamını gösterir.
Üretilen iletiler. Her çakışan yol için bir bulgu raporlanır — çakışmanın gerçekleştiği birleştirmeyi kaç sınır beslemiş olursa olsun bir kez — böylece katkıda bulunanları iki yolda buluşan bir derleme size ikisini de bildirir ve hiçbir çakışma iki kez raporlanmaz:
assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (birleştirilmiş çıktı çakışması: iki katkıda bulunan aynı çıktı yoluna yazıyor)
Her katkıda bulunan ne olduğuna göre adlandırılır; adının nerede yazıldığını da bu söyler: bir bileşen örneği için component <name>, bir sınıra eklenmiş bir feature için feature <name> ve birleştirmenin kendi birleştirilmiş çıktısı için the <provider> assembly. Katkıda bulunanlar ad sırasıyla listelenir; böylece cümle aynı girdinin her derlemesinde aynıdır.
Bir Recipe’in sınırın paylaşılan çıktısına kattığı bir dosya da bu kurala tabidir. Bir Recipe’in boundary: bloğu dosyalarını provider’ın kendi birleştirilmiş çıktısının yanına, dosya adı başına bir kez yazar. Tek bir adı aynı baytlarla bildiren birkaç bileşen tek bir dosyadır ve asla çakışmaz; adı farklı baytlarla bildirmek burada çakışır ve dosyayı ve onu bildiren her bileşeni adlandırır; provider’ın birleştirmesinin kendisinin yazdığı bir ad da öyle — örneğin terraform için aggrega.modules.tf; bu, katkıda bulunanlar arasında the terraform assembly adını verir. Birkaç bileşenin aynı biçimde bildirdiği ve birleştirmenin kendi dosyasıyla buluşan bir dosya, hepsiyle birlikte component <name-1> and component <name-2> olarak adlandırılır.
Birleştirmeyi besleyen sınırlar da adlandırılır ve tek biri seçilmek yerine listelenir. directory: bildirimleri aynı sonuca değerlendirilen sınırlar tek olarak birleştirilir ve bir çakışmadaki hiçbir şey, buluşan katkıda bulunanların hangisinde bildirildiğini söylemez — bu nedenle bulgu size, bildirimi onları ayırabilecek her sınırı verir ve hiçbiri için hatanın o olduğunu ileri sürmez. Bulgu aynı nedenle Release belgesinin bütününe karşı raporlanır: içindeki tek bir sınırı adlandırmak sizi yola hiçbir şey katmamış olabilecek bir belgeye gönderirdi.
Birden fazla yol çakıştığında, bulgular ortak noktalarını belirten bir rapor altında birlikte gelir:
assembled output paths written by more than one contributor (birden fazla katkıda bulunan tarafından yazılan birleştirilmiş çıktı yolları)
Nasıl düzeltilir: üretilen dosyayı denetiminizdeki Recipe’te — bir artifacts: anahtarı, bir boundary: bloğunun anahtarı ya da bir Workload çevirisinin türettiği dosya adı — yeniden adlandırın; böylece ikisi artık buluşmaz. İki Recipes tek bir paylaşılan dosya bildiriyor ve aynı yapılandırmayı kastediyorsa, bildirimlerini bayt bayt aynı yapın. İki katkıda bulunan gerçekten ayrı çıktılara aitse, her biri kendi başına birleştirilsin diye sınırlarına farklı directory: yolları verin.
The same name is derived more than once inside the output (Aynı ad çıktı içinde birden fazla kez türetiliyor)
Tek bir birleştirme, ürettiği dosyaların içindeki bir şey için, yalnızca bir tanesine yer olan bir yerde aynı adı iki kez kullanmış olur. Bu iki yolla olur: iki katkıda bulunan aynı adı türetir ya da tek bir katkıda bulunanın kendi çıktısı o adı iki kez taşır. Bu, yukarıdaki iki çakışmadan farklıdır: iki katkıda bulunan söz konusu olduğunda bileşenler farklı adlandırılmıştır ve dosyaları farklı yollara düşer; dolayısıyla birleştirmenin biçiminde yanlış bir şey yoktur — sorun içerikteki bir addır; örneğin bir hedefin tek bir kaynağı adreslemek için kullandığı tanımlayıcı ya da bir çıktının başka birinin başvurması için altında yayımlandığı ad.
Hangi adların karşılaştırılacağı, provider’ın bir birleştirmenin çıktısıyla ne yaptığından çıkar. Provider bu çıktıyı tek bir belgede birleştirdiğinde — tek bir yığın şablonu, tek bir compose dosyası — o tek belgenin içindeki adlar birbiriyle karşılaştırılır ve çıktısı kendine ait ayrı dosyalar olarak yazılan bir katkıda bulunan bunun dışında kalır. Onun adları başka kimseninkiyle buluşmaz; bu nedenle aralarında hiçbir şey durmaz ve yeniden adlandırabileceğiniz hiçbir şey bunu değiştirmez. Provider bunun yerine her katkıda bulunanın çıktısını kendine ait dosyalar olarak yazdığında — bir chart render’ı, bir manifest kümesi — birleştirmeye katkıda bulunan her taraf diğer her biriyle karşılaştırılır; çünkü böyle bir çıktıdaki bir ad, herhangi bir dosyanın içinde değil, bu dosyaları bir küme olarak okuyan her şey genelinde benzersizdir.
Bir FeatureRecipe’in kendi kaynakları, ev sahibi bileşeninkiler gibi hareket eder; çünkü bir ek, ev sahibinin ait olduğu birleştirmeye katkıda bulunur. Bu nedenle provider birleştirdiğinde, bir ekin adları ev sahibi bileşeninkilerle ve diğer her ekinkilerle, tıpkı iki bileşenin adları gibi karşılaştırılır: hepsi tek belgenin içine düşer ve eşit iki addan biri orada diğerinin yerini alır. Provider birleştirmediğinde, ekin kaynakları eklendiği bileşeni adlandıran bir dizinin altına yazılır ve adları yine birleştirmeye katkıda bulunan her tarafla karşılaştırılır — bir küme genelinde benzersiz olması gereken bir kaynak kimliği de burada yakalanır. Dolayısıyla karşılaştırma her ikisinde de aynıdır; farklı olan yalnızca yerinden edilecek adın nerede durduğudur.
Durmanın bir yarısı tüm bunlardan etkilenmez: tek bir katkıda bulunanın kendi çıktısının bir adı iki kez taşıması. Bu, tek bir katkıda bulunanın yazdığı çıktının içinde iki kez kullanılan bir addır; bu nedenle o çıktı nereye yazılmış olursa olsun durur ve ayrılması gereken iki şey her zaman onun içindedir.
Bu tür adların çoğu, bileşen örneğinden ve kaynaktan türetilmiş, provider’ın kendi adlarıdır; bu nedenle iki bileşen, türetildikleri parçalar örtüştüğünde aynı ada varabilir — ve tek bir bileşen de kendi kaynaklarından ikisi örtüşen parçalardan oluşturulduğunda aynı yolla aynı ada iki kez varabilir. Ad dosyanın kendi baytlarında bulunduğundan birleştirme onu göremez: provider türettiği adları raporlar, derleme de onları karşılaştırır.
Bir ad türü provider’ın değil derlemenin kendisinindir ve aynı şekilde raporlanır: bir FeatureRecipe’in ürettiği her kaynağın etiketlendiği ve çıktınıza aggrega.ai/component-id etiketi olarak ulaşan kimlik. Bu, component-id ad türü altında raporlanır; böylece aynı dizgeyi kendi üretilmiş çıktınızda bulabilirsiniz. Bir FeatureRecipe kaynaklarını sentezlediğinde, bu kimlik aynı zamanda onlara verilen addır; yazarının sağladığı bir chart’ı ya da parçayı render ettiğinde ise o render’ın içindeki adlar ev sahibi bileşeninkiler olarak kalır ve kimliği yalnızca etiketler taşır.
Bir bileşene eklenmiş bir feature için kimlik, sabit bir başlangıcın ardından, feature’ın eklendiği bileşenden ve features: altına yazdığınız anahtardan oluşturulur. Ev sahibi bileşen değerin bir parçasıdır; çünkü birkaç bileşene eklenmiş tek bir feature adı her birinde ayrı bir kaynak kümesi üretir ve her kümenin kendine ait bir kimliğe ihtiyacı vardır.
Bir sınıra eklenmiş bir feature için kimlik, kendine ait bir başlangıcın ardından, feature’ın adından ve sınırın yolunun her bölümünden oluşturulur. Her iki durumda da değiştirme değil oluşturma yapılır: etiket alfabesinin kabul etmediği bir karakter değiştirilmek yerine açıkça yazılır ve parçalar, yazılmış hiçbir parçanın içeremeyeceği bir dizi ile birleştirilir; böylece ayırt edebildiğiniz iki ek her zaman iki kimliğe varır. Geriye kalan tek durum uzunluktur: bir etiket değeri için fazla uzun olan oluşturulmuş bir kimlik, tamamının bir özeti etrafında kısaltılır ve kısaltılmış iki kimlik ilke olarak buluşabilir. Bu durma, adları karşılaştırılan iki katkıda bulunan arasındaki böyle bir buluşmayı raporlar; tek bir bileşendeki iki ek de, ev sahiplerinin provider’ı onları birlikte birleştirdiği her yerde böyle iki katkıda bulunandır. Her birinin nasıl oluşturulduğu için ../providers/well-known-annotations.md sayfasına bakın.
Bir Kubernetes render’ı kendine ait bir tür raporlar: kendi render’ının ürettiği her kaynağın metadata.name alanında taşıdığı ad. Böyle bir adın tüm çıktı genelinde değil, kendi kind türü içinde — ve kümenin ad alanlarında tuttuğu bir tür için kendi ad alanı içinde — benzersiz olması gerekir; bu nedenle ad türü, bunlardan hangisiyle sınırlandığını söyler. resource-names ile başlar, ardından kaynağın kind değerini ve kaynağın düştüğü ad alanını taşır; bu, kaynağın kendisi için adlandırdığı ad alanı ya da hiçbirini adlandırmıyorsa sınırın açıklamayla işaretlendiği ad alanıdır. Yani resource-names:Service--default, default içine düşen Service’lerin adlarıdır. Kubernetes API’sinin her ad alanının dışında tuttuğu bir tür — bir ClusterRole, bir StorageClass, bir CustomResourceDefinition — ve aynı render’daki bir CustomResourceDefinition öğesinin Cluster kapsamıyla bildirdiği özel bir tür, belgesi hangi ad alanını yazarsa yazsın yalnızca kind değerini taşır: resource-names:ClusterRole, çıktının taşıdığı her ClusterRole’ün adlarıdır. Harfler ve rakamlar dışındaki her şey değiştirilmek yerine açıkça yazılır ve iki parça, yazılmış hiçbir parçanın içeremeyeceği bir dizi ile birleştirilir; böylece iki farklı çift asla tek bir ad türüne varmaz ve tek başına bir tür, bir tür ile bir ad alanının ad türüne asla varmaz. Bir Service ile bir Deployment aynı adı paylaşabilir ve iki ad alanı, ad alanlı bir türün tek bir adını birbirinden bağımsız olarak tutar; bu nedenle bunların hiçbiri durmaya yol açmaz. Adın kendisi tam olarak chart’ınızın yazdığı biçimde raporlanır; bu da onu şablonlarınızda aranacak dizge yapar.
Dolayısıyla tek bir çıktıya katkıda bulunan ve her biri küme genelindeki bir nesneyi aynı ad altında yazan iki taraf, Release onları iki ad alanına yerleştirse bile durur; çünkü ikisini uygulamak o tek nesneyi iki kez yazar. Böyle bir nesneyi iki farklı ad alanı altında yazan ve render’ın iki dosya olarak ürettiği tek bir chart ise, adı iki kez taşıyan tek bir katkıda bulunan olarak durur. Render’daki hiçbir şeyin sınıflandırmadığı bir tür — CustomResourceDefinition öğesini render’ın üretmediği özel bir tür ya da hiçbir apiVersion adlandırmayan bir belge — ad alanlı bir tür gibi kendi ad alanı içinde karşılaştırılır; çünkü render’daki hiçbir şey kümenin onu bir ad alanının dışında tuttuğunu söylemez. Bu nedenle böyle bir nesneyi iki ad alanında yazan iki katkıda bulunan buluşmaz.
Adlar tek bir çıktıya katkıda bulunanlar arasında karşılaştırılır, asla iki çıktı arasında değil. Her birinin kendine ait bir dizini olduğunda — adlandırdığı bir dizin ya da hiçbir directory: adlandırmayan her sınıra verilen dizin — iki sınır iki çıktıdır ve bir derlemedeki hiçbir şey, iki çıktının tek bir kümeye mi yoksa ikiye mi uygulandığını söylemez: iki kümenin her birine gönderilen bir operatörün CustomResourceDefinition öğesi, iki çıktıdaki aynı addır ve doğrudur. Dolayısıyla her biri küme genelindeki bir nesneyi aynı ad altında yazan iki sınır, ikisi de tek bir kümeye uygulansa bile derlenir; uygulanıyorlarsa nesneyi yalnızca birinden üretin.
Bu durdurmaya en sık ulaşan düzen, tek bir bileşene eklenmiş ve her biri yazarının sağladığı bir chart teslim eden iki Features’tır. Her iki chart da aynı sürüm adına göre işlenir — host bileşenin adına; böylece bir chart eklemek, yazarının zaten bildirdiği ve dağıttığı kaynakları yeniden adlandırmaz — ve bir kaynağı sürüm adına göre adlandırmak, bir chart’ın en sık yaptığı şeyler arasındadır. Çıktının biçiminde yanlış bir şey yoktur: iki kaynak yalnızca tek bir ad taşır. Bileşenin sağlayıcısı ayrık belgeler yazdığında her ekleme kendine ait bir dizinin altına yazar ve ikisini birden uygulamak, en son hangisi uygulandıysa onu bırakır; grubunu tek bir belgede birleştirdiğinde ise her iki ekleme o belgeye katkıda bulunur ve iki addan biri belgenin içinde diğerinin yerini alır. Denetiminizdeki chart’ta kaynağı yeniden adlandırın ya da ona iki eklemeyi birbirinden ayıran bir şey taşıyan bir ad verin — ve şablona ulaşması gereken eklemedir, çünkü her iki chart da host’un sürüm adına göre işlenir; dolayısıyla yalnızca eklemeyi yeniden adlandırmak hiçbir şeyi değiştirmez. .attachment_name değerini FeatureRecipe’in valuesMapping: alanı aracılığıyla chart’a geçirin ve onu, chart’ın kaynak adlarının oluşturulduğu kendi değerlerinden hangisiyse ona atayın.
İkinci bir düzen aynı durdurmaya iki yerine tek bir Feature ile ulaşır: şablonu bir kaynak adını sabit değer olarak yazan ve iki bileşene eklenmiş bir chart. Her host onu kendine ait bir sürüm adıyla işler; dolayısıyla iki kopyanın tek bir ad taşımasının tek nedeni sabit değerdir — kaynağı .Release.Name değerine göre adlandırın, host yeniden ada dahil olur; kaynak adlarını sürüm kimliğinden oluşturan bir chart zaten bunu yapar.
Üçüncü bir düzen, aynı biçimin bir yazım yüzeyi daha içeride olanıdır: kaynaklarını bir chart yerine artifacts: aracılığıyla teslim eden, tek bir ad altında iki bileşene eklenmiş ve gövdesi bir kaynak adını sabit değer olarak yazan bir FeatureRecipe. Her eklemenin çıktısı kendi host’unu adlandıran bir dizinin altına düşer; böylece yayılan yollar farklıdır ve çıktının biçiminde yanlış bir şey yoktur — ancak her iki gövde de aynı adı taşır ve ikisini birden uygulamak, en son hangisi uygulandıysa onu bırakır. Bir artifacts gövdesindeki ad, bir chart’ın işlediği ad ile tam olarak aynı biçimde karşılaştırılır: ikisi aynı kümedeki aynı kaynağı tanımlar, dolayısıyla adın nereden geldiği, ikisi birden uygulandığında olan şeyi değiştirmez. Bu yorum, iki adın birlikte okunmasına dayanır; bu da bir sağlayıcının her katkıda bulunanın çıktısını bir hedefin tek bir küme olarak okuduğu dosyalar şeklinde yazdığı yerde olur. Sağlayıcı bunun yerine bir derlemenin çıktısını tek bir belgede birleştirdiğinde, her eklemenin dosyaları o belgenin dışında kalır ve bunlardan birinin içindeki ad onunla sınırlıdır; dolayısıyla bu tür iki ekleme hiçbir zaman karşılaşmaz ve derleme devam eder.
Her ad raporlanmaz; dolayısıyla durmayan bir derleme, çıktısının sonunda taşıyacağı her adın karşılaştırıldığını kanıtlamış olmaz. Adlandırılması kümeye bırakılan bir kaynak — name yerine generateName bildiren bir kaynak — henüz bir ad taşımaz, dolayısıyla raporlanacak bir ad yoktur. Bir denetleyicinin daha sonra okuması için başka bir alana yazılan ad da bir kaynak adı değildir, dolayısıyla onu hiçbir şey karşılaştırmaz. Her iki sınır da yayılan belgenin okunmasının özellikleridir; dolayısıyla ikisi de bir artifacts gövdesine, işlenmiş bir chart şablonuna uygulandıkları gibi aynen uygulanır.
Bir artifacts: gövdesi bir şablondur; dolayısıyla içinde her host için farklı olması gereken bir ad, sabit değer olarak yazılmak yerine oluşturulur. .context.rendered_name, host bileşenin kendi sağlayıcısının ona verdiği addır — helm altında, bir Kubernetes adının izin verdiği karakterlerle yazılmış sürüm adı — ve .attachment_name, onu altına eklediğiniz anahtardır; dolayısıyla {{ .context.rendered_name }}-{{ .attachment_name }} bir kaynağa her host’ta ve her ekleme altında kendine ait bir ad verir. Sağlayıcısı böyle bir ad raporlamayan bir host’ta adı bunun yerine host’un kimliği olan .context.instance_id değerinden oluşturun. Yazılmış tek bir gövde, eklendiği her host’a içindeki adlar neyse onlarla ulaşır ve bir sabit değer hepsinde aynıdır — bu yüzden kümede benzersiz olması gereken bir ada bu biçimi verin.
Bir adın anlamı hiçbir şekilde yorumlanmaz — raporlanan iki ad ya aynı metindir ya da değildir — bu yüzden aynı rapor, kim türetmiş olursa olsun her ad türünü kapsar.
Bir ad, tek bir bileşen için birden fazla raporda görünebilir, çünkü bir bileşenin her parçası işlendikçe raporlanır. Bu, iki kez kullanılan bir ad değil, ait olduğu her raporda adı geçen tek bir kaynaktır ve durdurmaya yol açmaz. Durduran şey, tek bir ad iki kez taşıyan tek bir rapordur, çünkü o rapor adın gerçekten iki kez kullanıldığı çıktıyı tanımlar.
Bu yorum, neyin tek bir katkıda bulunan sayıldığına bağlıdır ve component-id türü için yanıt, bileşen ya da üzerinde bulunduğu sınır değil, eklemedir. Bir ekleme, onun için yazdığınız her iki koordinatla tanımlanır — eklendiği bileşen ile features: altındaki anahtar, ya da sınır yolu ile o sınırdaki ad — dolayısıyla tek bir bileşendeki iki ekleme, farklı bileşenlerdeki iki ekleme gibi tam olarak iki katkıda bulunandır ve iki sınırda yazılmış tek bir feature adı, ad her birinde aynı olsa da iki katkıda bulunandır. İki katkıda bulunan olmak, bu düzenlerin her birinde kimliklerini karşılaştırılabilir kılan şeydir; ikisinin hiç karşılaştırılıp karşılaştırılmadığı ise buradaki diğer her ad ile aynı kurala uyar; dolayısıyla sağlayıcının birleştirdiği yerde, çıktısı kendine ait ayrı dosyalar olarak yazılan bir ekleme birleştirilmiş belgenin dışında kalır ve yalnızca kendisiyle karşılaştırılır. Bu nedenle tek bir kimliğe ulaşan iki ekleme, çıktılarının birbirine ulaşabildiği her yerde durdurmaya yol açar ve her bulgu iki koordinatını da adlandırır; böylece hangi iki şeyi ayırmanız gerektiğini anlayabilirsiniz. Her iki koordinat da oluşturulan değerin parçası olduğundan, birbirinden ayırt edebildiğiniz iki ekleme sığan her uzunlukta iki kimliğe ulaşır — dolayısıyla bu durdurmaya ulaşan düzen, hedefi için fazla uzun bir değerin kısaltıldığı ve kısaltılmış iki değerin karşılaştığı düzendir. Kısaltılmış iki kimlik karşılaştığında ve çıktıları birbirine ulaşamadığında — birleştiren bir sağlayıcı altında, tek bir bileşende, her biri kendine ait ayrı dosyalar olarak yazılan iki ekleme — onları hiçbir şey karşılaştırmaz ve iki kaynak kümesi aralarında tek bir aggrega.ai/component-id taşır.
Bir düzen açıkça belirtilmeye değer, çünkü durdurmaya yol açması gerekiyormuş gibi görünür ama yol açmaz: bir feature’ı iki bileşende aynı ad altında eklemek tamamen desteklenir ve yeniden adlandırma gerektirmez. Bileşen, oluşturulan değerin parçasıdır; dolayısıyla api üzerindeki metrics ve web üzerindeki metrics iki kimliğe ulaşır ve her bileşenin kaynakları kendine ait bir kimlik alır — bu önemlidir, çünkü tasarımı gereği birçok bileşende tek bir ekleme adı üreten bir kademe, yazara yazacak başka bir ad bırakmaz. Bir FeatureRecipe’in kaynak teslim ettiği her yol, yaydığı şeye kimliğini koyar; buna yalnızca bir kaynağı vendor’layıp olduğu gibi işleyen yol da dahildir; dolayısıyla bunların her biri karşılaştırılır; FeatureRecipe’i hiçbir şey yaymayan bir feature’ın karşılaştırılacak bir şeyi yoktur.
Derleme, birini tutup diğerini atmak yerine durur. Doğru bir sessiz çözüm yoktur: ilkini tutmak, bildirdiğiniz bir kaynağı çıktıdan tamamen düşürür ve derlemenin başarı raporlamasına neden olur; düşürülen kaynağa başvuran her şey de sessizce onun yerine kalan kaynağa çözümlenir. Çakışan her ad, ne tür bir ad olduğuyla ve onu türeten her katkıda bulunanın adıyla birlikte raporlanır — böylece tek bir derleme size çakışmaları tek tek değil, tüm tabloyu birden gösterir. Kendi çıktısı adı iki kez taşıyan bir katkıda bulunan, adı birden fazla kez türetmiş olarak adlandırılır; bu da size ayırmanız gereken iki şeyin iki bileşen arasında değil, o tek bileşenin içinde olduğunu söyler.
Yayımlanan iletiler. Çakışan her ad için katkıda bulunan başına bir bulgu raporlanır; böylece adı türeten her katkıda bulunan, tek bir iletinin içindeki bir listeye katlanmak yerine ayrı ayrı adlandırılır. Adı iki katkıda bulunan türettiyse en az iki bulgu vardır ve bunlar, ortak noktalarını belirten bir raporun altında birlikte gelir:
dispatch groups whose contributors derive one name more than once in one key space (katkıda bulunanları tek bir anahtar uzayında bir adı birden fazla kez türeten dağıtım grupları)
Her bulgu; adı, adın türünü, adı türeten katkıda bulunanı ve çıktılarının birleştiği derlemenin sağlayıcısını ve yolunu belirtir:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (türetilmiş ad çakışması: bir ad, tek bir anahtar uzayında birden fazla kez türetiliyor (anahtar uzayı, bileşen tarafından türetildi, sağlayıcı, dağıtım yolu))
Katkıda bulunan, ne olduğuna göre adlandırılır ve adının nereye yazıldığını da bu söyler: bir bileşen örneği için derived by component, bir sınıra eklenmiş bir özellik için derived by feature.
Katkıda bulunanın kendi adı onu tek başına tanımlamadığında ikinci bir koordinat eklenir; bunun hangisi olduğu türe bağlıdır. Bir sınıra eklenmiş bir özellik, sınırın yolunu taşır, çünkü tek bir özellik adı birden fazla sınırda yazılmış olabilir:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (türetilmiş ad çakışması: bir ad, tek bir anahtar uzayında birden fazla kez türetiliyor (anahtar uzayı, özellik tarafından türetildi, sınıra eklendi, sağlayıcı, dağıtım yolu))
Bir bileşen, render’ı adı türeten eklemenin anahtarını taşır, çünkü bir bileşen yazdığınız her anahtar için bir ekleme taşır:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (türetilmiş ad çakışması: bir ad, tek bir anahtar uzayında birden fazla kez türetiliyor (anahtar uzayı, bileşen tarafından türetildi, ekleme taşıyor, sağlayıcı, dağıtım yolu))
Bir bileşenin kendi render’ı — sağlayıcısının eklemelerinden biri için değil, bileşenin kendisi için türettiği bir ad — ikinci bir koordinat taşımaz; bu nedenle bulgu bileşenin adıyla biter.
Tek bir katkıda bulunanın kendi çıktısı adı iki kez taşıdığında tek bulgu o katkıda bulunandır; bu nedenle üstünde bir rapor olmadan tek başına gelir — ve başka bir katkıda bulunanla karşılaşmış olarak değil, adı birden fazla kez türetmiş olarak adlandırılır:
derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (türetilmiş ad çakışması: bir ad, tek bir anahtar uzayında birden fazla kez türetiliyor (anahtar uzayı, bileşen tarafından birden fazla kez türetildi, sağlayıcı, dağıtım yolu))
İkinci koordinat burada da yukarıdakiyle aynı koşullarda katkıda bulunanın ardından gelir; böylece tek bir eklemenin kendi çıktısındaki bir yineleme, yalnızca onu taşıyan bileşeni değil, o eklemeyi adlandırır.
Nasıl düzeltilir: iki katkıda bulunan adlandırıldığında, bunlardan birini Aggregate’te yeniden adlandırın; böylece ondan türetilen adlar diğerininkilerle artık eşleşmez. Ad türü component-id olduğunda her bulgu yeniden adlandırılacak şeyi zaten belirtir: carrying attachment "…", o bileşenin features: bloğundaki anahtardır; feature "…"attached at boundary "…" ise o sınırın features: bloğundaki addır. İki bulgu yalnızca belirttikleri sınır bakımından farklıysa, iki ekleme iki sınırda tek bir ad taşıyordur — bunlardan birini yeniden adlandırın ya da çıktıları artık birleşmesin diye iki sınıra farklı directory: yolları verin. İki ad derlemenin oluşturduğu adlarsa, ancak hedefe sığacak şekilde kısaltıldıktan sonra karşılaşmış olabilirler; bu nedenle kısaltmayı derlemeye bırakmak yerine adların oluşturulduğu parçaları kendiniz kısaltın. İki ad da açıkça ayarladığınız bir şeyden türetiliyorsa — Recipe’nin sağlayıcıya verdiği bir değer ya da sağlayıcının okuduğu bir annotation — bunun yerine ikisinden denetiminizde olanında onu değiştirin. İki katkıda bulunan gerçekten ayrı çıktılara aitse, sınırlarına farklı directory: yolları verin; böylece her biri kendi başına derlenir ve iki ad hiç karşılaşmaz. Tek bir katkıda bulunan adı birden fazla kez türetmiş olarak adlandırıldığında, çakışan iki şey de o tek bileşenin içindedir: Recipe’sinin ürettiği ve adları eşleşen iki kaynağı bulun ve bunlardan birinin adının neye göre verildiğini — altında bildirildiği anahtarı ya da oluşturulduğu bir değeri — değiştirin; böylece sağlayıcı her biri için farklı bir ad türetir. Ad türü tek başına küme kapsamlı bir tür olduğunda, örneğin resource-names:ClusterRole, adlandırılan belgeler hangi ad alanlarına yerleştirilmiş olursa olsun kümedeki tek bir nesneyi tanımlar: onu yalnızca tek bir katkıda bulunandan yayımlayın — chart’ının sunduğu bir değer aracılığıyla, örneğin tanımlarını kurmaya yönelik bir anahtar — ya da ikisinin iki ayrı nesne olması amaçlanıyorsa, denetiminizdeki chart’ta veya gövdede birine kendine ait bir ad verin; bunun için iki kez adlandırılan tek bir katkıda bulunan onu iki ad alanı altında yazar ve iki belgeden biri çıkarılması gerekendir.
An authored export name is one the build derives for a cross-stack reference (Yazılan bir dışa aktarma adı, derlemenin yığınlar arası bir başvuru için türettiği addır)
Bir cloudformation Recipe’inin Outputs: bloğu elle yazılmış CloudFormation’dır ve içindeki bir girdi bir Name: ile kendi Export: öğesini taşıyabilir; bu ad, birleştirilmiş yığına tam olarak yazıldığı gibi ulaşır. Bundan ayrı olarak, bir uses kenarı bir sınırdan diğerine geçtiğinde provider, tüketilen değeri release, sınır, bileşen ve sağlanan anahtardan türettiği bir ad altında bir Export ile birlikte bir yığın Output olarak yayımlar. Bu durdurma, ikisinin karşılaştığı yerde tetiklenir: yazdığınız ad, türetmenin aynı derleme için ürettiği adla aynıdır; bu nedenle yığın tek bir dışa aktarma adını iki yerden iki kez bildirir ve bir dışa aktarma adının benzersiz olması gerekir.
Durdurma, türetilmiş dışa aktarma adını oluşturulduğu dört parçayla birlikte verir; böylece onu hangi sınırlar arası başvurunun ürettiğini görebilirsiniz. Ayrıca bildiriminizin altında bulunduğu yığın çıktısını adlandırır ve bunu bir Recipe’in yazdığı değil, provider’ın birleştirdiği bir ad olarak işaretler; çünkü provider bu adı bileşeni ve girdiyi bir mantıksal kimliğin kabul ettiği harf ve rakamlara kodlayarak oluşturur, dolayısıyla ad ikisinin de yazıldığı dize değildir. Aranacak kısım dışa aktarma adıdır. Girdiniz onu durdurmanın yazdığıyla tam olarak aynı biçimde yazar; ikisini bir çakışma yapan da budur; dolayısıyla hem iletide hem de kendi dosyalarınızda görünen tek dize odur.
Karşılaştırma tek bir yığınla sınırlıdır: o yığının bildirdiği dışa aktarma adları, o yığına yayımlayan sınırlar arası başvurular için türetilen adlarla karşılaştırılır. İki yığın birbiriyle karşılaştırılmaz ve bir CloudFormation iç işlevi olarak yazılan bir dışa aktarma adı dağıtım zamanında çözümlenir; dolayısıyla karşılaştırılacak bir ad yoktur. Bir adın bir hesap ve bölgeye önceden dağıtılmış dışa aktarmalar arasında neyle karşılaştığı dağıtımın bir özelliğidir ve derleme bunu gözlemlemez.
Üretilen ileti. Koşul, hatanın türünü adlandırır ve provider’ın kendi cümlesi ne olduğunu söyler; çevreleyen rapor ayrıca bağlanan uses kenarını da adlandırır:
two things a plugin produced occupy one name in its output (bir plugin’in ürettiği iki şey çıktısında tek bir adı paylaşıyor)
cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (cloudformation-provider: sınırlar arası bir bağlantının türettiği bir dışa aktarma adı, aynı yığındaki başka bir Outputs girdisi tarafından zaten bildirilmiş: bağlantı, Release’in sınırındaki bileşenin sağlanan anahtarı için dışa aktarma adını türetiyor ve aynı yığının başka bir Outputs girdisi aynı dışa aktarma adını zaten bildiriyor; bu bildirim, bir Recipe’in yazdığı değil bu provider’ın birleştirdiği bir ad olan yığın çıktısının altında bulunuyor; gölgeleyen her Outputs girdisi dışa aktarma adını durdurmanın yazdığı gibi yazar, bu yüzden Recipe’lerinizde bu adı aramak girdiye ulaştırır; girdinin bildirdiği dışa aktarma adını yeniden adlandırın ya da o girdinin Export bloğunu kaldırıp dışa aktarmayı bağlantının yayımlamasına izin verin)
Nasıl düzeltilir: Recipe’lerinizde durdurmanın adlandırdığı dışa aktarma adını arayın (onu bildiren Outputs girdisi adı aynen yazar), ardından ya bu dışa aktarma adını artık eşleşmeyecek şekilde yeniden adlandırın ya da o girdinin Export: bloğunu kaldırıp dışa aktarmayı yığınlar arası bağlantının kendisinin yayımlamasına bırakın. Girdi, kenarın tükettiği değerin aynısını dışa aktarmak için varsa kaldırmak genellikle doğru adımdır: provider o değer için zaten bir Export yayımlar, dolayısıyla yazılan dışa aktarma hiçbir şey katmaz. Girdi değeri, onu sizin seçtiğiniz bir adla içe aktaran farklı bir tüketici için dışa aktarıyorsa, yazılan Export: öğesini koruyun ve bunun yerine yeniden adlandırın.
The output a cross-stack reference publishes on already carries an Export (Yığınlar arası bir başvurunun yayımladığı çıktı zaten bir Export taşıyor)
Bir uses kenarı bir sınırdan diğerine geçtiğinde provider, tüketilen değerin Export öğesini üreten bileşen ve sağlanan anahtar için birleştirdiği yığın çıktısında yayımlar; bu, bir cloudformation Recipe’inin Outputs: bloğu o anahtar altında bir girdi yazdığında ulaştığı çıktının aynısıdır. O çıktıda zaten bulunan bir Export:, yalnızca Name: değeri provider’ın türettiği adla tam olarak aynı olduğunda korunur: bu, aynı değere yönelik daha önceki bir yığınlar arası başvurunun zaten yayımladığı dışa aktarmadır; böylece her tüketici tek bir adı içe aktarır. Oradaki başka herhangi bir Export: derlemeyi durdurur; çünkü provider’ın dışa aktarmasını yazmak sizin yazdığınızın üzerine yazar, sizinkini korumak ise her tüketiciyi başvurunun hiç yayımlamadığı bir adı içe aktarır durumda bırakır.
Durdurma, o çıktıdaki dört Export: biçiminde tetiklenir:
farklı bir dize olan bir Name:;
dağıtım zamanında çözümlenen bir CloudFormation iç işlevi olarak yazılmış, dolayısıyla provider’ın neyi ifade ettiğini okuyamadığı bir Name:;
hiçbir şey adlandırmayan bir Export: bloğu;
blok yerine düz bir değer olarak yazılmış bir Export:.
Üretilen ileti. Koşul, hatanın türünü adlandırır ve provider’ın kendi cümlesi ne olduğunu söyler; çevreleyen rapor ayrıca bağlanan uses kenarını da adlandırır:
two things a plugin produced occupy one name in its output (bir plugin’in ürettiği iki şey çıktısında tek bir adı paylaşıyor)
cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (cloudformation-provider: sınırlar arası bir bağlantının dışa aktarmasını yayımladığı yığın çıktısı, bağlantının yazmadığı bir Export’u zaten taşıyor: bağlantı, Release’in sınırındaki bileşenin sağlanan anahtarı için dışa aktarma adını türetiyor ve bu provider’ın o anahtar ve bileşen için birleştirdiği yığın çıktısı ile ilgili bulunan durum belirtiliyor; o girdinin Export bloğunu kaldırın ve her tüketicinin içe aktardığı dışa aktarmayı bağlantının yayımlamasına izin verin)
<what-it-found>, yukarıdaki biçimlerin sırasıyla şunlardan biridir:
already declares the export name <name> (dışa aktarma adını zaten bildiriyor)
already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (dize olmayan bir dışa aktarma adını zaten bildiriyor; ad, dağıtım zamanında çözümlenen bir iç işlev olarak verilmiş, bu yüzden bu provider neyi ifade ettiğini okuyamıyor)
already carries an Export block declaring no export name (hiçbir dışa aktarma adı bildirmeyen bir Export bloğunu zaten taşıyor)
already carries an Export that is not a block, where CloudFormation expects one carrying a Name (CloudFormation’ın Name taşıyan bir blok beklediği yerde blok olmayan bir Export’u zaten taşıyor)
Nasıl düzeltilir: durdurmanın adlandırdığı bileşenin Recipe’inde, adlandırdığı sağlanan anahtar altında yazılmış Outputs girdisini bulun ve o girdinin Export: bloğunu kaldırın; yığınlar arası bağlantı bundan sonra her tüketicinin içe aktardığı dışa aktarmayı yayımlar. Değerin, bu derlemenin dışındaki bir tüketici için ayrıca kendi seçtiğiniz bir adla dışa aktarılması gerekiyorsa, o Export: öğesini farklı bir anahtar altındaki bir Outputs girdisine yazın: orada bir dışa aktarma adı, derlemenin türettiği bir ad olmadığı sürece desteklenir.
Birleştirilmiş bir helm-chart şemsiyesinde chart adı uyuşmazlığı
İki veya daha fazla sınır aynı helm-chart sağlayıcısı derleme yoluna katkıda bulunuyor, ancak etkin aggrega.ai/chart-name ek açıklamaları (sınır ek açıklama kademesi üzerinden çözümlenen) birbiriyle uyuşmuyor. Bir Helm şemsiye chart’ının tam olarak bir chart adı vardır; işleyici çakışan adaylardan birini seçemez.
Üretilen iletiler. Katkıda bulunan her sınır için bir bulgu raporlanır ve her bulgu o sınırın çözümlendiği değeri taşır; böylece uyuşmayan adlar tek bir yazdırılmış koleksiyon olarak değil, bulgu başına bir ad olarak gelir. Bulguların altında geldiği rapor, ortak noktalarını belirtir:
merged dispatch groups whose boundaries disagree on the assembly name (sınırları derleme adı üzerinde uyuşmayan birleştirilmiş dağıtım grupları)
Her bulgu, o sınırın çözümlendiği değeri, değerin okunduğu ek açıklamayı, sınırı, sağlayıcıyı ve birleştirildikleri yolu belirtir:
merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (birleştirilmiş yol derlemesinde çakışan derleme adı ek açıklama değerleri var)
Nasıl düzeltilir: katkıda bulunan her sınırda eşleşen bir aggrega.ai/chart-name ek açıklaması bildirin (katkıda bulunanlar ortak bir üst sınırı paylaştığında kademe mekanizması bunu tekrarsız kılar — üst sınırda bir kez bildirin) ya da her biri kendi şemsiye chart’ını alsın diye sınırları ayrı directory: yollarına bölün.
FeatureRecipe şablonu, kapsamının izin listesi dışındaki bir alana başvuruyor
executionScope: boundary içeren bir FeatureRecipe, sınır için bir kez çalışan bir şablonda — locals:, provides:, valuesMapping:, artifacts: alanlarında ya da bir işlem hattı adımının with: veya when: alanında — .context.instance_id, .context.inject veya .context.uses gibi yalnızca bileşen başına olan bir alana başvuruyor; bunlar sınır kapsamında anlamlı bir değeri olmayan alanlardır. Karşıt durum da geçerlidir: .boundary.* alanlarına başvuran bileşen kapsamlı bir FeatureRecipe (varsayılan) aynı doğrulayıcıda başarısız olur. Doğrulama, herhangi bir işleme başlamadan önce ayrıştırma zamanında ilgili kapsamın alan izin listesine karşı çalışır. Sınır kapsamlı bir FeatureRecipe’in injectMapping alanı burada denetlenmez: ekin ulaştığı her bileşen için o bileşenin bağlamında bir kez çalışır, dolayısıyla .context.* okur ve içindeki bir .boundary başvurusu yukarıdaki “Template references a root the render context does not define (Şablon, render bağlamının tanımlamadığı bir köke başvuruyor)” tarafından bildirilir.
Üretilen ileti:
FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (FeatureRecipe şablonu, executionScope: boundary ile yalnızca bileşen başına olan bir alana başvuruyor)
valuesMapping alanı .context.instance_id okuyan sınır kapsamlı bir FeatureRecipe şunu yazdırır:
[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")
Nasıl düzeltilir: şablonu kapsamın kullanılabilir alanlarına göre yeniden yazın ya da FeatureRecipe’in executionScope değerini değiştirin. Sınır kapsamlı FeatureRecipes .boundary.path, .boundary.boundary_name, .boundary.components, .boundary.*_uses_edges koleksiyonları, .boundary.labels, .boundary.annotations ve .boundary.feature_attachments alanlarına başvurur. Component kapsamlı FeatureRecipes .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations alanlarına başvurur. Her iki kapsam da .values, .infra, .locals, .provides, .steps ve .metadata alanlarını paylaşır. Bir Release parametresi bu yüzeyde kendi başına bir sütun değildir; bir FeatureRecipe şablonuna, ona başvuran bir values veya infra girdisi aracılığıyla ulaşır.
Kendine enjeksiyon değer şablonu düğümler arası verilere başvuruyor
Bileşen düzeyindeki bir inject:value: şablonu .context.inject veya .context.uses içinden veri çekiyor. Enjeksiyon hattı bu geçişin oluşturduğu şeydir — bir bileşenin kendi kendine enjeksiyon değerinin içindeki bir şablon ondan okuyamaz.
Bunun nedeni yüzeyin .context nesnesidir: instance_id, labels ve annotations taşır, başka hiçbir şey taşımaz. Dolayısıyla .context.inject ve .context.uses, bu yüzeyin bağlamının tanımlamadığı anahtarlardır ve başvuru, yukarıdaki “Template references a root the render context does not define (Şablon, işleme bağlamının tanımlamadığı bir köke başvuruyor)” olarak, ayrıştırma zamanında, hiçbir şey işlenmeden önce durur. Tanılama, şablonun ait olduğu mekanizmayı ve teslim anahtarını belirtir ve .context nesnesinin burada tanımladığı anahtarları listeler — böylece aynı rapor hem düğümler arası verilere gerçek bir erişim girişimini hem de {{ .context.nmae }} gibi basit bir yazım hatasını kapsar; ikincisi daha yaygın bir hatadır ve aksi halde hiçbir şey olarak işlenirdi.
Üretilen ileti — başvuru düzeyindeki ayrıntı; çevreleyen rapor ayrıca düğümü, mekanizmayı ve teslim anahtarını belirtir:
template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (şablon, işleme bağlamının tanımlamadığı bir köke başvuruyor)
Raporun her çerçevesi geliştirici alanındadır, çünkü bileşen düzeyindeki bir inject: bloğu Aggregate içinde yazılır.
Nasıl düzeltilir: bileşenler arası bağlantıyı bir uses[].inject girdisine taşıyın — düğümler arası bağlam orada kullanılabilir. Bileşen düzeyindeki kendine enjeksiyon value: şablonlarını bileşenin kendi values ve infra alanları, .context.instance_id / .context.labels / .context.annotations alanları ve .metadata ile sınırlı tutun.
Eksik şablon anahtarı — asimetrik politika
Eksik anahtarın nasıl ele alınacağı şablon yüzeyine bağlıdır. Boş bir işlemenin sınırlı bir yere düştüğü durumlarda — yazarın geri okuyabileceği bir manifest alanı gibi — eksiklik tolere edilir ve okuma hiçbir şey üretmez. Boş bir işlemenin bunun yerine yanlış bir yapı ya da yanlış bir karar üreteceği durumlarda ise yüzey, başvuruyu hiçliğe çözümlemek yerine reddeder.
Bir Aggregate içindeki parametre interpolasyonu — Aggregate’in kendi metninin taşıdığı {{ .parameters.<key> }} başvuruları — bu yüzeylerin en erkenidir: katalog çözümlenmeden önce ham belge üzerinde çalışır, bu nedenle politikası henüz başka hiçbir yüzeyin görmediği metne uygulanır. Release’in hiç doldurmadığı bir parametreye yapılan başvuru hiçbir şey olarak işlenir ve böyle bir okuma üzerindeki bir default borusu ya da bir if koruması, doldurulmamış parametre üzerinde nasıl davranacaksa tam olarak öyle davranır. Şablonun üzerinde yinelediği bir başvuru hiçbir şey olarak yinelemeye devam eder; isteğe bağlı bir liste üzerinde dolaşırken istenen de budur — ancak metin onu ayrıca yazdırıyorsa, aşağıdaki “A template reads and iterates a path that holds nothing (Bir şablon hiçbir şey içermeyen bir yolu okuyor ve üzerinde yineliyor)” bölümünde açıklandığı gibi durdurur. Üst öğesi bulunmayan bir başvuru — hiçbir db parametresinin doldurulmadığı yerde .parameters.db.host — yine de durdurur, çünkü içine inilecek bir şey yoktur ve bir üst öğe sağlamak, durmayı sessizce yanlış bir yapıtla takas etmek olurdu. Bir sınırın politika olarak değil, sınır olarak belirtilmesi yerinde olur: yüzeyin tanımlamadığı bir köke bağlanan başvuru hiçbir şey olarak işlenmek yerine olduğu gibi bırakılır; böylece interpolasyon uygulanmış belgeye şablon motorunun kendi yer tutucu metni olan <no value> olarak geçer. Bu yüzeyde hiçbir şey bunun üzerine durmaz; bu nedenle her parametre başvurusunu .parameters köküne bağlayın ve başıboş bir <no value> gördüğünüzde bunu yanlış yazılmış bir kök olarak okuyun.
Yol şablonları (Release sınırı directory: / subDirectory:) missingkey=error ile değerlendirilir. Yüzeyin onlara vermediği bir değişkene yapılan başvuru ayrıştırma zamanında durdurur — yukarıdaki “Path-template references a variable outside the allowlist (Yol şablonu izin listesi dışındaki bir değişkene başvuruyor)” bölümüne bakın — ve anahtarları bildirilmiş olan .manifest altında yanlış yazılmış bir anahtar da aynı şekilde durdurur. İzin verilen ancak değerlendirme zamanında tanımsız olan bir başvuru, örneğin Release’in sağlamadığı bir .parameters anahtarı, bir dizin yoluna sessizce boş bir dize işlemek yerine açık bir hata üretir.
assertions (bir Component, Feature, Recipe ya da FeatureRecipe üzerinde) missingkey=error ile değerlendirilir. Tanımsız bir anahtara yapılan başvuru; varlığı, örneği ve doğrulamayı adlandıran bir böyle-bir-anahtar-yok tanılamasıyla durdurur. Bir doğrulamayı güvenilir kılan bu katılıktır: başvurusu boş bir değer olarak işlenen bir yüklem hiçbir şeyle karşılaştırılır ve geçer; böylece tek bir yazım hatası, doğrulamanın uygulamak için yazıldığı kuralı sessizce devre dışı bırakırdı. Çıplak başvuru herhangi bir yedek değer çalışamadan önce durdurduğu için, düz bir default bu yüzeyde isteğe bağlı alan için bir yedek sağlamaz — başvuruyu hasKey ile koşula bağlayın ya da varlık denetimini doğrudan yapan optional yardımcısını kullanın. Anahtarı index üzerinden okumak da bir yedek sağlamaz: index, haritanın içermediği bir harita anahtarında anahtarı adlandırarak durdurur.
Değer şablonları (Recipe valuesMapping, locals: ve provides: girdileri, artifacts: gövdeleri, Workload gövdeleri, FeatureRecipe injectMapping ve pipeline.with ile bileşen düzeyindeki öz-enjeksiyon value: şablonları) missingkey=zero ile değerlendirilir; bu nedenle tanımsız bir anahtara yapılan başvuru derlemeyi durdurmaz — okuma hiçbir şey üretmez ve yapıta ulaşan da hiçbir şeydir. Bu yüzeyde yine de durduran şey, yazarın hiç sağlamadığı bir kapsayıcının içinden inen bir başvurudur — hiçbir tls yazılmamışken .values.tls.ca — çünkü içine inilecek bir şey yoktur. Yalnızca kapsayıcılarının tümü mevcut olan bir başvurunun son anahtarı hiçbir şey olarak işlenir. Bağlamın tanımladığı ancak içinde hiçbir şey bulunmayan bir üst düzey alan — hiçbir şey sentezlemeyen bir Recipe’deki .workload, eklemesi olmayan bir bileşendeki .features — bütün olarak okunduğunda aynı şekilde hiçbir şey olarak işlenir. Bir başvuru nasıl yazılırsa yazılsın tek bir başvurudur: .values.list, $.values.list ve (.values).list aynı anahtarı adlandırır; bu nedenle onu bir yazımla dolaşmak tüm yazımlarla dolaşmaktır ve parantez içine alınmış bir sütundan okunan bir anahtar, doğrudan yazımla tam olarak aynı şekilde işlenir ya da durdurur. Şablonun üzerinde yinelediği bir anahtar ayarlanmamışsa hiçbir şey olarak yinelemeye devam eder; şablonun hem yazdırdığı hem de üzerinde yinelediği bir anahtar ise ayarlanmamışsa durdurur — aşağıdaki “A template reads and iterates a path that holds nothing (Bir şablon hiçbir şey içermeyen bir yolu okuyor ve üzerinde yineliyor)” bölümüne bakın. Koruma beklendiği gibi çalışır: {{ .values.optional_field | default "fallback" }} yedek değeri gerçekten sağlar, çünkü ayarlanmamış bir değer default için boş, if için yanlış sayılır. Yok-ile-sıfır ayrımına — “anahtar yok” ile “anahtar var ve boş” durumlarını ayırt etmeye — ihtiyaç duyan yazarlar templates/sprig-functions.md içinde belgelenen optional yardımcısını kullanır ve belirli bir anahtarı her şablonda tek bir yolla okur: aynı şablonun .values.<key> olarak da okuduğu bir anahtar mevcut sayılır, bu nedenle optional yedek değer yerine anahtarın boş değerini bildirir. Bu politikanın kapsamadığı şey index üzerinden yapılan okumadır: bir haritayı içermediği bir anahtarla dizinlemek, her yüzeyde olduğu gibi burada da anahtarı adlandırarak durdurur — aşağıdaki “A template indexes a map with a key the map does not hold (Bir şablon bir haritayı haritanın içermediği bir anahtarla dizinliyor)” bölümüne bakın.
Bir source: koordinatı — bir Recipe ya da FeatureRecipe üzerindeki yapılandırılmış bir source: bloğunun şablonlu alanları (version, ref, chart, module_subdir) — missingkey=error ile değerlendirilir. Hiçbir şeyin sağlamadığı bir anahtara yapılan başvuru, hiçliğe çözümlenmek yerine kaynak alanını adlandırarak durdurur: boş bir sürüm ya da ref, yazarın adlandırdığından farklı bir yapıtı sabitlerdi ve sonraki her derlemenin yeniden ürettiği de bu sabitlemedir. Bu yüzey aynı zamanda kullanılabilir işlev kümesinin farklılaştığı ve bloğun kendi yazım sırasının reddettiği bir locals: başvurusunun herhangi bir şey değerlendirilmeden önce durdurduğu yerdir — aşağıya bakın.
Tipli parametre sözleşmeleri, eksik zorunlu parametre ve sözleşme ihlali durumlarını interpolasyon çalışmadan önce parametre sözleşmesi katmanında yakalar — yukarıdaki “Parameter type mismatch / contract violation (Parametre türü uyuşmazlığı / sözleşme ihlali)” bölümüne bakın.
Yardımcı kümesi değer şablonlarında, yol şablonlarında ve doğrulamalarda aynıdır: Sprig’in işlevleri ile Aggrega’nın kendi işlevleri (optional ve capitalizedWords). Sprig’in fail işlevi de bunlar arasındadır; bu nedenle bir değer şablonu, aşağıda “A value template failed while it ran (Bir değer şablonu çalışırken başarısız oldu)” bölümünde açıklandığı gibi derlemeyi kendi iletisiyle durdurabilir; doğrulama ise tam da bunun için yazılan yüzeydir, çünkü derlemeyi durdurmak onun tüm amacıdır. Bu üçü arasında farklı olan, eksik anahtar politikasıdır — optional bir yol şablonunda da kullanılabilir; orada katı politika önce devreye girmeden .parameters içinden bir anahtar okur. Bir source: koordinatının çözümlenmesi ise işlev kümesinin kendisinde farklılaşır ve aşağıda kendi alt bölümü vardır. Bir Aggregate içindeki parametre interpolasyonu yalnızca Sprig’in işlevlerini sunar; bu nedenle orada Aggrega yardımcılarının hiçbiri kullanılamaz. Koordinat ve interpolasyon da dahil olmak üzere bu yüzeylerin her birinde aynı şekilde okunan bir işlev vardır: index; okuduğu harita anahtarı içermediğinde anahtarı adlandırarak durdurur.
Bir yol şablonu eksikliğinin yazdırdığı ileti, o durumu belgeleyen girdinin, yukarıdaki “Path-template references a variable outside the allowlist (Yol şablonu izin listesi dışındaki bir değişkene başvuruyor)” bölümünün altında aktarılmıştır; bu nedenle burada yinelenmek yerine bir kez yazılmıştır.
Nasıl düzeltilir: yol şablonu eksikliklerinde alan adını path-template-variables.md içinde belgelenen izin listesindeki bir adla düzeltin. Bir doğrulama eksikliğinde başvuruyu düzeltin — raporların çoğu yanlış yazılmış bir anahtardır — ya da alan gerçekten isteğe bağlıysa onu hasKey ile koşula bağlayın veya optional yardımcısını kullanın; çıplak başvuruyu bir default içine sarmak durmayı ortadan kaldırmaz, çünkü başvuru yedek değer çalışmadan önce çözümlenir; onu index üzerinden okumak da kaldırmaz, çünkü index haritanın içermediği bir anahtarda durdurur. Boş işlemenin istenmediği değer şablonu eksikliklerinde optional yardımcısını kullanın ya da eksik anahtarı Aggregate üzerinde bir Release değeriyle tipli bir parameters.* bildirimi olarak, uses[].inject üzerinden bağlanan yukarı akıştaki bir Component’in provides: girdisi olarak ya da aynı varlık üzerinde bir locals: girdisi olarak sağlayın.
Resolving a source: coordinate registers a narrower function set (Bir koordinatın çözümlenmesi daha dar bir işlev kümesi kaydeder)
Yapılandırılmış bir source: bloğu, adlandırdığı yapıtın sabitlenebilmesi için çözümlenir ve bu çözümleme yalnızca Aggrega’nın kendi yardımcılarını kaydeder: optional ve capitalizedWords kullanılabilir, index de haritanın içermediği bir harita anahtarında tıpkı Recipe işlenirken olduğu gibi durur; Sprig’in işlevleri ise kullanılamaz. Bir Recipe veya FeatureRecipe’in şablon yazdığı yüzeyler arasında işlev kümesi farklı olan tek yüzey budur; bu nedenle aynı Recipe’in başka bir yerinde doğru işlenen bir ifade burada reddedilebilir. Daha dar küme bilinçli bir tercihtir: neyin sabitleneceğini yazarın sağladığı değerler ve altyapı belirler, Sprig’in işlevleri arasında ise saati, ortamı, rastgele bir kaynağı veya ağı okuyanlar bulunur.
Bir source: alanında ya da bu alanın okuduğu bir locals: girişinde bir Sprig işlevi çağırmak, ayrıştırma zamanında durdurur. Tanılamanın başında E0111 bulunur; tanılama girişi, onu okuyan source: alanını, çözümleyemediği işlevi ve bu yüzeyin kaydettiği yardımcıları adlandırır:
resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads (çözümle: şablon .spec.locals. konumunda ayrıştırılıyor, .spec.source. tarafından okunuyor: çözümle: kaynak şablonu ayrıştırma hatası (neden: şablon: .spec.locals.:1: işlev tanımlı değil); bir kaynak alanı ve okuduğu her locals girişi, kaynak çözümlenirken yalnızca Aggrega’nın kendi yardımcılarıyla (optional, capitalizedWords ve index) değerlendirilir, bir işlemenin eklediği Sprig işlevleriyle değil; değeri bu işlev olmadan yazın ya da değeri hiçbir kaynak alanının okumadığı bir locals girişine taşıyın)
İşlevi doğrudan çağıran bir source: alanı da aynı şekilde raporlanır; bu durumda yalnızca alan adlandırılır.
Kapsam, koordinatın okuduğu girişlerdir. Bir koordinatın çözümlenmesi, bir source: alanının okuduğu her locals: girişini ve böyle bir girişin sırayla okuduğu her girişi değerlendirir; başka hiçbirini değerlendirmez. Hiçbir source: alanının ulaşmadığı bir giriş, kaynak çözümlenirken değerlendirilmez, ayrıştırılmaz veya denetlenmez; bu nedenle işlemenin ihtiyaç duyduğu bir yerel değer (Sprig’in işlevleriyle aritmetik yapan ya da bir kaynağı .context.instance_id değerine göre adlandıran bir değer) yapıtın sabitlenmesini etkilemez; Recipe işlenirken değerlendirilir ve içindeki her hata o zaman raporlanır. Bir alanın hangi girişleri okuduğu metninden belirlenir; bu nedenle .locals değerini tek bir giriş adlandırmayacak şekilde okuyan bir alanda ({{ index .locals "version" }}, bloğun tamamının optional işlevine verilmesi ya da bir değişkene bağlanması) bunun yerine her giriş değerlendirilir ve bu yolla ulaşılan bir girişin tanılaması bunu belirtir: read by <field> yerine evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated yazar.
İki biçim bu yüzeyin dışında kalır ve bir Recipe’in hangisinde olduğunu bilmek, aynı ifadenin neden bir Recipe’te kabul edilip başka birinde reddedildiğini açıklar:
Düz bir dize olarak yazılmış bir source:, yani eşleme yerine bir URI veya yerel yol, olduğu gibi alınır; bu nedenle değerlendirilecek alanı yoktur ve locals: bloğu burada hiç çözümlenmez.
Hiç source: bildirmeyen bir varlık hiçbir koordinat çözümlemez; bu nedenle locals: bloğu yalnızca o varlığın kendi işlemesi için, tam işlev kümesinin geçerli olduğu yerde çözümlenir.
Başvuru sırası sözleşmesi, koordinatın okuduğu her giriş için burada da aynıdır. Bir koordinatın çözümlenmesi, değerlendirdiği her girişte bir işlemenin reddettiği başvuruların aynısını reddeder: bloğun kendisinden aşağıda bildirdiği bir kardeşi okuyan bir girişi ve bloğun bildirmediği bir anahtarı okuyan her şablonu. Her ikisi de yukarıda “locals: entry references a sibling defined later in the same block (Giriş, aynı blokta daha sonra tanımlanan bir kardeşe başvuruyor)” ve “locals: key does not exist (Anahtar mevcut değil)” altında belgelenen koşulları raporlar; hangi çözümleme önce ulaşırsa ulaşsın koşul da çözümü de aynıdır ve rapor, girişin hangi source: alanı için değerlendirildiğini adlandırır. Hiçbir source: alanının okumadığı bir girişteki hata, Recipe işlenirken aynı koşul altında reddedilir.
Bu yüzeyin gerçekten atladığı şey, bir koordinatın gerçekten çözümleyemeyeceği bir giriştir: yalnızca bir yapıt işlenirken var olan verileri okuyan bir giriş; bunun için var olduğu durum .context.instance_id değeridir. Böyle bir giriş atlanır; bu nedenle koordinatı böyle bir girişe yalnızca izlemediği bir dalda ulaşan bir Recipe yine de sabitlenir. Koordinatın kendisi bu girişe ihtiyaç duyduğunda çözümleme, source: alanını adlandırarak durur (bu yüzey için yukarıda açıklanan, başında E0110 bulunan eksik anahtar raporu) ve okuyamadığı anahtarın yanında bu girişin burada neden değer taşımadığını aktarır:
resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context") (çözümle: şablon .spec.source. konumunda değerlendiriliyor: çözümle: kilit zamanında kaynak şablonu değerlendirme hatası (neden: şablon: … haritada anahtar için giriş yok); .spec.locals. değerini okuyor, bu değer burada değerlendirilemedi (neden: şablon: … haritada anahtar için giriş yok))
Ne bir source: alanı ne de onun okuduğu bir locals: girişi .provides değerini okuyabilir. Bir locals: bloğu bir provides: bloğunu besler, asla tersi olmaz; bu nedenle bu yüzeyde .provides değerini okuyan bir şablon, hiçliğe çözümlenmek yerine olduğu gibi ters bir başvuru olarak reddedilir. Bu ret, sonraki bir aşamanın karşılayacağı kilit zamanı eksikliği değildir (hiçbir sıralama başvuruyu geçerli kılmaz); bu nedenle koordinat nerede çözümlenirse çözümlensin aynı şekilde raporlanır. Tanılamanın başında E0112 bulunur; tanılama alanı ya da girişi ve onu okuyan alanı adlandırır, başvurunun neyinin yanlış olduğunu söyler ve ifadenin bunun yerine okuyabileceği yüzeyi verir:
source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference) (.spec.source. konumundaki kaynak sürümü şablonu geçersiz bir ters başvuruya başvuruyor (locals provides’ı besler, asla tersi olmaz); yalnızca değerleri ve altyapıyı (ve bunlar üzerindeki yerel değerleri) okuyacak şekilde yeniden düzenleyin: çözümle: kaynak şablonu .provides’a başvuruyor (geçersiz ters başvuru))
Durmanın ortaya çıktığı yer: kilit dosyası doldurulurken veya yenilenirken; yani aggrega pull ya da onu dolduran bir derleme (--auto-pull, --upgrade veya çalışma alanının auto_pull ayarı) sırasında. Her hata, neyin yanlış gittiğinin koduyla başlayan tek bir tanılama olarak raporlanır: ayrıştırılamayan bir şablon için E0111, bir .provides başvurusu için E0112, ayrıştırılmış ancak değerlendirilemeyen bir şablon için E0110; bu, hem terminalde hem de aggrega serve ile bağlı bir düzenleyicide aynıdır. Bir source: alanındaki eksik anahtar, kullanılamayan bir işlevin aksine, ayrıştırma zamanında değil yürütme zamanında raporlanır ve alanı ile okuyamadığı anahtarı adlandırır.
Nasıl düzeltilir:optional bu yüzeyde ve her değer şablonunda, yol şablonunda ve doğrulamada kayıtlıdır; bu da onu taşınabilir seçenek yapar: {{ default "25.0.8" .values.chart_version }} yerine {{ optional .values "chart_version" "25.0.8" }}. Değiştirmeden önce anlam farkını okuyun: optional anahtar yokken devreye girer, default ise değer boşken devreye girer; bu nedenle boş dize veya sıfır olarak yazılmış bir anahtar optional altında yazılmış değerini korur, default altında ise değiştirilir. İfadenin gerçekten bir Sprig işlevine ihtiyacı olduğunda (bir geri dönüş değeri sağlamak yerine bir dizeyi yeniden biçimlendirmek gibi), onu koordinatın okuduğu yerin dışında tutun: hiçbir source: alanının okumadığı bir locals: girişinde ya da onu tüketen yüzeyde (valuesMapping, bir Workload gövdesi, bir artifacts: girişi).
A template indexes a map with a key the map does not hold (Bir şablon, bir eşlemeyi eşlemenin içermediği bir anahtarla dizinliyor)
Bir şablon bir eşlemeyi index aracılığıyla okur — {{ index .values "replicas" }} ya da şablonun hesapladığı bir anahtar adıyla {{ index .context.inject.env $apiKeyVar }} — ve eşleme istenen anahtarı içermez. index orada durur ve anahtarı adlandırır; bu, bir şablonu değerlendiren her yüzeyde geçerlidir: değer şablonları, locals: ve provides: girdileri, yol şablonları, doğrulamalar, yapılandırılmış bir source: koordinatı, bir Aggregate içindeki parametre ara değerlemesi ve parametrelerinin validate: yüklemleri ile bir şemanın x-aggrega-when: ve x-aggrega-validate: yüklemleri.
Bu yalnızca index’in bir özelliğidir ve hiçbir yüzeyin eksik anahtar politikası bunu değiştirmez. Açık bir sütun altında ayarlanmamış bir anahtarın nokta ile okunması, yukarıda “Missing template key — asymmetric policy (Eksik şablon anahtarı — asimetrik ilke)” bölümünün anlattığı gibi bir değer şablonunda hâlâ hiçbir şey üretmez ve yazarın böyle bir anahtarı sağlayıp sağlamadığını sınayan bir şablon bundan etkilenmez. Durduran, index’ten eşlemenin içermediği bir anahtarı istemektir. index, bir şablonun adını kendisinin hesapladığı bir anahtara ulaşma yoludur — örneğin tüketen Recipe’in seçtiği değişken adı altında okunan bir kimlik bilgisi — ve bu durdurma olmasaydı o okuma, derleme başarılı olurken şablon motorunun yer tutucu metni <no value>’yu yapıta koyardı: anahtarı bu metin olan bir sunucu başlatılırdı. index’in verdiği diğer her yanıt şablon motorunun kendisine aittir: bir listedeki ya da dizgedeki bir konum, aralık dışı bir konum, eşlemenin içerdiği bir anahtar — değeri null olan ve <no value> yazdıran bir anahtar da dahil.
Üretilen ileti, raporun son satırı olarak — üstündeki çerçeveler düğümü ve şablonun bulunduğu alanı adlandırır; bir Recipe ya da FeatureRecipe değer şablonunda başlık bu durumun kodunu taşır:
template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (şablon, bir eşlemeyi eşlemenin içermediği bir anahtarla dizinliyor (anahtar). bulunmayabilecek bir anahtarı, önce onu sınayan bir işlevle okuyun; örneğin optional, get ya da hasKey)
Bir şablon hatasını kendine ait bir durum altında bildiren bir yüzeyde — bir provides: girdisi (“A provides: template could not be evaluated”), parametre ara değerlemesi (“A {{ .parameters.* }} reference cannot be interpolated”), bir şema yüklemi (“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated”), bir source: koordinatı (“Resolving a source: coordinate registers a narrower function set”) — başlık o durumun kodunu taşır ve yukarıdaki satır, anahtar da dahil olmak üzere taşıdığı nedendir.
Nasıl düzeltilir: anahtarın meşru biçimde bulunmayıp bulunamayacağına karar verin.
Bulunmayabilir. Onu, önce varlığını sınayan bir işlevle okuyun: {{ optional .values "replicas" 1 }} anahtar yoksa yedek değeri, varsa değeri (ne olursa olsun) döndürür; Sprig’in get işlevi bulunmayan bir anahtar için boş dizge döndürür; hasKey okumadan sınar. optional, parametre ara değerlemesi ile bir parametrenin ya da şemanın yüklemleri dışında her yüzeyde kayıtlıdır; bunlar Sprig’in get ve hasKey işlevlerini sunar; bir source: koordinatı optional’ı kaydeder, Sprig’i kaydetmez.
Bulunmalıdır. Onu sağlayın. İletinin adlandırdığı anahtar şablonun istediği anahtardır; bu nedenle olağan nedenler şunlardır: başka bir ad altında yayımlanmış bir anahtar — key değeri Recipe’in okuduğu değişken adı olmayan bir kimlik bilgisi —, şablonda ya da yazılan değerlerde yanlış yazılmış bir anahtar ve anahtarı iletecek olup da bağlanmamış bir bağlantı.
A template reads and iterates a path that holds nothing (Bir şablon hiçbir şey içermeyen bir yolu okuyor ve yineliyor)
Bir şablon bir yolu olduğu gibi yazdırır ve aynı yol üzerinde de yineleme yapar — örneğin tek bir valuesMapping içinde "user": "{{ .values.user }}" ve "users": "{{ range .values.user }}…{{ end }}" — ve veri orada hiçbir şey içermez: anahtar ayarlanmamıştır, null içerir ya da bağlamın tanımladığı ancak karşılığında hiçbir şey içermediği bir üst düzey alandır; örneğin hiçbir iş yükü sentezlemeyen bir Recipe’deki .workload. Derleme, şablon çalışmadan önce durur ve yolu adlandırır; bu, ayarlanmamış bir değeri hiçbir şey olarak işleyen her yüzeyde geçerlidir: yukarıdaki “Missing template key — asymmetric policy (Eksik şablon anahtarı — asimetrik politika)” bölümünün listelediği değer şablonları ve bir Aggregate’teki parametre enterpolasyonu.
Her okumanın tek başına bir yanıtı vardır. Yazdırılan ayarlanmamış bir değer hiçbir şey işlemez, üzerinde yinelenen ise hiçbir şey yinelemez. Her iki şekilde okunan bir yol ise ikisine de sahip olamaz: onu hiçbir şey olarak işlemek, range ifadesinin metin üzerinde başarısız olmasına yol açar; ayarlanmamış bırakmak ise derleme başarılı olurken şablon motorunun yer tutucu metni olan <no value> ifadesini yapıta yazdırır. Bu nedenle iki yanıt da verilmez ve bunun yerine derleme durur.
Yolun yazdırılması sayılan durum dar tutulmuştur ve sınır, şablonun onu kesinlikle yazdırdığı yerde çizilir:
Yazdırılmış sayılır: bir eylem yalnızca yoldan oluştuğunda ve başka hiçbir şey içermediğinde — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }} ya da yola bağlanmış bir değişken, yani {{ $u := .values.user }} sonrasındaki {{ $u }} — ve şablonun her çalıştığında ulaştığı bir noktada bulunduğunda.
Yazdırılmış sayılmaz: okuma bir if, with ya da range gövdesinin veya bir else dalının içinde bulunduğunda; çünkü o okumanın çalışıp çalışmayacağı bir koşula bağlıdır ve bu koşul, okumanın hiçbir şeyle karşılaşmasını önleyen testin ta kendisi olabilir — bu nedenle bir range .values.user yanındaki {{ if .values.user }}{{ .values.user }}{{ end }} her zamanki gibi işlenir. Okuma bir korumanın kendi testi, bir değişken ataması ya da bir fonksiyonun argümanı olduğunda da — {{ .values.user | quote }}, {{ toYaml .values.user }} — yazdırılmış sayılmaz; çünkü çıktısı yer tutucu değil, fonksiyonun yanıtıdır.
Gerçekten çalışan bir gövde içinde hiçbir şey içermeyen bir yolun yazdırılması yine de <no value> yazar ve bu denetim buna ulaşmaz. Bir yolun bir yazımı diğer her yazımıyla aynı yoldur; bu nedenle bir yazımdaki yazdırma ile başka bir yazımdaki range birlikte değerlendirilir ve ileti, şablonun önce yazdığı yazımı alıntılar. Değer içeren bir yol her zamanki gibi yazdırılır ve yinelenir; üst öğesi hiçbir şey içermeyen bir yol ise hiçbir şeyin içinden aşağı inmenin zaten tetiklediği durdurmaya bırakılır.
Raporun son satırı olarak üretilen ileti — üstündeki çerçeveler düğümü ve şablonu adlandırır, başlık ise bu koşulun kodunu taşır:
template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (Şablon bir yolu değer olarak okuyor ve üzerinde yineliyor, ancak veri bu yolda hiçbir şey içermiyor. Yola bir değer sağlayın, yazdırılan okumayı yol üzerinde bir if veya with ile koruyun ya da yolu yalnızca tek bir şekilde okuyun)
Bir Aggregate’teki parametre enterpolasyonu da aynı satırı bu koşulun koduyla bildirir. Bir provides: girdisi şablon başarısızlığını “A provides: template could not be evaluated (Şablon değerlendirilemedi)” altında bildirir; dolayısıyla orada başlık o koşulun kodunu taşır ve yukarıdaki satır, yol da dahil olmak üzere, onun taşıdığı gerekçedir.
Nasıl düzeltilir: şablonun iki okumadan hangisini kastettiğine karar verin.
Yol orada olmalıdır. Onu sağlayın — Aggregate’in values: alanında, Release’in infra: alanında ya da Release’in doldurduğu parametrede — veya onu yöneten şemada zorunlu olarak bildirin; böylece yokluğu yazıldığı yerde bildirilir.
Yol bulunmayabilir. Yazdırılan okumayı koruyun: {{ with .values.user }}{{ . }}{{ end }} ya da {{ if .values.user }}{{ .values.user }}{{ end }} yol ayarlanmamışken hiçbir şey yazdırmaz ve yanındaki range hiçbir şey üzerinde yinelemeyi sürdürür.
Tek bir okuma yeterlidir. Yolu tek bir şekilde okuyun — ihtiyaç duyduğunu da yazan bir range ile ya da ayarlanmamış bir değer için kendisi yanıt veren toYaml veya join gibi bir fonksiyon aracılığıyla yazdırarak.
A value template failed while it ran (Bir değer şablonu çalışırken başarısız oldu)
Bir Recipe’in veya FeatureRecipe’in değer şablonu — yukarıdaki “Missing template key — asymmetric policy (Eksik şablon anahtarı — asimetrik ilke)” bölümünün listelediği şablonlardan biri; aralarında bir Workload gövdesi, bir artifacts: gövdesi veya bir locals: girdisi de vardır — ayrıştırıldı, çalışmaya başladı ve metnini üretmeden önce durdu. Onu durduran, şablon motorunun kendi gerekçesidir ve durdurma bunu altında taşır: hiçbir şeyin sağlamadığı bir kapsayıcının içinden inen bir başvuru, örneğin hiçbir tls yazılmamışken {{ .values.tls.ca }}; iki türden değerin karşılaştırılması, örneğin metni bir sayıyla karşılaştıran ve cannot compare text with a number ile duran {{ if eq .context.instance_id 1 }}; ya da bir değer şablonunun bir girdiyi kendi iletisiyle reddetmek için yapabileceği Sprig’in fail çağrısı.
Bu şablonlardaki dört başarısızlık bunun yerine kendi koşulları altında bildirilir. Bir provides: girdisi aşağıdaki “A provides: template could not be evaluated (Şablon değerlendirilemedi)” altında, iletisinin içinde bu cümle ve motorun gerekçesiyle bildirilir. Eşlemenin içermediği bir anahtarın index ile okunması yukarıdaki “A template indexes a map with a key the map does not hold (Bir şablon, eşlemenin içermediği bir anahtarla eşlemeyi dizinliyor)” altında bildirilir. Hiçbir şey içermeyen tek bir yolu yazdıran ve üzerinde yineleyen bir şablon, çalışmadan önce reddedilir ve yukarıdaki “A template reads and iterates a path that holds nothing (Bir şablon hiçbir şey içermeyen bir yolu okuyor ve yineliyor)” altında bildirilir. Ayrıştırılamayan bir şablon ise çalışmadan önce durur; dolayısıyla bu koşul değildir.
Üretilen ileti — üstündeki çerçeveler bileşen örneğini ve şablonu adlandırır, örneğin recipe "<recipe>" workload template veya Recipe "<recipe>" locals["<key>"]; şablon motorunun kendi satırı altında gelir:
a value template failed while it ran (bir değer şablonu çalışırken başarısız oldu)
Motorun satırı template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> biçimindedir — fail çağrısı için error calling fail: <the message the template wrote>. Şablon Recipe’in veya FeatureRecipe’in yazarı tarafından yazıldığı için derleme durdurmayı bir CATALOG_ERROR etiketiyle bildirir. aggrega pull, okuduğu dış girdileri keşfetmek için Release’i işlediğinde aynı başarısızlıkla karşılaşır: başarısızlığı bildirir, kilit dosyasının bağımlılık sabitlemelerini yine de yazar ve dış girdi sabitlemelerinin eksik olabileceğini söyler; derleme ise bunda durur.
Nasıl düzeltilir: raporun sonundaki motor gerekçesini okuyun — şablonu, satırı ve sütunu ve durduğu ifadeyi adlandırır. Hiçbir şeyin sağlamadığı bir kapsayıcı için onu sağlayın ya da okumayı, var olmayan bir şeyin içine asla inmeyecek şekilde koruyun: {{ with .values.tls }}{{ .ca }}{{ end }} veya optional yardımcısı. Karşılaştırılan iki tür için benzeri benzeriyle karşılaştırın — bir sayıyı tırnaksız yazılmış bir sayıyla, metni tırnak içinde yazılmış metinle — ya da bir tarafı toString ile metne dönüştürün. fail çağrısı için ileti şablon yazarınındır ve Recipe’in neye ihtiyaç duyduğunu söyler: bunu sağlayın ya da bileşeni yazdığınızı kabul eden bir Recipe ile eşleyin.
A governance plugin rejected the build (Bir yönetişim eklentisi derlemeyi reddetti)
Bir operatör, derleyicinin oluşturduğu çizge ya da ürettiği yapıtlar üzerinde, bir karar rolünde bir yönetişim eklentisi ekleyebilir. Böyle bir eklenti okur ve bir karar döndürür. Ana bilgisayarın ondan geri gelen bir değişikliği uygulayacak bir yolu yoktur; bu nedenle bir karar rolü bir derlemeyi reddedebilir ama onu uyumlu hâle getirmek için yeniden yazamaz — reddetme yapabileceği şeyin tamamıdır ve neyin değiştirileceği onu okuyana bırakılır.
Derlemeyi yalnızca bir durdurma kararı durdurur. Uyarı ve bilgi kararları bildirilir ve derleme devam eder. Bir eklentinin döndürdüğü her durdurma kararı, eklentinin onları ürettiği sırayla bildirilir; böylece tek bir çalıştırma size hepsini söyler.
Bir derlemenin yazdırdığı ileti eklentinin kendi iletisidir; döndürüldüğü gibi aynen gösterilir ve yalnızca onu döndüren eklentiyle çerçevelenir — bu nedenle ne kadar belirli ve ne kadar uygulanabilir olduğuna derleyici değil eklenti karar verir. Kararın taşıdığı isteğe bağlı ayrıntılar, her bölümü adlandırılarak köşeli parantez içinde ardından gelir: bir kod, bir kural tanımlayıcısı, bir sınıflandırma, bir kaynak başvurusu, bir konum, bir öneri. Kaydedildiği durum policy violation’dır; tanılamanın başlığındaki kısa kod da buna çözümlenir.
Reddetme belgelerinizden birine değil yönetişim eklentisine atfedilir, bu nedenle bir dosya konumu taşımaz: onu üreten bir anahtar yoktur ve çözüm ya politikayı karşılamak ya da eklemeyi yeniden gözden geçirmektir.
Üretilen ileti:
policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (politika eklentisi derlemeyi reddetti)
Köşeli parantezli bölüm yalnızca karar ayrıntı taşıdığında, içindeki her bölüm de yalnızca eklenti onu ayarladığında bulunur.
Nasıl düzeltilir: eklentinin iletisini ve sağladıysa öneriyi okuyun. Bulgu doğruysa itiraz ettiği şeyi değiştirin. Politika bu Release’e uygulanmamalıysa bu, eklemeyle ilgili bir sorudur: yönetişim eklemeleri çalışma alanı yapılandırmasında plugins.governance altında yapılandırılır ve hangi eklentinin hangi rolde çalışacağı, bir belgenin geçersiz kılabileceği bir şey değil, bir operatörün kararıdır.
A governance attachment’s settings do not match the plugin’s declared schema (Bir yönetişim eklemesinin ayarları eklentinin bildirdiği şemayla eşleşmiyor)
Bir yönetişim eklentisi, eklemesinin kendisine ilettiği ayarlar için bir şema bildirebilir. Eklemenin with.settings altına yazılan ayarlar, eklenti çağrılmadan önce bu şemaya göre denetlenir; böylece yanlış yapılandırılmış bir ekleme, eklentiye bozuk biçimli girdi olarak ulaşıp eklentinin ondan ne çıkardığına göre geri dönmek yerine, olduğu gibi bir yapılandırma hatası olarak bildirilir.
Denetimin amacı bu sıralamadır. Bu ayrıca durumu bir reddetmeden açıkça ayırır: eklenti çalışmamıştır, bir karara varılmamıştır ve derlemeyle ilgili hiçbir şey değerlendirilmemiştir. Ayar şeması bildirmeyen bir eklenti her ayarı kabul eder, bu nedenle böyle bir eklentiye yapılan ekleme bu durumla hiç karşılaşmaz.
Denetim her yönetişim rolünü kapsar.ir-verdict, render-verdict, label-transform ya da annotation-transform rolünde yazılmış bir eklemenin ayarları, eklenti çağrılmadan önce şemaya göre denetlenir — with.settings her rolde aynı yazılan anahtardır ve her rol onu önce şemaya göre okur. Bir dönüştürme rolü, derlemenin onu uyguladığı yerde çalışır; önce çekme yapan bir derlemede bu, o çekme sırasındadır; bu nedenle oradaki ileti, auto-pull: label-transform: örneğinde olduğu gibi onu çağıran adımla başlar.
Üretilen ileti — eklemenin yazıldığı rol ve adlandırdığı eklenti, ardından sabit cümle, ardından şema denetiminin bulduğu:
ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (ir-verdict: eklenti: with.settings, eklentinin bildirdiği ayar şemasını karşılamıyor: politika eklemesi ayarları, eklentinin bildirdiği ayar şemasını karşılamıyor)
O rolde yazılmış bir ekleme için baştaki ifade render-verdict olur. Şema denetiminin bulduğu, şema doğrulayıcısının kendi raporudur ve birden fazla satır sürer.
Nasıl düzeltilir:plugins.governance içinde o eklemenin with.settings altındaki ayarlarını düzeltin. İletinin ortasındaki ayrıntı hatalı anahtarı ve şemanın orada ne beklediğini adlandırır; eklentinin kendi başvuru belgeleri bildirdiği ayarları açıklar.
Bir pipeline adımı başarısız oldu
Bir FeatureRecipe bir pipeline bildirebilir: her biri düğümün ürettiği belgeler üzerinde bir plugin dışa aktarımını çağıran bir adımlar dizisi; böylece bir Feature, bileşenin kendi Recipe’inin ürettiği çıktıyı biçimlendirebilir. Bir adım, belge kümesinin içermediği bir şeyi adresleyen bir yama dışında herhangi bir nedenle başarısız olduğunda bu koşul altında raporlanır; o durumun aşağıda kendi raporu vardır.
Başarısız olan, adımın kimliği ve dizini ile adlandırılır; ardından gelen ifade hangi kısmın çöktüğünü söyler: adımın with girdisinin işlenmesi, çağrının kendisi, ana makinenin okuyamadığı çıktı, plugin’in döndürdüğü bir hata, plugin’in yaydığı hata önem düzeyinde bir tanılama, yama motorunun reddettiği bir yama ya da yürütmenin sahip olmadığı bir kapsamı adlandıran bir yama.
Başarısız bir adım bütünüyle geri alınır. Belgeler adım çalışmadan önceki hâllerine geri getirilir ve adımın kendi çıktıları da onlarla birlikte atılır; böylece sonraki bir adımın when ya da with alanı kısmi bir sonucu okuyamaz. optional: true olarak bildirilen bir adım bu durumda uyarı olarak raporlanır ve yürütme devam eder; isteğe bağlı olmayan bir adım derlemeyi durdurur. optional: alanının tolere etmediği şey, ihlal edilmiş bir bildirilmiş sözleşmedir; aşağıdaki girdiye bakın.
Üretilen iletiler:
pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> (pipeline adımı başarısız oldu: adım (dizin): işlemenin yapamadığı)
pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> (pipeline adımı başarısız oldu: adım (dizin) çağrı: çağrının yapamadığı)
pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> (pipeline adımı başarısız oldu: adım (dizin) hata tanılaması: plugin’in iletisi)
pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> (pipeline adımı başarısız oldu: kapsam, anahtar: yama motorunun reddettiği)
pipeline step failed: unknown patch scope "<scope>" (pipeline adımı başarısız oldu: bilinmeyen yama kapsamı)
Nasıl düzeltilir: adım kimliğini, ardından dizinden sonraki ifadeyi okuyun; adımın hangi yarısına bakılacağını söyler. Bir with hatası, adımın kendi with: bloğundaki bir şablondur ve düzeltmesi size düşer. Bir hata tanılaması, plugin’in girdiniz hakkındaki kendi sözleridir. Reddedilen bir yama ve bilinmeyen bir kapsam, plugin’in düğümün ürettiğine karşı çıktısıdır ve plugin yazarına aittir. Bir adımın gerçekten başarısız olmasına izin verildiği yerde (zorunlu bir dönüşüm değil, isteğe bağlı bir zenginleştirme) onu optional: true olarak bildirin; bunun bir hatayı tolere ettiğini, bozuk bir sözleşmeyi değil, unutmayın.
Bir pipeline adımının tipli girdisi ya da çıktısı bildirilmiş sözleşmesini karşılamıyor
Bir plugin dışa aktarımı, aldığı girdi ve döndürdüğü çıktılar için bir şema bildirebilir. İkisi de denetlenir: işlenmiş with değeri çağrıdan önce, döndürülen çıktılar ise çağrıdan sonra. Önem düzeyi paylaşılan sözleşmede bildirilmemiş bir tanılama da aynı gerekçeyle reddedilir.
Bu, optional: true olarak bildirilen bir adım için bile durdurur ve bu koşulun adım hatasından ayrı olmasının tüm nedeni bu ayrımdır. Optional, işini yapamayan bir adımı (başarısız bir çağrıyı, itiraz eden bir plugin’i) tolere eder. Ana makinenin yönlendiremediği çıktıyı ya da dışa aktarımın aldığını söylediği biçimde hiç olmamış girdiyi tolere etmez: bildirilmiş bir sözleşme bir taahhüttür ve sözleşmesi bozulmuş bir adımı sessizce atlayan bir derleme, hiçbir şey yapmamış bir Feature üzerinden başarı raporlamış olurdu.
Üretilen iletiler:
pipeline step "<id>"with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (pipeline adımının girdisi bildirilmiş girdi sözleşmesini karşılamıyor: şema denetiminin bulduğu: pipeline adımı tipli G/Ç sözleşmesi ihlali)
pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (pipeline adımı bildirilmiş çıktı sözleşmesini karşılamayan çıktılar döndürdü: şema denetiminin bulduğu: pipeline adımı tipli G/Ç sözleşmesi ihlali)
ve sözleşmenin bildirmediği bir tanılama önem düzeyi için, adım hatası çerçevesi içinde gelen:
pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (pipeline adımı başarısız oldu: adım (dizin): ana makinenin yönlendiremediği önem düzeyi: pipeline adımı tipli G/Ç sözleşmesi ihlali)
Adımın with şablonu hassas olarak bildirilmiş bir değeri okuduğunda, girdi ihlali hiçbir değeri adlandırmaz. Şema denetiminin bulduğunun yerine her başarısız konum ve onu reddeden anahtar sözcük konur, sonunda da nedeni adlandıran bir not yer alır (at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive)); böylece düzeltilecek alan yine adlandırılmış olur. Bkz. vocabulary/compact-form-authoring.md “Bir ret, bildirilmiş bir değer hakkında ne söyler”.
Nasıl düzeltilir: bir girdi ihlalinde, adımın with: bloğunu dışa aktarımının bildirdiği şemaya göre düzeltin; ayrıntı alanı ve neyin beklendiğini adlandırır. Bir çıktı ihlali ve bildirilmemiş bir önem düzeyi plugin’in düzeltmesi gereken şeylerdir; yanlış olan adımın bildirimi değildir, bu yüzden onu isteğe bağlı olarak işaretlemek ikisini de gidermez.
Bir pipeline yaması, kümenin içermediği ya da adreslenecek ağacı olmayan bir belgeyi adresliyor
Bir pipeline adımı bir belgeyi bir kapsam ve bir anahtarla adresler ve iki adres biçimi reddedilir.
Küme onu içermiyor. Adım, kendisine verilen belgeler arasında olmayan bir kapsam-anahtar çiftine yama uyguladı. Hiçbir şey düzenlenmeyeceği için, hiçliğe bir yama uygulayıp başarı raporlamak yerine yürütme durur:
pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (pipeline yaması kümede bulunmayan bir belgeyi hedefliyor: kapsam, anahtar)
Adreslenecek ağacı yok. Bazı birimlerin bir yamanın içine işaret edebileceği bir yapısı yoktur: ikili bir gövde, serbest metin, sağlayıcının güvenle dolaşamayacağı bir bölge. Böyle bir birim yine de medya türü ve baytlarıyla etiketlenerek adıma verilir, böylece seçilip bütün olarak üretilebilir; olamayacağı şey yamalanmaktır, çünkü bir yolun çözümleneceği hiçbir şey yoktur. Böyle bir birime karşı bir yama sessizce atlanmak yerine durur:
pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (pipeline yaması opak (yapısal olmayan) bir birimi hedefliyor: kapsam, anahtar)
Neyin yapısal sayılacağı sabit bir test değil, sağlayıcının birimi kendi okuyuşudur; bu yüzden aynı içerik bir sağlayıcı altında adreslenebilir, başka birinin altında opak olabilir.
İkisi de yürütmenin kendi retleridir ve bir derleme bunları yamayı yapan pipeline’ın ait olduğu düğüme karşı raporlar; bu yüzden yukarıdaki ileti o düğümü adlandıran bir durdurmanın altında gelir. O durdurma, aynı iki adresleme hatasının derlemeyi durduran biçimidir ve aşağıda “A pipeline step addresses documents the node does not have (Bir pipeline adımı düğümün sahip olmadığı belgeleri adresliyor)” altında belgelenmiştir; orası bir adımın hiçbir şeye ulaşamadığı üçüncü adresi de kapsar: hiçbirinin karşısında durmayan bir yerde bir ana bileşenin belgelerine yönelik istek.
Nasıl düzeltilir: ikisi de sizin değil plugin yazarının sorumluluğundadır. Bir adım, üzerinde çalıştırıldığı belge kümesini alır ve içinde hangi anahtarların olduğunu okuyabilir; bu yüzden olmayan bir hedef, bu düğümün üretmediği bir belgeyi adresleyen bir adımdır: var olan bir belgeyi yamalayın ya da kastettiğinizi önce üretip sonraki bir adımda yamalayın. Opak bir birim için yamayı birimin bütününü üreten bir emit ile değiştirin: opak bir gövde düzenlenmez, yerine yenisi konur.
A patch’s test operation did not match the document (Bir yamanın test işlemi belgeyle eşleşmedi)
Bir yama, ardından gelen işlemler uygulanmadan önce bir yolda ne bulunduğunu doğrulayan bir test işlemi taşıyabilir. Doğrulama tutmadığında motor yamanın tamamını reddeder; koşullu bir yamayı iyimser değil gerçekten koşullu yapan da budur: düzenlemeden önce test eden bir plugin, tanımadığı bir belgeye dokunmayacağını söylemiş olur.
Bu koşul altında iki biçim raporlanır. Ya yolda hiçbir şey yoktur ve ileti bunu söyler. Ya da bir değer vardır ama doğrulanan değer değildir; bu durum yalın bir ret olarak raporlanır — ne doğrulanan değer ne de bulunan değer aktarılır.
Üretilen iletiler:
jsonpatch: test operation failed: no value at path (jsonpatch: test işlemi başarısız oldu: yolda değer yok)
jsonpatch: test operation failed (jsonpatch: test işlemi başarısız oldu)
Yamayı bir pipeline adımının çıktısı taşıdıysa ret, adımı adlandıran o adımın başarısızlığının altında gelir. Yamayı bir label-transform plugin’inin yaması taşıdıysa, label-patch reddinin altında gelir.
Nasıl düzeltilir: hata sizin belgelerinizde değil, plugin’dedir. Belgede bulunmayan bir değer bekleyen bir test, genellikle plugin’in yazılmadığı bir biçim üzerinde çalıştığı anlamına gelir — başka bir provider’ın çıktısı ya da aynı pipeline’da daha önceki bir adımın zaten değiştirdiği bir belge. Yamayı düzeltmek size düşüyorsa, ya testi belgenin gerçekte taşıdığına göre gevşetin ya da durumu yamanın içinde test etmek yerine adımın when koşuluyla atlayın.
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
Bir workload:, bir form: bildirir — çalıştırılan şeyin biçimi, herhangi bir hedefin kendi sözcükleriyle değil, her hedefin anladığı terimlerle ifade edilir. Bazı alanlar yalnızca tek bir formda anlam taşır ve ihtiyaç duyduğu alan olmadan bildirilen bir formun işlenecek tutarlı bir şeyi yoktur. Her iki yön de, herhangi bir hedef workload’u çevirmeden önce denetlenir; böylece uyuşmazlık, her hedef için o hedefin kendi sözcükleriyle bir kez değil, yazdığınız şeye karşı bir kez raporlanır.
Beş eşleşme uygulanır ve her biri, iki yarıyı ve ne yazılacağını adlandıran kendi cümlesini raporlar:
workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (workload bir persistentTemplate birimi bildiriyor ama form: stateful değil; form: stateful bildirin)
workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (workload form: reference ama endpoint bildirmiyor; endpoint’i referansın gösterdiği harici ana makineye veya URL’ye ayarlayın)
workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (workload bir endpoint bildiriyor ama form: reference değil; form: reference bildirin ya da endpoint’i kaldırın)
workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (workload form: scheduled ama schedule bildirmiyor; schedule’ı 5 alanlı bir cron ifadesine veya bir @-makrosuna (ör. @daily) ayarlayın)
workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (workload bir schedule bildiriyor ama form: scheduled değil; form: scheduled bildirin ya da schedule’ı kaldırın)
Her biri, workload’u okunan component örneğinde konumlandırılır ve bir çeviri hatası olarak raporlanır, çünkü uyuşmazlık yazılmış tek bir bloğun iki alanı arasındadır.
Kaydedildikleri koşullar, yani kısa kodlarının çözümlendiği adlar, persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule ve schedule requires form: scheduled koşullarıdır.
Bir eşleşme yalnızca tek yönde işler. Replika başına talep şablonu olmayan bir form: stateful workload olağandır ve hiçbir rapor üretmez — kural, bir talep şablonunun yalnızca o formun verdiği kararlı replika başına kimliğe ihtiyaç duymasıdır; formun bir talep şablonuna ihtiyaç duyması değil. Diğer iki eşleşme her iki yönde işler, çünkü bir endpoint ve bir schedule’ın her birinin anlam taşıdığı tam olarak tek bir form vardır.
İki endpoint eşleşmesi Workload şemasında da bulunur; bu nedenle ikisinden birini bozan bir workload, yukarıdaki cümlesine ulaşılmadan önce şema aşamasında, E0214 altında reddedilir. reference dışındaki herhangi bir biçimdeki bir endpoint: — stateless olarak okunduğu için atlanmış bir form: da dahil — şu şekilde reddedilir:
workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (workload doğrulaması şema aşamasında başarısız oldu: endpoint değeri burada izin verilmeyen bir biçimle eşleşiyor)
ve endpoint: olmayan form: reference bunun yerine .endpoint: missing required property: endpoint ile biter. Çözüm, eşleşmenin cümlesinin verdiği çözümdür.
Nasıl düzeltilir: her cümle iki alanı adlandırır ve her iki yanıtı da verir. Formun ihtiyaç duyduğu alanı ekleyin, ya da formu alanın ait olduğu forma değiştirin, ya da bir düzenlemeden geride kalmışsa alanı kaldırın — bir schedule: değerini silip anahtarı bırakmak, bu hatayı en sık doğuran biçimdir.
A workload schedule: is not an expression the check accepts (Bir workload schedule değeri denetimin kabul ettiği bir ifade değil)
Bir form: scheduled workload, ne zaman çalışacağını söyleyen bir schedule: taşır ve bu değer, herhangi bir hedef okumadan önce yapı açısından denetlenir. İki yazım kabul edilir: @hourly, @daily, @weekly, @monthly ve @yearly makrolarından biri ya da alanları yalnızca rakamları ve *, ,, - ve / karakterlerini kullanan beş alanlı bir crontab ifadesi.
Denetimin okuduğu ve okumadığı şeyler. Denetim alanları sayar ve içlerindeki karakterlere bakar. Aralıkları, adım aritmetiğini veya haftanın günü adlarını değerlendirmez; bu nedenle sayıları aralık dışında olan beş alanlı bir ifade burada geçer ve onu reddetmek hedefe düşer. Başta bir saniye alanı taşıyan altı alanlı bir ifade reddedilir: bu yüzeyin kabul ettiği beş alandır ve saniye isteyen bir hedef onları başka bir yolla alır.
Üretilen ileti:
workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly (workload schedule değeri geçerli bir cron ifadesi değil; 5 alanlı bir crontab ifadesi (ör. “0 0 * * *”) ya da @hourly, @daily, @weekly, @monthly, @yearly değerlerinden birini kullanın)
Kaydedildiği koşul, kısa kodunun çözümlendiği ad olan schedule is not a valid cron expression koşuludur.
Nasıl düzeltilir: önce alanları sayın — dört ya da altı alanlı bir schedule en yaygın nedendir ve bir alanın içindeki fazladan bir boşluk onu ikiye böler. Adıyla yazılmış bir günü veya ayı numarasıyla değiştirin ve kastettiğinizi bir makro ifade ediyorsa makroyu kullanın.
A workload suspend: is set on a form other than scheduled (Bir workload’un askıya alma alanı zamanlanmış dışında bir biçimde ayarlanmış)
suspend: true, form: scheduled olan bir workload’un yinelenen zamanlamasını bekletir: zamanlanmış kaynak işlenir ve yeniden başlatılana kadar zamanlamasından hiçbir çalıştırma başlamaz. Başka hiçbir biçim bir zamanlama taşımaz; bu nedenle başka herhangi bir biçimde alanın bekleteceği bir şey yoktur ve derleme, alanı sessizce düşüren bir workload’u işlemek yerine durur. Denetim, herhangi bir hedef workload’u çevirmeden önce diğer biçim eşleşmeleriyle birlikte çalışır ve atlanmış bir form: burada da stateless olarak okunur.
Üretilen ileti:
workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (workload suspend bildiriyor ancak form: scheduled değil; zamanlamayla birlikte form: scheduled bildirin ya da suspend’i kaldırın)
Workload’u okunmakta olan bileşen örneğinde konumlanır ve bir çeviri hatası olarak bildirilir. Kaydedildiği koşul suspend requires form: scheduled’dir ve kısa kodu buna çözümlenir.
Kural yalnızca tek yönde ve yalnızca true için işler.suspend: olmayan bir form: scheduled workload’u olağandır ve zamanlamasına göre çalışır; varsayılan olan suspend: false ise hiçbir biçimde hiçbir şeye yol açmaz.
Nasıl düzeltilir: workload’un yalnızca biri başlattığında çalışması amaçlandıysa onu bir schedule: ile form: scheduled yapın ve suspend: true değerini koruyun; aksi takdirde biçimi yazıldığı gibi bırakın ve başka hiçbir biçimin okumadığı suspend: alanını kaldırın.
A library $import: is not written in the bare-name form (Bir kütüphane içe aktarımı yalın ad biçiminde yazılmamış)
Bir Recipe ve bir FeatureRecipe üzerindeki üç alan, gövdelerini yerinde yazmak yerine bir kütüphaneden alabilir: bir artifacts.<name>: girdisi, bir valuesMapping: ve bir workload:. Her biri $import: ile kütüphanenin yalın adını, ardından # işaretini, ardından o alanın okuduğu yüzeydeki girdinin yolunu yazar; sırasıyla #/artifacts/, #/mappings/ ve #/workloads/. Bu biçimde olmayan bir değer, derlemenin çözümleyebileceği hiçbir şeyi adlandırmaz ve alan çözümlenirken reddedilir.
Üç alan bilinçli olarak birbirinin aynası olarak tasarlanmıştır; bu nedenle hata üçünde de aynı biçimde okunur ve yalnızca yüzey değişir:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (artifacts içe aktarımı yalın adlı bir artifact kütüphanesi başvurusu değil)
valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (valuesMapping içe aktarımı yalın adlı bir eşleme kütüphanesi başvurusu değil)
workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (workload içe aktarımı yalın adlı bir workload kütüphanesi başvurusu değil)
@ ile yazılmış bir sürüm, bunun yerine kullanılacak yazımla birlikte bildirilir; kütüphanenin bulunamadığına dair bir şikâyete düşmez, çünkü bu biçimin en sık yol açtığı hata budur:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (artifacts içe aktarımı yalın adlı bir artifact kütüphanesi başvurusu değil: sürüm ayırıcısı ’@’ değil ’:’ karakteridir; düzeltilmiş değeri kullanın)
Burada bir biçim daha bildirilir ve bu bir yazım hatası değildir. Bir ArtifactLibrary paketinin kendi dosya gövdesi, başka bir paketin $import: ifadesi olamaz: tek bir dosya yuvası birden çok dosyaya genişleyemez; bu nedenle iç içe bir içe aktarım, yazarın yazmadığı bir şeye çözümlenmek yerine reddedilir. Bunun yerine paketleri tüketildikleri noktada birleştirin.
Bir component’in kendi Recipe’sinin yazdığı bir artifacts: girdisi herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki artifacts: bloğunda konumlanır ve başvuruyu, paketi, gövdesi iç içe içe aktarımı taşıyan dosyayı ve içe aktarımın yazıldığı girdiyi adlandırır. Paketin bu biçimdeki her dosyası tek bir derlemede bildirilir; birden fazla olduğunda bulgular artifacts entries whose library import the compiler cannot resolve altında gruplanır:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them (artifacts içe aktarımı yalın adlı bir artifact kütüphanesi başvurusu değil. Bir paket dosyası gövdesi başka bir paketi içe aktaramaz; ikisini onları tüketen artifacts girdisinde birleştirin)
Bir FeatureRecipe’nin yazdığı bir artifacts: girdisi aynı durumu paket çözümlenirken bildirir ve bu biçimdeki ilk dosyayı adlandırır:
artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site) (artifacts içe aktarımı yalın adlı bir artifact kütüphanesi başvurusu değil: paket dosyasının gövdesi alan kökünde bir içe aktarım; paket dosyası içinde iç içe kütüphane içe aktarımı desteklenmez, tüketim noktasında birleştirin)
Bir component’in kendi Recipe’sinin yazdığı bir valuesMapping: herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki valuesMapping: anahtarında konumlanır ve kullanılacak yazımı taşır:
valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/ (valuesMapping içe aktarımı yalın adlı bir eşleme kütüphanesi başvurusu değil. Kütüphaneyi ve girdiyi parçanın iki yanında adlandırın)
Bir FeatureRecipe’nin yazdığı bir valuesMapping:, başvuru çözümlenirken yukarıdaki listedeki biçimde bildirilir.
Bir component’in kendi Recipe’sinin yazdığı bir workload: herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki workload: anahtarında konumlanır ve kullanılacak yazımı taşır:
workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/ (workload içe aktarımı yalın adlı bir workload kütüphanesi başvurusu değil. Kütüphaneyi ve girdiyi parçanın iki yanında adlandırın)
Bir FeatureRecipe’nin yazdığı bir workload:, başvuru çözümlenirken yukarıdaki listedeki biçimde bildirilir.
Nasıl düzeltilir: değeri <Library>#<entry-path> olarak yeniden yazın; kütüphane adından sonra :<version> ifadesini yalnızca hangi sürümün seçilebileceğine bir alt sınır koymanız gerektiğinde ekleyin. Parçanın alanla eşleştiğini denetleyin: bir workload: üzerindeki #/mappings/… girdi yolu o alanın okumadığı bir yüzeyi adlandırır ve eksik girdi olarak değil burada bildirilir. Aynı kimlik biçimi bir şemanın $ref: ifadesini de yönetir; bunun retleri yukarıda “A $ref: is not written in a form the compiler can resolve (Şema başvurusu derleyicinin çözümleyebileceği bir biçimde yazılmamış)” altında belgelenmiştir.
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
Bir $import: doğru yazılmıştır, ancak işaret ettiği şey orada değildir. Altı koşul, üç kütüphane türü genelinde bir referansın iki yarısını kapsar ve hangisini aldığınız, hangi yarıya bakmanız gerektiğini söyler: ya kütüphanenin kendisi derlemenin görebildikleri arasında yoktur ya da kütüphane oradadır ama girdiyi yayımlamaz.
Bir referansın çözümlendiği küme, çalışma alanının kendi kataloğu ile kilit dosyasının sabitlediği ve derleme yüklenirken getirdiği kütüphanelerdir. Bu nedenle Release’in bağımlılık kapanışında hiçbir şeyin bağımlılık bildirmediği bir kütüphane, ona yönelik referans ne kadar doğru görünürse görünsün bu kümede yer almaz.
Kütüphane orada değil:
artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (artifact-library içe aktarması katalogda bulunmayan bir ArtifactLibrary’ye başvuruyor: ArtifactLibrary, paket)
mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (mapping-library içe aktarması katalogda bulunmayan bir MappingLibrary’ye başvuruyor: MappingLibrary, girdi)
workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (workload-library içe aktarması katalogda bulunmayan bir WorkloadLibrary’ye başvuruyor: WorkloadLibrary, girdi)
Girdi orada değil:
artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (artifact-library içe aktarması ArtifactLibrary’de bulunmayan bir pakete başvuruyor: ArtifactLibrary içindeki paket)
mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (mapping-library içe aktarması MappingLibrary’de bulunmayan bir girdiye başvuruyor: MappingLibrary içindeki girdi)
workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (workload-library içe aktarması WorkloadLibrary’de bulunmayan bir girdiye başvuruyor: WorkloadLibrary içindeki girdi)
Bir bileşenin kendi Recipe’inin yazdığı bir artifacts: girdisi, eksik bir paketi kendine özgü bir biçimde bildirir. Bu girdi herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki artifacts: bloğuna konumlanır ve referansın her iki yarısıyla birlikte içe aktarmanın yazıldığı girdiyi adlandırır:
artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (artifact-library içe aktarması ArtifactLibrary’de bulunmayan bir pakete başvuruyor: ArtifactLibrary, artifacts girdisi)
Bir bileşenin kendi Recipe’inin yazdığı bir valuesMapping:, eksik bir girdiyi kendine özgü bir biçimde bildirir, aynı nedenle: o da herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki valuesMapping: anahtarına konumlanır ve referansın her iki yarısını adlandırır:
mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (mapping-library içe aktarması MappingLibrary’de bulunmayan bir girdiye başvuruyor: MappingLibrary)
Bir bileşenin kendi Recipe’inin yazdığı bir workload:, eksik bir girdiyi kendine özgü bir biçimde bildirir, aynı nedenle: o da herhangi bir şey işlenmeden önce belirlenir; bu nedenle rapor o Recipe’deki workload: anahtarına konumlanır ve referansın her iki yarısını adlandırır:
workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (workload-library içe aktarması WorkloadLibrary’de bulunmayan bir girdiye başvuruyor: WorkloadLibrary)
Bir FeatureRecipe’in yazdığı bir artifacts: girdisi, bir FeatureRecipe’in yazdığı bir valuesMapping: veya workload: ve derlemenin göremediği bir kütüphaneye yönelik her referans, referans çözümlenirken yukarıdaki iki listenin taşıdığı biçimlerde bildirilir.
Her biri, hangi yarı başarısız olursa olsun hem kütüphaneyi hem de girdiyi adlandırır; böylece hiçbir şey açmadan eksik bir kütüphaneyi eksik bir girdiden ayırt etmek için tek bir rapor yeterlidir.
Nasıl düzeltilir: eksik bir girdi için adı kütüphanenin yayımladıklarıyla karşılaştırın; bir girdi adı o kütüphanenin kendi eşlemesindeki bir anahtardır ve büyük/küçük harfe duyarlıdır. Eksik bir kütüphane için referans genellikle doğrudur ve eksik olan kapanıştır: kütüphanenin yüklenmesi için ona bağımlılık bildirin ve sabitlenmesi için kilit dosyasını yenileyin. Bir çalışma alanında erişilebilen ama diğerinde erişilemeyen bir kütüphane, diğer taraftan görülen aynı hatadır.
Bir kütüphane $import: ifadesi, kütüphanesini kayıt defteri konumuyla adresliyor
Bir kütüphane $import: ifadesi, kütüphanesini hiçbir zaman yayımlandığı kayıt defteriyle değil, kimliğiyle adlandırır. Bir adın hangi kayıt defteri üzerinden çözümlendiği çalışma alanı yapılandırmasıdır ve hangi sürümün kullanıldığı kilit dosyasının yanıtıdır; dolayısıyla bir ana makine taşıyan referans, bir katalog belgesinde derlemenin karar vermesi gereken iki şeyi sabitler ve belge bundan sonra farklı yapılandırılmış hiçbir çalışma alanında çalışmaz.
Böyle bir referansın hâlâ bu durmaya ulaşabildiği yer göründüğünden daha dardır. Bir Recipe’in ve bir FeatureRecipe’in kendi $import: alanları daha önce, üç konumun hiçbirinde kayıt defteri öneki kabul etmeyen şemaları tarafından reddedilir. Geriye kalan, hiçbir şemanın tanımlamadığı referanstır: bir kütüphane girdisinin kendi gövdesinden okunan, onu tüketen varlığın yazmadığı ve gövde çözümlenene kadar göremediği referans.
Çözümleyicinin yalnızca değeri bildirdiği valuesMapping: ve workload: yüzeylerinden üretilen ileti:
library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (kütüphane $import: ifadesi bir kayıt defteri ana makinesi taşıyor; kütüphaneye yalın ad kimliğiyle başvurun)
Bir artifacts: girdisi bu durmaya ulaşmaz ve onu orada arıyorsanız nedenini bilmeye değer. Kendi referansı, diğer her konum gibi belgenin geri kalanıyla birlikte reddedilir; diğer iki yüzeyin aksine, gövdesi kendisi bir içe aktarma olan paket dosyası izlenmek yerine reddedilir; dolayısıyla ana makine taşıyan bir referansın gelebileceği bir gövde yoktur.
Nasıl düzeltilir: ana makineyi ve kütüphane adından önceki her şeyi kaldırarak <Library>#<entry-path> bırakın. Sorunlu değer yayımladığınız değil de tükettiğiniz bir kütüphanenin içindeyse, düzeltme o kütüphanenin yazarına düşer; düzeltme gelene kadar farklı bir girdiyi içe aktarmak veya gövdeyi yerinde yazmak derlemeyi temizler.
Bir Recipe’in iki artifact çıktısı aynı dosya adını taşıyor
Bir Recipe’in artifacts: bloğu her anahtar için bir çıktı adlandırır ve bir anahtarda içe aktarılan paket dosyalarını onun altına ekler. Tek bir dosya adına ulaşan iki çıktı, birinin diğerinin üzerine yazması anlamına gelir; bu nedenle derleme hangisinin kalacağını seçmek yerine durur.
Bu bir artık koruyucudur ve bunu söylemek onun ne olduğunun bir parçasıdır. Bir çıktı, altında yazıldığı anahtarla adlandırılır, eşleme anahtarları tek bir belge içinde benzersizdir ve yazım yüzeyi bir anahtarı tek bir dosya adıyla sınırlar; bu nedenle iki yazılmış girdi çakışamaz ve bir anahtar başka bir anahtarın paketinin ürettiği iç içe adı da yazamaz. Koruyucunun hâlâ kapsadığı şey, yazılmış bir belgenin kendi yinelenen anahtar reddinden geçmeden izdüşüme ulaşan içeriktir: bir dosyadan okunmak yerine derleme çalışırken birleştirilen durum. Bu nedenle burada bildirilen bir çakışma, görebileceğiniz bir satırı değil, derlemenin nasıl birleştirildiğini gösterir.
Her Recipe için o Recipe’in kendi çıktıları üzerinden üretilir; onu, bir birleştirmede tek bir yola düşen iki farklı katkıcıdan ayıran budur; o durum yukarıdaki “Two contributors write the same output path (İki katkıcı aynı çıktı yolunu yazıyor)” bölümüdür ve çözümü farklıdır.
Üretilen ileti:
artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (artifacts çıktı dosya adı çakışması: iki artifact çıktısı aynı dosya adını taşıyor; Recipe, birden fazla kez üretilen artifact çıktısı)
Nasıl düzeltilir: iletinin adlandırdığı Recipe’i açın ve artifacts: anahtarlarını içe aktardığı herhangi bir paketin eklediği dosyalarla karşılaştırın. Anahtarlar gerçekten farklıysa ve çakışma yine de sürüyorsa, belgede hata yoktur ve raporu derlemenin bakımını yapan kişiye iletmeye değer.
An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Bir ArtifactLibrary paket dosyası, içe aktarıldığı anahtarın altında kendine ait bir dosya adlandırmıyor)
Bir paketi içe aktaran bir artifacts: girdisi, o paketteki her dosya için bir çıktıya genişler ve her biri içe aktarmanın yazıldığı anahtarın altına yerleşir. Dolayısıyla anahtar bir dizini adlandırır ve paketin katkıda bulunduğu her dosya, kendine ait bir adla bu dizinin altında yer alır. O dizinden yukarı çıkan, mutlak bir konumu adlandıran ya da hiçbir şeyi adlandırmayan bir dosya adı buna uymaz ve derleme, dosyayı tüketen Recipe’in hiç seçmediği bir yere koymak yerine durur.
Hiçbir şeyi adlandırmamak, anahtarın altında tek bir dosyanın tek yazımı olmayan her adı kapsar.. ve ./ ile x/.. gibi anahtarın kendisine geri katlanan bir ad, anahtarın kendisini adlandırır; böylece dosya, anahtarın dizininin bulunması gereken yere yazılırdı. Sonda ya da çift / içeren veya . ya da .. parçası içeren bir ad — x/, a//b, ./a, a/./b, a/../b — başka bir adın da taşıyabileceği bir dosyanın ikinci yazımıdır: a/b yanında a//b, tek bir dosya için iki addır ve biri, hiçbir çakışma bildirilmeden diğerinin üzerine yazılırdı. Boş ad da reddedilir.
Önlediği şey, çıktı dizininin dışına yazma değil, sessiz bir yeniden yerleşimdir. Dosyaların yazıldığı yer ayrıca denetlenir; bu yüzden yeterince yukarı çıkan bir ad her durumda orada reddedilir. Bu denetimden geçen ad, tam olarak bir düzey yukarı çıkan addır: çıktı dizininin içine, kimsenin seçmediği bir konuma geri düşer. Bu, reddedilen bir yazmadan daha kötüdür, çünkü bu yoldaki her çakışma denetimi bir adı çözümlendiği hâliyle değil oluşturulduğu hâliyle okur — bu yüzden bu türden iki dosya, hiçbir şey çakışma bildirmeden tek bir çıktıya çözümlenebilir ve hangisinin kalacağına kimsenin yazdığı hiçbir şey karar vermez.
Anahtarın içine düz biçimde yazılmış iç içe bir yerleşime dokunulmaz. Bir paket, rbac/role.yaml gibi kendi alt dizinlerini taşımakta serbesttir ve bunları tüketim anahtarının altına yerleştirmek, anahtarın varlık nedenidir. ..config ya da role.v1.yaml gibi bir parçanın içinde yalnızca nokta barındıran bir ad, sıradan bir addır.
Tüketen Recipe ile yayımlanan paket genellikle farklı yazarlarca yazılır; bu yüzden ileti, her iki yarıyı da çözümle birlikte adlandırır.
Bir bileşenin kendi Recipe’inin yazdığı bir artifacts: girdisine herhangi bir şey işlenmeden önce karar verilir; bu yüzden rapor, o Recipe’teki artifacts: bloğunda konumlanır ve önce dosyayı, ardından geldiği kütüphaneyi ve tüketildiği girdiyi adlandırır. Paketin adı reddedilen her dosyası tek bir derlemede bildirilir; birden fazlası olduğunda bulgular artifacts entries whose library import the compiler cannot resolve altında gruplanır:
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (artifact-library paket dosyası adı, çıktısının altına yerleştiği artifacts anahtarının altında kendine ait bir dosya adlandırmıyor. ArtifactLibrary paketindeki dosyayı, tüketildiği artifacts anahtarının altında “config.yaml” ya da “rbac/role.yaml” gibi sıradan bir dosya adıyla yeniden adlandırın — “.” ya da “..” parçası olmadan, başta, sonda ya da çift “/” olmadan)
Bir FeatureRecipe’in yazdığı bir artifacts: girdisi aynı durumu paket çözümlenirken bildirir; içinde yazıldığı recipe’i ve bu türden ilk dosyayı adlandırır:
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (artifact-library paket dosyası adı, çıktısının altına yerleştiği artifacts anahtarının altında kendine ait bir dosya adlandırmıyor. ArtifactLibrary paketindeki dosyayı, tüketildiği artifacts anahtarının altında “config.yaml” ya da “rbac/role.yaml” gibi sıradan bir dosya adıyla yeniden adlandırın — “.” ya da “..” parçası olmadan, başta, sonda ya da çift “/” olmadan)
Nasıl düzeltilir: ArtifactLibrary içindeki dosyayı, anahtarın altında sıradan bir dosya adıyla yeniden adlandırın. Kütüphane sizin değilse, düzeltme kaynağında yapılırken farklı bir paketi içe aktarmak ya da girdiyi yerinde yazmak derlemeyi temizler. Bambaşka bir yere düşmesi amaçlanan bir dosya, oraya yürüyen bir ad değil, ait olduğu anahtarda ikinci bir artifacts: girdisidir.
An imported artifact no longer matches the digest recorded beside its Recipe (İçe aktarılan bir yapıt, Recipe’inin yanında kaydedilen özetle artık eşleşmiyor)
Yerel bir dosyayı içe aktaran bir artifacts: girdisinin içeriği, Recipe sabitlendiğinde sabitlenir — aggrega pin ile ya da aynı adımı çalıştırması istenen bir pull veya push ile: dosyanın baytlarının özeti, Recipe’in yanındaki entity.lock içine kaydedilir. Bir Recipe’in boundary.artifacts: girdisi de aynı şekilde sabitlenir ve karşılaştırılır; iletinin ona verdiği ad olan boundary/<key> altında kaydedilir. Her derleme dosyayı yeniden okur, özetini yeniden çıkarır ve uyuşmazlığı reddeder — böylece sabitlendikten sonra düzenlenen bir dosya hiçbir zaman denetlenmiş gibi işlenmez. aggrega pull --verify aynı karşılaştırmayı yapar ve uyuşmazlığı aynı iletiyle bildirir.
Karşılaştırılan, girdinin içeriğidir; onu işlemenin ürettiği şey değil. Bir yapıt gövdesi bir şablondur ve değerlendirilmesi, bileşen örneğine göre değişen değerleri yerine koyar; bu yüzden çıktı üzerinden alınan bir özet, değerleri farklı olan her örnek için uyuşmazdı. Kaydedilen içerik, Recipe’i bağlayan her örnek için aynı metindir; kaydedilen tek bir özeti karşılaştırılacak doğru şey yapan da budur.
Üç yüzey aynı denetimi farklı belgeler üzerinde taşır — bir bileşenin kendi Recipe’i, bir bileşene eklenmiş bir Feature ve bir sınıra eklenmiş bir Feature — bu yüzden FeatureRecipe’in içeriği, barındıran bileşenin Recipe’inin yanında değil, FeatureRecipe’in yanında kaydedilen özetle ölçülür. İki ek yüzeyinde ileti eki de adlandırır; hangi belgenin açılacağını söyleyen de budur.
Üretilen iletiler:
imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (içe aktarılan yapıt içeriği, entity.lock içinde onun için kaydedilen özetle eşleşmiyor. Dosya bilerek değiştirildiyse, yeni özetini kaydetmek için onu içe aktaran varlık üzerinde aggrega pin çalıştırın; aksi hâlde dosyayı geri yükleyin)
imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (içe aktarılan yapıt içeriği, entity.lock içinde onun için kaydedilen özetle eşleşmiyor. Dosya bilerek değiştirildiyse, yeni özetini kaydetmek için onu içe aktaran varlık üzerinde aggrega pin çalıştırın; aksi hâlde dosyayı geri yükleyin)
Nasıl düzeltilir: iki yanıt vardır ve hangisinin doğru olduğu, düzenlemenin bilerek yapılıp yapılmadığına bağlıdır. Bilerek yapıldıysa, sabitlemenin dosyanın güncel baytlarından yeniden alınması için Recipe üzerinde aggrega pin çalıştırın ve yeniden yazdığı entity.lock dosyasını commit edin. Bilerek yapılmadıysa dosyayı geri yükleyin — kaydedilen özet, sabitlenen baytların kaydıdır ve değişmiş dosyayı işleyen bir derleme, hiçbir şeyin doğrulamadığı bir içeriği teslim etmiş olurdu.
A local source no longer matches the pins recorded beside its Recipe (Yerel bir kaynak, Recipe’inin yanında kaydedilen sabitlemelerle artık eşleşmiyor)
source: alanı yanındaki bir dizini ya da dosyayı adlandıran bir Recipe veya FeatureRecipe’in kaynağı, varlık sabitlendiğinde sabitlenir: aggrega pin ile ya da aynı adımı çalıştırması istenen bir pull veya push ile. Varlığın yanındaki entity.lock, kaynağın varlığın bir yayınının taşıdıklarına kattığı her dosya için, dosyanın yoluyla anahtarlanmış bir özet kaydeder. Kilit bunları kaydettikten sonra her derleme, provider kaynağı okumadan önce kaynağın mevcut hâlini bu sabitlemelerle karşılaştırır ve bir uyuşmazlığı reddeder; böylece sabitlendikten sonra düzenlenen bir chart ya da modül hiçbir zaman denetlenmiş gibi işlenmez. aggrega pull --verify aynı karşılaştırmayı yapar ve bir uyuşmazlığı aynı iletiyle bildirir. Derleme, kaynağını çözümlemekte olduğu bileşen örneğini ve onun altındaki Recipe belgesini adlandırır.
Kaynak tek bir dosya kümesi olarak karşılaştırılır. İçeriği değişen bir dosya, kaynağa eklenen bir dosya ve kaynaktan çıkarılan bir dosya, varlığın neyden işlendiğini değiştirir; bu yüzden her biri, dosyanın şu anki özeti ve onun için kaydedilen özetle birlikte bildirilir. Varlığın yanında bulunup kaynağın katkıda bulunmadığı bir dosya (Recipe’in yanındaki bir not ya da README) karşılaştırılmaz. ./charts/{{ .values.flavour }} gibi şablon olarak yazılmış bir kaynak, varlığın dizinindeki her dosyaya katkıda bulunur, çünkü hangi dizini adlandırdığına her Release karar verir; bu biçimde dizindeki herhangi bir dosyada yapılan düzenleme bildirilir.
Kilidi kaynağı için hiçbir sabitleme kaydetmeyen bir Recipe’te derlemenin karşılaştıracağı bir şey yoktur. Derleme onu reddetmez; sabitleme yapmayan bir pull ya da push ise An entity reads an input the lock beside it records no pin for (Bir varlık, yanındaki kilidin sabitleme kaydetmediği bir girdiyi okuyor) bölümünün açıkladığı gibi reddeder. Bir kilidin, Recipe’in artık bildirmediği bir yerel kaynak için hâlâ kaydettiği sabitlemeler okunan hiçbir şeyi sabitlemez; bu yüzden hiçbir şeyle karşılaştırılmazlar. Bir pull’un bir kayıt defterinden çözümlediği Recipe ise bunun yerine lockfile’ın yayınının taşıdıkları için kaydettiği özetle kapsanır.
Değişiklikten önce yazılmış bir lockfile önce bildirir. Lockfile varlığı taşıdıklarıyla kaydeder ve kaynağın dosyaları bunun bir parçasıdır; bu yüzden bir dosya değişmeden önce yazılmış bir lockfile tutan bir derleme ya da aggrega pull --verify, bu karşılaştırma çalışmadan önce, varlığı ve her iki özeti adlandıran The lockfile no longer matches what the release resolves to (Lockfile, release’in çözümlendiği şeyle artık eşleşmiyor) ile durur. Düz bir aggrega pull, değişen dosyayı An entity reads an input the lock beside it records no pin for (Bir varlık, yanındaki kilidin sabitleme kaydetmediği bir girdiyi okuyor) ile adlandırır. Aynısı içe aktarılan bir dosya için de geçerlidir. Lockfile’da varlığın kendine ait bir girdisi olmadığında, bir derlemenin ve doğrulayan bir pull’un karşılaştığı bu karşılaştırmadır: Manifest’in, aynı zamanda Release’in ulaştığı bir Component ya da Feature’ın adı olan bir başvuruyla adlandırdığı bir Recipe veya FeatureRecipe, o başvurunun altında Component ya da Feature olarak kaydedilir; bu yüzden Recipe’in dosyaları değiştiğinde lockfile’da hiçbir şey değişmez.
Üretilen iletiler:
the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (varlığın yerel kaynağının dosyaları, entity.lock içinde onlar için kaydedilen sabitlemelerle eşleşmiyor (dosyanın özeti farklı ve kaydedilen sabitlemesi farklı). Kaynak bilerek değiştirildiyse, dosyalarını yeniden kaydetmek için varlık üzerinde çalıştırın; aksi hâlde dosyaları geri yükleyin)
the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (varlığın yerel kaynağının dosyaları, entity.lock içinde onlar için kaydedilen sabitlemelerle eşleşmiyor (dosyanın bir özeti var ve onun için hiçbir sabitleme kaydedilmemiş). Kaynak bilerek değiştirildiyse, dosyalarını yeniden kaydetmek için varlık üzerinde çalıştırın; aksi hâlde dosyaları geri yükleyin)
the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (varlığın yerel kaynağının dosyaları, entity.lock içinde onlar için kaydedilen sabitlemelerle eşleşmiyor (dosya artık kaynakta değil, ancak kaydedilmiş bir sabitlemesi var). Kaynak bilerek değiştirildiyse, dosyalarını yeniden kaydetmek için varlık üzerinde çalıştırın; aksi hâlde dosyaları geri yükleyin)
Nasıl düzeltilir: içe aktarılan bir dosyada olduğu gibi iki yanıt vardır ve hangisinin doğru olduğu değişikliğin bilerek yapılıp yapılmadığına bağlıdır. Bilerek yapıldıysa, kaynağının dosyalarının yeniden sabitlenmesi için Recipe üzerinde aggrega pin çalıştırın ve yeniden yazdığı entity.lock dosyasını commit edin. Bilerek yapılmadıysa, iletinin adlandırdığı dosyaları geri yükleyin.
A symbolic link sits among the files an entity carries (Bir varlığın taşıdığı dosyalar arasında bir sembolik bağlantı bulunuyor)
Bir varlığın bir yayınının taşıdığı her dosya varlığın kendi dizininden okunur ve oradaki bir sembolik bağlantı izlenmek yerine reddedilir. Onu izlemek, işaret ettiği baytları, işaret ettiği her yerden (varlığın dizininin dışı da dahil) bağlantının kendi adı altında, ardından özeti alınan ve imzalamanın geçerli olduğu yerde imzalanan bir yapıta yayımlamak anlamına gelirdi. Onu atlamak ise içeriği dizininizden sessizce farklılaşan bir yapıt yayımlamak olurdu. Bu yüzden her bağlantı biçimi aynı şekilde reddedilir: bir dosyaya bağlantı, bir dizine bağlantı, hiçbir yeri işaret etmeyen bir bağlantı, kendini işaret eden bir bağlantı ve birbirini işaret eden iki bağlantı.
Ret, varlığın dosyalarının okunduğu her yerde yapılır: aggrega pin tarafından, herhangi bir şeyi paketlemeden önce bir yayın tarafından (kuru çalıştırma da dahil), entity.lock dosyasını varlığın dosyalarıyla karşılaştıran bir pull ve doğrulayan bir pull tarafından, bir yerel kaynağı sabitlemeleriyle karşılaştıran bir derleme tarafından ve herhangi bir kısmı bir provider’a verilmeden önce bir yerel kaynak dizinini okuyan bir işleme tarafından. İleti bağlantıyı varlık belgesinin yanındaki yoluyla adlandırır ve tanılama bağlantının kendisine konumlandırılır.
Yok sayma kurallarınızın dışarıda bıraktığı bir bağlantı, varlığın taşıdığı bir dosya değildir; bu yüzden bu kuralların dışarıda bıraktığı diğer her dosya gibi atlanır ve hiçbir zaman izlenmez. Bu kurallar, varlık sabitlendiğinde entity.lock içine kaydedilenlerdir; bu yüzden .aggregaignore dosyasına eklediğiniz bir satır, varlığı yeniden sabitlediğinizde etkili olur.
Üretilen ileti:
a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (bir varlığın taşıdığı dosyalar arasında bir sembolik bağlantı bulunuyor. çözüm: bağlantıyı, işaret ettiği şeyin varlığın kendi dizinine yerleştirilmiş bir kopyasıyla değiştirin. Bir kaynak dizininde karşılaşılan bir bağlantı bunun yerine varlığın yanındaki .aggregaignore dosyasına eklenen bir satırla dışarıda bırakılabilir; bu, varlık yeniden sabitlendiğinde etkili olur. Bir bağlantı izlenmek yerine reddedilir, çünkü işaret ettiği baytlar, işaret ettiği her yerden bağlantının adı altında taşınırdı)
Nasıl düzeltilir: varlığın bağlantının işaret ettiği şeye ihtiyacı varsa, bağlantıyı varlığın dizini içindeki bir kopyasıyla değiştirin ve varlığı yeniden sabitleyin. Bağlantı kendi kolaylığınız için oradaysa ve varlık onu okumuyorsa, yolunu varlık belgesinin yanındaki .aggregaignore dosyasına ekleyin ve yeniden sabitleyin. Bir varlıkla hangi dosyalar gönderilir, bir varlığın neyi taşıdığına karar veren kuralları açıklar.
An entity reads an input the lock beside it records no pin for (Bir varlık, yanındaki kilidin pin kaydetmediği bir girdiyi okuyor)
Bir Recipe ya da FeatureRecipe kendi belgesinin dışındaki baytlara bağlı olabilir: koordinatları tam olarak yazılmış uzak bir source:, bir artifacts girdisinin $import ile içe aktardığı bir dosya ve yanındaki bir dizini ya da dosyayı adlandıran bir source: ögesinin dosyaları. Her birinin pin’i varlığın yanındaki entity.lock içinde kaydedilir ve bunu kaydetmek varlık yazarının adımıdır: aggrega pin. Bu nedenle bir pull bu pin’leri kendiliğinden kaydetmez: Release’in derlediği, katalog dizinlerinizden birindeki bir varlık üzerinde, adımın kaydedeceği şeyi kilidin tuttuğuyla karşılaştırır ve kilitte bir pin eksik olduğunda — ya da girdinin artık eşleşmediği bir pin bulunduğunda — yazarın dizinine istenmeden yazmak yerine durur. Kendi kilit dosyasını dolduran bir derleme de bir pull’dur ve aynı şekilde durur.
Bir push da aynı karşılaştırmada, yayımlamak üzere olduğu tek varlık üzerinde durur. Paket oluşturulmadan ve herhangi bir kayıt defterine bağlanılmadan önce, adımın varlık için kaydedeceği şeyi yanındaki kilitle karşılaştırır ve push’tan adımı kendisinin çalıştırması istenmediyse — kuru çalıştırma dahil — aynı şekilde reddeder. İletinin sonunda önerdiği şey ikisi arasında farklılık gösterir, çünkü her komutun pin’leri kaydettirmenin kendine ait yolları vardır; bildirdiği şey ise farklılık göstermez.
Yerel bir kaynak, pin’lerine tek bir dosya kümesi olarak tabi tutulur. Kilit bunların hiçbirini kaydetmiyorsa, kaynağın katkıda bulunduğu her dosya burada eksik olarak bildirilir. Kaydediyorsa, pin’den sonra eklenen bir dosya eksik olarak, değiştirilen ya da kaldırılan bir dosya ise girdinin artık eşleşmediği bir pin olarak bildirilir ve bir derleme aynı değişikliği A local source no longer matches the pins recorded beside its Recipe (Yerel bir kaynak artık Recipe’inin yanında kaydedilen pin’lerle eşleşmiyor) olarak bildirir. Bir kilidin, Recipe’in artık bildirmediği yerel bir kaynak için hâlâ kaydettiği pin’ler — source: ögesi kaldırılmış ya da artık uzak bir yapıtı adlandırıyor olsun — Recipe’in okuduğu hiçbir şeyi sabitlemez; bu yüzden ne bir pull’u, ne bir push’u, ne doğrulayan bir pull’u ne de bir derlemeyi durdurur; bir sonraki aggrega pin bunları atar.
İleti, eksik olan her girdiyi sınıfıyla adlandırır. Her biri ya url’si ve çözümlendiği sürümle adlandırılan bir remote source, ya onu tüketen artifacts anahtarıyla adlandırılan bir imported file ya da varlığın yanındaki yoluyla adlandırılan bir local source file olur; böylece pin’lenmesi gerekenin bir kaynak mı yoksa bir dosya mı olduğunu bilirsiniz. Release’teki bu türden her varlık tek bir çalıştırmada bildirilir.
Bir kayıt defterinden çözümlenen bir varlık, bir pull tarafından buna asla tabi tutulmaz, çünkü yayımlanması zaten tabi tutulmuştur. Sizin yazdığınız bir dizinde değil içerik önbelleğinde bulunur; bu yüzden bir pull yanında bir kilidi ne okur ne yazar ve kaynakları Release’in kilit dosyasına tabi tutulur. aggrega push ile yayımlanan bir varlık, kilidi adımın o anda onun için kaydedeceği her pin’i kaydetmiyorsa yayımlanırken reddedilmiştir ve o kilit yayımlanan paketin içinde taşınır.
Bir pull’dan ve bir push’tan üretilen iletiler:
an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (varlığın okuduğu bir girdi için yanındaki entity.lock içinde kaydedilmiş bir pin yok (Recipe, uzak kaynak: pin kaydedilmemiş, içe aktarılan dosya: kaydedilen pin artık onunla eşleşmiyor). çözüm: komutu çalıştırın ve varlığın yanına yazdığı entity.lock dosyasını commit edin; bunun yerine bu çalışma alanındaki her pull’un pin’leri kendisinin kaydetmesi için çalışma alanı yapılandırmasında ilgili ayarı yapın)
an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (varlığın okuduğu bir girdi için yanındaki entity.lock içinde kaydedilmiş bir pin yok (Recipe, uzak kaynak: pin kaydedilmemiş). çözüm: komutu çalıştırın ve varlığın yanına yazdığı entity.lock dosyasını commit edin; bunun yerine bu yayımlamanın pin’leri kendisinin kaydetmesi için onu ilgili bayrakla yeniden çalıştırın; bu çalışma alanındaki her yayımlamanın bunları kaydetmesi için çalışma alanı yapılandırmasında ilgili ayarı yapın)
Yayımlamanın orta yan cümlesi, yayımladığınız yüzeyin kabul ettiği şeyi adlandırır: terminalde --pin-sources, daemon’da pinSources alanı ve asistan aracında pin_sources argümanı.
Nasıl düzeltilir: varlık sizinse, üzerinde aggrega pin komutunu çalıştırın ve yazdığı entity.lock dosyasını commit edin, ardından yeniden pull ya da push yapın — ya da adımı paket oluşturulmadan önce çalıştıran --pin-sources ile push yapın. Başkasınınsa — kendi dizininden tükettiğiniz bir katalog — yayımlayıcısı onu henüz pin’lememiştir; her pull’un pin’leri kendisinin kaydetmesi için çalışma alanı yapılandırmanızda pin_sources_at_pull: true ayarlayın ya da tek bir pull’a --pin-sources verin. aggrega pin adımı ayrıntılı olarak açıklar.
A provides: template could not be evaluated (Bir şablon değerlendirilemedi)
Bir provides: girdisi, başka bir bileşenin bir bağımlılık bağlantısı üzerinden okuduğu değeri üreten bir şablondur. Bu koşul, değerlendirilemeyen bir girdinin bildirdiği şeydir: ayrıştırılamayan bir şablon, bu yüzeyin kaydetmediği bir işlevi çağırması, işleme bağlamının sağlamadığı bir şeyin içine inen bir başvuru ya da haritanın tutmadığı bir anahtarın index ile okunması.
Aynı blokta değerlendirmeden önce çalışan iki retten farklıdır — kendi kendine yeterli kümenin dışındaki bir köke yapılan başvuru ve bloğun kendi yazım sırasının reddettiği bir başvuru; ikisi de yukarıda belgelenmiştir. Bunlar değiştirilmesi gereken ifadeyi adlandırır; bu ise değerlendirmenin kendisi ne bildirdiyse onu taşır ve girdinin yanında adlandırılmasının nedeni budur.
Bileşen örneğini, bloğun içindeki girdiyi ve değerlendirmenin bildirdiği şeyi adlandıran üretilen ileti:
provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (provides şablonu değerlendirmesi başarısız oldu (düğüm, provides[], değerlendirmenin bildirdiği))
Değerlendirme ne bildirirse bildirsin, başlık bu koşulun kodunu taşır: E0056. Değerlendirme kendi durdurucu koşullarından birinde durduğunda — en yaygını, haritanın içermediği bir anahtarın index ile okunmasıdır — o koşul bunun yerine değil, bunun altında bildirilir: caused by (2): altında önce bu koşulun cümlesi, ikinci olarak da değerlendirmenin kendi raporu, cümlesiyle birlikte gelir. Böylece kodları eşleştiren bir okuyucu, başarısız her provides: girdisini E0056 koduyla eşler ve değerlendirmeyi neyin başarısız kıldığını altındaki koşuldan okur; o koşulun cümlesi tüm koşulların tablosunda kendi koduna karşılık gelir — eksik anahtar için E0327.
Nasıl düzeltilir: Recipe’in provides: bloğunu iletinin adlandırdığı anahtarda açın ve bildirilen nedeni okuyun — bu genellikle bir ayrıştırma konumunu ya da bir işlevi adlandırır. Bu yüzeydeki eksik anahtar işleme, eksik bir son anahtarı başarısız olmak yerine boş olarak işler; bu yüzden buradaki bir başarısızlık yapısal bir hatadır: ayrıştırılamayan bir şablon, hiç sağlanmamış bir kapsayıcının içine inen bir başvuru ya da haritanın tutmadığı bir anahtarın index ile okunması; bildirilen neden bunu adlandırır. Değer gerçekten isteğe bağlıysa, orada olmayabilecek bir şeyin içine inmek yerine onu optional yardımcısıyla okuyun.
A Recipe or FeatureRecipe does not publish a provides key its contract declares (Bir Recipe veya FeatureRecipe, sözleşmesinin bildirdiği bir anahtarı yayımlamıyor)
Bir Component ve bir Feature, schema.provides altında, kendilerini bağlayan her şeyin yayımlayacağı anahtarları bildirir: bu, bir tüketicinin bağlantılarını ona göre yazdığı çıktı sözleşmesidir. Bir Component’e bağlı Recipe ile bir Feature’a bağlı FeatureRecipe, bu sözleşmenin adlandırdığı her anahtarı üretmek zorundadır. Üretmeyen reddedilir; çünkü aksi hâlde eksik anahtar hiçbir şey iletmez: tüketicinin başvurusu, nedeni hakkında hiçbir şey söylenmeden, atanmamış bir değişken, boş bir argüman ya da var olmayan bir dosya olarak ulaşır.
Sözleşme yalnızca anahtarın varlığıdır, fazlası değil. Bildirilen her anahtar bulunmak zorundadır; fazladan anahtarlara izin verilir. Değerlerin kendisi hiçbir zaman incelenmez: bunlar dize olarak aktarılan opak işaretçilerdir; bu yüzden bir sözleşmenin bildirdiği türler, derlemenin yaptığı bir denetim değil, tüketiciye yönelik bir beyan olarak kalır.
Her eksiklik raporlanır. Üç anahtarı eksik olan bir Recipe, her biri o Recipe’in provides: bloğundaki kendi girdisinde konumlanmış üç bulgu üretir; böylece üçü de tek bir derlemeden düzeltilir. İleti eksik anahtarı, sözleşmesi onu bildiren türü ve Recipe’in bağlandığı örneği adlandırır; sonuncusu, tek bir Recipe bir türün birkaç örneğine hizmet ettiğinde iki bulguyu birbirinden ayıran şeydir.
Üretilen ileti:
Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (Recipe veya FeatureRecipe, soyut varlığının schema.provides sözleşmesinin bildirdiği bir provides anahtarını yayımlamıyor; bileşen türünce bildirilen, bileşen örneğine bağlı)
Feature ile FeatureRecipe eşleşmesi aynı durumu, eklemenin kendi çözümlemesi üzerinden, eşi ve anahtarı adlandırarak raporlar:
Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (Recipe veya FeatureRecipe, soyut varlığının schema.provides sözleşmesinin bildirdiği bir provides anahtarını yayımlamıyor; FeatureRecipe, Feature’ın schema.provides sözleşmesinin bildirdiği provides anahtarını yayımlamıyor)
Orada sıralı düzende ilk eksik anahtarı raporlar ve durur; bu yüzden o eşleşme her derlemede bir anahtar adlandırırken Component eşleşmesi hepsini adlandırır. Anahtarlar her iki durumda da sıralı düzende dolaşılır; ikisini de çalıştırmalar arasında aynı kılan budur.
Nasıl düzeltilir: eksik anahtarı Recipe’in veya FeatureRecipe’in provides: bloğuna ekleyin ya da onu yayımlaması beklenen hiçbir şey yoksa Component’in veya Feature’ın schema.provides alanından kaldırın. Şablonu boş işlenen bir anahtar yine de değer olarak boş dizeyle yayımlanır; bu yüzden var olan ve boş olan bir girdi sözleşmeyi karşılar ve burada raporlanmaz. Boş bir değerin derlemeyi durdurması gereken yerde onu bir doğrulamada reddedin: bir Recipe’in doğrulamaları, çözümlenmiş provides: değerlerini okur.
An assertion stopped the build (Bir doğrulama derlemeyi durdurdu)
Bir Component, Feature, Recipe ya da FeatureRecipe assertions: taşıyabilir: amacı metin üretmek değil, bir girdiyi reddetmek olan adlandırılmış şablonlar. Bir doğrulama fail işlevini çağırır ve onu çağırmak derlemeyi durduran şeydir; argüman, yazarının onunla karşılaşan kişi için yazdığı iletidir.
Doğrulamalar iki noktada değerlendirilir; böylece bir kural, ilgili olduğu durumu okur: bir Component ya da Feature üzerindekiler katalog çözümlendikten sonra ve herhangi bir şey işlenmeden önce çalışır; bir Recipe ya da FeatureRecipe üzerindekiler ise bağlama kesinleştikten sonra ve o bağlama işlenmeden önce çalışır.
Hiçbir şeyin sağlamadığı bir anahtara başvuru da burada raporlanır. Yüzey, katı eksik anahtar işlemesiyle değerlendirir; tam da başvurusu boş işlenen bir koşul hiçlikle karşılaştırılıp sessizce geçmesin diye: aksi hâlde tek bir yazım hatası, doğrulamanın uygulamak için yazıldığı kuralı devre dışı bırakırdı. Bu yüzden düz bir default bu yüzeyde bir yedek değer sağlamaz: yalın başvuru, yedek çalışamadan değerlendirmeyi durdurur. Başvuruyu hasKey ile koşula bağlayın ya da optional yardımcısını kullanın; onu index ile okumak da, “A template indexes a map with a key the map does not hold” bölümünün anlattığı gibi, anahtarı adlandırarak durdurur.
Varlık türünü ve tipini, örneği ve doğrulamayı adlandıran, ardından doğrulamanın kendisinin yazdığı iletiyi taşıyan üretilen ileti:
<entity-kind>"<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (fail çağrılırken hata: doğrulama başarısız oldu)
ve hiçbir şeyin sağlamadığı bir anahtar için, koşulun kendi cümlesinden sonra şablon motorunun cümlesi:
<entity-kind>"<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (doğrulama başarısız oldu: şablon çalışırken eşlemede bu anahtar için girdi yok)
ve başarısız olan koşul değil de değerlendirme olduğunda:
Hassas olarak bildirilen bir değer iletide görünmez. Doğrulama böyle bir değeri okuyup fail işlevini, cümlesi tek bir tırnaklı dize olarak açıkça yazılmış biçimde çağırdığında — fail "…", içine hiçbir şey aktarılmadan ve hiçbir şey birleştirilmeden — ileti, değer ne tutarsa tutsun, o cümleyi yazıldığı gibi taşır; çünkü cümle doğrulamanın okuduğu hiçbir şeyi alıntılamaz. İletisi değeri alıntıladığında, ileti değerin yerinde <redacted> gösterir. İleti başka herhangi bir şekilde oluşturulduğunda ve doğrulamanın yaptığı şey değerin içeriğine bağlı olduğunda, başarısız ifadeden sonraki ileti failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds ile değiştirilir; durma ve kodu değişmez. Neyin bildirilmiş sayıldığı ve hangi reddetmelerin bunun dışında kaldığı vocabulary/compact-form-authoring.md “Bir reddetmenin bildirilmiş bir değer hakkında söyledikleri” bölümündedir.
Tek başına denetlenen bir varlık, başarısız bir doğrulamayı uyarı olarak raporlar. Bir Recipe’in dosyası verilen aggrega validate, editörün o dosyayı aggrega serve üzerinden denetlemesi ve bir entity verilen aggrega mcp aracının validate aracı, Recipe’i bir Release’in belirlediği değerler yerine yer tutucular ve şema varsayılanları etrafında derler; bu yüzden bir Release’i bekleyen bir doğrulamayı bozuk olandan ayırt edemezler. Orada fail çağıran bir doğrulama (Recipe’in kendisininki ya da uyguladığı Component’in bildirdiği) yukarıdaki iletiyi taşıyan ve A Release must satisfy this assertion before a build of it can pass. cümlesiyle kapanan bir uyarı olarak raporlanır ve denetim geçer. Hiçbir şeyin sağlamadığı bir anahtara başvuru ve ayrıştırılamayan bir doğrulama başarısız doğrulama değildir: her biri doğrulamanın kendi metnindeki bir hatadır ve o denetim onu diğer her hata gibi değerlendirir. Bir derlemenin her zaman bir Release’i vardır ve burada anlatıldığı gibi doğrulamada durur; bkz. başarısız bir doğrulama bir uyarıdır.
Nasıl düzeltilir: son iki noktadan sonraki ileti doğrulama yazarınındır ve neyin değiştirileceğini söyleyen odur; bir doğrulama, onunla karşılaşmak size yanıtı söyleyecek şekilde yazılır. Rapor yazarın cümlesi değil de eksik bir anahtar olduğunda hata doğrulamanın kendisindedir: başvuruyu düzeltin ya da yukarıda anlatıldığı gibi koruma altına alın. Kuralın bu Release’e uygulanmaması gerektiğinde bu, kendi dosyanızla değil doğrulamayı taşıyan varlıkla ilgili bir sorudur.
Bir pipeline adımı, düğümde bulunmayan belgeleri adresliyor
Bir pipeline adımı bir belgeyi bir kapsam ve bir anahtarla adresler. Bir adresin hiçbir şeye ulaşmadığı durumları üç koşul kapsar ve her biri, bir adımın hiç gerçekleşmemiş bir düzenleme üzerinden başarı bildirmesine izin vermek yerine derlemeyi durdurur.
Düğüm onu üretmedi. Bir yama, bu düğümün ürettiği belgeler arasında bulunmayan bir kapsam-anahtar çiftini adlandırır:
node "<instance>": pipeline PATCH targets a document the node did not emit (düğüm: pipeline PATCH, düğümün üretmediği bir belgeyi hedefliyor)
Adreslenecek bir ana bileşen yok. Bir adım, hiçbir ana bileşene karşı durmayan bir konumda bir ana bileşenin belgelerine erişmeye çalıştı: tek kapsamı kendi çıktısı olan bir bileşenin kendi pipeline’ı ya da tek bir bileşene değil bir sınıra eklenmiş bir Feature. Böyle bir pipeline’ın çalıştığı her yerde ana bileşen kapsamı boştur, bu nedenle ona yönelik bir adres hiçbir şeye karşı çözümlenmez:
node "<instance>": pipeline /host operation from a step with no host component (düğüm: ana bileşeni olmayan bir adımdan pipeline /host işlemi)
Belge, adreslenecek bir ağaç taşımıyor. Bazı birimlerin bir yolun işaret edebileceği bir yapısı yoktur: ikili bir gövde, serbest metin, hedefin güvenle dolaşamayacağı bir bölge. Böyle bir birim, seçilip bütün olarak üretilebilmesi için yine de adıma verilir; yapılamayan şey ona yama uygulanmasıdır:
node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (düğüm: pipeline PATCH hedefi ayrıştırılabilir yapılandırılmış YAML/JSON değil)
pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (pipeline PATCH hedefi ayrıştırılabilir yapılandırılmış YAML/JSON değil (düğüm, belge))
Her biri, dolaşmanın altındaki adrese ilişkin kendi açıklamasıyla gelir ve her biri, pipeline’ı onu oluşturan bileşen örneğinde konumlandırılır.
Üçünden ikisi herhangi bir dolaşmadan önce de bildirilir. Bir konumun ana bileşen belgelerine sahip olup olmadığı pipeline’ın nereye yazıldığından çıkar; bu nedenle ana bileşen belgeleri üzerinde çalıştığını bildiren ve böyle belgesi olmayan bir konumdaki bir adım, bir düğümün işlenmesini beklemeden, derleme her plugin’in ne bildirdiğini öğrenir öğrenmez adlandırılır; bir sınıra eklenmiş bir Feature da adımla birlikte adlandırılır:
pipeline /host operation from a step with no host component (ana bileşeni olmayan bir adımdan pipeline /host işlemi)
pipeline /host operation from a step with no host component ("<attachment>") (ana bileşeni olmayan bir adımdan pipeline /host işlemi)
Bu iki okuma, aynı bulgunun iki kez bildirilmesi değil, tek bir koşulun bölünmesidir: bir bildirimin karara bağlayabileceği şey bildirimden karara bağlanır, yalnızca çalıştırmanın görebileceği şey ise çalıştırmada kalır; kendi kapsamını bildiren bir adım yine de başka bir kapsama karşı bir işlem döndürebilir.
Bu üçü, pipeline dolaşmasının kendisinin bildirdiği adresleme retlerinin derlemeyi durduran biçimidir ve yukarıda “A pipeline patch addresses a document the set does not hold, or one with no tree to address (Bir pipeline yaması, kümenin içermediği ya da adreslenecek ağacı olmayan bir belgeyi adresliyor)” başlığı altında belgelenmiştir.
Nasıl düzeltilir: üçü de sizin değil adım yazarının sorumluluğundadır. Bulunmayan bir hedef için, düğümün gerçekten ürettiği bir belgeye yama uygulayın ya da kastettiğiniz belgeyi önceki bir adımda üretip sonraki bir adımda ona yama uygulayın; bir adım kendisine hangi anahtarların verildiğini okuyabilir. Eksik bir ana bileşen için, adımı bir ana bileşene karşı duran bir konuma taşıyın, bunun yerine konumun kendi belgelerini adresleyin ya da adımı kaldırın. Ağacı olmayan bir birim için, yamayı birimin tamamını üreten bir emit ile değiştirin: opak bir gövde düzenlenmez, değiştirilir.
Bir pipeline yaması henüz birleştirilmemiş çıktıyı adresliyor
Bazı sağlayıcılar bir dağıtım grubunun düğüm başına çıktısını tek bir belgede birleştirir: birleştirilmiş bir compose dosyası, bir şemsiye chart. Bu birleştirme gerçekleşene kadar ayrık belgeler yoktur, yalnızca parçalar vardır; bu nedenle bunlardan birini adresleyen bir yamanın işaret edebileceği bir şey yoktur. Böyle bir bileşene karşı bir pipeline bu yüzden bütün olarak ertelenir ve birleştirme belgeleri ürettiğinde yeniden oynatılır; bu olağan yoldur ve yazardan hiçbir şey gerektirmez.
Bu koşul, bir yama yine de bir parçaya ulaştığında derlemeye yansıyan durumdur. Adlandırdığı durum, eklenmiş bir Feature’ın kendi çıktısıdır. Bileşenin sağlayıcısı grubunu birleştirdiğinde, eklemenin pipeline’ının tamamı birleştirme belgeleri üretene kadar bekletilir ve bu yeniden oynatmaya verilen şey yalnızca bileşenin belgeleridir. Feature’ın kendi çıktısına karşı bir adım yalnızca bileşen işlenirken, yani herhangi bir birleştirme gerçekleşmeden önce sunulur; bu nedenle adresleyecek bir şeyi yoktur. Bu, Feature’ın kendi çıktısı nasıl iletilirse iletilsin geçerlidir: ister birleştirmeye katılsın ister kendi belgeleri olarak yazılsın, kendi kapsamı hiçbir zaman yeniden oynatmanın taşıdığı kapsam değildir.
Üretme hiçbir zaman etkilenmez. Bir emit bir belgeyi düzenlemek yerine bir belge ekler ve her sağlayıcı için düğüm başına çalışır; bu nedenle bunun tamamen dışındadır.
Koşul, plugin’lerin ve sağlayıcıların bildirdiklerinden yola çıkılarak herhangi bir dolaşmadan önce ve bir düğüm işlenirken bir taban olarak yeniden bildirilir. Üretilen iletiler:
pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (pipeline PATCH, bir birleştirici sağlayıcının birleştirme öncesi parçalarını hedefliyor)
pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (pipeline PATCH, bir birleştirici sağlayıcının birleştirme öncesi parçalarını hedefliyor (düğüm, kapsam belgesi bir birleştirici sağlayıcı tarafından işleniyor). birleştirme sonrası aşama, belgeler ayrık hale geldiğinde bu PATCH’i yeniden çalıştırır)
Nasıl düzeltilir: Feature’ın kendi belgeleri yerine bileşenin belgelerini adresleyin; birleştirmeden sonra yeniden oynatılan biçim budur. Ya da bileşeni dağıtım grubunu birleştirmeyen bir sağlayıcıya alın ya da adımı kaldırın. Üçünden hangisinin doğru olduğu, adımın neyi değiştirmek için yazıldığına bağlıdır ve ileti, ayırt edebilmeniz için adreslediği kapsamı adlandırır. FeatureRecipe’in kendi capability: alanını değiştirmek bunlar arasında değildir: birleştirmeden sonraki yeniden oynatmaya hangi kapsamın verildiğini değiştirmez ve bu koşulun konusu da budur.
Bir pipeline adımının plugin’i, adreslediği şeyi işleyen sağlayıcıyı sahiplenmiyor
Bir pipeline adımının kullandığı bir plugin, karşısında test edildiği sağlayıcıları bildirebilir. Bu liste örtük bir “benzer her şey” değil, açık bir beyandır: bir plugin’i adlandırmadığı bir sağlayıcıya karşı çalıştırmak, başka bir çıktı biçimi için yazılmış bir yama riski taşır; bu nedenle derleme denemek yerine durur.
Bir adımın eşleştirildiği sağlayıcı, o adımın adreslediği belgeleri işleyen sağlayıcıdır: bileşenin belgelerine karşı bir adım için bileşenin kendi sağlayıcısı, Feature’ın belgelerine karşı bir adım için Feature’ın kendi sağlayıcısı. Bir bileşene eklenmiş bir Feature’da ikisi de ortaya çıkar ve bunlar iki farklı belgeden gelen iki farklı değerdir.
Boş ya da bulunmayan bir beyan listesi hiçbir şeyle eşleşmez; bu nedenle böyle bir plugin’i kullanan her adım burada bildirilir. Derlemenin soramadığı bir plugin farklı bir durumdur ve burada bildirilmez: elde edilemeyen bir öz bildirim boş bir beyan değil, beyanın yokluğudur ve böyle bir adım çözümleme, yükleme ya da öz bildirim hatasının kendisiyle durur; onarılması gereken de odur.
Derleme her Plugin’in kendisi hakkında ne bildirdiğini öğrendiği anda, adımı çağıracak çalıştırmadan önce bildirilir; derleme başına bir kez değil, yazılan her adım için bir kez bildirilir; böylece yazar bir pipeline’ın sorunlu tüm adımlarını tek bir derlemeden görür. Provider adları birebir eşleştirilir.
Üretilen iletiler; ilki bir bileşenin kendi pipeline’ından, ikincisi ise eklemeyi de adlandıran bir Feature’ın pipeline’ından:
pipeline plugin is not compatible with the rendering provider ("<provider>") (pipeline plugin’i işleyen sağlayıcıyla uyumlu değil)
pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (pipeline plugin’i işleyen sağlayıcıyla uyumlu değil)
Nasıl düzeltilir: bulgu yazılan adımda konumlandırılır ve adlandırdığı sağlayıcı, bildirimin karşısında uzlaştırılması gereken şeydir. Plugin sizinse, sağlayıcıya karşı test ettikten sonra onu plugin’in bildirdiği uyumluluğa ekleyin. Değilse, sağlayıcıyı sahiplenen bir plugin sürümü seçin, o kapsamı plugin’in sahiplendiği bir sağlayıcı üzerinden işleyin ya da adımı kaldırın.
A provider refused a node’s input (Bir provider bir düğümün girdisini reddetti)
Bir provider, bir bileşen için kendisine verilen girdiyi işlemeden önce denetleyebilir ve bulduklarını bildirebilir. Durdurma önem derecesindeki bulgular derlemeyi durdurur; uyarı ve bilgi önem derecesindeki bulgular derlemenin çıktısıyla birlikte gösterilir ve üretilen baytlarda hiçbir şeyi değiştirmez.
Bu, derleyicinin değil provider’ın girdinizi kendi okumasıdır; bu nedenle neye itiraz ettiğine ve bunu ne kadar ayrıntılı söylediğine provider karar verir. Derleyici bileşeni ve provider’ı adlandırır ve provider’ın iletilerini döndürüldükleri gibi taşır; bir provider birden çok ileti bildirdiğinde bunlar noktalı virgüllerle ayrılmış olarak birlikte gelir, böylece tek bir derleme size hepsini bildirir.
Girdi ister bir bileşenin kendi Recipe’ine ister bağlı bir Feature’a ait olsun aynı yönlendirme kullanılır; bu nedenle bir provider’ın denetimi her ikisinde de aynı biçimde okunur.
Nasıl düzeltilir: provider’ın iletilerini okuyun; bunlar çözümlenmiş girdide neyi kabul edemediğini belirtir. Girdi, Recipe’in değerlerinden ve bileşenin kendi yapılandırmasından oluşturulur; bu nedenle düzeltme genellikle bunlardan birindedir; provider’ın kendi başvuru sayfası neyi gerektirdiğini açıklar. Provider bir belgeden değiştiremeyeceğiniz bir şeye itiraz ediyorsa, bu Recipe’i veya plugin’i yazan kişiye yöneltilecek bir sorudur.
A provider rendered the same input twice and produced different output (Bir provider aynı girdiyi iki kez işledi ve farklı çıktı üretti)
Aynı girdi verildiğinde bir derleme aynı çıktıyı üretir; inceleme araçları ve dağıtım araçları bir derlemenin sonucunu bu sözleşmeye göre okur. İsteğe bağlı bir derleme kipi bunu doğrudan denetler: her bileşen aynı girdiden iki kez işlenir ve üretilen baytlar karşılaştırılır. İki işlemesi birbirini tutmayan bir provider ikisi arasında durum taşıyordur ya da başka bir nedenle girdisinin bir fonksiyonu değildir ve derleme durur.
Olağan derleme her bileşeni bir kez işler; bu nedenle bu duruma yalnızca denetim kipinde rastlanır. Bu kipin bulunması normal bir derlemede hiçbir şeyi değiştirmez.
Karşılaştırılan, provider’ın ham üretilmiş çıktısıdır (işlenmiş yapıtların ayrıldığı baytların ta kendisi); böylece yalnızca son bir dosyaya kadar ulaşan bir fark değil, ürettiği şeyin herhangi bir yerindeki fark yakalanır.
Üretilen ileti:
rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (düğüm işleniyor: düğüm (provider): aynı girdinin iki işlemesi farklı çıktı üretti: provider işlemesi deterministik değil)
Nasıl düzeltilir: önce iletinin adlandırdığı bileşenin iki derlemesi arasında neyin farklı olduğunu bulun; bileşeni iki kez derleyip çıktıları karşılaştırın. Fark, kaynak olarak kullandığınız bir chart’ın her işlemede yeniden ürettiği bir değerse (rastgele bir parola, üretilmiş bir anahtar, bir Secret ya da ConfigMap içindeki bir zaman damgası), hata provider’da değil o chart’ın çıktısındadır ve bunu iki yoldan biriyle kendiniz giderebilirsiniz. Değeri, chart’ın bunun için sunduğu ayar üzerinden Recipe’in valuesMapping: alanından sağlayın; böylece chart onu üretmeyi bırakır. Ya da üretilen belge Release’in göndermemesi gereken bir belgeyse (örneğin operatörün ayrıca sağladığı bir Secret), onu Recipe üzerindeki bir omits: girdisiyle derlemenin dışında bırakın; bkz. Recipe → omits: alanı. Aksi halde hata sizin belgelerinizde değil provider’dadır ve yazabileceğiniz hiçbir şey onu gidermez. Bunu, iletinin tanımladığı bileşeni belirterek o provider’a hizmet eden plugin’i yayımlayan kişiye bildirin; olağan nedenler bir zaman damgası, rastgele bir değer ya da yazarın yazdığı sırayı değil bir map’in yineleme sırasını izleyen bir sıralamadır. Düzeltilene kadar olağan derleme kipi etkilenmez ve plugin’i denetimi geçen bir sürüme sabitlemek pratik çözümdür.
An omits entry left out nothing the source rendered (Bir omits girdisi kaynağın işlediği hiçbir şeyi dışarıda bırakmadı)
Bir Recipe’in ya da FeatureRecipe’in omits: listesindeki, bir derlemeye uygulanan her girdi (when: alanı yoksa, boşsa ya da doğruysa), kaynağın işlediği en az bir şeyi çıktının dışında bırakmalıdır: bir chart’ın işlediği bir belge, bir compose dosyasının bildirdiği bir service, volume ya da config veya bir CloudFormation şablonunun bildirdiği bir kaynak. Kaynağı işleyen provider her girdiyi işlediği şeylerle eşleştirir ve her girdinin kaç birimi dışarıda bıraktığını bildirir; hiçbir şeyi dışarıda bırakmayan bir girdi derlemeyi durdurur.
Hiçbir şeyle eşleşmeyen bir girdi, kaynak hakkında artık doğru olmayan bir ifadedir. Olağan neden, girdinin adlandırdığı şeyi yeniden adlandıran ya da kaldıran bir kaynak yükseltmesidir (yeniden adlandırılan bir belge ya da service bu durumda yeni adıyla çıktıda yer alır ve bu tam da girdinin dışarıda tutmak için yazıldığı şeydir); diğer neden ise girdinin kendisindeki bir hatadır. Bunu görmezden gelmek, girdinin dışarıda bırakması amaçlanan şeyi göndermek olurdu; bu nedenle derleme durur ve girdiyi adlandırır.
İleti; düğümü, provider’ı, girdiyi bildiren belgeyi ve girdinin o belgenin omits: listesindeki konumunu (0’dan başlayarak sayılır) ve girdinin çözümlendiği kind, ad ve namespace’i adlandırır; namespace yalnızca girdi bir namespace adlandırıyorsa gösterilir. Bir bileşene bağlı bir FeatureRecipe için düğüm o bileşendir; bir sınıra bağlı olan için ise iletinin üstündeki satır bağlantıyı ve sınırını adlandırır. Birden çok girdi hiçbir şeyle eşleşmediğinde, yazdığınız sıradaki ilki adlandırılır; böylece her çalıştırmada aynı girdi adlandırılır. Şablonu hassas olarak bildirilmiş bir değeri okuyan bir alan, çözümlendiği değer olarak değil <redacted> olarak gösterilir. when: alanının düşürdüğü bir girdi provider’a hiç verilmez ve hiç denetlenmez.
Üretilen ileti. Kategori size köşeli parantezli başlıkta ulaşır:
an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (bir omits girdisi kaynağın işlediği hiçbir şeyi dışarıda bırakmadı (düğüm, provider, belge omits[konum], kind, ad, namespace). girdiyi kaynağın işlediği bir şeyi adlandıracak biçimde düzeltin ya da kaldırın; olağan neden onu yeniden adlandıran ya da kaldıran bir kaynak yükseltmesidir)
Başlık, bu durumun kısa kodu olan E0334’ü taşır.
Nasıl düzeltilir: girdiyi kaynağın şu anda işledikleriyle karşılaştırın (girdi kaldırılmış olarak derleyin ve bileşenin ne işlediğini okuyun), ardından girdinin kind, ad ya da namespace değerini düzeltin veya adlandırdığı şey artık yoksa girdiyi kaldırın. Bir chart için girdi bir belgeyi belgenin kendi kind, metadata.name değerleriyle ve girdi bir namespace adlandırıyorsa belgenin bulunduğu namespace ile adlandırır; bir compose dosyası için bir service, volume ya da config öğesini anahtarıyla adlandırır; bir CloudFormation şablonu için ise bir kaynağı Type değeri ve mantıksal kimliğiyle, kaynağın şablonlarından herhangi birinde adlandırır. Bkz. Recipe → omits: alanı.
A provider’s omitted counts do not match the omits entries it was handed (Bir sağlayıcının dışarıda bırakılan sayıları, kendisine verilen omits girdileriyle eşleşmiyor)
İşlenmiş birimleri dışarıda bıraktığını bildiren bir sağlayıcı, kendisine verilen her omits: girdisi için o girdinin kaç birimle eşleştiğini raporlar: girdi başına bir sayı, girdilerin verildiği sırayla. Eksik olan, çok az ya da çok fazla sayı içeren veya sıfırın altında bir sayı içeren bir rapor, bir girdinin herhangi bir şeyi dışarıda bırakıp bırakmadığını anlamanın yolunu bırakmaz; bu yüzden derleme durur. Bunun nedeni sizin yazdığınız bir şey değildir: bu durum, döndürdüğü çıktı bildirdiği sözleşmeye uymayan bir sağlayıcıyı raporlar.
Üretilen ileti. İleti düğümü ve sağlayıcıyı, ardından kaç girdinin verildiğini ve neyin geri döndüğünü belirtir; ya kaç sayı döndüğünü ya da sıfırın altındaki sayıyı ve hangi girdi için verildiğini:
a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (bir sağlayıcının dışarıda bırakılan sayıları, kendisine verilen omits girdileriyle eşleşmiyor (düğüm, sağlayıcı, verilen omits girdisi sayısı, döndürülen dışarıda bırakılan sayı adedi))
Baş kısım bu durumun kısa kodunu, E0336’yı taşır.
Nasıl düzeltilir: durumu, o sağlayıcıya hizmet eden eklentiyi yayımlayan kişiye, iletinin tanımladığı bileşeni belirterek bildirin. Bir sağlayıcının yükümlülükleri, eklenti sözleşmesinde İşlenmiş birimleri dışarıda bırakma başlığı altında açıklanır.
Assembled output still carries a cross-boundary placeholder (Birleştirilmiş çıktı hâlâ sınırlar arası bir yer tutucu taşıyor)
Bir bağımlılık bağlantısı birleştirilmiş iki çıktı arasında geçtiğinde, taşıdığı değer tüketen taraf işlenirken bilinemez: bu değer diğer tarafça yayımlanır ve her iki taraf da birleştirildikten sonra çözülür. Bu yüzden derleme, tüketen bileşenin girdisine bir yer tutucu yazar ve sağlayıcı, birleştirme oluştuğunda onu kendi çapraz başvuru biçimiyle değiştirir.
Bu durum, o değiştirmeden sağ çıkan bir yer tutucunun raporudur. Sağ çıkmak, çözümlemenin ona hiç ulaşmadığı anlamına gelir: değer sağlayıcının erişemediği bir yere düşmüştür (çoğu zaman bütün bir değer olarak durmak yerine daha uzun bir dizgeye eklenmiştir) ya da bir geçiş, diğer tarafta onu çözecek hiçbir şey olmadan damgalanmıştır. Yer tutucu hiçbir zaman geçerli çıktı değildir; bu yüzden derleme, yer tutucu içeren bir dosyayı teslim etmek yerine durur.
İleti, dosyayı yazan sağlayıcıyı ve dosyanın bulunduğu yolu belirtir: bir yol yalnızca tek bir birleştirme içinde benzersizdir; bu yüzden bir dosyayı ikisi birlikte tanımlar. Yalnızca ilki değil, sorunlu her dosya raporlanır ve her biri, içinde bulunduğu birleştirmeyi kaç sınır beslemiş olursa olsun bir kez raporlanır. Durum, içindeki bir sınıra karşı değil, Release belgesinin bütününe karşı raporlanır: hata bir sınır bildiriminde değil, bir değerin dosyaya ulaşma biçimindedir; bu yüzden değiştirilmesi gereken bir sınır bildirimi yoktur.
Üretilen ileti:
assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (birleştirilmiş çıktı çözülmemiş bir sınırlar arası bağlantı yer tutucusunu koruyor)
Nasıl düzeltilir: en yaygın neden, tüketen tarafın daha uzun bir dizgeye yerleştirdiği bir değerdir. Bir çapraz başvuru, enjekte edildiği değerin bütünü olarak durmalıdır; bu yüzden Recipe’in eşlemesini değeri bütün olarak iletecek şekilde değiştirin ve bunun yerine çevresini hedefin kendi söz dağarcığıyla oluşturun. Değer bütün olarak durduğu hâlde yer tutucu yine de sağ çıkıyorsa hata, çözümlemenin sağlayıcı tarafındadır ve o eklentiyi yayımlayan kişiye aittir.
A template did more than copy a value it read off a cross-boundary link (bir şablon, sınırlar arası bir bağlantıdan okuduğu değeri kopyalamaktan fazlasını yaptı)
Bir şablon, bir üreticinin değerlerini doğrudan bir bağlantıdan, .context.uses.<alias>.provides konumunda okuyabilir; sınır kapsamlı bir FeatureRecipe’te ise sınırın bağlantılarından .boundary altında okur. Bağlantı farklı çıktılara render edilen iki bileşeni birleştiriyor ve sağlayıcı onu kendi başvurusuyla bağlıyorsa, bu değerlerin her biri şablona bir yer tutucu olarak ulaşır ve sağlayıcı, iki çıktı da birleştirildiğinde onu değiştirir: yığınlar arası bir başvuruyla ya da değerin kendisiyle. Bu yüzden bir şablon böyle bir değeri yalnızca kopyalayabilir — onu bütün olarak, daha uzun bir dizenin içinde ya da quote gibi onu olduğu gibi bırakan bir işlevden geçirerek yazabilir.
Bir karşılaştırma, bir dallanma, bir uzunluk ya da değeri değiştiren bir işlev — eq, if, len, upper, trimPrefix — sessizce değere değil yer tutucuya göre karar verirdi. Derleme bunu, şablonu bir kez yer tutucular, bir kez de gerçek değerler üzerinde olmak üzere iki kez değerlendirerek denetler ve her yer tutucu geri yazıldıktan sonra ikisi uyuşmuyorsa durur. Bu, böyle bir bağlantıyı okuyan her şablon için geçerlidir: bir Recipe’in kendi şablonları, eklenmiş bir FeatureRecipe’in injectMapping: alanı ve sınır kapsamlı bir FeatureRecipe’in şablonları.
İleti şablonu — alanı ve ait olduğu Recipe’i — ve farkın bağlı olduğu her provides değeri için tüketen bileşeni, bağlantının takma adını ve soketini ve üreten bileşeni belirtir. Şablonun yalnızca kopyaladığı bir değer belirtilmez.
Üretilen ileti:
a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (bir şablon, sınırlar arası bir bağlantıdan okuduğu değeri kopyalamaktan fazlasını yapıyor: ileti şablonu, provides anahtarını, onu bir soket üzerindeki bağlantısından okuyan tüketen bileşeni ve üreten bileşeni belirtir. Değeri olduğu gibi, bütün olarak ya da daha uzun bir dizenin içinde kopyalayın, çünkü sağlayıcı onun yerine değerin diğer çıktıda neye dönüştüğünü yazar; dallanmayı bunun yerine bileşenin kendi değerine göre yapın)
Nasıl düzeltilir: iletinin belirttiği değeri sınamak ya da dönüştürmek yerine kopyalayın ve kararı bağlantının okuduğu değere değil, tüketen bileşenin kendisinin yazdığı bir değere — kendi values ya da infra anahtarlarından birine — dayandırın. CloudFormation sağlayıcısı, kopyalanan bir değerin diğer yığında neye dönüştüğünü açıklar.
A provider named a directory for a contributor that is not one directory (Bir sağlayıcı, bir katkıda bulunan için tek bir dizin olmayan bir dizin belirtti)
Her katkıda bulunanı, kapsayan tek bir çıktı içinde kendi konumuna yerleştiren bir sağlayıcı, bu konumların altında bulunduğu dizini bildirir ve derleme her bileşenin kimliğini bu dizine ekler. Değer tam olarak tek bir dizin belirtmelidir: yol ayırıcı taşıyan ya da geçerli veya üst dizini belirten bir değer, bir bileşenin dosyalarını kendi konumunun altından başka bir yere yerleştirir; ya tamamen birleştirmenin dışına ya da onun içinde sessizce yeniden düzenlenmiş biçimde.
Derleme böyle bir yol oluşturmak yerine durur. İleti, değeri bildiren sağlayıcıyı ve değerin kendisini belirtir; böylece hangi sağlayıcının değiştirileceği ve neyi bildirdiği açık olur.
Böyle bir dizin bildirmeyen bir sağlayıcı etkilenmez. Bu durumda her katkıda bulunan doğrudan dağıtım dizininde kendi adıyla bulunur; bu yüzden kapsayan bir dizin belirtmemek bir eksiklik değil, meşru bir yanıttır.
Üretilen ileti:
provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (sağlayıcı, her katkıda bulunanın kendi alt dizini için tek bir dizin adı olmayan bir dizin belirtti: sağlayıcı nest_segment bildirdi; değer tek bir dizin belirtmeli, yol ayırıcı taşımamalı ve ne geçerli ne de üst dizini belirtmelidir)
Nasıl düzeltilir: bu değeri hiçbir katalog belgesi üretmez; bu yüzden kendi dosyalarınızda düzeltilecek bir şey yoktur: değer, sağlayıcıya hizmet eden eklentiden gelir. Durumu, iletinin belirttiği değeri aktararak o eklentiyi yayımlayan kişiye bildirin. Eklenti sizinse tek bir dizin adı bildirin ya da hiçbirini bildirmeyin ve her katkıda bulunanın dağıtım dizininde bulunmasına izin verin.
A boundary-scope Feature is attached only to a component (Sınır kapsamlı bir Feature yalnızca bir bileşene eklenmiş)
Bir FeatureRecipe, her bileşen için bir kez değil, bir sınır için bir kez üretim yaptığını bildirebilir: her bileşen için bir kaynak yerine, sınırın içerdiği her şey için paylaşılan tek bir kaynak. Bu nedenle böyle bir eklemenin yazılması gereken yer sınırdır: bu adla yalnızca bir bileşene karşı yazılan bir ekleme, recipe’in üretim yapacağı bir kapsam belirtmez; bu yüzden hangi sınırda çalışacağına, hangi değerleri okuyacağına ya da çıktısının nereye yazılacağına hiçbir şey karar vermez.
Eklemeyi bir bileşene de yazmak olağandır ve raporlanmaz. Bir sınırda bildirilen ekleme, o sınırın içerdiği her bileşene, içine yuvalanmış kapsamlardakiler de dahil, ulaşır; bu yüzden onu taşımak normal biçimdir. Denetlenen, bileşenin kendi kapsamının ya da onu kapsayan bir kapsamın bu adı bildirip bildirmediğidir: arama, bileşenin bulunduğu yerden dışarıya doğru ilerler ve adı bildiren ilk kapsamda durur. Kapsayan kapsamının zaten bildirdiği bir eklemeyi kendisinde yeniden belirten bir bileşen, yalnızca kapsamda bildirilen biçimle tam olarak aynı şekilde işlenir ve aynı nedenle kabul edilir.
Hiçbir kapsama yerleştirilmemiş bir bileşenin dolaşılacak bir şeyi yoktur; bu yüzden ona yapılan sınır kapsamlı bir ekleme burada raporlanır. Bu, dürüst okumadır, çünkü böyle bir recipe’in üretim yapabileceği bir kapsam yoktur.
Eklemeyi ve bileşenin bulunduğu kapsamı belirten üretilen ileti:
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (ekleme, executionScope: boundary olan bir FeatureRecipe’i bağlıyor ve bileşeni içeren hiçbir sınır onu bildirmiyor (sınırdaki bir bileşen üzerinde))
ve böyle bir değer sağlamayan, hiçbir kapsamda olmayan bir bileşen için:
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (ekleme, executionScope: boundary olan bir FeatureRecipe’i bağlıyor ve bileşeni içeren hiçbir sınır onu bildirmiyor)
Nasıl düzeltilir: eklemeyi yalnızca bileşende değil, üretim yapması gereken sınırda (bileşenin bulunduğu kapsamda ya da onu kapsayan bir kapsamda) features: altında bildirin. Amaçladığınız bileşen başına üretimse, bunun yerine FeatureRecipe’i sınır kapsamını bildirmeyen bir Feature ekleyin.
The sandbox refused a plugin (Korumalı alan bir eklentiyi reddetti)
Her eklenti, herhangi bir iş yapmasına izin verilmeden önce ne olduğunu ve neye ihtiyaç duyduğunu bildirir; korumalı alan da bu bildirimi vermeye hazır olduğu şeylerle karşılaştırır. Bu durum, korumalı alanın kabul etmeyeceği bildirimlerin tüm sınıfını kapsar ve cümle, bildirimin hangi kısmının reddedildiğini söyler: ana makinenin konuşmadığı bir eklenti arabirimi sürümü, ana makinenin karşılığı olmayan bir eklenti türü, giden ağ erişimi ya da dosya sistemi erişimi isteyen bir eklenti, ana makinenin sunduğu kümenin dışında bir ana makine çağrısı adlandıran ya da kabul ettiği kümenin dışındaki bir ad alanından içe aktaran bir eklenti, eksik ya da bozuk bir dışa aktarım, kapalı olduğu kümenin dışında bir değer taşıyan bir alan veya hiç okunamayan bir öz bildirim.
Ret, eklenti çalışmadan önce gerçekleşir ve reddedilen eklenti, hata iletilmeden önce kapatılır; böylece istediği hiçbir şey kısa bir süreliğine bile verilmez.
Bir eklentinin sahip olamayacağı şeylerin bir kısmı burada denetlenmez, çünkü hiçbir zaman verilmez. Ana makine konuğa dondurulmuş bir saat verir; dosya sistemi, ortam ve kendi çıktısının gidebileceği bir yer vermez. Bu nedenle bunlardan herhangi birine ulaşmaya çalışan bir konuk, baştan reddedilmek yerine girişim anında başarısız olur. Bu durumun kapsadığı şey, eklentinin kendisi hakkında yaptığı ve başlamadan önce denetlenen bildirimdir.
Üretilen iletiler. Her birini durumun cümlesi kapatır; ondan önce gelen kısım eklentiyi ve bildiriminin reddedilen kısmını adlandırır. Ana makinenin konuşmadığı bir arabirim sürümü:
plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (eklenti abi_version bildiriyor; ana makine başka bir sürüm konuşuyor: wasm: eklenti korumalı alan tarafından reddedildi)
ana makinenin karşılığı olmayan bir eklenti türü:
plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (eklenti bilinmeyen bir plugin_type bildiriyor: wasm: eklenti korumalı alan tarafından reddedildi)
okunamayan bir öz bildirim:
wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: eklentinin describe() çıktısı geçerli JSON değil: wasm: eklenti korumalı alan tarafından reddedildi)
türünün gerektirdiği dışa aktarımı eksik olan bir eklenti; dışa aktarım, türün kendisinin okunduğu aynı kayıttan adlandırılır:
<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (eklenti gerekli dışa aktarımı bildirmiyor: wasm: eklenti korumalı alan tarafından reddedildi)
sabit bir kümeye kapalı olup başka bir şey taşıyan bir alan; aynı biçim, derleme kipini ve dışa aktarım başına operates ve scope alanlarını da kapsar:
plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (eklentinin dışa aktarımı bilinmeyen bir scope bildiriyor: wasm: eklenti korumalı alan tarafından reddedildi)
her iki dışa aktarımı olmadan bildirilen eşli bir yetenek ya da bildirim olmadan dışa aktarımlar:
plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (eklenti sınırlar arası bağlama yeteneğini bildiriyor ancak iki dışa aktarımın ikisini de sunmuyor: wasm: eklenti korumalı alan tarafından reddedildi)
bir Recipe’in hiçbir zaman seçemeyeceği bir yetenek adı — iki nokta içeren bir adı sunan bir provider ya da böyle bir adla uyumlu bir işlem hattı adımı — çünkü bir Recipe’in capability: değeri, son iki noktaya kadar ad, ondan sonrası ise sürüm sabitlemesi olarak okunur. Bir ayrıştırıcının parse:<format> ve bir içe aktarıcının import:<format> adları reddedilmez: iki nokta bu adların parçasıdır ve bunlar bir Recipe aracılığıyla değil, biçime göre aranır. Aynı ret, böyle bir eklentinin varlığının yayımlanmak üzere üretilmesini de durdurur:
plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (eklenti iki nokta içeren bir yetenek sunuyor; bir Recipe’in yetenek başvurusu son iki noktaya kadar yetenek, ondan sonrası sürüm sabitlemesi olarak okunur, bu yüzden hiçbir Recipe bu adı veremez: yetenek adını iki nokta olmadan bildirin: wasm: eklenti korumalı alan tarafından reddedildi)
ve bir eklentinin bildirdiği ana makine çağrılarının, ikili dosyasının gerçekten kullandıklarıyla karşılaştırılması; bu her iki yönde denetlenir, böylece bir eklenti ne kullanmadığı bir yüzeyi duyurabilir ne de kullandığı bir yüzeyi gizleyebilir:
plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (eklenti, wasm’ının içe aktarmadığı bir ana makine işlevini describe() içinde bildiriyor: wasm: eklenti korumalı alan tarafından reddedildi)
plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (eklenti, describe() çıktısının bildirmediği bir ana makine işlevini içe aktarıyor: wasm: eklenti korumalı alan tarafından reddedildi)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği bunu gidermez — reddedilen bildirim eklentinin kendisine aittir. Yayımlanmış bir eklenti kullanıyorsanız iletiyi onu yayımlayana bildirin ve bu arada ana makinenin kabul ettiği bir sürümü seçin. Eklenti sizinse ileti alanı ve her iki değeri adlandırır, dolayısıyla düzeltme cümlenin işaret ettiği düzeltmedir: ana makinenin konuştuğu arabirim sürümünü konuşun, onun bildiği bir tür bildirin, her alanı kapalı olduğu kümenin içinde tutun, türünüzün gerektirdiği dışa aktarımı bildirin ve ikili dosyanızın kullandığı ana makine çağrılarını tam olarak bildirin — ne fazla ne eksik.
A plugin is not the kind of plugin the socket expects (Eklenti, soketin beklediği türde bir eklenti değil)
Her bağlantı noktası hangi türde bir eklentiye yönlendirdiğini belirtir ve her eklenti kendi türünü bildirir. Bu durum, ikisi arasındaki bir uyuşmazlığın bildirdiği şeydir: linter beklenen yere bağlanmış, bir provider sunan eklenti; içe aktarıcı beklenen yere bağlanmış bir ayrıştırıcı; terminal komutu olmadığı hâlde öyle çalıştırılan bir eklenti. Denetim eklenti yüklenirken gerçekleşir; böylece yanlış türdeki bir eklenti, kendisinden istenecek işe hiçbir zaman ulaşmaz.
Yine de denemek yerine durmasının nedeni, türlerin ortak bir arabirimi paylaşmamasıdır. Başka türden bir eklenti, sahip olmadığı dışa aktarımlar üzerinden çağrılır ve geri dönen şey, hiçbir zaman üretmediği bir biçime göre okunurdu.
Bir eklentinin öz bildirimini bir tür öne sürmeden okumak bundan etkilenmez. Yalnızca bir eklentinin kendisi hakkında ne söylediğini bilmek isteyen bir yüzey — yapılandırılanları listelemek, biri için bir varlık üretmek — hiçbir beklenti belirtmez ve bu denetim orada atlanır.
Eklentiyi ve her iki türü adlandıran, beklenen türü hem sözcüklerle hem de bildirilen değeriyle veren üretilen ileti:
wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: eklenti: beklenen türde bir eklenti bekleniyordu ancak describe() çıktısı başka bir eklenti türü bildiriyor: wasm: bildirilen eklenti türü eklentinin describe() çıktısıyla eşleşmiyor)
Nasıl düzeltilir: bağlantı noktasının aldığı türde bir eklenti bağlayın — ileti beklenen türü adlandırır. Eklenti kastettiğiniz eklentiyse bağlantı yanlış yerdedir: onu, türünün ait olduğu yüzeye taşıyın. Eklentiyi siz yazıyorsanız ve beklenen türde olması gerekiyorsa, kendisi hakkında yanlış türü bildiriyordur; bu, onu bağlayan yapılandırmada değil, eklentide yapılacak bir düzeltmedir.
A plugin failed while it was running (Bir plugin çalışırken başarısız oldu)
Bir şey yapması istenen bir plugin, bir sonuçla geri dönmedi. Bu durumu üç koşul kapsar ve bunları birbirinden ayıran tek şey hatanın nasıl iletildiğidir: çöken bir plugin, kendi yürütmesini durduran bir plugin ve sonuna kadar çalışıp kendisinden isteneni yapamadığını bildiren bir plugin. Bunlar bilerek tek bir sınıflandırmada toplanmıştır; böylece bir derleme, bir plugin’in başarısız olabileceği her yolu aynı şekilde ele alır.
Çöken bir plugin. Bir plugin içindeki hataların çoğu (erişilemez bir komut, sıfıra bölme, belleğinin dışından okuma) dışarı çıkarken sıradan hatalara dönüştürülür ve bu koşula hiç ulaşmaz. Bu koşul, o yoldan kaçan bir çökme için o yolun arkasındaki güvenlik ağıdır.
Kendi yürütmesini durduran bir plugin. Çıkmak isteyen bir plugin, plugin modelinin kullanmadığı bir şey yapmaktadır: bir plugin sonucunu çıkarak değil, kendisiyle yapılan çağrı üzerinden döndürür. Yalnızca kendi yürütmesi durur; derleme süreci etkilenmez.
Bir hata bildiren plugin. Bir plugin’in döndürdüğü sonuç zarfında, işi tamamlayamadığını söyleyebileceği bir yer vardır ve bunu söyleyen bir ileti, sonuç olarak okunmak yerine hata olarak iletilir.
Üretilen iletiler; her biri plugin’i ya da export’u adlandırır ve hatanın sağladığı her şeyi taşır. Bir çökme, kurtarılan değeri taşır:
wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: konuk plugin, içinde paniğe girdi: wasm: konuk plugin çağrı sırasında paniğe girdi)
bildirilen bir hata ise plugin’in kendi iletisini taşır:
call "<export>": wasm: guest plugin reported an error: <the plugin's message> (çağrı: wasm: konuk plugin bir hata bildirdi)
Nasıl düzeltilir: üçünün hiçbirine varlık dosyalarınızdaki bir şey neden olmaz ve hiçbir yazım değişikliği bunları gidermez; her biri plugin içindeki bir hatadır. İletiyi, tanımladığı export’u belirterek plugin’i yayımlayan kişiye bildirin ve hata düzeltilene kadar plugin’i çalışan bir sürüme sabitleyin. Plugin sizinse: çökmek ya da çıkmak yerine sonuç zarfında bir hata döndürün; böylece derleme gösterebileceği bir ileti alır. Bildirilen hata plugin’in üzerinde düşünülmüş kendi yanıtıysa, iletisi okuyucunun göreceği şeydir; bu yüzden girdinin neyini kabul edemediğini söylemesi yararlıdır.
A plugin returned something that is not the shape the socket reads (Bir plugin, soketin okuduğu biçimde olmayan bir şey döndürdü)
Her bağlantı noktası, geri aldığı sonucu beklediği biçime göre okur ve başka her şeyi reddeder: biçimin bildirmediği bir alan, değeri kendisi için bildirilen türde olmayan bir alan ya da hiç düzgün biçimli bir sonuç olmayan baytlar.
Okuyabildiğini okumak yerine reddeder, çünkü okuyabildiğini okumak sessiz kalmak olurdu. Bir bağlantının hangi export’u çağıracağı her bağlantı için ayrı seçilebilir; bu yüzden bir bağlantı, sonucu bambaşka bir biçimde olan bir export’u adlandırabilir. Uymayan kısımları atlamak boş bir sonuç verir ve boş bir sonuç kendi başına meşru bir yanıttır: hiçbir karar döndürülmemiş, hiçbir bulgu bildirilmemiştir. Bu durumda ikisi birbirinden ayırt edilemez ve derleme, plugin onu onaylamış gibi aynen devam ederdi.
Sonucun geldiği export’u adlandıran ve okumanın neden başarısız olduğunu taşıyan üretilen ileti; ikisi birlikte bağlantının adlandırması gereken export’u belirler:
call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (çağrı: wasm: konuk plugin, soketin okuduğu biçimde olmayan bir çıktı döndürdü)
Nasıl düzeltilir: bağlantının adlandırdığı giriş işlevini plugin’in bildirdiği export’larla karşılaştırın; yanlış export’a yönlendirilmiş bir bağlantı yaygın nedendir ve iletideki neden, oraya ait olmayan alanı adlandırır. Export doğruysa plugin, bağlantı noktasının okumadığı bir biçim döndürüyordur ve bu plugin’de yapılacak bir düzeltmedir; hem export’u hem nedeni alıntılayarak plugin’i yayımlayan kişiye bildirin.
A plugin returned a diagnostic at a severity that is not declared (Bir plugin, bildirilmemiş bir önem düzeyinde tanılama döndürdü)
Bir plugin, sonucunun yanında gözlemler döndürebilir ve her biri kapalı bir kümeden bir önem düzeyi taşır: derlemeyi durduran ve neyin düzeltileceğini söyleyen, yine de tamamlanan bir derlemenin yanında gösterilen ve gözlemi kaydedip hiçbir şeyi değiştirmeyen. Bu kümenin dışındaki bir önem düzeyi, ana bilgisayarın yönlendiremeyeceği bir düzeydir ve derleme durur.
Bir yönlendirme seçmek yerine reddeder ve iki alternatif de daha kötüdür. Yönlendiremediği bir gözlemi atlamak, onu yapılacak bir şey yokmuş gibi ele almak olurdu; bu da plugin derlemeyi kabul edip etmeyeceğine karar veriyorsa onay anlamına gelir: plugin’in yükselttiği bir itiraz, hiç gösterilmeden derlemenin geçmesine izin verirdi. Onu durdurucu önem düzeyi olarak ele almak ise derlemeyi kimsenin seçmediği bir değer yüzünden reddederdi. İkisi de sessizdir; bu yüzden ana bilgisayar değerin yanlış olduğunu söyler ve bunun yerine plugin düzeltilir.
Denetim, bir gözlemin sonradan gösterildiği her yerde değil, sonucun okunduğu yerde bir kez çalışır; burası aynı zamanda plugin’in kimliğinin hâlâ elde olduğu tek noktadır, çünkü bir rapora katılmış bir gözlem artık onu hangi plugin’in yükselttiğini bilmez.
Plugin’i, export’u, hangi gözlemin hatalı olduğunu, değerini ve bildirilmiş değerleri adlandıran üretilen ileti:
plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (plugin çağrısı: wasm: konuk plugin, önem düzeyini sözleşmenin bildirmediği bir tanılama döndürdü: tanılamanın önem düzeyi şudur; bildirilmiş önem düzeyleri şunlardır)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz; değer plugin’den gelmiştir. İletinin adlandırdığı değeri alıntılayarak plugin’i yayımlayan kişiye bildirin. Plugin sizinse, bildirilmiş üç önem düzeyinden birini üretin; ileti bunları adlandırır ve dizin size hangi gözleme bakmanız gerektiğini söyler.
A provider returned two output files under one path (Bir provider tek bir yol altında iki çıktı dosyası döndürdü)
Bir provider çıktısını, her biri yazılacağı yolu adlandıran bir dosya listesi olarak döndürür. Ana bilgisayar bunları yola göre anahtarlanmış şekilde toplar ve kendi serileştiricisini çalıştırmadan her dosyanın baytlarını olduğu gibi yazar. Aynı yolu adlandıran iki dosya, bu koleksiyonda tek bir anahtar için iki değer bırakır.
Birini seçmek yerine reddeder, çünkü sonradan iki seçim birbirinden ayırt edilemez. Sonuncuyu tutmak, provider’ın yazılmasını söylediği bir dosyayı atar; ilkini tutmak sonrakini atar. Her iki durumda da diskteki çıktı düzgün biçimlidir ve bir dosya eksiktir; bir dosyanın düşürüldüğünü kaydeden hiçbir şey yoktur ve geride kalan yol zaten kalacak olan yoldur, bu yüzden sonuçtaki hiçbir şey bir çakışma olduğunu söylemez. İkisinden hangisinin kastedildiği, yalnızca provider’ın yanıtlayabileceği bir sorudur.
Bir provider’ın dosya döndürdüğü her yerde yükseltilir: tek bir düğümün işlenmesinde ve bir dağıtım grubunun çıktısının tek bir yapıta birleştirilmesinde. Koşul ve düzeltme ikisinde de aynıdır; bu yüzden ikisi de bunu bildirir.
İki kez döndürülen yolu ve döndürüldüğü düğümü ya da dağıtım yolunu adlandıran üretilen ileti:
provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (provider konuğu tek bir yol altında iki çıktı dosyası döndürdü; uyumlu bir konuk her çıktı yolunu en fazla bir kez döndürür)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz; yollar provider’dan gelmiştir. İletinin adlandırdığı yolu alıntılayarak provider’ı yayımlayan kişiye bildirin. Provider sizinse, her çıktı yolunu en fazla bir kez döndürün: yol listesini bir kümeye karşı oluşturun ki tek bir yoldaki ikinci dosya üretildiği yerde yakalansın ve ikisi de isteniyorsa ikinci dosyaya ayrı bir yol verin.
Bir provider, değeri liste olmayan bir render olgusu bildirdi
Bir provider, dosyalarının yanında render ettiği çıktı hakkında olgular bildirebilir — her biri bir ad ve bir değerden oluşur ve o provider’ın kendi belgelenmiş sözcük dağarcığındadır — ve bir component’e bağlı Features bunları kendi şablonlarından okur. Her olgunun değeri, tek bir öğe içerse bile bir listedir: bir ad, bir component’in birden fazla render’ı tarafından, yani kendi provider çağrıları ve ona bağlı Features’ın render’ları tarafından bildirilebilir ve listeler, onu okuyan şablonlar için o ad altında tek bir listede birleştirilir. Bir provider, render ederken bildiriminin bir ad altındaki tek bildirim olup olmayacağını bilemez; bu nedenle nesne, dize, sayı, boolean ya da null olan bir değer, hiçbir şablon olguyu okusun ya da okumasın, her render için provider’ın onu teslim ettiği yerde reddedilir.
Olguyu, bildirildiği düğümü, onu bildiren provider’ı ve değerin ne olduğunu belirten çıktı mesajı:
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 (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (provider konuğu, değeri liste olmayan bir render olgusu bildirdi; uyumlu bir konuk, her render olgusunun değerini tek öğeli olsa bile bir JSON dizisi olarak bildirir (olgu, düğüm, provider, değeri))
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz — değer provider’dan gelmiştir. Mesajın belirttiği olguyu aktararak durumu provider’ı yayımlayana bildirin. Provider sizinse, o olgunun değerini bir JSON dizisi olarak bildirin — tek bir nesne, o nesneyi içeren bir listeye dönüşür — ve provider’ınızın bildirdiği olgular arasında onu bir liste olarak belgeleyin; bkz. Bir konuğun çıktısı hakkında olgu bildirme.
Bir provider’ın bağlantı kablolaması hiç üretilmemiş bir çıktı dosyasını adlandırıyor
Bir bağlantı iki dispatch grubu arasında geçtiğinde, her iki taraftaki provider’dan onu kablolaması istenir: tüketilen uç bir kimlik yayımlar, tüketen uç bu kimliğe göre çözümleme yapar ve her biri kendi grubunun çıktısına uygulanacak yapısal kablolama döndürebilir. Her kablolama parçası uygulandığı çıktı dosyasını adlandırır. Sonraki bir geçiş o dosyayı parçalara ayırır, işlemleri uygular ve dosyayı bayt düzeyinde aslına uygun biçimde yeniden birleştirir.
Üretilmiş hiçbir dosyayla eşleşmeyen bir ad, o geçişe ayıracak bir şey bırakmaz ve geçiş kablolamayı atlamak yerine reddeder. Taşıdığı işlemler bağlantıyı çözen şeydir; bu yüzden onları düşürmek, birleştirilmiş çıktıyı hiçbir şeyin kablolamadığı bir uç noktaya başvurur hâlde bırakır — bu da dağıtım sırasında, ona yol açan provider’dan çok uzakta başarısız olur ve kablolamadaki değil bağlantıdaki bir hata gibi görünür.
Bir kablolama parçasının adlandırabileceği dosyalar, o grubun kendi render’ının döndürdüğü dosyalardır. Bunlar aynı çağrıda provider’a verilir; böylece provider hiçbir zaman bir adı tahmin etmek zorunda kalmaz: kendisine verilen kümeden birini seçer.
Kablolamanın istediği dosyayı ve döndürüldüğü uç noktayı belirten çıktı mesajı:
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 (file "<file>", node "<node>") (bağlantı yaması, dispatch grubunun üretmediği bir çıktı dosyasını adlandırıyor; uyumlu bir bağlantı yaması, grubun kendi render’ının döndürdüğü bir dosyayı adlandırır (dosya, düğüm))
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz — ad provider’dan gelmiştir. Mesajın belirttiği dosyayı aktararak durumu provider’ı yayımlayana bildirin. Provider sizinse, dosyayı bağımsız olarak oluşturulmuş bir addan değil, çağrının size verdiği birleştirilmiş dosyalardan adlandırın — elle oluşturulan bir yol, onu üreten render değiştiği anda geçerliliğini yitirir ve bunun görünümü tam olarak budur.
Bir pipeline adımının dosya üretimi hiç dosya taşımıyor
Bir pipeline adımı, yamaladığı belgelerin yanında yeni bir belge üretebilir. Her üretim kendi türünü bildirir ve dosya türündeki bir üretim yazdığı dosyayı taşır: yolu ve içeriği.
Burada tür doğrudur ve dosya yoktur; yani adım, yanıtının yerine getirmediği bir niyet bildirmiştir. Bunu aşağıdaki tanımsız tür durmasından ayıran budur: host bir emit_file üretimiyle ne yapacağını tam olarak bilir, ancak bunu uygulayacağı bir şey yoktur.
Hiçbir şey üretmemek yerine reddeder, çünkü sessizce hiç dosya katmayan bir üretim görünmez olurdu. Belge üreten bir adım çoğu zaman pipeline’da bulunmasının tek nedenidir ve çıktısı daha önce orada olmayan bir dosyadır — dolayısıyla onu atlayan bir derleme, adım çalıştığını bildirirken bir belgesi eksik çıktı üretirdi.
Düğümü ve adımın üretimlerinden hangisinin hatalı olduğunu belirten çıktı mesajı:
emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (emit_file yan etkisi hiç dosya taşımıyor; uyumlu bir emit_file yan etkisi yolu ve içeriğiyle bir dosya taşır (düğüm, yan etki))
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz — yanıt plugin’den gelmiştir. Mesajın belirttiği dizini aktararak durumu plugin’i yayımlayana bildirin. Plugin sizinse, her emit_file üretiminde dosya üyesini hem yolu hem içeriğiyle doldurun; dizin, o adımın yanıtındaki hangi üretime bakmanız gerektiğini söyler.
Bir pipeline adımı, sözleşmenin tanımlamadığı bir üretim türü bildiriyor
Bir pipeline adımının döndürdüğü her üretim kendi türünü bildirir ve sözleşme iki tür tanımlar: biri bir dosya yazar, diğeri bir özel kaynak belgesi katar. Tür, iletimde açık bir dizedir; bu da mevcut plugin’leri bozmadan sonradan bir tür eklenebilmesini sağlar.
Tanımsız bir türün atlanmak yerine reddedilmesinin nedeni tam da bu açıklıktır. Host’un tanımlamadığı bir değer, yalnızca biçimine bakılarak sonraki bir sürümün tanımlayacağı bir değerden ayırt edilemez — dolayısıyla onu atlayan bir host, adım başarı bildirirken her derlemede adımın onunla kastettiği şeyi sessizce düşürürdü. Reddetmek, genişletme noktasını bir boşluğa dönüştürmeden açık tutar: bu derlemenin tanımlamadığı bir tür, kabul edilip yok sayılmak yerine adımın gönderdiği değer aktarılarak tanımsız olarak bildirilir.
Düğümü, hangi üretimin hatalı olduğunu ve bildirdiği türü belirten çıktı mesajı:
side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (yan etki, plugin sözleşmesinin tanımlamadığı bir tür bildiriyor; uyumlu bir yan etki emit_file ya da emit_crd bildirir (düğüm, yan etki, tür))
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey yol açmaz — değer plugin’den gelmiştir. Mesajın belirttiği türü aktararak durumu plugin’i yayımlayana bildirin. Plugin sizinse, mesajın listelediği türlerden birini bildirin; yaygın neden tanımlı bir türün yanlış yazılmasıdır ve geri aktarılan değer sizin gönderdiğiniz değerdir.
A provider’s reassembly is handed a unit its own carve never produced (Bir provider’ın yeniden birleştirmesine kendi bölmesinin hiç üretmediği bir birim veriliyor)
Çıktı biçimi doğrudan adreslenemeyen bir provider, çıktıyı kendisi için bölebilir: bir çıktı dosyasını her biri bir belirteç altında olan adreslenebilir birimlere ayırır ve bunları geri verir. Ardından bir pipeline adımı bir birimi bu belirteçle adresler ve yeniden birleştirme, düzenlenmiş birimleri dosyaya bayt düzeyinde aslına sadık biçimde geri ekler. İki yarı tek bir sözleşmedir: bir dosyanın bölündüğü belirteçler, yeniden birleştirmesinin çözdüğü belirteçlerdir.
Yeniden birleştirmeye, aynı dosyanın bölmesinin üretmediği bir belirteç verildiğinde, düzenlenmiş içeriğin geri yerleşeceği bir bayt aralığı yoktur. Birimi düşürmek yerine reddeder; çünkü düşürülen bir birim, iyi biçimlendirilmiş ama bir adımdan istenen bir düzenlemeyi eksik bırakan bir dosya üretir: hiçbir şey başarısız olmamıştır, hiçbir şey bozuk değildir ve düzenleme düpedüz yoktur.
İki yarı yalnızca ayrıldıkları yerde uyuşmayabilir: kendisi için bölen ve geri kalanı için standart yapısal yeniden birleştirmeyi ödünç alan bir codec. Bir belirteç kümesi altında bölüp başka bir kümeye göre yeniden birleştirmek tam olarak bunu üretir. Her iki yarıya da sahip olan bir codec buna ulaşamaz: kendi yeniden birleştirmesi kendi belirteçlerinden sorumludur.
Hiçbir şeye çözülmeyen belirteci ve adlandırıldığı dosyayı belirten çıktı mesajı:
reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (yeniden birleştirme, bölmenin üretmediği yamalı bir birim belirteci adlandırıyor; uyumlu bir codec bir dosyayı aynı belirteçler altında böler ve yeniden birleştirir)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz. Provider sizinse, bir yarının ürettiği belirteçleri diğerinin çözdüğü belirteçler yapın: bunları her iki tarafta bağımsız olarak türetmek yerine bir kez türetip taşıyın; bölme işlemi bir dosyayı ayırmadan önce yeniden yazıyorsa, aynı yeniden yazılmış biçime göre yeniden birleştirin. Provider sizin değilse, mesajın adlandırdığı belirteci aktararak durumu yayımlayan kişiye bildirin.
A workload declares a form compose cannot express (Bir workload, compose’un ifade edemediği bir biçim bildiriyor)
compose provider’ı uzun süre çalışan hizmetleri işler. Makine başına bir kopya çalıştığını, bir zamanlamaya göre çalıştığını ya da bir kez çalışıp bittiğini bildiren bir workload’un temiz bir tek makineli karşılığı yoktur; bu yüzden işleme, düz bir hizmet üretmek yerine durur. Düz bir hizmet onu başlatır, çalışır durumda tutar ve isteneni yanlış yansıtırdı.
Çıktı mesajı. Koşul, hatanın türünü adlandırır (yapının bildirdiği bir şey için ifadesi olmayan bir provider) ve provider’ın kendi cümlesi kendisine verilen biçimi adlandırır:
a plugin has no expression for a construct this build declares (bir plugin’in bu yapının bildirdiği bir öge için ifadesi yok)
compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: workload biçiminin compose eşlemesi yok; compose yalnızca stateless ve stateful destekler: compose bu workload biçimini ifade edemez)
Nasıl düzeltilir: hedef gerçekten tek makineli bir compose ortamıysa, işi uzun süre çalışan bir hizmet olarak ifade edin; stateless ve stateful biçimleri, işlediği iki biçimdir. Kastettiğiniz o biçimse, o sınırı hedefinde bir karşılığı olan bir provider üzerinden işleyin: makine başına kopya, zamanlanmış çalıştırma ve tamamlanana kadar çalışan iş, başka yerlerde doğrudan ifadelere sahiptir ve provider seçimi workload’a değil sınıra aittir.
A container declares a field compose has no primitive for (Bir container, compose’un ilkel öğesi olmadığı bir alan bildiriyor)
İki container alanının compose karşılığı yoktur ve ikisi de düşürülmek yerine işlemeyi durdurur.
Bir container başladığında ya da durmak üzereyken çalışan kancalar. compose’da bunları çalıştıran hiçbir şey yoktur ve sessizce çalıştırılmayan bir kanca, derleme zamanında değil çalışma zamanında ortaya çıkan bir doğruluk sürprizidir.
Adlandırılmış bir nesneden alınan toplu ortam. compose değişkenleri bir dosyadan okuyabilir, ancak bir nesneye başvuru bir dosya değildir; birini diğeri olarak yeniden yorumlamak, container’a verileni bunu söylemeden değiştirirdi.
Her ikisi de sıradan container’lar ve ana container’dan önce çalışan container’lar için denetlenir; böylece aynı alan nerede bildirilirse bildirilsin durdurur ve mesaj hangi container’dan geldiğini adlandırır.
Çıktı mesajları. İkisi de aynı koşulu bildirir (yapının bildirdiği bir şey için ifadesi olmayan bir provider) ve hangi alan olduğunu provider’ın kendi cümlesi söyler:
a plugin has no expression for a construct this build declares (bir plugin’in bu yapının bildirdiği bir öge için ifadesi yok)
compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: düğüm, container: compose: düğüm container yaşam döngüsü kancaları bildiriyor; compose’un yaşam döngüsü kancası ilkel öğesi yok: compose’un yaşam döngüsü kancası ilkel öğesi yok; container yaşam döngüsü kancaları bildiriyor)
a plugin has no expression for a construct this build declares (bir plugin’in bu yapının bildirdiği bir öge için ifadesi yok)
compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: düğüm, container: compose: düğüm container envFrom bildiriyor; compose’un nesneden ortam ilkel öğesi yok: compose’un nesneden ortam ilkel öğesi yok; container envFrom bildiriyor)
Nasıl düzeltilir: bir compose hedefi için alanı kaldırın ve işini başka bir yolla yapın: başlangıç işi ana container’dan önce çalışan bir container’a, kapanış işi ise container’ın kendi sinyal işlemesine aittir; toplu ortam açık değişkenler olarak yazılabilir ya da compose hedefinin okuyabileceği bir dosyadan sağlanabilir. Kastettiğiniz o alansa, o sınırı hedefinde bu ilkel öğe bulunan bir provider üzerinden işleyin.
An omits entry names a kind or a namespace a compose file does not have (Bir omits girdisi, bir compose dosyasında olmayan bir tür ya da namespace adlandırıyor)
Bir compose dosyasını kaynak alan bir Recipe ya da FeatureRecipe üzerindeki bir omits: girdisi, o dosyanın en üst düzeydeki bir birimini dışarıda bırakır ve bir compose dosyasında bir girdinin adlandırabileceği tam olarak üç tür vardır: her biri services:, volumes: ya da configs: altında anahtarlanan bir service, bir volume ve bir config; namespace ise yoktur. Başka herhangi bir türü (aralarında bir chart belgesinin Secret’ı ya da bir compose network’ü de olmak üzere) adlandıran ya da bir namespace taşıyan girdi, dosyanın dışarıda bırakabileceği hiçbir şeyi adlandırmaz; bu yüzden işleme, girdiyi hiçbir şeyle eşleşmemiş bir girdi olarak ele almak yerine durur. Türler tam olarak karşılaştırılır; bu nedenle service kastedildiğinde Service reddedilir. Herhangi bir şey dışarıda bırakılmadan önce her girdi denetlenir ve girdilerin yazıldığı sırayla hatalı olan ilk girdi adlandırılır.
Çıktı mesajları. İkisi de bir provider’ın ifadesi olmadığı bir yapı için koşulu bildirir ve provider’ın kendi cümlesi girdiyi ve kabul ettiği türleri adlandırır. Şablonu hassas olarak bildirilmiş bir değeri okuyan bir alan <redacted> olarak gösterilir:
a plugin has no expression for a construct this build declares (bir plugin’in bu yapının bildirdiği bir öge için ifadesi yok)
compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: bir omits girdisi bir tür adlandırıyor: compose; her biri services:, volumes: ya da configs: altındaki anahtarıyla adlandırılan bir service, bir volume ya da bir config dışarıda bırakır, başka hiçbir tür bırakmaz)
a plugin has no expression for a construct this build declares (bir plugin’in bu yapının bildirdiği bir öge için ifadesi yok)
compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: bir omits girdisi bir namespace adlandırıyor ve bir compose dosyasında namespace yok: compose; her biri services:, volumes: ya da configs: altındaki anahtarıyla adlandırılan bir service, bir volume ya da bir config dışarıda bırakır, başka hiçbir tür bırakmaz; namespace’i girdiden kaldırın)
Nasıl düzeltilir: birimi compose dosyasının adlandırdığı gibi adlandırın (kind: service, volume ya da config ve name: olarak o bölümün altındaki anahtarı) ve namespace: öğesini kaldırın. Bkz. compose → Kaynaklı mod.
An omits entry names a namespace a CloudFormation template does not have (Bir omits girdisi, CloudFormation şablonunda bulunmayan bir ad alanını adlandırıyor)
Bir CloudFormation şablonunu kaynak olarak kullanan bir Recipe ya da FeatureRecipe üzerindeki omits: girdisi, girdinin kind alanı olarak Type değeriyle ve girdinin name alanı olarak mantıksal kimliğiyle adlandırılan bir kaynağı dışarıda bırakır. Bir şablonun ad alanları yoktur; bu nedenle namespace taşıyan bir girdi, şablonun dışarıda bırakabileceği hiçbir şeyi adlandırmaz ve render işlemi, girdiyi hiçbir şeyle eşleşmemiş bir girdi olarak ele almak yerine durur. Herhangi bir şey dışarıda bırakılmadan önce her girdi denetlenir ve girdilerin yazıldığı sırayla ad alanı taşıyan ilk girdi adlandırılır.
Yayımlanan ileti. Bir sağlayıcının ifade edemediği bir yapıya ilişkin koşulu bildirir; sağlayıcının kendi cümlesi de girdiyi ve bu sağlayıcının neyi dışarıda bıraktığını adlandırır. Şablonu hassas olarak bildirilmiş bir değeri okuyan bir alan <redacted> olarak gösterilir:
a plugin has no expression for a construct this build declares
cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry
A published port declares a transport compose cannot spell (Yayımlanan bir port, compose’un yazamadığı bir taşıma protokolü bildiriyor)
Yayımlanan bir compose portu, taşıma protokolünü girdinin sonundaki bir ek olarak taşır ve bu ekin iki yazımı vardır. Başka bir taşıma protokolü bildiren bir portun compose’da hiçbir yazımı yoktur.
Eki düşürmek yerine durur, çünkü sessizce varsayılan taşıma protokolüne geri dönen yayımlanmış bir port, istemcilerinin ulaşamadığı trafiği taşıyarak açılır; bu da taşıma protokolü bildirmenin önlemek için var olduğu hatanın ta kendisidir ve çeviri anında yeniden ortaya çıkar.
Taşıma protokolü bildirmeyen bir port etkilenmez. Hiç taşıma protokolü taşımamış bir port gibi, eksiz yayımlanır.
Yayımlanan ileti. Koşul, hatanın türünü adlandırır (sağlayıcının ürettiği çıktıda karşılığı olmayan bir değer) ve ardından sağlayıcının kendi cümlesi gelir:
a plugin has no representation for a value it was given
compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express
Nasıl düzeltilir: bir compose hedefi için portun taşıma protokolünü compose’un yazabildiği ikisinden biri olarak bildirin ya da bildirmeden bırakıp girdinin eksiz yayımlanmasına izin verin. Kastettiğiniz bu taşıma protokolüyse, o sınırı hedefi bunu ifade edebilen bir sağlayıcı üzerinden render edin.
A resources quantity cannot be converted to a compose value (Bir kaynak miktarı compose değerine dönüştürülemiyor)
Bir konteynerin işlemci ve bellek miktarları ile nvidia.com/gpu sayısı, Kubernetes’in kaynaklar için kullandığı gösterimle yazılır; compose ise bunları kendi birimleriyle taşır (bir GPU sayısı, bir NVIDIA aygıt rezervasyonunun sayısına dönüşür). Bu yüzden her biri bir miktar olarak okunur ve değerinden dönüştürülür. Bunu iki şey durdurur ve ileti hangisiyle karşılaşıldığını söyler: hiç miktar olmayan bir değer ve compose’un tam karşılığı olmayan bir miktar; yani negatif bir miktar, tam sayı bayt olmayan bir bellek miktarı, bir çekirdeğin dokuz ondalık basamağından daha ince bir işlemci miktarı, tam sayı aygıt olmayan bir GPU sayısı ya da compose’un tutabileceği en büyük değeri aşan bir miktar. nvidia.com/gpu isteği ve sınırı farklı sayılar isteyen bir konteyner de durur, çünkü compose bir servis için tek bir sayı ayırır. Değeri yuvarlamak ya da yaklaşık bir değer üretmek yerine durur, çünkü sessizce istenen sınır olmayan bir sınır, bir şey onu aştığı için durdurulana kadar kimsenin aramadığı türden bir farktır.
Yayımlanan iletiler. Her biri koşulla açılır (sağlayıcının ürettiği çıktıda karşılığı olmayan bir değer), ardından kaynağı, değerin istek mi sınır mı olduğunu, Workload içindeki yolunu ve değeri adlandırır. Miktar olmayan bir değerin ardından, onu miktar olmaktan çıkaran neden ve bir miktarın aldığı biçim gelir:
a plugin has no representation for a value it was given
compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu><request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value
compose’un temsil edemediği bir miktarın ardından, compose’un o kaynak için tuttuğu aralık gelir:
a plugin has no representation for a value it was given
compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value
a plugin has no representation for a value it was given
compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value
a plugin has no representation for a value it was given
compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value
Farklı sayılar isteyen bir GPU isteği ve sınırı, her iki yolu ve her iki sayıyı adlandırır:
a plugin has no representation for a value it was given
compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value
Workload’un şablonu, bir yazarın hassas olarak bildirdiği bir değeri okuduğunda hiçbir ileti reddettiği değeri aktarmaz ve iki sayı da aynı şekilde dışarıda bırakılır.
Nasıl düzeltilir: değer bir miktar değilse, onu Workload → Kaynak miktarları bölümünde açıklanan biçimde yazın; m gibi yalın bir ek, bir şablonun aradeğerlediği değer boş olduğunda bıraktığı şeydir, bu yüzden düzeltilecek girdi şablonun okuduğu girdidir. compose’un temsil edemediği bir miktarsa, iletinin belirttiği aralıkta bir miktar yazın: belleği hangi birimde olursa olsun tam sayı bayt olarak (1.5001Gi yerine 1536Mi), işlemci süresini bir çekirdeğin en fazla dokuz ondalık basamağına kadar ve GPU sayısını tam sayı aygıt olarak (0.5 ya da 500m değil, 1). Bir GPU isteği ve sınırı uyuşmuyorsa, ikisine de aynı sayıyı yazın ya da yalnızca sınırı yazın; sınır, Kubernetes’in aynı Workload için zamanladığı sayıdır.
A resource quantity the helm provider emits is not a quantity (helm provider’ının ürettiği bir kaynak miktarı bir miktar değil)
helm provider’ı, ürettiği manifest’lere her kaynak miktarını olduğu gibi kopyalar — her container’ın ve init container’ın resources.requests ve resources.limits değerleri, genişletilmiş kaynaklar dahil, ve her volume’un ephemeral.sizeLimit, persistent.size ve persistentTemplate.size değerleri — ve her birini önce, Recipe’nin şablonlarının değerlendirdiği haliyle Workload üzerinde, miktar biçimine göre denetler. Biçimin dışındaki bir değer derlemeyi burada durdurur; aksi halde derleme sorunsuz tamamlanır ve chart kurulduğunda küme tarafından reddedilirdi.
Üretilen ileti. Koşulla başlar, ardından düğümü, alanın Workload içindeki yolunu, değeri ve onu miktar olmaktan çıkaran nedeni belirtir ve bir miktarın aldığı biçimi açıklar:
a plugin has no representation for a value it was given
helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei)
(bir plugin’in kendisine verilen bir değer için gösterimi yok; helm: düğüm: bir miktar değil; miktar, 2, 0.5 veya 1.5 gibi, isteğe bağlı bir işaret ve en fazla bir tamsayı üs (1e3, 5E-2) ya da birim son eki (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) taşıyan bir sayıdır)
Nasıl düzeltilir: değeri Workload → Kaynak miktarları bölümünde açıklanan biçimde yazın. Alan şablonla üretiliyorsa düzeltilecek değer şablonun okuduğu değerdir: m veya Mi gibi yalın bir son ek, bir şablonun araya yerleştirdiği değer boş olduğunda geriye bıraktığı şeydir ve bir Release parametresi alana tam yazıldığı gibi ulaşır.
A service type the helm provider cannot render (helm provider’ının işleyemediği bir servis türü)
helm provider’ı her Workload services girdisini, türü girdinin type değeri olan bir Kubernetes Service olarak işler. Bir Loopback girdisi, port’larının yalnızca ana makinenin kendi loopback adresinden erişilebilir olmasını ister ve bir Kubernetes Service’in bunu yapan bir türü yoktur: bir NodePort Service’in hangi düğüm adreslerini dinlediği tek bir Service’in değil, tüm kümenin ayarıdır. Bu nedenle derleme, servislerin bildirildiği sırayla ilk Loopback girdisinde, herhangi bir kaynak yazılmadan önce durur.
Girdiyi başka bir tür olarak işlemek yerine durur, çünkü bir Service’in sahip olduğu türlerin her biri port’un nereye ulaştığını değiştirir: bir ClusterIP Service girdinin istediği yayımlanmış erişimi düşürür, bir NodePort Service ise port’u kümenin izin verdiği her düğüm adresinde yayımlar — girdinin önlemek için var olduğu daha geniş açığa çıkma.
Üretilen ileti. Koşulla başlar, ardından düğümü, servisin Workload içindeki yolunu ve türü belirtir:
a plugin has no representation for a value it was given
helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it
(bir plugin’in kendisine verilen bir değer için gösterimi yok; helm: düğüm: “Loopback” türü servisin port’larını yalnızca ana makinenin loopback adresinde yayımlar ve bir Kubernetes Service’in bunu yapan bir türü yoktur; port’ları küme içinde tutmak için ClusterIP, küme dışında yayımlamak için NodePort veya LoadBalancer bildirin)
Nasıl düzeltilir: bir helm hedefi için port’un kümede ne kadar uzağa erişmesi gerektiğini belirten türü bildirin — içeride tutmak için ClusterIP, yayımlamak için NodePort veya LoadBalancer. Bir Loopback girdisi, port’u 127.0.0.1 üzerinde yayımlayan bir compose hedefi içindir; bkz. Workload → services.
A Kubernetes version the helm provider cannot render a chart for (helm provider’ının chart işleyemediği bir Kubernetes sürümü)
helm provider’ı bir chart’ı kaynaktan, bir bileşen veya onun sınırı üzerindeki aggrega.ai/kubernetes-version ek açıklamasının belirttiği Kubernetes sürümü için işler ve değeri helm template --kube-version komutunun bayrağını okuduğu şekilde okur. Bu bayrağın reddedeceği bir değerin — "one.two", "latest", "1" gibi tek bir sayı, "01.20" gibi başında sıfır bulunan bir sayı — chart’ın .Capabilities.KubeVersion olarak okuyabileceği bir sürümü yoktur; bu nedenle derleme chart işlenmeden önce durur.
Chart’ı varsayılan sürüm için işlemek yerine durur, çünkü bir chart sürümü bir API sürümü, bir alan ya da bütün bir mekanizma seçmek için okur ve sizin belirttiğinizden farklı bir sürüm için işlenen chart o diğer sürümün biçimini üretir — dağıtıldığı kümenin çalıştıramayabileceği bir biçim.
Boş bir değer reddedilmez. Ayarlanmamış kabul edilir ve chart varsayılan sürüm için işlenir: aynı helm sürümünün standart helm template komutunun işlediği sürüm.
Üretilen ileti. Koşulla başlar, ardından düğümü ve bulunduğu sınırı, ek açıklamayı, değeri ve onu sürüm olmaktan çıkaran nedeni belirtir ve yazılacak biçimi açıklar:
a plugin has no representation for a value it was given
helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary
(bir plugin’in kendisine verilen bir değer için gösterimi yok; helm: sınırdaki düğüm: ek açıklama aggrega.ai/kubernetes-version: bir chart’ın işlenebileceği bir Kubernetes sürümü değil; chart’ın dağıtıldığı kümenin sürümünü, örneğin “1.31” veya “v1.31.2”, bileşene ya da sınırına yazın)
İleti hem düğümü hem de sınırını belirtir, çünkü provider bir bileşenin ek açıklamalarını ve sınırınınkileri birlikte okur, bileşenin kendi değeri önceliklidir; dolayısıyla değer ikisinden birine yazılmış olabilir.
Nasıl düzeltilir: chart’ın dağıtıldığı kümenin sürümünü — "1.31" gibi bir ana ve ara sürüm ya da "v1.31.2" gibi tam bir sürüm — bileşene veya sınırına yazın ya da varsayılan sürüm için işlemek üzere ek açıklamayı kaldırın. Bkz. helm → Bir chart’ın işlendiği Kubernetes sürümü.
A health probe cannot be turned into a compose healthcheck (bir sağlık yoklaması compose healthcheck’ine dönüştürülemiyor)
Bildirilen bir sağlık yoklaması bir compose healthcheck’ine dönüşür ve bunu iki şey durdurabilir.
Hiç port yayımlamayan bir container üzerinde HTTP üzerinden bir yolu denetleyen yoklama. Denetim, container üzerindeki bir port’a yapılan istek olarak oluşturulur; dolayısıyla port bildirilmemişse onu oluşturacak bir adres yoktur.
Hiçbir denetim yolu bildirmeyen bir yoklama — ne bir yol, ne bağlanılacak bir port, ne de çalıştırılacak bir komut. Denetime dönüştürülecek bir şey yoktur. Bu, yazmanız olası bir biçimden çok şemanın arkasındaki bir korumadır: bir yoklama buraya ulaşmadan önce bu üçünden birine sahip olup olmadığı açısından denetlenir.
Üretilen iletiler. İkisi de aynı koşulu bildirir — provider’ın gerektirdiği ve tam olarak tek bir değere çözümleyemediği bir şey — ve provider’ın kendi cümlesi hangisi olduğunu söyler:
a plugin could not resolve something it requires to exactly one value
compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none
(bir plugin gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi; compose: düğüm, container: http yoklaması: en az bir container port’u gerektirir; container hiç bildirmiyor)
a plugin could not resolve something it requires to exactly one value
compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec)
(bir plugin gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi; compose: düğüm, container: yoklama hiçbir biçim bildirmiyor (http/tcp/exec))
Nasıl düzeltilir: denetimin yapılacağı port’u yoklamayla aynı container üzerinde bildirin — HTTP üzerinden bir yoklama ilk container port’unu okur, bu yüzden denetimin oluşturulabilmesi için port’un var olması gerekir. Container gerçekten hiçbir şey yayımlamıyorsa onu başka bir yolla denetleyin: komut çalıştıran bir yoklamanın port’a ihtiyacı yoktur. Hiçbir denetim yolu bildirilmemiş bir yoklamaya bu üçünden birini verin.
Bir configmap biriminin arkasında dosya yok
Yapılandırma bağlayan bir birim, compose’un bu iş için kendi mekanizmasıyla, adıyla başvurularak teslim edilir; içeriği tutan girdi ise Recipe’in ürettiği bir dosyadan gelir. Bu koşul, eşleşen girdisi olmayan bir başvurunun bildirdiği durumdur: dosya orada değildir, bu nedenle bağlama arkasında hiçbir şey olmadan var olur ve konteyner boş bir yolu okuyarak ayağa kalkar.
Denetim, bileşen başına değil, birleştirilmiş çıktının tamamı üzerinde çalışır ve bu bilinçli bir tercihtir: başvuru ile içeriği tutan girdi farklı yollardan gelir ve aynı grubun farklı bileşenlerinden gelebilir; bu nedenle ikisinin birlikte bulunduğu ilk nokta birleştirilmiş çıktıdır. Bileşen başına bir denetim, içeriğini aynı gruptaki başka bir bileşenin sağladığı bir başvuruyu reddederdi.
Yalnızca ilki değil, çözümlenmemiş her başvuru kararlı bir sırayla bildirilir; böylece tek bir derleme hepsini adlandırır.
Üretilen ileti. Önce koşul gelir, ardından her hizmet, yaptığı başvuru ve bağlandığı yer:
a plugin could not resolve something it requires to exactly one value (bir plugin, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found (compose AssembleBoundary: hizmet, bağlandığı yerde bir yapılandırmaya başvuruyor; her birini Recipe’in artifacts: girdisinden üst düzey bir configs: girdisi olarak bildirin: configmap birimi, Recipe’in artifacts: girdisiyle üretilmiş bir dosya gerektirir; hiçbiri bulunamadı)
Nasıl düzeltilir: dosyayı Recipe’in artifacts: girdisinden, birimin başvurduğu adla üretin; ikisi bu adla eşleştirilir, bu yüzden birimin istediği ile Recipe’in ürettiği arasındaki bir uyumsuzluk yaygın nedendir. İçeriğin başka bir yerden gelmesi amaçlandıysa birim bunun için yanlış mekanizmadır: ortama ait bir değer onun yerine oraya gider.
Bir omits girdisinin dışarıda bıraktığı şey compose dosyasında hâlâ adlandırılıyor
Bir omits: girdisi, kaynaktan alınan bir compose dosyasından bir hizmeti, birimi ya da yapılandırmayı dışarıda bırakır ve compose, bildirmediği birini adlandıran bir dosyayı reddeder. Bu yüzden girdilerin birimleri kaldırıldıktan sonra, dosyanın geri kalanının bunlardan birine hâlâ yaptığı her başvuru işlemeyi durdurur: depends_on, links, volumes_from, extends, bir build.additional_contexts değeri ya da bir service: ağ, IPC, PID veya UTS kipiyle adlandırılan bir hizmet; bir volumes: girdisinin kaynağı olarak adlandırılan bir birim; bir configs: girdisiyle adlandırılan bir yapılandırma. Bunlar her hizmette, her hizmetin pre_start kancalarında ve her işte okunur. Tam liste ve yalnızca başvuruya benzeyen değerler compose → Kaynaktan alınan kip bölümündedir.
Denetim, bildiren Recipe’in ya da FeatureRecipe’in kendi dosyasını okur; bu nedenle aynı birleştirilmiş dosyaya katkıda bulunan başka biri dışarıda bırakılanla aynı adda bir birim bildirse bile işlemeyi durdurur. Yalnızca ilki değil, her başvuru bildirilir (önce anahtar sırasıyla hizmetler, ardından işler, her hizmetin kancaları kendisinden sonra); böylece tek bir derleme hepsini adlandırır.
Üretilen ileti. Önce koşul gelir, ardından başvuran her girdi, adlandırdığı birim ve başvurunun bulunduğu alan:
a plugin could not resolve something it requires to exactly one value (bir plugin, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
compose: what an omits entry left out is still named by the file: service "<service>" names <kind>"<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry (compose: bir omits girdisinin dışarıda bıraktığı şey dosyada hâlâ adlandırılıyor: hizmet, bir alanda bir birimi adlandırıyor; compose, bildirmediği bir hizmeti, birimi ya da yapılandırmayı adlandıran dosyayı reddeder: onu adlandıranı da dışarıda bırakın, başvuruyu valuesMapping ile değiştirin ya da girdiyi kaldırın)
Girdisinin adı hassas olarak bildirilmiş bir değerden oluşturulan bir birim <redacted> olarak gösterilir.
Nasıl düzeltilir: ikisinden hangisini kastettiğinize karar verin. Başvuran hizmet birime hâlâ ihtiyaç duyuyorsa birimi koruyun: girdiyi kaldırın. İhtiyaç duymuyorsa başvuruyu Recipe’in valuesMapping: alanıyla değiştirin (oradaki bir liste temel dosyanın listesinin yerini alır, bu yüzden depends_on: [] birini temizler) ya da başvuran hizmeti kendine ait bir girdiyle dışarıda bırakın.
Bir omits girdisinin dışarıda bıraktığı şey bir CloudFormation şablonunda hâlâ adlandırılıyor
Bir omits: girdisi, kaynaktan alınan bir CloudFormation şablonundan bir kaynağı dışarıda bırakır ve CloudFormation, bildirmediği bir kaynağı adlandıran şablonu reddeder. Bu yüzden girdilerin kaynakları kaldırıldıktan sonra, kalan şablonların bunlardan birine hâlâ yaptığı her başvuru işlemeyi durdurur: bir Ref, liste biçiminde ya da noktalı dize biçiminde bir Fn::GetAtt, bir kaynağın DependsOn alanı ya da bir Fn::Sub değişkeni. Bunlar her kaynağın gövdesinin ve her çıktının herhangi bir yerinde okunur. Tam liste ve yalnızca başvuruya benzeyen değerler cloudformation → Kaynakları kaynaktan alınan bir şablonun dışında bırakmak bölümündedir.
Denetim, bildiren Recipe’in ya da FeatureRecipe’in kendi şablonlarını birlikte okur: bu şablonlardan bir başkasının hâlâ bildirdiği bir mantıksal kimliğe yapılan başvuru durdurulmaz; dışarıda bırakılan bir kaynağa yapılan başvuru ise başka bir bileşen o mantıksal kimlikte bir kaynak bildirse bile işlemeyi durdurur. Yalnızca ilki değil, her başvuru bildirilir (kaynağın taşıdığı sırayla şablon şablon, her şablonun önce kaynakları sonra çıktıları anahtar sırasıyla); böylece tek bir derleme hepsini adlandırır.
Üretilen ileti. Önce koşul gelir, ardından her başvuru: bulunduğu şablon, adlandırdığı kaynak, onu nasıl adlandırdığı ve şablonun kökünden bir yol olarak nerede durduğu:
a plugin could not resolve something it requires to exactly one value (bir plugin, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry (cloudformation-provider: bir omits girdisinin dışarıda bıraktığı şey kaynağın şablonlarında hâlâ adlandırılıyor: şablon, bir yolda bir kaynağı adlandırıyor; CloudFormation, bildirmediği bir kaynağı adlandıran şablonu reddeder: onu adlandıranı da dışarıda bırakın ya da girdiyi kaldırın)
Bir girdinin alanları hassas olarak bildirilmiş bir değerden oluşturulduysa kaynağının mantıksal kimliği ve türü <redacted> olarak gösterilir; yolun o mantıksal kimliği yazan her adımı da öyle gösterilir.
Nasıl düzeltilir: ikisinden hangisini kastettiğinize karar verin. Başvuran kaynak dışarıda bırakılana hâlâ ihtiyaç duyuyorsa onu koruyun: girdiyi kaldırın. İhtiyaç duymuyorsa başvuran kaynağı da kendine ait bir girdiyle dışarıda bırakın; bir parametreye bağlanan değer yalnızca o parametreye yapılan başvurunun yerini alır, bu yüzden bir kaynağa yapılan başvuru bununla değiştirilemez. Kaynağı adlandıran bir çıktı dışarıda bırakılamaz, bu yüzden bir çıktının adlandırdığı kaynak kalır.
Bir valuesMapping anahtarı, kaynaktan alınan bir CloudFormation şablonunun hiçbir parametresini adlandırmıyor
Kaynaktan alınan bir CloudFormation şablonu değerleri bildirdiği Parameters aracılığıyla alır ve onu kaynak olarak kullanan Recipe’in ya da FeatureRecipe’in valuesMapping alanı, doldurduğu her parametre için bir anahtar yazar. Kaynağın hiçbir şablonunun bildirmediği bir parametreyi adlandıran anahtarın gidecek yeri yoktur; bu yüzden işleme onu atmak yerine durur. Bu, CloudFormation’ın bilinmeyen bir parametre için kendisinin bildireceği hatadır; ancak hâlâ sizin düzeltebileceğiniz bir aşamada bildirilir. Parametreleri yalnızca bir valuesMapping doldurur: hiçbir şeyin eşlemediği değerler bu yolla hiç okunmaz, bu yüzden bir bileşenin ya da bir eklemenin diğer girdileri için yazılmış kendi değerleri bu durumla hiç karşılaşmaz.
Üretilen ileti. Önce koşul gelir, ardından hiçbir şeyi adlandırmayan her anahtar ve kaynağın her şablonunun bildirdikleri:
a plugin could not resolve something it requires to exactly one value (bir plugin, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping (cloudformation-provider: Recipe’in ya da FeatureRecipe’in valuesMapping alanı bir anahtar yazıyor ve kaynağın hiçbir şablonu bu adda bir parametre bildirmiyor: şablon şunları bildiriyor, …; kaynaktan alınan bir şablon değerleri yalnızca bildirdiği parametreler aracılığıyla alır, bu yüzden anahtarı amaçlandığı parametrenin adıyla yeniden adlandırın ya da valuesMapping alanından kaldırın)
Başka bir component, kaynaklı bir şablonun bağlamasının doldurduğu bir CloudFormation parametresine başvuruyor
Kaynaklı bir şablonun parametresini, onu kaynak olarak alan Recipe’in ya da eklenmiş Feature’ın FeatureRecipe’inin valuesMapping alanı üzerinden doldurmak, o kaynağın her şablonundaki o parametreye yapılan her başvurunun yerine değer yazar ve parametrenin bildirimini kaldırır. Aynı birleştirilmiş yığının başka bir yerinden gelen içerik — başka bir component’in parçası ya da kaynaklı şablonu veya bir Feature’ın eklendiği component’in parçası — parametreyi hâlâ Ref, bir Fn::Sub değişkeni ya da bir kuralın Fn::ValueOf ifadesi üzerinden adlandırıyorsa, yığının artık bildirmediği bir şeyi adlandırmış olur; CloudFormation bunu yığın dağıtılırken reddeder, bu yüzden birleştirme durur. Yığının bir component’inin hâlâ kendi parametresi ya da bir kaynağın mantıksal kimliği olarak bildirdiği bir ad, yığının çözümlediği bir başvurudur ve durdurulmaz.
Yayımlanan ileti. Önce koşul, ardından her başvuru gelir: içinde bulunduğu component ve şablon, parametre ve Recipe’inin ya da eklenmiş FeatureRecipe’inin valuesMapping alanı onu dolduran component — bir component’e eklenmiş Feature o component ile, bir sınıra eklenmiş Feature ise kaynaklarının aggrega.ai/component-id olarak taşıdığı, sınırın yolu ile eklemenin adından oluşturulan kimlikle adlandırılır; örneğin bfr--stack--aux:
a plugin could not resolve something it requires to exactly one value
cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (bir eklenti, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi; cloudformation-provider: kaynaklı bir şablonun bağlamasının doldurduğu bir parametreye birleştirilmiş yığının başka bir yerinden hâlâ başvuruluyor: component’in şablonu, bir component için işleme yapan bir Recipe ya da FeatureRecipe’in valuesMapping alanının bağladığı parametreye başvuruyor; …; bir parametreyi bağlamak, onu bildiren kaynaktan bildirimini kaldırır ve yığındaki hiçbir şablon artık onu bildirmez, bu yüzden başvuru CloudFormation’ın çözümleyebileceği hiçbir şeyi adlandırmaz: bunun yerine bağlayan component’in yayımladığına başvurun, parametreyi ona başvuran şablonda bildirin ya da anahtarı valuesMapping’den kaldırın)
Nasıl düzeltilir: başvuran component değere ihtiyaç duyuyorsa, onu dolduran component’in değeri provides üzerinden yayımlamasını sağlayın ve ona başvurun; ya da parametreyi başvuran şablonda bildirin ki kendi değerini alsın; ya da anahtarı valuesMapping alanından kaldırın, böylece parametre bildirili kalır ve her component yığın dağıtılırken geçirilen değeri okur. Bkz. cloudformation → Kaynaklı bir şablonun parametreleri için değerler.
Bir CloudFormation parametresine bağlanan değer, parametrenin türünü alamıyor
Bir parametreye bağlanan sabit değer, CloudFormation’ın yığın dağıtılırken o parametrenin Type türü için geçirilen aynı değeri dönüştürdüğü biçimde dönüştürülür. Böyle bir dönüşüm olmadığında işleme durur: bir Number ya da List<Number> parametresine bağlanan sayı olmayan bir değer, tek değer alan bir parametreye bağlanan bir liste ya da eşleme ve değerini CloudFormation’ın şablondan değil Parameter Store’dan okuduğu bir AWS::SSM::Parameter::Value<…> parametresine bağlanan her sabit değer. Şablonun bir Fn::Sub değişkeni olarak adlandırdığı bir parametreye bağlanan liste de işlemeyi durdurur, çünkü bir değişken tek bir dizgenin yerine geçer.
Yayımlanan ileti. Önce koşul, ardından parametre, şablonu ve türü ile değerin neden uymadığı gelir; hiçbir değer alıntılanmaz:
a plugin has no representation for a value it was given
cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (bir eklentinin kendisine verilen bir değer için gösterimi yok; cloudformation-provider: şablonun parametresi şu türdendir ve değer uymuyor)
Nasıl düzeltilir: parametrenin türünde bir değer bağlayın — ya da bir Parameter Store türü için bir {{resolve:ssm:…}} dinamik başvurusu veya bir yerleşik işlev bağlayın — ya da yığın dağıtılırken geçirilecek bir değer için parametreyi bağlanmamış bırakın.
Bir CloudFormation parametresine bağlanan değer, kısıtlarının reddettiği bir değer
Bir parametreye bağlanan sabit değer, şablonun onun için bildirdiği kısıtlara — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue ve MaxValue — karşı denetlenir; bu, CloudFormation’ın yığın dağıtılırken geçirilen bir değer üzerinde yaptığı denetimdir ve bir parametreyi doldurmak şablonun bildirdiği hiçbir denetimi kaldırmasın diye derleme zamanına taşınmıştır. Bir yerleşik işlev ve bir dinamik başvurunun denetimi CloudFormation’a bırakılır, çünkü bunların değeri yığın dağıtılana kadar var olmaz.
Yayımlanan ileti. Önce koşul, ardından parametre, şablonu ve kısıt gelir; hiçbir değer alıntılanmaz:
a plugin has no representation for a value it was given
cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (bir eklentinin kendisine verilen bir değer için gösterimi yok; cloudformation-provider: şablonun parametresine bağlanan değer kısıtını karşılamıyor, CloudFormation bunu yığın dağıtılırken reddeder; parametrenin kabul ettiği bir değer bağlayın)
Nasıl düzeltilir: kısıtın kabul ettiği bir değer bağlayın; şablonun parametre için kendi bildirimi neye izin verdiğini listeler.
Bir CloudFormation parametresine bağlanan gizli değer şablona yazılacaktı
Bir parametreye bağlanan değer şablona yazılır ve yığının şablonunu okuyabilen herkes onu okuyabilir. İşleme, şablonun NoEcho olarak bildirdiği bir parametreye bağlanan sabit değerde durur; Recipe’in ya da FeatureRecipe’in valuesMapping alanı bir yazarın hassas olarak bildirdiği bir değeri okuyorsa, o eşlemenin bağladığı her sabit değerde de durur, çünkü çıktısının hiçbiri geldiği değere kadar izlenemez. Dinamik başvuru ve yerleşik işlev verildiği gibi yazılır — bir yerleşik işlevin içindeki metin de dahil — bu yüzden eşlemenin bir Fn::Sub dizgesine kattığı hassas bir değer şablona o metin olarak ulaşır ve gizli değerin kendisini şablonun dışında yalnızca dinamik başvuru tutar.
Yayımlanan ileti. Önce koşul, ardından parametreler ve bunun yerine neyin bağlanacağı gelir; hiçbir değer alıntılanmaz. Şunlardan biri:
a plugin has no representation for a value it was given
cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (bir eklentinin kendisine verilen bir değer için gösterimi yok; cloudformation-provider: şablonun parametresi NoEcho olarak bildirilmiş ve ona bağlanan değer şablona olduğu gibi yazılacaktı; bunun yerine bir dinamik başvuru ({{resolve:secretsmanager:…}} ya da {{resolve:ssm-secure:…}}) veya bir yerleşik işlev bağlayın ya da dağıtım zamanı değeri için parametreyi bağlanmamış bırakın)
cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (cloudformation-provider: Recipe’in ya da FeatureRecipe’in valuesMapping alanı hassas olarak bildirilmiş bir değer okuyor, bu yüzden ürettiği sabit değer reddedilir ve parametreleri bağlamak şablona olduğu gibi bir sabit değer yazacaktı; …)
Nasıl düzeltilir: gizli değeri Secrets Manager’da ya da Parameter Store’da güvenli dizge olarak saklayın ve ona bir dinamik başvuru bağlayın — {{resolve:secretsmanager:<secret>}} ya da {{resolve:ssm-secure:<name>}} — onu bir yerleşik işlevin metnine katmak yerine; ya da yığın dağıtılırken geçirilecek bir değer için parametreyi bağlanmamış bırakın. Bkz. cloudformation → Kaynaklı bir şablonun parametreleri için değerler.
Dinamik bir başvuru, CloudFormation’ın onu çözümlemediği bir yere bağlanmış
CloudFormation, dinamik bir başvuruyu bir kaynağın özelliklerinde çözümler, ancak EC2 kullanıcı verilerinde ve AWS::CloudFormation::Init meta verilerinde çözümlemez; ayrıca bir şablonun Outputs bölümünü yığını okuyan herkese gösterir. Bu nedenle, kaynağın herhangi bir şablonunun bir UserData özelliğinde, bu meta verilerde ya da kendi Outputs bölümünde başvurduğu bir parametreye bağlanan dinamik bir başvuru, dağıtılamayacağı ya da açığa çıkacağı bir yere ulaşmak yerine render işlemini durdurur.
Yayımlanan ileti. Önce koşul, ardından parametre, şablon ve şablonun ona nerede başvurduğu gelir; hiçbir değer alıntılanmaz:
a plugin has no representation for a value it was given (bir eklenti, kendisine verilen bir değer için bir gösterime sahip değil)
cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (parametreye bağlanan değer dinamik bir başvurudur ve şablon parametreye, CloudFormation’ın dinamik bir başvuruyu çözümlemediği ya da onu yığını okuyan herkese gösterdiği bir yerde başvurur; bunun yerine yerleşik bir işlev bağlayın ya da dağıtım zamanındaki bir değer için parametreyi bağlanmamış bırakın)
Nasıl düzeltilir: parametreyi bağlanmamış bırakıp değerini yığın dağıtılırken iletin ya da şablonun orada ihtiyaç duyduğunu üreten yerleşik bir işlev bağlayın.
Bir kural, bağlanmış bir CloudFormation parametresini adıyla okuyor
Bir şablonun Rules bölümündeki Fn::ValueOf, bir parametreyi Ref aracılığıyla değil mantıksal kimliğiyle adlandırır ve yığın dağıtılırken onun için iletilen değeri okur. Parametrenin bağlanması, bildirimini kaynağın her şablonundan kaldırır; bu da kuralı, bu şablonların hangisinde olursa olsun, hiçbir şeyi adlandırmaz durumda bırakacağından render işlemi durur.
Yayımlanan ileti. Önce koşul, ardından kural, şablonu ve parametre gelir:
a plugin has no expression for a construct this build declares (bir eklenti, bu derlemenin bildirdiği bir yapı için bir ifadeye sahip değil)
cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (şablonun kuralı parametreyi, bildirilmiş bir parametreyi mantıksal kimliğiyle adlandıran Fn::ValueOf aracılığıyla okur ve parametrenin bağlanması bildirimini kaynaktan kaldırır; kuralın dağıtımda okuyabilmesi için parametreyi bağlanmamış bırakın)
Nasıl düzeltilir: parametrenin anahtarını valuesMapping içinden kaldırın; böylece parametre bildirilmiş kalır ve kural, yığın dağıtılırken iletilen değeri okur.
Birleştirilmiş CloudFormation yığını bir dönüşümü taşıyamıyor
Birleştirilmiş yığının Transform bölümü her bileşeninkinden oluşturulur ve bir dönüşüm şablonun tamamını işler; bu nedenle etkisi kendisi için yazılmış içerikle sınırlı kalmayan bir dönüşüm, başka bir bileşenin içeriğinin nasıl dağıtılacağını değiştirmesine izin verilmek yerine reddedilir: AWS::CodeDeployBlueGreen ve AWS::Include her zaman, hesabınızın tanımladığı bir makro ve AWS::ServiceCatalog başka herhangi bir bileşenin yanında, AWS::LanguageExtensions başka bir bileşenin sunucusuz içeriğinin yanında ve AWS::Serverless-2016-10-31, Globals bölümü başka bir bileşenin sunucusuz kaynaklarına ulaşacaksa ya da olay kaynaklarından biri başka bir bileşenin bildirdiği bir kaynağı adlandırıyorsa. Tablonun tamamı cloudformation → Birleştirilmiş yığındaki üst düzey bölümler sayfasındadır.
Yayımlanan ileti. Önce koşul, ardından yığındaki her bileşen, dönüşüm ve onu bildiren bileşenler ile neden taşınamadığı gelir:
a plugin has no expression for a construct this build declares (bir eklenti, bu derlemenin bildirdiği bir yapı için bir ifadeye sahip değil)
cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (bileşenin birleştirilmiş yığını, bileşen tarafından bildirilen dönüşümü taşıyamaz)
Nasıl düzeltilir: dönüşümü bildiren bileşeni kendine ait bir sınıra yerleştirin; böylece yığını, dönüşümün değiştirebileceği hiçbir şey barındırmaz. Ya da ileti başka bir bileşenin bildirdiği içeriği adlandırıyorsa, bu içeriği dönüşümü bildiren bileşene taşıyın.
İki bileşen bir dönüşüm çiftini zıt sırada sıralıyor
Birleştirilmiş yığın, dönüşümlerini her bileşenin kendi sırasından ve CloudFormation’ın belgelediği sıradan oluşturulan tek bir sırada çalıştırır. İki sıranın birlikte geçerli olamadığı durumda — iki bileşen bir dönüşüm çiftini zıt yönde listelediğinde ya da bir bileşen, CloudFormation’ın tersini belgelediği hâlde AWS::Serverless-2016-10-31 dönüşümünü AWS::LanguageExtensions dönüşümünden önce listelediğinde — yazılabilecek tek bir sıra yoktur, bu nedenle render işlemi durur.
Yayımlanan ileti. Önce koşul, ardından çift ve onu her iki yönde kimin sıraladığı gelir:
a plugin could not resolve something it requires to exactly one value (bir eklenti, gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (dönüşümler her iki yönde sıralanmış ve birleştirilmiş yığının Transform bölümü onları tek bir sırada çalıştırır; onları tek bir sırada bildirin)
Nasıl düzeltilir: çifti, ikisini de listeleyen her bileşende tek bir sırada bildirin; CloudFormation bir sıra belgeliyorsa onun kendi sırasını izleyin.
İki girdi tek bir yığın çıktı adına ulaşıyor
Bir yığın çıktı adı yalnızca harf ve rakam kabul eder; bu nedenle ad, yazdığınız şeyden, bu alfabenin kabul etmediği karakterler atılarak değil kodlanarak oluşturulur. Böylece ayrı yazdığınız iki girdi ayrı kalır ve bu durdurma, yine de ikisinin tek bir ada ulaştığı durumu bildirir. Render işlemi, iki girdinin yazıldığı yerde tek bir çıktı yayımlamak yerine durur; aksi hâlde bunlardan biri sessizce atılırdı.
İki ya da daha fazla girdinin buluştuğu her ad bildirilir ve her adın arkasındaki her girdi kararlı bir sırada adlandırılır; böylece tek bir derleme size çakışmanın bir yanını değil tamamını gösterir.
Koşulla başlayan ve sağlayıcının kendi ayrıntısıyla devam eden yayımlanan ileti:
two things a plugin produced occupy one name in its output (bir eklentinin ürettiği iki şey, çıktısında tek bir adı işgal ediyor)
cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (bir yazarın yazdığı iki girdi tek bir yığın Output adına ulaşıyor; bir Output adı, bileşen ve girdi, mantıksal kimliğin kabul etmediği atılarak değil kabul ettiği harf ve rakamlara kodlanarak oluşturulur, böylece bir yazarın ayrı yazdığı iki girdi ayrı kalır — iki uçtan birini yeniden adlandırmak derlemeyi düzeltir)
Nasıl düzeltilir: girdilerden birini ya da bileşenlerden birini yeniden adlandırın; böylece ikisi artık tek bir ada ulaşmaz — ileti her iki tarafı da adlandırır. Ad, yazdığınız noktalama işaretlerini ve harf büyüklüğünü atılmış değil kodlanmış olarak taşır; bu nedenle bunlardan birindeki bir fark ada yansır ve farklı yazılmış iki girdi ayrı adlandırılır.
Bir CloudFormation parçası bir anahtarı iki kez yazıyor
Bir eşleme anahtar başına bir değer tutar; bu nedenle aynı anahtarı iki kez yazan bir parça, en son gelen gövdeyi tutar ve diğerini atardı. Eşleme kaynakları ya da çıktıları tutan blok olduğunda, atılan gövde yazılmış ama sonuçta yer almayacak bir kaynak ya da çıktıdır. Bunun yerine render işlemi durur.
Anahtarın yazıldığı her iki yer de bildirilir, çünkü iki kez yazılmış bir anahtar genellikle iki farklı anahtar olması amaçlanan iki düzenlemedir ve yazarın hangisini değiştireceğini anlamak için ikisine de ihtiyacı vardır.
Koşulla başlayan ve sağlayıcının kendi ayrıntısıyla devam eden yayımlanan ileti:
two things a plugin produced occupy one name in its output (bir eklentinin ürettiği iki şey, çıktısında tek bir adı işgal ediyor)
cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (bir eşleme anahtarı birden fazla kez yazılmış: anahtar bir satırda ve yeniden başka bir satırda yazılmış; bir eşleme anahtar başına bir değer tutar, bu nedenle iki gövdeden biri atılırdı — birini kaldırın ya da her anahtar bir kez yazılacak şekilde birini yeniden adlandırın)
Nasıl düzeltilir: parçayı iletinin adlandırdığı iki satırda açın. İki gövdenin tek bir şey olması amaçlandıysa artık gereksiz olanı kaldırın; iki ayrı şey olması amaçlandıysa her birinin kendine ait bir anahtarı olacak şekilde birini yeniden adlandırın. Parça bir şablondur; bu nedenle bir anahtar doğrudan yazılmak yerine oluşturuluyorsa yalnızca kaynağı değil render edilmiş metni de denetleyin.
A cross-boundary reference has no consuming stack to be written into (Sınırlar arası bir başvurunun yazılacağı tüketen bir yığın yok)
Bir bağımlılık bağlantısı ayrı ayrı birleştirilen iki çıktı arasında geçtiğinde, tüketen taraf bir yer tutucuyla işlenir ve başvuru, her iki taraf da var olduğunda yazılır. Bu durum, tüketen tarafın birleştirilmiş çıktısında hiç yığın şablonu bulunmadığında ortaya çıkar: başvurunun yazılacağı bir belge yoktur, dolayısıyla yer tutucu değiştirilemez.
Üretilen ileti. Durum hatanın türünü belirtir, sağlayıcının kendi cümlesi ise hangi girdi olduğunu söyler:
a plugin could not resolve something it requires to exactly one value (bir eklenti gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
cloudformation-provider: cross-boundary link resolve received no consumer stack template (sınırlar arası bağlantı çözümlemesi hiçbir tüketici yığın şablonu almadı)
Nasıl düzeltilir: tüketen bileşenin içine yazdığınız hiçbir şey buna yol açmaz; bu, sınırının birleştirdiği şeyin biçimidir. Tüketen tarafın gerçekten CloudFormation sağlayıcısı tarafından işlenip işlenmediğini denetleyin: başka bir şey birleştiren bir sınıra geçen bağlantının, başvurunun yerleşeceği bir yığını yoktur ve bağlantı, aynı sağlayıcının birleştirdiği iki sınır arasında olmalıdır. Her iki tarafın da CloudFormation olması gerekiyorsa, tüketen sınır hiçbir yığın şablonu üretmemiştir; bu, ona katkıda bulunan Recipes’i yazan kişiye sorulacak bir sorudur.
A cross-boundary reference was spliced into a longer string (Sınırlar arası bir başvuru daha uzun bir dizgenin içine eklendi)
Bir CloudFormation çapraz başvurusu metin değil bir nesnedir, bu yüzden bir değerin yalnızca tamamının yerini alabilir. Bu durum, daha büyük bir dizgenin içinde bulunan bir yer tutucunun bildirdiği durumdur: enjekte edilenin tamamı olarak iletilmek yerine etrafında oluşturulmuş bir değer. Nesnenin yerine konacağı bir şey yoktur, bu nedenle işleme, hedefin okuyamayacağı bir biçimde başvuru üretmek yerine durur.
Üretilen ileti. Önce durum, ardından değer ve değerin geldiği bağlantı gelir:
a plugin has no representation for a value it was given (bir eklentinin kendisine verilen bir değer için bir gösterimi yok)
cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (sınırlar arası bağlantı değeri daha büyük bir dizgenin içine yerleştirilmiş; yalnızca tam skaler bir enjeksiyon yığınlar arası bir başvuru taşıyabilir: soketteki çıktı anahtarı)
Nasıl düzeltilir: değeri, etrafında bir şey oluşturmak yerine bütün olarak iletin. Tüketen tarafın değere daha uzun bir dizgenin içinde ihtiyacı varsa (bir bağlantı dizgesi, bir URL), bu bileşimi, başvuru var olmadan önce Recipe’nin şablonunda değil, hedefin kendi söz dağarcığında başvurudan oluşturun. Eklemenin gerçekleştiği yer değeri enjekte eden eşlemedir, dolayısıyla değiştirilecek satır odur.
Two rendered resources land at one output file (İşlenen iki kaynak tek bir çıktı dosyasına düşüyor)
İşlenen her kaynak, adı kaynağın ne olduğundan ve ne olarak adlandırıldığından gelen bir dosyaya yazılır. Bunları paylaşan iki kaynak aynı dosya adını taşır; bu durumda biri diğerinin yerini işgal eder ve işleme, iki kaynağın işlendiği yerde tek bir dosya üretmek yerine durur.
Aynı biçimde işlenen iki kaynak bir çakışma değildir. İçerik bayt bayt eşleşiyorsa, birini tutmak hiçbir şey kaybettirmez ve işleme devam eder; dolayısıyla aynı sonuçla iki kez dahil edilen bir şablon bildirilmez.
Üretilen ileti. Önce durum, ardından onları üreten her iki şablon ve buluştukları dosya gelir:
two things a plugin produced occupy one name in its output (bir eklentinin ürettiği iki şey çıktısında tek bir adı işgal ediyor)
helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (düğüm: işlenen kaynakların ikisi de farklı içerikle aynı çıktıyı türetiyor: işlenen iki kaynak farklı içerikle aynı çıktı dosya adını türetiyor)
Nasıl düzeltilir: iki kaynağa ayrı kimlikler verin; genellikle farklı olan addır ve dosya adı ondan türer. İleti her iki şablonu da adlandırır; bu yüzden onları açın ve her birinin ne ürettiğini denetleyin: aynı kaynağı tek bir ad altında işleyen iki şablonun biri çoğu zaman eski bir kopyadır. Her ikisi de isteniyorsa, bunlar iki ayrı kaynaktır ve her birinin kendi adına ihtiyacı vardır.
A synthesized StatefulSet has no single service to govern it (Sentezlenen bir StatefulSet’i yönetecek tek bir hizmet yok)
Örnek başına depolama bildiren bir workload bir StatefulSet olarak işlenir ve bir StatefulSet, onu yöneten tek bir hizmeti adlandırır: her örneğe kalıcı adresini veren hizmeti. Bu hizmet, kendine ait bir küme adresi olmadan bildirilen hizmettir. İşlemeyi iki biçim durdurur: hiç bildirilmemiş olması, bu durumda adlandırılacak bir şey yoktur; ve birden fazla bildirilmiş olması, bu durumda hangisinin yöneteceğinin yanıtı yoktur. Her ikisi de hedefin reddettiği bir StatefulSet üreteceğinden, işleme bir tane üretmek yerine durur.
Üretilen iletiler. İkisi de aynı durumu bildirir (sağlayıcının gerektirdiği ancak tam olarak tek bir değere çözümleyemediği bir şey) ve sağlayıcının kendi cümlesi iki biçimden hangisiyle karşılaşıldığını söyler. Her biri, düğümü adlandıran bir çerçevenin altında yazdırılır:
a plugin could not resolve something it requires to exactly one value (bir eklenti gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (sentezlenen StatefulSet, yöneten headless bir Service gerektirir (type: Headless olan bir hizmet bildirin); hiçbiri bulunamadı: sentezlenen StatefulSet’in yöneten headless bir Service’i yok)
a plugin could not resolve something it requires to exactly one value (bir eklenti gerektirdiği bir şeyi tam olarak tek bir değere çözümleyemedi)
synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (sentezlenen StatefulSet birden fazla headless Service bildiriyor; yöneten Service belirsiz (tam olarak bir type: Headless hizmet bildirin): sentezlenen StatefulSet’in birden fazla headless Service’i var)
Nasıl düzeltilir: workload üzerinde headless türünde tam olarak bir hizmet bildirin. Hiç bildirilmemişse ekleyin; örnek başına depolaması olan bir workload’un buna ihtiyacı vardır ve her örneğe kendisiyle kalan bir adresi veren de budur. Birden fazla bildirilmişse, yönetmesi gerekeni tutun ve diğerlerine sıradan bir tür verin ya da onları kaldırın; ikinci bir headless hizmet genellikle headless olması gerekmeyen bir hizmettir.
A plugin reported a failure it did not classify (Bir eklenti sınıflandırmadığı bir hata bildirdi)
Bir derlemeyi durduran eklenti iki şey bildirir: ne olduğunu söyleyen kendi cümlesi ve bu cümlenin hangi tür hatayı adlandırdığı. Türler, derleyicinin bildirdiği küçük bir kümedir (ifadesi olmayan bir yapı, tek bir değere çözümlenemeyen bir girdi, tek bir adı isteyen üretilmiş iki şey, gösterimi olmayan bir değer) ve bu durum, bir eklentinin hatası bunların hiçbirine uymadığında seçtiği durumdur.
Bu bir varış noktası değil, bir geri dönüş seçeneğidir. Diğer türlerden biri uyarken buna başvuran bir eklenti size bildiğinden azını söylüyordur ve ifade, yalnızca bir şeylerin ters gittiğini değil, eklentinin sınıflandırmayı reddettiğini açıkça söyler; böylece aşırı kullanılan bir geri dönüş seçeneği, doğru bir bildirimden ayırt edilemez olmak yerine okunaklı olur.
Üretilen ileti. Önce durum gelir, ardından eklentinin kendi cümlesi:
a plugin reported a failure that none of the declared kinds names (bir eklenti, bildirilen türlerin hiçbirinin adlandırmadığı bir hata bildirdi)
<the plugin's own sentence>
Nasıl düzeltilir: derlemenize özgü her şeyin bulunduğu yer olan, eklentinin kendi cümlesini okuyun. Durumun kendisi size yalnızca eklentinin bunun için bir türü olmadığını söyler. Eklenti sizinse, hatanın gerçekte olduğu türü seçin; değilse, eklentiyi yayımlayan kişiye aktarmanız gereken şey bu cümledir.
A plugin named a condition the socket does not declare (Bir eklenti, soketin bildirmediği bir koşulu adlandırdı)
Bir eklenti, kendi numarasını uydurmak yerine bu derleyicinin bildirdiği bir koşulu raporlar; böylece size ulaşan tanımlayıcı her zaman aggrega explain komutunun yanıt verebildiği bir tanımlayıcıdır. Bu durdurma, başka bir şeyi adlandıran bir raporun ürettiği sonuçtur: altında hiçbir şeyin kayıtlı olmadığı bir numara, kullanımdan kaldırılmış bir numara, karşılık geldiği kayıttan farklı yazılmış bir kısa kod ya da iki farklı koşulu adlandıran bir tanımlayıcı çifti.
Raporu sessizce geri çekmek yerine durur. Tanımlayıcıları atıp genel eklenti hatası koşulunun geçerli kalmasına izin vermek, hiçbir koşul adlandırmamış bir eklentiden gelen derlemeyle tamamen aynı görünen bir derleme üretirdi; bu durumda sorunu düzeltmesi gereken kişi düzeltilecek bir şey olduğunu hiçbir zaman öğrenemezdi. Bunun yerine önerilen numarayı raporlamak ise size hiçbir şeye karşılık gelmeyen bir tanımlayıcı verirdi.
Derlemeniz, onu neyin durdurduğunu yine de alır. Durdurma, sorunlu numarayı aktarır, neden hiçbir koşula karşılık gelmediğini söyler, bir eklentinin daha iyi bir kimliği olmadığında başvurduğu genel koşulları adlandırır ve eklentinin kendi cümlesini değiştirmeden iletir.
Üretilen ileti:
wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence> (konuk eklenti, soketin bildirmediği bir koşulu adlandırdı: konuk şunu adlandırdı ve neden hiçbir koşula karşılık gelmediği; bir eklenti bu derleyicinin bildirdiği bir koşulu adlandırır ve daha iyisi olmadığında genel koşullardan ve kodlarından birine başvurur: eklentinin kendi cümlesi)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz; hatalı olan eklentinin raporudur ve raporladığı hata gerçektir. İletinin son kısmı olan eklentinin kendi cümlesine göre hareket edin. Eklenti sizinse, bu derleyicinin bildirdiği bir koşulu raporlayın; hata daha özel koşulların hiçbirine uymuyorsa iletinin listelediği genel türlerden birini kullanın. Eklenti sizin değilse, sorunlu numarayı eklentiyi yayımlayan kişiye iletin.
A source artifact is cached without a workspace root to anchor it (Bir kaynak yapıtı, onu sabitleyecek bir çalışma alanı kökü olmadan önbelleğe alınıyor)
Edinilen bir kaynak yapıtı, çalışma alanının yapıt önbelleği altındaki bir yuvada saklanır ve o yuvanın yolu çalışma alanı kökünden dışarıya doğru oluşturulur. Bu koşul, kökün boş gelmesini raporlar; bu da yuva yolunu göreli bırakırdı: baytlar yazılırken süreç hangi dizindeyse ona göre çözümlenir ve önbellek kimsenin seçmediği bir yere konurdu.
Çözümlenmek yerine reddedilir, çünkü yanlış yere yazılmış bir yuva hiç yuva olmamasından daha kötüdür: sonraki okumalar doğru yere bakar, hiçbir şey bulamaz ve yeniden edinir; böylece göreceğiniz şey hiçbir zaman bir şey tutmuyor gibi görünen bir önbellek olur ve nedenine işaret eden başka hiçbir şey olmaz.
Üretilen ileti. İletiyi koşulun kendi cümlesi açar, ardından yapıtı tanımlayan bilgiler gelir:
cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (boş çalışma alanı kökü)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği bunu gidermez; çalışma alanı kökü bir katalogda yazılmaz, derlemeyi yürüten şey tarafından sağlanır. Derlemeyi çalışma alanının içinden çalıştırın; böylece kök boş olarak aktarılmak yerine keşfedilir. Derleyiciyi kendi yazılımınızdan yürütüyorsanız çalışma alanı kökünü açıkça aktarın; önbelleği gerçekten geçerli dizine göreli isteyen bir çağıran tek bir nokta aktarır; bu kabul edilir ve bunu bilinçli olarak belirtir.
A value would place a cached file outside the cache (Bir değer, önbelleğe alınmış bir dosyayı önbelleğin dışına yerleştirecek)
Önbelleğe alınmış bir varlık ve önbelleğe alınmış bir kaynak yapıtı, her biri önbelleğin kendisi için adlandırdığı bir yuvada bulunur ve o yuva değerlerden oluşturulur: varlığın başvurusu ve çözümlendiği sürüm ya da bir kaynağın türü, url, chart, module_subdir, sürüm ve özet. Her değer düzende bir konumu adlandırır. Bu koşul, kendisi için yazılanı adlandırdığı konumdan başka bir yere (başka bir yuvanın yanına ya da tamamen önbelleğin dışına) taşıyacak bir değeri raporlar ve orada herhangi bir şey yazılmadan ya da okunmadan önce onu reddeder.
Bu değerlerin çoğu önbelleğin denetlemediği bir yerden gelir: bir kayıt defterinin sunduğu bir gövde, diskten geri okunan bir kayıt, bir Recipe ya da FeatureRecipe yazarının yazdığı bir koordinat. Sürüm yerine yol olan bir sürüm, yerinin üstüne çıkan bir url yolu ya da module_subdir ve nokta dizinine çözümlenen bir başvuru burada reddedilir. Tek bir dizini adlandıran bir değere ve yerinde ya da altında kalan bir url yoluna veya module_subdir değerine dokunulmaz.
Yukarı çıkan bir module_subdir, herhangi bir şey getirilmeden önce reddedilir. Bir git-repository kaynağı için aynı değer, çekme işleminin arşivlediği deponun dizinini de adlandırır ve deponun üstüne çıkan bir değer, çekme işleminin kendi checkout’unun yanındaki dosyaları okumasına yol açardı. Bu yüzden çekme işlemi depoyu getirmeden önce module_subdir değerini değerlendirir ve yukarı çıkan bir değeri, anahtarıyla birlikte aktararak bu koşulla reddeder: hiçbir şey getirilmez ve checkout’un yanındaki hiçbir şey okunmaz. İçindeki ters eğik çizgi, bir Windows yolunun okuduğu gibi ayırıcı olarak okunur; böylece ..\shared bir makinede checkout’un yanından okunmak yerine her makinede reddedilir. Değerin başındaki ya da sonundaki ayırıcı atılır; böylece /charts/app, charts/app dizinini adlandırır.
Üretilen ileti. İletiyi koşulun kendi cümlesi açar, ardından değer, yazıldığı anahtar altında yazıldığı haliyle ve çözüm gelir:
a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one (bir önbellek konumunun oluşturulduğu bir değer, önbelleğe alınmış dosyaları önbellekte adlandırdığı yerin dışına yerleştirecek. bir sürüm, ad, tür ya da ana makine önbelleğin tek bir dizinini adlandırır, bu yüzden eğik çizgi ya da ters eğik çizgi taşımaz ve nokta ya da çift nokta değildir; bir URL yolu ya da modül alt dizini yerinin altındaki dizinleri adlandırabilir ama üstüne çıkamaz. Değeri yazıldığı yerde düzeltin ya da bir kayıt defteri sunduysa, yayımcısından düzgün biçimli bir değer taşıyan bir sürüm yayımlamasını isteyin)
Nasıl düzeltilir: değer sizin yazdığınız bir değerse (bir Recipe’in ya da FeatureRecipe’in source.version, url veya module_subdir değeri), onu tek bir dizini ya da yerinin içinde kalan bir yolu adlandıracak biçimde düzeltin; ileti, değeri ve okunduğu anahtarı aktarır. Bir kayıt defteri sunduysa, yayımlanan varlık geçerli olmayan bir sürüm ya da koordinat taşır ve bunu sizin yapacağınız hiçbir değişiklik düzeltemez: ileti neyin getirildiğini adlandırır ve çözüm onu yayımlayan kişidedir.
A path the operation writes leads through a link out of the directory it must stay inside (İşlemin yazdığı bir yol, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor)
Birçok işlem, sizin adlandırdığınız yerlerde değil kendi belirlediği yerlerde kendi dosyalarını yazar ya da kaldırır: bir derlemenin çıktı dizini ve oraya yazdığı her dosya ile izlenen bir derlemenin yerine koyduğu .trace dizini; bir çekme işleminin yazdığı, bir Release’in kilit dosyası ve yanındaki eklenti güven kaydı; bir varlığın yanındaki, aggrega pin komutunun yazdığı ve kaynakları sabitleyen bir çekme işleminin sabitlediği her varlığın yanına yazdığı entity.lock; bir komut çalışma alanının yapılandırmasını yazdığında çalışma alanının .aggrega-config.yaml dosyası; bir çekme işleminin doldurduğu ve aggrega cache clear ile aggrega cache prune komutlarının boşalttığı yapıt önbelleği ve onun her alt ağacı; bir çekme işleminin imzasını doğruladığı her yapıt için bu önbellekte tuttuğu imza paketleri; aggrega import komutunun yazdığı taslaklar; aggrega plugin gen-catalog komutunun kendi çıktı dizini altına yazdığı Plugin varlıkları; ve varsayılan bir Release kaydedildiğinde düzenleyicinin dil sunucusunun yazdığı .aggrega/active-release işaretçisi ile onu tutan .aggrega dizini. İşlemi hangi yüzey başlatmış olursa olsun (komut satırı, düzenleyicinin dil sunucusu ya da bir asistanın araçları) aynısı geçerlidir. Çalışma alanı sınırı bunun uyguladığı kuralı ve bilinçli olarak çalışma alanının dışına uzanan yolları belirtir.
Bu yerlerin her birinin içinde kalması gereken bir dizin vardır ve bunun hangisi olduğu, işlemin onu altında oluşturduğu dizine bağlıdır:
Çalışma alanı, onun içinde oluşturulan her şey için. Olağan durum budur ve çalışma alanının içinde bulunan, sizin adlandırdığınız bir dizin için de geçerlidir. Bir derlemenin dist ve .trace dizinleri, derleme hangi klasörden çalıştırılırsa çalıştırılsın her zaman burada, çalışma alanı kökünün altında oluşturulur; hiçbir çıktı dizini adlandırmayan bir içe aktarmanın taslakları da öyle.
Çalışma alanının dışında bulunan, sizin adlandırdığınız bir dizin, onun altında oluşturulan her şey için: aggrega plugin gen-catalog ya da aggrega import komutuna aktardığınız çıktı dizini; yanındaki kilit dosyası ve güven kaydı için, sizin adlandırdığınız ya da çalışma alanı yapılandırmasının adlandırdığı, çalışma alanının dışında bulunan bir Release’in dizini; ve oradaki her varlığın yanındaki entity.lock için, aggrega pin komutuna adlandırdığınız bir varlığın dizini ya da --catalog ile adlandırdığınız veya yapılandırmanın catalog_dirs altında listelediği bir katalog dizini. Dizinin kendisi adlandırdığınız gibi kullanılır (bağlantı olan bir dizin üzerinden, işaret ettiği yere yazılır) ve onun altına yazılan şey onun içinde kalır.
Yapıt önbellek dizininin kendisi, onun altında önbelleğe yazılan her şey ve aggrega cache clear ile aggrega cache prune komutlarının orada kaldırdığı her şey için; bu, varsayılan .aggrega/cache için olduğu kadar yapılandırmanın çalışma alanı kökünden dışarı çıkarak yazdığı bir artifact_cache_dir (../shared-cache) için de geçerlidir. Önbelleğin kendi dizinlerinden biri ya da içindeki bir dosya, önbellek dizininin dışına çıkan bir bağlantıysa, çalışma alanının içinde başka bir yere çıksa bile reddedilir; böylece önbelleğe yazılan hiçbir şey ve bir temizleme ya da budamanın kaldırdığı hiçbir şey onun dışındaki bir dosyaya düşmez. Önce önbellek dizininin kendisinin nerede bulunduğu değerlendirilir: çalışma alanı kökünün içine yazılmış olan, çalışma alanının içinde nereye çıkarsa izlenir ve çalışma alanına bağlı tutularak, dışına çıktığında reddedilir; çalışma alanı kökünden dışarı çıkarak yazılmış olan adlandırdığınız gibi kullanılır ve bir bağlantıysa işaret ettiği yere yazılır.
Bu yerlerin her biri, orada herhangi bir şey yazılmadan ya da kaldırılmadan önce denetlenir. Yolun var olan en derin kısmı, yoldaki her sembolik bağlantı izlenerek, içinde kalması gereken dizin olmalı ya da onun altında bulunmalıdır. Yolun herhangi bir yerinde o dizinin dışına çıkan bir bağlantı (başka bir yerdeki bir dizine bağlanmış bir dist, başka bir projedeki bir dosyaya bağlanmış bir kilit dosyası, başka işlerle paylaşılan bir dizine bağlanmış bir .aggrega/cache, bir gen-catalog çıktı dizininin altında başka bir yere bağlanmış bir dizin) yazmanın ya da kaldırmanın dışarıya düşmesine yol açardı; bu yüzden işlem bunun yerine durur ve o yol tam olarak olduğu gibi bırakılır. Bu en çok bir derleme için önemlidir: aksi halde bağlantı olan bir çıktı dizinini temizleyip yeniden yazmak, makinenin başka bir yerindeki bir dizini silip yeniden yazardı.
Hiçbir yere çıkmayan bir bağlantı olduğu şey olarak, yani var olan bir şey değil olarak ele alınır; bu yüzden denetlenen, onu tutan dizindir. Böyle bir bağlantı, işlemin oluşturmak üzere olduğu bir yolun en sonunda duruyorsa, dosya bağlantının işaret ettiği yerde oluşturulurdu; bu yüzden işaret ettiği yer de denetlenir. Yolun içinde kalması gereken dizinin içinde bir yeri işaret eden bir bağlantı her zamanki gibi izlenir.
Üretilen ileti. İletiyi koşulun kendi cümlesi açar, ardından işlemin yazmak ya da kaldırmak üzere olduğu yol (hangisi olduğunu writing ya da removing belirtir), içinde kalması gereken dizin, yolda karşılaştığı bağlantı ve o bağlantının çıktığı yer, sonra da çözüm gelir. dist dizini çalışma alanının dışına çıkan bir bağlantı olan bir derleme, dokunacağı ilk şeyde, yani önceki çıktının temizlenmesinde durdurulur:
a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (bu işlemin yazdığı ya da sildiği bir yol, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor. o yola hiçbir şey yazılmadı ya da oradan kaldırılmadı. Bağlantıyı kaldırın ya da çalışma alanının içinde bir yere çıkmasını sağlayın ve işlemi yeniden çalıştırın)
Tanılama bir kategori taşımaz: hatalı olan, yazdığınız herhangi bir belge değil, diskteki düzendir.
Nasıl düzeltilir: iletinin adlandırdığı bağlantıyı kaldırın ve işlemi yeniden çalıştırın; böylece işlem o yerde gerçek bir dizin ya da dosya oluşturur. Ya da bağlantının, iletinin adlandırdığı dizinin içinde, izleneceği bir yere çıkmasını sağlayın. Buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği bunu gidermez.
İşlemin yazdığı bir ad, Windows’un tutamayacağı bir parça içeriyor
Windows’ta bazı adlar, yazıldıkları gibi bir dosyaya ulaşmaz. Windows’un bir aygıt için ayırdığı bir ad — CON, PRN, AUX, NUL, CONIN$, CONOUT$, COM0 ile COM9 arası ve LPT0 ile LPT9 arası, ayrıca üst simge bir, iki veya üç ile yazılan COM ve LPT adları — harf büyüklüğü ne olursa olsun ve ardından hangi uzantı gelirse gelsin bir dosyayı değil aygıtı adlandırır; bu nedenle nul, Aux.yaml ve com1.txt adlarının tümü aygıttır. Ayrıca bir yolun nokta veya boşlukla biten bir parçası, Windows’un yazıldığı gibi korumak yerine kırpabileceği bir parçadır. Böyle bir adı yazmak, baytlarını adlandırdığı dosyadan başka bir yere koyar.
Bu nedenle bir işlem, bir Windows makinesinde bir dizinin altına kendisinin seçmediği bir adı yazmak üzereyken, böyle bir parça içeren ad hiçbir şey yazılmadan önce reddedilir: önbellek arşivi okunmak üzere açarken, bir kaynak yapıtın veya bir katalog varlığının taşıdığı arşivin bir girdisi; bir derlemenin çıktı dizinine işlediği bir dosya; bir içe aktarıcının aggrega import komutuna döndürdüğü bir taslak, hem deneme çalıştırmasında hem yazmada; ve düzenlemeyi hangi yüzey istemiş olursa olsun, aggrega edit-document komutunun geri yazdığı belge. Adın her parçası, ters eğik çizgi ayırıcı olarak okunarak Windows’un okuduğu gibi değerlendirilir; böylece aux/x.yaml, aux dizini nedeniyle, report. son noktası nedeniyle ve .. \evil.yaml ilk parçası olan iki nokta ve bir boşluk nedeniyle reddedilir. Bir ad nedeniyle reddedilen bir küme diğerlerinin hiçbirini yazmaz: arşiv açılmaz, derlemenin çıktısı temizlenmez veya yazılmaz ve hiçbir taslak diske ulaşmaz.
Linux ve macOS’ta aynı adlar adlandırıldıkları gibi yazılır ve bu koşul hiçbir zaman tetiklenmez. Altına yazıldığı dizinin dışına çıkan bir ad farklı bir hatadır; bu koşula bakılmadan önce, her platformda o işlemin kendi iletisiyle reddedilir.
Üretilen ileti. İletiyi koşulun kendi cümlesi açar, ardından ad, Windows’un tutamayacağı parça ve adın altına yazılacağı dizin, ardından çözüm gelir:
a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written; rename that segment where the name is produced (bu işlemin yazdığı bir ad, Windows’un yazıldığı gibi tutamayacağı bir yol parçası içeriyor (ad, parçası, altında). Yazılmadı. Windows, harf büyüklüğü ne olursa olsun ve ardından hangi uzantı gelirse gelsin CON, PRN, AUX, NUL, COM1 ve LPT1 gibi aygıt adlarını ayırır ve nokta veya boşlukla biten bir parçayı yazıldığı gibi tutmaz; o parçayı adın üretildiği yerde yeniden adlandırın)
Tanılama bir kategori taşımaz: ad, derleyicinin hatayı kaydettiği tek bir belgeden değil, onu üreten kaynaktan — bir arşivin yayımcısından, bir Recipe’ten veya bir kitaplıktan, bir içe aktarıcıdan, bir düzenlemenin adlandırdığı yoldan — gelir.
Nasıl düzeltilir: iletinin adlandırdığı parçayı adın geldiği yerde yeniden adlandırın. Bir arşiv girdisi için bu, yalnızca yayımcısının değiştirebileceği yayımlanmış kaynak yapıt veya varlıktır. İşlenmiş bir dosya için, bir Recipe’in veya bir ArtifactLibrary’nin ona verdiği çıktı adıdır; bir taslak için onu adlandıran içe aktarıcı; bir düzenleme için belgenin yoludur. Windows makinesiyle ilgili hiçbir şey, adı yazıldığı gibi kullanılabilir kılmaz.
Derlemeyi durdurmayan koşullar
Yukarıdaki her koşul bir derlemeyi durdurur. Bazı koşullar, hiçbir zaman derlemeyi durdurmadan kendilerine ait bir kısa kod ve ileti taşır; bunlar, elinizdeki bir kodun hangi sayfadan gelmiş olursanız olun her zaman bir karşılığa ulaşması için burada listelenmiştir.
Bunlar dört türe ayrılır ve bir düzeltme aramaya başlamadan önce aradaki farkı bilmeye değer.
Bir öneri. Derleme bunu bildirir ve devam eder; işlenen çıktı, buna göre davransanız da davranmasanız da aynıdır. Her biri warnings.md sayfasında tam olarak anlatılır — neyin tetiklediği, derlemenin neresinde okunduğu, ne yazdırdığı ve bu konuda ne yapılacağı — ve aşağıdaki girdiler bunu burada tekrarlamak yerine hangi bölüm olduğunu belirtir.
Düzenleyicinin soğurduğu bir koşul. Düzenleyici entegrasyonunun kendisi tarafından yanıtlanır ve ne bir derlemenin çıktısına ne de bir tanılamaya ulaşır.
Daha önceki bir reddin arkasındaki bir güvence. Koruduğu kural, ondan önce derlemeyi durduran bir koşul tarafından uygulanır; bu nedenle bir derleme önce o önceki koşulla karşılaşır.
Derleme olmayan bir komuttaki ret. Gerçek bir çözümü olan kesin bir duruştur — karşılaştığı komutu sonlandırır ve hiçbir şey yayımlanmaz, yazılmaz ya da değiştirilmez — ancak derlemenin hiçbir aşaması ona ulaşmaz, bu nedenle hiçbir derleme onu bildirmez. Bir yapıtı yayımlamak ya da imzalamak, bir varlığın girdilerini sabitlemek, bir kayıt defteri eklemek, bir belgeyi düzenlemek, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmek ve bütün bir kataloğu — doğruluk açısından ya da yayımlama uzlaşımlarına karşı — denetlemek, bunlarla karşılaşılan yerlerdir; her girdi hangi komuta ait olduğunu ve düzeltmenin kimde olduğunu belirtir.
Bir açıklama bağlaması bir yolu her iki sütun listesinde de bildiriyor
Bir öneri. Bir Manifest açıklama bağlaması, aynı noktalı yolu hem maps.infra hem de maps.values listesinde adlandırır. Bu çakışmayı bildirmek geçerlidir ve derleyici bunu denetlemez: yönlendirme eşitlik bozucusu yolu deterministik olarak infra üzerinden gönderir; bu da o yolun values tarafını Aggregate’ten erişilemez bırakır.
İletisi şöyle başlar:
annotation binding declares one path in both pillar lists (açıklama bağlaması bir yolu her iki sütun listesinde de bildiriyor)
Bir derleme, yukarıda “An annotation routes through a pillar its authoring side may not use (Bir açıklama, yazım tarafının kullanamayacağı bir sütun üzerinden yönleniyor)” altında açıklanan duruşla karşılaşmadan önce sizi uyaran budur — öneri erken yüzeydir, o duruş ise uygulama yüzeyidir. Bu lint, warnings.md sayfasında “Binding-map-overlap lint (Bağlama eşlemesi çakışması lint’i)” altında anlatılır.
Bir ek adı, bildirilmiş bir yuvadan tek düzenleme uzaklıkta
Bir öneri. Bir bileşen, bir Feature’ı türünün bildirilmiş yuvalarından biri olmayan ama bunlardan birine tek düzenleme uzaklıkta duran bir ad altında ekler — yuva adındaki bir yazım hatasının aldığı biçim. Hiçbir yuvanın bildirmediği bir ad altındaki ek geçerlidir, bu nedenle hiçbir şey durmaz; önerinin adlandırdığı sonuçtur: ek, kastettiğiniz yuvanın doldurulması değil serbest bir ektir ve yuva boş kalır. Bir bağlantıda aynı yazım hatası geçerli değildir ve bunun yerine yakın yuvayı adlandırarak durur; bkz. “A connection carries an attachment under a name its socket declares no slot for (Bir bağlantı, soketinin yuva bildirmediği bir ad altında bir ek taşıyor)”. Ekin Feature’ı yakın yuvanın selector: koşulunu karşılıyorsa öneri üretilmez: bu eşleşme, “An attachment written under another name fits a slot its component leaves empty (Başka bir ad altında yazılmış bir ek, bileşeninin boş bıraktığı bir yuvaya uyuyor)” altındaki duruş tarafından değerlendirilir ve yuva boş bırakıldığında bildirilir.
İletisi şöyle başlar:
attachment name is a near miss for a declared slot (ek adı, bildirilmiş bir yuvaya çok yakın)
warnings.md sayfasında “Attachment-slot near-miss lint (Ek yuvası yakın ıskalama lint’i)” altında, eşleşme eşiği ve kasıtlı olarak yakalamadıklarıyla birlikte anlatılır.
Bir uses: soket adı, bildirilmiş bir soketten tek düzenleme uzaklıkta
Bir öneri. Bir bileşenin kendi uses: bloğu, türünün bildirmediği ama bildirdiklerinden birine tek düzenleme uzaklıkta duran bir soketi adlandırır. Bir geliştirici, Aggregate’in bildirdiği topolojiye sahiptir ve kataloğun öngörmediği bir soketi adlandırabilir; bu nedenle o yüzeyde türün bildirmediği bir soket adı geçerlidir ve hiçbir şey durmaz. Önerinin adlandırdığı sonuçtur: yanlış yazılmış ad, seçici ve kenar başına sözleşme taşımayan kendine ait geçici bir bağlantı oluşturur; kastettiğiniz soket ise bağlanmamış kalır.
İletisi şöyle başlar:
uses socket name is a near miss for a declared socket (uses soket adı, bildirilmiş bir sokete çok yakın)
warnings.md sayfasında “Uses-socket near-miss lint (Uses soketi yakın ıskalama lint’i)” altında anlatılır. Sahip varlığın usesSchema’sında bulunmayan bir soket adının gerçekten durduğu iki komşu yüzey, yukarıda “uses: socket not declared in the owning entity’s usesSchema (soket, sahip varlıkta bildirilmemiş)” altında ele alınır.
Bir Recipe, Component’inin bildirmediği bir provides anahtarı yayımlıyor
Bir öneri. Bir bileşene bağlı Recipe, provides: altında bileşenin türünün spec.schema.provides: sözleşmesinde bildirmediği bir anahtar yayımlar. Component’in bildirdiğinden fazlasını yayımlamak geçerlidir ve geçerli kalır — sözleşme alt kümeyi zorunlu kılar, üst kümeye izin verir. Önerinin adlandırdığı, iki taraftan da görünmeyen bir sonuçtur: bir uses: kenarı üzerinden okuyan bir tüketici, hedefin Recipe’sinin ürettiği her şeyi değil, bildirilmiş sözleşmesini görür; bu nedenle bildirilmemiş bir anahtar iletilmez ve onu okuyan tüketici şablonu boş işlenir.
İletisi şöyle başlar:
Recipe publishes a provides key its Component does not declare (Recipe, Component’inin bildirmediği bir provides anahtarı yayımlıyor)
Tersi durum bir öneri değildir: Recipe’sinin yayımlamadığı bir anahtarı bildiren bir Component, sözleşmeyi karşılanmamış bırakır ve durur. warnings.md sayfasında “Undeclared-provides-key lint (Bildirilmemiş provides anahtarı lint’i)” altında anlatılır.
Bildirilmiş bir parametreyi hiçbir şey okumuyor
Bir öneri. Bir Aggregate, spec.parameters: altında bir girdi bildirir ve o Aggregate’in kendi metnindeki hiçbir {{ .parameters.<key> }} başvurusu onu okumaz; bu nedenle bir Release onun için ne sağlarsa sağlasın işlenen çıktı aynıdır. Derleyici bir yazarın hangi ayarları sunduğunu denetlemez ve bir parametre, onu okuyacak başvurudan önce meşru olarak bildirilebilir; bu nedenle bu durum derlemeyi durdurmak yerine öneride bulunur.
İletisi şöyle başlar:
declared parameter is read by no reference in the Aggregate (bildirilmiş parametreyi Aggregate’teki hiçbir başvuru okumuyor)
warnings.md sayfasında “Unread declared-parameter warnings (Okunmayan bildirilmiş parametre uyarıları)” altında anlatılır; bir varsayılanın neden muafiyet olmadığı ve okumanın hangi başvuruları görüp hangilerini göremediği de dahil.
Bir sağlayıcı bağlaması, derlemenin okuduğu hiçbir eklentinin sunmadığı bir yeteneği adlandırıyor
Bir öneri. Bir plugins.providers girdisi bir yeteneği adlandırır ama hiçbir eklentiyi adlandırmaz ve derlemenin okuduğu sağlayıcı eklentilerinden hiçbiri — katalog dizinlerinde, derleyicinin içinde ya da kilit dosyasının kaydettikleri arasında — o yeteneği sunmaz. Bu, yanlış yazılmış bir yeteneğin aldığı biçimdir ve böyle bir girdiyi hiçbir şey okumaz: bir bağlamaya yalnızca bir Recipe onun yeteneğini istediğinde başvurulur ve hiçbir eklenti adlandırmayan bir bağlama, yeteneğin çözümlemesinin onsuz da seçmeyeceği hiçbir şeyi seçmez.
Derleme emin olamadığı için durmak yerine öneride bulunur. Bağlamalar tüm çalışma alanı için bir kez yazılırken bir derleme tek bir Release’e aittir; bu nedenle yeteneği sunan eklenti, yalnızca başka bir Release’in okuduğu bir eklenti olabilir. Bir eklenti adlandıran girdi farklı değerlendirilir ve kesin olarak yanlış olduğu yerde durur — bkz. yukarıdaki “A plugins.providers binding names a plugin that does not serve the capability (Bir bağlama, yeteneği sunmayan bir eklentiyi adlandırıyor)”.
İletisi şöyle başlar:
plugins.providers entry names a capability no provider-rendering plugin the build reads serves (plugins.providers girdisi, derlemenin okuduğu hiçbir sağlayıcı işleme eklentisinin sunmadığı bir yeteneği adlandırıyor)
ve yetenekle, varsa tek düzenleme uzaklıktaki sunulan bir yetenekle devam eder. warnings.md sayfasında “Provider-binding unserved-capability warning (Provider bağlaması sunulmayan yetenek uyarısı)” altında anlatılır.
Bir düzenleyici konumu belgenin dışına düşüyor
Düzenleyicinin soğurduğu bir koşul. İmlecin bulunduğu yere bağlı düzenleyici özellikleri (tanıma gitme, üzerine gelme, tamamlama) önce imleci belgenin ayrıştırılmış yapısı içinde konumlandırır. Bu koşul, konum belgede bulunmayan bir satırı gösterdiğinde o adımın bildirdiği şeydir; bu durum bir düzenleme sürerken geçici olarak ortaya çıkar ve düzenleyicinin gönderdiği konum, belgenin çoktan geride bıraktığı bir metne göre ölçülmüştür.
İletisi şöyledir:
position out of range (konum aralık dışında)
Hiçbir derlemeye ve hiçbir tanılamaya ulaşmaz. Bu koşulla karşılaşabilecek her özellik, bir hata göstermek yerine sonuçsuz yanıt verir; düzenleyici protokolünün istediği davranış budur: yanıtlanamayan bir istek hiçbir şey döndürmez ve düzenleyici bir sonraki tuş vuruşundan sonra yeniden sorar.
Dosyalarınızda düzeltilecek bir şey yoktur ve bir derlemede hiçbir şey görünmez. Bir sonraki düzenlemede toparlanmak yerine yanıt vermemeye devam eden bir özelliği hata olarak bildirmeye değer.
Şema birleştirme adımının kendi girdi koruması
Bir derlemenin ulaşmadığı bir koruma. Bir Component veya Feature başka birini genişlettiğinde ve her ikisi de şema bildirdiğinde, bu şemalar tek bir şemada birleştirilir. Birleştirmeyi yapan kitaplık, yapısal olarak birleştiremediği bir girdiyi reddeder:
Birleştirme adımına aittir; bir derleme bu adıma ulaşır, genişleten bir varlık ve tabanı her ikisi de şema bildirdiğinde. Koruduğu durum, kendisine boş bir zincirin ya da şeması eksik bir zincir girdisinin verilmesidir; çağıran ise bunların hiçbirini veremez: zinciri yalnızca varlığını önceden tespit ettiği şemalardan kurar ve yalnızca zincir boş olmayan çıktığında birleştirir.
Koruma, dışa aktarılan bir kitaplığın hatalı biçimlendirilmiş girdiyi reddetmesi olduğu için kalır. Kaldırılması, bir derlemenin ulaşabileceği hiçbir durdurmayı kaldırmaz; derleyicinin dışında böyle bir girdi veren bir çağıran için açık bir reddi bir çökmeye dönüştürür ki bu kesinlikle daha kötüdür.
Zincirin kendisi bu adımın ilgi alanı değildir. Döngüye giren bir zincir ve derinlik sınırını aşan bir zincir, herhangi bir şema birleştirilmeden önce tek extends: taramasıyla reddedilir — yukarıdaki “Cyclic extends chain (Döngüsel extends zinciri)” ve “An extends: chain runs past the depth bound (Bir zincir derinlik sınırını aşıyor)” bölümlerine bakın.
Bildirilmiş olduğu ve kendine ait bir kod taşıdığı için kataloglanmıştır; böylece eldeki bir kod bir karşılık bulur. Yazabileceğiniz hiçbir şey bunu üretmez ve bununla karşılaşmak yukarıda anlatılan düzenin artık geçerli olmadığı anlamına gelir; etrafından dolaşmak yerine hata olarak bildirmeye değer.
Açık bir değer, bir ek açıklamanın sağladığı değerin yerini aldı
Bir uyarı. Ek açıklama güdümlü genişletme, bir Aggregate’in ya da Release’in taşıdığı ek açıklamayı kendi yapılandırmasına sahip bir Feature eklentisine dönüştürür. Aynı eklenti açıkça yazılmış bir yapılandırma da taşıdığında (bileşende, onun üstündeki bir kapsamda veya Release’te), ikisinin de kapsadığı her anahtarda açık değer kazanır. Amaçlanan kural budur ve üretilen çıktı yanlış değildir, dolayısıyla derleme tamamlanır. Uyarının adlandırdığı şey sonuçtur: ek açıklamanın o anahtara katkısı artık çıktının hiçbir yerinde görünmez ve ek açıklamayı yazan kişi bunun bastırıldığını bilmeyebilir.
Yalnızca bir şeyi değiştirenleri değil, her yer değiştirmeyi bildirir. Birleştirme bastırılan değerin üzerine yazar; bu nedenle yapılacak bir karşılaştırma ve ikisinin uyuşup uyuşmadığını söyleyebilecek bir şey kalmaz; bir yer değiştirmenin gerçekleştiğine dair kayıt kanıtın tamamıdır. Tüm eklenti basamaklaması ve genişletme bir araya getirildiğinde okunur; bu, söz konusu kaydın var olduğu en erken noktadır.
İletisi şöyle başlar:
annotation contribution overridden by an explicit value (ek açıklama katkısı açık bir değer tarafından geçersiz kılındı)
ve yerinden edilen ek açıklamayla, ardından onu yerinden eden anahtarın koordinatlarıyla, ardından yerinden edilen ek açıklamanın yazıldığı yerle devam eder. Önündeki konum, bulgunun bulunduğu belge ve onun içindeki anahtardır:
<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>")
Bu değerlerden ikisi kolayca yanlış okunabilir. component yalnızca yerinden eden girdinin bir bileşeni olduğunda adlandırılır: tüm bir kapsam için yazılmış bir girdinin kendine ait bir bileşeni yoktur ve hiç sahip olmadığı bir bileşeni adlandırmak okuyucuyu kimsenin yazmadığı bir anahtara yönlendirir. annotation declared at ise yerinden edilen ek açıklamanın yazıldığı yeri adlandırır; bu, ek açıklama onu yerinden eden bileşende yazılmadığı her durumda devralındığı kapsamdır; yani başka bir başlık altında yinelenen bileşen anahtarı değildir.
Ne yapılmalı: açık değer kastettiğiniz şeyse hiçbir şey. Uyarı, önceliğin bir sürpriz değil bir seçim olması için vardır. Kastettiğiniz bu değilse, kapsamları farklı iki çıkış yolu vardır. Açık girdiyi silin; ek açıklamanın değeri o anahtara akar. Ya da ek açıklamayı onu taşıyan bileşenden veya kapsamdan kaldırın; bu durumda hiç katkı yapılmaz ve bu, o ek açıklamanın sağladığı diğer tüm anahtarları da etkiler. Her iki taraf da isteniyor ancak farklı anahtarlar için isteniyorsa, amaçlanandan daha ileriye uzananı daraltın; böylece ikisi artık örtüşmez.
Bir bağlantı, iki farklı sağlayıcının birleştirilmiş çıktıları arasında geçiyor
Bir bağımlılık bağlantısının iki ucu farklı çıktılarda birleştirildiğinde, sınırlar arası bağlamayı bildiren bir sağlayıcı bunu yerel olarak bağlar: üreten tarafta bir başvuru yayımlar ve tüketen tarafta onu çözümler. Bu bağlama bir sağlayıcının kendi sözcük dağarcığıyla yazılır ve bir sağlayıcı başka birinin yayımladığı bir başvuruyu çözümleyemez. Bu nedenle iki ucu farklı sağlayıcılar üzerinden işlenen bir bağlantı hiçbiri tarafından bağlanmaz.
Bu bir uyarıdır ve derlemeyi durdurmaz. Bağlantı yine de değerini taşır: enjeksiyon sözleşmesi, üreten tarafın skaler değerini tüketen tarafa başka her yerde olduğu gibi aktarır; dolayısıyla ortada bozuk bir bağlantı değil, olağan yolla bağlanmış çalışan bir bağlantı vardır. Bulgunun size söylediği, beklemiş olabileceğiniz yerel bağlamanın gerçekleşmediğidir ve buna göre davransanız da davranmasanız da çıktı değişmez.
Bildirim için bağlamayı bildiren tek bir sağlayıcı yeterlidir. Her iki ucun da bunu öne sürmesi gerekmez: tek bir iddia, yerel bağlamanın beklendiği ve imkânsız olduğu anlamına gelir ve o sağlayıcıyı ekleyen yazar bunu isteyen kişidir. Her iki iddiayı şart koşmak, bir sağlayıcının bağladığı ve diğerinin bağlamadığı olağan karma dağıtımda hiçbir şey söylemezdi; oysa bu bildirim tam da o durum içindir.
Uçların nereye yerleştirildiği hesaba girmez. Birleştirilmiş bir çıktı, yolu ve sağlayıcısıyla birlikte tanımlanır; bu nedenle sağlayıcıları farklı olan iki uç, yerleşimleri ne olursa olsun her zaman farklı çıktılardadır. Okunan şey iki sağlayıcı ve onların iki iddiasıdır.
Bu tür her bağlantı için bir kez, bağlantının yazıldığı belge ve anahtarda konumlandırılarak bildirilir.
Uzak uçla başlayıp ardından soketi ve her ucun sağlayıcısını adlandıran, verilen ileti:
cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (farklı sağlayıcılar tarafından işlenen uç noktalar arasında sınırlar arası bağlama desteklenmiyor)
Nasıl düzeltilir: bağlantının zaten taşıdığı skaler değer yeterliyse yapılacak bir şey yoktur; bu bir hata değil bir bildirimdir. Yerel bağlama isteniyorsa iki ucun tek bir sağlayıcı üzerinden işlenmesi gerekir: bir ucu diğerinin sağlayıcısı üzerinden yönlendiren bir sınıra taşıyın ya da her iki yeteneği tek bir sağlayıcıyla sunun. Bunların hiçbiri mümkün değilse dağıtımın sahip olduğu şey değer taşıyan biçimdir ve bağlantı çalışır.
Bir komut satırı eklenti çalıştırıcısı, eklentileri bulmanın bir yolu olmadan oluşturulmuş
Terminal komutu sağlayan bir eklenti, önce eklentinin başvurusunu baytlara dönüştürmesi gereken bir bileşen tarafından çalıştırılır. Bu koşul, söz konusu bileşenin bu dönüştürmeyi yapan parça olmadan oluşturulduğunu bildirir; dolayısıyla başvurudan çalıştırılacak herhangi bir şeye giden bir yol yoktur.
Bir derlemeyle değil, bir terminal komutuyla ilgilidir, bu nedenle derlemenin hiçbir aşaması ona ulaşmaz: kurulu bir komutun yönlendirildiği yerde ortaya çıkar ve ürettiği sonuç, herhangi bir derlemede bir durma değil, o komutun başlatılamamasıdır.
Yayımlanan komut satırı aracındaki hiçbir yol bunu ortaya çıkaramaz. Aracın o bileşeni oluşturduğu her yer aramayı sağlar; dolayısıyla bu koruma yalnızca başka bir şey bileşeni oluşturup aramayı dışarıda bıraktığında tetiklenir.
Koşulun kendi cümlesi olan, verilen ileti:
cliplugin: no plugin resolver configured (cliplugin: yapılandırılmış bir eklenti çözümleyici yok)
Nasıl düzeltilir: varlık dosyalarınızdaki hiçbir şey buna yol açmaz ve bir katalogda ya da çalışma alanında yazabileceğiniz hiçbir şey bunu gidermez. Yayımlanan komut satırı aracını çalıştırıyorsanız bu, ulaşabileceğiniz bir koşul değildir; başlamayan kurulu bir komut başka bir şeyi bildiriyordur ve okunması gereken, onun yazdırdığı iletidir. Eklenti çalıştırıcısını kendi yazılımınıza gömüyorsanız, onu oluştururken bir eklenti başvurusunu baytlarına çözümleyen aramayı sağlayın.
Bir kayıt defteri takma adı zaten başka bir ana bilgisayara bağlı
Bir derlemede değil, çalışma alanına bir kayıt defteri eklenirken verilen bir retti. Takma ad, tek bir kayıt defteri girdisini seçen kısa bir addır; bu nedenle girdiler arasında benzersizdir. Farklı bir ana bilgisayarın zaten kullandığı bir takma adı kaydetmek, mevcut bağlamayı gölgelemesine izin verilmek yerine reddedilir; aksi hâlde o takma adı kullanan her başvurunun gösterdiği yer sessizce değişirdi.
Aynı ana bilgisayarı mevcut takma adıyla yeniden eklemek bir çakışma değildir; bu, girdiyi yerinde günceller ve bir ana bilgisayarın diğer ayarlarını değiştirmek için komutu yeniden çalıştırmak da tam olarak bunu yapar.
Takma adı ve onu zaten kullanan ana bilgisayarı adlandıran, verilen ileti:
workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: kayıt defteri takma adı zaten bir ana bilgisayar tarafından kullanılıyor; farklı bir takma ad seçin ya da o ana bilgisayara doğrudan başvurun: kayıt defteri takma adı zaten başka bir ana bilgisayar tarafından kullanılıyor)
Nasıl düzeltilir: düzeltme, komut satırında operatöre düşer. Yeni kayıt defterine farklı bir takma ad verin ya da takma adsız bırakıp ona ana bilgisayar adıyla başvurun. Takma adı yeni ana bilgisayara taşımak istediyseniz, önce onu .aggrega-config.yaml içinde iletinin adlandırdığı girdiden kaldırın; bu ret, bir takma adı taşımanın bir kayıt defteri eklemenin yan etkisi değil, bilerek yaptığınız bir şey olması için vardır.
Bir kayıt defteri, güven belgesi olarak okunamayan bir belge sunuyor
Bir derlemede değil, bir kayıt defteri eklenirken verilen bir ret. Bir kayıt defteri, yapıtların hangi imzalama kimlikleriyle imzalanmasını beklediğini yayımlayabilir; böylece kayıt defteri eklenirken bu kimlikler, bir operatörün onları elle aktarması gerekmeden sabitlenebilir. Bu koşul, güven ilkesi olarak kullanılamayan bir belgeyle yanıt veren bir kayıt defterini bildirir.
Kesin bir ret olmasının nedeni tam da uç noktanın yanıt vermiş olmasıdır. Hiçbir şey yayımlamayan bir kayıt defteri, hoş görülen olağan ve beklenen bir sonuçtur; okunamayan bir şey yayımlayan ise bir yanlış yapılandırmadır ve ondan hiçbir şey sabitlememek, kayıt defterini sabitlenmiş gibi görünürken sessizce sabitlenmemiş bırakırdı.
Burada üç biçim bildirilir: biçimin tanımlamadığı bir alan taşıyan belge de dahil olmak üzere hiç çözümlenemeyen içerik; ne tam bir kimlik ne de bir desen adlandıran bir kimlik girdisi; ve yayımcısı (issuer) olmayan bir kimlik girdisi. Son ikisi reddedilir, çünkü böyle bir girdi hiçbir imzayla eşleşemez; dolayısıyla sabitlemeyi güçlendiriyor gibi görünürken onu zayıflatırdı.
Verilen iletiler. Çözümlenemeyen içerik:
registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: duyurulan güven yapılandırması hatalı biçimlendirilmiş)
eşleşecek hiçbir şeyi olmayan bir kimlik girdisi:
registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: duyurulan güven yapılandırması hatalı biçimlendirilmiş: bir kimlik girdisi identity ya da identity_regexp ayarlamalıdır)
ve yayımcısı olmayan bir girdi:
registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: duyurulan güven yapılandırması hatalı biçimlendirilmiş: bir kimlik girdisi issuer ayarlamalıdır)
Her biri, onunla karşılaşan komutla çerçevelenir:
aggrega registry add: <the message above>
Nasıl düzeltilir: düzeltme sizin değil, kayıt defterini işleten kişinin işidir; iletiyi ona aktarın, çünkü ileti tam girdiyi ve ondan neyin eksik olduğunu adlandırır. Bu arada devam etmek için kayıt defterini duyurduğu ilkeyi sabitlemeden ekleyin ve kimlikleri ya da anahtarı kendiniz sağlayın; komut bunları doğrudan alır ve hiç ilke yayımlamayan bir kayıt defteri için de yaptığınız budur.
Bir kayıt defteri güven belgesi yayımlamıyor
Bir hata değil, olağan ve beklenen bir sonuçtur ve hiçbir şeyi durdurmaz. Bir kayıt defteri beklediği imzalama kimliklerini yayımlayabilir ve çoğu yayımlamaz. Böyle bir kayıt defteri, istendiğinde hiç belgesi olmadığını yanıtlar ve kayıt defterinin eklenmesi sürer; sonuç bir bildirim olarak raporlanır ve kimlikler bunun yerine elle sabitlenir.
Ulaşılamayan bir kayıt defterinden bilerek ayrı tutulur. Bu kayıt defteri yanıt vermiştir; yanıt, hiçbir ilke yayımlamadığıdır. İkisini ayrı tutmak, bilinçli bir yokluğun hoş görülmesini, bir erişilebilirlik sorununun ise yine de öyle görünür kalmasını sağlar.
Kayıt defterini, ne yanıt verdiğini ve bunun yerine ne yapılacağını adlandıran bir bildirim olarak raporlanır:
Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Bildirim: güven ilkesi yayımlamıyor (HTTP 404); güvenini —identity ya da —key ile elle sabitleyin)
Kaydedildiği koşul registrytrust: registry advertises no trust config koşuludur.
Resmî merkez (hub) bunun istisnasıdır: yerleşik bir temel çizgi taşır; bu nedenle hiçbir belge yayımlamadığında bunun yerine o temel çizgi sabitlenir ve bildirim, sizden kimlikleri sabitlemenizi istemek yerine merkezin ne yanıt verdiğini ve onun yerine temel çizginin kullanıldığını söyler.
Nasıl düzeltilir: bozuk bir şey yoktur. Bu kayıt defterinden gelen imzaların denetlenmesini istiyorsanız, onu eklerken kimliği ya da anahtarı tam bildirimin söylediği gibi sağlayın; hiçbir ilke yayımlamayan bir kayıt defteri için olağan yol budur. İstemiyorsanız, kayıt defteri bir imzalama tutumu olmadan eklenir ve ondan gelen yapıtlar yalnızca bir imza taşıdıklarında doğrulanır.
Bir kayıt defteri, sabitlenecek güven politikası olmadan çevrimdışı ekleniyor
Bir derlemede değil, bir kayıt defteri eklenirken verilen bir ret. Kayıt defterinin eklenmesi, güveninin sabitlendiği tek andır: duyurduğu imzalama kimlikleri bir kez getirilir ve sonraki her çekme bu sabitlenmiş kopyaya göre doğrulanır. Çalışma alanı çevrimdışıyken bu getirme yapılamaz, dolayısıyla kayıt defterine hiç sorulmaz. Hiçbir şeye güvenmeyen ve sonraki her çekmenin kayıt defterini bağlı tutacağı bir girdi yazmak yerine, resmi hub dışındaki bir kayıt defterinin eklenmesi, politikayı siz sağlamadığınız sürece reddedilir.
Üç durum reddedilmez. Kimlik ya da anahtar sağlamak tam olarak bunları kaydeder ve hiç getirme yapmaz, bu yüzden çevrimdışıyken de çevrimiçiyle aynı şekilde çalışır. Resmi hub, getirme yapılsa da yapılmasa da taşıdığı yerleşik temel çizgisiyle eklenir. Getirme istememek — --fetch-trust=false — ise girdiyi, çevrimiçiyken olduğu gibi, bayraklardan kaydeder.
Bir kayıt defterinin eklendiği her yerde karşılaşılır: aggrega registry add, aggrega config init --registry <host>, hata iletisi kısa kodu cümlenin önünde taşıyan aggrega serve uygulamasının aggrega/registryAdd ve aggrega/configInit istekleri ve bu komutları çalıştıran aggrega mcp kayıt araçları. Bir yapılandırmanın başlatılması kimlik ya da anahtar almaz, bu yüzden çevrimdışıyken yalnızca hub ile başlatılabilir; başka bir kayıt defterini bunun yerine aggrega registry add ile ekleyin.
Koşulun kendi cümlesi olan, verilen ileti:
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> (resmi hub dışındaki bir kayıt defteri, elle sağlanmış bir güven politikası olmadan çevrimdışı kaydedilmez, çünkü duyurduğu politika getirilemez; onu bir kez çevrimiçiyken kaydedin ya da güvenini elle sabitleyin)
onunla karşılaşan komut ve adını verdiği kayıt defteriyle çerçevelenir:
aggrega registry add: <host>: <the message above>
Nasıl düzeltilir: kayıt defterini çalışma alanı çevrimiçiyken bir kez kaydedin — o tek çalıştırma için --offline=false verin ya da offline ayarını temizleyin — böylece duyurduğu politika getirilip sabitlenir; sonraki çekmeler sabitlenmiş kopyaya göre doğrulandığından sonrasında hiçbir şeyin yinelenmesi gerekmez. Çevrimiçi olamadığınız yerde politikayı elle sağlayın: anahtarsız bir kayıt defteri için bir ya da daha fazla --identity <identity>=<issuer> girdisi, anahtarlı bir kayıt defteri için de ortak anahtar dosyasını gösteren --key; bu, duyurusundan sabitleyeceğiniz şeyin ta kendisidir.
Bir etiket farklı içerikle zaten yayımlanmış
Bir derlemede değil, yayımlama sırasında verilen bir ret. Yayımlanmış baytlar dondurulmuştur: herhangi bir şey yüklenmeden önce hedef sürüm aranır ve gösterdiği özet, eldeki içeriğin üreteceği özetle karşılaştırılır. Zaten farklı içeriği gösteren bir sürüm reddedilir.
Bayt bayt aynı içeriği yeniden yayımlamak bir çakışma değildir. Özetler eşleşir, hiçbir şey yüklenmez ve komut sürümün zaten yayımlanmış olduğunu bildirir — bu yüzden kısmen başarılı olmuş bir yayımlamayı yeniden çalıştırmak güvenlidir ve yayımlamayı tamamlar: sürümde hâlâ eksik olan yayım tarihi ve gönderimin imzaladığı yerde imzası eklenir; ikisi de eksik olmayan bir sürüme ise hiçbir şey eklenmez; bu, Önceki bir gönderimin kısmi bıraktığı yayımlamanın tamamlanması bölümünde anlatılır.
Bunu geçersiz kılan bir bayrak yoktur. Değişen içerik yeni bir sürüm altında yayımlanır; tüketicilere altlarında değişen bir sürüm yerine bilinçli olarak geçebilecekleri bir sürüm bırakan da budur.
Verilen iletiler, sürümü, tuttuğu özeti ve sunulan özeti adlandırır. Sürüm artışını doğrulayan denetimi de adlandıran, bir katalog varlığının yayımlanması:
aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (zaten farklı özetle yayımlanmış; üzerine yazma reddediliyor — yeni bir sürüm yayımlayın (aggrega lint —pre-publish artışı doğrular): oci: etiket farklı içerikle zaten yayımlanmış)
ve bir veri yapıtının yayımlanması:
aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (zaten farklı özetle yayımlanmış; üzerine yazma reddediliyor — yeni bir sürüm yayımlayın: oci: etiket farklı içerikle zaten yayımlanmış)
Nasıl düzeltilir: sürümü yükseltin ve yeniden yayımlayın. Bir katalog varlığı için bu, birlikte değişen metadata.version ile varlığın bulunduğu sürüme özgü dizin demektir. Bunu yapmadan önce değişikliğin kastettiğiniz bir değişiklik olduğunu denetleyin: dokunmadığınızı düşündüğünüz bir sürümde iki özetin farklı olması, diskteki içeriğin yayımlanan içerik olmadığı anlamına gelir ve nedenini bulmak, üzerine yayımlamaktan daha değerlidir. İletide adı geçen yayım öncesi denetim, bir sürümü bir öncekiyle karşılaştırır ve artışın doğru olduğunu doğrulamanın yoludur.
Bir varlık dizinini başka bir varlıkla paylaşıyor
Bir derlemede değil, sabitleme ve yayımlama sırasında verilen bir ret. Bir çalışma alanı kökünün yan yana tuttuğu üçü dışında her varlık türünün kendine ait bir dizini vardır: bu üçü bir Aggregate, bir Release ve bir Manifest’tir. Yayımlanmış bir varlık, her sürüm için tek bir koordinattaki tek bir yapıttır ve yazıldığı dizin bunu yansıtır — sabitleme adımı bir dizinin yer verdiği tek entity.lock dosyasını yazar ve bir yayımlama varlığı dizininden paketler. Bu yüzden yanında başka bir varlık bulunan başka türden bir varlık bu iki anda da reddedilir: aggrega pin tarafından, yazar adına sabitleme istenen bir çekme ya da gönderim tarafından ve sabitlese de sabitlemese de aggrega push tarafından. Herhangi bir şey getirilmeden önce reddedilir ve hiçbir şey yazılmaz.
Birkaç varlık tutan bir dizin yine de yüklenir, lint edilir, doğrulanır ve derlenir. Yerleşim yalnızca dizinden bir şey üretildiğinde değerlendirilir; bu, iletinin yoldaki varlığı adlandırabildiği andır. Sabitleme yapmayan bir çekme varlığın yanına hiçbir şey yazmaz ve reddedilmez.
Yanındaki bir varlık sayılan şey, aynı dizinde doğrudan bulunan ve kind: alanı bir varlık türü olan başka herhangi bir YAML belgesidir. Bir chart’ın kendi dosyaları, bir compose parçası, bir Kubernetes manifest’i ya da bir README varlık değildir; bir alt dizin — yerel bir chart, bir source/ ağacı — ne tutarsa tutsun varlığın yanında sayılmaz. Her komşunun yalnızca türü ve adı okunur, bu yüzden bir komşunun bildirdiği hiçbir şey yanıtı değiştiremez.
Dizinin adı değerlendirilmez. Dizininde tek başına olan bir varlık, o dizin nerede olursa olsun bildirdiği sürümde sabitlenir ve yayımlanır; standart kütüphane kataloğunun kullandığı <name>/<version>/ yerleşimi bir denetim değil, bir uzlaşımdır.
Varlığı, yanındaki her varlığı ve taşınacak dosyaları adlandıran, verilen ileti:
the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (varlık dizinini başka bir varlıkla paylaşıyor ve bu türden bir varlığın kendine ait bir dizini vardır. çözüm: her varlığa kendine ait bir dizin verin — dosyayı, yalnızca o varlığın okuduğu dosyalarla birlikte kendine ait bir dizine taşıyın; yalnızca Aggregate, Manifest ve Release türleri bir dizini başka varlıklarla paylaşabilir)
Nasıl düzeltilir: iletinin adlandırdığı her varlığı, yalnızca onun okuduğu dosyalarla — yerel bir chart, içe aktarılan bir dosya ve o varlığın sabitlemelerini kaydediyorsa entity.lock — birlikte kendine ait bir dizine taşıyın ve uzak bir kaynak okuyan ya da bir dosya içe aktaran her biri üzerinde aggrega pin çalıştırın, böylece her kilit kendi varlığını kaydeder. Her birini <kind>/<provider-or-publisher>/…/<name>/<version>/ olarak yerleştirmek, onu standart kütüphane kataloğunun her varlığı tuttuğu yerde tutar. Bir katalog dizini dolaşılarak bulunur, bu yüzden katalog üzerinde yapılan bir derleme taşımadan sonra aynı çıktıyı üretir.
Bir varlık türünün artifact medya türü yok
Bir derlemede değil, yayınlamada verilen bir ret. Yayınlanabilir her varlık türünün, artifact’inin aldığı iki biçimin her biri için bir medya türü vardır — yalnızca belgesi ya da belgenin ve bildirdiği dosyaların bir arşivi — ve bir varlığı paketlemek bunu türe göre arar. Bu koşul, girdisi olmayan bir türü bildirir.
Hiçbir derleme buna ulaşmaz. Aynı aramanın çalıştığı diğer tek yer, eksik bir girdiyi “bu bir kütüphane değil” olarak ele alır ve devam eder; bu nedenle koşul orada hiçbir zaman ortaya çıkmaz.
Üretilen ileti: koşulun kendi cümlesi, komut ve paketlenmekte olan dosyayla çerçevelenmiş olarak:
aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: paket: oci: medya türü dağıtımı için bilinmeyen varlık türü)
Nasıl düzeltilir: yayınladığınız dosyanın kind: alanını aggrega push --list-kinds komutunun yazdırdığı türlerle karşılaştırın — yanlış yazılmış ya da desteklenmeyen bir tür burada bildirilir ve alanı düzeltmek çözümün tamamıdır. Tür o listede yer alıyorsa, bu sizin varlığınızda değil araç zincirinde bir eksikliktir ve türü belirterek bildirmeye değer.
Yayınlanmış bir arşiv, Windows’un kullanamayacağı bir girdi taşıyor
Bir varlık yayınlandığında verilen bir uyarı; hiçbir şeyi durdurmaz ve bir derleme bunu vermez. Belgesinin yanında dosya taşıyan bir varlık arşiv olarak yayınlanır ve arşivin tuttuğu her ad — önce varlık belgesinin kendi dosya adı, sonra taşıdığı her dosya —, yukarıdaki “A name the operation writes holds a part Windows cannot hold” durdurmasının Windows’ta uyguladığı kurala göre değerlendirilir: Windows’un bir aygıt için ayırdığı bir parça (harf büyüklüğü ne olursa olsun ve ardından hangi uzantı gelirse gelsin) ya da nokta veya boşlukla biten bir parça. Böylece aux/x.yaml bunu aux dizini için, report. sondaki noktası için ve bir şema dosyası içe aktaran con.yaml adlı bir belge kendi adı için tetikler. Hiçbir şey taşımayan bir varlık, ürünün seçtiği bir ad altında yerleştirilen yalnızca belgesi olarak yayınlanır ve bir Plugin hiçbir arşiv yayınlamaz; bu nedenle ikisi de bunu tetiklemez.
Her platformda verilir ve hiçbir şeyi reddetmez. Windows’taki bir çalışma alanı böyle bir girdiyi o durdurma altında yerleştirmeyi reddeder, bu nedenle sürümü kullanamaz; uyarı, yayıncının bunu Windows’taki birinden önce öğrenmesinin yoludur. Yayın ya da deneme çalıştırması, uyarı olmasaydı nasıl ilerleyecek ya da duracaksa tam olarak öyle ilerler ya da durur.
Bir varlığı yayınlayan her yüzey bunu verir, her biri kendi biçiminde.aggrega push ve onun --dry-run seçeneği, standart hata çıktısına her girdi için warning: ile başlayan bir satır yazdırır. Asistanın publish-entity aracı girdileri windows_unusable_entries olarak döndürür ve yanıtın metni de bunları adlandırır. aggrega serve, aggrega/publishEntity isteğini bunlarla windowsUnusableEntries olarak yanıtlar ve uyarı satırlarının kendilerini bildirim isteyen bir isteğe iletir. Her yanıt, böyle bir girdi olmadığında alanı dışarıda bırakır.
İletisi şöyle başlar:
an entry this publication carries cannot be used on Windows (bu yayının taşıdığı bir girdi Windows’ta kullanılamaz)
ve girdiyle, Windows’un tutamayacağı ilk parçasıyla, ardından çözümle devam eder. warnings.md içinde “A published archive carries an entry Windows cannot use (Yayınlanmış bir arşiv, Windows’un kullanamayacağı bir girdi taşıyor)” başlığı altında anlatılır.
Nasıl düzeltilir: iletinin adlandırdığı parçayı diskte ve varlığın bildirimlerinin dosyayı adlandırdığı her yerde yeniden adlandırın ve yeniden yayınlayın. Sürümün Windows’ta kullanılması amaçlanmıyorsa hiçbir şeyin değişmesi gerekmez.
İki katalog kimliği tek bir depo konumuna yayımlıyor
Derlemede değil, katalogun tamamı denetlenirken verilen bir ret. Bir varlığın yayımlandığı yer kimliğinden türetilir ve küçük harfe çevrilir; bu nedenle yalnızca harf büyüklüğünde ayrışan iki kimlik aynı yere düşer. İkisini de yayımlamak, bir varlığın baytlarının ötekininkilerle üzerine yazılmasına yol açar ve iki varlıktan hiçbirinde bunu belirten bir şey olmaz.
Denetim katalogun tamamı üzerinde bir kerede çalışır, çünkü çakışma tek tek varlıkların değil bir çiftin özelliğidir: ikisi de tek başına hatalı değildir ve ikisinden birini ayrı olarak okumak hiçbir şey göstermez.
Verilen ileti. İletiyi katalog denetiminin çerçevesi açar, ardından koşulun kendi cümlesi, ardından çakışan her grup gelir; her biri ortak konumu ve o konuma ulaşan kimlikleri adlandırır:
catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (katalog doğrulaması başarısız oldu: oci: farklı katalog kimlikleri aynı OCI depo konumuna eşleniyor:)
<location> <- <identity>, <identity>
Nasıl düzeltilir: iletinin adlandırdığı varlıklardan birini, metadata.name alanında ve onu yansıtan dizinde yeniden adlandırın. Hangisinin yeniden adlandırılacağı sizin seçiminizdir; yalnızca harf büyüklüğünde ayrışan çiftler yaygın biçimdir ve bir yazımı seçip tutarlı biçimde kullanmak, çiftin yeniden ortaya çıkmasını önler. Yeniden adlandırma bir varlığın kimliğinde gerçek bir değişikliktir; bu nedenle eski ada başvuran her şeyin de onunla birlikte değişmesi gerekir. Bu, çakışmayı adlardan biri yayımlanmadan önce çözmek için bir nedendir.
Anahtarsız imzalama, gerektirdiği hizmetler olmadan istendi
Derlemede değil, yayımlama sırasında imzalanırken verilen bir ret. Anahtarsız imzalamanın çevrimdışı bir biçimi yoktur: bir kimlik edinir, bu kimlik için kısa ömürlü bir sertifika düzenletir, imzayı daha sonra denetlenebileceği bir yere kaydeder ve ardından anahtarı atar. Bunların her biri çalışan bir hizmetle yapılan bir alışveriştir. Bu koşul, akışın başladığı kimliğin kullanılabilir olmadığını bildirir; bu nedenle akış başlatılıp yarıda bırakılmak yerine reddedilir.
Bunu iki biçim bildirir: kimlik sağlamak için hiçbir şeyin yapılandırılmamış olması ve yapılandırılmış bir şeyin hiçbir şey vermemesi.
Çevrimdışı bir çalışma alanı farklı bildirir; bunu her ağ adımını kapsayan ret altında yapar, çünkü ret daha bir kimlik istenmeden gerçekleşir.
Verilen iletiler. Kimlik kaynağı yok:
signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (signing: anahtarsız imzalama canlı bir kimlik sağlayıcısı, Fulcio ve Rekor gerektirir: bir kimlik belirteci kaynağı gereklidir)
ve hiçbir şey üretmeyen bir kaynak:
signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (signing: anahtarsız imzalama canlı bir kimlik sağlayıcısı, Fulcio ve Rekor gerektirir: bir kimlik belirteci gereklidir)
Nasıl düzeltilir: düzeltme, yayımlamanın nasıl çalıştırıldığında, işletmene düşer. Otomatik bir işlem hattında kimlik, işlem hattının kendi kimlik bilgilerinden gelir; bu nedenle bu genellikle işe bunları düzenleyen iznin verilmediği anlamına gelir. Etkileşimli çalıştırıldığında kimlik oturum açmaktan gelir ve komut bunu sizden ister. Canlı bir kimlik hiç istemediğiniz yerde bunun yerine elde tutulan bir anahtarla imzalayın: bu yol bu hizmetlerin hiçbirini gerektirmez ve onlara ulaşamayan bir ortamdan kullanılacak olan da budur.
İmzasız bir yayımlama, imza gerektiren bir kayıt defterini veya ilkeyi hedefliyor
Derlemede değil, yayımlamada verilen bir ret. İmzanın gerektiği yerde imzasız içerik yayımlanmaz. Denetim herhangi bir bayt yüklenmeden önce çalışır; bu nedenle kayıt defterine yarım bir şey ulaşmaz.
İki koşul vardır, çünkü bir gerekliliğin iki kaynağı vardır ve çözümleri farklıdır. Biri, hedef kayıt defterinin oraya yayımlanan her şeye uygulanan kendi tutumudur. Öteki, çalışma alanının, bir dizi yapıt türünü nereye yayımlanırlarsa yayımlansınlar kapsayan imzalama ilkesidir. İkisi birden geçerli olduğunda kayıt defterininki bildirilir, çünkü hedefi adlandırmak ikisinden daha yararlı olanıdır.
Burada imzasız içerik yayımlayan bir bayrak yoktur. İmzalamayı açıkça kapatmak reddi gevşetmez; yalnızca imzalamanın isteğe bağlı olduğu yapıtlar için varsayılanı değiştirir.
İmza yüklemeden sonra değil önce üretilir; bu nedenle bir imzalama hatası da buraya düşer ve hiçbir şey yayımlanmaz.
Verilen iletiler. Kayıt defterinin kendi gerekliliği:
aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: kayıt defteri imza gerektiriyor; yapıtı imzalayarak yeniden çalıştırın (burada imzasız içerik gönderen bir bayrak yok): signing: kayıt defteri imza gerektiriyor; imzasız içerik gönderilmesi reddediliyor)
yapıtı kapsama alan türü adlandıran, çalışma alanı ilkesinin gerekliliği:
aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: imzalama ilkesi bu tür için imza gerektiriyor; yapıtı imzalayarak yeniden çalıştırın (burada imzasız içerik gönderen bir bayrak yok): signing: imzalama ilkesi bu yapıt türü için imza gerektiriyor; imzasız içerik gönderilmesi reddediliyor)
ve kayıt defterinin koşulu altında bildirilen ve alttaki hatayı aktaran, üretilemeyen bir imza:
aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: imzala: signing: kayıt defteri imza gerektiriyor; imzasız içerik gönderilmesi reddediliyor)
İmzalama hatasının bir biçimi özel olarak adlandırılır, çünkü genel bir ret insanları işe yaramayacak bir kimlik bilgisini yeniden edinmeye yöneltir:
aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: imzala: kimlik belirteci doğrulanmış bir e-posta veya özne beyanı taşımıyor; OIDC akışı/istemcisi e-posta kapsamlı bir kimlik döndürmedi (belirteci yeniden dışa aktarmak veya yeniden edinmek işe yaramaz); kimlik sağlayıcısını/istemciyi/kapsamı bir kimlik döndürecek biçimde yapılandırın: signing: kayıt defteri imza gerektiriyor; imzasız içerik gönderilmesi reddediliyor)
Nasıl düzeltilir: düzeltme işletmene düşer. Yapıtı imzalayın ve yeniden yayımlayın: çalışma alanı hangisine göre kurulduysa, elde tutulan bir anahtarla ya da anahtarsız yolla. İmza gerekmesini beklemediğiniz yerde ileti, onu hangi kaynağın gerektirdiğini söyler: bir kayıt defterinin kendi tutumu, .aggrega-config.yaml içindeki o kayıt defterinin girdisindedir; türe göre kapsamlanan gereklilik ise çalışma alanı genelindeki imzalama ilkesindedir. İkisinden birini gevşetmek, neyi imzasız yayımlamaya razı olduğunuza dair bir karardır; bu nedenle ilkenin kapsamını daraltmak genellikle onu kapatmaktan daha iyidir.
References signed together need different signing credentials (Birlikte imzalanan başvurular farklı imzalama kimlik bilgileri gerektiriyor)
Derlemede değil, imzalamada verilen bir retdir. Birkaç başvuru verilen aggrega sign ve bir toplu iş dosyası verilen aggrega deprecate --from, kendilerine verilen her şeyi tek bir kimlik bilgisiyle imzalar: tek bir saklanan anahtar ya da tek bir anahtarsız kimlik. Bir başvurunun hangi kimlik bilgisini gerektirdiğine, onun kayıt defteri için yapılan yapılandırma karar verir: o kayıt defterine uygulanan bir signing.key_path, adlandırdığı anahtarı seçer; hiçbiri uygulanmıyorsa başvuru anahtarsız imzalanır. Birlikte adlandırılan başvurular farklı kimlik bilgileri gerektirdiğinde (bir kayıt defteri için bir anahtar, diğeri için hiçbiri ya da iki farklı anahtar) hiçbir şey imzalanmaz ve ileti her iki taraftaki kayıt defterlerini adlandırır.
Denetim bir kimlik istenmeden ve herhangi bir kayıt defteri okunmadan önce çalışır; böylece hiçbir şey imzalanmaz ya da eklenmez ve gerçekleşmeyecek bir çalıştırma için kimseden giriş istenmez. Bir imza, onu almış olan hiç kimseden geri çağrılamaz; çalıştırmanın, başvurulardan birinin gerektirdiği kimlik bilgisiyle imzalanmak yerine reddedilmesinin nedeni budur.
--key ile verilen bir anahtar her başvuru için karar verir. Yapılandırma her kayıt defteri için ne derse desin, adlandırılan her başvuruya uygulanır; bu nedenle böyle bir çalıştırma burada asla reddedilmez.
Bir toplu işin imzalandığı her yerde karşılaşılır: aggrega sign, aggrega deprecate --from, hata iletisi kısa kodu cümlenin önünde taşıyan aggrega serve komutunun aggrega/signArtifacts ve aggrega/deprecateArtifact istekleri ve aggrega mcp komutunun sign-artifacts ve deprecate-artifact araçları. Bir dinleyici üzerinden sunucuya ulaşan bir araç çağrısı, yapılandırmanın adlandırdığı bir anahtarı asla kullanmaz; bu yüzden orada her başvuru çağrının gönderdiği kimlikle imzalanır ve çağrı burada reddedilmez.
Üretilen ileti. Koşulun kendi cümlesiyle başlar, ardından her kimlik bilgisi imzalayacağı kayıt defterleriyle birlikte gelir ve çözüm en sonda yer alır:
aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (aggrega sign: imzalama: birlikte adlandırılan başvurular farklı imzalama kimlik bilgileri gerektiriyor, bu nedenle hiçbir şey imzalanmadı (biri signing.key_path’in adlandırdığı saklanan anahtarla imzalar, diğeri anahtarsız imzalar: hiçbir signing.key_path uygulanmıyor). çözüm: bunları her kimlik bilgisi için bir tane olmak üzere ayrı çalıştırmalarda imzalayın: önce bir kayıt defterindeki başvurular, sonra diğerindekiler; her çalıştırma tek başına nasıl imzalayacaksa öyle imzalar)
ve toplu işteki bir kayıt defteri imza gerektirdiğinde, onu çözümün sonunda adlandırarak:
aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (aggrega sign: imzalama: birlikte adlandırılan başvurular farklı imzalama kimlik bilgileri gerektiriyor, bu nedenle hiçbir şey imzalanmadı (biri signing.key_path’in adlandırdığı saklanan anahtarla imzalar, diğeri anahtarsız imzalar: hiçbir signing.key_path uygulanmıyor). çözüm: bunları her kimlik bilgisi için bir tane olmak üzere ayrı çalıştırmalarda imzalayın: önce bir kayıt defterindeki başvurular, sonra diğerindekiler; her çalıştırma tek başına nasıl imzalayacaksa öyle imzalar ve kayıt defteri imza gerektiriyor, bu nedenle bu ret yapılamayacak bir imzalamayı değil, aksi hâlde gerçekleşecek bir imzalamayı durdurur)
Kendi anahtarı olan ikinci bir kayıt defteri, “with a different held key” (farklı bir saklanan anahtarla) imzalıyor olarak adlandırılır. Bir anahtarın yolu asla yazdırılmaz: ileti, sizin değiştirebileceğiniz şey olan ayarı adlandırır.
Nasıl düzeltilir: başvuruları kayıt defterlerinin gerektirdiği kimlik bilgisine göre ayırın ve her kimlik bilgisi için bir kez çalıştırın: anahtarla imzalanan kayıt defterlerindeki başvuruları adlandıran bir aggrega sign, geri kalanları adlandıran bir diğeri; aggrega deprecate --from için her kimlik bilgisine bir toplu iş dosyası. Böylece her çalıştırma tek başına nasıl imzalayacaksa öyle imzalar. Bunun yerine tek bir çalıştırmada her başvuruyu tek bir anahtarla imzalamak için o anahtarı --key ile verin.
A detached signature does not verify against the key supplied (Ayrık bir imza, verilen anahtara karşı doğrulanmıyor)
Bir yük üzerindeki yalın bir imzanın bir açık anahtara karşı, tamamen çevrimdışı denetlenmesinin olumsuz sonucudur: yük imzalanandan farklıdır, imza değiştirilmiştir ya da anahtar onu üreten anahtar değildir.
Dağıtılan araç zincirindeki hiçbir şey buna ulaşmaz. Ait olduğu denetimin kendi testleri dışında çağıranı yoktur; bu nedenle kullanıcının çalıştırdığı hiçbir komut (derleme, çekme ya da yayımlama) bunu bildirmez. Bir derleme bunu yazdırabildiği için değil, kod bir şeye karşılık gelsin diye burada kataloglanmıştır. Bir çekme işleminin gerçekte yaptığı doğrulama tam bir imza paketi üzerindedir ve ayrı olarak bildirilir.
Doğrulayıcının bildirdiğini aktaran üretilen ileti:
signing: signature does not verify: <what the verifier reported> (imzalama: imza doğrulanmıyor)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve bir katalogda ya da çalışma alanında yazabileceğiniz hiçbir şey bunu gidermez. Yayımlanmış komut satırı aracını çalıştırıyorsanız bu, ulaşabileceğiniz bir koşul değildir; gerçekte karşılaştığınız bir imza sorunu bunun yerine yukarıdaki paket doğrulama koşullarından biri tarafından bildiriliyordur. İmzalama paketini doğrudan kendi yazılımınızdan kullanıyorsanız yük, imza ve anahtar birbirine ait olan üçü olmalıdır; olağan neden, imzalama ile doğrulama arasında yeniden serileştirilen bir yüktür, çünkü içerik aynı okunsa bile baytlar bu durumda farklıdır.
A resolved artifact is not a documentation bundle (Çözümlenen bir yapıt bir belge paketi değil)
Başka türde bir yapıta (bir katalog varlığı, bir eklenti) çözümlenen bir başvuru, belge olarak önbelleğe alınmak yerine reddedilir; böylece yanlış yöne işaret eden bir başvuru, daha sonra okunamayan bir paket olarak değil, işaret edildiği yerde başarısız olur.
Nerede ortaya çıkar. Belge paketi, makinedeki her projenin paylaştığı önbelleğe, çalışma alanının yapılandırılmış kayıt defterinden ayrılmış docs ad alanı altında edinilir: asistana yönelik sunucu tarafından bir kez, başladığında ve herhangi bir şeye yanıt vermeden önce; aggrega explain ve bir düzenleyicinin bir koda ilişkin açıklaması tarafından, ikisinden biri ona ilk kez ihtiyaç duyduğunda; ve aggrega scaffold --example tarafından; her durumda yalnızca makinede çalışma alanının imza denetiminin kabul ettiği bir kopya bulunmadığında. Bu, her edinmenin geri gelen üzerinde çalıştırdığı denetimdir.
Bir oturumu asla durdurmaz. Edinme, sonucunu sunucunun günlük akışında bildirir ve bağlantı her iki durumda da sürer; reddedilen bir yapıtın bedeli, o oturum için bulunamadı yanıtı veren belge kaynaklarıdır. aggrega scaffold --example için paket olmadan yazılacak hiçbir şey yoktur; bu nedenle orada bu, komutun reddidir ve hiçbir şey yazılmaz.
Başvuruyu ve her iki medya türünü adlandıran üretilen ileti:
docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (docscache: başvurunun medya türü beklenenden farklı: docscache: yapıt bir belge paketi değil)
Nasıl düzeltilir: buna varlık dosyalarınızdaki hiçbir şey neden olmaz ve hiçbir yazım değişikliği bunu gidermez. Edinmenin kullandığı başvuru, belge paketi olmayan bir şeye işaret ediyordur; paket başvurusu çalışma alanının yapılandırılmış kayıt defterinden türetildiği için onu denetleyin; iyi biçimlendirilmiş olup başka bir yapıta işaret eden bir başvuru başarıyla çözümlenir ve yalnızca burada başarısız olur.
A page is absent from a documentation bundle (Bir sayfa bir dokümantasyon paketinde yok)
Bir dokümantasyon paketi önbelleğe alınmış ve içeriği doğrulanmıştır, ancak istenen sayfa — ya da aggrega scaffold --example için örneğin dizini — paketin içinde yoktur. Bu, hiç paket olmamasından farklıdır: paket mevcut ve sağlamdır, eksik olan yalnızca içindeki giriştir.
Hiçbir derlemeye ulaşmaz. Dokümantasyon sayfalarını bir düzenleyiciye veya bir asistana sunan yüzey, durumu istenen kaynak için sıradan bir bulunamadı yanıtına dönüştürür. aggrega scaffold --example hiçbir şey yazmaz; durumu, örneği ve paketi adlandıran bir ret olarak bildirir ve ardından paketin gerçekten içerdiği örnekleri yazdıran aggrega scaffold --example --list komutuna yönlendirir.
İki bulunamadı yanıtından hangisini aldığınızı ayırt edebilmek yararlıdır, yüzey ikisini de aynı biçimde sunsa bile. Bu yanıt, paketin önbellekte ve sağlam olduğu, sayfanın ise içinde olmadığı anlamına gelir. Diğeri — hiçbiri önbellekte olmadığından ya da tek kopya çalışma alanının imza denetiminin reddettiği bir kopya olduğundan, çalışma alanının okuyabileceği bir paket bulunmaması — edinmenin tamamlanmadığı anlamına gelir ve nedenini sunucunun günlük akışı söyler.
Üretilen ileti; sayfayı ve sayfanın arandığı paketi adlandırır:
page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (sayfa: docscache: sayfa dokümantasyon paketinde bulunamadı)
Nasıl düzeltilir: dosyalarınızda bozuk bir şey yoktur. Paketten eksik olan bir sayfa, ya paket sayfadan daha eski olduğu için ya da istenen yol sayfanın yayımlandığı yol olmadığı için eksiktir — paket, sunucunun kendi sürümü olarak bildirdiği sürümde edinilir; dolayısıyla o sürümden sonra eklenen bir sayfa pakette bulunmaz. Sayfa hiç var olmamışsa, istek dokümantasyonun kullanmadığı bir yolu adlandırmıştır ve doğru yolu bulmak için yayımlanmış dokümantasyona bakılmalıdır.
An edit would produce a document its schema refuses (Bir düzenleme, şemasının reddettiği bir belge üretecektir)
Bir derlemede değil, bir belge düzenlemesinde verilen bir ret. Tek bir yapılandırılmış düzenleme — bir bileşen eklemek, bir Feature iliştirmek, bir kenar bağlamak veya bir değer ayarlamak — oluşturulur ve belgeye eklenir; ardından sonuç, belgenin türüne ait şemaya göre denetlenir. Bu denetim itiraz ederse düzenleme reddedilir ve hiçbir şey yazılmaz. Bu durum aggrega edit-document komutuna ve bir düzenleyicinin aggrega serve üzerinden ya da bir asistanın eriştiği aynı yeteneğe aittir; bunlar tek bir gerçekleştirime açılan ince giriş noktalarıdır.
Tür, çağıran tarafından verilmez, her zaman belgeden okunur. Türü adlandıran bir çağıran yanlış türü adlandırabilir ve sonuç bu durumda belgenin yazılmadığı bir şemaya göre denetlenirdi — bu da tam olarak bu denetimin reddetmek için var olduğu düzenlemeyi kabul ederdi.
Dosya bayt bayt olduğu gibi bırakılır ve yazma atomiktir; dolayısıyla reddedilen bir düzenleme hiç denenmemiş bir düzenlemeden ayırt edilemez ve düzeltilmiş bir istek, başladığınız belgeye karşı yeniden denenebilir.
Konusu, iyi biçimlendirilmiş bir istektir. İstek bu yeteneğin uyguladığı bir düzenlemeyi adlandırmıştır ve üreteceği belge, elle yazmış olsaydınız yazım şemasının reddedeceği bir belgedir — bu nedenle onun için hiçbir yazım kuralı yeniden belirtilmez: bir Release’ten geliştirici değeri taşımasını istemek her iki yolda da aynı şema tarafından reddedilir. Hiçbir düzenlemeye yönelmeyen bir istek — belgede hiçbir şeye ulaşmayan bir düğüm yolu, skaler beklenen yerde eşleme olarak yazılmış bir değer, başka bir şey taşıyan ve zaten var olan bir giriş — kendi gerekçesiyle reddedilir ve her yüzey bunu kendi kanalında bildirir.
Zaten geçersiz olan bir belge de bunu bildirir. Denetim, düzenleme hiçbir şeyi değiştirmediğinde bile çalışır; dolayısıyla ürünün okumayı reddedeceği bir belgeye karşı yapılan düzenleme başarı bildirmek yerine bunu söyler.
Denetim, belgenin her okunuşunda uygulanan denetimin aynısıdır; bu nedenle işlem hattı bir adım kimliğini iki kez bildiren bir Recipe ya da FeatureRecipe’yi de reddeder ki bu, hiçbir şemanın ifade edemediği bir kuraldır; bu durumda cümleden sonraki itiraz, A pipeline declares one step id twice (Bir işlem hattı bir adım kimliğini iki kez bildiriyor) altında açıklandığı gibi, o koşulun kendi cümlesi ve önerisiyle başlar.
Üretilen ileti; cümleden sonra şemanın kendi itirazını taşır — belge türü ve dosya, ardından konum, hatalı anahtar ve şemanın orada söyledikleri — ve öneriyle biter:
the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (ortaya çıkacak belge geçerli olmayacağı için düzenleme reddedildi ve hiçbir şey yazılmadı: belge zarfı doğrulaması başarısız oldu. Belgeyi türünün şemasına uyacak şekilde düzeltin)
Nasıl düzeltilir: belgeyi iletinin aktardığı konumda açın ve şemanın o anahtarda ne beklediğini söyleyen itirazı okuyun. Yapılacak değişiklik genellikle belgede değil istektedir — o yerde şemanın kabul ettiği bir giriş isteyin; aynı istek böylece sorunsuz uygulanır. Anahtar, o belge türünün hiç taşıyamayacağı bir anahtarsa, onu taşıyabilen yazım yüzeyine aittir ve türün varlık sayfası, türün bildirdiği alanları adlandırır. Neyin anlamsal olarak kabul edilebilir olduğu bu noktada karara bağlanmaz — örneğin bir bağımlılık soketinin üreticinin bildirdiği bir soket olup olmadığı — dolayısıyla bu ret her zaman belgenin biçimiyle ilgilidir, bir bağlantı üzerinden neyin tüketilebileceğiyle asla ilgili değildir.
An annotation key uses a prefix the platform reserves (Bir ek açıklama anahtarı platformun ayırdığı bir önek kullanıyor)
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. aggrega.ai/ öneki ve bir Feature dışında feature.aggrega.ai/ öneki platforma aittir: bunlardan birinin altına yazılan bir anahtar platformun atadığı bir anlam taşır; dolayısıyla oraya yazan, size ait bir varlık, sahibi olmadığı bir ad alanını sahiplenmiş olur.
Siz yazarken uyarır, yayımlama kapısında reddeder ve her iki okuma da bu tek durumu adlandırır. Bulunan şey her iki durumda da aynıdır; yalnızca sonuç farklıdır. Bu ayrım, burada kataloglanan yayımlama uzlaşımı kurallarının çoğunun davranış biçimidir; bu yüzden bir kez belirtilir ve aşağıda aksini söylemeyen girişlerde geçerli kabul edilir — zaten yayımlanmış bir sürümle karşılaştırma yapan iki kural bunu kendi girişlerinde belirtir, çünkü onlar yerel içerik üzerinde hiç çalışamaz.
İletisi şöyle başlar:
an annotation key on the entity uses a prefix the platform reserves (varlıktaki bir ek açıklama anahtarı platformun ayırdığı bir önek kullanıyor)
Nasıl düzeltilir: anahtarı kendi kuruluşunuzun sahip olduğu bir önekin altına taşıyın. Bir çalışma alanının yine de ayrılmış önekin altına yazmak için bir nedeni varsa, bu kural aggrega-lint.md sayfasındaki “The discipline rules” başlığı altında açıklanan devre dışı bırakma seçeneklerinden biridir.
Bir varlığın adı, türünün beklediği biçime uymuyor
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. Her varlık türü bir ad biçimi uzlaşımı taşır — bulutta yerel türler için segment sayıları, kütüphane türleri için PascalCase — ve bu varlığın bildirdiği ad, türünün beklediğiyle eşleşmiyor.
İletisi şöyle başlar:
the entity’s name does not follow the documented name shape for its kind (varlığın adı, türü için belgelenen ad biçimine uymuyor)
Nasıl düzeltilir: varlığı türünün beklediği biçime göre yeniden adlandırın; türe göre uzlaşımlar, varlıkları bilerek kendi yöntemiyle adlandıran bir katalog için devre dışı bırakma seçeneğiyle birlikte aggrega-lint.md içinde “The discipline rules” başlığı altında listelenir.
Bir şema, önceden çözümlenemeyen dinamik bir başvuru kullanıyor
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. Varlığın taşıdığı bir şema, hedefi şema yazılırken sabitlenmek yerine bir belge doğrulanırken seçilen dinamik bir başvuru yapısı kullanıyor. Burada başvurular önceden genişletilir; bu nedenle böyle bir yapının çözümlenebileceği, sürmekte olan bir doğrulama yoktur.
İletisi şöyle başlar:
a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (varlıktaki bir şema, belgeler arası başvuru çözümlemesinin izleyemediği dinamik bir başvuru yapısı kullanıyor)
Nasıl düzeltilir: dinamik yapıyı, hedefi doğrudan adlandıran düz bir başvuruyla değiştirin. Şemanın bu yapıya gerçekten ihtiyaç duyduğu ve belgeler arasında başvurulmayacağı durumlarda, kural aggrega-lint.md içinde “The discipline rules” başlığı altında açıklanan bir devre dışı bırakma seçeneği taşır.
Bir şema, platformun sahip olduğu bir tanımlayıcı bildiriyor
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. Varlığın taşıdığı bir şema kendine ait bir tanımlayıcı bildiriyor; oysa kanonik tanımlayıcı varlığın kimliğinden türetilir. Bildirilen tanımlayıcı türetilenin yerini alır, bu nedenle kanonik tanımlayıcıya göre yazılmış bir başvuru çözümlenmez olur.
İletisi şöyle başlar:
a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (varlıktaki bir şema kendine ait bir tanımlayıcı bildiriyor, oysa o şemanın kimliğinin sahibi platformdur)
Nasıl düzeltilir: bildirilen tanımlayıcıyı kaldırın ve türetilmesine izin verin. Bilerek kendine ait bir tanımlayıcı altında yayımlanan bir şema için devre dışı bırakma seçeneği, aggrega-lint.md içinde “The discipline rules” başlığı altında açıklanır.
Bir Component’in kategori etiketi ve dizini farklı kategorileri adlandırıyor
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. Bir Component bir kategori etiketi taşır ve bir kategori dizini altında dosyalanır; uzlaşım, ikisinin aynı kategoriyi adlandırmasıdır; böylece bir okuyucunun gezindiği dizin ile bir seçicinin eşleştirdiği etiket birbiriyle çelişemez.
İletisi şöyle başlar:
the entity’s category label does not match the category directory the entity is filed under (varlığın kategori etiketi, varlığın dosyalandığı kategori diziniyle eşleşmiyor)
Nasıl düzeltilir: ikisinden hangisi yanlışsa onu, uyuşacak biçimde değiştirin — ya dosyayı etiketinin adlandırdığı dizinin altına taşıyın ya da etiketi dizinin adlandırdığı kategoriye göre düzeltin. Kategorilerin kapalı kümesi ve devre dışı bırakma seçeneği aggrega-lint.md içinde “The discipline rules” başlığı altındadır.
Bir şema uzantısı doğrudan şema içeriğine yazılmış
Bir derlemede değil, bir varlığın yayımlama uzlaşımlarına göre denetlenmesinde verilen bir ret. Bir Component veya Feature, bir Aggrega şema uzantısını doğrudan şema içeriğine yazıyor; oysa varlık aynı şeyi bildirmek için birinci sınıf bir yüzey taşır. Doğrudan yazılan biçim çalışır; uzlaşım ise bildirilen yüzeyi tercih eder, çünkü varlık sayfalarının öğrettiği ve araçların okuduğu odur.
Bu, gruptaki bir derlemenin de bildirdiği tek kuraldır; derlemeyi durdurmayan bir öneri olarak. Varlığın yayımlama kapısında yayımlama uzlaşımlarına göre denetlenmesi, aynı bulguyu bir rede yükseltir.
İletisi şöyle başlar:
the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (varlık, bir Aggrega şema uzantısını bildirmek yerine doğrudan şema içeriğine yazıyor)
Nasıl düzeltilir: uzantıyı varlığın kendi soket veya ek yüzeyine taşıyın; component.md ve feature.md varlık sayfaları onu orada bildirir. Devre dışı bırakma seçeneği aggrega-lint.md içinde “The discipline rules” başlığı altındadır.
Bir Plugin hiçbir çalışma zamanı sınırını sabitlemiyor, bu yüzden platformunkiler uygulanıyor
Bir varlık yayımlama uzlaşımlarına göre denetlendiğinde, hem siz yazarken hem de yayımlama kapısında verilen bir öneri; hiçbir şeyi durdurmaz ve bir derleme bunu vermez. Bir Plugin, ana makinenin eklentiyi yükleyip çalıştırırken uyguladığı bellek tavanını ve zaman sınırını bildirir. Hiçbirini bildirmeyen bir Plugin platformun varsayılanlarıyla çalışır; bu bir hata değil, desteklenen bir sonuçtur — dolayısıyla bunun bildirdiği, varsayılanların geçerli olduğu ve bunları açıkça sabitlemenin mümkün olduğudur.
İletisi şöyle başlar:
the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (Plugin varlığı kendine ait bir çalışma zamanı kaynak sınırı bildirmiyor, bu yüzden platform varsayılanları uygulanıyor)
Nasıl düzeltilir: eklentinin gerçekten ihtiyaç duyduğu sınırları sabitleyin ya da varsayılanları bilerek yerinde bırakın. Devre dışı bırakma ayarı taşımaz; bunun nedeni, varlık hakkında bir yargı değil bir olgu bildirmesidir: gevşetilecek bir şey yoktur. Alanlar plugin.md sayfasında açıklanır.
Bir ek yuvası yalnızca gizli malzeme kabul ediyor, ama onu işlediğini belirtmiyor
Bir varlık yayımlama uzlaşımlarına göre denetlendiğinde, hem siz yazarken hem de yayımlama kapısında verilen bir öneri; hiçbir şeyi durdurmaz ve bir derleme bunu vermez. Bir ek yuvası, seçicisi aracılığıyla onu yalnızca gizli bilgi taşıyan bir Feature’ın doldurabileceğini sabitleyebilir ve ayrıca onu dolduran her şeyin gizli malzeme işlediğini kaydedebilir. Seçici hangi doldurmaların kabul edilebilir olduğunu belirtir; kayıt ise işlemeyi belirtir. Birincisini sabitleyip ikincisini atlayan bir yuva, işlemenin yuvadan okunması yerine seçiciden çıkarılmasını gerektirir. Bir varlığın bildirdiği her yuva denetlenir: kendi ek bloğundaki bir yuva ve bir Component üzerinde, bir bağımlılık soketinin içinden geçen her bağlantı için bildirdiği bir yuva — bir soketin yuvasıyla ilgili bulgu, yuvanın yanında soketi de adlandırır.
İletisi şöyle başlar:
an attachment slot admits only secret material and does not declare that it handles it (bir ek yuvası yalnızca gizli malzeme kabul ediyor ve onu işlediğini bildirmiyor)
Nasıl düzeltilir: işlemeyi, yuvada onu sabitleyen seçicinin yanında bildirin. Plugin sınırları kuralının taşımadığı nedenle bu da devre dışı bırakma ayarı taşımaz: varlık hakkında bir olgu bildirir ve kararı size bırakır.
Bir Recipe, Component’inin bildirmediği bir provides anahtarı yayımlıyor; yayımlamada denetlenir
Bir varlık yayımlama uzlaşımlarına göre denetlendiğinde, hem siz yazarken hem de yayımlama kapısında verilen bir öneri; hiçbir şeyi durdurmaz ve bir derleme bunu vermez. Bir Recipe provides: altında bir anahtar yayımlıyor ve Recipe’nin uyguladığı Component bu anahtarı şemasının provides sütununda bildirmiyor. Bir bağlantı üzerinden bağlanan bir tüketici, Recipe’nin ürettiği her neyse onu değil, Component’in bildirilmiş sözleşmesini okur; bu nedenle anahtar üretilir, sonra bir şey onu tüketmeye çalıştığı yerde reddedilir.
🔴 Bunu iki koşul tanımlar ve ikisi aynı değildir. Bir derlemenin bildirdiği öneri yukarıda “A Recipe publishes a provides key its Component does not declare” başlığı altında belgelenmiştir; bu ise varlık yayımlama uzlaşımlarına göre denetlendiğinde verilir ve kendi kodunu taşır. Bulgu, iki yüzeyde karşılaşılan aynı olgudur — hangisiyle karşı karşıya olduğunuzu anlamak için tanılamadaki kodu okuyun.
İletisi şöyle başlar:
the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (Recipe, uyguladığı Component’in bildirmediği bir provides anahtarı yayımlıyor, bu yüzden o anahtarı bağlayan bir tüketici reddediliyor)
Nasıl düzeltilir: anahtarı Component üzerinde bildirin; böylece bir tüketicinin okuduğu sözleşme Recipe’nin ürettiğini içerir — ya da hiçbir şeyin onu tüketmesi amaçlanmıyorsa Recipe’den yayımlamayı bırakın. Devre dışı bırakma seçeneği aggrega-lint.md içinde “The discipline rules” başlığı altındadır.
Bir Component’in metrik ek açıklaması ile provides anahtarı uyuşmuyor
Bir varlık yayımlama uzlaşımlarına göre denetlendiğinde, hem siz yazarken hem de yayımlama kapısında yükseltilen bir uyarı; hiçbir şeyi durdurmaz ve bir derleme bunu yükseltmez. Bir Component, ürününün metriklerinin nasıl kimlik doğruladığını observability.aggrega.ai/metrics-credential ek açıklamasında — none, target-key ya da separate-token — belirtebilir ve her Recipe’sinin bir örneğin metriklerinin kimlik bilgisi gerektirip gerektirmediğini söylemek için yayımladığı metrics_credential_required provides anahtarını bildirebilir. İkisi, ürün hakkında iki taraftan görülen tek bir olgudur; bu nedenle metriklerinin kimlik bilgisi almadığını belirten bir Component böyle bir anahtar bildirmez, kimlik bilgisi aldığını belirten ise bildirir. Bu koşul, ikisinin uyuşmadığı bir Component’i bildirir ve Component’i, ek açıklamanın değerini ve fazla ya da eksik olan anahtarı adlandırır.
İletisi şöyle başlar:
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 (bir Component’in metriklerinin nasıl kimlik doğruladığını belirten ek açıklaması, bir örneğin metriklerinin kimlik bilgisi gerektirdiğini söyleyen provides anahtarını bildirip bildirmediğiyle uyuşmuyor)
Nasıl düzeltilir: ikisinden hangisi yanlışsa onu düzeltin — metrikler kimlik bilgisi alıyorsa metrics_credential_required anahtarını provides sütununda bildirin ve her Recipe’den yayımlayın; almıyorsa kaldırın; ya da ek açıklamayı ürünü tanımlayan değere değiştirin. Plugin sınırları kuralının devre dışı bırakma ayarı taşımamasıyla aynı nedenle bunun da devre dışı bırakma ayarı yoktur; hangi değerleri okuduğu ve hangi Components’i okumadan bıraktığı aggrega-lint.md içinde “The discipline rules” altında yer alır.
Bir bağlantı ile ulaştığı hedef tek bir anahtarı adlandırmıyor
Bir Release yayımlama uzlaşımlarına göre denetlendiğinde yükseltilen bir uyarı; hiçbir şeyi durdurmaz ve bir derleme bunu yükseltmez. Anahtar denetleyen bir sunucu, doğruladığı anahtarı kendine ait bir yuvada tutar; bir çağıran ise anahtarı, o sunucuya ulaştığı bağlantıda sunar. Hiçbir uç diğerininkini görmez; bu yüzden ikisi yalnızca yazarları her iki uçta aynı konum belirleyiciyi yazdığı için tek bir anahtardır. Bu koşul, hedefinin çağıranlarından istediği anahtar için yuva bildirdiği ancak ikisinin tek anahtar olmadığı bir bağlantıyı bildirir: bağlantı bir kimlik bilgisi taşır ve hedefin anahtar yuvası boştur, hedefin anahtar yuvası doludur ve bağlantı kimlik bilgisi taşımaz ya da ikisi de doludur ve konum belirleyicilerini farklı yazarlar.
Üstündeki kurallardan farklı olarak bu kural tek bir varlığı değil bütün bir Release’i okur; bu nedenle yalnızca bir Release denetlendiğinde karşılaşılır, tek bir varlığı kendi başına denetleyen yayımlama kapısında hiç karşılaşılmaz; nerede bildirilirse bildirilsin bir öneridir. Bulgu bileşeni, bağlantıyı, hedefi ve iki yuvayı adlandırır, hiçbir konum belirleyiciyi aktarmaz. Bir kazıma — scrape_target soketindeki bir bağlantı — hedefinin metrikleri hakkında belirttiğine göre değerlendirilir: hedefin observability.aggrega.ai/metrics-credential ek açıklaması none diyorsa hiç değerlendirilmez, separate-token diyorsa hiçbir zaman hedefin anahtarına göre değerlendirilmez, aksi hâlde diğer her bağlantı gibi değerlendirilir; başka herhangi bir soketteki bağlantı, hedef ne belirtirse belirtsin değerlendirilir.
İletisi şöyle başlar:
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 (bir bağlantı ile ulaştığı hedef tek bir anahtarı adlandırmıyor: onun için farklı konum belirleyiciler yazıyorlar ya da yalnızca biri bir anahtar adlandırıyor)
Nasıl düzeltilir: her iki ucun tek bir parametreyi okumasını sağlayın — bağlantının credential alanı ve hedefin api_key alanı — böylece çağıranın sunduğu anahtar ile sunucunun doğruladığı anahtar farklı yazılamaz; ya da bir bağlantının anahtar sunmaması amaçlanıyorsa kimlik bilgisini ondan kaldırın. Hangi yuvaların okunduğu, neyin karşılaştırıldığı ve devre dışı bırakma seçeneği aggrega-lint.md içinde “The discipline rules” altında yer alır.
Yayımlanan değişiklik, evrim ölçütünün izin verdiğini bozuyor
Bir derlemede değil, yayımlamadan önceki denetimde verilen bir ret. Yayımlanan sürüm, ondan önce zaten yayımlanmış sürümle karşılaştırılır ve aralarındaki fark belgelenmiş bir ölçüte göre sınıflandırılır. Bu koşul, farkın ölçütün itiraz ettiği bir fark olduğunu bildirir.
Karşılaştırma için yayımlanmış bir önceki sürüme ihtiyaç duyar; bu nedenle bu kural ve aşağıdaki sürüm artırma denetimi, bu grupta yalnızca yerel içerik üzerinde çalışamayan iki kuraldır: hiçbir kayıt defterine başvurulmadığında karşılaştırılacak bir şey yoktur ve denetim geçilmiş sayılmaz, atlanır.
İletisi şöyle başlar:
the version being published changes the published predecessor in a way the documented evolution rubric objects to (yayımlanan sürüm, yayımlanmış önceki sürümü belgelenmiş evrim ölçütünün itiraz ettiği bir biçimde değiştiriyor)
Nasıl düzeltilir: tanılamadaki, ölçütün değişikliğin neyine itiraz ettiğini adlandıran sınıflandırmayı okuyun ve ya değişikliği uyumlu hâle getirin ya da onu kabul eden bir sürümle yayımlayın. Ölçüt, aggrega-lint.md içinde “The version-bump rubric” altında açıklanır.
Sunulan sürüm artışı, değişikliğin gerektirdiğinden küçük
Bir derlemede değil, yayımlamadan önceki denetimde verilen bir ret. Yayımlanan değişiklik evrim ölçütüne göre sınıflandırılır ve onun için sunulan sürüm, bu sınıflandırmanın gerektirdiğinden daha küçük bir adımdır — örneğin bir yama olarak sunulan bir kaldırma ya da daraltma. Gereğinden büyük artış her zaman kabul edilir; burada durduran, gereğinden küçük artıştır.
Üstündeki kurallardan farklı olarak bu kurala uzlaşımlar plugin’i değil, burası karar verir. Hangi artışın sunulduğu yalnızca yayımlama anında bilinir ve o sırada hiçbir derleme çalışmaz; bu nedenle sınıflandırma ile sunulan sürüm arasındaki karşılaştırma o noktada yapılır.
İletisi şöyle başlar:
the version bump being published is smaller than the evolution check’s classification of the change requires (yayımlanan sürüm artışı, evrim denetiminin değişiklik için yaptığı sınıflandırmanın gerektirdiğinden küçük)
Nasıl düzeltilir: sınıflandırmanın gerektirdiği sürümle yayımlayın; tanılama bunun hangisi olduğunu adlandırır. Değişikliğin sınıflandırıldığından küçük olduğuna inanıyorsanız, aggrega-lint.md içinde “The version-bump rubric” altındaki ölçüt, bir değişikliği her sınıfa neyin yerleştirdiğini söyler. Bir varlığın ilk yayımlanmasının önceki sürümü yoktur; bu nedenle karşılaştırma atlanır ve geçilmiş değil, yapılmamış olarak bildirilir.
Bir içe aktarma, bir kaynağı çevirirken yarıda durdu
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürürken verilen bir ret. İçe aktarıcı, çeviriyi durduracak kadar ciddi bir tanılama bildirdi; bu yüzden ürettiği şey kısmidir: kaynağın bir kısmı taslak yazım dosyalarına dönüştü, bir kısmı dönüşmedi.
Kısmi sonuç bir enkaz değil, bilinçli bir sonuçtur. Nedeni değil sonucu adlandırır — çevrilemeyen şey, yanındaki tanılamalarda, içe aktarıcının aktaramadığı her yapı için bir tane olmak üzere, içe aktarıcının kendi sözcükleriyle bildirilir. Bu koşul, çağıranın “içe aktarma durdu ve bir yanıtın bir kısmını üretti” durumunu “içe aktarma tamamen başarısız oldu” durumundan ayırt etmesini sağlar; bunlar farklı sonraki adımları olan farklı durumlardır.
İletisi şöyle başlar:
the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (içe aktarıcı içe aktarmayı durduran bir tanılama bildirdi, bu yüzden kaynak tamamen taslak yazım dosyalarına dönüştürülmedi)
Nasıl düzeltilir: yanında bildirilen tanılamaları okuyun — her biri kaynakta içe aktarıcının çeviremediği bir yapıyı adlandırır. Düzeltme, verdiğiniz kaynaktadır ya da taslağı elle tamamlamaktır: bir içe aktarma düzenlenecek bir başlangıç noktası üretir; bu nedenle çeviriden sağ çıkmayan bir yapı, doğrudan Aggrega tarafında yazılacak bir yapıdır. aggrega-import.md, komutun ne ürettiğini ve nereye yazdığını açıklar.
Kaynağı birden fazla içe aktarıcı tanıyor
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. İçe aktarma hiçbir biçim belirtmedi; bu nedenle biçim, içe aktarıcıların bildirdiği imzalardan tanındı — çalışma alanının kataloğundakiler de derleyicinin çekirdek içe aktarıcıları da; her biri bir kaynağın okunduğu sözdizimini, uygulandığı dosya adlarını ve ayrıştırılmış ağacının taşıması gereken ya da taşımaması gereken yolları belirtir — ve birden fazla biçime hizmet eden içe aktarıcıların imzaları kaynakla eşleşti. İçe aktarma bunlar arasında seçim yapmaz: bir kaynağın hangi biçimde olduğu derleyicinin değil içe aktarıcıların beyanıdır ve seçim yapmak, kaynağı ona ait olmayabilecek bir içe aktarıcıya veren bir tahmin olurdu.
Bu, tek bir biçimin birden fazla içe aktarıcı tarafından duyurulmasıyla aynı şey değildir; o durum yukarıda “A parse or import format is advertised by more than one plugin” altında anlatılır. Orada biçim bellidir ve ona hizmet eden içe aktarıcılar yarışır, bu nedenle aralarından bir plugins.importer girdisi seçer; burada ise biçimlerin kendileri farklıdır, bu nedenle durumu hiçbir ekleme çözmez, biçimi belirtmek çözer. Bir kaynağı tanıyan içe aktarıcı onu duyurduğu her biçim olarak tanır; bu nedenle birden fazla biçim duyuran ve imzalarından biri eşleşen bir içe aktarıcı da burada reddedilir.
İletisi şöyle başlar:
more than one importer recognises the source (kaynağı birden fazla içe aktarıcı tanıyor)
İletinin geri kalanı kaynağı ve onun tanındığı her biçimi, içe aktarıcıların kimlik ve sürümlerinin sırasıyla adlandırır, ardından çözümü verir:
more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (kaynağı birden fazla içe aktarıcı tanıyor (kaynak, şu biçimler olarak tanındı). Hangisi olarak okunacağını belirtmek için —format verin)
Nasıl düzeltilir: biçimi belirtin — aggrega import üzerinde --format ya da asistanın içe aktarma aracında ve oturumun aggrega/import yönteminde format. İçe aktarıcılardan biri böyle bir kaynağı hiç tanımamalıysa, değişiklik o içe aktarıcının imzalarında yapılır; bunları yazarı describe() öz raporunda bildirir ve Plugin varlığı oluşturulduğunda kaydeder; ya da çalışma alanının kataloğunda bulunan bir içe aktarıcıysa onu çalışma alanının okuduğu katalogun dışında bırakın — bir çekirdek içe aktarıcı her zaman denenenler arasındadır, bu nedenle bunlardan birinin başka bir içe aktarıcıyla birlikte tanıdığı bir kaynak biçimi belirterek çözülür. aggrega-import.md bir biçimin nasıl tanındığını açıklar.
Kaynağı hiçbir içe aktarıcı tanımıyor
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. İçe aktarma hiçbir biçim belirtmedi; bu nedenle biçim, içe aktarıcıların bildirdiği imzalardan tanındı — çalışma alanının kataloğundakiler de derleyicinin çekirdek içe aktarıcıları da — ve hiçbir biçimin imzaları kaynakla eşleşmedi. İçe aktarma tahmin yürütmez: kaynağı, o şekli okuduğunu hiç bildirmemiş bir içe aktarıcıya vermek, ona ait olmayabilecek bir kaynaktan taslak üretirdi.
Bu, yukarıdaki “More than one importer recognises the source (Kaynağı birden fazla içe aktarıcı tanıyor)” durumunun karşılığıdır. Orada kaynağı birkaç biçim sahiplenir; burada hiçbiri sahiplenmez. İkisinde de biçimi belirtmek durumu çözer ve biçim belirtilene kadar hiçbir şey yazılmaz.
İletisi şöyle başlar:
no importer recognises the source (kaynağı hiçbir içe aktarıcı tanımıyor)
İletinin geri kalanı kaynağı adlandırır, ardından çözümü ve katalogdaki içe aktarıcıların duyurduğu her biçimi okundukları sırayla verir:
no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (kaynağı hiçbir içe aktarıcı tanımıyor. Biçimi açıkça belirtmek için —format verin)
Hiçbir içe aktarıcı herhangi bir biçim duyurmuyorsa, çözüm örneklerin yerine bunu belirtir.
Bir dizine farklı bir çözüm önerilir, çünkü herhangi bir biçimi belirtmek ona yardımcı olamaz. Bir dizin yalnızca içe aktarıcısının bildirdiği dosya kalıpları aracılığıyla okunur ve hiçbir dosya kalıbı bildirmeyen bir imza, bir dizinin hiçbir dosyasına uygulanmaz — bu nedenle örneğin tek bir Langflow dışa aktarımı içeren bir dizin hiçbir imza tarafından tanınmaz ve langflow biçimini belirtmek de bu kez An importer that declares no file patterns is handed a directory (Dosya kalıbı bildirmeyen bir içe aktarıcıya bir dizin verilir) kapsamında reddedilir. Bu yüzden bir dizinin reddi onu bir dizin olarak adlandırır ve dosyalarından birini tek başına içe aktarmayı ya da içe aktarıcısı dosya kalıpları bildiren bir biçimi belirtmeyi önerir — yalnızca bu biçimleri, içe aktarıcıların kendi bildirimlerinden okuyarak:
no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (hiçbir içe aktarıcı kaynağı tanımıyor (dizin). Dizinin dosyalarından birini tek başına içe aktarın ya da içe aktarıcısı bir dizini bildirdiği dosya kalıpları aracılığıyla okuyan bir biçimi belirterek —format geçirin (örneğin —format veya —format))
Hiçbir içe aktarıcı bir dosya kalıbı bildirmediğinde ret, dizinin dosyalarından birini tek başına içe aktarmayı önerir ve katalogdaki hiçbir içe aktarıcının, bir dizinin okunmasını sağlayan dosya kalıplarını bildirmediğini söyler.
Nasıl düzeltilir: biçimi belirtin — aggrega import üzerinde --format ya da asistanın içe aktarma aracında ve oturumun aggrega/import yönteminde format; bunların her biri reddi aldığı alana göre ifade eder ve bu durumun kısa koduyla başlatır; oturumun yanıtı ayrıca durumun her iki kodunu da verisinde taşır. Bir dizin için, kastettiğiniz tek dosyayı tek başına içe aktarın — hiçbir dosya adlandırmayan bir imza, adı ne olursa olsun tek başına içe aktarılan bir dosyaya uygulanır — ya da reddin listelediği biçimlerden birini belirtin. Kaynağın tanınması gerekiyorduysa, değişiklik onun biçimine hizmet eden içe aktarıcının imzalarında yapılır; bunları yazarı describe() öz raporunda bildirir ve Plugin varlığı oluşturulduğunda kaydeder. aggrega-import.md bir biçimin nasıl tanındığını açıklar.
Dosya kalıbı bildirmeyen bir içe aktarıcıya bir dizin veriliyor
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. Belirtilen kaynak bir dizindir ve bir dizin, içe aktarıcısına tam olarak içe aktarıcının bildirdiği dosya kalıplarının seçtiği dosyalar olarak verilir — bu nedenle bir içe aktarıcının bir dizinin hangi dosyalarını okuduğu, içe aktarıcının kendi beyanıdır. Kaynağın biçimine hizmet eden içe aktarıcı hiçbir dosya kalıbı bildirmiyor: tek bir dosya okur ve bir dizinin hangi dosyalarının kendisine ait olduğu hakkında hiçbir şey söylemez.
Hiçbir şey açılmaz. İçe aktarma, içe aktarıcıya dizindeki her dosyayı vermek yerine, içe aktarıcı çözümlendikten sonra ve dizinin herhangi bir dosyası okunmadan önce durur.
İletisi şöyle başlar:
the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (kaynağın biçimine hizmet eden içe aktarıcı hiçbir dosya kalıbı bildirmiyor, bu nedenle tek bir dosya okur ve bir dizin okuyamaz)
İletinin geri kalanı biçimi, içe aktarıcıyı ve dizini sizin belirttiğiniz biçimde adlandırır, ardından çözümü verir:
the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (kaynağın biçimine hizmet eden içe aktarıcı hiçbir dosya kalıbı bildirmiyor, bu nedenle tek bir dosya okur ve bir dizin okuyamaz (biçim, içe aktarıcı, dizin). Bunun yerine dizindeki dosyalardan birini tek başına içe aktarın; içe aktarıcı, dosyalarının adlandırıldığı dosya kalıplarını bildirdiğinde bir dizini okur)
Nasıl düzeltilir: o biçimdeki bir dosyayı tek başına içe aktarın. Bir içe aktarıcının kendi biçimindeki dizinleri okuyabilmesi için yazarı, dosyalarının adlandırıldığı kalıpları bildirir — describe() öz raporundaki bir tanıma imzasının files alanı; Plugin varlığı oluşturulduğunda bunu kaydeder. aggrega-import.md bir dizinin içe aktarılmasında neyin okunduğunu açıklar.
Dizindeki hiçbir dosya içe aktarıcının dosya kalıplarıyla eşleşmiyor
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. Belirtilen kaynak bir dizindir, biçim bellidir ve ona hizmet eden içe aktarıcı dosya kalıpları bildirir — ancak dizinin herhangi bir derinlikte barındırdığı hiçbir dosya bunlardan biriyle eşleşmez. İçe aktarıcıya hiç kaynak vermemek, onun boş bir kaynakta, hangi dosyaların okunduğu hakkında değil içerik hakkında sözlerle başarısız olmasına yol açardı; bu nedenle içe aktarma hiçbir şey okunmadan burada durur.
Biçim belirtilmek yerine tanındıysa, imzası dizini tanıyan içe aktarıcı dizindeki dosyalardan biriyle eşleşmiştir; bu nedenle bu durumla yalnızca çalışan içe aktarıcı o içe aktarıcı olmadığında karşılaşılır — bir plugins.importer girdisinin seçtiği aynı biçimdeki başka bir içe aktarıcı ya da onun başka bir sürümü.
İletisi şöyle başlar:
no file in the directory matches the file patterns the importer serving the source’s format declares (dizindeki hiçbir dosya, kaynağın biçimine hizmet eden içe aktarıcının bildirdiği dosya kalıplarıyla eşleşmiyor)
İletinin geri kalanı biçimi, içe aktarıcıyı, dizini sizin belirttiğiniz biçimde ve içe aktarıcının bildirdiği her kalıbı adlandırır, ardından çözümü verir:
no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (dizindeki hiçbir dosya, kaynağın biçimine hizmet eden içe aktarıcının bildirdiği dosya kalıplarıyla eşleşmiyor (biçim, içe aktarıcı, dizin, dosya kalıpları). Bu kalıplardan birinin eşleştiği bir dosyayı barındıran bir dizini ya da kalıpları bu dizindeki dosyalarla eşleşen bir içe aktarıcının biçimini belirtin)
Nasıl düzeltilir: o biçimdeki dosyaları barındıran dizini içe aktarın — bir kalıp, dizin içindeki bir dosya yolunun sonuyla eşleştirilir, bu nedenle herhangi bir derinlikteki dosya sayılır — ya da dizindeki dosyaların biçimini belirtin. aggrega-import.md bir dizinin içe aktarılmasında neyin okunduğunu açıklar.
A file read from the directory and a file named in the importer’s with.sources have the same name (Dizinden okunan bir dosya ile içe aktarıcının with.sources alanında adlandırılan bir dosya aynı ada sahip)
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. Adlandırılan kaynak bir dizindir ve dizinin dosyaları içe aktarıcıya, her biri dizin içindeki yolu altında olmak üzere adlandırılmış kaynaklar olarak ulaşır. İçe aktarıcıyı ekleyen plugins.importer girdisi with.sources altında kendi dosyalarını adlandırır; bunlar da içe aktarıcıya, her biri temel adı altında olmak üzere adlandırılmış kaynaklar olarak ulaşır ve tek bir ad her ikisinde de bulunur. Bir içe aktarıcı kaynakları birbirinden adlarıyla ayırt eder; bu yüzden ikisini birden vermek, hangisinin hangisini gölgelediğini söyleyecek hiçbir şey olmadan birinin ötekini gölgelemesine yol açardı. Bunun yerine içe aktarma, hiçbir şey teslim edilmeden durur.
İletisi şöyle başlar:
a file read from the directory and a file named in the importer’s with.sources have the same name
İletinin geri kalanı, adı ve with.sources dosyasını, ardından çözümü belirtir:
a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources
Nasıl düzeltilir: iki dosyadan birini yeniden adlandırın ya da dizin dosyayı zaten içeriyorsa dosyayı girdinin with.sources alanından çıkarın. Bir with.sources dosyası temel adını korur; bu yüzden karşılaştığı dosya, dizinin en üst düzeyindeki aynı adlı dosyadır; alttaki bir dizinde bulunan dosya ise o dizini adında taşır. Bir kaynağı hangi içe aktarıcı taslaklara dönüştürür, bir girdinin with.sources alanını açıklar.
An import’s target names a capability no Recipe in the catalog binds to (Bir içe aktarmanın hedefi, katalogdaki hiçbir Recipe’in bağlanmadığı bir yeteneği adlandırıyor)
Bir derlemede değil, yabancı bir kaynak tanımını taslak yazım dosyalarına dönüştürmede verilen bir ret. İçe aktarmaya bir hedef verilmiştir (aggrega import üzerinde --target ya da asistanın içe aktarma aracında ve oturumun aggrega/import yönteminde target); böylece taslağı çıkarılan her bileşen türünü o sağlayıcının bir Recipe’ine eşleyen bir Manifest taslağı oluşturur. Hedef bir sağlayıcı yeteneğidir ve çalışma alanının kataloğundaki her Recipe’in bağlandığı spec.capability ile karşılaştırılır; oradaki hiçbir Recipe verilen yeteneğe bağlanmaz. Bunun için taslağı çıkarılan bir Manifest hiçbir şey eşlemezdi ve asıl yanlış olan seçeneğin kendisiyken (çoğunlukla bir yazım hatası) her bileşen türü katalogda eksik görünürdü.
Hiçbir şey çalışmaz ve hiçbir şey yazılmaz. İçe aktarma, katalog yüklendiğinde, kaynağın biçimi tanınmadan ve içe aktarıcı çalışmadan önce durur; bu nedenle deneme çalıştırmasında da hiçbir taslak üretilmez ve hiçbir dosya yazılmaz.
İletisi şöyle başlar:
no Recipe in the workspace’s catalog binds to the capability the import’s target names
İletinin geri kalanı, hedefi tam verildiği gibi ve kataloğun Recipes’inin gerçekten bağlandığı yetenekleri her birini bir kez ve sıralı olarak, ardından çözümü belirtir:
no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written
Katalog hiç Recipe içermiyorsa ileti listenin yerine bunu belirtir ve çözüm, kataloğa sağlayıcının bir Recipe’ini eklemektir.
Nasıl düzeltilir: iletinin listelediği yeteneklerden birini adlandırın (örneğin bir Recipe’in spec.capability alanının yazdığı biçimde compose ya da helm) veya hedefi çıkarın; bu durumda Manifest taslağı oluşturulmaz. Kastettiğiniz sağlayıcı için katalogda henüz Recipe yoksa önce onun Recipes’ini çalışma alanının okuduğu bir katalog klasörüne ekleyin. aggrega-import.md, hedef verilen bir içe aktarmanın neyin taslağını oluşturduğunu açıklar.
Bir alt Release, üst öğesinin yazdığı yere çözümlenen bir sınır dizinini devralıyor
Bir uyarı. Bir Release başka birini genişletir ve ondan bir sınırın çıktı dizinini devralır; bu dizin hiçbir şablon değişkeni taşımaz, bu yüzden ikisi için de aynı yola çözümlenir ve alt öğeyi derlemek, üst öğeyi derlemenin yazdığı yere yazar.
Dizini devralmak bir hata değil, desteklenen biçimdir. Dizin bir şablondur; bu nedenle üst öğe onu bir kez yazar ve bir parametreyi karşılayan alt öğe, hiçbir şey yinelenmeden onu başka bir yere çözümler; bir alt öğenin üst öğesinin sınır topolojisini yeniden belirtmesine gerek olmamasının tüm nedeni budur. Dar ve gerçek olan, bunun adlandırdığı geriye kalan durumdur: içinde hiçbir değişken olmadığında farklı biçimde çözümlenecek hiçbir şey kalmaz.
Derlemeyi durduramaz ve bu, kural hakkında bir temkin değil, kuralın bir özelliğidir. Aynı çözümlenmiş yola yazmak, bir yazarın meşru olarak kastedebileceği bir şeydir (çıktılarını karşılaştırmak için yalnızca işleyen Recipes’i değiştiren ya da yalnızca boyutlandırmayı değiştiren bir alt öğe); bu yüzden çıkarıma dayanarak derlemeyi durduran bir kural, geçerli girdiyi bir tahmine dayanarak reddederdi.
İletisi şöyle başlar:
inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to
Nasıl düzeltilir: ikisinin farklı yerlere yazması amaçlanmışsa dizine bir parametre başvurusu koyun ve her Release’in onu karşılamasını sağlayın. Tek bir yola yazmak kastettiğiniz şeyse hiçbir şeyin değişmesi gerekmez: uyarı size ne yapacağını söylemiştir ve derleme her durumda çıktısını üretir.
Derlemenin yazdırdığı kısa koddan bir durmayı bulma
Durduran bir tanılamanın köşeli parantez içindeki başlığı, hatanın ilişkilendirildiği kategoriyi ve hata burada kataloglanan koşullardan birini adlandırıyorsa o koşulun kısa kodunu belirtir: [CATALOG_ERROR E0209] örneğinde olduğu gibi E harfi ve dört rakam. Bir numara bir kez verilir ve sonra sabit kalır; böylece bir rapora ya da aramaya yapıştırdığınız kısa kod, onu kaydettiğiniz sırada adlandırdığı koşulu adlandırmaya devam eder. Bir koşulun taşıdığı diğer iki tanımlayıcı ve üçünden hangisine ne zaman başvurulacağı sentinels.md sayfasında anlatılır.
Koşulun kendi ileti satırı, koşulu belirten sabit bir cümleyle başlar. Bu cümleden sonraki her şey oluşuma göre değişir: hatalı belge, yazılan anahtar, sorunlu değer ve o oluşuma yönelik öneri. Yukarıdaki girdiler, her biri belgelediği koşul için iletinin tüm biçimini aktarır. Sabit cümle her seferinde aynı kalan kısımdır; eşleştirme için kullanılacak kısım olmasını sağlayan da budur.
Aşağıdaki tablo, bu sayfayla sınırlı olarak ikisini eşleştirir: burada kataloglanan her koşul için, bir derlemenin yazdırdığı kısa kod ve ileti satırının başladığı cümle, yazım düzeltmesini açıklayan yukarıdaki girdinin karşısında yer alır. Girdi başlıkları tam olarak aktarılır; böylece bu sayfada biri arandığında kendi girdisine ulaşılır. Her koşulun tablosu, burada hiçbir girdinin kapsamadıkları da dahil olmak üzere, derleyicinin bildirdiği her koşul için bir kısa kodu çözümler.
Bir girdi iki kısa kodun karşısında yer aldığında, iki ayrı koşulu kapsar ve her biri kendi cümlesini kaydeder; bir derlemenin hangisini bildirdiğini anlamak için ortak başlığa değil cümlelere bakın.
aggrega explain <code> bu aramayı sizin için terminalde yapar: koşulun kodlarından herhangi birini alır ve koşulu, onu belgeleyen yukarıdaki girdiyle birlikte yazdırır. aggrega explain sayfasında açıklanmıştır.
Kısa kod
Başladığı cümle
Belgelendiği yer
E0001
cliplugin: no plugin resolver configured
Bir komut satırı eklenti çalıştırıcısı, eklentileri bulmanın bir yolu olmadan oluşturulmuş
annotation contribution overridden by an explicit value
Açık bir değer, bir ek açıklamanın sağladığı değerin yerini aldı
E0005
policy violation
A governance plugin rejected the build (Bir yönetişim eklentisi derlemeyi reddetti)
E0006
required attachment slot unfilled
Required attachment slot not bound (Zorunlu ek yuvası bağlanmamış)
E0007
selector violation
Cross-node type safety violation via selector: (selector: üzerinden düğümler arası tür güvenliği ihlali)
E0008
attachment slot selector unsatisfied
The Feature filling an attachment slot does not satisfy the slot’s selector (Bir ek yuvasını dolduran Feature, yuvanın seçicisini karşılamıyor)
E0009
pipeline step typed-I/O contract violation
Bir pipeline adımının tipli girdisi ya da çıktısı bildirilmiş sözleşmesini karşılamıyor
E0010
pipeline step failed
Bir pipeline adımı başarısız oldu
E0011
pipeline patch targets a document not present in the set
Bir pipeline yaması, kümenin içermediği ya da adreslenecek ağacı olmayan bir belgeyi adresliyor
E0012
pipeline patch targets an opaque (non-structured) unit
Bir pipeline yaması, kümenin içermediği ya da adreslenecek ağacı olmayan bir belgeyi adresliyor
E0013
feature type mismatch between Aggregate and Release
Feature type mismatch between Aggregate and Release (Aggregate ile Release arasında Feature türü uyuşmazlığı)
E0014
inject entry carries both `value:` and `from:`; schema requires exactly one
Bir inject: girdisi hem bir değişmez değer hem de bir kaynak anahtar taşıyor
E0015
uses-edge inject dictates a delivery mechanism the socket does not permit
uses edge dictates delivery on a socket that allowlists none (Kenar, izin listesinde hiçbir şey olmayan bir sokette teslimatı dayatıyor); uses edge dictates a delivery mechanism outside the socket’s allowlist (Kenar, soketin izin listesi dışında bir teslim mekanizması dayatıyor)
E0016
jsonpatch: test operation failed
A patch’s test operation did not match the document (Bir yamanın test işlemi belgeyle eşleşmedi)
E0017
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
An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Bir annotation-transform eklentisi kendisine verilmemiş bir bileşeni adlandırıyor veya hiçbir annotation’ın kabul etmediği bir değer enjekte ediyor)
E0018
policy attachment settings do not satisfy the plugin's declared settings schema
A governance attachment’s settings do not match the plugin’s declared schema (Bir yönetişim eklemesinin ayarları eklentinin bildirdiği şemayla eşleşmiyor)
E0019
endpoint requires form: reference
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
E0020
schedule is not a valid cron expression
A workload schedule: is not an expression the check accepts (Bir workload schedule değeri denetimin kabul ettiği bir ifade değil)
E0021
persistentTemplate volume requires form: stateful
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
E0022
pipeline PATCH target is not parseable structured YAML/JSON
Bir pipeline adımı, düğümde bulunmayan belgeleri adresliyor
E0023
form: reference requires an endpoint
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
E0024
schedule requires form: scheduled
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
E0025
form: scheduled requires a schedule
A workload: form and the fields beside it do not agree (Bir workload formu ile yanındaki alanlar uyuşmuyor)
E0026
imported artifact content does not match the digest recorded for it in entity.lock
An imported artifact no longer matches the digest recorded beside its Recipe (İçe aktarılan bir yapıt, Recipe’inin yanında kaydedilen özetle artık eşleşmiyor)
E0027
artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)
A library $import: is not written in the bare-name form (Bir kütüphane içe aktarımı yalın ad biçiminde yazılmamış)
E0028
artifacts output filename collision: two artifact outputs carry the same filename
Bir Recipe’in iki artifact çıktısı aynı dosya adını taşıyor
E0029
artifact template references a pillar the Recipe does not declare
An artifacts: template reads a pillar the Recipe does not declare (Bir artifacts: şablonu, Recipe’nin bildirmediği bir sütunu okuyor)
E0030
artifact-library import references a bundle not present in the ArtifactLibrary
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0031
artifact-library import references an ArtifactLibrary not present in the catalog
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0032
assembled output collision: two contributors write the same output path
Two contributors write the same output path (İki katkıda bulunan aynı çıktı yoluna yazıyor)
E0033
assertion failed
An assertion stopped the build (Bir doğrulama derlemeyi durdurdu)
E0034
duplicate delivery key across attachment-inject and another inject source
An attachment delivers a key another inject source already claimed (Bir ek, başka bir inject kaynağının zaten sahiplendiği bir anahtarı iletiyor)
E0035
provider expected to assemble its dispatch group provides no boundary assembler
The plugin serving a provider cannot assemble what that provider combines (Bir sağlayıcıya hizmet eden eklenti, o sağlayıcının birleştirdiğini derleyemiyor)
E0036
merged-path assembly has conflicting assembly-name annotation values
Birleştirilmiş bir helm-chart şemsiyesinde chart adı uyuşmazlığı
E0037
cross-boundary link between endpoints rendered by different providers is not supported
Bir bağlantı, iki farklı sağlayıcının birleştirilmiş çıktıları arasında geçiyor
E0038
derived name collision: one name is derived more than once in one key space
The same name is derived more than once inside the output (Aynı ad çıktı içinde birden fazla kez türetiliyor)
E0039
FeatureRecipe template references a per-component-only field with executionScope: boundary
FeatureRecipe şablonu, kapsamının izin listesi dışındaki bir alana başvuruyor
E0040
library $import: carries a registry host; reference the library by bare-name identity
Bir kütüphane $import: ifadesi, kütüphanesini kayıt defteri konumuyla adresliyor
E0041
multiple contributors share an instance ID at the same dispatch path
Instance-ID collision across boundaries assembling to the same path (Aynı yola birleştirilen sınırlar arasında örnek kimliği çakışması)
E0042
locals entry references a sibling defined later in the same block
locals: girdisi aynı blokta daha sonra tanımlanan bir kardeşe başvuruyor
E0043
template references a key the locals block does not declare
locals: anahtarı mevcut değil
E0044
mapping-library import references an entry not present in the MappingLibrary
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0045
valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)
A library $import: is not written in the bare-name form (Bir kütüphane içe aktarımı yalın ad biçiminde yazılmamış)
E0046
mapping-library import references a MappingLibrary not present in the catalog
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0047
assembled output retains an unresolved cross-boundary link placeholder
Assembled output still carries a cross-boundary placeholder (Birleştirilmiş çıktı hâlâ sınırlar arası bir yer tutucu taşıyor)
E0048
dispatch path produced multiple provider outputs
Path collision: two contributors emit at incompatible paths (Yol çakışması: iki katkıda bulunan uyumsuz yollara üretiyor)
E0049
path template references a field not in the documented allowlist
Path-template references a variable outside the allowlist (Yol şablonu izin listesi dışındaki bir değişkene başvuruyor)
E0050
pipeline /host operation from a step with no host component
Bir pipeline adımı, düğümde bulunmayan belgeleri adresliyor
E0051
pipeline PATCH targets an assembler provider's pre-assembly fragments
Bir pipeline yaması henüz birleştirilmemiş çıktıyı adresliyor
E0052
pipeline PATCH targets a document the node did not emit
Bir pipeline adımı, düğümde bulunmayan belgeleri adresliyor
E0053
pipeline plugin is not compatible with the rendering provider
Bir pipeline adımının plugin’i, adreslediği şeyi işleyen sağlayıcıyı sahiplenmiyor
E0054
provider rejected node input
A provider refused a node’s input (Bir provider bir düğümün girdisini reddetti)
E0055
Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares
A Recipe or FeatureRecipe does not publish a provides key its contract declares (Bir Recipe veya FeatureRecipe, sözleşmesinin bildirdiği bir anahtarı yayımlamıyor)
E0056
provides template evaluation failed
A provides: template could not be evaluated (Bir şablon değerlendirilemedi)
E0057
provides block references a root outside the self-contained set
provides: şablonu kendi kendine yeterli olmayan bir köke başvuruyor
E0058
provider render is not deterministic
A provider rendered the same input twice and produced different output (Bir provider aynı girdiyi iki kez işledi ve farklı çıktı üretti)
E0059
duplicate delivery key across self-inject and uses-inject
Duplicate delivery key across inject sources (Inject kaynakları arasında yinelenen teslim anahtarı)
E0060
template references a root the render context does not define
Template references a root the render context does not define (Şablon, işleme bağlamının tanımlamadığı bir köke başvuruyor); Self-inject value template references cross-node data (Self-inject değer şablonu düğümler arası veriye başvuruyor)
E0061
unknown provider
Unknown provider (Bilinmeyen sağlayıcı)
E0062
custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping
A component declares an inject mechanism the attached Feature maps nothing to (Bir bileşen, eklenmiş Feature’ın hiçbir şey eşlemediği bir inject mekanizması bildiriyor)
E0063
workload-library import references an entry not present in the WorkloadLibrary
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0064
workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)
A library $import: is not written in the bare-name form (Bir kütüphane içe aktarımı yalın ad biçiminde yazılmamış)
E0065
workload-library import references a WorkloadLibrary not present in the catalog
Bir kütüphane $import: ifadesi, kataloğun içermediği bir kütüphaneyi veya girdiyi adlandırıyor
E0066
uses edge target does not exist
Boşta kalan uses hedefi
E0067
active toggle did not resolve to a boolean
Bir active: anahtarı true ya da false olarak çözümlenmiyor
An Aggregate reached graph building without being normalised (Bir Aggregate normalleştirilmeden grafik oluşturmaya ulaştı)
E0076
sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`
Bir alt modülün bileşenleri hiçbir sınıra yerleştirilmemiş
E0077
uses edge target was pruned because its active toggle resolved to false
Bir uses kenarı, bir active: anahtarının kaldırdığı bir bileşeni hedefliyor
E0078
producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call
A plugin asks the host to parse a source while a parse is already running for it (Bir eklenti, kendisi için zaten bir ayrıştırma çalışırken ana bilgisayardan bir kaynağı ayrıştırmasını ister)
E0079
wasm: recorded command mirror does not match plugin describe()
Bir Plugin varlığının kaydedilmiş komut kümesi plugin ile eşleşmiyor
E0080
wasm: entity contract claim does not match plugin describe()
Bir Plugin varlığının iddiaları, plugin’in kendi öz bildirimiyle uyuşmuyor
E0081
wasm: guest plugin returned a diagnostic whose severity the contract does not declare
A plugin returned a diagnostic at a severity that is not declared (Bir plugin, bildirilmemiş bir önem düzeyinde tanılama döndürdü)
E0082
wasm: guest plugin reported an error
A plugin failed while it was running (Bir plugin çalışırken başarısız oldu)
E0083
wasm: guest plugin panicked during call
A plugin failed while it was running (Bir plugin çalışırken başarısız oldu)
E0084
wasm: stamped host-function record does not match .wasm imports
A Plugin entity’s recorded host functions do not match the binary (Bir Plugin varlığının kayıtlı host işlevleri ikili dosyayla eşleşmiyor)
E0085
wasm: plugin rejected by the sandbox
The sandbox refused a plugin (Korumalı alan bir eklentiyi reddetti)
E0086
wasm: plugin invoked proc_exit
A plugin failed while it was running (Bir plugin çalışırken başarısız oldu)
E0087
wasm: declared plugin type does not match plugin describe()
A plugin is not the kind of plugin the socket expects (Eklenti, soketin beklediği türde bir eklenti değil)
E0088
wasm: entity metadata.version does not match plugin describe()
Bir Plugin varlığının kaydedilmiş sürümü plugin ile eşleşmiyor
E0089
every published version this reference could select has been withdrawn
Every version a reference could select has been withdrawn (Bir başvurunun seçebileceği her sürüm geri çekilmiş)
E0090
format is advertised by more than one importer plugin
A parse or import format is advertised by more than one plugin (Bir ayrıştırma ya da içe aktarma biçimi birden fazla plugin tarafından duyuruluyor)
E0091
format is advertised by more than one parser plugin
A parse or import format is advertised by more than one plugin (Bir ayrıştırma ya da içe aktarma biçimi birden fazla plugin tarafından duyuruluyor)
E0092
capability is served by more than one provider plugin; add a plugins.providers entry to select one
A capability is served by more than one provider plugin (Bir yetenek birden fazla sağlayıcı eklentisi tarafından sunuluyor)
E0093
manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous
A Manifest maps two version-distinct keys onto one type (Bir Manifest, sürümü farklı iki anahtarı tek bir türe eşliyor)
E0094
duplicate entity identity within a single catalog directory
Two catalog entities in one directory share an identity (Bir dizindeki iki katalog varlığı aynı kimliği paylaşıyor)
E0095
malformed recipe reference in a Manifest mapping value
Manifest mapping value is not a shape a recipe reference accepts (Manifest eşleme değeri, bir tarif başvurusunun kabul ettiği bir biçimde değil)
E0096
manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key
Recipe implements değeri eşlenen bileşen türüyle eşleşmiyor
E0097
no importer plugin advertises the requested format
No plugin advertises a requested parse or import format (Hiçbir plugin istenen ayrıştırma ya da içe aktarma biçimini duyurmuyor)
E0098
no parser plugin advertises the requested format
No plugin advertises a requested parse or import format (Hiçbir plugin istenen ayrıştırma ya da içe aktarma biçimini duyurmuyor)
E0099
no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type
No Recipe is mapped for a component or feature instance (Bir bileşen veya özellik örneği için hiçbir Recipe eşlenmemiş)
E0100
plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches
A plugins.providers binding names a plugin that does not serve the capability (Bir plugins.providers bağlaması, yeteneğe hizmet etmeyen bir plugin’i adlandırıyor)
E0101
no provider-rendering plugin version satisfies the recipe's provider version pin
No provider plugin version satisfies a Recipe’s provider pin (Hiçbir provider plugin sürümü bir Recipe’nin provider sabitlemesini karşılamıyor)
E0102
wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path
A plugin reference carries a registry host or an artifact path (Bir plugin başvurusu bir kayıt defteri ana bilgisayarı veya bir yapıt yolu içeriyor)
E0103
no catalog version satisfies the referenced version constraint
No catalog version satisfies a version constraint (Hiçbir katalog sürümü sürüm kısıtını karşılamıyor)
E0104
wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location
A plugin or recipe reference carries no scope (Bir plugin veya recipe başvurusu kapsam içermiyor)
E0105
recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location
A plugin or recipe reference carries no scope (Bir plugin veya recipe başvurusu kapsam içermiyor)
E0106
resolve: invalid library reference URI
A library reference is not written in the identity form (Bir kütüphane başvurusu kimlik biçiminde yazılmamış)
E0107
resolve: minimal version selection conflict — incompatible library version requirements
Two consumers of one library require incompatible versions (Bir kütüphanenin iki tüketicisi uyumsuz sürümler gerektiriyor)
The catalog view a build was given cannot load the bodies pinning needs (Bir derlemeye verilen katalog görünümü, sabitlemenin ihtiyaç duyduğu gövdeleri yükleyemiyor)
E0109
resolve: catalog lookup cannot load resolved recipe and plugin bodies
The catalog view a build was given cannot load the bodies pinning needs (Bir derlemeye verilen katalog görünümü, sabitlemenin ihtiyaç duyduğu gövdeleri yükleyemiyor)
E0110
resolve: source-template evaluation failure at lock time
Resolving a source: coordinate registers a narrower function set (Bir koordinatın çözümlenmesi daha dar bir işlev kümesi kaydeder)
E0111
resolve: source-template parse error
Resolving a source: coordinate registers a narrower function set (Bir koordinatın çözümlenmesi daha dar bir işlev kümesi kaydeder)
Resolving a source: coordinate registers a narrower function set (Bir koordinatın çözümlenmesi daha dar bir işlev kümesi kaydeder)
E0113
resolve: sub-aggregate inclusion depth exceeded
The chain of module imports is deeper than the pin walk descends (Modül içe aktarma zinciri, sabitleme dolaşmasının indiği derinlikten daha derin)
E0114
resolve: no entity in the catalog matches this URI
A reference names no entity the catalog holds (Bir başvuru, kataloğun tuttuğu hiçbir varlığı adlandırmıyor)
E0115
compactform: ambiguous dispatch — $mode required
A compact-form schema declares a field literally named type (Kompakt biçimli bir şema, adı tam olarak type olan bir alan bildiriyor)
E0116
compactform: constraint not valid for declared type
A compact-form constraint does not apply to the type it was written on (Kompakt biçimli bir kısıtlama, üzerine yazıldığı türe uygulanmıyor)
E0117
compactform: $jsonschema content invalid
A $jsonschema: escape carries content that is not a schema (Bir $jsonschema: kaçışı şema olmayan içerik taşıyor)
E0118
compactform: cross-document $ref carries a registry host; reference the library by identity
A $ref: addresses a library by registry location (Bir $ref:, bir kitaplığı kayıt defteri konumuyla adresliyor)
E0119
compactform: $ref unresolvable
A $ref: is not written in a form the compiler can resolve (Bir $ref:, derleyicinin çözümleyebileceği bir biçimde yazılmamış)
E0120
compactform: unknown keyword
A compact-form schema uses a keyword the compact form does not know (Kompakt biçimli bir şema, kompakt biçimin tanımadığı bir anahtar sözcük kullanıyor)
E0121
compactform: cross-document $ref target not found
A $ref: is not written in a form the compiler can resolve (Bir $ref:, derleyicinin çözümleyebileceği bir biçimde yazılmamış)
E0122
deprecation: build consumes a deprecated entity
The build consumes an artifact its publisher has deprecated (Derleme, yayıncısının kullanımdan kaldırdığı bir yapıtı tüketiyor)
E0123
docscache: artifact is not a documentation bundle
A resolved artifact is not a documentation bundle (Çözümlenen bir yapıt bir belge paketi değil)
E0124
docscache: page not found in documentation bundle
A page is absent from a documentation bundle (Bir sayfa bir dokümantasyon paketinde yok)
E0125
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
The workspace is offline and the step needs the network (Çalışma alanı çevrimdışı ve adım ağa ihtiyaç duyuyor)
E0126
externalinputs: acquisition is disabled for unpinned inputs
A render requests an external input the lockfile does not pin (Bir işleme, kilit dosyasının sabitlemediği bir dış girdi istiyor)
E0127
externalinputs: fetched bytes mismatch the pinned digest
Fetched bytes do not match a pinned digest (Getirilen baytlar sabitlenmiş bir özetle eşleşmiyor)
E0128
externalinputs: URL scheme is not allowed
An external input’s URL uses a scheme that is not allowed (Bir dış girdinin URL’si izin verilmeyen bir şema kullanıyor)
E0129
externalinputs: store blob mismatches its pinned record
A stored external input no longer matches its record (Saklanan bir dış girdi artık kaydıyla eşleşmiyor)
E0130
lockfile: out of date; it no longer matches what its Release resolves to
The lockfile no longer matches what the release resolves to (Lockfile artık release’in çözümlendiği sonuçla eşleşmiyor)
E0131
lockfile: file failed schema validation
The lockfile does not satisfy its schema (Kilit dosyası şemasını karşılamıyor)
E0132
oci: manifest has multiple layers of the expected content media type
Bir manifest beklenen türde hiçbir katman taşımıyor ya da birden fazla taşıyor
E0133
oci: cached manifest digest mismatch
Getirilen veya önbellekteki baytlar, onlar için taahhüt edilen özetle eşleşmiyor
E0135
oci: content digest mismatch
Getirilen veya önbellekteki baytlar, onlar için taahhüt edilen özetle eşleşmiyor
E0136
oci: network unreachable
The registry could not be reached (Kayıt defterine ulaşılamadı)
E0137
oci: artifact not found at remote source
An artifact is not at the source the build was told to find it (Bir yapıt, derlemeye bulunacağı söylenen kaynakta değil)
E0138
oci: authentication required or failed
The registry will not serve an artifact without credentials it accepts (Kayıt defteri, kabul ettiği kimlik bilgileri olmadan bir yapıtı sunmaz)
E0139
oci: tag already published with different content
Bir etiket farklı içerikle zaten yayımlanmış
E0140
oci: manifest has no layer of the expected content media type
Bir manifest beklenen türde hiçbir katman taşımıyor ya da birden fazla taşıyor
E0141
oci: distinct catalog identities map to the same OCI repository location
İki katalog kimliği tek bir depo konumuna yayımlıyor
E0142
oci: referrer discovery could not be completed
The registry could not answer what is attached to an artifact (Kayıt defteri bir yapıta neyin ekli olduğunu yanıtlayamadı)
E0143
oci: unknown entity kind for mediatype dispatch
Bir varlık türünün artifact medya türü yok
E0144
cached signature bundle does not match its recorded digest
A cached signature bundle does not match the digest recorded for it (Önbellekteki bir imza paketi, kendisi için kaydedilen özetle eşleşmiyor)
E0145
plugin reference is not a Plugin entity
A plugin reference is not a Plugin entity (Bir eklenti başvurusu bir Plugin varlığı değil)
E0146
circular reference expansion
Bir kütüphane başvurusu kendi içine genişliyor
E0147
registrytrust: advertised trust config is malformed
Bir kayıt defteri, güven belgesi olarak okunamayan bir belge sunuyor
E0148
registrytrust: registry advertises no trust config
Bir kayıt defteri güven belgesi yayımlamıyor
E0149
attachment name is a near miss for a declared slot
Bir ek adı, bildirilmiş bir yuvadan tek düzenleme uzaklıkta
E0150
attachment does not conform to its declared slot shape
Attachment does not conform to its declared slot shape (Ek, bildirilen yuva biçimine uymuyor)
E0151
component declared in more than one boundary: declare each component in exactly one boundary
A component is placed in more than one boundary (Bir bileşen birden fazla sınıra yerleştirilmiş)
E0152
duplicate Aggregate/Manifest identity (metadata.name) in the Release directory
The Release directory declares one Aggregate or Manifest twice (Release dizini bir Aggregate’i veya Manifest’i iki kez bildiriyor)
E0153
feature merge conflict: reconcile the Aggregate and Release declarations for the feature
A feature attached by both the Aggregate and the Release cannot be merged (Hem Aggregate hem de Release tarafından eklenen bir özellik birleştirilemiyor)
E0154
the compiler's own views of the catalog disagree
A guard needs a catalog entity the build resolved and cannot see (Bir koruyucu, derlemenin çözümlediği ancak göremediği bir katalog varlığına ihtiyaç duyuyor)
E0155
duplicate delivery key across inject sources
Duplicate delivery key across inject sources (Inject kaynakları arasında yinelenen teslim anahtarı)
E0156
invalid inject key: the from-key must name a provides key its source publishes
Inject from key is not in the target’s provides (Inject from anahtarı hedefin provides alanında yok)
E0158
invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template
A {{ .parameters.* }} reference cannot be interpolated (Bir {{ .parameters.* }} başvurusu enterpole edilemiyor)
E0160
manifest annotation bindings collide on same Feature path+pillar
İki Manifest açıklama bağlaması tek bir yönlendirme yuvası için çakışıyor
E0161
manifest annotation binding uses reserved prefix
A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Bir Manifest açıklama bağlaması ayrılmış aggrega.ai/ önekini sahipleniyor)
E0162
missing required feature: attach a Feature of the required type to the component
Required feature not attached (Gerekli feature eklenmemiş)
E0163
required uses socket not populated
Required uses: socket not populated (Zorunlu uses: soketi doldurulmamış)
E0164
parameter contract violated
Parameter type mismatch / contract violation (Parametre türü uyuşmazlığı / sözleşme ihlali)
E0165
required parameter not supplied
Parameter type mismatch / contract violation (Parametre türü uyuşmazlığı / sözleşme ihlali)
E0167
Recipe publishes a provides key its Component does not declare
Bir Recipe, Component’inin bildirmediği bir provides anahtarı yayımlıyor
E0168
authored pillar does not conform to its declared schema
Authored values or infra do not conform to the declared schema (Yazılan values veya infra bildirilen şemaya uymuyor)
E0169
self-inject on component without spec.inject allowlist
Self-inject on a component without an allowlist (İzin listesi olmayan bir bileşende self-inject); Self-inject mechanism not in the component’s allowlist (Self-inject mekanizması bileşenin izin listesinde yok)
E0170
aggregate/manifest reference unresolvable
A Release’s aggregate: or manifest: reference resolves to nothing (Bir Release’in aggregate: veya manifest: başvurusu hiçbir şeye çözümlenmiyor)
E0171
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
uses: socket not declared in the owning entity’s usesSchema (uses soketi sahip varlığın usesSchema alanında bildirilmemiş)
Bir Release, yükleme yolundan geçmeden çözümlemeye ulaştı
E0173
declared parameter is read by no reference in the Aggregate
Bildirilmiş bir parametreyi hiçbir şey okumuyor
E0174
uses socket name is a near miss for a declared socket
Bir uses: soket adı, bildirilmiş bir soketten tek düzenleme uzaklıkta
E0175
file load failed: the file could not be read, or its bytes did not parse
A file cannot be read, or its bytes do not parse (Bir dosya okunamıyor veya baytları ayrıştırılamıyor)
E0176
signing: keyless signing requires a live identity provider, Fulcio, and Rekor
Anahtarsız imzalama, gerektirdiği hizmetler olmadan istendi
E0177
signing: no signature found for an artifact that requires one
An artifact that must be signed carries no signature (İmzalanması gereken bir yapıt imza taşımıyor)
E0178
signing: keyless verification requires at least one trusted identity
A keyless trust policy names no acceptable signer (Anahtarsız bir güven ilkesi kabul edilebilir hiçbir imzacı belirtmiyor)
E0179
signing: signature does not verify
A detached signature does not verify against the key supplied (Ayrık bir imza, verilen anahtara karşı doğrulanmıyor)
E0180
signing: signature bundle does not verify
A signature does not verify (Bir imza doğrulanmıyor)
E0181
signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content
İmzasız bir yayımlama, imza gerektiren bir kayıt defterini veya ilkeyi hedefliyor
E0182
signing: cannot load pinned trust root
The pinned trust root cannot be read (Sabitlenmiş güven kökü okunamıyor)
E0183
signing: registry requires signatures; refusing to push unsigned content
İmzasız bir yayımlama, imza gerektiren bir kayıt defterini veya ilkeyi hedefliyor
E0184
signing: unsupported held-key type
A pinned verification key is not the key profile the verifier accepts (Sabitlenmiş bir doğrulama anahtarı, doğrulayıcının kabul ettiği anahtar profilinde değil)
E0185
signing: signature identity is not trusted for this registry
A signature verifies but its signer is not one the registry trusts (Bir imza doğrulanıyor ancak imzalayanı kayıt defterinin güvendiği biri değil)
E0186
no source adapter serves the source kind
Bir Recipe’in source: alanı, hiçbir şeyin nasıl edinileceğini bilmediği bir tür belirtiyor
E0187
cacheslot: empty workspaceRoot
A source artifact is cached without a workspace root to anchor it (Bir kaynak yapıtı, onu sabitleyecek bir çalışma alanı kökü olmadan önbelleğe alınıyor)
E0188
artifacts entry: shape must be a string scalar or {$import: <local-path>}
Satır içi ya da içe aktarma alanı iki biçimden hiçbiriyle yazılmamış
E0189
artifactlibrary: entry must be a mapping of filename to a string body
Bir kütüphane girdisinin gövdesi o kütüphanenin tuttuğu biçimde değil
E0190
schemalibrary: forbidden JSON Schema keyword
Bir şema, kütüphanenin kabul etmediği bir JSON Schema anahtar sözcüğü kullanıyor
E0191
mappinglibrary: entry body must be a string scalar
Bir kütüphane girdisinin gövdesi o kütüphanenin tuttuğu biçimde değil
E0192
a document nests too many levels deep
Bir belge, okuyucunun ineceğinden daha derin iç içe geçiyor
E0193
parameters: shape must be an inline object or {$import: <local-path>}
A Release’s parameters: block is written in neither of its two shapes (Bir Release’in parameters: bloğu iki biçiminden hiçbiriyle yazılmamış)
E0194
schemalibrary: template not found
Bir $instantiate: başvurusu çözümlenemiyor
E0195
schemalibrary: template parameter missing
Bir $instantiate: başvurusu çözümlenemiyor
E0196
schemalibrary: template parameter type mismatch
Bir $instantiate: başvurusu çözümlenemiyor
E0197
valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}
Satır içi ya da içe aktarma alanı iki biçimden hiçbiriyle yazılmamış
E0198
wellKnownAnnotations: a key is declared at a scope the provider's contract does not render
Bir provider, iyi bilinen bir ek açıklamayı işlemediği bir kapsamda bildiriyor
E0199
workloadlibrary: entry body must be a string scalar
Bir kütüphane girdisinin gövdesi o kütüphanenin tuttuğu biçimde değil
E0200
workload: shape must be a string scalar or {$import: <path-or-library-identity>}
Satır içi ya da içe aktarma alanı iki biçimden hiçbiriyle yazılmamış
E0201
assertion name declared twice across the extends chain
An assertion name is declared twice along an extends: chain (Bir doğrulama adı bir extends: zinciri boyunca iki kez bildirilmiş)
E0202
cyclic extends chain
Cyclic extends chain (Döngüsel extends zinciri); Cyclic extends on Components or Features (Components veya Features üzerinde döngüsel extends)
E0204
FeatureRecipe: valuesMapping requires source
A FeatureRecipe’s valuesMapping requires source (FeatureRecipe’in valuesMapping alanı source gerektirir)
E0205
inheritance merge failed
An extends: chain cannot be assembled (Bir extends: zinciri birleştirilemiyor)
E0207
recipe output-component-labels constraint: key is also declared in outputLabels
A promoted component label is also declared literally (Yükseltilen bir bileşen etiketi değişmez olarak da bildirilmiş)
E0208
recipe output-labels constraint: key uses a reserved namespace
An output-label key uses a reserved namespace (Bir çıktı etiketi anahtarı ayrılmış bir ad alanı kullanıyor)
At least one input kind must be present (En az bir girdi türü bulunmalıdır)
E0211
filename collision across input kinds: two input-kind blocks produced a file under one output name
Emission-time filename collision across input kinds (Yayım anında girdi türleri arasında dosya adı çakışması)
E0212
workload attachment slot is not referenceable
A Workload references a slot whose fill publishes no locator (Bir Workload, dolgusu hiçbir konum belirteci yayımlamayan bir yuvaya başvuruyor)
E0213
workload featuresSchema cross-check failed
A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Bir Workload eki, varlığın bildirmediği bir yuvayı ya da yuvanın yasakladığı bir teslimatı adlandırıyor)
E0214
workload validation failed
A Workload does not satisfy the Workload schema (Bir Workload, Workload şemasını karşılamıyor)
E0215
document envelope validation failed
YAML anchor aliased inside its own content (YAML çapası kendi içeriği içinde takma adla kullanılmış); Divergent Release (extends + aggregate pointer) (Ayrışan Release (extends + aggregate işaretçisi))
An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Bir x-aggrega-when: veya x-aggrega-validate: yüklemi değerlendirilemiyor)
E0218
validator/jsonschema: schema resolution failed
Bildirilen bir şema çözümlenemiyor
E0220
extends chain exceeds maximum depth
An extends: chain runs past the depth bound (Bir extends: zinciri derinlik sınırını aşıyor)
E0221
merger: invalid merge input
Şema birleştirme adımının kendi girdi koruması
E0222
registry alias matches more than one host
A registry alias matches more than one host (Bir kayıt defteri takma adı birden fazla ana bilgisayarla eşleşiyor)
E0223
a cross-cutting socket is bound by capability but attaches by uri
A plugin binding sets a key the socket it attaches to does not read (Bir plugin bağlaması, bağlandığı soketin okumadığı bir anahtar ayarlıyor)
E0224
workspace configuration is invalid
The workspace configuration is invalid (Çalışma alanı yapılandırması geçersiz)
E0225
capability is bound to more than one provider plugin
A capability is bound to more than one provider plugin (Bir yetenek birden fazla provider plugin’ine bağlanmış)
E0226
registry alias is already used by another host
Bir kayıt defteri takma adı zaten başka bir ana bilgisayara bağlı
E0227
a governance attachment declares no role or an unknown role
A governance attachment declares no role, or one that is not a known role (Bir yönetişim eki hiçbir rol bildirmiyor ya da bilinen bir rol olmayan bir rol bildiriyor)
E0228
a provider socket binding sets a field with no referent on that socket
A plugin binding sets a key the socket it attaches to does not read (Bir plugin bağlaması, bağlandığı soketin okumadığı bir anahtar ayarlıyor)
E0229
position out of range
Bir düzenleyici konumu belgenin dışına düşüyor
E0246
the digest recorded as trusted for this plugin does not match the digest its cached manifest reports
A trusted plugin’s recorded digest disagrees with the cached artifact (Güvenilir bir plugin’in kaydedilmiş özeti önbellekteki yapıtla uyuşmuyor)
E0247
a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role
A plugin recorded as a trusted gate is no longer attached (Güvenilir kapı olarak kaydedilmiş bir eklenti artık bağlı değil)
E0248
wasm: guest plugin returned an output that is not the shape the socket reads
A plugin returned something that is not the shape the socket reads (Bir plugin, soketin okuduğu biçimde olmayan bir şey döndürdü)
E0250
provider named a directory for each contributor's own sub-directory that is not a single directory name
A provider named a directory for a contributor that is not one directory (Bir sağlayıcı, bir katkıda bulunan için tek bir dizin olmayan bir dizin belirtti)
E0251
recipe source is an empty string, which names neither sourceless mode nor sourced mode
Recipe source: boş bir dizedir
E0252
artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under
An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Bir ArtifactLibrary paket dosyası, içe aktarıldığı anahtarın altında kendine ait bir dosya adlandırmıyor)
E0253
annotation binding does not resolve against its target Feature
Annotation binding does not resolve against its target Feature (Ek açıklama bağlaması hedef Feature’a karşı çözümlenmiyor)
E0254
annotation subkey does not conform to the target Feature's schema at the routed pillar
A bound annotation value does not conform to the target Feature’s schema (Bağlanan bir açıklama değeri hedef Feature’ın şemasına uymuyor)
E0255
annotation routes through a pillar its authoring side may not use
An annotation routes through a pillar its authoring side may not use (Bir açıklama, yazıldığı tarafın kullanamayacağı bir sütun üzerinden yönlendiriliyor)
E0256
annotation binding declares one path in both pillar lists
Bir açıklama bağlaması bir yolu her iki sütun listesinde de bildiriyor
E0257
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
Bildirilen bir şema sözleşmesi şema olarak okunamıyor
E0259
attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it
A boundary-scope Feature is attached only to a component (Sınır kapsamlı bir Feature yalnızca bir bileşene eklenmiş)
E0260
component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`
A component the composition holds is placed in no boundary (Kompozisyonun içerdiği bir bileşen hiçbir sınıra yerleştirilmemiş)
E0261
boundary names a component the composition does not hold: correct the name, or remove the entry
Bir sınır, bileşimin tutmadığı bir bileşeni adlandırıyor
E0262
component identity cannot be the name its emitted resources are stamped with: rename the component
Component identity cannot be stamped on what it emits (Bileşen kimliği, ürettiklerine damgalanamıyor)
E0263
the target will not accept a name derived from this component's authored identity: rename the component
The target will not accept a name derived from an authored identity (Hedef, yazılmış bir kimlikten türetilen adı kabul etmiyor)
E0264
provider guest never accepted a component identity the compiler composed for it
A provider never accepted a name the compiler composed (Bir sağlayıcı, derleyicinin oluşturduğu bir adı hiç kabul etmedi)
E0265
provider does not support the node's input kind
workload: requires a provider that can synthesize (workload:, sentezleyebilen bir provider gerektirir)
E0266
a schema `$import:` could not be applied
A schema $import: cannot be applied (Bir şema $import: yönergesi uygulanamıyor)
E0267
a schema block declares a key that names no data pillar
A schema block names a key that is not a data pillar (Bir şema bloğu veri sütunu olmayan bir anahtarı adlandırıyor)
E0268
reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens
A provider’s reassembly is handed a unit its own carve never produced (Bir provider’ın yeniden birleştirmesine kendi bölmesinin hiç üretmediği bir birim veriliyor)
E0269
provider guest returned two output files under one path; a conforming guest returns each output path at most once
A provider returned two output files under one path (Bir provider tek bir yol altında iki çıktı dosyası döndürdü)
E0270
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
Bir provider’ın bağlantı kablolaması hiç üretilmemiş bir çıktı dosyasını adlandırıyor
E0271
emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content
Bir pipeline adımının dosya üretimi hiç dosya taşımıyor
E0272
side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd
Bir pipeline adımı, sözleşmenin tanımlamadığı bir üretim türü bildiriyor
E0273
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
Bir şablon, düğümün provider’ının bildirmediği bir işlenmiş adı okuyor
E0274
the plugin identity recorded as trusted no longer matches what this resolution reports
A gate recorded as trusted resolves to a different identity (Güvenilir olarak kaydedilmiş bir kapı farklı bir kimliğe çözümleniyor)
E0275
the edit was refused because the resulting document would not be valid, and nothing was written
An edit would produce a document its schema refuses (Bir düzenleme, şemasının reddettiği bir belge üretecektir)
E0276
the version being published changes the published predecessor in a way the documented evolution rubric objects to
Yayımlanan değişiklik, evrim ölçütünün izin verdiğini bozuyor
E0277
an annotation key on the entity uses a prefix the platform reserves
An annotation key uses a prefix the platform reserves (Bir ek açıklama anahtarı platformun ayırdığı bir önek kullanıyor)
E0278
the entity's name does not follow the documented name shape for its kind
Bir varlığın adı, türünün beklediği biçime uymuyor
E0279
a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow
Bir şema, önceden çözümlenemeyen dinamik bir başvuru kullanıyor
E0280
a schema in the entity declares an identifier of its own, where the platform owns that schema's identity
Bir şema, platformun sahip olduğu bir tanımlayıcı bildiriyor
E0281
the entity's category label does not match the category directory the entity is filed under
Bir Component’in kategori etiketi ve dizini farklı kategorileri adlandırıyor
E0282
the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema
Bir şema uzantısı doğrudan şema içeriğine yazılmış
E0283
the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply
Bir Plugin hiçbir çalışma zamanı sınırını sabitlemiyor, bu yüzden platformunkiler uygulanıyor
E0284
an attachment slot admits only secret material and does not declare that it handles it
Bir ek yuvası yalnızca gizli malzeme kabul ediyor, ama onu işlediğini belirtmiyor
E0285
the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused
Bir Recipe, Component’inin bildirmediği bir provides anahtarı yayımlıyor; yayımlamada denetlenir
E0286
the version bump being published is smaller than the evolution check's classification of the change requires
Sunulan sürüm artışı, değişikliğin gerektirdiğinden küçük
E0287
the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files
Bir içe aktarma, bir kaynağı çevirirken yarıda durdu
E0288
a plugin has no expression for a construct this build declares
A workload declares a form compose cannot express (Bir workload, compose’un ifade edemediği bir biçim bildiriyor); A container declares a field compose has no primitive for (Bir konteyner, compose’un karşılığı olan bir temel öğeye sahip olmadığı bir alan bildiriyor); An omits entry names a kind or a namespace a compose file does not have (Bir omits girdisi, bir compose dosyasında bulunmayan bir tür ya da ad alanı adlandırıyor); An omits entry names a namespace a CloudFormation template does not have (Bir omits girdisi, bir CloudFormation şablonunda bulunmayan bir ad alanı adlandırıyor); A rule reads a bound CloudFormation parameter by name (Bir kural, bağlanmış bir CloudFormation parametresini adıyla okuyor); The assembled CloudFormation stack cannot carry a transform (Birleştirilen CloudFormation yığını bir dönüşüm taşıyamıyor)
E0289
a plugin could not resolve something it requires to exactly one value
A health probe cannot be turned into a compose healthcheck (Bir sağlık yoklaması bir compose healthcheck’ine dönüştürülemiyor); A configmap volume has no file behind it (Bir configmap biriminin arkasında dosya yok); What an omits entry left out is still named by the compose file (Bir omits girdisinin dışarıda bıraktığı şey compose dosyasında hâlâ adlandırılıyor); What an omits entry left out is still named by a CloudFormation template (Bir omits girdisinin dışarıda bıraktığı şey bir CloudFormation şablonunda hâlâ adlandırılıyor); A valuesMapping key names no parameter of a sourced CloudFormation template (Bir valuesMapping anahtarı, kaynaktan alınan bir CloudFormation şablonunun hiçbir parametresini adlandırmıyor); Another component references a CloudFormation parameter a sourced template’s binding filled (Başka bir bileşen, kaynaktan alınan bir şablonun bağlamasının doldurduğu bir CloudFormation parametresine başvuruyor); Two components order one pair of transforms oppositely (İki bileşen bir dönüşüm çiftini ters sırayla diziyor); A cross-boundary reference has no consuming stack to be written into (Sınırlar arası bir başvurunun yazılacağı tüketici bir yığın yok); A synthesized StatefulSet has no single service to govern it (Sentezlenen bir StatefulSet’i yönetecek tek bir hizmet yok)
E0290
two things a plugin produced occupy one name in its output
An authored export name is one the build derives for a cross-stack reference (Yazılan bir dışa aktarma adı, derlemenin yığınlar arası bir başvuru için türettiği bir ad); The output a cross-stack reference publishes on already carries an Export (Yığınlar arası bir başvurunun yayımlandığı çıktı zaten bir Export taşıyor); Two entries reach one stack output name (İki girdi tek bir yığın çıktı adına ulaşıyor); A CloudFormation fragment writes one key twice (Bir CloudFormation parçası bir anahtarı iki kez yazıyor); Two rendered resources land at one output file (İşlenen iki kaynak tek bir çıktı dosyasına düşüyor)
E0291
a plugin has no representation for a value it was given
A published port declares a transport compose cannot spell (Yayımlanan bir bağlantı noktası, compose’un yazamadığı bir aktarım bildiriyor); A resources quantity cannot be converted to a compose value (Bir resources miktarı bir compose değerine dönüştürülemiyor); A resource quantity the helm provider emits is not a quantity (helm provider’ının ürettiği bir kaynak miktarı bir miktar değil); A service type the helm provider cannot render (helm provider’ının işleyemediği bir hizmet türü); A Kubernetes version the helm provider cannot render a chart for (helm provider’ının chart işleyemediği bir Kubernetes sürümü); A value bound to a CloudFormation parameter cannot take the parameter’s type (Bir CloudFormation parametresine bağlanan bir değer parametrenin türünü alamıyor); A value bound to a CloudFormation parameter is one its constraints refuse (Bir CloudFormation parametresine bağlanan bir değer, parametrenin kısıtlarının reddettiği bir değer); A secret bound to a CloudFormation parameter would be written into the template (Bir CloudFormation parametresine bağlanan bir gizli bilgi şablona yazılacak); A dynamic reference is bound where CloudFormation does not resolve it (Dinamik bir başvuru, CloudFormation’ın onu çözümlemediği bir yere bağlanmış); A cross-boundary reference was spliced into a longer string (Sınırlar arası bir başvuru daha uzun bir dizenin içine eklenmiş)
E0292
a plugin reported a failure that none of the declared kinds names
A plugin reported a failure it did not classify (Bir eklenti sınıflandırmadığı bir hata bildirdi)
E0293
wasm: guest plugin named a condition the socket does not declare
A plugin named a condition the socket does not declare (Bir eklenti, soketin bildirmediği bir koşulu adlandırdı)
E0294
components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity
İki alt sistem tek bir ad altında bir bileşen bildiriyor
E0295
library reference: a reference to a library entry carries no whitespace or line break
Bir kütüphane girdisine yapılan başvuru boşluk içeriyor
E0296
release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both
A Release chain’s links disagree about the routing shape (Bir Release zincirinin halkaları yönlendirme biçimi konusunda uyuşmuyor)
E0297
inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to
Bir alt Release, üst öğesinin yazdığı yere çözümlenen bir sınır dizinini devralıyor
E0298
oci: published bundle carries no entity document
A published bundle holds no entity, or holds two (Yayımlanmış bir paket hiç varlık içermiyor ya da iki varlık içeriyor)
E0299
oci: published bundle carries more than one entity document
A published bundle holds no entity, or holds two (Yayımlanmış bir paket hiç varlık içermiyor ya da iki varlık içeriyor)
E0300
oci: published bundle cannot be unpacked
A published artifact cannot be read as an entity (Yayımlanmış bir yapıt varlık olarak okunamıyor)
E0301
oci: published artifact is not an entity document
A published artifact cannot be read as an entity (Yayımlanmış bir yapıt varlık olarak okunamıyor)
E0302
an input the entity reads has no pin recorded for it in the entity.lock beside it
An entity reads an input the lock beside it records no pin for (Bir varlık, yanındaki kilidin pin kaydetmediği bir girdiyi okuyor)
E0303
the entity shares its directory with another entity, and an entity of its kind has a directory of its own
Bir varlık dizinini başka bir varlıkla paylaşıyor
E0304
a path names content outside the entity's own directory
Bir yol, varlığın kendi dizininin dışındaki içeriği adlandırıyor
E0305
the files of the entity's local source do not match the pins recorded for them in entity.lock
A local source no longer matches the pins recorded beside its Recipe (Yerel bir kaynak, Recipe’inin yanında kaydedilen sabitlemelerle artık eşleşmiyor)
E0306
plugin artifact not found on this machine
Bir eklentinin .wasm dosyası bu makinede değil
E0307
a value a cache location is built from would place cached files outside the place it names in the cache
A value would place a cached file outside the cache (Bir değer, önbelleğe alınmış bir dosyayı önbelleğin dışına yerleştirecek)
E0308
a Feature reaches a component alongside a Feature it declares a conflict with
Two Features declared to conflict reach one component (Çakıştığı bildirilen iki Feature tek bir bileşene ulaşıyor)
E0309
a symbolic link sits among the files an entity carries
A symbolic link sits among the files an entity carries (Bir varlığın taşıdığı dosyalar arasında bir sembolik bağlantı bulunuyor)
E0310
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>`
Bir kayıt defteri, sabitlenecek güven politikası olmadan çevrimdışı ekleniyor
E0311
reference carries a malformed version pin
A version pin is none of the forms a pin takes (Bir sürüm sabitlemesi, sabitlemenin alabileceği biçimlerin hiçbirinde değil)
E0312
a provider socket binding names a capability containing a colon, which no Recipe can select
A provider binding names a capability containing a colon (Bir provider bağlaması iki nokta içeren bir yetenek adlandırıyor)
E0313
plugins.providers entry names a capability no provider-rendering plugin the build reads serves
Bir sağlayıcı bağlaması, derlemenin okuduğu hiçbir eklentinin sunmadığı bir yeteneği adlandırıyor
E0314
plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports
A plugin was built from a working tree with uncommitted changes (Bir plugin, commit edilmemiş değişiklikler içeren bir çalışma ağacından derlendi)
E0315
a connection carries an attachment under a name its socket declares no slot for
A connection carries an attachment under a name its socket declares no slot for (Bir bağlantı, soketinin hiçbir yuva bildirmediği bir ad altında bir ek taşıyor)
E0316
a Release attachment takes the name of an attachment one of a component's connections carries
A Release attachment takes the name of a connection’s attachment (Bir Release eki, bir bağlantının ekinin adını alıyor)
E0317
a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes
A Release connection attachment names no Feature type (Bir Release bağlantı eki hiçbir Feature türü belirtmiyor)
E0318
duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered
Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Eklenmiş iki Feature tek bir anahtarı iletiyor, sonraki FeatureRecipe’inin injectMapping’i aracılığıyla)
E0319
connection alias is already used by another connection of the same component
Bir bileşenin tek bir takma ad altındaki iki bağlantısı
E0320
a path this operation writes or deletes leads through a link out of the directory it must stay inside
A path the operation writes leads through a link out of the directory it must stay inside (İşlemin yazdığı bir yol, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor)
E0321
a file this operation reads leads through a link out of the directory it must stay inside
A file the operation reads leads through a link out of the directory it must stay inside (İşlemin okuduğu bir dosya, bir bağlantı aracılığıyla içinde kalması gereken dizinin dışına çıkıyor)
E0323
template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts
Bir şablon, çağıranlarının işleme olgularını bildirmeden okuyor
E0324
a reference a document makes to another file leads out of the directory it must stay inside
A reference to another file leads out of the directory it must stay inside (Başka bir dosyaya yapılan başvuru, içinde kalması gereken dizinin dışına çıkıyor)
E0325
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
Bir provider, değeri liste olmayan bir render olgusu bildirdi
E0326
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
A pipeline step reads its callers’ render facts (Bir pipeline adımı, çağıranlarının render olgularını okuyor)
E0327
template indexes a map with a key the map does not hold
A template indexes a map with a key the map does not hold (Bir şablon, bir eşlemeyi eşlemenin içermediği bir anahtarla dizinliyor)
E0328
attachment written under a name no slot declares fits a slot its component leaves empty
An attachment written under another name fits a slot its component leaves empty (Başka bir ad altında yazılan bir ek, bileşeninin boş bıraktığı bir yuvaya uyuyor)
E0329
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
Bir bağlantı ile ulaştığı hedef tek bir anahtarı adlandırmıyor
E0330
signing: the references named together need different signing credentials, so nothing was signed
References signed together need different signing credentials (Birlikte imzalanan başvurular farklı imzalama kimlik bilgileri gerektiriyor)
E0331
signing: no verified signature is recorded for an artifact that requires one
No verified signature is recorded for an artifact that requires one (İmza gerektiren bir yapıt için doğrulanmış imza kaydedilmemiş)
E0332
signing: the recorded signature was made for a different artifact
A recorded signature was made for a different artifact (Kayıtlı imza farklı bir yapıt için oluşturulmuş)
E0333
signing: a recorded signature is not the one a pull would record
A recorded signature is not the one a pull would record (Kaydedilen imza, bir pull işleminin kaydedeceği imza değil)
E0334
an omits entry left out nothing the source rendered
An omits entry left out nothing the source rendered (Bir omits girdisi kaynağın işlediği hiçbir şeyi dışarıda bırakmadı)
E0335
provider does not support omits
The provider does not support omits (Sağlayıcı omits desteklemiyor)
E0336
a provider's omitted counts do not match the omits entries it was handed
A provider’s omitted counts do not match the omits entries it was handed (Bir sağlayıcının dışarıda bırakılan sayıları, kendisine verilen omits girdileriyle eşleşmiyor)
E0337
no importer plugin version satisfies the plugins.importer entry's version pin
A plugins.importer entry pins a version of its importer the catalog does not hold (Bir plugins.importer girdisi, importer’ının kataloğun içermediği bir sürümünü sabitliyor)
E0338
importer is attached by more than one plugins.importer entry
An importer is attached by more than one plugins.importer entry (Bir importer birden fazla plugins.importer girdisiyle bağlanmış)
E0339
more than one importer recognises the source
Kaynağı birden fazla içe aktarıcı tanıyor
E0340
a name this operation writes holds a path segment Windows cannot hold as written
İşlemin yazdığı bir ad, Windows’un tutamayacağı bir parça içeriyor
E0341
the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory
Dosya kalıbı bildirmeyen bir içe aktarıcıya bir dizin veriliyor
E0342
no file in the directory matches the file patterns the importer serving the source's format declares
Dizindeki hiçbir dosya içe aktarıcının dosya kalıplarıyla eşleşmiyor
E0343
a file read from the directory and a file named in the importer's `with.sources` have the same name
A file read from the directory and a file named in the importer’s with.sources have the same name (Dizinden okunan bir dosya ile içe aktarıcının with.sources alanında adlandırılan bir dosya aynı ada sahip)
E0344
an entry this publication carries cannot be used on Windows
Yayınlanmış bir arşiv, Windows’un kullanamayacağı bir girdi taşıyor
E0345
a container declares one environment variable twice
A container gives one environment variable two values (Bir konteyner bir ortam değişkenine iki değer veriyor)
E0346
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
Bir Component’in metrik ek açıklaması ile provides anahtarı uyuşmuyor
E0347
template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts
A template reads its targets’ render facts without declaring it (Bir şablon, bunu bildirmeden hedeflerinin render olgularını okuyor)
E0348
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
A pipeline step reads its targets’ render facts (Bir pipeline adımı, hedeflerinin render olgularını okuyor)
E0349
no Recipe in the workspace's catalog binds to the capability the import's target names
An import’s target names a capability no Recipe in the catalog binds to (Bir içe aktarmanın hedefi, katalogdaki hiçbir Recipe’in bağlanmadığı bir yeteneği adlandırıyor)
E0350
no importer recognises the source
Kaynağı hiçbir içe aktarıcı tanımıyor
E0351
provider does not support boundary artifacts
The provider does not support boundary artifacts (Sağlayıcı sınır yapıtlarını desteklemiyor)
E0352
boundary output directory does not name a directory beneath the output root
A boundary’s output directory is not a directory beneath the output root (Bir sınırın çıktı dizini, çıktı kökünün altındaki bir dizin değil)
E0353
boundary-level Feature instance name is not a directory name
A boundary-level Feature is named . or .. (Sınır düzeyindeki bir Feature . veya .. olarak adlandırılmış)
E0354
a template does more than copy a value it reads off a cross-boundary link
A template did more than copy a value it read off a cross-boundary link (bir şablon, sınırlar arası bir bağlantıdan okuduğu değeri kopyalamaktan fazlasını yaptı)
E0355
inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`
An inject: delivery is not a list of entries (Bir enjeksiyon teslimatı girdi listesi değil)
E0356
suspend requires form: scheduled
A workload suspend: is set on a form other than scheduled (Bir workload’un askıya alma alanı zamanlanmış dışında bir biçimde ayarlanmış)
E0357
a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing
A Manifest name mapping names nothing in the build (Bir Manifest name eşlemesi derlemedeki hiçbir şeyi adlandırmıyor)
E0358
uses edge target names a component its module does not export
A uses target names a module’s component the module does not export (Bir uses hedefi, modülün dışa aktarmadığı bir modül bileşenini adlandırıyor)
E0359
no source adapter is registered in this program for the source kind
No source adapter is registered in this program for a source kind (Bu programda bir kaynak türü için kayıtlı kaynak bağdaştırıcısı yok)
E0360
the netrc file could not be read
The netrc file cannot be read (Netrc dosyası okunamıyor)
E0361
the source URL carries a credential
A source URL carries a credential (Bir kaynak URL’si kimlik bilgisi taşıyor)
E0362
inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`
An inject: entry on a connection carries a literal (Bir bağlantıdaki enjeksiyon girdisi değişmez değer taşıyor)
E0363
annotation subkey is not routed by the annotation's binding
An annotation subkey is not routed by its binding (Bir açıklama alt anahtarı bağlaması tarafından yönlendirilmiyor)
E0364
a value template failed while it ran
A value template failed while it ran (Bir değer şablonu çalışırken başarısız oldu)
E0365
boundary-level Feature's output is routed to a dispatch path nothing assembles
A boundary-level Feature’s output reaches no assembled file (Sınır düzeyindeki bir Feature’ın çıktısı hiçbir birleştirilmiş dosyaya ulaşmıyor)
E0366
FeatureRecipe injectMapping output could not be read as a dictionary of deliveries
An attached Feature’s injectMapping output cannot be read (Eklenmiş bir Feature’ın injectMapping çıktısı okunamıyor)
E0367
a scalar annotation value does not route to exactly one path of its binding
A bare annotation value does not route to exactly one path of its binding (Yalın bir ek açıklama değeri, bağlamasının tam olarak tek bir yoluna yönlenmiyor)
E0368
FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads
An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Eklenmiş bir Feature’ın injectMapping çıktısı, hiçbir şeyin teslim etmediği bir anahtar altına teslimler yazıyor)
E0369
template reads a path as a value and iterates it, and the data holds nothing at that path
A template reads and iterates a path that holds nothing (Bir şablon hiçbir şey içermeyen bir yolu okuyor ve yineliyor)
E0370
a pipeline declares one step id twice
A pipeline declares one step id twice (Bir işlem hattı bir adım kimliğini iki kez bildiriyor)
E0371
catalog document declares a kind a catalog does not hold
A catalog document declares a kind a catalog does not hold (Bir katalog belgesi, kataloğun tutmadığı bir tür bildiriyor)
E0372
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
An inject: entry on an attached Feature carries a literal (Eklenmiş bir Feature üzerindeki enjeksiyon girdisi bir değişmez değer taşıyor)
E0373
a document declares an API version this compiler no longer reads
A document declares an API version this compiler no longer reads (Bir belge, bu derleyicinin artık okumadığı bir API sürümü bildiriyor)
E0374
a plugin declares a plugin ABI version this compiler no longer speaks
A plugin declares a plugin ABI version this compiler no longer speaks (Bir eklenti, bu derleyicinin artık desteklemediği bir eklenti ABI sürümü bildiriyor)
E0375
oci: artifact carries a media type this compiler no longer reads
An artifact carries a media type this compiler no longer reads (Bir yapıt, bu derleyicinin artık okumadığı bir medya türü taşıyor)
E0376
egress: the server did not answer in time
A server did not answer in time (Bir sunucu zamanında yanıt vermedi)
E0377
registry: the repository listing did not end in time
A registry’s repository listing did not end in time (Bir kayıt defterinin depo listesi zamanında sona ermedi)
E0378
oci: the registry kept asking to slow down
A registry kept asking to slow down (Bir kayıt defteri yavaşlamayı istemeyi sürdürdü)
Linter alanı (ölümcül değil)
Derleyici yürütme konusunda kesinlikle kendi görüşü olmayan bir yapıdadır. Yalnızca şüpheli olan kalıplar nedeniyle derlemeyi asla durdurmaz: kullanılmayan değerler, sahipsiz gizli bilgiler, bağlantısız hedefler. Böyle bir kalıp en fazla bir uyarıya yol açar — yukarıda “Derlemeyi durdurmayan koşullar” altında kataloglanan, hiçbir şeyin okumadığı bildirilmiş bir parametre gibi birkaç durum için derlemenin kendi uyarısına — geri kalanlar ise kuruluşların kendi uzlaşımlarını uygulayan Wasm eklentilerini isteğe bağlı olarak etkinleştirdiği linter alanına aittir.
Sahipsiz kimlik bilgileri
inject: teslim sözleşmesi olmadan eklenmiş bir kimlik bilgisi Feature’ı derleme hatası değildir. Çekirdek derleyici bildirimi IR grafiğinde korur ve hiçbir uyarı üretmez. Kurumsal linter eklentileri bu kalıbı algılayıp uyarı verebilir; kurumsal işleyiciler de sahipsiz gizli bilgileri kendi Black-Box uzlaşımları altında örtük olarak bağlamayı seçebilir. Her iki yorum da geçerli olduğundan çekirdek derleyici hiçbir tarafı tutmaz.