Peringatan dan keluaran linter
Peringatan non-fatal yang dikeluarkan compiler selama kompilasi. Peringatan tidak menghentikan build — peringatan menampilkan kejanggalan penulisan, penentuan seri deterministik yang dipilih compiler, dan sumber daya yang tidak pernah digunakan oleh templat pengembang. Setiap temuan mencapai stderr di belakang prefiks yang menyebutkan jenisnya — warning:, lint:, atau notice:, bergantung pada pass mana yang memunculkannya — sehingga pipeline CI dapat menangkap dan menampilkannya kembali; artefak yang dirender tetap dihasilkan.
Untuk penghentian kompilasi yang fatal (diagnostik yang menghentikan build), lihat fatal-halts.md.
Setiap peringatan, berdasarkan kode singkat
Sebagian dari apa yang dilaporkan compiler tanpa menghentikan build merupakan sebuah kondisi tersendiri: kondisi tersebut membawa kode singkat, yaitu pengidentifikasi empat digit yang sama dengan yang dicetak oleh diagnostik yang menghentikan build, serta kalimat tetap yang mengawali pesannya. Tabel di bawah ini memetakan yang satu ke yang lain, sehingga kode yang Anda pegang dapat dirujuk ke pokok temuan tersebut, bahkan ketika baris yang Anda baca adalah peringatan, bukan penghentian.
Yang mendapat tempat di sini adalah deklarasi, bukan deskripsi. Setiap aturan yang dievaluasi compiler menyatakan apa akibat dari pelanggarannya — menghentikan build, atau melaporkan temuan dan membiarkan build selesai — dan baris-baris di bawah ini termasuk jenis kedua. Dengan demikian, peringatan yang ditambahkan ke compiler muncul di sini tanpa perlu menulis baris secara manual, dan peringatan yang berubah menjadi kondisi penghentian akan hilang dari sini.
Ada dua batasan cakupan tabel ini, dan keduanya perlu diketahui sebelum Anda menyimpulkan bahwa suatu kode tidak ada:
- Tidak semua yang ada di halaman ini termasuk jenis tersebut. Beberapa temuan yang dijelaskan di bawah dimunculkan oleh pass tersendiri, bukan oleh aturan yang dideklarasikan, dan sebagian sama sekali tidak membawa kondisi — baris yang dicetaknya tetap persis seperti yang dijelaskan di bagiannya masing-masing, tetapi tidak ada kode untuk dirujuk sehingga tidak ada barisnya di tabel. Kode kelas
unsupported-fieldadalah bentuk yang dapat diharapkan di sana: kode itu menamai kelas temuan, bukan kondisi. - Adanya baris di sini tidak menjamin adanya bagian di bawah. Peringatan yang dimunculkan pada tahap akhir rendering hanya dikatalogkan, tidak dijelaskan, sehingga suatu kode dapat merujuk ke sebuah kalimat di sini dan mendapat penjelasan lebih lengkap di fatal-halts.md pada “Conditions that do not halt a build”, yang mengatalogkan setiap kondisi yang membawa kode tanpa menghentikan build.
sentinels.md merujuk setiap kode singkat yang dicetak oleh build, baik peringatan maupun penghentian, dan merupakan tempat untuk memulai ketika Anda belum tahu jenis mana yang sedang Anda hadapi.
| Kode pendek | Diawali dengan |
|---|---|
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 |
Lint schema-pillar-overlap
Dipicu ketika sebuah Component atau Feature mendeklarasikan nama properti yang sama di pilar values: dan infra: pada blok spec.schema:-nya, pada kedalaman sarang yang sama. Penulis skema yang menaruh nama field yang sama di kedua pilar biasanya bermaksud menaruhnya di salah satu saja; lint ini menandai duplikasi tersebut agar penulis dapat menentukan pilar mana yang memiliki field itu.
Posisi dalam pipeline. Lint ini berjalan pada tahap validasi setelah unifikasi skema, sebelum konstruksi topologi. Lint ini menelusuri skema setelah ekspansi bentuk ringkas, tanpa mengikuti $ref: (lihat disiplin soft-skip di bawah), dan melaporkan setiap properti yang tumpang tindih sebagai peringatan terpisah.
Bentuk keluaran:
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)Untuk properti bersarang, jalurnya adalah jalur bertitik menuju properti tersebut dari akar pilar:
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)Pemuatan seluruh katalog — aggrega validate tanpa argumen — menamai setiap entitas berdasarkan nama dan versinya serta file tempat entitas itu dibaca, seperti di atas. Sebuah build, atau validasi satu Release, hanya membaca entitas yang dijangkau Release tersebut dan menamai masing-masing berdasarkan nama dan versinya — at core/db-pool:1.0.0 — satu kali per entitas, berapa pun banyaknya referensi dalam Release yang menjangkaunya: sebuah Aggregate yang menamai sebuah Feature dengan nama polosnya dan sebuah Manifest yang memetakannya berdasarkan nama dan versi menjangkau satu Feature, yang dilaporkan satu kali.
Visibilitas di editor. Temuan ini mencapai diagnostik editor melalui language server, dengan tingkat keparahan peringatan, di awal file alih-alih pada sebuah kunci — temuan ini menamai entitas katalog, bukan posisi di dalam dokumen yang sedang Anda sunting, sehingga tidak ada kunci penulisan tempat penanda dapat diletakkan. Temuan ini dimunculkan sebelum tahap perenderan artefak, sehingga tidak memerlukan pengaturan: sesi editor menampilkannya baik serve.build_on_inspect aktif maupun tidak.
Disiplin soft-skip. Penelusur berhenti tanpa peringatan ketika sebuah cabang skema memuat salah satu jalan keluar JSON Schema 2020-12 yang mencegah himpunan properti dapat diturunkan secara statis: $ref (referensi lintas dokumen atau dalam dokumen), patternProperties (deklarasi properti berbasis bentuk kunci), additionalProperties yang disetel ke true atau ke sebuah skema (properti yang diterima cabang tanpa menamainya), dan operator komposisi oneOf / anyOf / allOf (disjungsi dan konjungsi yang cabang-cabangnya dapat mendeklarasikan himpunan properti yang berbeda). Menelusuri cabang-cabang ini akan memerlukan evaluasi skema yang dirujuk atau dikomposisikan pada saat lint (jenis pekerjaan yang tidak dilakukan lint ini) atau menghasilkan positif palsu ketika nama properti values: dari satu cabang kebetulan bertabrakan dengan nama properti infra: dari cabang lain. Lint tidak mengeluarkan peringatan untuk kedalaman sarang yang terdampak; tingkat yang lebih dalam dari skema yang sama tetap ditelusuri dan dapat di-lint.
Catatan penulisan. Compiler tidak menolak tumpang tindih nama antarpilar — lint ini bersifat anjuran. Sebuah Component dengan storage_size di kedua pilar tetap terkompilasi; values.storage_size di sisi pengembang dan infra.storage_size di sisi operator divalidasi secara independen oleh skema pilarnya masing-masing, dan templat valuesMapping: milik Recipe menentukan nilai pilar mana yang mengalir ke keluaran yang dirender. Lint ini ada karena pola penulisan tersebut hampir selalu merupakan kesalahan; duplikasi lintas pilar yang disengaja cukup jarang sehingga penulis yang benar-benar menginginkannya dapat mengabaikan peringatan ini. Untuk mekanisme lintas pilar yang lebih luas — termasuk kasus langka ketika penyaluran lintas pilar yang disengaja dapat dibenarkan — lihat vocabulary/data-pillars.md “Cross-pillar mechanics”.
Lint tumpang-tindih peta binding
Dipicu ketika sebuah binding anotasi Manifest mendeklarasikan jalur bertitik yang sama di kedua daftar maps.infra dan maps.values-nya. Jalur tersebut akan dirutekan melalui kedua pilar; pemecah seri deterministik milik compiler mengirimkannya melalui infra:, sehingga sisi values: tidak dapat dijangkau dari Aggregate. Lint ini menampilkan hal tersebut agar penulis dapat mempersempit binding ke satu pilar saja atau menerima perutean khusus sisi infra secara sadar.
Penempatan dalam pipeline. Lint ini berjalan setelah Manifest di-resolve dan sebelum ekspansi anotasi apa pun dijalankan, sehingga sebuah build melaporkan binding yang tumpang-tindih baik ada maupun tidak ada anotasi Aggregate yang mencapai binding tersebut. Lint ini menelusuri binding di bawah mappings.features.annotations sesuai urutan penulisannya, mencari irisan daftar maps.infra dan maps.values setiap binding, dan melaporkan satu temuan per jalur yang tumpang-tindih. Dalam satu binding, jalur yang tumpang-tindih dilaporkan sesuai urutan deklarasinya dalam daftar maps.values binding tersebut — urutan yang Anda tulis — sehingga eksekusi berulang atas masukan yang identik melaporkan urutan yang identik.
Bentuk keluaran:
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")Kedua baris tersebut berasal dari satu build atas satu Manifest, dan yang membedakan locator keduanya adalah bentuk kunci anotasinya. Sebuah locator menunjuk dokumen melalui jalur bertitik, sehingga berhenti pada segmen pertama yang memuat titiknya sendiri: audit-scope tidak memuat titik dan locator mencapai binding, sedangkan compliance.aggrega.ai/data-class memuatnya, sehingga locator menyebut blok annotations yang menampungnya. Itulah sebabnya kunci yang bermasalah juga menjadi nilai berkutip pertama dari setiap temuan — kunci itulah satu-satunya bagian yang tidak selalu dapat dibawa oleh locator.
Visibilitas di editor. Temuan ini juga mencapai diagnostik editor melalui language server, dengan tingkat keparahan peringatan, diposisikan di mana pun locator-nya mencapai — pada binding itu sendiri untuk kunci biasa, dan pada blok annotations yang melingkupinya untuk kunci yang memuat titik. Penulis yang tidak pernah membaca keluaran terminal tetap melihatnya. Temuan ini dimunculkan sebelum tahap rendering artefak, sehingga tidak memerlukan pengaturan: sesi editor menampilkannya baik serve.build_on_inspect aktif maupun tidak.
Mencocokkannya secara terprogram. Temuan ini membawa ErrAnnotationBindingPillarOverlap dari pkg/resolver, sehingga konsumen mengenali kelasnya dengan errors.Is, bukan dengan mencocokkan teks pesan. Seperti setiap sentinel bersifat anjuran, temuan ini tidak pernah memengaruhi putusan build — lihat sentinels.md untuk aksesor dan kode kondisinya.
Pemecah seri deterministik. Runtime menyelesaikan bentrokan dengan merutekan jalur tersebut secara eksklusif melalui pilar infra:. Pilihan ini konsisten di seluruh build; penulis dapat mengandalkannya. Sisi values: dibuang dari perutean efektif binding — anotasi sisi Aggregate yang mencoba mencapai jalur tersebut tidak menerima target perutean dan build berhenti di sisi Aggregate pada waktu ekspansi, dengan penghentian yang dijelaskan di fatal-halts.md “An annotation routes through a pillar its authoring side may not use (Sebuah anotasi dirutekan melalui pilar yang tidak boleh digunakan oleh sisi penulisannya)”. Lint ini adalah sarana peringatan dini; penghentian tersebut adalah sarana penegakannya.
Catatan penulisan. Seperti lint tumpang-tindih pilar skema, lint ini bersifat anjuran — binding tetap dikompilasi dan pemecah seri runtime menghasilkan keluaran deterministik. Lint ini dipicu karena pola penulisan tersebut hampir selalu tidak disengaja; penulis binding yang benar-benar ingin kedua pilar merutekan jalur yang sama akan menulis dua binding terpisah dengan kunci anotasi yang berbeda.
Lint near-miss slot lampiran
Muncul ketika sebuah instans komponen melampirkan Feature dengan nama yang bukan salah satu slot featuresSchema yang dideklarasikan oleh tipe Component-nya, tetapi berjarak satu suntingan dari salah satunya — satu karakter yang disisipkan, dihapus, atau diganti, atau dua karakter bersebelahan yang tertukar — yang selector-nya tidak dipenuhi oleh Feature yang dilampirkan. Itulah bentuk salah ketik nama slot, dan lint ini menyebutkan kedua ejaan agar penulis dapat melihat pasangannya.
Mengapa lint ini ada. Mendeklarasikan slot tidak menutup permukaan lampiran: lampiran dengan nama yang tidak dideklarasikan oleh slot mana pun tetap sah, karena keterbukaan itulah yang memungkinkan satu entitas katalog melayani lampiran pengisi slot sekaligus kredensial yang dibagikan pada cakupan yang lebih luas. Akibatnya, nama slot yang salah eja diam-diam menjadi lampiran bebas alih-alih pengisian slot yang dimaksud penulis — build berhasil dan slot tersebut tetap kosong. Lint ini adalah mitigasi yang diungkapkan untuk kasus tersebut secara tepat.
Penempatan dalam pipeline. Lint ini berjalan saat resolusi, dalam lintasan yang sama dengan penjaga semantik yang sadar katalog, atas Aggregate yang telah diresolusi. Lint ini menelusuri nama lampiran setiap instans komponen terhadap nama slot yang dideklarasikan oleh tipe Component instans tersebut, dan memancarkan satu peringatan per pasangan near-miss.
Bentuk keluaran:
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")Nilai berkutip pertama adalah nama yang digunakan untuk menulis lampiran, yang menjadi pokok kalimat pembuka peringatan. Dua nilai berikutnya diperkenalkan oleh kata-kata yang menyatakan apa nilai tersebut: tipe Component tempat lampiran berada, dan slot terdeklarasi yang berjarak satu suntingan darinya.
Visibilitas di editor. Peringatan ini juga mencapai diagnostik editor melalui language server, dengan tingkat keparahan peringatan, diposisikan pada kunci lampiran yang bermasalah. Penulis yang tidak pernah membaca keluaran terminal tetap melihat pasangannya. Peringatan ini dimunculkan sebelum tahap perenderan artefak, sehingga tidak memerlukan pengaturan: sesi editor menampilkannya terlepas dari aktif tidaknya serve.build_on_inspect.
Ambang batas dan komprominya. Lint ini memasangkan nama hanya pada jarak satu suntingan, dan hanya jika kedua nama setidaknya sepanjang empat karakter. Di bawah panjang itu, hampir setiap nama pendek berjarak satu suntingan dari nama lainnya, sehingga memasangkannya akan menghasilkan derau alih-alih sinyal; di atas satu suntingan, pasangan tidak lagi menyerupai salah ketik. Transposisi dihitung sebagai satu suntingan, bukan dua, karena pasangan karakter yang tertukar adalah kekeliruan yang paling umum dan penghitungan yang lebih ketat akan melewatkannya.
Catatan penulisan. Lint ini bersifat anjuran dan tidak pernah mengubah putusan build — kompiler tidak mengawasi nama yang diberikan penulis pada lampiran. Penulis yang dengan sengaja melampirkan Feature dengan nama yang menyerupai slot dapat mengabaikan peringatan ini; lampiran berperilaku persis seperti yang ditulis.
Tidak berlaku jika Feature cocok dengan slot. Nama yang berjarak satu suntingan dari slot yang selector-nya dipenuhi oleh Feature yang dilampirkan tidak memicu peringatan. Pasangan itu bukan lampiran bebas yang salah ketik, melainkan pengisian yang ditulis dengan nama lain, dan penting tidaknya hal itu bergantung pada apakah slot akhirnya kosong, yang baru diketahui setelah setiap cakupan dilipat. Jika slot dibiarkan kosong, build terhenti dan menyebutkan lampiran serta slotnya — lihat “An attachment written under another name fits a slot its component leaves empty (Lampiran yang ditulis dengan nama lain cocok dengan slot yang dibiarkan kosong oleh komponennya)” di fatal-halts.md — sehingga penghentian itulah satu-satunya temuan yang dilaporkan, tanpa peringatan di sampingnya. Jika ada hal lain yang mengikat slot tersebut, lampiran itu adalah lampiran tambahan biasa dan tidak ada yang dilaporkan. Slot yang tidak mendeklarasikan selector tidak dapat diisi oleh Feature mana pun, sehingga nama yang mendekati slot semacam itu selalu memicu peringatan.
Tidak berlaku pada koneksi. Lint ini membaca blok features: milik komponen itu sendiri, yang bersifat terbuka. Lampiran yang dibawa koneksi dikunci oleh slot yang dideklarasikan socket-nya dan tidak ada yang lain, sehingga nama yang berjarak satu suntingan dari salah satu slot tersebut tidak sah di sana: build justru terhenti, dan penghentian itu menyebutkan slot yang didekati nama tersebut dalam kalimat yang sama. Tidak ada peringatan yang dimunculkan di sampingnya. Lihat “A connection carries an attachment under a name its socket declares no slot for (Koneksi membawa lampiran dengan nama yang tidak dideklarasikan slotnya oleh socket-nya)” di fatal-halts.md.
Lint near-miss uses-socket
Dipicu ketika blok uses: milik sebuah komponen sendiri menyebut socket yang bukan salah satu socket usesSchema yang dideklarasikan oleh tipe Component-nya, tetapi berjarak satu suntingan dari salah satunya — satu karakter yang disisipkan, dihapus, atau diganti, atau dua karakter bersebelahan yang tertukar. Itulah bentuk salah ketik nama socket, dan lint menyebut kedua ejaan agar penulis dapat melihat pasangannya.
Mengapa lint ini ada. Mendeklarasikan sebuah socket tidak menutup permukaan uses: pada komponen milik developer sendiri: nama socket yang tidak dideklarasikan oleh entri usesSchema mana pun adalah sah, karena diamnya katalog tentang sebuah socket berarti koneksi itu tidak diantisipasi, bukan dilarang, dan developer memiliki topologi Aggregate. Akibatnya, nama socket yang salah eja menjadi koneksi ad-hoc tersendiri alih-alih menyambungkan socket yang dimaksud penulis — build berhasil, socket yang dimaksud tetap tidak tersambung, dan edge ad-hoc tersebut tidak membawa selector maupun kontrak per-edge. Lint ini adalah mitigasi yang diungkapkan tepat untuk kasus tersebut. Untuk apa yang dilepaskan dan dipertahankan oleh socket ad-hoc, lihat entities/component.md “Topology Sockets: usesSchema”.
Permukaan yang dicakup. Hanya blok uses: milik komponen itu sendiri — satu-satunya permukaan tempat nama socket yang tidak dideklarasikan diterima. uses: pada attachment Feature hanya boleh menyebut socket yang dideklarasikan oleh Feature yang dilampirkan, dan uses: per-edge pada Release hanya boleh menyebut socket yang dideklarasikan oleh Component konsumen; nama yang salah pada salah satu dari keduanya sudah menghentikan build, sehingga tidak ada yang perlu ditambahkan oleh peringatan.
Penempatan dalam pipeline. Lint berjalan pada tahap resolusi, dalam pass yang sama dengan guard semantik yang sadar katalog, atas Aggregate yang telah di-resolve. Lint menelusuri nama socket milik setiap instans komponen terhadap nama socket yang dideklarasikan oleh tipe Component instans tersebut, dan mengeluarkan satu peringatan per pasangan near-miss. Komponen yang berasal dari sub-aggregate tidak dicakup: komponen di dalamnya dilipat ke dalam graf setelah pass ini berjalan.
Bentuk keluaran:
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")Nilai berkutip pertama adalah nama socket yang ditulis penulis, yang menjadi pokok kalimat pembuka peringatan. Dua nilai berikutnya diawali kata-kata yang menyatakan maknanya: tipe Component tempat socket itu disebut, dan socket terdeklarasi yang berjarak satu suntingan darinya. Konsekuensi yang tidak dijelaskan oleh peringatan adalah yang diuraikan di atas: nama yang salah eja adalah koneksi ad-hoc, sehingga tidak membawa selector maupun kontrak per-edge, dan socket yang dimaksud penulis tetap tidak tersambung.
Visibilitas di editor. Peringatan ini juga sampai ke diagnostik editor melalui language server, dengan tingkat keparahan warning, diposisikan pada komponen yang blok uses:-nya memuat nama yang bermasalah. Penulis yang tidak pernah membaca keluaran terminal tetap melihat pasangannya. Peringatan dimunculkan sebelum tahap rendering artefak, sehingga tidak memerlukan pengaturan: sesi editor menampilkannya baik serve.build_on_inspect aktif maupun tidak.
Ambang batas dan kompromi. Lint memasangkan nama hanya pada jarak satu suntingan, dan hanya jika kedua nama setidaknya sepanjang empat karakter — batas yang sama dengan yang digunakan lint near-miss attachment-slot, dengan alasan yang sama. Di bawah panjang itu, hampir setiap nama pendek berjarak satu suntingan dari nama lainnya, sehingga memasangkannya akan menghasilkan derau alih-alih sinyal; di atas satu suntingan, pasangan tidak lagi menyerupai salah ketik. Transposisi dihitung sebagai satu suntingan, bukan dua, karena pasangan karakter yang tertukar adalah kekeliruan paling umum dan hitungan yang lebih ketat akan melewatkannya.
Catatan penulisan. Lint ini bersifat anjuran dan tidak pernah mengubah putusan build — compiler tidak mengatur nama yang diberikan penulis pada sebuah socket. Penulis yang sengaja membuat koneksi ad-hoc dengan nama yang menyerupai socket terdeklarasi (koneksi cache di samping socket terdeklarasi caches, yang dimaksudkan untuk hal lain) dapat mengabaikan peringatan; edge berperilaku persis seperti yang ditulis. Tidak ada flag untuk menekannya, dan memang tidak diperlukan: peringatan ini tidak berbobot terhadap putusan.
Lint kunci provides yang tidak dideklarasikan
Dipicu ketika Recipe yang terikat pada sebuah instance komponen menerbitkan kunci di bawah provides: miliknya yang tidak dideklarasikan oleh tipe Component instance tersebut dalam kontrak spec.schema.provides:-nya.
Mengapa lint ini ada. Menerbitkan lebih banyak daripada yang dideklarasikan Component adalah sah dan tetap sah: kontrak provides mewajibkan subset dan mengizinkan superset, sehingga Recipe yang mencakup kontrak Component-nya dan juga mengeluarkan kunci tambahan adalah Recipe yang memenuhinya. Yang disebutkan oleh lint ini adalah konsekuensi yang jika tidak demikian tidak terlihat dari sisi mana pun. Konsumen yang membaca melalui sebuah edge uses: melihat kontrak target yang dideklarasikan, bukan apa pun yang kebetulan dikeluarkan oleh Recipe target — itulah yang menjaga Recipes tetap dapat dipertukarkan, karena dua Recipes yang mewujudkan satu Component kemudian menyajikan permukaan yang sama kepada konsumen, dan menukar keduanya tidak dapat secara diam-diam menarik kunci yang telah diandalkan konsumen. Jadi kunci yang tidak dideklarasikan tidak dikirimkan melalui edge tersebut, dan template konsumen yang membacanya merender nilai kosong alih-alih gagal.
Temuan ini dinyatakan pada penyebabnya — pada Recipe yang menerbitkan kunci tersebut — karena di sanalah temuan itu dapat disebutkan. Di sisi konsumen, kunci tersebut adalah referensi template yang tidak dapat dikaitkan oleh compiler dengan target tertentu, dan diagnostik yang menebak akan lebih buruk daripada tidak ada sama sekali. Jadi keduanya sengaja tidak ditempatkan bersama: nilai kosong muncul di konsumen, penjelasannya di sini, dan keduanya muncul dalam keluaran build yang sama.
Pasangan mana yang dibandingkan. Kunci provides: yang ditulis pada Recipe yang terikat dibandingkan dengan kunci spec.schema.provides: yang dideklarasikan oleh tipe Component. Himpunan yang dideklarasikan itu sama dengan himpunan yang digunakan untuk memeriksa kunci from: di dalam blok inject:, sehingga keduanya sepakat tentang apa yang dideklarasikan sebuah Component. Perbandingannya bersifat persis, bukan uji kemiripan, sehingga tidak seperti dua lint near-miss di atas, lint ini tidak memiliki ambang batas dan tidak memasangkan nama.
Recipe yang dibandingkan adalah Recipe yang benar-benar terikat pada instance tersebut, dicocokkan berdasarkan nama instance dan tipe katalog yang sama dengan yang digunakan rendering untuk mengikat, sehingga override Recipe per instance dalam Manifest dihormati alih-alih dirata-ratakan. Instance komponen yang tipenya tidak terselesaikan ke Component katalog mana pun dilewati: tidak ada deklarasi yang dibaca, dan itu tidak sama dengan deklarasi yang kosong.
Penempatan dalam pipeline. Lint ini berjalan saat resolusi, dalam pass yang sama dengan guard semantik yang sadar katalog, atas Aggregate yang telah diresolusi — sebelum rendering, sehingga lint ini muncul dari aggrega validate --release maupun dari aggrega build. Components yang dideklarasikan di root Aggregate dan komponen yang bersarang di subsistem sama-sama tercakup. Komponen yang berasal dari sub-aggregate tidak tercakup: komponen di dalamnya dilipat ke dalam graf setelah pass ini berjalan, sehingga kunci yang tidak dideklarasikan pada komponen seperti itu tetap ditahan dari konsumen, tetapi tidak ada advisori yang menyebutkannya.
Bentuk keluaran. Satu baris per instance komponen dan kunci, yang menyebutkan Recipe yang menerbitkan kunci tersebut dan Component yang tidak mendeklarasikannya:
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")Temuan ini milik instance yang membawanya, sehingga sepuluh instance dari satu tipe Component yang menerbitkan kunci tidak dideklarasikan yang sama menghasilkan sepuluh baris, bukan satu, masing-masing menyebutkan instance-nya sendiri. Setiap baris dikaitkan dengan Recipe yang menerbitkan kunci tersebut, karena itulah dokumen yang Anda edit untuk menyelesaikannya. Penelusurannya deterministik, sehingga masukan yang sama menghasilkan urutan advisori yang sama pada setiap eksekusi.
Visibilitas di editor. Advisori ini juga mencapai diagnostik editor melalui language server, dengan tingkat keparahan peringatan, diposisikan pada instance komponen yang type:-nya mengikat Recipe tersebut. Penulis yang tidak pernah membaca keluaran terminal tetap melihatnya. Advisori ini dimunculkan sebelum tahap rendering artefak, sehingga tidak memerlukan pengaturan: sesi editor menampilkannya baik serve.build_on_inspect aktif maupun tidak.
Catatan penulisan. Lint ini bersifat advisori dan tidak pernah mengubah putusan build — Recipe yang menerbitkan lebih banyak daripada yang dideklarasikan Component-nya tetap berhasil di-build. Perbaikannya adalah salah satu dari dua, dan mana yang tepat adalah keputusan penulis: deklarasikan kunci tersebut pada Component jika konsumen dimaksudkan untuk membacanya, atau biarkan tidak dideklarasikan jika kunci itu adalah state kerja milik Recipe sendiri, dan dalam hal ini locals: adalah tempat state semacam itu seharusnya berada. Kasus sebaliknya bukan advisori: Component yang mendeklarasikan kunci yang tidak diterbitkan oleh Recipe-nya membuat kontrak tidak terpenuhi dan menghentikan build.
Peringatan Ghost Infrastructure Tracker
Dipicu ketika sebuah kunci yang dideklarasikan oleh penulis mencapai sebuah node dan tidak ada templat yang dideklarasikan oleh Recipe terikat yang pernah mereferensikannya. Kunci yang tidak dibaca menjadi infrastruktur senyap: konfigurasi yang diminta oleh pengembang atau operator tetapi tidak pernah disambungkan oleh Recipe ke dalam keluaran yang dirender. Tracker memunculkannya agar ketidaksesuaian antara apa yang ditulis dan apa yang dibawa keluaran terlihat, alih-alih tersembunyi.
Kunci tertulis mana yang dibandingkan. Tiga kelompok, per node:
.values— pilar sisi pengembang milik node itu sendiri..infra— pilar sisi operator milik node itu sendiri..context.uses.<alias>.values— nilai per koneksi yang dibawa pada setiap edgeuses:yang dikonsumsi oleh node. Kelompok ini dengan sendirinya tercakup pada konsumen: mapusesmilik sebuah node hanya memuat edge yang bersumber dari node tersebut, sehingga nilai per koneksi yang tidak dibaca selalu diatribusikan ke node yang menulisnya dan tidak pernah ke target edge.
Referensi mana yang dikumpulkan. Setiap templat yang dideklarasikan oleh Recipe terikat. Peringatan ini menyatakan bahwa sebuah kunci dibaca oleh tidak ada apa pun, yang merupakan klaim tentang seluruh Recipe, sehingga cakupan apa pun yang lebih sempit daripada seluruh Recipe akan membuat klaim itu salah, bukan sekadar perkiraan — kunci yang dikonsumsi oleh koordinat source: akan dilaporkan tidak dibaca oleh eksekusi yang justru mengambil versi yang disebutkannya. Blok yang dibaca adalah:
valuesMapping:, overlay nilai yang diserahkan ke provider.source:— seluruh field jika ditulis sebagai satu string, dan setiap field bernilai string di dalamnya jika ditulis sebagai objek. Koordinat source adalah templat yang dievaluasi per instance yang mengonsumsi, sehingga versi, nama chart, referensi git, atau subdirektori modul yang dipilih dari.valuesatau.inframembaca kunci-kunci tersebut.locals:danprovides:, setiap entri.assertions:, setiap entri.workload:, badan Workload yang disintesis.artifacts:, konten setiap entri.pipeline:, inputwith:setiap langkah dan gerbangwhen:-nya.
Tiga batasan berikut berlaku, dan ketiganya merupakan batas atas apa yang dapat diklaim secara jujur, bukan pilihan. Masing-masing membungkam pembacaan alih-alih memperluasnya, yaitu arah yang paling murah biayanya: kunci yang tidak dilaporkan membuat pembaca kehilangan satu peringatan yang masih dapat mereka temukan dengan membaca Recipe, sedangkan kunci yang salah dilaporkan memberi tahu mereka bahwa pengaturan yang berfungsi telah diabaikan.
- Recipe tanpa
valuesMapping:inline tidak dibaca sama sekali. Kuncinya dilewati alih-alih dilaporkan, apa pun yang dilakukan templat lainnya. - Blok yang diimpor Recipe dari file atau dari referensi pustaka belum tersedia pada titik ini, sehingga referensinya tidak dapat dikumpulkan. Kunci node dilewati seluruhnya alih-alih dilaporkan — hal ini berlaku sama untuk
valuesMapping:yang diimpor,workload:yang diimpor, maupun entriartifacts:yang diimpor. - Templat yang gagal di-parse tidak menghasilkan himpunan referensi sama sekali. Melaporkan setiap kunci sebagai tidak dibaca akan menenggelamkan diagnostik parse yang dimunculkan evaluasi atas templat yang sama, sehingga tidak ada yang dilaporkan. Entri
artifacts:dibaca dengan delimiter standar{{ }}, yang bukan pasangan yang dideklarasikan setiap provider untuk field tersebut; jika dibaca dengan pasangan yang salah, badan semacam itu menghasilkan referensi yang tidak pernah ditulis penulisnya, atau tidak dapat di-parse, dan kedua hasil itu hanya pernah membungkam peringatan.
valueSchema milik socket tidak pernah ditandai. usesSchema.<socket>.valueSchema mendeklarasikan kontrak yang harus dipenuhi oleh nilai per koneksi. Ini adalah skema, bukan instance yang ditulis, dan tidak termasuk input yang dibandingkan — sehingga tidak pernah dapat dilaporkan. Apa yang dihasilkan oleh default yang dideklarasikan socket adalah instance seperti yang lain, dibaca atau tidak dibaca berdasarkan keadaannya sendiri.
Referensi yang menyebut seluruh pilar menghitung setiap kunci di bawahnya sebagai telah dibaca. {{ .infra.port }} menandai port sebagai dibaca dan membiarkan kunci lain dari pilar tersebut tetap dapat memicu peringatan. {{ optional .infra `port` 8080 }} menyerahkan seluruh map .infra ke sebuah fungsi, sehingga referensi yang dikumpulkan menyebut pilar alih-alih kunci di bawahnya, setiap kunci dalam pilar itu dihitung sebagai dibaca, dan pilar tersebut tidak memunculkan apa pun. Hal yang sama berlaku untuk melakukan range atas sebuah pilar dan untuk menjangkau satu entri uses melalui index. Penulis Recipe yang menginginkan cakupan per kunci menulis referensi per kunci.
Hal itu menjangkau setiap blok di atas, yang perlu diketahui sebelum pilar yang sepi dianggap sebagai peringatan yang terlewat: Recipe yang versi source:-nya ditulis sebagai {{ optional .infra `source_version` "1.2.3" }} telah menyerahkan seluruh map .infra ke sebuah fungsi, sehingga Recipe tersebut tidak melaporkan apa pun tentang kunci .infra mana pun pada node mana pun yang direndernya. Pilar .values tidak terpengaruh — keduanya dihitung secara terpisah.
Penempatan dalam pipeline. Tracker berjalan pada rendering dasar, bersamaan dengan evaluasi templat. Setiap templat Recipe di-parse dan ditelusuri untuk mengumpulkan jalur field berkualifikasi titik yang direferensikannya (.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget); himpunan kunci yang di-resolve dari setiap kelompok dibandingkan dengan gabungan referensi tersebut, dan selisihnya adalah himpunan yang tidak dibaca. Yang ditelusuri adalah Recipe sebagaimana ditulis: koordinat source: dibaca sebagai teks templatnya, bukan sebagai nilai yang dihasilkan templat itu untuk instance ini.
Bentuk keluaran. Satu baris per kunci yang tidak dibaca, yang menyebutkan node, jalur kelompok, kunci, dan Recipe yang tidak satu pun templatnya membaca kunci tersebut:
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 keyBaris ini tidak menyebutkan field Recipe, dan hal itu disengaja: siapa pun yang menulis kunci tersebut adalah pengembang, operator, atau penulis edge uses: yang dilaluinya, dan tidak satu pun dari mereka menyunting Recipe. Menyebutkan blok tempat referensi dicari akan memberi pembaca itu koordinat dalam dokumen yang tidak mereka buka. Dua perbaikan yang ditawarkan baris ini adalah dua hal yang dapat mereka lakukan — kunci yang salah eja adalah penyebab umum, dan kunci yang memang tidak akan pernah dibaca layak dihapus.
Urutannya tetap: .values milik node, lalu .infra-nya, lalu setiap alias uses dalam urutan edge dikeluarkan, dengan kunci diurutkan di dalam setiap kelompok. Karena itu, input yang sama menghasilkan urutan peringatan yang sama pada setiap eksekusi.
Visibilitas di editor. Peringatan ini mencapai diagnostik editor hanya jika language server menjalankan tahap rendering artefak saat memeriksa graf IR — aggrega serve --build-on-inspect, atau kunci konfigurasi serve.build_on_inspect yang ditimpanya, yang nonaktif secara default. Pengaturan itu menambahkan peringatan yang dimunculkan build saat rendering, dan tidak satu pun pemeriksaan yang menghentikan build. Entri ini menyebutkan node alih-alih kunci yang ditulis, sehingga ditampilkan pada kunci kind: milik Aggregate.
Mengapa peringatan dan bukan penghentian fatal. Pengembang dapat secara sah mengonsumsi subset .values yang berbeda dalam logika templat bersyarat — Recipe yang templatnya bercabang pada .values.mode membaca mode tetapi secara bersyarat membaca .values.replication_password hanya ketika mode == "replication". Penelusuran statis tidak dapat membedakan apakah kunci yang tidak direferensikan memang tidak penting atau merupakan bug. Tujuan tracker adalah membuat ketidaksesuaian terlihat, bukan mengawasinya; penghilangan yang senyap adalah mode kegagalan yang dicegah oleh tracker.
Tanggapan penulis Recipe. Ketika penulis Recipe melihat peringatan Ghost Infrastructure untuk kunci yang mereka harapkan dikonsumsi Recipe, perbaikannya adalah menyambungkan kunci tersebut ke dalam templat. Ketika kunci yang tidak dibaca merupakan penghilangan yang disengaja (fitur yang tidak didukung chart, kemudahan penulisan yang sengaja diabaikan Recipe), penulis dapat mendokumentasikan penghilangan tersebut dalam komentar header Recipe agar pembaca berikutnya tahu bahwa ketidaksesuaian itu disengaja.
Peringatan parameter terdeklarasi yang tidak dibaca
Muncul ketika sebuah Aggregate mendeklarasikan entri di bawah spec.parameters: dan tidak ada referensi {{ .parameters.<key> }} dalam teks Aggregate itu sendiri yang membacanya.
Parameter yang dideklarasikan adalah permukaan penulisan untuk memvariasikan satu nilai per Release: Release memenuhi deklarasi tersebut, dan sebuah referensi membawa nilai yang dipenuhi itu ke nilai komponen tempatnya berada. Deklarasi yang tidak dibaca oleh apa pun membuat variasi itu tidak punya tempat untuk mendarat — apa pun yang diberikan Release untuknya, keluaran yang dirender tetap sama. Ini adalah bentuk lingkup parameter dari gejala yang sama yang dibawa oleh kunci values yang ditulis tetapi tidak dikonsumsi oleh apa pun.
Nilai default bukan pengecualian. Nilai default yang tidak dibaca oleh referensi mana pun sama tidak sampainya ke keluaran seperti nilai yang diberikan Release, sehingga deklarasi dengan nilai default dilaporkan persis seperti deklarasi tanpa nilai default.
Referensi mana yang dikumpulkan. Teks Aggregate itu sendiri, dan tidak ada yang lain. Tiga konsekuensi mengikutinya:
- Parameter yang hanya dijangkau oleh predikat
validate:dari skema Component tidak terlihat di sini. Predikat semacam itu menyebut parameter melalui peta parameter yang telah di-resolve, bukan melalui referensi bertitik di dalam Aggregate, sehingga deklarasi dilaporkan sebagai tidak dibaca meskipun predikat tersebut membacanya. - Teks yang tidak dapat di-parse sebagai template tidak menghasilkan himpunan referensi. Melaporkan setiap deklarasi sebagai tidak dibaca akan menenggelamkan diagnostik yang dimunculkan oleh interpolasi atas teks yang sama, sehingga sebagai gantinya tidak ada yang dilaporkan.
- Referensi yang menyebut seluruh peta
parameters— mengiterasinya, atau menjangkau satu entri melalui index — menghitung setiap deklarasi sebagai dibaca, karena referensi yang dikumpulkan kemudian menyebut peta tersebut, bukan kunci di bawahnya, dan tidak ada klaim per kunci yang dapat dibuat.
Penempatan dalam pipeline. Pembacaan berjalan pada tahap resolusi, atas teks mentah Aggregate dan kontrak parameter yang dideklarasikannya — sebelum rendering. Karena itu, peringatan ini muncul dari aggrega validate maupun dari aggrega build.
Bentuk keluaran. Satu baris per deklarasi yang tidak dibaca, yang menyebut Aggregate dan lokator deklarasi tersebut:
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")Temuan muncul dalam urutan Aggregate mendeklarasikan parameternya, sehingga Aggregate yang sama menghasilkan urutan yang sama pada setiap eksekusi. Masing-masing membawa lokator deklarasi, yang menyebut kunci yang bermasalah. Pesannya juga menyebut kunci tersebut, itulah sebabnya kunci muncul dua kali pada baris terminal yang juga mencetak lokator: editor menampilkan pesan pada posisi yang ditempatkannya dan tidak pernah menampilkan teks lokator, sehingga pesan yang tidak menyertakan kunci akan terbaca identik untuk setiap deklarasi yang tidak dibaca.
Visibilitas di editor. Advisori ini juga sampai ke diagnostik editor melalui language server, dengan tingkat keparahan peringatan, diposisikan pada deklarasi yang disebut oleh lokatornya, bukan pada Aggregate secara keseluruhan. Advisori ini dimunculkan sebelum tahap rendering artefak, sehingga tidak memerlukan pengaturan apa pun: sesi editor memunculkannya baik serve.build_on_inspect aktif maupun tidak.
Mengapa peringatan dan bukan penghentian fatal. Sebuah parameter dapat dideklarasikan lebih dulu sebelum referensi yang akan membacanya, dan penelusuran statis tidak dapat membedakan hal itu dari kesalahan — alasan yang sama mengapa pembacaan kunci yang ditulis hanya memberi saran. Compiler tidak mengawasi pengaturan mana yang diekspos oleh seorang penulis.
Peringatan kapabilitas tak terlayani pada binding Provider
Muncul ketika sebuah entri di bawah plugins.providers dalam konfigurasi workspace menyebutkan sebuah capability tanpa uri, dan tidak satu pun plugin provider yang dibaca build melayani kapabilitas tersebut. Plugin yang dibaca sebuah build adalah plugin di direktori katalognya, provider yang ada di dalam kompiler, dan plugin yang dicatat oleh lockfile-nya.
Mengapa peringatan ini ada. Sebuah binding hanya dibaca ketika capability: milik sebuah Recipe meminta kapabilitasnya, dan entri yang tidak menyebutkan plugin tidak memilih apa pun yang tidak akan dipilih oleh resolusi kapabilitas tanpa entri itu. Jadi entri yang kapabilitasnya salah eja — hlem untuk helm — tidak dirujuk oleh apa pun dan tidak mengubah apa pun, dan tanpa peringatan ini tidak ada yang akan memberitahukannya.
Mengapa berupa peringatan dan bukan penghentian fatal. Binding ditulis sekali untuk seluruh workspace, sedangkan sebuah build adalah build dari satu Release. Plugin yang melayani kapabilitas tersebut mungkin hanya dibaca oleh Release lain di workspace, dan build ini tidak dapat melihatnya, sehingga penghentian di sini akan menolak workspace yang sah berdasarkan tebakan. Entri yang juga menyebutkan sebuah plugin adalah kasus yang berbeda: pull meresolusi setiap entri semacam itu, baik digunakan oleh sebuah Recipe maupun tidak, sehingga build memegang plugin tersebut dan mengetahui apa yang dilayaninya, dan kapabilitas yang tidak dilayani plugin itu menyebabkan penghentian — lihat fatal-halts.md “A plugins.providers binding names a plugin that does not serve the capability (Binding plugins.providers menyebutkan plugin yang tidak melayani kapabilitas tersebut)”. Entri untuk kapabilitas yang memang dilayani oleh suatu plugin yang dibaca build tidak dilaporkan sama sekali, baik digunakan oleh sebuah Recipe dalam Release ini maupun tidak.
Penempatan dalam pipeline. Setiap build dan setiap validasi sebuah Release membaca setiap entri dalam konfigurasi workspace yang tersusun — lapisan-lapisan beserta pendamping providers_append-nya — sebelum graf Release dianalisis, sehingga peringatan ini muncul dari aggrega validate --release maupun dari aggrega build, serta dari aggrega pull, yang merender Release satu kali, atas lockfile yang akan ditulisnya, untuk menemukan input eksternal yang diambil oleh build Release tersebut. Penilaian ini tidak mengubah apa pun mengenai plugin mana yang merender sebuah Recipe; hal itu dibaca dari lockfile.
Bentuk keluaran. Satu baris per entri, dalam urutan yang dibawa oleh daftar tersusun, yang menyebutkan kapabilitas tersebut dan kapabilitas terlayani yang berjarak satu suntingan jika ada:
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 readsAmbang batas. Sebuah ejaan hanya disarankan pada jarak satu suntingan dan hanya jika kedua nama memiliki panjang minimal empat karakter, batas yang sama dengan yang digunakan lint near-miss di atas dan dengan alasan yang sama.
Visibilitas di editor. Peringatan ini mencapai diagnostik editor melalui language server dengan tingkat keparahan peringatan. Entri tersebut berada di file konfigurasi, bukan di dokumen yang sedang disunting, sehingga ditempatkan di awal dokumen itu, bukan pada sebuah kunci.
Cakupan metadata per entitas
Envelope entitas mana yang membawa metadata.labels dan metadata.annotations berbeda-beda menurut jenisnya. Component, Feature, dan jenis-jenis library membawa keduanya; Aggregate hanya membawa label; Recipe, FeatureRecipe, Manifest, Release, dan Plugin tidak menerima kunci mana pun dari keduanya pada tingkat envelope. Status Bahasa memuat posisi per entitas dan merupakan rujukan yang perlu dikonsultasikan.
Visibilitas di editor. Tidak ada peringatan yang mencakup hal ini, pada pengaturan apa pun: tidak ada yang perlu dilaporkan, karena sebuah entitas membawa kunci-kunci ini atau tidak menerimanya, dan kunci yang tidak diterima oleh suatu jenis merupakan pertanyaan yang dijawab oleh skemanya saat dokumen dimuat, bukan sesuatu yang dilaporkan tahap rendering sesudahnya. Penulis memeriksa halaman status alih-alih menunggu peringatan.
Peringatan bidang yang tidak didukung
Satu kelas mencakup semua yang Anda tulis yang tidak dapat dipenuhi oleh target. Kelas ini memiliki dua anggota — bidang Workload yang tidak dapat diekspresikan oleh target, dan anotasi aggrega.ai/ yang tidak ditindaklanjuti oleh target — dan keduanya berbagi satu kode kelas dan satu flag penekanan, karena penulis yang ingin membungkam “hal-hal yang diabaikan target ini” ingin semuanya dibungkam bersama-sama, bukan satu sakelar demi satu sakelar.
Bidang Workload yang tidak dapat diekspresikan oleh target
Target berbeda dalam fidelitas. Bidang Workload yang diekspresikan secara native oleh satu target mungkin tidak memiliki padanan di target lain — misalnya, Docker Compose tidak mengenal batasan penjadwalan, akun layanan, atau kelas prioritas. Ketika sebuah Workload mendeklarasikan bidang semacam itu dan target tidak dapat mengekspresikannya, bidang tersebut dihilangkan dengan peringatan, satu peringatan per bidang yang ditulis. Bidang tersebut tidak dibuang diam-diam dan tidak pula diperlakukan sebagai kesalahan fatal.
Perbedaannya dengan penghentian fatal terletak pada granularitasnya. Bentuk yang tidak didukung menghentikan build secara tegas — target sama sekali tidak dapat menghasilkan bentuk workload tersebut. Bentuk yang didukung yang membawa bidang yang tidak dapat diekspresikan tetap dirender, tanpa bidang tersebut, dan memberitahukannya.
Pada target compose, kelas ini saat ini mencakup scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, runAsNonRoot pada kontainer, dan setiap kunci extended-resource kecuali nvidia.com/gpu — misalnya amd.com/gpu — karena kunci tersebut dicadangkan sebagai GPU NVIDIA. Kasus-kasus di bawah ini memancarkan varian parsial dari kelas yang sama, di mana bidang tersebut dikurangi alih-alih dihapus:
persistentTemplate— templating volume per replika tidak tersedia, sehingga volume diciutkan menjadi satu volume persisten bersama alih-alih menghilang.- Entri
attachmentskontainer denganas: env— compose tidak dapat mengambil variabel lingkungan dari attachment, sehingga variabel tersebut dipancarkan dengan nilai kosong. Peringatan menyebut entri tersebut pada koordinat yang ditulis (containers.<name>.attachments.<KEY>, atauinitContainers[<i>].attachments.<KEY>untuk entri init posisional), sehingga jelas variabel mana yang tiba kosong dan kontainer mana pemiliknya. Entri denganas: filedi-bind-mount secara normal dan tidak memicu apa pun. - Entri
volumesyang tidak di-mount oleh kontainer mana pun — peringatan menyebut volume tersebut pada koordinat yang ditulis (volumes.<name>). Apa yang mencapai output bergantung pada variannya: volumepersistentataupersistentTemplatetetap dideklarasikan sebagai volume bernama, yang kemudian dibuat dan dibiarkan tidak terpakai, sedangkan volumeconfigmap,secret, atauephemeralmencapai output hanya melalui titik mount kontainer, sehingga tanpa ada yang me-mount-nya, deklarasi tersebut tidak menghasilkan output sama sekali. Dalam kedua kasus, volume yang Anda tulis tidak melakukan apa pun: mount volume tersebut dari sebuah kontainer, atau hapus. Setiap kontainer dari workload dihitung sebagai pe-mount, termasuk kontainer init, sehingga volume yang hanya di-mount oleh kontainer init tidak memicu apa pun. - Blok
healthyang mendeklarasikan lebih dari satu slot probe — layanan compose hanya membawa satuhealthcheck, sehingga urutan prioritaslive > ready > startupmempertahankan satu slot dan setiap slot lain yang dideklarasikan tidak mencapai bagian mana pun dari output. Peringatan menyebut blok tersebut pada koordinat yang ditulis (containers.<name>.health, atauinitContainers[<i>].healthuntuk entri init posisional) dan menyebut slot yang diterjemahkan maupun slot yang dibuang, sehingga jelas probe mana yang aktif dalam output dan maksud tertulis mana yang tidak berpengaruh. Blok yang mendeklarasikan satu slot diterjemahkan tanpa kehilangan dan tidak memicu apa pun. hostNetworkpada workload yang juga mendeklarasikaninitContainers— layanan milik workload itu sendiri berjalan pada jaringan node, tetapi setiap kontainer init menjadi layanannya sendiri yang bergabung dengan jaringan boundary secara mandiri, karena berbagi namespace layanan utama akan membuat penantian layanan utama terhadapnya menjadi sirkular. Hal ini lebih sempit daripada bentuk pod yang dimodelkan, di mana setiap kontainer berbagi satu namespace, sehingga perbedaannya disebutkan alih-alih dibiarkan ditemukan saat run time. Workload yang mendeklarasikanhostNetworktanpa kontainer init diterjemahkan tanpa kehilangan dan tidak memicu apa pun.
Anotasi yang tidak ditindaklanjuti oleh target
Anotasi aggrega.ai/ adalah direktif platform yang dibaca oleh provider dan diterapkan pada apa yang direndernya — namespace, prefiks registry, akun layanan. Anotasi mana yang dibaca oleh provider merupakan deklarasi provider itu sendiri, dibuat per jenis input, karena provider yang memiliki setiap bidang dari unit deployment yang disintesisnya sendiri sering kali tidak memiliki tempat untuk menaruh nilai yang sama ketika merender artefak vendored. Anotasi yang dikenal luas adalah matriksnya.
Recipe milik node dan setiap fitur yang dilampirkan ke node tersebut dirender secara terpisah, masing-masing melalui target yang disebut oleh capability: miliknya sendiri dan pada jenis input yang dideklarasikan oleh source:, workload:, dan artifacts: miliknya sendiri. Ketika anotasi semacam itu mencapai salah satu render tersebut dan deklarasi target yang di-resolve tidak mencakup kunci tersebut pada satu pun jenis input yang dideklarasikan oleh render itu, target tidak menerapkan apa pun untuk kunci tersebut, dan build memberitahukannya dengan peringatan yang menyebut kunci, target, dan setiap jenis input yang dideklarasikan oleh render tersebut:
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored itKonsekuensi berikut timbul dari cara anotasi mencapai sebuah render, dan masing-masing disengaja:
- Satu baris tertulis dapat menghasilkan beberapa peringatan. Anotasi boundary menurun ke setiap komponen di bawahnya, dan komponen-komponen tersebut dapat dirender melalui target yang berbeda dan jenis input yang berbeda. Setiap peringatan adalah pernyataan yang benar tentang satu render, sehingga Anda mendapatkan satu peringatan per render yang tidak dapat menindaklanjuti kunci tersebut — yang juga memberi tahu Anda bagian mana dari output Anda yang terdampak.
- Fitur yang dilampirkan ke node dinilai berdasarkan FeatureRecipe miliknya sendiri, bukan Recipe milik node. Attachment yang menghasilkan resource-nya sendiri merendernya melalui target yang disebut oleh FeatureRecipe-nya, pada jenis input yang dideklarasikan oleh FeatureRecipe tersebut — sehingga anotasi yang diterapkan oleh target node itu sendiri mungkin tidak mencapai apa pun dalam file attachment, dan sebaliknya juga berlaku. Anda diberi tahu tentang masing-masing secara terpisah, karena keduanya adalah file yang berbeda. Hal yang sama berlaku untuk fitur yang dilampirkan ke boundary alih-alih ke komponen bernama. Attachment yang FeatureRecipe-nya tidak mendeklarasikan satu pun dari
source:,workload:, danartifacts:tidak merender file sendiri — attachment tersebut berkontribusi dengan menyuntikkan nilai, melalui edgeusesyang dibawa oleh Feature-nya, atau melalui pipeline atas dokumen yang dipancarkan oleh hal lain — sehingga tidak ada output miliknya sendiri yang dapat kehilangan anotasi, dan tidak ada yang diperingatkan untuknya. - Render yang mendeklarasikan lebih dari satu jenis input dinilai berdasarkan semuanya. Jenis-jenis yang dideklarasikannya tersusun secara penjumlahan dan output-nya dijumlahkan, sehingga target yang membaca kunci pada salah satu jenis tersebut menerapkannya dan nilainya muncul dalam output yang dirender. Tidak ada yang diperingatkan dalam kasus tersebut, karena tidak ada yang perlu dilaporkan. Peringatan muncul hanya ketika setiap jenis yang dideklarasikan melewatkan kunci tersebut, dan peringatan menyebut semuanya —
on sourced or synthesized input. - Hanya kunci
aggrega.ai/polos yang diperiksa. Kunci dengan sub-prefiks —compliance.aggrega.ai/data-class, atauacme.aggrega.ai/teammilik Anda sendiri — adalah kosakata Anda, yang diteruskan oleh compiler tanpa diinterpretasikan. Tidak ada yang pernah memperingatkan tentang kunci semacam itu. - Target yang sama sekali tidak mendeklarasikan klaim dukungan tidak memicu apa pun. Peringatan membandingkan apa yang Anda tulis dengan apa yang dinyatakan provider sebagai yang dibacanya; provider yang tidak menyatakan apa pun tidak memberi pembanding, dan menyimpulkan penolakan dari diam akan melaporkan klaim yang tidak pernah dibuat oleh penulis provider. Provider yang tidak membaca satu pun kunci menyatakannya dengan
readsNoWellKnownAnnotations: true, seperti yang dilakukanterraform, dan setiap kunci polos yang mencapai salah satu render-nya kemudian diperingatkan.
Mengapa peringatan dan bukan penghentian. Boundary yang secara sah mencakup komponen pada target yang heterogen akan selalu memiliki node yang tidak dapat menindaklanjuti kunci tertentu — itulah bentuk normal dari Release yang mencakup beberapa target, bukan kesalahan — sehingga menolak build akan menolak Releases yang benar. Nilai tersebut diteruskan tanpa diubah, dan peringatan memberitahukannya kepada Anda.
Kode kelas dan jaminan di luar jalur
Setiap peringatan membawa kode kelas unsupported-field yang stabil dan dapat dicocokkan oleh mesin, sehingga perkakas dapat mencocokkan kelasnya alih-alih mengurai teks pesannya. Setiap anggota kelas ini — field yang dihilangkan sepenuhnya, field yang bentuknya dikurangi, dan anotasi yang tidak ditindaklanjuti — membawa satu kode yang sama, dan itulah yang memungkinkan satu filter meredam seluruh kelas. Peringatan-peringatan ini berjalan di luar jalur artefak yang dirender, yang berarti byte yang dirender identik byte demi byte, baik peringatan muncul maupun tidak — meredamnya tidak dapat mengubah keluaran Anda.
Visibilitas di editor. Setiap anggota kelas ini mencapai diagnostik editor hanya jika language server menjalankan tahap perenderan artefak saat memeriksa graf IR — aggrega serve --build-on-inspect, atau kunci konfigurasi serve.build_on_inspect yang ditimpanya, yang nonaktif secara bawaan. Pengaturan itu menambahkan advisori yang dimunculkan build saat merender, dan tidak satu pun pemeriksaan yang menghentikan build. Kode kelas di atas ikut pada diagnostik yang dipublikasikan sebagaimana pada baris terminal, sehingga klien editor mencocokkan kelas yang sama dengan yang dibaca penulis. Setiap entri menyebut sebuah node dan sebuah target, bukan kunci penulisan, sehingga entri itu ditampilkan pada kunci kind: milik Aggregate.
Meredam kelas ini
Kedua perintah yang merender menerima --no-unsupported-field-warnings, yang hanya meredam kelas ini sementara setiap peringatan render lainnya tetap muncul:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warningsFlag ini hanya memengaruhi tampilan dan tidak mengubah keluaran yang dirender. aggrega lint tidak memiliki flag yang setara karena perintah itu tidak menjalankan tahap render — perintah itu hanya memeriksa konvensi publikasi, sehingga tidak ada peringatan render yang dapat muncul di sana.
Gunakan flag ini jika Anda telah menerima fidelitas yang berkurang dengan sengaja — misalnya target compose yang digunakan untuk pengembangan lokal, tempat field penjadwalan dan akun layanan dari Workload produksi memang diharapkan tidak berpengaruh. Selain itu, biarkan flag ini nonaktif: peringatan inilah yang memberi tahu Anda bahwa sebuah field yang Anda tulis tidak mencapai target.
Nilai yang dideklarasikan sensitif dikirim sebagai literal
Muncul ketika sebuah attachment mengisi slot dengan mengirimkan datum yang dideklarasikan sensitif oleh skemanya ke dalam kunci pengiriman sebagai nilai literal, alih-alih sebagai referensi yang di-resolve oleh target saat melakukan deploy.
Bentuk keluaran. Satu baris per kunci pengiriman, yang menyebutkan instans attachment, mekanisme pengiriman tempat kunci tersebut berada, dan kunci itu sendiri, diatribusikan ke node dan target yang merendernya:
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 insteadKode kelas. Advisori ini membawa kode kelas sensitive-by-value yang stabil dan dapat dicocokkan oleh mesin, sehingga tooling mencocokkan kelas tersebut alih-alih mengurai teks pesan. Kode ini dibawa pada baris terminal dan pada diagnostik terstruktur yang dipublikasikan oleh language server, sehingga penulis dan klien editor membaca kelas yang sama — dengan syarat visibilitas editor di bawah, yang menentukan apakah language server memublikasikan advisori ini sama sekali.
Visibilitas editor. Advisori ini mencapai diagnostik editor hanya jika language server menjalankan tahap rendering artefak saat menginspeksi graf IR — aggrega serve --build-on-inspect, atau kunci konfigurasi serve.build_on_inspect yang ditimpanya, yang nonaktif secara default. Pengaturan tersebut menambahkan advisori yang dimunculkan build saat rendering, dan tidak satu pun pemeriksaan yang menghentikan build. Entri ini menyebutkan node dan target alih-alih kunci authoring, sehingga ditampilkan pada kunci kind: milik Aggregate.
Ini adalah kelas tersendiri, dan --no-unsupported-field-warnings tidak mencakupnya. Flag tersebut membungkam kelas unsupported-field di atas; advisori ini tetap muncul di sampingnya. Tidak ada flag yang dapat membungkam advisori ini.
Build berhasil dan byte hasil render tidak berubah. Advisori ini dikirim di luar jalur artefak hasil render, seperti halnya kelas unsupported-field, sehingga apa yang mencapai keluaran Anda tetap sama, baik baris tersebut muncul maupun tidak.
Nilai yang dinyatakan sensitif mencapai target melalui pemetaan nilai
Terpicu ketika sebuah render dari source: menyerahkan keluaran sebuah valuesMapping: kepada targetnya, sementara entitas yang nilainya dibaca oleh pemetaan tersebut menyatakan sebuah leaf values sebagai sensitif: pemetaan sebuah Recipe atas leaf yang dinyatakan oleh Component-nya, atau pemetaan FeatureRecipe dari sebuah Feature yang dilampirkan ke sebuah komponen atas leaf yang dinyatakan oleh Feature tersebut. Sebuah pemetaan adalah satu templat yang kunci keluarannya merupakan ciptaannya sendiri, sehingga tidak ada deklarasi yang menamai satu pun di antaranya, dan target tidak menerima penandaan sensitivitas per kunci untuk leaf tersebut. Inilah satu-satunya bentuk render ketika sebuah deklarasi tidak mencapai kunci yang dirender sementara penulis masih memegang kendali atasnya.
Bentuk keluaran. Satu baris per leaf yang dinyatakan, yang menamai leaf pada koordinat penulisannya serta Recipe atau FeatureRecipe yang pemetaannya menjadi gerbang penggabungan, dan diatribusikan ke node dan target yang merendernya. Baris untuk Feature yang dilampirkan diawali dengan nama lampirannya, karena satu komponen dapat membawa beberapa lampiran dari satu Feature dan baris-barisnya akan identik jika tidak demikian — baris kedua di bawah adalah Feature yang dilampirkan ke komponen api sebagai token:
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 themApa kendali tersebut. Tanpa pemetaan, nilai yang diterima oleh render dari source diberi kunci berdasarkan jalur leaf yang dinyatakan itu sendiri, sehingga deklarasi tersebut bergabung tepat dengan kunci yang direndernya dan penandaan ikut terbawa bersamanya — pada target Terraform, itu adalah berkas override yang dihasilkan sebagaimana dijelaskan di Masukan modul yang dinyatakan sensitif. Dengan pemetaan, penandaan yang memang sampai mencakup keluaran pemetaan secara keseluruhan, dan hanya jika pemetaan membaca nilai yang dinyatakan: penandaan itu mengatur teks yang disusun plugin ketika menolak atau memberi peringatan, dan tidak mengubah satu byte pun yang dirender.
Tiga bentuk tetap senyap, dan hal ini disengaja. Render khusus artefak dan render khusus workload tidak menyerahkan peta nilai sama sekali kepada targetnya, sehingga leaf values tidak memiliki kunci yang dirender untuk ditandai di sana bagaimanapun penulisannya. Feature yang dilampirkan ke sebuah boundary juga tidak memicu apa pun, apa pun yang dipetakan oleh FeatureRecipe-nya: boundary tidak membawa blok values:, sehingga lampiran seperti itu dirender terhadap pilar values yang kosong, tidak satu pun leaf values milik Feature-nya dapat membawa datum di sana, dan menghapus pemetaan tidak akan menandai apa pun. Masing-masing merupakan sifat permanen dari bentuk tersebut, bukan sesuatu yang dapat diubah penulis, sehingga peringatan tentangnya akan terpicu pada setiap build tanpa menyebutkan tindakan apa pun; batas ini dijelaskan di Menyatakan leaf sebagai sensitif sebagai gantinya. Render dari source: tanpa valuesMapping: juga senyap, karena di sana penandaan sampai.
Kode kelas. Advisori ini membawa kode kelas yang stabil dan dapat dicocokkan mesin, sensitivity-not-conveyed, sehingga perkakas mencocokkan kelasnya alih-alih mengurai teks pesan: alat build milik asisten mencantumkan setiap temuan di bawah advisories beserta kode tersebut. Kode ini menamai sebuah kelas temuan, bukan kondisi yang terdaftar, sehingga tidak memiliki baris di tabel di bagian atas halaman ini.
Visibilitas di editor. Advisori ini mencapai diagnostik editor, dengan tingkat keparahan peringatan dan membawa baris yang sama dengan yang dicetak build di terminal, setiap kali language server merender Release — build atau pratinjau build yang diminta darinya, atau inspeksi graf IR dengan aggrega serve --build-on-inspect, atau kunci konfigurasi serve.build_on_inspect yang ditimpanya, yang secara bawaan nonaktif. Entri ini menamai node dan target, bukan kunci penulisan, sehingga ditampilkan pada kunci kind: milik Aggregate.
Ini adalah kelas tersendiri, dan --no-unsupported-field-warnings tidak mencakupnya. Flag tersebut membungkam pemberitahuan fidelitas target, yaitu penilaian berbeda yang dibuat dengan alasan berbeda; advisori ini tetap muncul di sampingnya. Tidak ada flag yang membungkam advisori ini.
Build berhasil dan byte yang dirender tidak berubah. Advisori ini melaporkan suatu ketiadaan — tidak ada kunci yang dirender yang membawa penandaan — dan pemetaan adalah bentuk yang biasa dan didukung, sehingga tidak ada yang perlu dihentikan dan tidak ada apa pun dalam keluaran Anda yang berubah, baik baris tersebut muncul maupun tidak.
Panggilan modul Terraform yang diambil mesin saat inisialisasi
Muncul ketika sebuah modul Terraform yang di-vendor oleh build, atau badan Terraform yang ditulis dalam sebuah Recipe, mendeklarasikan blok module yang source-nya diunduh Terraform saat konfigurasi diinisialisasi alih-alih dibaca dari berkas yang ditempatkan build: alamat registry, URL arsip git, Mercurial, atau HTTP, bucket S3 atau GCS, atau path absolut — atau path lokal yang keluar dari modul yang di-vendor, yang menunjuk berkas yang tidak di-vendor oleh build. Lock menetapkan commit dan digest arsip modul yang di-vendor, dan berkas lock dependensi milik Terraform sendiri hanya mencatat provider, sehingga modul yang ditunjuk oleh panggilan semacam itu diambil pada versi apa pun yang kemudian dipilih mesin dan tidak ada yang dicatat build ini yang mencakupnya.
Apa yang dibacanya. Berkas konfigurasi yang dimuat mesin saat modul dipanggil — yang berada langsung di direktori modul itu sendiri dan di setiap direktori yang dicapai source lokal dari sana — dan tidak ada apa pun di direktori yang tidak dipanggil oleh siapa pun, sehingga panggilan yang ditulis di direktori examples/ atau tests/ sebuah modul tidak dilaporkan. Yang dibaca adalah apa yang dinyatakan sebuah source, tidak pernah modul yang ditunjuk oleh source tersebut. Berkas di bawah spec.boundary.artifacts sebuah Recipe dievaluasi dan ditulis oleh compiler itu sendiri dan tidak diserahkan ke provider mana pun, sehingga blok module yang ditulis di dalamnya tidak dibaca dan tidak memicu peringatan. Validasi input struktural di halaman provider menyatakan aturannya secara lengkap.
Bentuk keluaran. Satu baris per panggilan, yang menyebutkan node dan provider, lalu blok, berkas dan baris tempatnya berada, serta source sebagaimana ditulis; source yang keluar dari modul menyatakan hal itu alih-alih menyebutkan unduhan:
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 vendoredPanggilan-panggilan itu muncul dalam urutan mesin mencapainya — direktori modul itu sendiri terlebih dahulu, lalu setiap direktori dalam urutan source lokal pertama kali mencapainya, dan di dalam sebuah berkas dalam urutan bloknya ditulis — sehingga input yang sama menghasilkan urutan yang sama pada setiap eksekusi. Setiap eksekusi yang melakukan render memunculkannya: aggrega build; aggrega pull, yang me-render Release sekali untuk mengetahui apa yang diambil oleh build-nya; dan aggrega validate atas Recipe yang modulnya disimpan di workspace, yang me-render Recipe tersebut secara tersendiri.
Kode kelas. Setiap peringatan membawa kode kelas yang stabil dan dapat dicocokkan mesin, module-fetched-at-init, sehingga tooling mencocokkan kelasnya alih-alih mengurai teks pesan. Kode ini ikut dalam diagnostik terstruktur: tool build milik asisten mencantumkan setiap temuan di bawah advisories beserta kode tersebut, dan language server memublikasikannya pada setiap entri. Kode ini menamai kelas temuan, bukan kondisi yang terdaftar, sehingga tidak memiliki baris di tabel di bagian atas halaman ini.
Visibilitas di editor. Peringatan ini mencapai diagnostik editor pada lapisan aggrega-build, dengan tingkat keparahan warning, setiap kali language server me-render Release — build atau pratinjau build yang diminta darinya, atau inspeksi graf IR dengan aggrega serve --build-on-inspect, atau kunci konfigurasi serve.build_on_inspect yang ditimpanya, yang secara default nonaktif. Entri ini menyebutkan node, bukan kunci authoring, sehingga digambar pada kunci kind: milik Aggregate.
Ini adalah kelas tersendiri, dan tidak ada flag yang membungkamnya. --no-unsupported-field-warnings membungkam kelas unsupported-field dan tidak mencakup kelas ini.
Build berhasil dan byte hasil render tidak berubah. Peringatan ini disampaikan terpisah dari artefak hasil render, sehingga modul yang di-vendor, badan yang ditulis, dan konfigurasi root identik byte demi byte, baik peringatan itu muncul maupun tidak.
Mengapa peringatan dan bukan penghentian. Modul yang memanggil modul lain adalah input yang sah: Terraform mengambil modul yang dipanggil dan konfigurasinya berfungsi. Yang dilepaskan penulis adalah pin build atas modul tersebut, yang merupakan fakta untuk dilaporkan, bukan kesalahan untuk ditolak, dan apakah pengambilan itu dapat diterima adalah keputusan penulis.
Plugin dijalankan tanpa digest tercatat untuk memeriksanya
Muncul ketika compiler akan menjalankan sebuah plugin, sebuah digest tercatat seharusnya mengatur byte plugin tersebut, dan workspace tidak mencatat satu pun untuknya. Plugin tetap berjalan; peringatan ini adalah cara Anda mengetahui bahwa tidak ada yang membandingkan byte yang dijalankannya dengan byte yang pernah ditinjau seseorang.
aggrega pull menulis digest setiap plugin yang diperolehnya ke dalam lockfile Release, dan setiap resolusi berikutnya membandingkan byte yang ditemukannya dengan digest tersebut. Workspace yang belum pernah di-pull, atau yang lockfile-nya lebih lama daripada plugin yang kemudian dilampirkan oleh konfigurasi, tidak memiliki digest untuk plugin tersebut — sehingga perbandingan tidak memiliki apa pun untuk dibandingkan, dan tanpa baris ini perbandingan itu akan lolos tanpa pemberitahuan.
Langkah pipeline, provider, atau plugin yang dilampirkan pada peran verdict yang entitas Plugin-nya ditulis di salah satu direktori katalog Anda juga tidak memiliki digest, dan pull tidak memberinya digest: pull tidak pernah mem-pin entitas seperti itu, dan build membaca .wasm-nya dari awal setiap kali — dari samping entitas, dalam kasus biasa — alih-alih terhadap apa pun yang dicatat oleh pull. Plugin yang dilampirkan pada peran transform dan ditulis di sana adalah pengecualian: byte-nya membentuk keluaran yang dirender, sehingga pull mencatat digest .wasm yang ditemukannya untuk plugin tersebut, dan setelah tercatat, build memeriksa plugin itu terhadap digest tersebut dan baris ini tidak dimunculkan untuknya.
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 recordedItulah baris yang ditampilkan build, pull, atau validasi di antara peringatan-peringatan lainnya. Perintah yang meresolusi plugin di luar proses semacam itu — memasang, mendaftar, atau menjalankan plugin baris perintah milik workspace itu sendiri, atau aggrega lint yang meresolusi plugin yang dipakainya untuk lint — mencetak kalimat yang sama pada barisnya sendiri, tanpa indentasi.
Baris ini menyebutkan sumber asal byte — kata yang sama yang digunakan aggrega pull dan aggrega plugin list untuknya — dan diakhiri dengan apa yang berlaku untuk sumber tersebut. Untuk byte dari cache konten, perbaikannya adalah melakukan pull terhadap Release, yang mencatat digest dan menjadikan setiap eksekusi plugin tersebut berikutnya sebagai eksekusi yang diperiksa. Untuk byte yang dibaca dari samping entitas Plugin di direktori katalog, pull mencatat digest hanya untuk plugin yang dilampirkan pada peran transform, dan baris ini menyatakannya: untuk plugin lain yang ditulis di sana, tidak ada pull yang mengubahnya, dan cara untuk menempatkannya di bawah digest tercatat adalah memublikasikannya dan mereferensikan entitas yang telah dipublikasikan.
Peringatan ini ditampilkan sekali per plugin untuk setiap perintah, berapa kali pun perintah tersebut meresolusi plugin itu. Render meresolusi provider-nya sekali per node, dan build yang mengisi lockfile-nya sendiri dapat merender Release lebih dari sekali; mengulang baris ini setiap kali akan menenggelamkannya. Layanan editor menampilkannya pada aliran error-nya sendiri sekali selama layanan itu berjalan, sementara setiap permintaan yang dijawabnya melaporkannya kembali ke editor — sehingga jawaban mana pun yang dipakai editor memberi tahu Anda plugin mana saja yang digunakan proses tersebut tanpa verifikasi.
Visibilitas di editor. Peringatan ini mencapai diagnostik editor bersama advisory lain dari proses tersebut, dengan tingkat keparahan peringatan: validasi sebuah Release menerbitkannya pada Aggregate milik Release itu, dan build atau pratinjau build yang diminta editor menerbitkannya pada lapisan aggrega-build. Peringatan ini menyebutkan sebuah plugin, bukan kunci yang Anda tulis, sehingga ditempatkan di awal file. Karena setiap proses melaporkan apa yang diresolusinya, entri ini tetap ada selama sebuah proses meresolusi plugin tersebut tanpa verifikasi dan hilang pada proses pertama yang tidak melakukannya. Peringatan ini tidak mengubah verdict dan tidak menggagalkan resolusi, sehingga jawaban sebuah sesi tetap sama, baik peringatan ini ditampilkan maupun tidak.
Dua resolusi tidak memunculkan apa pun, dan keduanya bukan kelalaian:
- Plugin yang dibawa compiler di dalam dirinya sendiri.
aggrega pullmencatat apa yang diambilnya, dan tidak ada yang perlu diambil untuk byte yang dikirim di dalam binary — sehingga tidak pernah ada digest yang dicatat untuk plugin seperti itu, dan tidak ada yang dapat Anda jalankan untuk mengubahnya. Binary itulah identitas byte tersebut. Plugin bawaan compiler beserta versinya dicantumkan olehaggrega plugin listdan dicap ke dalam bagiantoolchainpada lockfile. - Resolusi yang memang tidak pernah dimaksudkan untuk dikenai digest.
aggrega validate --plugin ./some.wasmmenunjuk ke file yang Anda sebutkan di baris perintah, danaggrega lintmemeriksa artefak yang sedang diperiksanya itu sendiri; pada keduanya, plugin adalah subjek, bukan alat yang dipercaya, sehingga tidak ada catatan yang dapat dijadikan acuan.
Mengapa peringatan dan bukan penghentian. Membaca dokumen tetap layak dilakukan pada workspace yang belum disiapkan siapa pun — menolak melakukan validate atau lint sampai seseorang menjalankan aggrega pull akan membuat perintah pelaporan tidak dapat digunakan tepat pada saat perintah itu paling berguna. aggrega build sama sekali tidak akan menghasilkan artefak tanpa lockfile, sehingga build hanya menjumpai peringatan ini untuk plugin yang digest-nya tidak dicatat oleh lockfile — kasus yang biasa adalah plugin yang dibaca dari samping entitasnya di direktori katalog.
Saat lockfile yang hilang justru menyebabkan penolakan. Ketika editor meminta graf sebuah Release kepada layanan compiler dan workspace sama sekali tidak memiliki lockfile, layanan berhenti dan meminta lockfile alih-alih menggambar graf. Lockfile yang ada tetapi tidak mencatat digest untuk sebuah plugin adalah kasus di atas: plugin tetap berjalan, dan peringatan ini adalah cara Anda mengetahuinya. Graf yang digambar adalah hal yang kemudian menjadi dasar penalaran pembaca, dan graf yang dibangun dari byte yang belum diverifikasi akan terlihat persis sama dengan graf yang telah diperiksa. Lihat aggrega serve.
A published archive carries an entry Windows cannot use (Arsip yang dipublikasikan memuat entri yang tidak dapat digunakan Windows)
Muncul ketika aggrega push — atau --dry-run-nya — menerbitkan arsip yang salah satu entrinya memuat bagian yang tidak dapat ditampung Windows sebagaimana tertulis: nama yang dicadangkan Windows untuk perangkat, seperti CON, PRN, AUX, NUL, COM1 atau LPT1, dalam huruf besar atau kecil apa pun dan dengan ekstensi apa pun di belakangnya, atau bagian yang diakhiri titik atau spasi. aux/x.yaml memuatnya pada direktorinya; report. dan COM1.yaml memuatnya pada nama berkasnya. Di Windows, aggrega menolak membongkar entri seperti itu, sehingga workspace Windows sama sekali tidak dapat menggunakan versi tersebut. Peringatan ini muncul di setiap platform, karena sebuah publikasi ditujukan bagi siapa pun yang menariknya, dan inilah cara pembuatnya mengetahui hal ini sebelum seseorang di Windows mengetahuinya.
Apa yang dibacanya. Nama-nama yang akan dimuat arsip: nama berkas dokumen entitas itu sendiri, lalu setiap berkas yang disebut entitas di sampingnya — berkas-berkas yang dicantumkan Bundling. Jadi, dokumen bernama con.yaml yang mengimpor berkas skema memicu peringatan untuk namanya sendiri. Entitas yang tidak menyebut apa pun diterbitkan sebagai dokumennya saja, yang ditata konsumen dengan nama yang dipilih produk alih-alih nama yang Anda tulis, sehingga entitas tersebut tidak pernah diperingatkan, apa pun nama berkasnya. Sebuah Plugin tidak menerbitkan arsip dan juga tidak pernah diperingatkan.
Bentuk keluaran. Satu baris per entri, pada standard error, dalam urutan nama-nama disusun — dokumen lebih dulu, lalu berkas-berkas yang dibawanya dalam urutan leksikal — sebelum laporan dry run atau laporan publikasi itu sendiri pada standard output:
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 useNilai berkutip pertama adalah entri sebagaimana dinamai arsip. Nilai kedua adalah segmen pertamanya — bagian-bagian yang dipisahkan garis miringnya — yang tidak dapat ditampung Windows, yaitu bagian yang perlu diganti namanya. Baris ini dibuka dengan kalimat tetap kondisi tersebut. Peringatan ini dimunculkan oleh publikasi, bukan oleh aturan yang dievaluasi build, sehingga tidak memiliki baris dalam tabel di bagian atas halaman ini; tabel setiap kondisi mencantumkannya di bawah E0344.
Peringatan ini tidak menolak apa pun. Push, atau dry run-nya, berjalan atau ditolak persis seperti tanpa peringatan ini, dan keluar sebagaimana mestinya.
Ke mana lagi peringatan ini sampai. Alat publish-entity milik asisten menjawab dengan entri yang sama sebagai windows_unusable_entries, dan aggrega serve menjawab aggrega/publishEntity dengan entri tersebut sebagai windowsUnusableEntries; masing-masing tidak ada jika tidak ada entri. Lihat aggrega mcp dan aggrega serve. Layanan ini juga meneruskan baris peringatan itu sendiri kepada permintaan yang meminta dilaporkan, di antara bagian lain laporan publikasi.
Visibilitas di editor. Tidak ada sebagai diagnostik: penerbitan bukanlah build, sehingga tidak ada apa pun di sini yang sampai ke daftar masalah. Editor yang menerbitkan melalui layanan membaca windowsUnusableEntries pada jawabannya.
Mengapa peringatan dan bukan penghentian. Nama seperti itu sah, dan Linux serta macOS menggunakan berkas tersebut sesuai namanya, sehingga menolak publikasi berarti menolak entitas yang berfungsi berdasarkan tebakan tentang siapa yang akan menariknya. Apakah perlu mengganti nama adalah keputusan pembuatnya.