Uyarılar ve linter çıktısı
Derleyicinin derleme sırasında ürettiği, derlemeyi durdurmayan uyarılar. Uyarılar derlemeyi durdurmaz; yazımdaki kötü kokuları, derleyicinin seçtiği deterministik eşitlik bozmaları ve geliştiricinin şablonlarının hiç kullanmadığı kaynakları gün yüzüne çıkarır. Her bulgu, onu hangi geçişin ürettiğine bağlı olarak türünü adlandıran bir önekle (warning:, lint: veya notice:) stderr’e ulaşır; böylece CI işlem hatları bunları yakalayıp yeniden görünür kılabilir. İşlenmiş yapıtlar her durumda üretilir.
Derlemeyi durduran ölümcül hatalar (bir derlemeyi durduran tanılamalar) için bkz. fatal-halts.md.
Kısa koda göre tüm uyarı niteliğindeki bulgular
Derleyicinin durmadan bildirdiklerinin bir kısmı kendi başına bir koşuldur: durduran bir tanılamanın yazdırdığı dört haneli tanımlayıcının aynısı olan bir kısa kod ve mesajının başladığı sabit bir cümle taşır. Aşağıdaki tablo birinden diğerine arama yapmanızı sağlar; böylece elinizdeki bir kod, okuduğunuz satır bir durdurma değil de bir uyarı olsa bile bulgunun neyle ilgili olduğuna çözümlenir.
Burada yer almayı sağlayan bir açıklama değil, bir bildirimdir. Derleyicinin değerlendirdiği her kural, bir ihlalin ne yaptığını belirtir — derlemeyi durdurmak ya da bulguyu bildirip derlemenin tamamlanmasına izin vermek — ve aşağıdaki satırlar ikinci türdendir. Bu nedenle derleyiciye eklenen uyarı niteliğindeki bir bulgu, elle bir satır yazılmadan burada görünür; durduran bir koşula dönüşen bir bulgu ise buradan çıkar.
Tablonun kapsamının iki sınırı vardır ve bir kodun eksik olduğu sonucuna varmadan önce ikisini de bilmekte yarar vardır:
- Bu sayfadaki her şey bunlardan biri değildir. Aşağıda anlatılan bulguların birçoğu bildirilmiş bir kural yerine kendine ait bir geçiş tarafından üretilir ve bazıları hiçbir koşul taşımaz — yazdırdıkları satırlar yine de bölümlerinde anlatıldığı gibidir, ancak çözümlenecek bir kod ve dolayısıyla bir satır yoktur. Orada beklenecek biçim
unsupported-fieldsınıf kodudur: bir koşul yerine bir bulgu sınıfını adlandırır. - Buradaki bir satır, aşağıda bir bölüm olacağını vaat etmez. İşlemenin geç bir aşamasında üretilen uyarı niteliğindeki bir bulgu anlatılmak yerine kataloglanır; bu nedenle bir kod burada bir cümleye çözümlenip daha ayrıntılı ele alınışı fatal-halts.md içinde, derlemeyi durdurmadan kod taşıyan her koşulu kataloglayan “Conditions that do not halt a build” başlığı altında bulunabilir.
sentinels.md, bir derlemenin yazdırdığı uyarı niteliğinde ya da durduran her kısa kodu çözümler ve elinizdekinin hangi türden olduğunu henüz bilmediğinizde başlanacak yerdir.
| Kısa kod | Başladığı cümle |
|---|---|
E0004 | annotation contribution overridden by an explicit value |
E0037 | cross-boundary link between endpoints rendered by different providers is not supported |
E0149 | attachment name is a near miss for a declared slot |
E0167 | Recipe publishes a provides key its Component does not declare |
E0173 | declared parameter is read by no reference in the Aggregate |
E0174 | uses socket name is a near miss for a declared socket |
E0256 | annotation binding declares one path in both pillar lists |
E0297 | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
Şema sütunu çakışması lint’i
Şu durumda tetiklenir: bir Component ya da Feature, spec.schema: bloğunun hem values: hem de infra: sütununda aynı iç içe geçme derinliğinde aynı özellik adını bildirdiğinde. Aynı alan adını her iki sütuna koyan şema yazarları genellikle onu yalnızca birine koymak ister; lint, yazarın alanın hangi sütuna ait olduğunu çözebilmesi için bu yinelemeyi işaretler.
İşlem hattındaki yeri. Lint, şema birleştirmesinden sonra, topoloji oluşturulmadan önce doğrulama geçişinde çalışır. Şemayı kısa biçim genişletmesinden sonra, bir $ref: başvurusunu izlemeden dolaşır (aşağıdaki yumuşak atlama ilkesine bakın) ve çakışan her özelliği ayrı bir uyarı olarak raporlar.
Çıktı biçimi:
notice: LINT: Component "core/compute/web-server:1.0.0" at ./catalog/component/core/compute/web-server/1.0.0/component.yaml declares property "storage_size" in both values: and infra: pillars (path: storage_size)İç içe özellikler için yol, sütunun kökünden özelliğe giden noktalı yoldur:
notice: LINT: Feature "core/db-pool:1.0.0" at ./catalog/feature/core/db-pool/1.0.0/feature.yaml declares property "timeout" in both values: and infra: pillars (path: connection.timeout)Tüm kataloğun yüklenmesi — argümansız aggrega validate — yukarıdaki gibi her varlığı adı ve sürümüyle ve okunduğu dosyayla adlandırır. Bir derleme ya da tek bir Release’in doğrulanması ise yalnızca o Release’in ulaştığı varlıkları okur ve her birini adı ve sürümüyle — at core/db-pool:1.0.0 — Release’teki kaç başvuru ona ulaşırsa ulaşsın varlık başına bir kez adlandırır: bir Feature’ı yalın adıyla anan bir Aggregate ile onu adı ve sürümüyle eşleyen bir Manifest tek bir Feature’a ulaşır ve bu Feature bir kez raporlanır.
Düzenleyicide görünürlük. Bulgu, dil sunucusu aracılığıyla düzenleyici tanılamalarına uyarı önem düzeyinde, bir anahtarın üzerinde değil dosyanın başında ulaşır — düzenlemekte olduğunuz belgenin içindeki bir konumu değil bir katalog varlığını adlandırır, bu yüzden bir işaretçinin üzerinde durabileceği bir yazım anahtarı yoktur. Yapıt oluşturma aşamasından önce üretildiği için bir ayar gerektirmez: düzenleyici oturumu, serve.build_on_inspect açık olsun ya da olmasın onu gösterir.
Yumuşak atlama disiplini. Bir şema dalı, statik olarak türetilebilir özellik kümelerini engelleyen JSON Schema 2020-12 kaçış yollarından birini taşıdığında dolaşıcı uyarı vermeden sonlanır: $ref (belgeler arası ya da belge içi başvurular), patternProperties (anahtar biçimine dayalı özellik bildirimleri), true ya da bir şemaya ayarlanmış additionalProperties (dalın adlandırmadan kabul ettiği özellikler) ve oneOf / anyOf / allOf bileşim işleçleri (dalları birbirinden farklı özellik kümeleri bildirebilen ayrışımlar ve birleşimler). Bu dalları dolaşmak ya başvurulan ya da bileşik şemanın lint zamanında değerlendirilmesini (lint’in yapmadığı türden bir iş) gerektirir ya da bir dalın values: özellik adı başka bir dalın infra: özellik adıyla tesadüfen çakıştığında yanlış pozitifler üretir. Lint, etkilenen iç içe geçme derinliği için uyarı vermez; aynı şemanın daha derin düzeyleri yine dolaşılır ve lint’ten geçirilebilir.
Yazım notu. Derleyici sütun adı çakışmalarını reddetmez — lint yalnızca öneri niteliğindedir. Her iki sütunda storage_size bulunan bir Component derlenir; geliştirici tarafındaki values.storage_size ile operatör tarafındaki infra.storage_size kendi sütun şemalarınca birbirinden bağımsız olarak doğrulanır ve Recipe’nin valuesMapping: şablonu oluşturulan çıktıya hangi sütunun değerinin aktarılacağını seçer. Lint, bu yazım kalıbı neredeyse her zaman bir hata olduğu için vardır; bilinçli sütunlar arası yineleme o kadar nadirdir ki bunu gerçekten isteyen yazarlar uyarıyı yok sayabilir. Kasıtlı sütunlar arası aktarımın haklı olduğu nadir durumlar da dahil olmak üzere daha geniş sütunlar arası işleyiş için vocabulary/data-pillars.md “Cross-pillar mechanics” bölümüne bakın.
Bağlama eşlemesi çakışması lint’i
Tetiklendiği durum: bir Manifest ek açıklama bağlaması aynı noktalı yolu hem maps.infra hem de maps.values listesinde bildirdiğinde. Yol her iki sütun üzerinden de yönlendirilecektir; derleyicinin deterministik eşitlik bozma kuralı onu infra: üzerinden gönderir ve bu da values: tarafını Aggregate’ten erişilemez kılar. Lint bunu görünür kılar; böylece yazar bağlamayı tek bir sütuna daraltabilir ya da yalnızca infra tarafından yönlendirmeyi bilinçli olarak kabul edebilir.
İşlem hattındaki yeri. Lint, Manifest çözümlendikten sonra ve herhangi bir ek açıklama genişletmesi başlamadan önce çalışır; bu nedenle bir derleme, çakışan bir bağlamayı, bir Aggregate ek açıklaması o bağlamaya hiç ulaşsa da ulaşmasa da raporlar. mappings.features.annotations altındaki bağlamaları yazıldıkları sırayla dolaşır, her bağlamanın maps.infra ve maps.values listelerinin kesişimini alır ve çakışan her yol için bir bulgu raporlar. Tek bir bağlama içinde çakışan yollar, o bağlamanın maps.values listesinin onları bildirdiği sırayla — yani sizin yazdığınız sırayla — raporlanır; böylece aynı girdi üzerinde tekrarlanan çalıştırmalar aynı diziyi raporlar.
Çıktı biçimi:
lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations, "compliance.aggrega.ai/data-class", on Feature "core/pii-redaction", at path "classifier_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values") lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations.audit-scope, "audit-scope", on Feature "core/pii-redaction", at path "retention_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values")Bu iki satır tek bir Manifest üzerindeki tek bir derlemeden gelir ve konum belirteçleri arasındaki fark, ek açıklama anahtarının biçimidir. Konum belirteci bir belgeyi noktalı yolla adresler; bu nedenle kendi içinde nokta taşıyan ilk segmentte durur: audit-scope nokta taşımaz ve konum belirteci bağlamaya ulaşır; compliance.aggrega.ai/data-class ise taşır ve konum belirteci bunun yerine onu içeren annotations bloğunu adlandırır. Sorunlu anahtarın her bulgunun ilk tırnaklı değeri olmasının nedeni budur: konum belirtecinin her zaman taşıyamadığı tek parça odur.
Düzenleyicide görünürlük. Bulgu, dil sunucusu aracılığıyla uyarı önem düzeyinde düzenleyici tanılamalarına da ulaşır ve konum belirtecinin ulaştığı yere yerleştirilir: düz bir anahtar için bağlamanın kendisine, nokta taşıyan bir anahtar için ise onu içeren annotations bloğuna. Terminal çıktısını hiç okumayan bir yazar da onu görür. Yapıt oluşturma aşamasından önce üretildiği için herhangi bir ayar gerektirmez: bir düzenleyici oturumu, serve.build_on_inspect açık olsa da olmasa da onu gösterir.
Programatik olarak eşleştirme. Bulgu pkg/resolver paketinden ErrAnnotationBindingPillarOverlap değerini taşır; böylece bir tüketici sınıfı mesaj metnini eşleştirerek değil errors.Is ile tanır. Her tavsiye niteliğindeki sentinel gibi bir derlemenin sonucuna hiçbir zaman ulaşmaz — erişimci ve koşulun kodları için bkz. sentinels.md.
Deterministik eşitlik bozma. Çalışma zamanı çakışmayı, yolu yalnızca infra: sütunu üzerinden yönlendirerek çözer. Bu seçim derlemeler arasında tutarlıdır; yazar buna güvenebilir. values: tarafı bağlamanın etkin yönlendirmesinden çıkarılır — yola ulaşmaya çalışan Aggregate tarafı ek açıklamaları hiçbir yönlendirme hedefi almaz ve derleme, genişletme zamanında Aggregate tarafında, fatal-halts.md içinde “An annotation routes through a pillar its authoring side may not use” (Bir ek açıklama, yazıldığı tarafın kullanamayacağı bir sütun üzerinden yönlendiriliyor) başlığında açıklanan durdurmayla durur. Lint erken uyarı yüzeyidir; o durdurma ise yaptırım yüzeyidir.
Yazım notu. Şema sütunu çakışması lint’i gibi bu lint de tavsiye niteliğindedir — bağlama derlenir ve çalışma zamanı eşitlik bozma kuralı deterministik çıktı üretir. Lint, bu yazım kalıbı neredeyse her zaman istenmeden ortaya çıktığı için tetiklenir; her iki sütunun da aynı yolu yönlendirmesini gerçekten isteyen bir bağlama yazarı, farklı ek açıklama anahtarlarına sahip iki ayrı bağlama yazardı.
Ek yuvası yakın eşleşme lint’i
Şu durumda tetiklenir: bir component örneği, bir Feature’ı Component türünün bildirilmiş featuresSchema yuvalarından biri olmayan, ancak bunlardan birine tek düzenleme uzaklığında olan bir ad altında ekler — tek bir karakterin eklenmesi, silinmesi ya da değiştirilmesi veya bitişik iki karakterin yer değiştirmesi — ve eklenen Feature o yuvanın selector’ını karşılamaz. Bu, bir yuva adı yazım hatasının aldığı biçimdir ve lint, yazarın çifti görebilmesi için iki yazımı da adlandırır.
Neden var? Bir yuvanın bildirilmesi ek yüzeyini kapatmaz: hiçbir yuvanın bildirmediği bir ad altındaki ek geçerlidir, çünkü tek bir katalog varlığının hem yuvayı dolduran bir eke hem de daha geniş bir kapsamda paylaşılan bir kimlik bilgisine hizmet etmesini sağlayan bu açıklıktır. Bunun bedeli, yanlış yazılmış bir yuva adının yazarın kastettiği yuvayı doldurmak yerine sessizce bir serbest ek olmasıdır — derleme başarılı olur ve yuva yalnızca boş kalır. Lint, tam da bu durum için açıkça belirtilmiş önlemdir.
İşlem hattındaki yeri. Lint, çözümleme sırasında, kataloğu dikkate alan anlamsal korumalarla aynı geçişte, çözümlenmiş Aggregate üzerinde çalışır. Her component örneğinin ek adlarını o örneğin Component türünün bildirilmiş yuva adlarıyla karşılaştırır ve her yakın eşleşme çifti için bir uyarı üretir.
Çıktı biçimi:
lint: attachment name is a near miss for a declared slot (Aggregate nearmiss, at .spec.components.db.features.app_user_passwrod, "app_user_passwrod", on component type "core/datastore/postgres", near the declared slot "app_user_password")Tırnak içindeki ilk değer, ekin altında yazıldığı addır; uyarının açılış cümlesi de bununla ilgilidir. Ardından gelen iki değer, ne olduklarını söyleyen sözcüklerle tanıtılır: ekin üzerinde bulunduğu Component türü ve ekin tek düzenleme uzaklığında bulunduğu bildirilmiş yuva.
Düzenleyicide görünürlük. Uyarı, dil sunucusu aracılığıyla düzenleyici tanılamalarına da uyarı önem düzeyinde ulaşır ve sorunlu ek anahtarının üzerinde konumlanır. Terminal çıktısını hiç okumayan bir yazar da çifti görür. Yapıt oluşturma aşamasından önce üretildiği için herhangi bir ayar gerektirmez: serve.build_on_inspect açık olsun ya da olmasın, bir düzenleyici oturumu onu gösterir.
Eşik ve getirdiği ödünleşim. Lint, adları yalnızca tek düzenleme uzaklığında ve yalnızca her iki ad da en az dört karakter uzunluğundaysa eşleştirir. Bu uzunluğun altında neredeyse her kısa ad diğer her addan tek düzenleme uzaklığındadır; bu yüzden onları eşleştirmek sinyal yerine gürültü üretir. Tek düzenlemenin üzerinde ise çiftler yazım hatalarına benzemez olur. Yer değiştirme iki değil tek düzenleme sayılır, çünkü yer değiştirmiş bir karakter çifti en yaygın hatadır ve daha katı bir sayım bunu kaçırırdı.
Yazım notu. Lint tavsiye niteliğindedir ve derlemenin sonucunu asla değiştirmez — derleyici, bir yazarın bir eke ne ad verdiğini denetlemez. Bir Feature’ı bilerek bir yuvaya benzeyen bir ad altında ekleyen yazar uyarıyı yok sayabilir; ek tam olarak yazıldığı gibi davranır.
Feature’ın yuvaya uyduğu durumda tetiklenmez. Eklenen Feature’ın selector’ını karşıladığı bir yuvaya tek düzenleme uzaklığındaki bir ad uyarıya yol açmaz. Bu eşleşme yanlış yazılmış bir serbest ek değil, başka bir ad altında yazılmış bir doldurmadır; önemli olup olmadığı yuvanın boş kalıp kalmadığına bağlıdır ve bu ancak her kapsam birleştirildikten sonra bilinir. Yuvanın boş kaldığı durumda derleme durur ve eki ve yuvayı adlandırır — bkz. fatal-halts.md içindeki “An attachment written under another name fits a slot its component leaves empty (Başka bir ad altında yazılmış bir ek, component’inin boş bıraktığı bir yuvaya uyuyor)” — dolayısıyla raporlanan tek bulgu bu durmadır, yanında asla bir uyarı olmaz. Yuvayı başka bir şey bağladığında ek sıradan, fazladan bir ektir ve hiçbir şey raporlanmaz. selector bildirmeyen bir yuvaya hiçbir Feature uymaz; bu yüzden böyle bir yuvaya yakın bir ad her zaman uyarıya yol açar.
Bir bağlantıda tetiklenmez. Lint, bir component’in açık olan kendi features: bloğunu okur. Bir bağlantının taşıdığı ekler, yalnızca soketinin bildirdiği yuvalarla anahtarlanır; bu yüzden bu yuvalardan birine tek düzenleme uzaklığındaki bir ad orada geçerli değildir: bunun yerine derleme durur ve durma, adın yakınında bulunduğu yuvayı aynı cümlede adlandırır. Yanında hiçbir uyarı üretilmez. Bkz. fatal-halts.md içindeki “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)”.
Uses-soketi yakın eşleşme lint’i
Şu durumda tetiklenir: bir bileşenin kendi uses: bloğu, Component türünün bildirilmiş usesSchema soketlerinden biri olmayan ama bunlardan birine tek düzenleme uzaklıkta olan bir soketi adlandırdığında; yani tek bir karakter eklenmiş, silinmiş ya da değiştirilmiş veya bitişik iki karakterin yeri değişmiş olduğunda. Soket adındaki bir yazım hatası bu biçimi alır ve lint, yazarın çifti görebilmesi için iki yazımı da belirtir.
Neden var? Bir soketi bildirmek, geliştiricinin kendi bileşenindeki uses: yüzeyini kapatmaz: hiçbir usesSchema girdisinin bildirmediği bir soket adı geçerlidir, çünkü kataloğun bir soket hakkında sessiz kalması bağlantının yasaklandığı değil öngörülmediği anlamına gelir ve Aggregate’in topolojisi geliştiriciye aittir. Bunun bedeli, yanlış yazılmış bir soket adının, yazarın kastettiği soketi bağlamak yerine kendi başına bir ad-hoc bağlantı hâline gelmesidir: derleme başarılı olur, amaçlanan soket yalnızca bağlanmadan kalır ve ad-hoc kenar hiçbir seçici ve hiçbir kenar başına sözleşme taşımaz. Lint, tam olarak bu durum için açıklanmış hafifletme önlemidir. Bir ad-hoc soketin neyden vazgeçtiği ve neyi koruduğu için bkz. entities/component.md “Topology Sockets: usesSchema”.
Hangi yüzeyi kapsar? Yalnızca bileşenin kendi uses: bloğunu; bildirilmemiş bir soket adının kabul edildiği tek yüzey budur. Bir Feature ekinin uses: alanı yalnızca eklenen Feature’ın bildirdiği bir soketi, bir Release’in kenar başına uses: alanı ise yalnızca tüketen Component’in bildirdiği bir soketi adlandırabilir; bunlardan herhangi birindeki yanlış bir ad derlemeyi zaten durdurur, dolayısıyla bir uyarının ekleyeceği bir şey yoktur.
İşlem hattındaki yeri. Lint, çözümleme aşamasında, kataloğa duyarlı anlamsal korumalarla aynı geçişte, çözümlenmiş Aggregate üzerinde çalışır. Her bileşen örneğinin kendi soket adlarını, o örneğin Component türünün bildirilmiş soket adlarıyla karşılaştırır ve her yakın eşleşme çifti için bir uyarı üretir. Bir alt aggregate’ten gelen bileşen kapsanmaz: onun iç bileşenleri, bu geçiş çalıştıktan sonra grafiğe katlanır.
Çıktı biçimi:
lint: uses socket name is a near miss for a declared socket (Aggregate aggregate, at .spec.components.web, "databses", on component type "core/devtool/adminer", near the declared socket "databases")Tırnak içindeki ilk değer, yazarın yazdığı soket adıdır; uyarının ilk cümlesi bununla ilgilidir. Ardından gelen iki değer, ne olduklarını söyleyen sözcüklerle tanıtılır: soketin adlandırıldığı Component türü ve tek düzenleme uzaklıkta olduğu bildirilmiş soket. Uyarının açıkça belirtmediği sonuç, yukarıda açıklanandır: yanlış yazılmış ad bir ad-hoc bağlantıdır, dolayısıyla hiçbir seçici ve hiçbir kenar başına sözleşme taşımaz ve yazarın kastettiği soket bağlanmadan kalır.
Editörde görünürlük. Uyarı, dil sunucusu aracılığıyla editör tanılamalarına da ulaşır; uyarı önem düzeyindedir ve sorunlu adı içeren uses: bloğunun ait olduğu bileşenin üzerinde konumlanır. Terminal çıktısını hiç okumayan bir yazar da çifti görür. Yapıt oluşturma aşamasından önce üretildiği için herhangi bir ayar gerektirmez: bir editör oturumu, serve.build_on_inspect açık olsun ya da olmasın onu gösterir.
Eşik ve getirdiği ödünleşim. Lint, adları yalnızca tek düzenleme uzaklığında ve yalnızca iki ad da en az dört karakter uzunluğunda olduğunda eşleştirir; bu, ek yuvası yakın eşleşme lint’inin aynı nedenle kullandığı sınırın aynısıdır. Bu uzunluğun altında neredeyse her kısa ad diğer her birine tek düzenleme uzaklıktadır, bu yüzden onları eşleştirmek sinyal yerine gürültü üretirdi; tek düzenlemenin üzerinde ise çiftler yazım hatasına benzemez. Yer değiştirme iki değil tek düzenleme sayılır, çünkü yeri değişmiş bir karakter çifti en yaygın hatadır ve daha katı bir sayım onu kaçırırdı.
Yazım notu. Lint tavsiye niteliğindedir ve derlemenin sonucunu asla değiştirmez; derleyici, yazarın bir sokete ne ad verdiğini denetlemez. Bildirilmiş bir sokete benzeyen bir ad altında bilerek ad-hoc bağlantı kuran bir yazar (bildirilmiş bir caches soketinin yanında, başka bir amaçla kurulan bir cache bağlantısı gibi) uyarıyı yok sayabilir; kenar tam olarak yazıldığı gibi davranır. Onu bastıracak bir bayrak yoktur ve gerek de yoktur: sonuç üzerinde hiçbir ağırlığı yoktur.
Bildirilmemiş provides anahtarı lint’i
Tetiklendiği durum: bir component örneğine bağlı Recipe, provides: altında, örneğin Component türünün spec.schema.provides: sözleşmesinde bildirmediği bir anahtar yayımladığında.
Neden var? Component’in bildirdiğinden fazlasını yayımlamak geçerlidir ve geçerli kalır: provides sözleşmesi alt kümeyi zorunlu kılar ve üst kümeye izin verir; dolayısıyla Component’inin sözleşmesini karşılayan ve bunun yanında ek anahtarlar üreten bir Recipe, sözleşmeyi yerine getiren bir Recipe’dir. Lint’in adlandırdığı şey, aksi takdirde iki taraftan da görünmeyen bir sonuçtur. Bir uses: kenarı üzerinden okuyan tüketici, hedefin Recipe’inin ürettiği her ne ise onu değil, hedefin bildirilmiş sözleşmesini görür. Recipes’i birbirinin yerine kullanılabilir kılan budur: bir Component’i gerçekleştiren iki Recipe tüketiciye aynı yüzeyi sunar ve bunların değiştirilmesi, tüketicinin bağımlı hâle geldiği bir anahtarı sessizce geri çekemez. Bu nedenle bildirilmemiş bir anahtar kenar üzerinden iletilmez ve onu okuyan tüketici şablonu hata vermek yerine boş bir değer üretir.
Bulgu, nedeninin bulunduğu yerde, yani anahtarı yayımlayan Recipe üzerinde bildirilir, çünkü adlandırılabileceği yer orasıdır. Tüketici tarafında anahtar, derleyicinin belirli bir hedefe atfedemediği bir şablon referansıdır ve tahmin yürüten bir tanılama hiç olmamasından daha kötü olurdu. Bu yüzden ikisi bilinçli olarak aynı yerde değildir: boş değer tüketicide, açıklama burada görünür ve ikisi de aynı derleme çıktısında yer alır.
Hangi eşleştirme karşılaştırılır? Bağlı Recipe’in yazılmış provides: anahtarları, Component türünün bildirilmiş spec.schema.provides: anahtarlarıyla karşılaştırılır. Bu bildirilmiş küme, bir inject: bloğu içindeki from: anahtarının denetlendiği kümeyle aynıdır; böylece ikisi bir Component’in neyi bildirdiği konusunda uyuşur. Karşılaştırma bir benzerlik testi değil, tam eşleşmedir; bu nedenle yukarıdaki iki yakın eşleşme lint’inin aksine eşiği yoktur ve ad eşleştirmez.
Karşılaştırılan Recipe, örneğin gerçekten bağlı olduğu Recipe’tir; işlemenin bağlamada kullandığı aynı örnek adı ve katalog türüyle eşleştirilir. Böylece Manifest’teki örnek başına bir Recipe geçersiz kılması ortalamada kaybolmaz, dikkate alınır. Türü hiçbir katalog Component’ine çözümlenmeyen bir component örneği atlanır: hiçbir bildirim okunmamıştır ve bu, hiçbir şey bildirmeyen bir bildirimle aynı şey değildir.
İşlem hattındaki yeri. Lint, çözümleme aşamasında, kataloğu dikkate alan anlamsal korumalarla aynı geçişte, çözümlenmiş Aggregate üzerinde çalışır; işleme (rendering) öncesinde çalıştığı için aggrega build komutunun yanı sıra aggrega validate --release komutunda da ortaya çıkar. Aggregate’in kökünde bildirilen Components ve alt sistemlerin içine yerleştirilmiş bileşenler kapsanır. Bir alt aggregate’ten gelen bileşen kapsanmaz: onun iç bileşenleri grafiğe bu geçiş çalıştıktan sonra katlanır; bu nedenle böyle bir bileşenin bildirilmemiş anahtarı tüketicilerden yine esirgenir, ancak onu adıyla belirten bir uyarı çıkmaz.
Çıktı biçimi. Her component örneği ve anahtar için, anahtarı yayımlayan Recipe’i ve onu bildirmeyen Component’i adlandıran bir satır:
lint: Recipe publishes a provides key its Component does not declare (Recipe broker-with-region, at .spec.provides.region, "region", on component type "core/ai-model/openai-compatible", bound to component instance "gateway")Bulgu onu taşıyan örneğe aittir; bu nedenle aynı bildirilmemiş anahtarı yayımlayan tek bir Component türünün on örneği, her biri kendi örneğini adlandıran bir değil on satır üretir. Her satır anahtarı yayımlayan Recipe’e atfedilir, çünkü sorunu çözmek için düzenleyeceğiniz belge odur. Tarama deterministiktir; bu nedenle aynı girdi her çalıştırmada aynı uyarı sırasını üretir.
Düzenleyicide görünürlük. Uyarı, dil sunucusu aracılığıyla düzenleyici tanılamalarına da uyarı önem düzeyinde ulaşır ve type: değeri Recipe’i bağlayan component örneğinin üzerinde konumlanır. Terminal çıktısını hiç okumayan bir yazar da onu görür. Yapıt işleme aşamasından önce üretildiği için bir ayara ihtiyaç duymaz: düzenleyici oturumu, serve.build_on_inspect açık olsun ya da olmasın onu gösterir.
Yazım notu. Lint yalnızca uyarı niteliğindedir ve derlemenin sonucunu asla değiştirmez; Component’inin bildirdiğinden fazlasını yayımlayan bir Recipe yine derlenir. Çözüm iki seçenekten biridir ve hangisinin doğru olduğuna yazar karar verir: tüketicilerin okuması amaçlanıyorsa anahtarı Component üzerinde bildirin; anahtar Recipe’in kendi çalışma durumuysa bildirilmemiş bırakın, bu durumda böyle bir durumun yeri locals:’tır. Tersi durum bir uyarı değildir: Recipe’inin yayımlamadığı bir anahtarı bildiren bir Component, sözleşmeyi karşılanmamış bırakır ve derlemeyi durdurur.
Ghost Infrastructure Tracker uyarıları
Ne zaman tetiklenir: bir yazarın bildirdiği bir anahtar bir düğüme ulaştığında ve bağlı Recipe’in bildirdiği hiçbir şablon ona hiç başvurmadığında. Okunmayan anahtarlar sessiz altyapıya dönüşür: geliştiricinin veya operatörün istediği, ancak Recipe’in işlenmiş çıktıya hiç bağlamadığı yapılandırma. İzleyici bunları görünür kılar; böylece yazılan ile çıktının taşıdığı arasındaki tutarsızlık sessiz kalmak yerine görünür olur.
Hangi yazılmış anahtarlar karşılaştırılır. Düğüm başına üç grup:
.values— düğümün kendi geliştirici tarafı sütunu..infra— düğümün kendi operatör tarafı sütunu..context.uses.<alias>.values— düğümün üzerinden tükettiği heruses:kenarında taşınan bağlantı başına değerler. Bu grup kendiliğinden tüketici kapsamlıdır: bir düğümünusesharitası yalnızca kaynağı olduğu kenarları tutar; bu nedenle okunmayan bir bağlantı başına değer her zaman onu yazan düğüme atfedilir, asla kenarın hedefine atfedilmez.
Hangi başvurular toplanır. Bağlı Recipe’in bildirdiği her şablon. Uyarı, bir anahtarın hiçbir şey tarafından okunmadığını söyler; bu, Recipe’in tamamı hakkında bir iddiadır, dolayısıyla Recipe’in tamamından daha dar herhangi bir kapsam uyarıyı yaklaşık değil yanlış kılardı — bir source: koordinatının tükettiği bir anahtar, adını verdiği sürümü getiren çalıştırmanın ta kendisi tarafından okunmamış olarak raporlanırdı. Okunan bloklar şunlardır:
valuesMapping:, sağlayıcıya verilen değerler katmanı.source:— tek bir dize olarak yazıldığında alanın tamamı, nesne olarak yazıldığında ise dize değerli her alanı. Bir kaynak koordinatı, tüketen her örnek için değerlendirilen bir şablondur; bu nedenle.valuesveya.infraiçinden seçilen bir sürüm, chart adı, git başvurusu veya modül alt dizini bu anahtarları okur.locals:veprovides:, her girdi.assertions:, her girdi.workload:, sentezlenen Workload gövdesi.artifacts:, her girdinin içeriği.pipeline:, her adımınwith:girdisi vewhen:koşulu.
Bunu üç sınır izler ve üçü de birer tercih değil, dürüstçe iddia edilebilecek olanın sınırlarıdır. Her biri okumayı genişletmek yerine susturur; bu en az maliyetli yöndür: raporlanmayan bir anahtar okuyucuya, Recipe’i okuyarak yine de bulabileceği bir uyarıya mal olur; yanlış raporlanan bir anahtar ise ona çalışan bir ayarın yok sayıldığını söyler.
- Satır içi
valuesMapping:içermeyen bir Recipe hiç okunmaz. Diğer şablonları ne yaparsa yapsın, anahtarları raporlanmak yerine atlanır. - Recipe’in bir dosyadan veya bir kütüphane başvurusundan içe aktardığı bir blok bu noktada elde değildir, dolayısıyla başvuruları toplanamaz. Düğümün anahtarları raporlanmak yerine tamamen atlanır — bu, içe aktarılan bir
valuesMapping:, içe aktarılan birworkload:ve içe aktarılan birartifacts:girdisi için aynı şekilde geçerlidir. - Ayrıştırılamayan bir şablon hiçbir başvuru kümesi üretmez. Her anahtarı okunmamış olarak raporlamak, değerlendirmenin aynı şablon için ürettiği ayrıştırma tanılamasını gölgede bırakırdı; bu nedenle bunun yerine hiçbir şey raporlanmaz. Bir
artifacts:girdisi standart{{ }}sınırlayıcılarıyla okunur; bu, her sağlayıcının o alan için bildirdiği çift değildir; yanlış çiftle okunan böyle bir gövde, yazarının hiç yazmadığı başvurular üretir ya da ayrıştırılamaz ve her iki sonuç da yalnızca bir uyarıyı susturur.
Bir soketin valueSchema alanı asla işaretlenmez. usesSchema.<socket>.valueSchema, bağlantı başına bir değerin karşılaması gereken sözleşmeyi bildirir. Bu bir şemadır, yazılmış bir örnek değildir ve karşılaştırılan girdiler arasında yer almaz — bu nedenle asla raporlanamaz. Bir soketin bildirilen varsayılanının ürettiği ise diğerleri gibi bir örnektir ve kendi durumuna göre okunmuş ya da okunmamış sayılır.
Bir sütunun tamamını adlandıran bir başvuru, altındaki her anahtarı okunmuş sayar. {{ .infra.port }}, port anahtarını okunmuş olarak işaretler ve sütunun diğer anahtarlarını uyarı için uygun bırakır. {{ optional .infra `port` 8080 }} ise .infra haritasının tamamını bir fonksiyona verir; böylece toplanan başvuru altındaki bir anahtarı değil sütunu adlandırır, o sütundaki her anahtar okunmuş sayılır ve sütun hiçbir uyarı üretmez. Aynısı bir sütun üzerinde range ile dolaşmak ve bir uses girdisine index ile ulaşmak için de geçerlidir. Anahtar başına kapsam isteyen bir Recipe yazarı anahtar başına başvurular yazar.
Bu, yukarıdaki her bloğa uzanır ve sessiz bir sütunu kaçırılmış bir uyarı olarak yorumlamadan önce bilinmeye değerdir: source: sürümü {{ optional .infra `source_version` "1.2.3" }} olarak yazılan bir Recipe, .infra haritasının tamamını bir fonksiyona vermiştir; bu nedenle o Recipe, işlediği hiçbir düğümdeki hiçbir .infra anahtarı hakkında hiçbir şey raporlamaz. .values sütunu etkilenmez — ikisi ayrı sayılır.
İşlem hattındaki yeri. İzleyici, temel işleme aşamasında şablon değerlendirmesiyle birlikte çalışır. Recipe’in her şablonu ayrıştırılır ve başvurduğu nokta nitelikli alan yollarını (.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget) toplamak için dolaşılır; her grubun çözümlenmiş anahtar kümesi bu başvuruların birleşimiyle karşılaştırılır ve fark, okunmamış kümedir. Dolaşılan, yazıldığı haliyle Recipe’tir: bir source: koordinatı, o şablonun bu örnek için ürettiği değer olarak değil, şablon metni olarak okunur.
Çıktı biçimi. Okunmayan her anahtar için bir satır; düğümü, grubun yolunu, anahtarı ve hiçbir şablonu onu okumayan Recipe’i adlandırır:
warning: node "data.main-db": .values key "database_name" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "data.main-db": .infra key "storage_class" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "frontend": .context.uses.my-api.values key "retry_budget" is read by no template in recipe "helm-web-ui-sourced-with-artifacts" — correct the spelling, or remove the keySatır Recipe’in hiçbir alanını adlandırmaz ve bu kasıtlıdır: anahtarı yazan kişi geliştirici, operatör ya da anahtarın üzerinde taşındığı uses: kenarının yazarıdır ve hiçbiri Recipe’i düzenlemez. Başvurunun arandığı bloğu adlandırmak, bu okuyucuya açmadığı bir belgedeki bir koordinatı vermek olurdu. Satırın sunduğu iki çözüm, onların uygulayabileceği iki çözümdür — yanlış yazılmış bir anahtar yaygın nedendir ve hiçbir zaman okunmayacak bir anahtar silinmeye değerdir.
Sıra sabittir: önce düğümün .values grubu, ardından .infra grubu, ardından kenarların üretildiği sırayla her uses takma adı; anahtarlar her grup içinde sıralanır. Bu nedenle aynı girdi her çalıştırmada aynı uyarı dizisini üretir.
Düzenleyicide görünürlük. Uyarı, düzenleyici tanılamalarına yalnızca dil sunucusunun bir IR grafiğini incelerken yapıt işleme aşamasını çalıştırdığı durumlarda ulaşır — aggrega serve --build-on-inspect ya da bu bayrağın geçersiz kıldığı, varsayılan olarak kapalı olan serve.build_on_inspect yapılandırma anahtarı. Bu ayar, bir derlemenin işleme sırasında ürettiği uyarıları ekler; derlemeyi durduran denetimlerin hiçbirini eklemez. Girdi bir yazım anahtarını değil bir düğümü adlandırdığından Aggregate’in kind: anahtarı üzerinde gösterilir.
Neden ölümcül bir durdurma değil de uyarı. Geliştiriciler koşullu şablon mantığında meşru olarak farklı .values alt kümelerini tüketebilir — şablonu .values.mode üzerinde dallanan bir Recipe mode anahtarını okur, ancak .values.replication_password anahtarını yalnızca mode == "replication" olduğunda koşullu olarak okur. Statik dolaşma, başvurulmayan bir anahtarın önemsiz mi yoksa bir hata mı olduğunu ayırt edemez. İzleyicinin amacı tutarsızlığı denetlemek değil görünür kılmaktır; sessiz atlama, izleyicinin önlediği hata biçimidir.
Recipe yazarının yanıtı. Bir Recipe yazarı, Recipe’in tüketmesini beklediği bir anahtar için Ghost Infrastructure uyarısı gördüğünde çözüm, anahtarı şablona bağlamaktır. Okunmayan anahtar kasıtlı bir atlama olduğunda (chart’ın desteklemediği bir özellik, Recipe’in kasıtlı olarak yok saydığı bir yazım kolaylığı), yazar bu atlamayı Recipe’in başlık yorumunda belgeleyebilir; böylece gelecekteki okuyucular tutarsızlığın kasıtlı olduğunu bilir.
Okunmayan bildirilmiş parametre uyarıları
Şu durumda tetiklenir: bir Aggregate spec.parameters: altında bir girdi bildirir ve o Aggregate’in kendi metnindeki hiçbir {{ .parameters.<key> }} başvurusu onu okumaz.
Bildirilmiş bir parametre, Release başına bir değeri değiştirmek için kullanılan yazım yüzeyidir: Release bildirimi karşılar ve bir başvuru karşılanan değeri ait olduğu bileşen değerlerine taşır. Hiçbir şeyin okumadığı bir bildirim, bu değişikliğin varacağı bir yer bırakmaz; Release onun için ne sağlarsa sağlasın, işlenen çıktı aynıdır. Bu, hiçbir şeyin tüketmediği yazılmış bir values anahtarının taşıdığı aynı kusurun parametre kapsamlı biçimidir.
Varsayılan değer bir muafiyet değildir. Hiçbir başvurunun okumadığı bir varsayılan değer, Release tarafından sağlanan bir değerden daha fazla çıktıya ulaşmaz; bu nedenle varsayılan değeri olan bir bildirim, yalın bir bildirimle tam olarak aynı biçimde raporlanır.
Hangi başvurular toplanır. Aggregate’in kendi metni ve başka hiçbir şey. Bunun üç sonucu vardır:
- Yalnızca bir Component şemasının
validate:yüklemiyle erişilen bir parametre burada görünmez. Böyle bir yüklem parametreyi Aggregate’teki noktalı bir başvuru yerine çözümlenmiş parametre eşlemi üzerinden adlandırır; bu nedenle yüklem onu okusa bile bildirim okunmamış olarak raporlanır. - Şablon olarak ayrıştırılamayan metin hiçbir başvuru kümesi üretmez. Her bildirimi okunmamış olarak raporlamak, enterpolasyonun aynı metin için ürettiği tanılamayı gömer; bu nedenle bunun yerine hiçbir şey raporlanmaz.
parameterseşleminin tamamını adlandıran bir başvuru (onu yinelemek ya da bir girdisine index aracılığıyla erişmek) her bildirimi okunmuş sayar; çünkü toplanan başvuru bu durumda altındaki bir anahtarı değil eşlemin kendisini adlandırır ve anahtar başına bir iddiada bulunulamaz.
İşlem hattındaki yeri. Okuma, çözümleme aşamasında, Aggregate’in ham metni ve bildirilmiş parametre sözleşmesi üzerinde, işlemeden önce çalışır. Bu nedenle aggrega build komutunun yanı sıra aggrega validate komutundan da ortaya çıkar.
Çıktı biçimi. Okunmayan her bildirim için, Aggregate’i ve bildirimin konum belirtecini adlandıran bir satır:
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")Bulgular, Aggregate’in parametrelerini bildirdiği sırayla gelir; böylece aynı Aggregate her çalıştırmada aynı diziyi üretir. Her biri, sorunlu anahtarı adlandıran bildirimin konum belirtecini taşır. İleti de anahtarı adlandırır; bu yüzden anahtar, konum belirtecini de yazdıran bir terminal satırında iki kez görünür: bir düzenleyici iletiyi yerleştirdiği konumda gösterir ve konum belirteci metnini hiçbir zaman göstermez; dolayısıyla anahtarı dışarıda bırakan bir ileti, okunmayan her bildirim için aynı okunurdu.
Düzenleyicide görünürlük. Bu öneri, dil sunucusu aracılığıyla, uyarı önem derecesinde düzenleyici tanılamalarına da ulaşır ve Aggregate’in tamamı yerine konum belirtecinin adlandırdığı bildirimin üzerine konumlandırılır. Yapıt işleme aşamasından önce üretildiği için herhangi bir ayar gerektirmez: bir düzenleyici oturumu, serve.build_on_inspect açık olsun ya da olmasın onu gösterir.
Neden ölümcül bir durdurma değil de uyarı. Bir parametre, onu okuyacak başvurudan önce bildirilebilir ve statik bir tarama bunu bir hatadan ayırt edemez; yazılmış anahtar okumasının yalnızca öneride bulunmasının nedeni de budur. Derleyici, bir yazarın hangi ayarları dışa açtığını denetlemez.
Provider bağlamasında karşılanmayan yetenek uyarısı
Şu durumda tetiklenir: çalışma alanı yapılandırmasında plugins.providers altındaki bir girdi bir capability adlandırıp hiçbir uri adlandırmadığında ve derlemenin okuduğu provider plugin’lerinden hiçbiri o yeteneği karşılamadığında. Bir derlemenin okuduğu plugin’ler; katalog dizinlerindekiler, derleyicinin içindeki provider’lar ve kilit dosyasının kaydettiği plugin’lerdir.
Neden var? Bir bağlama yalnızca bir Recipe’nin capability: alanı onun yeteneğini istediğinde okunur ve hiçbir plugin adlandırmayan bir girdi, yeteneğin çözümlemesinin onsuz da seçmeyeceği hiçbir şeyi seçmez. Bu nedenle yeteneği yanlış yazılmış bir girdiye — helm yerine hlem — hiçbir şey başvurmaz ve girdi hiçbir şeyi değiştirmez; bu uyarı olmasaydı bunu hiçbir şey söylemezdi.
Neden ölümcül bir durdurma değil de uyarı? Bağlamalar tüm çalışma alanı için bir kez yazılır, oysa bir derleme tek bir Release’e aittir. Yeteneği karşılayan plugin, çalışma alanında yalnızca başka bir Release’in okuduğu bir plugin olabilir ve bu derleme onu göremez; dolayısıyla burada bir durdurma, geçerli bir çalışma alanını bir tahmine dayanarak reddetmiş olurdu. Bir plugin de adlandıran bir girdi farklı bir durumdur: bir pull, bir Recipe kullansın ya da kullanmasın bu tür her girdiyi çözümler; böylece derleme plugin’e sahip olur ve neyi karşıladığını bilir, o plugin’in karşılamadığı bir yetenek ise durdurmaya yol açar — bkz. fatal-halts.md “A plugins.providers binding names a plugin that does not serve the capability (Bir bağlama, yeteneği karşılamayan bir plugin adlandırıyor)”. Derlemenin okuduğu bir plugin’in karşıladığı bir yetenek için yazılmış girdi, bu Release’teki bir Recipe onu kullansın ya da kullanmasın hiçbir şey olarak raporlanmaz.
İşlem hattındaki yeri. Bir Release’in her derlemesi ve her doğrulaması, birleştirilmiş çalışma alanı yapılandırmasındaki her girdiyi — katmanları ve onların providers_append eşlikçilerini birlikte — Release’in grafiği analiz edilmeden önce okur; bu nedenle uyarı aggrega build komutunun yanı sıra aggrega validate --release komutundan ve ayrıca, Release’in bir derlemesinin getirdiği dış girdileri keşfetmek için Release’i yazmak üzere olduğu kilit dosyası üzerinden bir kez işleyen aggrega pull komutundan da ortaya çıkar. Bu değerlendirme, bir Recipe’yi hangi plugin’in işlediği konusunda hiçbir şeyi değiştirmez; bu bilgi kilit dosyasından okunur.
Çıktı biçimi. Birleştirilmiş listenin taşıdığı sırayla her girdi için bir satır; yeteneği ve varsa bir düzenleme uzaklıktaki karşılanan bir yeteneği adlandırır:
warning: plugins.providers entry names a capability no provider-rendering plugin the build reads serves: capability "hlem", which is one edit from "helm"; the entry names no plugin, so it selects nothing a Recipe would not resolve without it, and none of the plugins this build reads — in the catalog directories, inside the compiler, or among those the lockfile records — serves the capability: correct its spelling, or keep it where the plugin serving it is one only another Release readsEşik. Bir yazım yalnızca bir düzenlemelik uzaklıkta ve yalnızca her iki ad da en az dört karakter uzunluğunda olduğunda önerilir; bu, yukarıdaki yakın eşleşme lint’lerinin kullandığı sınırla aynıdır ve aynı nedene dayanır.
Düzenleyicide görünürlük. Uyarı, dil sunucusu aracılığıyla düzenleyici tanılamalarına uyarı önem düzeyinde ulaşır. Girdi, düzenlenen belgede değil yapılandırma dosyasında bulunduğundan bir anahtarın üzerine değil o belgenin başına yerleştirilir.
Varlık başına metadata kapsamı
Hangi varlık zarflarının metadata.labels ve metadata.annotations taşıdığı türe göre değişir. Component, Feature ve kütüphane türleri ikisini de taşır; Aggregate yalnızca etiketleri taşır; Recipe, FeatureRecipe, Manifest, Release ve Plugin zarf düzeyinde bu anahtarların hiçbirini kabul etmez. Dilin durumu varlık başına durumu içerir ve başvurulacak kaynak odur.
Düzenleyicide görünürlük. Hiçbir ayarda bunu kapsayan bir uyarı yoktur: bildirilecek bir şey yoktur, çünkü bir varlık ya bu anahtarları taşır ya da kabul etmez; bir türün kabul etmediği anahtar ise oluşturma aşamasının sonradan bildirdiği bir şey değil, belge yüklendiğinde şemasının yanıtladığı bir sorudur. Yazar bir uyarı beklemek yerine durum sayfasına bakar.
Desteklenmeyen alan uyarıları
Hedefin karşılayamadığı, sizin yazdığınız her şeyi tek bir sınıf kapsar. Bu sınıfın iki üyesi vardır — hedefin ifade edemediği bir Workload alanı ve hedefin uygulamadığı bir aggrega.ai/ ek açıklaması — ve ikisi tek bir sınıf kodunu ve tek bir bastırma bayrağını paylaşır; çünkü “bu hedefin yok saydığı şeyleri” susturmak isteyen bir yazar, bunları tek tek anahtarlarla değil, birlikte susturmak ister.
Hedefin ifade edemediği bir Workload alanı
Hedeflerin aslına uygunluk düzeyleri farklıdır. Bir hedefin yerel olarak ifade ettiği bir Workload alanının başka bir hedefte karşılığı olmayabilir — örneğin Docker Compose’da zamanlama kısıtı, hizmet hesabı veya öncelik sınıfı kavramı yoktur. Bir Workload böyle bir alan bildirdiğinde ve hedef onu ifade edemediğinde, alan bir uyarıyla atlanır; yazılan her alan için bir uyarı verilir. Alan ne sessizce düşürülür ne de ölümcül hata olarak ele alınır.
Ölümcül duruştan farkı ayrıntı düzeyidir. Desteklenmeyen bir biçim derlemeyi açıkça durdurur — hedef o şekilde bir iş yükünü hiç üretemez. İfade edilemeyen bir alan taşıyan desteklenen bir biçim ise o alan olmadan işlenir ve bunu bildirir.
compose hedefinde sınıf şu anda scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, kapsayıcı düzeyindeki runAsNonRoot ve nvidia.com/gpu dışındaki her genişletilmiş kaynak anahtarını — örneğin amd.com/gpu — kapsar; çünkü o anahtar NVIDIA GPU’ları için ayrılmıştır. Aşağıdaki durumlar aynı sınıfın kısmi bir türünü üretir; bunlarda alan kaldırılmaz, indirgenir:
persistentTemplate— kopya başına birim şablonlama kullanılamaz, bu nedenle birim ortadan kalkmak yerine tek bir paylaşılan kalıcı birime indirgenir.as: enviçeren bir kapsayıcıattachmentsgirdisi — compose bir ortam değişkenini bir eklentiden besleyemez, bu nedenle değişken boş bir değerle üretilir. Uyarı, girdiyi yazıldığı koordinatla adlandırır (containers.<name>.attachments.<KEY>ya da konumsal bir init girdisi içininitContainers[<i>].attachments.<KEY>); böylece hangi değişkenin boş geldiği ve hangi kapsayıcıya ait olduğu açıkça görülür.as: fileiçeren bir girdi normal şekilde bağlanır ve hiçbir uyarı üretmez.- Hiçbir kapsayıcının bağlamadığı bir
volumesgirdisi — uyarı, birimi yazıldığı koordinatla adlandırır (volumes.<name>). Çıktıya neyin ulaştığı türe bağlıdır:persistentveyapersistentTemplatebirimi yine de adlandırılmış bir birim olarak bildirilir, ardından oluşturulur ve kullanılmadan kalır;configmap,secretveyaephemeralbirimi ise çıktıya yalnızca bir kapsayıcının bağlama noktası üzerinden ulaşır, dolayısıyla onu bağlayan bir şey olmadığında bildirim hiçbir çıktı üretmez. Her iki durumda da yazdığınız birim hiçbir işe yaramaz: onu bir kapsayıcıdan bağlayın ya da kaldırın. İş yükünün init kapsayıcıları dahil her kapsayıcısı bağlayıcı sayılır, bu nedenle yalnızca bir init kapsayıcısının bağladığı bir birim hiçbir uyarı üretmez. - Birden fazla yoklama yuvası bildiren bir
healthbloğu — bir compose hizmeti tek birhealthchecktaşır, bu nedenlelive > ready > startupöncelik sırası tek bir yuvayı korur ve bildirilen diğer her yuva çıktının hiçbir bölümüne ulaşmaz. Uyarı, bloğu yazıldığı koordinatla adlandırır (containers.<name>.healthya da konumsal bir init girdisi içininitContainers[<i>].health) ve hem çevrilen yuvayı hem de düşürülen yuvaları adlandırır; böylece çıktıda hangi yoklamanın etkin olduğu ve hangi yazılmış niyetin etkisiz kaldığı açıkça görülür. Tek bir yuva bildiren bir blok kayıpsız çevrilir ve hiçbir uyarı üretmez. initContainersde bildiren bir iş yükündekihostNetwork— iş yükünün kendi hizmeti düğümün ağında çalışır, ancak her init kapsayıcısı sınır ağına kendi başına katılan ayrı bir hizmete dönüşür; çünkü ana hizmetin ad alanını paylaşmak, ana hizmetin onu beklemesini döngüsel hâle getirirdi. Bu, her kapsayıcının tek bir ad alanını paylaştığı, modellenen pod şeklinden daha dardır; bu nedenle fark, çalışma zamanında bulunmaya bırakılmak yerine adlandırılır. Init kapsayıcısı olmadanhostNetworkbildiren bir iş yükü kayıpsız çevrilir ve hiçbir uyarı üretmez.
Hedefin uygulamadığı bir ek açıklama
aggrega.ai/ ek açıklamaları, bir sağlayıcının okuyup işlediği şeye uyguladığı platform yönergeleridir — bir ad alanı, bir kayıt defteri öneki, bir hizmet hesabı. Bir sağlayıcının bunlardan hangilerini okuduğu, o sağlayıcının girdi türü başına yaptığı kendi bildirimidir; çünkü kendi sentezlediği bir dağıtım biriminin her alanına sahip olan bir sağlayıcının, dışarıdan alınmış bir yapıtı işlerken aynı değeri koyacak bir yeri çoğu zaman yoktur. Matris Well-Known Annotations sayfasındadır.
Bir düğümün kendi Recipe’i ve o düğüme eklenen her özellik ayrı ayrı işlenir; her biri kendi capability: anahtarının adlandırdığı hedef üzerinden ve kendi source:, workload: ve artifacts: anahtarlarının bildirdiği girdi türlerinde işlenir. Böyle bir ek açıklama bu işlemelerden birine ulaştığında ve çözümlenen hedefin bildirimi anahtarı o işlemenin bildirdiği girdi türlerinin hiçbirinde kapsamadığında, hedef o anahtar için hiçbir şey uygulamaz ve derleme, anahtarı, hedefi ve o işlemenin bildirdiği her girdi türünü adlandıran bir uyarıyla bunu bildirir:
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored itAşağıdaki sonuçlar, ek açıklamaların bir işlemeye nasıl ulaştığından kaynaklanır ve her biri bilinçlidir:
- Yazılmış tek bir satır birden fazla uyarı üretebilir. Bir sınır ek açıklaması altındaki her bileşene yayılır ve bu bileşenler farklı hedefler ve farklı girdi türleri üzerinden işlenebilir. Her uyarı tek bir işleme hakkında doğru bir ifadedir; bu nedenle anahtarı uygulayamayan her işleme için bir uyarı alırsınız — bu da çıktınızın hangi bölümlerinin etkilendiğini size söyleyen şeydir.
- Bir düğüme eklenen bir özellik, düğümün Recipe’ine göre değil, kendi FeatureRecipe’ine göre değerlendirilir. Kendi kaynaklarını üreten bir eklenti, bunları FeatureRecipe’inin adlandırdığı hedef üzerinden, o FeatureRecipe’in bildirdiği girdi türlerinde işler — bu nedenle düğümün kendi hedefinin uyguladığı bir ek açıklama, eklentinin dosyalarında hiçbir şeye ulaşmayabilir; tersi de geçerlidir. Her biri hakkında ayrı ayrı bilgilendirilirsiniz, çünkü bunlar farklı dosyalardır. Aynı durum, adlandırılmış bir bileşen yerine bir sınıra eklenen bir özellik için de geçerlidir. FeatureRecipe’i
source:,workload:veartifacts:anahtarlarının hiçbirini bildirmeyen bir eklenti kendi dosyasını işlemez — değer enjekte ederek, Feature’ının taşıdığıuseskenarıyla ya da başka bir şeyin ürettiği belgeler üzerinde çalışan bir işlem hattıyla katkıda bulunur — bu nedenle bir ek açıklamanın eksik kalabileceği kendine ait bir çıktı yoktur ve onun için hiçbir uyarı verilmez. - Birden fazla girdi türü bildiren bir işleme, bunların hepsine göre değerlendirilir. Bildirilen türler toplama yoluyla birleşir ve çıktıları bir araya eklenir; bu nedenle anahtarı bunlardan herhangi birinde okuyan bir hedef onu uygular ve değer işlenmiş çıktıda görünür. Bu durumda hiçbir uyarı verilmez, çünkü bildirilecek bir şey yoktur. Uyarı yalnızca bildirilen her tür anahtarı kaçırdığında görünür ve hepsini adlandırır —
on sourced or synthesized input. - Yalnızca yalın
aggrega.ai/anahtarları denetlenir. Alt önekli bir anahtar —compliance.aggrega.ai/data-classya da kendiacme.aggrega.ai/teamanahtarınız — sizin sözcük dağarcığınızdır ve derleyici onu yorumlamadan taşır. Böyle bir anahtar için hiçbir zaman uyarı verilmez. - Hiçbir destek beyanı bildirmeyen bir hedef hiçbir uyarı üretmez. Uyarı, yazdığınız şeyi sağlayıcının okuduğunu söylediği şeyle karşılaştırır; hiçbir şey söylememiş bir sağlayıcı karşılaştırılacak bir şey sunmaz ve sessizlikten bir ret çıkarmak, sağlayıcının yazarının hiç yapmadığı bir beyanı bildirmek olurdu. Anahtarların hiçbirini okumayan bir sağlayıcı bunu,
terraformgibi,readsNoWellKnownAnnotations: trueile söyler; bu durumda işlemelerinden birine ulaşan her yalın anahtar için uyarı verilir.
Neden durdurma değil de uyarı. Farklı türde hedeflerdeki bileşenleri meşru olarak kapsayan bir sınırda, belirli bir anahtarı uygulayamayan bir düğüm her zaman bulunur — bu bir hata değil, birden fazla hedefi kapsayan bir Release’in olağan şeklidir — bu nedenle derlemeyi reddetmek doğru Releases’i reddetmek olurdu. Değer dokunulmadan geçer ve uyarı size bunu söyler.
Sınıf kodu ve bant dışı güvence
Her uyarı, kararlı ve makine tarafından eşleştirilebilir unsupported-field sınıf kodunu taşır; böylece araçlar ileti metnini ayrıştırmak yerine sınıfı eşleştirebilir. Sınıfın her üyesi (tamamen çıkarılan alan, indirgenmiş biçimli alan ve uygulanmayan ek açıklama) bu tek kodu taşır ve tek bir filtrenin tüm sınıfı bastırabilmesini sağlayan da budur. Uyarılar işlenmiş yapıtlardan bant dışı olarak iletilir; bu da uyarılar görünse de görünmese de işlenmiş baytların bayt bayt aynı olduğu anlamına gelir: uyarıları bastırmak çıktınızı değiştiremez.
Düzenleyicide görünürlük. Sınıfın her üyesi, düzenleyici tanılamalarına yalnızca dil sunucusunun bir IR grafiğini incelerken yapıt işleme aşamasını çalıştırdığı durumlarda ulaşır: aggrega serve --build-on-inspect ya da bu bayrağın geçersiz kıldığı, varsayılan olarak kapalı olan serve.build_on_inspect yapılandırma anahtarı. Bu ayar, bir derlemenin işleme sırasında ürettiği önerileri ekler; bir derlemenin durduğu denetimlerin hiçbirini eklemez. Yukarıdaki sınıf kodu, terminal satırında olduğu gibi yayımlanan tanılamada da taşınır; böylece bir düzenleyici istemcisi, yazarın okuduğu sınıfın aynısını eşleştirir. Her girdi bir yazım anahtarı yerine bir düğümü ve bir hedefi adlandırdığından Aggregate’in kind: anahtarı üzerinde gösterilir.
Sınıfı bastırma
İşleme yapan her iki komut da --no-unsupported-field-warnings bayrağını kabul eder; bu bayrak yalnızca bu sınıfı susturur, diğer tüm işleme uyarıları görünmeye devam eder:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warningsBayrak yalnızca görüntülemeyi etkiler ve işlenmiş çıktıyı değiştirmez. aggrega lint komutunun eşdeğer bir bayrağı yoktur, çünkü bu komut hiçbir işleme geçişi çalıştırmaz: yalnızca yayımlama uzlaşımlarını denetler, dolayısıyla orada hiçbir işleme uyarısı ortaya çıkamaz.
Bayrağı, düşük doğruluğu bilerek kabul ettiğinizde kullanın; örneğin üretim Workload’unun zamanlama ve hizmet hesabı alanlarının etkisiz kalmasının beklendiği, yerel geliştirme için kullanılan bir compose hedefinde. Aksi durumlarda kapalı bırakın: yazdığınız bir alanın hedefe ulaşmadığını uyarı sayesinde öğrenirsiniz.
Hassas olarak bildirilmiş bir değer sabit değer olarak taşınıyor
Şu durumda tetiklenir: bir ek, şemasının hassas olarak bildirdiği bir veriyi bir teslim anahtarına, hedefin dağıtım sırasında çözümlediği bir başvuru olarak değil, sabit değer olarak teslim ederek bir yuvayı doldurduğunda.
Çıktı biçimi. Teslim anahtarı başına bir satır; ek örneğini, anahtarın düştüğü teslim mekanizmasını ve anahtarın kendisini adlandırır ve onu işleyen düğüme ve hedefe atfedilir:
warning: node "db" (provider "compose"): attachment "user_password" delivers a value declared sensitive to env delivery key "MARIADB_PASSWORD" as a literal; where the target supports it, fill the slot with an attachment that delivers a reference insteadSınıf kodu. Uyarı, kararlı ve makineyle eşleştirilebilir sensitive-by-value sınıf kodunu taşır; böylece araçlar ileti metnini ayrıştırmak yerine sınıfı eşleştirir. Kod, terminal satırında ve dil sunucusunun yayımladığı yapılandırılmış tanılamada taşınır; böylece bir yazar ile bir düzenleyici istemcisi aynı sınıfı okur — dil sunucusunun bu uyarıyı yayımlayıp yayımlamayacağını belirleyen, aşağıdaki düzenleyici görünürlüğü koşulu altında.
Düzenleyici görünürlüğü. Uyarı, düzenleyici tanılamalarına yalnızca dil sunucusunun bir IR grafiğini incelerken yapıt işleme aşamasını çalıştırdığı yerde ulaşır — aggrega serve --build-on-inspect ya da bu bayrağın geçersiz kıldığı, varsayılan olarak kapalı olan serve.build_on_inspect yapılandırma anahtarı. Bu ayar, bir derlemenin işleme sırasında ürettiği uyarıları ekler; bir derlemeyi durduran denetimlerin hiçbirini eklemez. Giriş bir yazım anahtarı yerine bir düğümü ve bir hedefi adlandırır; bu nedenle Aggregate’in kind: anahtarı üzerinde gösterilir.
Kendi başına bir sınıftır ve --no-unsupported-field-warnings onu kapsamaz. Bu bayrak yukarıdaki unsupported-field sınıfını susturur; bu uyarı onunla birlikte görünmeye devam eder. Bu uyarıyı susturan bir bayrak yoktur.
Derleme başarılı olur ve işlenmiş baytlar değişmez. Uyarı, unsupported-field sınıfında olduğu gibi işlenmiş yapıtlardan bant dışı taşınır; bu nedenle satır görünse de görünmese de çıktınıza ulaşan aynıdır.
Hassas olarak bildirilmiş bir değer hedefe bir values eşlemesi üzerinden ulaşır
Şu durumda tetiklenir: bir source: üzerinden yapılan render, hedefine bir valuesMapping: çıktısını verirken, bu eşlemenin değerlerini okuduğu varlık bir values yaprağını hassas olarak bildirir: bir Recipe’in, Component’inin bildirdiği bir yaprak üzerindeki eşlemesi ya da bir bileşene eklenmiş bir Feature’ın FeatureRecipe’inin, o Feature’ın bildirdiği bir yaprak üzerindeki eşlemesi. Bir eşleme, çıktı anahtarlarını kendisi uyduran tek bir şablondur; bu nedenle hiçbir bildirim bu anahtarların hiçbirini adlandırmaz ve hedef, yaprak için anahtar başına hassasiyet işareti almaz. Bu, bir bildirimin hiçbir render edilmiş anahtara ulaşmadığı, ancak yazarın üzerinde hâlâ bir kaldıraç tuttuğu tek render biçimidir.
Çıktı biçimi. Bildirilmiş her yaprak için bir satır; yaprağı yazıldığı koordinatta ve eşlemesi birleştirmeyi denetleyen Recipe’i ya da FeatureRecipe’i adlandırır ve onu render eden düğüme ve hedefe atfedilir. Eklenmiş bir Feature’ın satırı, eklendiği adla başlar; çünkü bir bileşen bir Feature’ın birkaç eklentisini taşıyabilir ve aksi takdirde satırları aynı olurdu. Aşağıdaki ikinci satır, api bileşenine token olarak eklenmiş bir Feature’dır:
warning: node "api" (provider "terraform"): "values.token" is declared sensitive, but recipe "terraform/api" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a recipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them warning: node "api" (provider "terraform"): attachment "token": "values.token" is declared sensitive, but FeatureRecipe "terraform/api-token" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a FeatureRecipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with themKaldıraç nedir. Eşleme olmadan, bir source render’ının aldığı değerler doğrudan bildirilmiş yaprak yollarıyla anahtarlanır; böylece bildirim, render edilmiş anahtarıyla tam olarak birleşir ve işaret onunla birlikte taşınır. Terraform hedefinde bu, Hassas olarak bildirilmiş modül girdileri bölümünde açıklanan, üretilmiş geçersiz kılma dosyasıdır. Eşleme olduğunda, ulaşan işaret eşlemenin çıktısını bir bütün olarak kapsar ve yalnızca eşlemenin bildirilmiş değeri okuduğu yerde geçerlidir: bir Plugin’in reddederken ya da uyarırken oluşturduğu metni yönetir ve render edilmiş hiçbir baytı değiştirmez.
Üç biçim sessiz kalır ve bu bilinçlidir. Yalnızca artifact’lardan oluşan bir render ile yalnızca workload’dan oluşan bir render, hedeflerine hiç values eşlemi vermez; bu nedenle bir values yaprağının, nasıl yazılmış olursa olsun, orada işaretlenecek render edilmiş bir anahtarı yoktur. Bir sınıra eklenmiş bir Feature da, FeatureRecipe’i neyi eşlerse eşlesin, uyarı üretmez: bir sınır values: bloğu taşımaz; bu nedenle böyle bir eklenti boş bir values sütununa karşı render edilir, Feature’ının values yapraklarının hiçbiri orada veri taşıyamaz ve eşlemeyi kaldırmak hiçbir şeyi işaretlemez. Her biri, bir yazarın değiştirebileceği bir şey değil, biçimin kalıcı bir özelliğidir; bu nedenle bununla ilgili bir uyarı her derlemede tetiklenir ve yapılacak hiçbir şey göstermezdi. Bu sınır bunun yerine Bir yaprağı hassas olarak bildirmek bölümünde anlatılır. valuesMapping: içermeyen bir source: render’ı da sessizdir, çünkü orada işaret ulaşır.
Sınıf kodu. Uyarı, kararlı ve makine tarafından eşleştirilebilir sensitivity-not-conveyed sınıf kodunu taşır; böylece araçlar mesaj metnini ayrıştırmak yerine sınıfı eşleştirir: asistanın build aracı her bulguyu bu kodla advisories altında listeler. Kod, kayıtlı bir koşulu değil bir bulgu sınıfını adlandırır; bu nedenle bu sayfanın başındaki tabloda bir satırı yoktur.
Düzenleyicide görünürlük. Uyarı, dil sunucusu Release’i her render ettiğinde, uyarı önem düzeyinde ve bir terminal derlemesinin yazdırdığı satırın aynısını taşıyarak düzenleyici tanılamalarına ulaşır: istenen bir derleme ya da derleme önizlemesi, ya da aggrega serve --build-on-inspect ile veya bu bayrağın geçersiz kıldığı, varsayılan olarak kapalı olan serve.build_on_inspect yapılandırma anahtarıyla yapılan bir IR grafiği incelemesi. Kayıt, bir yazım anahtarı yerine bir düğümü ve bir hedefi adlandırır; bu nedenle Aggregate’in kind: anahtarı üzerinde gösterilir.
Kendine ait bir sınıftır ve --no-unsupported-field-warnings onu kapsamaz. Bu bayrak, bir hedefin aslına uygunluk bildirimlerini susturur; bu, farklı nedenlerle verilen farklı bir yargıdır. Bu uyarı onunla birlikte görünmeye devam eder. Bunu susturan bir bayrak yoktur.
Derleme başarılı olur ve render edilen baytlar değişmez. Uyarı bir yokluğu bildirir (hiçbir render edilmiş anahtar işareti taşımaz) ve eşleme sıradan, desteklenen bir biçimdir; bu nedenle durdurulacak bir şey yoktur ve satır görünse de görünmese de çıktınızda hiçbir şey değişmez.
Motorun başlatılırken getirdiği bir Terraform modül çağrısı
Şu durumda tetiklenir: derlemenin vendor olarak dahil ettiği bir Terraform modülü ya da bir Recipe’in yazılmış Terraform gövdesi, source değerini Terraform’un derlemenin yerleştirdiği dosyalardan okumak yerine yapılandırma başlatılırken indirdiği bir module bloğu bildirdiğinde: bir kayıt defteri adresi; bir git, Mercurial veya HTTP arşiv URL’si; bir S3 veya GCS bucket’ı ya da mutlak bir yol — veya vendor olarak dahil edilen modülün dışına çıkan ve derlemenin dahil etmediği dosyaları adlandıran yerel bir yol. Kilit, vendor olarak dahil edilen modülün commit’ini ve arşiv özetini sabitler; Terraform’un kendi bağımlılık kilit dosyası ise yalnızca provider’ları kaydeder. Bu nedenle böyle bir çağrının adlandırdığı modül, motorun o anda seçtiği sürümde getirilir ve bu derlemenin kaydettiği hiçbir şey onu kapsamaz.
Neyi okur. Modül çağrıldığında motorun yüklediği yapılandırma dosyalarını — doğrudan modülün kendi dizinindekileri ve yerel bir source değerinin oradan ulaştığı her dizindekileri — okur; hiçbir şeyin çağırmadığı bir dizindeki hiçbir şeyi okumaz. Bu nedenle bir modülün examples/ veya tests/ dizininde yazılmış bir çağrı raporlanmaz. Bir source değerinin ne dediğini okur, o kaynağın adlandırdığı modülü asla okumaz. Bir Recipe’in spec.boundary.artifacts altındaki bir dosya derleyicinin kendisi tarafından değerlendirilip yazılır ve hiçbir provider’a verilmez; bu yüzden böyle bir dosyada yazılmış bir module bloğu okunmaz ve uyarı üretmez. Provider sayfasındaki Yapısal girdi doğrulaması kuralı eksiksiz açıklar.
Çıktı biçimi. Çağrı başına bir satır: düğümü ve provider’ı, ardından bloğu, bulunduğu dosya ve satırı ve yazıldığı haliyle kaynağı adlandırır; modülün dışına çıkan bir kaynak, bir indirmeyi adlandırmak yerine bunu belirtir:
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module warning: node "app" (provider "terraform"): module "shared" (main.tf, line 2) has the local source "../shared", which resolves outside the module this build placed, so Terraform reads whatever sits at that path when the configuration is initialised rather than files this build vendoredÇağrılar motorun onlara ulaştığı sırayla gelir — önce modülün kendi dizini, ardından her dizin yerel bir kaynağın ona ilk ulaştığı sırayla ve bir dosya içinde bloklarının yazıldığı sırayla — bu nedenle aynı girdi her çalıştırmada aynı diziyi üretir. Render eden her çalıştırma onları üretir: aggrega build; bir Release’in derlemesinin neleri getirdiğini keşfetmek için onu bir kez render eden aggrega pull; ve modülünü çalışma alanının barındırdığı bir Recipe üzerinde, o Recipe’i tek başına render eden aggrega validate.
Sınıf kodu. Her uyarı kararlı, makineyle eşleştirilebilir module-fetched-at-init sınıf kodunu taşır; böylece araçlar mesaj metnini ayrıştırmak yerine sınıfı eşleştirir. Kod yapılandırılmış tanılamayla birlikte taşınır: asistanın build aracı her bulguyu bu kodla advisories altında listeler ve dil sunucusu kodu her girdide yayımlar. Kayıtlı bir koşulu değil bir bulgu sınıfını adlandırır, bu nedenle bu sayfanın başındaki tabloda bir satırı yoktur.
Editörde görünürlük. Uyarı, dil sunucusu Release’i her render ettiğinde aggrega-build katmanında, uyarı önem düzeyinde editör tanılamalarına ulaşır — kendisinden istenen bir derleme veya derleme önizlemesi ya da aggrega serve --build-on-inspect ile veya bu bayrağın geçersiz kıldığı, varsayılan olarak kapalı olan serve.build_on_inspect yapılandırma anahtarıyla yapılan bir IR grafiği incelemesi. Girdi bir yazım anahtarını değil bir düğümü adlandırır, bu yüzden Aggregate’in kind: anahtarı üzerinde gösterilir.
Kendine ait bir sınıftır ve hiçbir bayrak onu susturmaz. --no-unsupported-field-warnings desteklenmeyen alan sınıfını susturur ve bunu kapsamaz.
Derleme başarılı olur ve render edilen baytlar değişmez. Uyarı render edilen yapıtlardan ayrı bir kanaldan iletilir; bu nedenle vendor olarak dahil edilen modül, yazılmış gövde ve kök yapılandırma, uyarı görünse de görünmese de bayt bayt aynıdır.
Neden durdurma değil de uyarı. Başka bir modülü çağıran bir modül meşru bir girdidir: Terraform çağrılan modülü getirir ve yapılandırma çalışır. Yazarın vazgeçtiği şey, derlemenin o modül üzerindeki sabitlemesidir; bu, reddedilecek bir hata değil raporlanacak bir olgudur ve getirmenin kabul edilebilir olup olmadığına yazar karar verir.
Karşılaştırılacak kayıtlı bir özet olmadan çalışan bir eklenti
Ne zaman tetiklenir: derleyici bir eklentiyi çalıştırmak üzereyken, o eklentinin baytlarını kayıtlı bir özetin denetlemesi gerekiyorsa ve çalışma alanı onun için hiçbir özet kaydetmiyorsa. Eklenti çalışır; uyarı, çalıştırılan baytların birinin incelediği baytlarla hiçbir şey tarafından karşılaştırılmadığını öğrenmenizi sağlar.
aggrega pull, edindiği her eklentinin özetini Release’in kilit dosyasına yazar ve sonraki her çözümleme bulduğu baytları bu özetle karşılaştırır. Henüz çekilmemiş bir çalışma alanının ya da kilit dosyası, yapılandırmanın sonradan eklediği bir eklentiden daha eski olan bir çalışma alanının o eklenti için özeti yoktur; bu nedenle karşılaştırmanın karşılaştıracağı bir şey yoktur ve bu satır olmasaydı sessizce geçerdi.
Bir işlem hattı adımının, bir sağlayıcının ya da Plugin varlığı katalog dizinlerinizden birinde yazılmış olan ve bir karar rolüne eklenmiş bir eklentinin de özeti yoktur ve bir çekme işlemi ona özet vermez: çekme böyle bir varlığı hiçbir zaman sabitlemez ve bir derleme onun .wasm dosyasını her seferinde yeniden okur (olağan durumda varlığın yanından), bir çekmenin kaydettiği herhangi bir şeye göre değil. Bir dönüşüm rolüne eklenmiş ve orada yazılmış bir eklenti istisnadır: baytları işlenen çıktıyı biçimlendirdiği için çekme, onun için bulduğu .wasm dosyasının özetini kaydeder ve kaydettikten sonra derleme o eklentiyi özete göre denetler ve bu satır onun için üretilmez.
warning: plugin "governance/label-injector:1.0.0" resolved from cache with no recorded digest to check it against, so it runs unverified; run `aggrega pull --release <release>` to record it warning: plugin "pipeline-step/patch" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recordedBu, bir derlemenin, bir çekmenin ya da bir doğrulamanın diğer uyarıları arasında gösterdiği satırdır. Böyle bir çalıştırmanın dışında bir eklentiyi çözümleyen bir komut — çalışma alanının kendi komut satırı eklentilerini kurma, listeleme ya da çalıştırma veya lint için kullandığı eklentileri çözümleyen aggrega lint — aynı cümleyi girintisiz, ayrı bir satırda yazdırır.
Satır, baytların geldiği kaynağı, aggrega pull ve aggrega plugin list komutlarının onun için kullandığı aynı sözcükle adlandırır ve o kaynak için geçerli olanla biter. İçerik önbelleğinden gelen baytlar için çözüm Release’i çekmektir; bu, özeti kaydeder ve o eklentinin sonraki her çalıştırmasını denetlenmiş bir çalıştırma yapar. Bir katalog dizinindeki bir Plugin varlığının yanından okunan baytlar için çekme, özeti yalnızca bir dönüşüm rolüne eklenmiş bir eklenti için kaydeder ve satır bunu belirtir: orada yazılmış diğer herhangi bir eklenti için hiçbir çekme bunu değiştirmez; onu kayıtlı bir özetin denetimine almanın yolu, onu yayımlamak ve yayımlanan varlığa başvurmaktır.
Komut o eklentiyi kaç kez çözümlerse çözümlesin, her komut için eklenti başına bir kez gösterilir. Bir işleme, sağlayıcısını düğüm başına bir kez çözümler ve kendi kilit dosyasını dolduran bir derleme Release’i birden fazla kez işleyebilir; satırı her seferinde yinelemek onu gömerdi. Düzenleyici hizmeti, çalıştığı sürece onu kendi hata akışında bir kez gösterir, yanıtladığı her istek ise onu düzenleyiciye yeniden bildirir — böylece düzenleyici hangi yanıtı kullanırsa kullansın, o yanıt size o çalıştırmanın doğrulanmadan kullandığı eklentileri bildirir.
Düzenleyicide görünürlük. Uyarı, çalıştırmanın diğer tavsiyeleriyle birlikte uyarı önem düzeyinde düzenleyici tanılamalarına ulaşır: bir Release’in doğrulanması onu Release’in Aggregate’i üzerinde yayımlar, düzenleyicinin istediği bir derleme ya da derleme önizlemesi ise onu aggrega-build katmanında yayımlar. Yazdığınız bir anahtarı değil bir eklentiyi adlandırdığından dosyanın başına yerleştirilir. Her çalıştırma çözümlediğini bildirdiğinden, girdi, bir çalıştırma eklentiyi doğrulanmadan çözümlediği sürece kalır ve bunu yapmayan ilk çalıştırmayla temizlenir. Hiçbir kararı değiştirmez ve hiçbir çözümlemeyi başarısız kılmaz; bu nedenle bir oturumun verdiği yanıt, uyarı gösterilsin ya da gösterilmesin aynıdır.
İki çözümleme hiçbir şey üretmez ve ikisi de bir gözden kaçırma değildir:
- Derleyicinin kendi içinde taşıdığı bir eklenti.
aggrega pullgetirdiğini kaydeder ve ikili dosyayla birlikte gelen baytlar için getirilecek bir şey yoktur; bu nedenle böyle bir eklenti için hiçbir zaman özet kaydedilmez ve bunu değiştirmek için çalıştırabileceğiniz bir şey de olmazdı. Bu baytların kimliği ikili dosyanın kendisidir. Derleyicinin kendi eklentileri ve sürümleriaggrega plugin listtarafından listelenir ve kilit dosyasınıntoolchainbölümüne damgalanır. - Hiçbir özetin uygulanmasının hiç amaçlanmadığı bir çözümleme.
aggrega validate --plugin ./some.wasmkomut satırında adlandırdığınız bir dosyayı gösterir veaggrega lintdenetlediği yapıtın ta kendisini inceler; her ikisinde de eklenti güvenilen bir araç değil, incelenen konudur; bu nedenle ona uygulanabilecek bir kayıt yoktur.
Neden durdurma değil de uyarı. Bir belgeyi okumak, henüz kimsenin hazırlamadığı bir çalışma alanında da yapmaya değer bir iştir; biri aggrega pull çalıştırana kadar doğrulamayı ya da lint işlemini reddetmek, raporlama komutlarını tam da en yararlı oldukları anda kullanılamaz hâle getirirdi. aggrega build hiç kilit dosyası olmadan yapıt üretmez; bu nedenle derleme bu uyarıyla yalnızca kilit dosyasının özet kaydetmediği bir eklenti için karşılaşır; olağan durum, bir katalog dizininde varlığının yanından okunan bir eklentidir.
Eksik bir kilit dosyasının bunun yerine reddettiği durum. Bir düzenleyici derleyici hizmetinden bir Release’in grafiğini istediğinde ve çalışma alanında hiç kilit dosyası olmadığında, hizmet bir grafik çizmek yerine durur ve bir kilit dosyası ister. Var olan ve bir eklenti için yalnızca özet kaydetmeyen bir kilit dosyası ise yukarıdaki durumdur: eklenti çalışır ve bunu bu uyarı aracılığıyla öğrenirsiniz. Çizilen bir grafik, okuyucunun ardından üzerinde akıl yürüttüğü şeydir ve doğrulanmamış baytlardan oluşturulan bir grafik, denetlenmiş bir grafikle tıpatıp aynı görünürdü. Bkz. aggrega serve.
Yayınlanmış bir arşiv, Windows’un kullanamayacağı bir girdi taşıyor
Şu durumda tetiklenir: aggrega push — ya da onun --dry-run biçimi — girdilerinden birinde Windows’un yazıldığı hâliyle tutamayacağı bir parça bulunan bir arşiv yayımladığında: harf büyüklüğü ne olursa olsun ve ardından hangi uzantı gelirse gelsin, Windows’un bir aygıt için ayırdığı CON, PRN, AUX, NUL, COM1 veya LPT1 gibi bir ad ya da nokta veya boşlukla biten bir parça. aux/x.yaml böyle bir parçayı dizininde; report. ve COM1.yaml ise dosya adında taşır. Windows’ta aggrega böyle bir girdiyi açmayı reddeder; bu nedenle bir Windows çalışma alanı o sürümü hiç kullanamaz. Uyarı her platformda tetiklenir, çünkü bir yayın onu kim çekerse onun içindir ve yazarı bunu Windows kullanan biri öğrenmeden önce bu uyarıyla öğrenir.
Neyi okur. Arşivin tutacağı adları: önce varlık belgesinin kendi dosya adını, ardından varlığın yanında adlandırdığı her dosyayı — Bundling bölümünün listelediği dosyaları. Dolayısıyla bir şema dosyasını içe aktaran con.yaml adlı bir belge, uyarıyı kendi adı için alır. Hiçbir şey adlandırmayan bir varlık yalnızca kendi belgesi olarak yayımlanır; tüketici bunu sizin yazdığınız adla değil, ürünün seçtiği bir adla yerleştirir, bu yüzden dosyasının adı ne olursa olsun hakkında hiçbir zaman uyarı verilmez. Bir Plugin hiçbir arşiv yayımlamaz ve onun hakkında da hiçbir zaman uyarı verilmez.
Çıktı biçimi. Girdi başına bir satır, standart hata akışında, adların oluşturulduğu sırayla — önce belge, ardından taşıdığı dosyalar sözlük sırasıyla — kuru çalıştırmanın ya da yayının standart çıktıdaki kendi dökümünden önce:
warning: an entry this publication carries cannot be used on Windows (the entry "aux/x.yaml", its segment "aux"). 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, so a workspace on Windows refuses to unpack the entry. This warning does not stop the publication; rename that segment to publish a version Windows can useİlk tırnaklı değer, girdinin arşivdeki adıdır. İkincisi, girdinin bölümlerinden — eğik çizgilerin ayırdığı parçalardan — Windows’un tutamadığı ilkidir; yeniden adlandırılması gereken parça budur. Satır, koşulun sabit cümlesiyle başlar. Bir derlemenin değerlendirdiği bir kuraldan değil yayından kaynaklandığı için bu sayfanın başındaki tabloda satırı yoktur; her koşulun tablosu onu E0344 altında listeler.
Hiçbir şeyi reddetmez. Push ya da onun kuru çalıştırması, uyarı olmasaydı nasıl olacaksa tam öyle ilerler veya reddedilir ve olacağı gibi sonlanır.
Başka nereye ulaşır. Asistanın publish-entity aracı aynı girdileri windows_unusable_entries olarak yanıtlar, aggrega serve ise aggrega/publishEntity isteğini bunlarla windowsUnusableEntries olarak yanıtlar; hiç girdi yoksa her ikisi de yer almaz. Bkz. aggrega mcp ve aggrega serve. Hizmet ayrıca, raporlanmak isteyen bir isteğe uyarı satırının kendisini de yayının dökümünün geri kalanıyla birlikte iletir.
Düzenleyicide görünürlük. Tanılama olarak yoktur: yayımlama bir derleme değildir, bu nedenle buradaki hiçbir şey bir sorunlar listesine ulaşmaz. Hizmet üzerinden yayımlayan bir düzenleyici, yanıttaki windowsUnusableEntries alanını okur.
Neden durdurma değil de uyarı. Böyle bir ad geçerlidir ve Linux ile macOS dosyayı adlandırıldığı gibi kullanır; dolayısıyla yayını reddetmek, onu kimin çekeceğine dair bir tahmine dayanarak çalışan bir varlığı reddetmek olur. Yeniden adlandırıp adlandırmamak yazarın kararıdır.