Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Penghentian fatal

Penghentian fatal adalah galat waktu kompilasi yang menghentikan build sebelum keluaran apa pun dihasilkan. Setiap penghentian menyebutkan file, entitas, dan bidang yang bermasalah, menjelaskan apa yang tidak dapat diselesaikan oleh kompiler, dan menunjukkan perubahan penulisan konkret yang memperbaikinya. Kompiler tidak pernah diam-diam memperbaiki atau menulis ulang masukan Anda — jika ada yang salah, build berhenti dan memberi tahu Anda letaknya.

Katalog ini disusun berdasarkan tahap kompilasi tempat setiap penghentian terjadi.

Setiap entri di bawah ini mengutip pesan yang dicetak build untuk kondisi yang didokumentasikannya: kalimat tetap yang menyatakan kondisi tersebut, lalu apa pun yang diberikan oleh kejadian itu. Di terminal, pesan tersebut muncul di dalam sebuah bingkai — kepala dalam tanda kurung siku yang memuat kategori dan kode singkat kondisi, penunjuk ke file dan kunci yang bermasalah yang diikuti oleh instance yang menjadi pokok kegagalan sebagai (instance <name>) — atau hanya instance itu, sebagai instance <name>, jika tidak ada file yang berlaku — serta pesan pada baris di bawahnya — sehingga satu baris utuh yang ditempel dari build tidak akan cocok dengan entri di sini, sedangkan pesan di dalamnya akan cocok; error-translation.md menguraikan bingkai tersebut secara lengkap.

Jika Anda datang dari build dengan kode singkat di tangan — huruf E dan empat digit, di kepala diagnostik dalam tanda kurung siku — mulailah dari Menemukan penghentian dari kode singkat yang dicetak build di bagian bawah halaman ini, yang mencantumkan setiap kondisi yang dikatalogkan di sini beserta kode singkat yang dicetak build untuknya.

Saat memuat berkas Anda

Kompiler membaca setiap Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin, dan Release yang dirujuk oleh build Anda, memvalidasi masing-masing terhadap skemanya, dan menginterpolasi parameter bertipe dari Release ke dalam Aggregate.

Anchor YAML dialiaskan di dalam kontennya sendiri

Sebuah dokumen memberi anchor pada sebuah node dengan &name lalu mengaliaskannya dengan *name di suatu tempat di dalam konten yang dicakup anchor tersebut. Memperluas alias itu mereproduksi anchor, yang kontennya kembali memuat alias tersebut, sehingga dokumen menggambarkan struktur tanpa akhir. Tidak ada sesuatu yang berhingga untuk dibaca, apalagi divalidasi, dan build berhenti alih-alih memulai penelusuran yang tidak dapat selesai.

Membaca YAML menjadi pohon tidak memperluas alias, sehingga dokumen dengan bentuk ini dibaca tanpa keluhan dan baru gagal ketika sesuatu menelusurinya. Karena itu, penolakan berada di antara pembacaan dan penelusuran — dan sebuah build membaca YAML yang ditulis pada lebih dari satu titik, sehingga kondisi yang sama dapat ditemui di lebih dari satu titik. Empat titik melaporkannya, masing-masing membingkai penjelasan yang sama dengan informasi apa pun yang menunjukkan letak dokumen pada permukaan tersebut:

  • Berkas entitas, saat dibaca. Build berhenti sebelum entitas tersebut diperiksa terhadap skemanya, sehingga halt ini menyebutkan sebuah anchor alih-alih sebuah field, dan tidak memuat baris dan kolom: pada titik itu dokumen belum memiliki posisi yang dapat ditunjuk secara berguna oleh diagnostik.
  • Badan skema, saat dikompilasi. Pilar spec.schema: dikompilasi dari bentuk ringkas menjadi dokumen JSON Schema setelah berkasnya dibaca, sehingga halt ini terjadi selama kompilasi tersebut, bukan sebelumnya, dan memang memuat baris. Bentuk yang tidak dapat ditangkap oleh pembacaan sebelumnya adalah badan escape $jsonschema:: badan escape adalah block scalar — teks biasa, tanpa anchor — selama berkas di sekitarnya dibaca, dan anchor-nya baru menjadi anchor ketika teks itu sendiri di-parse, satu tingkat ke bawah. Jika siklus berada di dalam blok semacam itu, halt juga menyebutkan $jsonschema sebagai kata kunci yang badannya memuat siklus tersebut.
  • Skema workload milik Plugin provider, saat Plugin dimuat. spec.provider.workloadSchema ditulis sebagai block scalar: teks biasa selama berkas Plugin itu sendiri dibaca, tanpa anchor pada titik itu, dan anchor-nya baru menjadi anchor ketika teks itu di-parse sebagai dokumen tersendiri, satu tingkat ke bawah. Parse tersebut dan kompilasi yang mengikutinya sama-sama terjadi saat Plugin dimuat, sehingga halt ini terjadi di sana, bukan saat berkas dibaca, dan memuat baris. Jika siklus berada di dalam escape $jsonschema: di dalam badan skema, halt juga menyebutkan $jsonschema sebagai kata kunci yang badannya memuat siklus tersebut. Lihat ../entities/plugin.md untuk permukaan penulisan field tersebut.
  • Fragmen CloudFormation yang telah di-render, saat provider membacanya. Sebuah Recipe cloudformation menulis fragmen, dan badan artifacts: adalah templat — sehingga yang dibaca provider adalah teks hasil render templat tersebut, konten yang belum ada ketika berkas Anda sedang dibaca. Karena itu, halt ini terjadi saat output sedang di-render, setelah semua pemeriksaan skema lolos. Lihat ../providers/cloudformation.md untuk permukaan penulisan fragmen.

Yang ditolak adalah rekursi, bukan penggunaan ulang atau kedalaman. Memberi anchor pada konten bersama dan merujuknya dari banyak tempat adalah pola penulisan yang didukung — lihat ../entities/aggregate.md “YAML anchor patterns (defs: block)” dan ../entities/manifest.md “YAML anchors for DRY manifests” — dan rujukan yang diperluas lalu berakhir dimuat secara normal, berapa kali pun rujukan itu muncul dan sedalam apa pun dokumen bersarang; kedalaman saja tidak pernah menjadi alasan halt ini. Yang menghentikan build adalah anchor yang dicapai ketika build masih berada di dalamnya, termasuk jika anchor itu dicapai secara tidak langsung, melalui anchor kedua yang dideklarasikan di bawahnya. Pesan menyebutkan anchor tempat loop kembali menutup, yang belum tentu anchor terluar dalam dokumen.

Pesan yang dikeluarkan. Keempatnya memuat penjelasan yang sama, dan hal ini disengaja: ini adalah satu kondisi yang ditemui di empat titik, dan penulis yang telah belajar membacanya sekali tidak perlu mempelajarinya lagi. Hanya bingkai yang menunjukkan letak dokumen yang berbeda.

anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (anchor dialiaskan di dalam kontennya sendiri, sehingga dokumen diperluas tanpa akhir; arahkan alias tersebut ke konten yang dideklarasikan di luar anchor, atau tulis konten secara lengkap)

Berkas entitas dibingkai oleh pemeriksaan envelope yang sedang membacanya dan path tempat berkas itu dibaca:

document envelope validation failed: envelope: parse <path>: <the explanation above> (validasi envelope dokumen gagal: envelope: parse)

Badan skema dibingkai oleh posisinya di dalam skema, dan oleh kata kunci escape jika siklus berada di dalam blok $jsonschema:. Build melaporkannya di bawah tag CATALOG_ERROR, yang juga menyebutkan berkas, entitas, dan pilar yang badannya gagal dikompilasi:

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above> (compactform pada posisi tersebut, kata kunci)

Skema workload milik Plugin provider memuat bingkai bentuk ringkas yang sama; yang berbeda adalah tag CATALOG_ERROR di sekelilingnya, yang menyebutkan Plugin dan spec.provider.workloadSchema sebagai pengganti entitas dan pilarnya.

Fragmen yang telah di-render dibingkai oleh provider yang membacanya:

cloudformation-provider: parse fragment: <the explanation above> (cloudformation-provider: parse fragmen)

Cara memperbaiki: arahkan alias ke konten yang dideklarasikan di luar anchor tempat alias itu saat ini berada, atau tulis konten yang berulang secara lengkap di titik penggunaannya. Pada Aggregate atau Manifest, blok defs: di tingkat root adalah tempat yang wajar untuk anchor bersama — blok itu berada di luar setiap blok yang merujuknya, sehingga anchor yang dideklarasikan di sana tidak dapat dicapai dari dalam dirinya sendiri. Pada jenis entitas lain, yang tidak memiliki blok defs:, beri anchor pada konten bersama di tempat yang bukan merupakan induk dari blok yang merujuknya. Sebuah anchor dapat dirujuk dari sejumlah tempat mana pun dan dari kedalaman mana pun; satu-satunya bentuk yang tidak dapat diambilnya adalah rujukan yang kembali mendarat di dalam konten yang dicakup anchor tersebut.

Perbaikan yang sama berlaku di mana pun halt ditemui, dan bingkai memberi tahu Anda dokumen mana yang perlu dibuka: berkas entitas itu sendiri, blok $jsonschema: di dalam pilar skema, badan workloadSchema di dalam Plugin provider, atau badan artifacts: yang output hasil render-nya dibaca oleh provider. Dalam kasus terakhir, anchor berada di templat yang Anda tulis, bukan di teks hasil render — proses render mereproduksinya dengan setia.

Parameter type mismatch / contract violation (Ketidakcocokan tipe parameter / pelanggaran kontrak)

Release memberikan nilai yang tipe atau bentuknya tidak cocok dengan yang dideklarasikan Aggregate untuk parameter tersebut. Validator kontrak parameter menangkap ketidakcocokan tipe, pelanggaran enum, pelanggaran rentang, pelanggaran pola, string yang bukan instans valid dari format yang dideklarasikan, kegagalan predikat validate:, dan parameter wajib yang tidak ada sebelum interpolasi templat apa pun dijalankan. Nama-nama yang dapat diambil oleh format, beserta apa yang diperiksa masing-masing, tercantum di bawah Format bernama.

Pesan yang dikeluarkan — kalimat yang menyatakan kondisinya, lalu entitas yang bermasalah, jalur field, dan detail batasan:

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (kontrak parameter dilanggar (Aggregate, di, parameter diharapkan bertipe; diterima))

Untuk parameter yang dideklarasikan required: true tanpa default: dan tanpa nilai yang diberikan Release, laporan membawa kondisi yang berbeda dan kode singkat yang berbeda:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (parameter wajib tidak diberikan (Aggregate, di, parameter wajib tetapi tidak diberikan oleh Release))

Hanya detail setelah jalur field yang berubah sesuai batasan yang tidak terpenuhi. Kalimat dan bingkai dalam tanda kurung di sekitarnya selalu sama, sehingga kalimat itulah bagian yang dicocokkan dan detailnya bagian yang dibaca. Detail yang dicetak build, satu per jenis batasan:

parameter "<parameter>" value <value> not in enum [<members>] (nilai parameter tidak ada dalam enum) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (nilai parameter tidak cocok dengan pola) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (nilai parameter bukan format yang valid) parameter "<parameter>" value <value> above max <max> (nilai parameter melebihi maksimum) parameter "<parameter>" failed validate predicate (parameter gagal pada predikat validate) parameter "<parameter>" validate predicate error: <detail> (galat predikat validate pada parameter)

<reason> pada kegagalan format menyatakan apa yang salah pada nilai tersebut menurut istilah format itu sendiri. Nilai di dalam kontrak bersarang disebut menurut jalurnya, sehingga format yang dideklarasikan kontrak items: diperiksa pada setiap elemen dan laporan menyebut elemen yang gagal: elemen kedua dari parameter hosts dilaporkan di .spec.parameters.hosts.1, dengan detail yang menyebut "hosts.1".

Parameter yang mendeklarasikan validateMessage: mengganti seluruh detail itu dengan teksnya sendiri, sehingga laporan berbunyi parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) — bingkainya tidak berubah dan kalimat Anda menempati posisi detail batasan.

Kondisi yang sama mencakup kontrak yang, sebagaimana ditulis, tidak dapat membatasi apa pun. pattern: yang bukan ekspresi reguler valid ditolak saat kontrak parameter Aggregate dibaca, sebelum nilai Release apa pun diperiksa, sehingga build dihentikan baik Release memberikan parameter tersebut maupun tidak. Laporan menunjuk ke kunci — .spec.parameters.<parameter>.pattern, atau jalur melalui kontrak bersarang seperti .spec.parameters.<parameter>.items.pattern — dan detailnya menyebut deklarasi, pola, dan alasannya:

parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (pola parameter tidak dapat dikompilasi)

format: yang menyebut format di luar himpunan yang didukung juga tidak dapat membatasi apa pun, dan ditolak pada titik yang sama, sebelum nilai Release apa pun diperiksa, sehingga build juga dihentikan baik Release memberikan parameter tersebut maupun tidak. Di dalam kontrak bersarang — di bawah items:, properties: atau valuesType: — kondisi inilah yang menolaknya: laporan menunjuk ke kunci, seperti .spec.parameters.<parameter>.items.format, dan detailnya menyebut deklarasi, format sebagaimana ditulis, dan setiap nama yang didukung:

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (parameter: format tidak didukung; format yang didukung adalah email, uri, hostname, ipv4, ipv6, uuid, date-time, date)

Pada deklarasi parameter itu sendiri, nama yang sama ditolak satu langkah lebih awal, oleh skema Aggregate, yang format-nya hanya menerima nama-nama yang didukung. Penolakan itu adalah dokumen yang gagal memenuhi skema jenisnya — kondisi yang berbeda, dengan kode singkatnya sendiri, E0215 — dan aggrega pull serta aggrega validate --release mencantumkannya setelah melaporkan referensi aggregate: milik Release sebagai tidak dapat di-resolve (E0170), karena Aggregate yang membawa nama tersebut tidak dimuat:

document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (validasi envelope dokumen gagal (Aggregate, di); spec.parameters..format: enum: tidak sama dengan salah satu dari: [email uri hostname ipv4 ipv6 uuid date-time date]. perbaiki dokumen agar sesuai dengan skema jenisnya)

Detail galat predikat mencakup kedua cara predikat validate: dapat gagal menghasilkan putusan: fungsi yang tidak didaftarkan oleh permukaan tersebut, dan referensi ke sesuatu selain .value. Masing-masing dilaporkan terhadap predikat, bukan terhadap nilai, dan masing-masing menyebut apa yang tidak dapat di-resolve.

Predikat validate: membaca nilai yang sedang divalidasi sebagai .value, dan itulah satu-satunya nama yang didefinisikannya. Predikat yang menyebut hal lain ditolak sebelum dijalankan, sehingga referensi yang salah ketik dilaporkan sebagai kesalahan penamaan sebagaimana adanya, alih-alih di-resolve menjadi kosong dan muncul sebagai nilai yang gagal validasi.

Cara memperbaiki: ubah nilai Release agar sesuai dengan batasan type / enum / min / max / pattern / format yang dideklarasikan parameter, berikan parameter wajib yang tidak ada, perbaiki pattern: yang tidak dapat dikompilasi, ganti format: yang menyebut format yang tidak didukung dengan salah satu format bernama atau hapus, perbaiki predikat validate: yang menyebut sesuatu selain .value atau menghasilkan sesuatu selain true atau false, atau perluas deklarasi Aggregate agar menerima bentuk yang benar-benar Anda butuhkan.

Aturan bentuk Recipe

Sebuah Recipe menyusun keluarannya dari tiga jenis input — sourced, synthesized, dan artifacts — yang dijelaskan dalam ../../architecture/16-recipe-input-composition.md. Bentuk Recipe yang valid dibatasi oleh aturan komposisi di bawah ini. Aturan-aturan tersebut berbeda dalam hal kapan diperiksa — saat Recipe dimuat, saat sebuah node dirender, atau saat keluaran diemisikan — jadi bacalah setiap entri untuk mengetahui titik pemeriksaan kondisinya sendiri.

Setiap aturan dinamai berdasarkan apa yang dibatasinya. Tidak ada penomoran, dan tidak ada yang dicadangkan: sebuah nama menunjukkan bagian Recipe mana yang perlu dibuka, dan nama itu tetap menunjukkannya bagaimanapun daftar di bawah bertambah atau diurutkan ulang. Jika Anda perlu mencatat suatu kondisi secara permanen — dalam gerbang CI, sebuah issue, atau runbook — gunakan kode-nya, yaitu pengidentifikasi yang dicantumkan sentinels.md untuk kondisi tersebut dan yang tetap sama selama paket-paket di sekitarnya berkembang.

Penghentian bentuk Recipe disusun dengan cara yang sama. Diawali dengan kalimat yang menyatakan aturan, lalu menyebutkan apa yang diberikan oleh Recipe tersebut, kemudian detail yang spesifik untuknya:

<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail>

Kalimat pembuka bersifat tetap untuk setiap aturan — teks yang sama setiap kali aturan itu menghentikan build, tahap mana pun yang mendeteksinya — sehingga bagian itulah yang dicocokkan pada keluaran, dan itulah teks yang dicantumkan sentinels.md untuk kondisi aturan tersebut. Semua yang mengikutinya bervariasi sesuai Recipe yang bermasalah: nilai dalam tanda kurung menunjukkan dokumen mana, aturan mana berdasarkan nama, dan di mana, sedangkan kalimat penutup adalah saran untuk kejadian tersebut. Posisinya adalah file tempat Recipe dimuat jika aturan menyangkut dokumen secara keseluruhan, dan jalur bertitik ke kunci yang Anda tulis — .spec.outputComponentLabels.hosting — jika aturan menyangkut satu hal di dalamnya; kunci yang mengandung titik sendiri tidak dapat dieja sebagai satu segmen tambahan tanpa sama-sama terbaca sebagai dua segmen, sehingga jalur berhenti pada blok yang memuatnya dan saran mengutip kunci tersebut.

Build mencetak seluruh baris di bawah tag CATALOG_ERROR, yang menandakan bahwa kegagalan disebabkan oleh entitas katalog (Recipe, atau provider yang diikatnya), bukan oleh Aggregate atau Release. File tempat Recipe dimuat dicetak di samping tag, sehingga aturan yang diposisikan pada sebuah kunci tetap memberi tahu Anda file mana yang perlu dibuka.

valuesMapping memerlukan source

Sebuah Recipe mendeklarasikan valuesMapping tetapi tidak source. Tanpa source untuk ditimpa, tidak ada yang menerima nilai yang dipetakan. Aturan ini diperiksa saat Recipe dimuat.

Pesan yang diemisikan:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (Recipe: valuesMapping memerlukan source (Recipe, aturan values-mapping, di jalur). deklarasikan pointer source: di samping valuesMapping (atau hapus valuesMapping jika tidak dimaksudkan adanya overlay))

Cara memperbaiki: tambahkan pointer source: (referensi chart, modul, atau file compose) di samping valuesMapping, atau hapus valuesMapping dan gunakan jenis input lain (workload: untuk keluaran yang disintesis, artifacts: untuk emisi manifest secara langsung).

workload: memerlukan provider yang dapat melakukan sintesis

Sebuah Recipe mendeklarasikan workload: (mode synthesized) untuk provider yang tidak mengimplementasikan sintesis Workload. Dukungan mode synthesized merupakan properti provider — katalog pustaka standar mendeklarasikan workloadSchema pada provider yang mampu melakukan sintesis berdasarkan konvensi, tetapi pemeriksaan didasarkan pada kapabilitas provider, bukan pada keberadaan field tersebut.

Dua permukaan melaporkannya, dan hanya satu yang menentukan build. Penghentian dimunculkan saat render, setelah provider node diikat dan setelah jenis input yang dideklarasikan Recipe-nya dibaca, sehingga laporan itu menyebutkan node. aggrega validate melaporkan temuan yang sama lebih awal, sebelum node mana pun diikat, dengan membaca Recipe secara mandiri — sehingga laporan itu menyebutkan Recipe dan versinya. Keduanya tidak membaca kumpulan Recipes yang sama: laporan awal dimunculkan untuk setiap Recipe yang mendeklarasikan workload: sama sekali, sedangkan penghentian dimunculkan untuk setiap jenis input yang dideklarasikan node yang tidak dapat dipenuhi provider-nya. Jadi Recipe yang memasangkan workload: dengan source: tetap dihentikan, dan dihentikan karena workload — mendeklarasikan jenis input yang dapat dirender provider tidak meloloskan jenis yang tidak didukung.

Satu batasan dalam hal itu: artifacts: diperiksa terhadap dukungan standalone-artifacts hanya jika merupakan satu-satunya jenis yang dideklarasikan node. Bersama source: atau workload:, file-filenya ikut sebagai keluaran tersusun, yang tidak diatur oleh kapabilitas tersebut.

Pesan yang diemisikan saat render. Kategori penyebab kegagalan sampai kepada Anda di bagian kepala diagnostik dalam tanda kurung siku, bukan di dalam pesan. Pesan diawali dengan kalimat tetap yang menyatakan kondisi, lalu menyebutkan node, provider, jenis yang dideklarasikan dan ditolak, serta jenis yang didukung provider tersebut. Jika sebuah node mendeklarasikan dua jenis yang tidak dapat dipenuhi provider-nya, yang pertama dalam urutan source → workload → artifacts adalah yang dilaporkan, sehingga temuan tetap mengenai satu baris Recipe Anda:

provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode> (provider tidak mendukung jenis input node (node). provider tidak mendukung recipe mode tersebut (provider ini mendukung: jenis-jenis); deklarasikan salah satu jenis input yang didukung, atau targetkan provider yang mendukung mode tersebut)

Bagian kepala memuat kategori dan kode singkat kondisi ini, E0265, yang merupakan pengidentifikasi untuk dicatat ketika Anda perlu menyebut penghentian ini secara permanen — dalam gerbang continuous integration, sebuah issue, atau runbook. Sebuah nomor diberikan sekali lalu bersifat tetap, sehingga tetap sama bagaimanapun kata-kata di sekitarnya diperbaiki; tabel semua kondisi menguraikannya, dan kalimat pembuka di atas adalah yang dicocokkan ketika Anda bekerja dari teks, bukan dari pengidentifikasi.

aggrega validate melaporkan klausa yang sama di bawah Recipe yang memuat blok tersebut, diawali dengan permukaan yang membacanya dan dikepalai dengan kode singkat kondisi ini, karena laporan awal tersebut adalah kondisi yang sama:

input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (input-kind: Recipe: provider tidak mendukung recipe synthesized (provider ini mendukung: jenis-jenis); deklarasikan salah satu jenis input yang didukung, atau targetkan provider yang mendukung synthesized)

Pada seluruh katalog, itu adalah satu baris; dengan --release, kepala berada di barisnya sendiri di atas klausa. Diagnostik editor untuk temuan yang sama membawa E0265 sebagai kodenya.

Cara memperbaiki: ikat Recipe ke provider yang melakukan sintesis (paling umum helm atau compose), atau migrasikan Recipe ke jenis input lain (artifacts: untuk emisi manifest secara langsung, atau source: + valuesMapping: jika ada chart/modul).

Validasi konten Workload per provider. Saat ini workloadSchema milik provider hanya bersifat dokumentasi dan tidak memvalidasi isi Workload; isi divalidasi terhadap skema Workload tertanam milik platform. Ketika synthesizer Workload berbasis Wasm dirilis, workloadSchema menjadi kontrak per provider yang digunakan synthesizer untuk memvalidasi isi Workload (penghentian tingkat konten yang berbeda).

The provider does not support omits (Provider tidak mendukung omits)

Sebuah Recipe atau FeatureRecipe mendeklarasikan omits: dan provider yang merendernya tidak mendeklarasikan bahwa ia mengecualikan dokumen yang dirender. Mengecualikan dokumen dari apa yang dirender oleh sebuah sumber hanya dapat dilakukan oleh provider — hanya provider yang mengetahui dokumen mana yang dirender oleh sumber dan apa nama masing-masing — sehingga provider yang tidak melakukannya akan merender setiap dokumen yang disebutkan oleh entri dan melaporkan keberhasilan. Sebagai gantinya, build menolak sebelum apa pun dirender, sehingga kunci tersebut tidak pernah diam-diam tidak berbuat apa-apa.

Apakah sebuah provider mengecualikan dokumen dibaca dari deklarasi provider itu sendiri tentang apa yang didukungnya, bukan dari daftar provider yang disimpan oleh compiler. Setiap entri dihitung, apa pun yang dirender oleh when:-nya, karena kemampuan provider untuk memenuhi kunci tersebut tidak bergantung pada entri mana yang dipertahankan oleh sebuah build. Provider helm, compose, dan cloudformation memenuhi kunci tersebut. helm-chart dan terraform meneruskan sumbernya untuk dirender saat di-deploy, sehingga tidak ada dokumen yang dirender pada waktu build untuk dikecualikan, dan keduanya ditolak.

Penolakan diputuskan setelah Recipe setiap komponen dan FeatureRecipe setiap lampiran terikat dan setiap provider telah mendeskripsikan dirinya — sebelum komponen pertama dirender dan sebelum entri apa pun dievaluasi, sehingga build yang ditolak di sini tidak merender apa pun. Pemeriksaan ini diajukan untuk setiap dokumen yang merender sebuah sumber: Recipe sebuah komponen; FeatureRecipe yang diikat oleh sebuah lampiran pada sebuah komponen, sekali untuk setiap komponen yang membawa lampiran tersebut; dan FeatureRecipe yang menghasilkan sekali untuk sebuah boundary, sekali, pada boundary yang mendeklarasikannya. Setiap dokumen yang bermasalah dilaporkan dalam satu build; jika ada lebih dari satu, temuan dikelompokkan di bawah documents declaring omits whose provider does not honour them. Dokumen yang terikat pada provider yang tidak dapat di-resolve oleh build tidak dilaporkan di sini: build tersebut berhenti di tempat provider dipilih, dengan menyebutkan pengikatannya.

Pesan yang dikeluarkan, diposisikan pada kunci komponen itu sendiri di bawah components: untuk entri sebuah Recipe (komponen yang ditulis di dalam sebuah subsistem diposisikan terlebih dahulu di bawah kunci subsistem tersebut), pada kunci lampiran di blok features: yang menulisnya untuk entri FeatureRecipe pada sebuah komponen, dan pada .spec.boundaries.<boundary>.features.<attachment> di Release untuk FeatureRecipe yang menghasilkan sekali untuk boundary-nya. Kategori sampai kepada Anda di bagian kepala dalam kurung siku; pesan menyebutkan provider terlebih dahulu, lalu komponen yang dirender oleh dokumen tersebut:

provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it (provider tidak mendukung omits. kontrak provider ini tidak mendeklarasikan bahwa ia mengecualikan dokumen yang dirender; hapus kunci omits, atau render sumber melalui provider yang kontraknya mendeklarasikannya)

Temuan sebuah FeatureRecipe menyebutkan lampiran setelah komponen — node "<node-id>", attachment "<attachment>" — dan FeatureRecipe yang menghasilkan sekali untuk boundary-nya menyebutkan boundary dan lampiran sebagai pengganti komponen: boundary "<boundary>", attachment "<attachment>".

Bagian kepala membawa kode pendek kondisi ini, E0335.

Cara memperbaiki: hapus kunci omits:, atau render sumber melalui provider yang memenuhinya. Jika sebuah Recipe helm-chart atau terraform mengambil chart atau modul lokal, satu baris di .aggregaignore di samping Recipe tersebut akan mengecualikan sebuah file dari sumber itu sebagai gantinya, mulai saat Recipe berikutnya di-pin — lihat aggrega pin.

The provider does not support boundary artifacts (Provider tidak mendukung artefak boundary)

Sebuah Recipe mendeklarasikan spec.boundary.artifacts — file untuk output bersama dari boundary tempat ia dirender — dan provider yang merendernya tidak mendeklarasikan bahwa ia menerima file semacam itu. Compiler menulis file tersebut sendiri, di samping apa yang dirakit provider untuk boundary, dan tidak menyerahkan satu pun kepada provider, sehingga apakah file yang ditempatkan di sana bermakna merupakan properti dari target provider. Target yang tidak membacanya akan mengirimkannya dan mengabaikannya, dan konfigurasi yang dibawanya tidak akan pernah berlaku; sebagai gantinya, build menolak sebelum apa pun dirender.

Apakah sebuah provider menerima file tersebut dibaca dari deklarasi provider itu sendiri tentang apa yang didukungnya, bukan dari daftar provider yang disimpan oleh compiler. Setiap entri dihitung, apa pun hasil rendernya. Provider terraform menerimanya, dengan menulis masing-masing di samping konfigurasi root boundary; helm, compose, helm-chart, dan cloudformation tidak, dan ditolak.

Penolakan diputuskan setelah Recipe setiap komponen terikat dan setiap provider telah mendeskripsikan dirinya — sebelum komponen pertama dirender dan sebelum entri apa pun dievaluasi, sehingga build yang ditolak di sini tidak merender apa pun. Setiap Recipe yang bermasalah dilaporkan dalam satu build, sekali untuk setiap komponen yang direndernya; jika ada lebih dari satu temuan, temuan dikelompokkan di bawah Recipes declaring boundary artifacts whose provider does not accept them. Recipe yang terikat pada provider yang tidak dapat di-resolve oleh build tidak dilaporkan di sini: build tersebut berhenti di tempat provider dipilih, dengan menyebutkan pengikatannya.

Pesan yang dikeluarkan, diposisikan pada .spec.boundary di Recipe, tempat perubahan dilakukan. Kategori sampai kepada Anda di bagian kepala dalam kurung siku; pesan menyebutkan provider terlebih dahulu, lalu komponen yang dirender oleh Recipe:

provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it (provider tidak mendukung artefak boundary. kontrak provider ini tidak mendeklarasikan bahwa ia menerima file yang ditulis ke output bersama sebuah boundary; hapus blok boundary, atau render Recipe melalui provider yang kontraknya mendeklarasikannya)

Bagian kepala membawa kode pendek kondisi ini, E0351.

Cara memperbaiki: hapus blok boundary:, atau render Recipe melalui provider yang menerimanya. File yang menjadi milik komponen, bukan milik boundary, sebaiknya menjadi entri artifacts:.

At least one input kind must be present (Setidaknya satu jenis input harus ada)

Sebuah Recipe tidak mendeklarasikan jenis input apa pun: tidak ada source yang dipasangkan dengan valuesMapping, tidak ada workload:, tidak ada artifacts:. Recipe semacam itu tidak menghasilkan output dan tidak memiliki permukaan render. Aturan ini diperiksa saat Recipe dimuat.

File Recipe dengan bentuk seperti itu lebih dulu berhadapan dengan skema Recipe: skema mewajibkan, pada setiap provider, salah satu dari source, valuesMapping, workload, atau artifacts, sehingga pemeriksaan amplop dokumen menolak file tersebut di bawah E0215 sebelum aturan ini berjalan, dengan satu cabang untuk setiap kunci:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (validasi amplop dokumen gagal (Recipe): spec: tidak ada cabang anyOf yang cocok: cabang 0 tidak memiliki properti wajib “source”; cabang 1 tidak memiliki properti wajib “valuesMapping”; cabang 2 tidak memiliki properti wajib “workload”; cabang 3 tidak memiliki properti wajib “artifacts”. Perbaiki dokumen agar sesuai dengan skema jenisnya)

Pesan yang diemisikan:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts (Recipe: diperlukan setidaknya satu jenis input. deklarasikan salah satu dari: source (dengan valuesMapping), workload, artifacts)

Cara memperbaiki: tambahkan jenis input yang sesuai dengan maksud penulisan Recipe. Recipe untuk layanan yang tidak disediakan oleh build — database atau API yang sudah berjalan di tempat lain — mendeklarasikan workload: dengan form: reference beserta endpoint-nya (dan secara opsional port), lalu memublikasikan nilai koneksinya di bawah provides: seperti Recipe lainnya: helm merendernya sebagai ExternalName Service, compose tidak merender apa pun untuknya, dan pada keduanya konsumennya membaca nilai yang dipublikasikan.

artifacts: entry keys must be unique (Kunci entri artifacts harus unik)

Sebuah Recipe mendeklarasikan dua entri atau lebih di bawah artifacts: dengan kunci yang sama. Kunci menentukan nama file yang dikeluarkan (baik isi entri ditulis inline maupun dimuat melalui $import: per entri); kunci duplikat akan mengeluarkan file dengan nama yang sama ke direktori boundary yang sama.

Build menolak Recipe saat mendekode dokumen ke bentuk bertipenya, dengan menyebutkan kunci yang berulang dan baris tempat kunci itu muncul kembali. Langkah tersebut berjalan setelah pemeriksaan skema envelope dan sebelum aturan bentuk, sehingga Recipe dengan kunci artifacts: duplikat melaporkan skema yang valid lalu halt ini, dan aturan bentuk lainnya tidak melaporkannya.

Cara memperbaiki: ganti nama salah satu kunci entri yang bertabrakan sehingga setiap entri artifacts: memiliki nama file yang unik.

Emission-time filename collision across input kinds (Tabrakan nama file saat emisi lintas jenis input)

Sebuah Recipe dan sebuah FeatureRecipe masing-masing mendeklarasikan jenis input yang menghasilkan file: source: yang dirender oleh provider, workload: yang disintesis oleh provider, entri artifacts:, dan pipeline: yang langkah-langkahnya dapat mengemisi file. Masing-masing memilih nama outputnya secara independen dari yang lain, dan tidak ada yang mendeklarasikan bahwa nama-nama tersebut berbeda — sehingga dua di antaranya dapat menghasilkan file dengan satu nama yang sama, dan hanya salah satu dari keduanya yang akan bertahan. Build berhenti dan menyebutkan nama output tersebut beserta setiap blok yang menghasilkannya.

Pemeriksaan dijalankan sekali untuk setiap dokumen yang mengemisi, segera setelah emisi dokumen itu sendiri selesai dan sebelum outputnya bergabung ke dalam perakitan apa pun. Tiga dokumen mengemisi, dan masing-masing diperiksa secara terpisah: Recipe milik komponen itu sendiri, FeatureRecipe yang diikat oleh sebuah attachment pada komponen, dan FeatureRecipe yang diikat oleh attachment lingkup boundary. Pemisahan inilah yang membuat diagnostik menyebutkan dokumen yang tepat — file sebuah attachment dirender di bawah identitas komponen host-nya, sehingga tabrakan dalam FeatureRecipe attachment tersebut dilaporkan terhadap FeatureRecipe itu, bukan terhadap host.

Setiap nama yang bertabrakan dilaporkan secara terpisah, sehingga dokumen yang blok-bloknya bertemu pada dua nama melaporkan keduanya. Sebuah temuan diposisikan pada dokumen yang Anda sunting untuk memperbaikinya: instans komponen untuk Recipe, dan FeatureRecipe itu sendiri untuk attachment, yang temuannya juga menyebutkan attachment tersebut — sebuah komponen atau boundary dapat mengikat beberapa attachment.

Satu blok yang mengemisi beberapa file dengan satu nama bukanlah penghentian ini. Itu adalah satu kontributor, bukan dua blok yang bertemu, dan kunci artifacts: duplikat di dalam satu blok ditolak saat dokumen didekode.

Pesan yang diemisikan:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (tabrakan nama file lintas jenis input: dua blok jenis input menghasilkan file dengan satu nama output (nama output, dihasilkan oleh))

Tabrakan dalam FeatureRecipe juga menyertakan attachment:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (tabrakan nama file lintas jenis input: dua blok jenis input menghasilkan file dengan satu nama output (nama output, dihasilkan oleh, attachment))

Cara memperbaiki: ganti nama file yang bertabrakan pada jenis input mana pun yang Anda kendalikan. Jika tabrakan melibatkan nama file hasil terjemahan Workload dan entri artifacts:, nama hasil terjemahan Workload mengikuti konvensi penerjemahan provider (misalnya, <release-name>-deployment.yaml untuk helm, dengan nama rilis berupa {{ .context.rendered_name }}) — sesuaikan nama file artifacts: menjadi nama yang tidak disintesis oleh provider.

An output-label key uses a reserved namespace (Kunci label output menggunakan namespace yang dicadangkan)

Sebuah Recipe menyebutkan kunci label di bawah aggrega.ai/ atau app.kubernetes.io/ — dalam outputLabels:, blok yang membubuhkan label literal ke output yang dirender, atau dalam outputComponentLabels:, blok yang menyebutkan kunci label komponen yang nilainya dipromosikan ke output tersebut. Kedua prefiks itu termasuk ruang kunci provenans milik platform sendiri: keduanya adalah kunci yang dibubuhkan oleh build itu sendiri, sehingga Recipe yang membubuhkan salah satunya akan menulis ke ruang yang menyatakan asal suatu resource. Pencadangan ini juga yang menjaga agar himpunan label Recipe terpisah dari himpunan provenans, sehingga keduanya tidak pernah perlu direkonsiliasi saat digabungkan. Aturan ini diperiksa saat Recipe dimuat.

Pencadangan hanya berlaku pada root polos. Kunci yang sekadar memuat root yang dicadangkan lebih dalam di dalam namespace-nya sendiri — misalnya component.aggrega.ai/hosting — adalah ruang kunci lain yang tidak dimiliki platform, dan tetap dapat ditulis.

Pesan yang diemisi. Satu kondisi mencakup kedua blok, sehingga kalimatnya tidak dapat menyatakan blok mana yang ditulis; saran sesudahnya menyebutkan blok tersebut dengan mengutip kunci yang Anda ketik dan blok tempat Anda mengetiknya:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (batasan output-labels pada recipe: kunci menggunakan namespace yang dicadangkan (Recipe, aturan output-labels, pada). kunci dalam outputLabels menggunakan namespace yang dicadangkan (dan dicadangkan untuk provenans platform))

Kunci yang ditulis dalam blok yang dipromosikan dilaporkan di bawah nama aturan blok tersebut dan menyebutkannya dalam saran:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (batasan output-labels pada recipe: kunci menggunakan namespace yang dicadangkan (Recipe, aturan output-component-labels, pada). kunci dalam outputComponentLabels menggunakan namespace yang dicadangkan (dan dicadangkan untuk provenans platform))

Kunci blok literal diperiksa dalam urutan terurut dan kunci blok yang dipromosikan dalam urutan Anda menuliskannya, sehingga Recipe yang melanggar aturan di beberapa tempat selalu melaporkan pelanggaran yang sama terlebih dahulu.

Cara memperbaiki: pindahkan kunci ke namespace milik Anda — domain Anda sendiri, atau namespace dengan sub-prefiks seperti component.aggrega.ai/… — atau hapus kunci tersebut jika nilai yang Anda inginkan sudah dibubuhkan oleh build. Kunci provenans yang dibawa oleh resource yang dirender tercantum di ../providers/well-known-annotations.md; membaca kembali salah satunya tidak memerlukan deklarasi Recipe.

A promoted component label is also declared literally (Label komponen yang dipromosikan juga dideklarasikan secara literal)

Sebuah Recipe menyebutkan satu kunci di outputComponentLabels: sekaligus di outputLabels:. Kedua blok membubuhkan ke permukaan label yang sama dari sumber yang berbeda — yang pertama mempromosikan nilai yang dibawa komponen, yang kedua menulis nilai yang diketik oleh penulis Recipe — sehingga kunci yang disebutkan di keduanya akan tiba dengan dua nilai kandidat tanpa ada yang menentukan mana yang menang. Aturan ini diperiksa saat Recipe dimuat, setelah aturan namespace yang dicadangkan di atas, sehingga Recipe yang melanggar keduanya melaporkan namespace yang dicadangkan terlebih dahulu: perbaikan kesalahan tersebut tidak bergantung pada isi blok lainnya.

Pesan yang diemisikan:

recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (batasan output-component-labels pada recipe: kunci juga dideklarasikan dalam outputLabels (Recipe, aturan output-component-labels, pada). kunci dipromosikan melalui outputComponentLabels dan juga dideklarasikan secara literal dalam outputLabels; pertahankan sumber asal label yang semestinya dan hapus yang lain)

Cara memperbaiki: tentukan dari mana nilai label berasal dan hapus deklarasi lainnya. Pertahankan entri outputComponentLabels: jika nilai harus mengikuti apa pun yang dibawa komponen, sehingga dua komponen yang terikat pada satu Recipe membubuhkan nilainya masing-masing; pertahankan entri outputLabels: jika nilai tersebut milik Recipe sendiri dan sama di mana pun Recipe diikat.

Aturan bentuk FeatureRecipe

Sebuah FeatureRecipe menyusun outputnya dari jenis input yang sama dengan Recipe, dan aturan komposisi di bawah ini membatasinya sebagaimana aturan itu membatasi Recipe. Aturan ini diperiksa saat FeatureRecipe dimuat, dan dilaporkan dalam bentuk yang sama dengan penghentian bentuk Recipe — kalimat aturan, lalu dokumen yang bermasalah, nama aturan, dan saran untuk kejadian tersebut — di bawah tag CATALOG_ERROR.

Di sini sengaja tidak ada aturan minimal-satu-jenis-input, dan itulah perbedaannya dengan Recipe. FeatureRecipe yang hanya mendeklarasikan provider dan apa yang diimplementasikannya adalah attachment murni-wiring yang sah: ia tidak merender apa pun, dan efeknya adalah koneksi yang dibawa oleh Feature yang diimplementasikannya. FeatureRecipe yang hanya mendeklarasikan injectMapping: juga sah dengan cara yang sama.

A FeatureRecipe’s valuesMapping requires source (valuesMapping pada FeatureRecipe memerlukan source)

Sebuah FeatureRecipe mendeklarasikan valuesMapping tetapi tidak mendeklarasikan source. Pemetaan nilai adalah sebuah overlay, sehingga tanpa chart, modul, atau file yang menjadi sasaran overlay, nilai yang dipetakan tidak memiliki tujuan.

Pesan yang diemisikan:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping memerlukan source (FeatureRecipe, aturan values-mapping). deklarasikan pointer source: bersama valuesMapping (atau hapus valuesMapping jika tidak dimaksudkan adanya overlay))

Cara memperbaiki: tambahkan pointer source: yang menjadi tujuan penulisan overlay tersebut, atau hapus valuesMapping dan biarkan lampiran menjalankan tugasnya dengan cara lain — artifacts: untuk menghasilkan file miliknya sendiri, injectMapping: untuk membentuk ulang apa yang dikirimkannya, atau tidak keduanya, untuk lampiran yang murni berupa penyambungan.

A pipeline declares one step id twice (Pipeline mendeklarasikan satu id langkah dua kali)

Sebuah Recipe atau FeatureRecipe mendeklarasikan id yang sama pada dua langkah spec.pipeline-nya. Sebuah langkah menerbitkan output yang dikembalikannya di bawah id-nya, dan langkah berikutnya dalam pipeline yang sama membacanya sebagai .steps.<id>.outputs, sehingga dua langkah yang berbagi satu id akan membuat langkah berikutnya itu membaca output dari langkah yang terakhir menerbitkan di antara keduanya, bukan dari langkah yang Anda maksud.

Aturan ini mencakup pipeline milik satu dokumen saja. Recipe sebuah komponen dan FeatureRecipes yang dilampirkan padanya masing-masing menjalankan pipeline-nya secara terpisah, dan setiap pipeline dimulai tanpa output langkah, sehingga langkah Recipe dan langkah FeatureRecipe yang dilampirkan boleh memiliki id yang sama.

Tidak ada skema yang dapat menyatakan aturan ini — JSON Schema tidak memiliki kata kunci untuk daftar yang entri-entrinya unik berdasarkan salah satu field-nya — sehingga editor yang memahami skema menerima dokumen seperti itu, dan pemeriksaan dijalankan saat dokumen dibaca, tepat setelah pemeriksaan skema. Setiap antarmuka yang membaca Recipe atau FeatureRecipe melaporkannya: aggrega validate pada file atau atas seluruh katalog, build yang memuat katalog, pull yang menerima entitas yang diambil, diagnostik editor, dan pengeditan dokumen, yang ditolak alih-alih ditulis. Dokumen yang juga gagal memenuhi skemanya melaporkan temuan skema terlebih dahulu, lalu penolakan ini setelah temuan tersebut diperbaiki.

Setiap pengulangan adalah temuan tersendiri, diposisikan pada id yang diulang dan menyebut langkah yang pertama kali mendeklarasikan id tersebut, beserta baris dan kolomnya. Jika sebuah id muncul tiga kali, kedua langkah yang belakangan sama-sama menyebut langkah pertama.

Pesan yang dikeluarkan, untuk FeatureRecipe yang langkah keduanya mengulang id langkah pertama. Kategori dan kode singkat kondisi ini, E0370, sampai kepada Anda di kepala dalam tanda kurung siku:

a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (pipeline mendeklarasikan satu id langkah dua kali; id langkah spec.pipeline[1].id sudah dideklarasikan di spec.pipeline[0].id. berikan setiap langkah pipeline id-nya sendiri, dan arahkan setiap referensi langkah yang dibuat oleh langkah berikutnya ke langkah yang dimaksud)

Cara memperbaiki: ganti nama salah satu dari kedua langkah, sehingga setiap id dideklarasikan sekali. Lalu periksa template with: dan when: setiap langkah berikutnya untuk referensi .steps.<id> ke id yang Anda pertahankan, dan arahkan masing-masing ke langkah yang output-nya dimaksud — penggantian nama itulah yang membuat output kedua langkah dapat dijangkau secara terpisah.

A document declares an API version this compiler no longer reads (Dokumen mendeklarasikan versi API yang tidak lagi dibaca oleh kompiler ini)

Baris apiVersion sebuah dokumen mendeklarasikan aggrega.ai/v1alpha1. Setiap jenis dokumen yang memiliki baris apiVersion mendeklarasikan aggrega.ai/v1beta1, satu-satunya versi yang dibaca oleh kompiler ini, dan tidak ada konversi dari versi sebelumnya: dokumen ditolak saat dibaca, sebelum hal lain diperiksa, karena setiap temuan lainnya akan menyangkut versi dokumen yang tidak dibaca oleh kompiler.

Setiap permukaan yang membaca dokumen melaporkannya: aggrega validate, build, pull yang menerima entitas yang diambil, diagnostik editor, dan pengeditan dokumen. Dokumen yang mendeklarasikan versi yang belum pernah dibaca oleh kompiler sebagai gantinya ditolak oleh skema jenisnya, dengan kode E0215.

Pesan yang dikeluarkan, untuk sebuah Component. Kategori dan kode pendek kondisi ini, E0373, sampai kepada Anda di bagian kepala dalam kurung siku:

a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (dokumen mendeklarasikan versi API yang tidak lagi dibaca oleh kompiler ini (Component); 1:1: apiVersion: dokumen mendeklarasikan aggrega.ai/v1alpha1, dan kompiler ini membaca aggrega.ai/v1beta1. ubah baris apiVersion menjadi aggrega.ai/v1beta1)

Cara memperbaiki: ubah baris apiVersion dokumen menjadi apiVersion: aggrega.ai/v1beta1. Bidang setiap jenis tidak berubah di antara kedua versi, sehingga baris tersebut adalah keseluruhan perubahannya.

A plugin declares a plugin ABI version this compiler no longer speaks (Sebuah plugin mendeklarasikan versi ABI plugin yang tidak lagi didukung oleh kompiler ini)

Sebuah plugin mendeklarasikan ABI plugin v1alpha1. Kompiler ini mendukung ABI plugin v1beta1 dan tidak ada yang lain, sehingga plugin yang dibangun terhadap ABI sebelumnya ditolak alih-alih dijalankan. Sebuah plugin menyatakan ABI-nya di dua tempat, dan masing-masing ditolak di bawah kondisi yang sama ini: laporan describe() yang dikembalikan oleh modul guest-nya saat dimuat, dan spec.abiVersion milik entitas Plugin-nya, yang ditolak saat entitas dibaca, sebelum hal lain diperiksa. Sebuah plugin yang mendeklarasikan versi ABI yang belum pernah didukung oleh kompiler ini juga ditolak, oleh pemeriksaan deskriptor (E0085) atau oleh skema Plugin (E0215).

Pesan yang dikeluarkan, untuk modul guest saat dimuat. Kategori dan kode pendek kondisi ini, E0374, sampai kepada Anda di bagian kepala dalam kurung siku:

plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (plugin mendeklarasikan abi_version “v1alpha1”, dan kompiler ini mendukung “v1beta1”; bangun ulang plugin terhadap kit plugin saat ini lalu publikasikan lagi: sebuah plugin mendeklarasikan versi ABI plugin yang tidak lagi didukung oleh kompiler ini)

Pesan yang dikeluarkan, untuk entitas Plugin:

a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (sebuah plugin mendeklarasikan versi ABI plugin yang tidak lagi didukung oleh kompiler ini (Plugin); spec.abiVersion: Plugin mendeklarasikan abiVersion v1alpha1, dan kompiler ini mendukung v1beta1. bangun ulang plugin terhadap kit plugin saat ini lalu publikasikan lagi; entitas Plugin-nya kemudian mendeklarasikan abiVersion v1beta1)

Cara memperbaiki: bangun ulang plugin terhadap versi kit plugin-nya saat ini, yang menuliskan v1beta1 ke dalam laporan describe() modul guest, lalu publikasikan lagi, sehingga entitas yang dihasilkan di sampingnya juga mendeklarasikan abiVersion: v1beta1. Mengedit baris entitas saja tidak cukup: modul guest itu sendiri masih melaporkan ABI sebelumnya dan ditolak saat dimuat.

An artifact carries a media type this compiler no longer reads (Artefak membawa jenis media yang tidak lagi dibaca oleh kompiler ini)

Artefak yang diambil dari registry membawa jenis media yang digunakan oleh versi sebelumnya saat memublikasikan — application/vnd.aggrega.<kind>.v1alpha1 beserta sufiksnya, pada jenis artefak manifes, konfigurasinya, atau salah satu lapisannya. Kompiler ini memublikasikan dan membaca jenis media v1beta1, sehingga artefak ditolak dengan menyebut namanya saat manifesnya dibaca, sebelum apa pun dari kontennya diambil: baik entitas katalog, plugin beserta file yang dapat dieksekusi, maupun bundel dokumentasi. Pengindeksan registry melewati artefak semacam itu, dengan menyebutkan alasannya. Jenis media di luar namespace application/vnd.aggrega. milik Aggrega sendiri tidak pernah termasuk kondisi ini.

Pesan yang dikeluarkan, untuk sebuah Component yang dipublikasikan oleh versi sebelumnya. Kategori dan kode pendek kondisi ini, E0375, sampai kepada Anda di bagian kepala dalam kurung siku:

"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (membawa jenis media “application/vnd.aggrega.component.v1alpha1+yaml”, dan kompiler ini membaca “application/vnd.aggrega.component.v1beta1+yaml”; publikasikan lagi artefak dengan versi saat ini: oci: artefak membawa jenis media yang tidak lagi dibaca oleh kompiler ini)

Cara memperbaiki: publikasikan lagi artefak dengan versi aggrega saat ini, yang menuliskan jenis media v1beta1. Artefak yang dipublikasikan oleh orang lain harus dipublikasikan lagi oleh orang tersebut; sampai mereka melakukannya, artefak itu tidak dapat dibaca.

A file cannot be read, or its bytes do not parse (Sebuah file tidak dapat dibaca, atau byte-nya tidak dapat di-parse)

Sebuah file yang harus dibaca oleh build, atau sebuah dokumen Aggrega yang dibaca oleh pemeriksaan seluruh katalog di bawah direktori katalog, tidak menghasilkan apa pun yang dapat digunakan oleh permukaan yang menyebutkan atau membacanya. Entah file itu tidak dapat dibaca dari disk, atau byte-nya di-parse dan tidak ter-parse dengan bersih. Tidak ada proses hilir yang berjalan atasnya, karena tidak ada konten untuk diperiksa terhadap skema, tidak ada komponen untuk ditempatkan, dan tidak ada templat untuk dirender.

Kondisi ini tidak menyebutkan format apa pun, dan hal itu disengaja. Sebagian besar file yang dicakupnya dibaca sebagai YAML; badan workload, values-mapping, dan artefak sebuah Recipe dibaca sebagai sumber templat Go dan tidak pernah di-parse sama sekali. Kalimat yang menjanjikan YAML akan mengawali diagnostik tentang file templat dengan klaim mengenai format file tersebut. Kegagalan mana dari keduanya yang terjadi, dan untuk jenis file apa, dinyatakan oleh klausa setelah kalimat tersebut.

Dokumen yang menjadi titik awal build — Aggregate, Release, dan Manifest — adalah subjek yang paling umum, dan penghentian ini dimunculkan di setiap titik salah satu dari ketiganya dibaca. Diagnostik menyebutkan dokumen mana yang sedang dibaca dan path tempat dokumen itu dibaca. Path itulah yang membedakan file yang hilang dari file yang rusak: kegagalan baca mengutip alasan dari sistem operasi sendiri, dan kegagalan parse mengutip alasan dari parser YAML, yang memuat baris tempat parser menyerah.

Pesan yang dikeluarkan, ketika file tidak dapat dibaca:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (Aggregate, di path, gagal membaca file: alasan yang mendasari))

dan ketika teksnya tidak dapat di-parse:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (Aggregate, di path, gagal melakukan unmarshal YAML: alasan yang mendasari))

Release dan Manifest muncul menggantikan Aggregate ketika salah satu dari keduanya adalah dokumen yang sedang dibaca. Kondisi yang sama juga mencakup kontrak parameter yang dibaca dari blok parameters: yang dideklarasikan sebuah Aggregate, yang dibaca dari teks Aggregate itu sendiri sebelum apa pun diinterpolasikan ke dalamnya.

parameters: { $import: … } sebuah Release yang menyebutkan file yang tidak dapat diperoleh build juga dilaporkan di sini, dan untuk kedua kasus: path tidak menyebutkan file yang dapat dibaca build, atau file dibaca dan byte-nya tidak dapat di-parse. Release adalah subjeknya, dan klausa menyebutkan kunci yang menunjuk ke file tersebut:

file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (Release, di path, gagal membaca file: alasan yang mendasari)) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (Release, di path, gagal melakukan unmarshal YAML: alasan yang mendasari))

Path relatif di-resolve dari direktori yang memuat Release yang menuliskannya — Release yang disebutkan oleh sebuah perintah, atau satu mata rantai dari rantai extends:-nya — dari mana pun perintah dijalankan, sehingga baris perintah dan editor membaca file yang sama; path absolut menyebutkan tempatnya sendiri. Pastikan checkout yang digunakan build memuat file tersebut di sana: file parameter yang ada di mesin Anda tetapi dikecualikan dari kontrol versi tidak ada selama proses continuous integration, dan itulah cara umum kondisi ini dijumpai. Path yang mengarah keluar dari workspace — atau, untuk Release yang disebutkan di luar workspace, keluar dari direktori Release itu sendiri — tidak dibaca sama sekali, dan dilaporkan di bawah “A reference to another file leads out of the directory it must stay inside (Referensi ke file lain mengarah keluar dari direktori yang harus ditempatinya)” di bawah.

$import: skema yang menyebutkan file yang tidak dapat diperoleh build juga dilaporkan di sini, karena kesalahannya sama: direktif tersebut tersusun dengan benar dan file yang disebutkannya tidak menghasilkan dokumen. Dalam hal ini subjeknya adalah entitas katalog, bukan salah satu dari ketiga dokumen tersebut, sehingga klausa menyebutkan permukaan skema yang sedang di-resolve — spec.schema, salah satu pilarnya seperti spec.schema.values, atau valueSchema milik soket usesSchema — dan penunjuk sumber adalah baris tempat direktif itu ditulis:

file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse. permukaan: membaca skema yang diimpor nilai: alasan dari sistem operasi)

dengan resolve imported schema path menggantikan read untuk kegagalan yang lebih jarang, yaitu ketika direktori entitas itu sendiri sama sekali tidak dapat ditetapkan, dan parse imported schema ketika file telah dibaca dan teksnya bukan YAML yang tersusun dengan benar. Kesalahan pada direktif yang Anda tulis — kunci saudara di sampingnya, nilai yang bukan path, atau konten impor yang ter-parse tetapi bukan map — adalah kondisi yang berbeda dan dilaporkan di bawah “A schema $import: cannot be applied (Impor skema tidak dapat diterapkan)” di bawah.

Impor valuesMapping:, workload:, atau artifacts.<name>: milik sebuah Recipe atau FeatureRecipe juga dilaporkan di sini, dengan alasan yang sama dan solusi yang sama: direktif tersebut tersusun dengan benar dan file yang disebutkannya tidak menghasilkan konten. Ketiga badan tersebut adalah sumber templat Go, bukan dokumen, sehingga hanya pembacaan yang dapat gagal — tidak ada yang mem-parse-nya pada tahap ini. Entitas dan kunci yang menyebutkan path dibawa dalam klausa, dan penunjuk sumber adalah path file yang diimpor itu sendiri:

file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (impor file valuesMapping Recipe nama, alasan dari sistem operasi). jika yang Anda maksud adalah entri pustaka dan bukan file, referensi memerlukan fragmennya — $import: tanpa fragmen dibaca sebagai path file, dan nilai tanpa tanda kutip berakhir di tempat spasi sebelum # memulai komentar, jadi beri tanda kutip pada seluruh referensi) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (impor file workload Recipe nama, alasan dari sistem operasi). jika yang Anda maksud adalah entri pustaka dan bukan file, referensi memerlukan fragmennya — $import: tanpa fragmen dibaca sebagai path file, dan nilai tanpa tanda kutip berakhir di tempat spasi sebelum # memulai komentar, jadi beri tanda kutip pada seluruh referensi) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (impor file artefak kunci Recipe nama, alasan dari sistem operasi). jika yang Anda maksud adalah entri pustaka dan bukan file, referensi memerlukan fragmennya — $import: tanpa fragmen dibaca sebagai path file, dan nilai tanpa tanda kutip berakhir di tempat spasi sebelum # memulai komentar, jadi beri tanda kutip pada seluruh referensi)

Fragmen itulah yang membedakan referensi pustaka dari path: <Library>#/mappings/<entry> di-resolve terhadap pustaka, dan teks yang sama tanpa fragmen adalah path relatif biasa. Fragmen mudah hilang tanpa disadari, karena nilai YAML biasa berakhir di tempat spasi sebelum # membuka komentar — sehingga $import: LibBeta:1.0.0 #/workloads/Web sampai ke build sebagai LibBeta:1.0.0, lalu build mencari file dengan nama itu di samping Recipe. Beri tanda kutip pada seluruh referensi untuk mempertahankan fragmennya.

Ketiga kunci yang sama pada sebuah FeatureRecipe melaporkan kondisi yang sama dan dibaca dengan cara yang sama. Impor artifacts dibaca dua kali selama masa hidup sebuah Release — sekali ketika aggrega pull membekukan pin kontennya, dan sekali lagi ketika entri tersebut dirender — sehingga file yang hilang yang sama melaporkan kondisi ini pada mana pun dari keduanya yang Anda capai lebih dahulu. Kesalahan bentuk pada direktif itu sendiri, seperti kunci saudara di samping $import: atau referensi oci:// yang memuat host, adalah kondisi yang berbeda dan dilaporkan di bawah entrinya sendiri.

aggrega lint dan aggrega validate untuk seluruh katalog juga melaporkan di sini, untuk dokumen di bawah direktori katalog yang mendeklarasikan apiVersion Aggrega — baris yang diawali, tanpa indentasi, dengan apiVersion: dan nilai yang diawali aggrega.ai/ — dan tidak dapat dibaca, tidak dapat di-parse, atau tidak dapat didekode ke envelope yang dibaca pemeriksaan, seperti metadata yang ditulis sebagai daftar. Tidak ada penulis yang menulis path ke dokumen itu: pemeriksaan membacanya karena dokumen itu berada di direktori katalog. Setiap pemeriksaan membaca semua file sebelum berhenti, sehingga satu kali jalan menyebutkan semua dokumen semacam itu, dan tidak memeriksa hal lain serta tidak mencetak ringkasan. YAML yang tidak mendeklarasikan apiVersion Aggrega — termasuk templat Helm chart — dilewati. Bagian kepala menghitung dokumen dan menyebutkan file-filenya, dan masing-masing dicantumkan di bawahnya beserta alasan dari pembacaan atau dari parser itu sendiri:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (sejumlah dokumen di bawah direktori katalog mendeklarasikan apiVersion Aggrega tetapi tidak dapat dimuat, sehingga tidak ada yang diperiksa) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (pemuatan file gagal: file tidak dapat dibaca, atau byte-nya tidak dapat di-parse (dokumen katalog, gagal melakukan unmarshal YAML))

dengan failed to decode the envelope: beserta baris dan apa yang ditemukan dekoder di sana — line 4 (metadata): a list is written where a map is expected untuk metadata yang ditulis sebagai daftar — untuk dokumen yang dapat di-parse tetapi tidak dapat didekode, dan failed to read file: beserta alasan dari sistem operasi untuk file yang tidak dapat dibaca. Dokumen yang berhasil dimuat tetapi mendeklarasikan jenis yang tidak ada di katalog mana pun disebutkan oleh penghentian yang sama, dihitung dalam kepala yang sama, dan dicantumkan di bawah kondisinya sendiri — lihat “A catalog document declares a kind a catalog does not hold (Dokumen katalog mendeklarasikan jenis yang tidak ada di katalog)” di bawah.

Cara memperbaiki: baca path dalam pesan, bukan nama dokumennya — keduanya berbeda setiap kali sebuah referensi ter-resolve ke tempat yang tidak terduga. Untuk kegagalan baca, pastikan file ada di path tersebut, bahwa path dieja sebagaimana dokumen perujuk menuliskannya, dan bahwa build memiliki izin untuk membacanya; file yang ada secara lokal tetapi tidak ada di checkout agen build adalah kasus yang umum. Untuk kegagalan parse, buka file pada baris yang disebutkan parser — nilai tanpa tanda kutip yang memuat titik dua, tab yang digunakan untuk indentasi, dan item daftar yang diindentasi di bawah kunci yang salah adalah tiga penyebab sebagian besar kegagalan tersebut.

A catalog document declares a kind a catalog does not hold (Dokumen katalog mendeklarasikan jenis yang tidak ada di katalog)

Sebuah dokumen di bawah direktori katalog mendeklarasikan apiVersion Aggrega — baris yang diawali, tanpa indentasi, dengan apiVersion: dan nilai yang diawali aggrega.ai/ — dan kind yang tidak ada di katalog mana pun: salah eja seperti Componnent, jenis dengan huruf besar-kecil yang salah seperti component, atau tanpa kind sama sekali. Katalog menyimpan setiap dokumen di bawah jenis yang dideklarasikannya, sehingga dokumen seperti itu tidak masuk ke katalog mana pun: build, inspect, dan setiap perintah lain yang memuat katalog melewatinya, dan referensi ke entitas yang seharusnya dideklarasikannya tidak teresolusi ke apa pun.

Katalog memuat dokumen Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate, dan Plugin. Tiga jenis lain sah berada di direktorinya dan tidak pernah dilaporkan di sini: Manifest dan Release yang disimpan di samping entitas, dan Workload di direktori Recipe atau FeatureRecipe yang mengimpornya.

aggrega validate dan aggrega lint untuk seluruh katalog, serta lint lingkup Release, yang menelusuri direktori yang sama, melaporkannya. Masing-masing membaca setiap file sebelum berhenti, sehingga satu run menyebut setiap dokumen seperti itu bersama dengan dokumen mana pun yang sama sekali tidak dapat dimuat, di bawah satu kepala yang menghitungnya dan menyebut file-filenya; tidak ada yang diperiksa dan tidak ada ringkasan yang dicetak. Setiap dokumen dicantumkan beserta jenis yang dideklarasikannya, dan baris itu ditutup dengan jenis-jenis yang dimuat katalog:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (dokumen di bawah direktori katalog mendeklarasikan apiVersion Aggrega dan tidak dapat dimuat, sehingga tidak ada yang diperiksa) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (dokumen katalog mendeklarasikan jenis yang tidak ada di katalog. katalog memuat dokumen Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate, dan Plugin, serta melewati Workload, Manifest, atau Release; perbaiki jenisnya, atau pindahkan file keluar dari direktori katalog)

dengan no kind sebagai pengganti kind "<kind>" untuk dokumen yang tidak mendeklarasikan jenis apa pun.

Build tidak berhenti pada dokumen seperti itu: build melewatinya sebagaimana setiap pemuatan, dan dokumen yang tidak dijangkau Release mana pun tidak pernah menggagalkan build. Jika sebuah Release memang menjangkau entitas tersebut, build berhenti pada referensinya, di bawah “A reference names no entity the catalog holds (Referensi tidak menyebut entitas apa pun yang ada di katalog)” di bawah, dan catatan di bawah kegagalan itu menyebut file tersebut jika file itu mendeklarasikan nama yang diminta referensi — lihat entri tersebut.

Cara memperbaiki: buka file yang disebut pesan dan perbaiki kind-nya menjadi jenis dokumen yang sebenarnya — ejaan dan huruf besar-kecil sama-sama berpengaruh. File yang sama sekali bukan entitas katalog tidak semestinya berada di bawah direktori katalog; pindahkan keluar, atau berikan apiVersion yang bukan milik Aggrega jika file itu dokumen milik alat lain.

A path names content outside the entity’s own directory (Sebuah path menunjuk konten di luar direktori milik entitas itu sendiri)

Konten sebuah entitas berada di direktori milik entitas itu sendiri, karena setiap file yang dibawa oleh publikasi entitas tersebut diambil dari sana. Path yang keluar dari direktori itu menunjuk ke file yang tidak akan ikut berpindah bersama entitas, sehingga file tersebut tidak tersedia bagi siapa pun yang menerima entitas itu, dan pin yang dicatat atasnya menjamin byte yang tidak dapat mereka peroleh.

Karena itu, setiap path yang ditulis sebuah entitas untuk konten yang dibawanya dibaca relatif terhadap direktori yang memuat file entitas tersebut dan harus tetap berada di dalamnya. Hal ini mencakup source: milik Recipe dan FeatureRecipe — sebuah path biasa, atau url: dari bentuk terstruktur — file yang diimpor setiap entri valuesMapping:, workload: dan artifacts: dengan $import:, serta setiap skema yang diimpor sebuah Component atau Feature, secara utuh, per pilar, atau untuk valueSchema dan infraSchema dari socket usesSchema. Ada tiga bentuk yang keluar dari direktori: path yang naik ke atasnya, path absolut, yang menunjuk suatu tempat di mesin tempat path itu ditulis, dan path yang ditulis di dalam direktori tetapi dibawa keluar oleh tautan simbolik di sepanjang jalannya — sebuah direktori di sepanjang path, maupun file di ujungnya, yang merupakan tautan menuju ke luar direktori entitas. Path yang naik lalu kembali ke dalam — ./charts/../values.tmpl — adalah path biasa di dalam direktori, demikian pula path melalui tautan yang mengarah ke tempat lain di dalamnya. Pendakian yang masuk kembali ke direktori melalui namanya sendiri — ../1.0.0/values.tmpl yang ditulis di direktori bernama 1.0.0 — ditolak, karena nama direktori bukan bagian dari apa yang ikut berpindah: entitas yang dipublikasikan dibaca dari direktori yang dinamai oleh cache konsumen, tempat nama tersebut tidak menemukan apa pun. Path melalui tautan yang mengarah ke luar ditolak karena jika tidak, publikasi akan membawa byte yang ditunjuk tautan itu, dari mana pun asalnya, dengan nama di dalam entitas.

Penolakan terjadi di mana pun entitas dibaca. aggrega validate atas seluruh katalog, aggrega validate pada file entitas itu sendiri, aggrega pull dan aggrega build menolaknya saat file entitas dibaca, begitu pula aggrega pin atas Recipe atau FeatureRecipe dan aggrega push atas salah satu dari keempat jenis tersebut, sebelum apa pun diambil, ditulis, atau dipublikasikan. source: yang ditulis sebagai templat tidak menunjuk apa pun sampai build mengevaluasinya, sehingga templat yang menghasilkan path di luar direktori ditolak oleh build, pada saat nilainya ada.

Release berbeda, begitu pula referensi entitas. Sebuah Release menunjuk entitas lain — Aggregate-nya, Manifest-nya, Release yang diperluasnya — dan tidak pernah dipublikasikan, sehingga tidak ada yang dibacanya yang berpindah ke mana pun: path tersebut, dan file yang diimpor parameters: milik Release, dibaca sebagaimana ditulis. type milik Aggregate menunjuk entitas lain berdasarkan identitasnya alih-alih konten yang dibawa Aggregate, dan juga diselesaikan menurut ketentuannya sendiri: melalui direktori katalog, cache, dan registry, tidak pernah sebagai path file.

Pesan yang dikeluarkan, menyebutkan path sebagaimana ditulis:

a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (sebuah path menunjuk konten di luar direktori milik entitas itu sendiri. remediasi: pindahkan file ke direktori yang memuat entitas, atau direktori di bawahnya, dan sebut file itu dengan path relatif terhadap direktori tersebut. Konten sebuah entitas berada di direktori milik entitas itu sendiri karena setiap file yang dibawa publikasinya diambil dari sana; path yang keluar darinya menunjuk ke file yang tidak akan ikut berpindah bersama entitas)

dan, untuk path yang dibawa keluar direktori oleh sebuah tautan, menyebutkan tautan tersebut dan ke mana ia mengarah:

a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (sebuah path menunjuk konten di luar direktori milik entitas itu sendiri, tautan tersebut mengarah ke luar. remediasi: ganti tautan dengan salinan dari apa yang ditujunya, ditempatkan di dalam direktori yang memuat entitas. Konten sebuah entitas berada di direktori milik entitas itu sendiri karena setiap file yang dibawa publikasinya diambil dari sana; tautan yang mengarah ke luar akan membawa byte yang ditunjuknya dengan nama di dalam entitas)

Field tempat path itu dibaca disebutkan pada baris di atas pesan: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema …, atau, untuk source bertemplat, node "<name>" source.

Cara memperbaiki: pindahkan file ke direktori entitas, atau direktori di bawahnya, dan tulis path-nya relatif terhadap direktori tersebut. Jika sebuah tautan membawa path keluar, ganti tautan itu dengan salinan dari apa yang ditujunya di dalam direktori entitas. Chart yang digunakan bersama oleh beberapa Recipes disalin ke direktori setiap Recipe, karena masing-masing dipublikasikan sendiri; skema yang digunakan bersama oleh beberapa Components ditempatkan dalam sebuah SchemaLibrary, yang kemudian direferensikan setiap Component melalui identitasnya, dan isi mapping, workload, atau artifact yang digunakan bersama oleh beberapa Recipes ditempatkan dalam jenis library yang sesuai.

source: milik sebuah Recipe menyebut jenis yang tidak diketahui cara memperolehnya oleh apa pun

source: sebuah Recipe menyatakan jenis hal yang ditunjuknya — chart, modul, proyek compose — dan setiap jenis diperoleh oleh adapter sumber yang melayani jenis tersebut. Kondisi ini melaporkan jenis yang tidak dilayani adapter sumber mana pun, sehingga tidak ada yang dibawa program ini yang dapat mengambil sumber tersebut. source: sebuah FeatureRecipe tunduk pada aturan yang sama.

Ini ditolak saat dokumen dibaca, sebelum apa pun diambil: memeriksa Recipe itu sendiri menolaknya, begitu pula setiap Release yang mencapainya. Tidak ada yang dicoba, karena tidak ada yang dapat mencobanya — itulah yang membedakannya dari akuisisi yang berjalan lalu gagal.

Pesan yang dikeluarkan, menyebut dokumen, jenis sebagaimana ditulis, dan jenis-jenis yang dilayani:

no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (tidak ada adapter sumber yang melayani jenis sumber ini (Recipe, aturan source-kind). sumber menyebut jenis ini; sebutkan jenis yang dilayani adapter sumber, atau tulis sumber sebagai satu URI yang bentuknya menyatakan jenisnya)

Cara memperbaiki: perbaiki jenis pada source: menjadi jenis yang dilayani toolchain — salah ketik dan jenis yang memang tidak memiliki adapter menghasilkan pesan yang sama, dan pesan itu mengutip jenis sebagaimana Anda tulis di samping jenis-jenis yang dilayani, jadi hal pertama yang perlu diperiksa adalah ejaannya terhadap daftar tersebut, yang juga dijelaskan di halaman Recipe. Jika jenisnya sudah dieja sesuai maksud Anda, jenis itu tidak dapat diperoleh oleh build ini, dan tidak ada perubahan penulisan pada Recipe yang akan membuatnya dapat diperoleh; arahkan source: ke bentuk yang dilayani, atau tulis sebagai satu URI yang bentuknya menyatakan jenisnya.

No source adapter is registered in this program for a source kind (Tidak ada adapter sumber yang terdaftar dalam program ini untuk suatu jenis sumber)

Sebuah sumber diambil oleh adapter yang terdaftar untuk jenisnya. Kondisi ini melaporkan pengambilan yang di-dispatch untuk jenis yang tidak memiliki adapter terdaftar. Jenis yang ditulis tetapi tidak dilayani adapter mana pun ditolak saat Recipe-nya dibaca (lihat “A Recipe’s source: names a kind nothing knows how to acquire (Sumber sebuah Recipe menyebut jenis yang tidak diketahui cara memperolehnya)” di atas), sehingga tidak ada yang ditulis penulis yang mencapai kondisi ini: kondisi ini melaporkan program yang dirakit tanpa adapter untuk jenis yang dilayaninya, atau program yang dibangun di atas paket Go milik Aggrega yang men-dispatch jenis yang dirakitnya sendiri.

Pesan yang dikeluarkan, menyebut jenisnya:

kind "<kind>": no source adapter is registered in this program for the source kind (tidak ada adapter sumber yang terdaftar dalam program ini untuk jenis sumber tersebut)

Cara memperbaiki: tidak ada isi file entitas Anda yang menyebabkan ini. Laporkan kepada siapa pun yang membangun biner yang Anda jalankan.

A source URL carries a credential (URL sumber membawa kredensial)

url sumber dicatat sebagaimana Anda menulisnya — di lockfile Release, di entity.lock di samping Recipe, dan di cache sumber — dan Recipe itu sendiri adalah file yang Anda commit dan mungkin publikasikan. Jadi kredensial yang ditulis ke dalam URL akan ikut ke mana pun URL itu pergi. Kondisi ini melaporkan source: sebuah Recipe yang url-nya menuliskan pengguna sebelum host-nya: https://user:token@host/…, atau token yang ditulis sendiri sebagai https://token@host/…, karena layanan yang dijangkau melalui HTTP umumnya menerima token di posisi pengguna. Melalui http dan https, pengguna apa pun yang ditulis di sana dihitung; melalui skema lain hanya kata sandi yang dihitung, karena pengguna yang ditulis sendiri di sana menyebut sebuah akun — ssh://git@github.com/… diterima, dan agen SSH menyediakan kuncinya. source: sebuah FeatureRecipe tunduk pada aturan yang sama.

Ini ditolak saat dokumen dibaca, sebelum apa pun diambil: memeriksa Recipe itu sendiri menolaknya, begitu pula setiap Release yang mencapainya, dalam validasi, pull, pin, atau build. Pesan menyebut host dan tidak pernah menyebut kredensialnya. Pemeriksaan hanya membaca bagian URL yang ditulis sebelum host dan tidak membaca bagian lain, sehingga token yang dibawa dalam query string atau path tidak terdeteksi — dan dicatat sebagaimana ditulis, seperti bagian URL lainnya.

Pesan yang dikeluarkan melalui http atau https, menyebut dokumen, kunci, dan host, lalu tempat kredensial seharusnya berada:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (URL sumber membawa kredensial (Recipe, aturan source-url). spec.source.url menyebut pengguna atau kata sandi untuk host; hapus dari URL dan tulis kredensial di file netrc sebagai entri machine, login, password (file yang disebut NETRC, jika tidak ada .netrc di direktori home Anda, atau _netrc di %USERPROFILE% di Windows))

dan melalui skema lain, ketika solusinya adalah menghapus kata sandi:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (URL sumber membawa kredensial (Recipe, aturan source-url). spec.source.url menyebut kata sandi untuk host; hapus dari URL, yang ditulis ke lockfile dan cache sebagaimana ditulis)

Cara memperbaiki: hapus pengguna dan kata sandi dari url, sehingga tersisa URL yang menyebut host. Untuk sumber yang diambil melalui http atau https, letakkan kredensial di entri machine untuk host tersebut dalam file netrc Anda, yang dibaca setiap pengambilan repositori Helm chart klasik, fragmen compose, atau repositori Git melalui HTTP atau HTTPS — Autentikasi menjelaskan file mana dan entri mana. Untuk repositori Git melalui SSH, agen SSH menyediakan kuncinya, dan penggunanya boleh tetap ada. Jika Recipe sudah di-commit atau dipublikasikan dengan kredensial di dalamnya, kredensial itu ada dalam riwayat tersebut: ubah juga di server.

A {{ .parameters.* }} reference cannot be interpolated (Referensi tidak dapat diinterpolasi)

Teks Aggregate dievaluasi sebagai templat sebelum dibaca sebagai dokumen, sehingga referensi {{ .parameters.<key> }} diganti dengan nilai yang diberikan Release untuknya. Penghentian ini terjadi ketika evaluasi tersebut tidak dapat diselesaikan: teks tidak dapat di-parse sebagai templat, atau dapat di-parse tetapi gagal saat dijalankan.

Interpolasi terjadi sebelum Aggregate di-parse sebagai YAML, itulah sebabnya kesalahan di sini dilaporkan terhadap Aggregate secara keseluruhan, bukan pada kunci di dalamnya — pada titik itu dokumen belum memiliki kunci. Itu juga sebabnya referensi boleh dibiarkan tanpa tanda kutip: substitusi terjadi pada byte mentah, lalu aturan kutipan YAML sendiri menentukan tipe nilainya, sehingga referensi tanpa kutip menghasilkan tipe alami nilai tersebut dan referensi yang dikutip menghasilkan string.

Referensi yang menyebut kunci yang tidak diberikan Release bukan penghentian ini. Kunci yang tidak ada di-resolve menjadi nilai kosong di sini dan ditangkap, beserta tipe dan kontraknya, oleh pemeriksaan parameter yang dijelaskan di bawah “Parameter type mismatch / contract violation (Ketidakcocokan tipe parameter / pelanggaran kontrak)” di atas. Yang dilaporkan penghentian ini adalah teks yang sama sekali tidak dapat diproses mesin templat — {{ yang tidak ditutup, nama fungsi yang salah eja, pipeline yang tahapannya tidak saling cocok. Membaca parameter melalui index — {{ index .parameters "db_size" }} — ketika Release tidak memberikan parameter tersebut adalah kegagalan saat dijalankan, dan penghentian ini yang membawanya, dengan menyebut kuncinya: index berhenti pada kunci map yang tidak dimiliki map tersebut di setiap permukaan templat, sebagaimana dijelaskan di bawah “A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)” di bawah.

Teks yang sama sekali tidak dapat di-parse ditolak dengan menyebut path Aggregate itu sendiri, karena file tersebut sudah tersedia sebelum apa pun membacanya. Modul yang diimpor oleh komposisi dievaluasi dengan cara yang sama satu tingkat lebih dalam, dengan teksnya dibaca dari katalog alih-alih diserahkan ke build. Penghentiannya adalah kondisi yang sama ini dan membawa kode ini dalam kedua kasus; untuk modul, penghentian ini juga menyebut impor yang sedang diikuti dan file tempat teks modul dibaca, dan pesan yang dibawanya hanya menyebut jenisnya — sehingga posisi yang diberikan pesan itu adalah posisi dalam teks modul itu sendiri, bukan dalam Aggregate tempat Anda memulai.

Pesan yang dikeluarkan, untuk templat yang tidak dapat di-parse, untuk kesalahan yang sama dalam modul yang diimpor komposisi, dan untuk templat yang gagal saat dijalankan:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (referensi parameter tidak valid: periksa bahwa ekspresi tersebut menyebut parameter yang dideklarasikan dan dapat di-parse sebagai templat Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (referensi parameter tidak valid: periksa bahwa ekspresi tersebut menyebut parameter yang dideklarasikan dan dapat di-parse sebagai templat Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (referensi parameter tidak valid: periksa bahwa ekspresi tersebut menyebut parameter yang dideklarasikan dan dapat di-parse sebagai templat Go)

Teks sebuah Aggregate memiliki satu root, .parameters, sehingga referensi melalui root lain — {{ .values.app_token }}, atau {{ $.values.app_token }} — tidak membaca apa pun dan gagal saat berjalan. Alasannya kemudian diawali dengan menyebut referensi yang dibacanya:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (referensi parameter tidak valid: periksa bahwa ekspresi parameters menyebut parameter yang dideklarasikan dan dapat di-parse sebagai templat Go (Aggregate; templat membaca referensi ini, padahal teks Aggregate tidak mendefinisikan root selain .parameters; kesalahan eksekusi templat))

Cara memperbaiki: buka Aggregate dan baca alasan yang mendasarinya, yang menyebut posisi dalam teks dan konstruksi yang gagal. Pastikan setiap {{ memiliki }}, bahwa fungsi yang Anda panggil adalah fungsi yang ditawarkan permukaan tersebut — interpolasi parameter menawarkan fungsi-fungsi Sprig dan tidak ada yang lain, sehingga helper optional tidak tersedia di sini — dan bahwa tahapan pipeline menerima apa yang dihasilkan tahapan sebelumnya. Jika alasannya menyebut kunci yang tidak ditemukan index, baca parameter yang mungkin tidak diatur dengan titik ({{ .parameters.db_size }}) atau melalui get atau hasKey dari Sprig. Jika alasannya menyebut referensi melalui root lain, deklarasikan nilai itu sebagai parameter Aggregate dan baca sebagai {{ .parameters.<key> }}. Jika alasannya menyebut sesuatu yang tidak pernah Anda maksudkan sebagai templat — undefined variable "$json" dari ekspresi n8n, atau fungsi yang dinamai menurut node Flowise — teks tersebut membawa kurung kurawal gandanya sendiri, termasuk dalam komentar: tulis setiap {{ di dalamnya sebagai {{"{{"}}, sebagaimana dijelaskan Teks yang membawa kurung kurawal gandanya sendiri.

The Release directory declares one Aggregate or Manifest twice (Direktori Release mendeklarasikan satu Aggregate atau Manifest dua kali)

Release yang referensi aggregate: atau manifest:-nya berupa identitas polos di-resolve dengan terlebih dahulu memindai direktori Release itu sendiri, dan pemindaian tersebut menemukan dua Aggregates — atau dua Manifests — yang membawa metadata.name yang sama. Referensi identitas polos menyebut entitas dengan nama tersebut, sehingga nama yang diklaim dua kali adalah nama yang tidak dapat dijawab oleh direktori.

Pemindaian menolak direktori secara keseluruhan, bukan hanya nama yang diminta referensi. Pemindaian membaca setiap Aggregate dan setiap Manifest yang berada di samping Release, sehingga pasangan yang bertabrakan yang tidak disebut oleh referensi mana pun juga menghentikan build: direktori tersebut ambigu, terlepas dari apakah Release ini yang akan membaca entitas itu atau bukan. Referensi yang ditulis sebagai path (./aggregate.yaml, ../shared/manifest.yaml) menunjuk sebuah file, bukan entitas, dan di-resolve tanpa pemindaian, sehingga Release yang aggregate: dan manifest:-nya sama-sama path tidak pernah menjalankannya.

Ini adalah padanan direktori-yang-sama dari penolakan identitas duplikat pada katalog, dan keduanya dilaporkan secara terpisah agar pesan menyebut direktori tempat Anda berada, bukan tingkat katalog yang mungkin tidak Anda pikirkan.

Pesan yang diemisikan:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (identitas Aggregate/Manifest duplikat (metadata.name) di direktori Release: Aggregate dideklarasikan lebih dari sekali)

dengan Manifest sebagai pengganti Aggregate ketika dua Manifests bertabrakan.

Cara memperbaiki: beri salah satu dari kedua entitas tersebut metadata.name yang berbeda, atau pindahkan keluar dari direktori Release. Dua Releases yang memang men-deploy Aggregates berbeda dengan nama yang sama sebaiknya berada di direktorinya masing-masing; menyalin Release ke file bersebelahan tanpa mengganti nama isinya adalah penyebab yang biasa.

A Release’s aggregate: or manifest: reference resolves to nothing (Referensi Release tidak di-resolve ke apa pun)

Release menyebut Aggregate atau Manifest dengan identitas polos dan tidak ada entitas dengan nama tersebut yang ditemukan di permukaan mana pun tempat identitas polos dicari: direktori Release itu sendiri, katalog, dan registry.

Pesan yang dikeluarkan, ketika tidak ada yang cocok di mana pun:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (referensi aggregate/manifest tidak dapat di-resolve: tidak ada Aggregate dengan nama tersebut di direktori Release, katalog, atau registry)

File di direktori Release yang tidak dapat diindeks mengubah laporan, karena mengubah apa yang dapat diklaim secara jujur. File semacam itu mungkin saja entitas yang dicari, sehingga pesan menyatakan hal itu alih-alih menegaskan ketiadaan yang tidak dapat dipastikannya, dan membawa kegagalan parse yang membuatnya tidak terbaca:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (referensi aggregate/manifest tidak dapat di-resolve: Aggregate tidak ditemukan; file yang tidak dapat di-parse tidak dapat diindeks dan mungkin file itulah yang dimaksud)

dan ketika file yang tidak dapat di-parse adalah file yang langsung disebut oleh referensi:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (referensi aggregate/manifest tidak dapat di-resolve: Aggregate yang dibutuhkan adalah file yang tidak dapat di-parse)

Cara memperbaiki: jika referensi memang tidak ada, perbaiki ejaannya — identitasnya adalah metadata.name entitas, bukan nama filenya — atau tambahkan entitas ke direktori Release atau ke katalog yang dibaca build. Jika pesan menyebut file yang tidak dapat di-parse, perbaiki file itu terlebih dahulu: kegagalan parse-nya dikutip dalam pesan, dan memperbaikinya sering kali sekaligus me-resolve referensi dalam suntingan yang sama. Referensi ./ atau ../ adalah path, bukan identitas, dan di-resolve sebagai path, sehingga titik di awal mengubah mana dari kedua kesalahan itu yang sedang Anda cari.

A component is placed in more than one boundary (Sebuah komponen ditempatkan di lebih dari satu boundary)

Pohon boundary sebuah Release menempatkan satu komponen di dua boundary yang berbeda. Kedua penempatan itu tidak digabungkan maupun diperingkatkan, dan memang tidak dapat: boundary sebuah komponen menentukan di mana output-nya ditulis, di subdirektori mana ia berada, sync wave mana yang diikutinya, serta anotasi boundary dan infra boundary mana yang diwarisinya — sementara permukaan uses: per-edge-nya dibaca oleh penelusuran terpisah. Komponen yang disebut dua kali akan mengambil lokasi output-nya dari satu penempatan dan konfigurasi per-edge-nya dari penempatan lainnya.

Sebuah boundary menempatkan komponen dengan tiga cara, dan ketiganya dihitung. Menyebut satu komponen langsung di bawah components:, dengan id yang dibawanya setelah komposisi selesai, menempatkannya. Menyebut satu komponen di dalam components: milik sebuah entri routing, dengan nama lokal yang dibawanya di dalam submodul tersebut, juga menempatkannya. Dan me-routing seluruh submodul di bawah aggregates: menempatkan setiap komponen yang dikandung modul itu. Jadi halt ini juga mencakup satu submodul yang di-routing ke dua boundary, sebuah modul yang di-routing ke satu boundary sementara modul yang bersarang di dalamnya di-routing ke boundary lain, dan sebuah komponen yang disebut di satu boundary sementara modul yang memuatnya di-routing ke boundary yang berbeda.

Me-routing sebuah modul ke dalam sebuah boundary dan juga menyebut salah satu komponennya di bawah boundary yang sama bukanlah konflik — kedua penempatan sepakat tentang tempat komponen itu — dan build berhasil. Satu id yang ditulis dua kali di bawah satu boundary tetap merupakan konflik bahkan di sana: entri di components: milik boundary dan entri untuk komponen yang sama di dalam entri routing boundary itu adalah dua entri yang membawa konfigurasi untuk satu komponen, tanpa ada yang dapat dipilih di antara keduanya.

Setiap penempatan yang bermasalah dilaporkan. Release yang menempatkan beberapa komponen dua kali berhenti dengan satu pesan seperti ini untuk setiap entri yang bermasalah dalam satu build, masing-masing pada kunci entri yang dipersoalkannya — jadi beberapa pesan sekaligus berarti satu build yang menyebut semua yang ditemukannya, bukan satu kesalahan yang dituliskan lebih dari sekali.

Penempatan yang dilaporkan pesan sebagai sudah berlaku tidak selalu yang ditulis pertama dalam file. Entri components: milik sebuah boundary dibaca sebelum komponen yang disebut oleh entri routing-nya dan sebelum submodul yang di-routing-nya, dan sebuah boundary dibaca sebelum boundary yang bersarang di dalamnya; boundary yang ditulis berdampingan dibaca sesuai urutan kemunculannya. Jika lebih dari satu penempatan sebelumnya berkonflik, yang pertama dibacalah yang disebut. Kedua lokasi disebut bagaimanapun urutannya, dan tidak ada yang diperingkatkan di atas yang lain.

Pesan yang dikeluarkan. Kalimatnya menyatakan aturannya; bagian selanjutnya menyebut entri yang bermasalah, boundary tempat masing-masing dari kedua penempatan berada, blok tempat masing-masing ditulis, dan file yang memuat keduanya. Jika entri di bawah components: milik satu boundary bertemu entri sebelumnya di bawah milik boundary lain:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (komponen dideklarasikan di lebih dari satu boundary: deklarasikan setiap komponen tepat di satu boundary)

Dua klausa yang menyebut boundary dirumuskan sesuai blok tempat setiap entri ditulis. Entri yang bermasalah mengambil salah satu dari:

  • named in the components block of boundary "<boundary>" — map components: milik boundary itu sendiri;
  • named inside a routing entry in boundary "<boundary>" — map components: dari sebuah entri routing di bawah aggregates: milik boundary tersebut;
  • routed as a sub-module into boundary "<boundary>" — entri routing itu sendiri.

Penempatan sebelumnya, yang melanjutkan kalimat yang sama, mengambil salah satu dari:

  • while it is already named in the components block of boundary "<boundary>";
  • while it is already named inside a routing entry in boundary "<boundary>";
  • while it is already placed by a sub-module routed into boundary "<boundary>".

Kedua klausa dipilih secara independen, sehingga pasangan apa pun di antaranya dapat muncul, dan that earlier entry naming membawa apa pun yang dituju penempatan sebelumnya: id komponen, atau prefiks submodul jika submodul yang di-routing-lah yang menempatkannya.

Jika entri yang bermasalah adalah entri routing itu sendiri, yang ditujunya adalah submodul, bukan satu komponen, dan pesan menyatakannya demikian alih-alih menyajikan prefiks modul sebagai nama komponen — di sini bertemu submodul sebelumnya yang di-routing ke boundary lain:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (komponen dideklarasikan di lebih dari satu boundary: deklarasikan setiap komponen tepat di satu boundary)

Cara memperbaiki: hapus salah satu dari kedua penempatan yang tidak Anda maksudkan. Pesan menyebut keduanya, sehingga pilihannya ada pada Anda, bukan pada compiler. Jika deklarasi langsung dan modul yang di-routing tidak sepakat, tentukan apakah komponen itu termasuk bersama modulnya atau berdiri sendiri: me-routing modul menempatkannya bersama semua isi modul lainnya, dan menyebutnya secara langsung memisahkannya dari isi tersebut. Jika dua entri routing mengklaim satu modul, hapus routing yang tidak Anda maksudkan — me-routing modul ke sebuah boundary menempatkan setiap komponen yang dikandungnya di sana, sehingga dua entri seperti itu mengklaim kumpulan komponen yang sama.

A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Binding anotasi Manifest mengklaim prefiks yang dicadangkan)

Sebuah Manifest mendeklarasikan binding anotasi di bawah kunci yang diawali prefiks polos aggrega.ai/. Prefiks itu adalah tempat build mencantumkan kunci yang dikeluarkannya sendiri, sehingga binding yang mengklaim kunci di dalamnya akan menempatkan routing Anda dan output platform sendiri dalam satu ruang kunci, bersaing untuk nama yang sama.

Ini menghentikan build, dan tidak dapat sekadar menjadi peringatan. Pencadangan itulah satu-satunya yang menjadikan ruang kunci tersebut milik platform; menerima binding lalu menyebutkannya sesudahnya akan membiarkan tabrakan itu tetap ada dalam build.

Aturan ini menyangkut ruang kunci yang diklaim oleh binding yang ditulis, sehingga kunci yang tidak dideklarasikan binding-nya oleh Manifest yang disajikan dilewati alih-alih dilaporkan — tidak ada binding yang dapat melanggar.

Pesan yang dikeluarkan. Kunci yang bermasalah ditempatkan di depan, karena itulah pokok kalimatnya, dan nilai-nilai sesudahnya masing-masing diawali dengan keterangan tentang apa nilai itu:

manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (binding anotasi manifest menggunakan prefiks yang dicadangkan; tulis binding di bawah domain milik Anda sendiri)

Cara memperbaiki: ganti nama kunci binding ke namespace yang Anda kendalikan. Kunci dengan subprefiks adalah bentuk yang didukung dan tidak dicadangkan: feature.aggrega.ai/… untuk pintasan pustaka standar, atau domain Anda sendiri — acme.aggrega.ai/…, compliance.example.com/… — untuk pintasan perusahaan. Mengganti nama kunci mengubah apa yang ditulis penulis pada sebuah komponen untuk memicu binding, jadi perbarui anotasi yang menggunakannya dalam suntingan yang sama. Kunci milik platform di bawah prefiks polos tercantum di ../providers/well-known-annotations.md.

Dua binding anotasi Manifest bersaing untuk satu slot perutean

Dua binding anotasi dalam satu Manifest merutekan ke Feature yang sama, melalui pilar yang sama, pada path yang sama. Tugas sebuah binding adalah menyatakan ke mana nilai anotasi mendarat, dan dua binding yang menyebut satu tujuan membuat nilai tersebut memiliki dua rute tanpa ada yang dapat dipilih di antara keduanya pada saat ekspansi.

Hanya satu binding yang boleh mendeklarasikan pasangan path-dan-pilar tertentu per Feature target. Dua binding yang menargetkan Feature yang sama pada path yang berbeda adalah penulisan biasa dan berhasil di-build; demikian pula dua binding yang merutekan path yang sama ke dua Features yang berbeda.

Binding ditelusuri dalam urutan yang dideklarasikan oleh Manifest, sehingga binding yang disebut pertama oleh pesan selalu merupakan binding yang lebih awal dalam dokumen Anda.

Pesan yang diemisikan:

manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (binding anotasi manifest bertabrakan pada path+pilar Feature yang sama (Manifest, pada path, binding anotasi kunci pertama dan kunci kedua sama-sama menargetkan Feature URI feature dengan path yang merutekan ke pilar; hanya satu binding yang boleh mendeklarasikan pasangan (path, pilar) tertentu per Feature))

Cara memperbaiki: tentukan binding mana yang memiliki tujuan tersebut dan hapus path dari daftar maps.infra atau maps.values milik binding lainnya, atau hapus binding kedua sepenuhnya. Jika kedua binding ada karena Anda ingin dua kunci anotasi mencapai satu field Feature, pertahankan satu binding dan biarkan kedua kunci anotasi dirutekan melaluinya; jika keduanya ada karena dua nilai berbeda dimaksudkan untuk mendarat di dua tempat, perbaiki path mana pun yang tertulis karena kesalahan.

Sebuah Release mencapai resolusi tanpa melewati jalur pemuatan

Sebuah Release tiba di tahap resolusi dengan membawa sekaligus permukaan components: tingkat atas yang tidak kosong dan boundary default yang disintesis. Kombinasi itu tidak dapat dihasilkan oleh Release yang dimuat secara normal: jalur pemuatan melipat blok components: tingkat atas ke dalam boundary default lalu mengosongkannya, dan dokumen yang secara langsung menuliskan keduanya ditolak oleh skemanya sebelum sampai sejauh ini.

Jadi halt ini tidak melaporkan apa pun yang Anda tulis. Halt ini melaporkan bahwa sesuatu mencapai resolusi dengan memintas jalur pemuatan — paling sering, sebuah Release yang dibangun di memori oleh program penyemat alih-alih dibaca dari file — dan berhenti di sana alih-alih membiarkan build berlanjut pada dokumen yang dua permukaan komponennya tidak sesuai. Membacanya dalam urutan mana pun akan menghasilkan output yang diam-diam menghilangkan atau menggandakan komponen, dan penelusuran boundary serta penelusuran per-edge bahkan tidak akan sepakat satu sama lain tentang komponen mana.

Pesan yang diemisikan:

release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (release mencapai resolusi tanpa dinormalisasi (komponen root tidak kosong bersama boundary default yang disintesis): bangun release melalui inti normalisasi (types.NormalizeRelease melalui jalur pemuatan), bukan literal yang dibuat manual)

Cara memperbaiki: tidak ada, jika Anda menulis YAML — mencapai halt ini dari aggrega build, aggrega validate atau editor berarti compiler memiliki cacat yang layak dilaporkan, dan Release yang Anda build tidak bersalah. Jika Anda menyematkan compiler dan membangun nilai Release dalam kode Anda sendiri, bangunlah melalui jalur pemuatan alih-alih merakit struct secara langsung, sehingga normalisasi yang melipat komponen root ke dalam boundary default dijalankan.

Sebuah referensi library berekspansi ke dirinya sendiri

Sebuah rantai referensi lintas dokumen kembali ke dokumen yang sudah dicapainya, sehingga ekspansinya tidak akan pernah selesai. Dua permukaan penulisan mencapai kondisi yang sama, dan keduanya merupakan rantai antar entitas library, bukan sesuatu di dalam satu file: $ref: dari pilar skema ke entri SchemaLibrary yang merujuk balik, dan $import: ke entri MappingLibrary atau WorkloadLibrary yang melakukan hal yang sama.

Rantai dibandingkan berdasarkan kunci kanonis — identitas library dan nama entri, dengan host registry dan penulisan versi dihapus — sehingga sebuah siklus tidak dapat lolos dari pemeriksaan dengan menyebut entri yang sama dengan dua cara berbeda di sepanjang jalurnya. Referensi yang berekspansi dan berakhir tidak bermasalah berapa kali pun muncul dan sedalam apa pun rantainya; kedalaman saja tidak pernah menyebabkan halt ini, dan menggunakan ulang satu entri library dari banyak tempat adalah pola yang menjadi alasan keberadaan library.

Pesan yang dikeluarkan, untuk rantai $import:, yang menyebut seluruh loop dalam urutan penelusurannya sehingga Anda dapat melihat langkah mana yang menutupnya:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> (ekspansi referensi melingkar)

Rantai $ref: justru dilaporkan oleh compiler bentuk ringkas, yang membingkainya dengan dokumen dan kata kunci yang sedang dibacanya:

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> (compactform pada file konsumen (kata kunci): ekspansi $ref lintas dokumen melingkar)

Cara memperbaiki: baca rantai dalam pesan dan putuskan pada langkah mana pun yang tidak dimaksudkan. Siklus biasanya berarti dua entri library masing-masing ditulis untuk memperluas yang lain; satukan bagian bersama ke dalam entri ketiga yang dirujuk keduanya, atau sisipkan langsung ke salah satunya. Langkah terakhir yang ditampilkan adalah langkah yang menutup loop, tetapi belum tentu langkah yang salah — seluruh rantai dicetak justru karena tautan mana yang harus diputus adalah keputusan Anda.

Kondisi yang sama juga mendasari penolakan rekursi anchor yang didokumentasikan di bawah “YAML anchor aliased inside its own content” di atas. Yang itu adalah loop di dalam teks satu dokumen; yang ini adalah loop antar dokumen. Rantai dalam pesan membedakan keduanya sekilas: loop antar dokumen menyebut entri library, dan loop di dalam satu dokumen menyebut sebuah anchor.

Skema yang dideklarasikan tidak dapat di-resolve

Sebuah skema mencapai titik digunakan untuk memvalidasi sesuatu dan sama sekali tidak dapat dirakit menjadi skema. Penyebab paling umum adalah $ref: yang tidak menyebut apa pun yang dapat di-resolve; skema yang tidak memenuhi meta-skema JSON Schema mencapai halt yang sama, begitu pula cabang then: atau else: di bawah kata kunci kondisional yang tidak dapat di-resolve dengan sendirinya.

Penolakan terjadi sebelum apa pun divalidasi terhadap skema, dan urutan itulah intinya. Melewatkan skema yang tidak terbaca akan membiarkan semua yang dicakupnya tidak tervalidasi sementara build melaporkan keberhasilan — sebuah pemeriksaan yang telah berhenti berjalan tanpa ada yang memberi tahu bahwa ia berhenti.

Pesan yang dikeluarkan, menyebut posisi di dalam skema, kata kunci yang tidak dapat di-resolve, dan apa yang dilaporkan oleh resolusi:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (validator/jsonschema: resolusi skema gagal (pada path di dalam skema, kata kunci, apa yang dilaporkan resolusi))

Jika kegagalan terjadi di root skema alih-alih pada kata kunci di dalamnya, posisi dan kata kunci dihilangkan dan kalimat hanya memuat alasan yang dilaporkan.

Cara memperbaiki: buka skema pada posisi yang disebut pesan. $ref: adalah penyebab yang biasa: pastikan targetnya ada, bahwa referensi dalam dokumen mengeja path #/$defs/…-nya dengan tepat, dan bahwa referensi lintas dokumen menyebut entri SchemaLibrary yang benar-benar ada dalam closure dependensi build. Jika pesan menyebut cabang then: atau else:, cabang itu adalah skema tersendiri dan harus dapat di-resolve dengan sendirinya.

Predikat x-aggrega-when: atau x-aggrega-validate: tidak dapat dievaluasi

Sebuah skema mendeklarasikan salah satu dari dua kata kunci ekstensi bernilai templat, dan templat tersebut tidak dapat digunakan: nilainya bukan string, tidak dapat di-parse sebagai templat, gagal saat dijalankan, atau merender sesuatu selain true atau false.

x-aggrega-when: menentukan apakah sebuah cabang kondisional dari skema berlaku; x-aggrega-validate: menentukan apakah sebuah nilai memenuhi aturan yang tidak dapat diungkapkan oleh kata kunci skema itu sendiri. Keduanya dibaca sebagai putusan, karena itulah hasil yang bukan putusan ditolak alih-alih ditafsirkan: predikat yang merender string kosong akan dibaca sebagai false dan secara diam-diam menonaktifkan aturan yang hendak ditegakkannya.

Pesan yang diemisikan:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: evaluasi ekstensi x-aggrega gagal (pada, kata kunci))

dengan "x-aggrega-when" sebagai pengganti kata kunci tersebut bila predikat kondisionalnya yang bermasalah, dan alasan yang dilaporkan menyebutkan kesalahan templat — posisi parse, fungsi yang tidak ada, atau nilai non-boolean yang dihasilkan templat.

Cara memperbaiki: buka skema pada posisi yang disebutkan pesan dan baca alasan yang dilaporkan. Pastikan nilai kata kunci tersebut berupa string, templatnya dapat di-parse, dan setiap path yang ditelusurinya memang dimiliki oleh nilai yang divalidasi — predikat membaca nilai sebagai .value, dan merujuk hal lain adalah kesalahan yang paling umum. Bila alasannya menyebutkan kunci yang tidak ditemukan oleh index, periksa keberadaan kunci dengan hasKey atau baca dengan get: index berhenti pada kunci map yang tidak dimiliki map tersebut, sebagaimana dijelaskan di bagian “A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)” di bawah. Pastikan templat diakhiri dengan menghasilkan true atau false: perbandingan menghasilkannya, sedangkan templat yang hanya merender nilai tidak.

Sebuah Workload tidak memenuhi skema Workload

Blok workload: milik sebuah Recipe atau FeatureRecipe telah dibaca dan diperiksa terhadap skema Workload, dan satu atau lebih field tidak memenuhinya — kunci yang salah eja, nilai dengan tipe yang salah, field wajib yang tidak diisi, atau nilai di luar rentang atau enumerasi yang dideklarasikan.

Laporannya dikelompokkan: satu halt memuat setiap field yang bermasalah, sehingga Workload dengan empat kesalahan memberi tahu Anda keempatnya dalam satu build, bukan satu per build. Header menyebutkan Workload, Recipe yang mendeklarasikannya, dan berkasnya; setiap temuan di bawahnya menyebutkan path field di dalam Workload, apa yang diwajibkan skema di sana, dan perbaikannya bila dapat dinyatakan.

Pesan yang diemisikan:

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage) (validasi workload gagal (Workload dalam Recipe, pada, tahap skema)): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated> .initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated>

Kegagalan tanpa detail per field — blok tidak dapat dibaca sama sekali, alih-alih dibaca lalu dinyatakan tidak memenuhi — memuat seluruh alasannya sebagai satu-satunya temuan.

Bila templat workload: membaca nilai yang dideklarasikan sensitif, tidak ada temuan yang mengutip nilai. Field mana dari dokumen hasil render yang berasal dari nilai tersebut tidak dapat diketahui, sehingga setiap temuan yang teksnya dapat memuat nilai menyatakan batasan skema dengan <redacted> sebagai pengganti nilai, diakhiri pemberitahuan yang menyebutkan alasannya, dan tidak memuat perbaikan yang diturunkan dari nilai tersebut:

.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)

Temuan yang tidak mengutip nilai — kunci yang hilang, kunci yang tidak diterima Workload — dibaca seperti pada templat lainnya. Lihat vocabulary/compact-form-authoring.md “Apa yang dinyatakan penolakan tentang nilai yang dideklarasikan”.

Build melaporkan halt ini dengan tag CATALOG_ERROR, karena blok workload: ditulis oleh penulis Recipe, bukan oleh Aggregate atau Release.

Cara memperbaiki: buka Recipe pada path field yang tercantum dan perbaiki masing-masing. Path diberikan dari root Workload itu sendiri, sehingga .containers.main.health.ready adalah blok ready di bawah kunci health milik container main. Container bernama dialamatkan dengan kuncinya dan init container dengan posisinya, karena itulah keduanya terbaca berbeda. Apa yang diterima setiap field tercantum dalam referensi penulisan Workload.

Field yang diharapkan skema berupa teks, tetapi ditolak karena nilainya angka atau boolean, hampir selalu berarti ekspresi templat tanpa tanda kutip. Blok workload: dirender sebelum diperiksa, sehingga ekspresi yang ditulis tanpa tanda kutip diekspansi menjadi teks polos dan YAML kemudian membaca teks itu sesuai rupanya. Kuantitas ukuran core utuh, versi yang hanya terdiri dari digit, port, serta kata yes, no, on, dan off semuanya terbaca sebagai sesuatu selain teks. Temuan menyebutkan tipe yang dibaca YAML, dan solusinya adalah memberi tanda kutip pada ekspresi di Recipe — cpu: "{{ .infra.compute.cpu }}" alih-alih cpu: {{ .infra.compute.cpu }} — sehingga nilainya tetap teks apa pun yang diberikan operator. Perlu dicatat bahwa nilai operator sendiri tidak bermasalah di sini dan memberinya tanda kutip di Release tidak mengubah apa pun: tanda kutip harus ada di Recipe, mengapit ekspresinya.

A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Lampiran Workload menyebut slot yang tidak dideklarasikan entitas, atau pengiriman yang dilarang slot tersebut)

Entri attachments: sebuah kontainer di dalam blok workload: merujuk ke slot lampiran, dan rujukan tersebut tidak cocok dengan slot yang dideklarasikan Component atau Feature dalam featuresSchema-nya — atau, untuk entri yang menyebut koneksi dengan connection:, dengan slot yang dideklarasikan soket koneksi tersebut. Entri envFrom yang menyebut koneksi tunduk pada aturan koneksi yang sama. Temuan menyebutkan bentuk mana yang Anda miliki.

  • Slot tidak dideklarasikan. from: pada entri menyebut slot yang tidak dimuat dalam featuresSchema entitas — salah ketik, atau slot yang diganti namanya hanya di satu sisi.
  • Slot bersifat blackbox. Slot mendeklarasikan daftar izin inject: yang kosong, yang mencadangkan pengiriman untuk mekanisme internal Recipe itu sendiri. Slot semacam itu diisi dan dikonsumsi secara internal, sehingga Workload tidak dapat menjangkaunya.
  • Pengiriman berada di luar daftar izin slot. as: pada entri menyebut mekanisme yang tidak diizinkan oleh daftar inject: slot.
  • Koneksi bukan koneksi yang ditarik komponen. connection: pada entri menyebut alias yang tidak digunakan oleh koneksi mana pun dari komponen.
  • Soket koneksi tidak mendeklarasikan slot. from: pada entri (atau, pada envFrom, secret:) menyebut slot yang tidak dideklarasikan oleh soket yang dilalui koneksi tersebut.
  • Slot ditulis dengan nama gabungannya. from: (atau secret:) pada entri adalah nama yang diambil lampiran sebuah koneksi pada komponen — alias, titik, dan slot — yang ditulis tanpa connection:. Slot sebuah koneksi hanya dapat dijangkau dengan menyebut koneksinya.

Setiap entri yang bermasalah di seluruh kontainer dilaporkan bersama, sehingga satu build menyebut semuanya. Temuan dikelompokkan di bawah satu header yang menyebut Workload, Recipe-nya, dan berkasnya.

Pesan yang diemisikan:

workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot>

Pada entri envFrom, temuan yang sama berada di .containers.<name>.envFrom[<i>].connection dan .containers.<name>.envFrom[<i>].secret.

Cara memperbaiki: setiap temuan menyebut kedua sisi, sehingga pilihannya adalah sisi mana yang diubah. Untuk slot yang tidak dideklarasikan, perbaiki ejaan from: atau deklarasikan slot dalam featuresSchema entitas — akhiran .from pada jalur field menunjuk ke rujukan tersebut. Untuk slot blackbox, hapus rujukan di sisi Workload dan biarkan Recipe mengirimkan materinya, kecuali pengiriman di sisi Workload memang diinginkan, dalam hal ini berikan slot daftar izin inject:. Untuk mekanisme yang ditolak, ganti as: dengan mekanisme yang disebut daftar izin, atau tambahkan mekanisme Anda ke dalamnya. Untuk koneksi yang tidak ditarik komponen, perbaiki alias menjadi salah satu yang dicantumkan temuan, atau tarik koneksi tersebut di Aggregate atau Release. Untuk slot yang tidak dideklarasikan soket, sebut salah satu slot yang dicantumkan temuan, atau deklarasikan slot dalam featuresSchema soket pada Component. Untuk nama gabungan, tulis koneksi dan slot secara terpisah, seperti yang ditunjukkan temuan.

A Workload references a slot whose fill publishes no locator (Workload merujuk slot yang pengisinya tidak memublikasikan lokator)

Entri attachments: sebuah kontainer menyebut slot melalui rujukan, dan lampiran yang mengisi slot tersebut tidak memublikasikan kunci provides yang dibaca oleh rujukan semacam itu. Merujuk slot dengan nama berarti meminta agar sumber daya yang diwakilinya dialamatkan dalam keluaran yang dirender — dengan nama sumber daya, dan dengan field di dalamnya. Pengisi yang tidak memublikasikan keduanya tidak memiliki lokator untuk ditunjuk, sehingga rujukan tidak dapat diubah menjadi apa pun.

Kunci yang diwajibkan bergantung pada entri, dan temuan menyebutkan mana yang diharapkan. Entri yang menyebut key: miliknya sendiri menyediakan field itu sendiri, sehingga hanya name sumber daya yang harus dipublikasikan — inilah yang memungkinkannya merujuk sumber daya multi-kunci. Entri yang tidak menyebut key: membaca satu-satunya field yang dipublikasikan slot, sehingga name dan key keduanya harus ada.

Pemeriksaan hanya membaca apakah kunci-kunci tersebut ada; nilainya tidak pernah diperiksa. Setiap entri yang bermasalah dilaporkan bersama, di bawah satu header.

Pesan yang diemisikan:

workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference

Cara memperbaiki: ada dua arah, dan mana yang tepat bergantung pada maksud Anda. Jika rujukannya benar, lampiran yang mengisi slot itulah yang perlu diubah: lampirkan Feature yang schema.provides-nya mendeklarasikan name — dan key, jika entri tidak menyebut kuncinya sendiri — sehingga ada lokator untuk ditunjuk. Jika materi tersebut memang tidak dimaksudkan untuk dialamatkan dengan nama dalam keluaran, hapus rujukan dan kirimkan melalui pipa inject: slot sebagai gantinya, yang membawa nilainya alih-alih penunjuk ke lokasinya.

A container gives one environment variable two values (Sebuah kontainer memberikan dua nilai untuk satu variabel lingkungan)

Satu kontainer dalam blok workload: menyebut variabel lingkungan yang sama dua kali: sekali sebagai kunci dari variables-nya, dan sekali sebagai kunci dari entri attachments yang dikirimkan as: env. Kontainer utama dan kontainer init masing-masing diperiksa, baik dalam Workload yang dirender oleh Recipe sebuah komponen maupun dalam Workload yang dirender oleh FeatureRecipe — yang dilampirkan ke komponen maupun yang dideklarasikan pada sebuah batas — dan pemeriksaan membaca Workload sebagaimana templatnya merendernya.

Mengapa build berhenti alih-alih memilih salah satu. Lingkungan sebuah kontainer ditulis dari kedua koleksi tersebut dalam urutan yang tetap — provider helm dan compose menulis setiap entri yang dibaca dari lampiran terlebih dahulu, lalu variables biasa setelahnya. Karena itu, sebuah nama yang ditulis dengan kedua cara akan sampai ke proses dengan nilai mana pun yang dimenangkan oleh urutan tersebut, yang merupakan akibat dari tempat kedua jenis itu ditempatkan, bukan dari apa pun yang Anda tulis, sehingga build menolak pasangan itu alih-alih merendernya. Pemeriksaan dijalankan sekali, apa pun provider yang merender Workload, setelah pemeriksaan lain atas Workload dan sebelum entri artifacts: dievaluasi atau Workload diserahkan ke provider mana pun, sehingga pasangan yang ditolak tidak pernah dirender. Entri attachments yang dikirimkan as: file dipasang sebagai berkas, bukan ditetapkan di lingkungan, sehingga tidak pernah membentuk pasangan.

Pemeriksaan hanya membandingkan nama; pemeriksaan tidak pernah membaca nilai, sehingga tidak ada temuan yang mengutip nilai. Dua jenis entri lingkungan berada di luar yang dibandingkannya: entri envFrom menetapkan kunci-kunci dari ConfigMap atau Secret yang disebutnya, yang belum diketahui saat build berjalan, dan entri yang ditulis oleh langkah pipeline ke dalam dokumen yang dirender bukan bagian dari Workload yang dibaca pemeriksaan.

Setiap pasangan merupakan temuan tersendiri, yang diposisikan pada kunci workload: dari Recipe atau FeatureRecipe yang mendeklarasikan Workload, dan menyebut variabel serta kontainernya — kontainer utama dengan kuncinya, kontainer init dengan posisinya dalam daftar initContainers. Temuan muncul dengan kontainer utama terlebih dahulu, sesuai urutan penulisannya, lalu kontainer init menurut posisi, dan di dalam satu kontainer sesuai urutan penulisan entri attachments-nya.

Pesan yang dikeluarkan, untuk pasangan pada kontainer utama dari Workload sebuah Recipe. Kategori dan kode singkat kondisi ini, E0345, sampai kepada Anda di bagian kepala bertanda kurung siku, dan posisinya terbaca <path> at .spec.workload:

a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (sebuah kontainer mendeklarasikan satu variabel lingkungan dua kali. Ganti nama salah satunya, atau tulis keduanya di bawah kondisi templat yang saling melengkapi sehingga hanya satu yang dirender)

Pasangan pada kontainer init menyebut posisinya dalam daftar sebagai gantinya — init container "initContainers[<i>]" — dan temuan dari FeatureRecipe menyebut lampiran yang mengikatnya setelah kontainer, attachment "<attachment>", karena sebuah komponen dapat membawa beberapa lampiran yang FeatureRecipes-nya merupakan dokumen terpisah.

Jika satu Workload membawa beberapa pasangan, temuan dikelompokkan di bawah satu baris yang menyebut dokumennya: containers of the Workload this Recipe renders name one environment variable twice, atau, untuk FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice.

Build melaporkan penghentian ini di bawah tag CATALOG_ERROR, karena blok workload: ditulis oleh penulis Recipe atau FeatureRecipe, bukan oleh Aggregate atau Release.

Cara memperbaiki: tentukan mana dari keduanya yang harus diterima kontainer. Jika keduanya diperlukan, ganti nama salah satunya, sehingga proses melihat dua variabel. Jika keduanya merupakan alternatif — misalnya nilai cadangan biasa untuk saat tidak ada kredensial yang dilampirkan — lindungi keduanya dengan kondisi yang saling melengkapi sehingga tepat satu yang dirender: tulis variabel di bawah {{ if not (hasKey (default dict .features) "<slot>") }} dan entri attachments di bawah {{ if hasKey (default dict .features) "<slot>" }}, atau di bawah dua cabang dari satu {{ if }}/{{ else }}. Pasangan yang dilindungi dengan cara itu tidak pernah mencapai pemeriksaan, karena hanya satu dari keduanya yang ada dalam Workload yang dirender.

A Release’s parameters: block is written in neither of its two shapes (Blok parameter sebuah Release tidak ditulis dalam salah satu dari dua bentuknya)

Sebuah Release memenuhi parameter yang dideklarasikan sebuah Aggregate dengan salah satu dari dua cara, dan blok tersebut dibaca berdasarkan bentuknya. Blok itu berupa pemetaan nama parameter ke nilai yang ditulis di tempat, atau berupa pemetaan dengan tepat satu kunci, $import:, yang nilainya adalah path berkas YAML yang memuat nilai-nilai tersebut. Blok yang bukan keduanya ditolak saat dibaca, sebelum apa pun memeriksa nilainya terhadap deklarasi Aggregate.

Tiga bentuk ditolak. Nilai parameters: yang sama sekali bukan pemetaan — skalar, atau daftar. Pemetaan yang membawa $import: bersama kunci lain, yang meminta nilai yang diimpor dan nilai yang ditulis sekaligus tanpa memberikan aturan untuk menggabungkannya. Dan $import: yang nilainya bukan string biasa, yang tidak menyebut berkas apa pun.

Skema Release mendeklarasikan dua bentuk yang sama, sehingga file Release yang membawa salah satu dari ketiganya lebih dulu menemui pemeriksaan envelope dokumen, di bawah E0215, yang mencoba kedua bentuk dan menyatakan mengapa masing-masing gagal — berikut untuk daftar:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (validasi envelope dokumen gagal (Release); spec.parameters: tidak ada cabang oneOf yang cocok (2 cabang dicoba): branch[0]: tipe: diharapkan objek, didapat array; branch[1]: tipe: diharapkan objek, didapat array. perbaiki dokumen agar sesuai dengan skema jenisnya)

Untuk $import: di samping kunci lain, cabang kedua berakhir dengan additionalProperties: unexpected property: "<key>", dan untuk $import: yang ditulis sebagai daftar alih-alih string, berakhir dengan validation: type: array has type "array", want "string".

Pesan yang dikeluarkan, jika nilainya bukan pemetaan, menyebut apa yang ditulis di sana — misalnya a list:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: bentuk harus berupa objek inline atau pemetaan yang hanya berisi $import: bentuk lain ditulis di tempat yang seharusnya berisi map)

dan jika $import: berbagi pemetaan dengan hal lain, atau menyebut sesuatu yang bukan path:

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (bentuk parameters: harus berupa objek inline atau {$import: path lokal}: $import: harus menjadi satu-satunya kunci, ditemukan beberapa kunci pada baris) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (bentuk parameters: harus berupa objek inline atau {$import: path lokal}: nilai $import harus berupa skalar string pada baris)

Cara memperbaiki: buka Release pada baris yang disebut pesan. Tulis nilai-nilainya di tempat di bawah parameters:, atau ganti seluruh blok dengan satu entri $import: yang nilainya berupa path bertanda kutip. Jika Anda menginginkan nilai yang ditulis dan berkas impor berisi nilai bawaan bersama, pindahkan nilai yang ditulis ke dalam Release yang melakukan extends: terhadap Release yang memuat impor tersebut — menumpuk beberapa sumber parameter adalah kegunaan rantai extends:, dan satu kunci ini dibaca dari satu sumber secara sengaja.

An inline-or-import field is written in neither shape (Bidang inline-atau-impor tidak ditulis dalam salah satu dari kedua bentuknya)

Tiga bidang yang ditulis oleh Recipe atau FeatureRecipe — entri artifacts.<name>:, valuesMapping:, dan workload: — menerima dua bentuk yang sama. Isinya ditulis di tempat, sebagai skalar string (blok | adalah penulisan yang lazim untuk apa pun yang lebih dari satu baris), atau nilainya berupa mapping dengan tepat satu kunci, $import:, yang menyebutkan tempat isi tersebut berada. Apa yang dapat disebutkan oleh $import: berbeda menurut bidangnya: entri artifacts mengimpor path lokal atau bundel dari ArtifactLibrary, sedangkan valuesMapping: dan workload: mengimpor path lokal atau entri dari library berdasarkan identitas.

Satu pembaca memeriksa ketiganya, sehingga penolakannya sama, yaitu tiga, bidang mana pun yang bermasalah: mapping yang memuat lebih dari satu kunci, mapping yang satu-satunya kuncinya bukan $import, dan $import: yang nilainya bukan string biasa. Nilai yang bukan skalar maupun mapping — paling sering berupa list — ditolak berdasarkan bentuknya saja.

Skema Recipe dan FeatureRecipe mendeklarasikan dua bentuk yang sama untuk masing-masing dari ketiga field, sehingga file yang membawa salah satu kasus ini lebih dulu menemui pemeriksaan envelope dokumen, di bawah E0215, yang menyebut field-nya dan menyatakan mengapa masing-masing bentuk gagal — cabang pertama adalah bentuk yang ditulis di tempat, cabang kedua adalah bentuk $import::

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (validasi envelope dokumen gagal (Recipe); tidak ada cabang oneOf yang cocok untuk entri spec.artifacts ini (2 cabang dicoba): branch[0]: validasi: tipenya objek, diharapkan string; branch[1]: additionalProperties: properti yang tidak terduga. perbaiki dokumen agar sesuai dengan skema jenisnya)

Itu adalah pemetaan yang membawa kunci di samping $import:. Satu kunci yang bukan $import berakhir dengan required: missing required property: $import, additionalProperties: unexpected property: "<key>", daftar berakhir dengan type: expected object, got array, dan $import: yang bukan string menyebut tipe yang ditemukan di tempat yang seharusnya string, seperti pada type: array has type "array", want "string".

Pesan yang dikeluarkan. Masing-masing diawali dengan kalimat untuk bidang yang bermasalah, lalu menyebutkan apa yang ditemukan pembaca dan di mana:

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (entri artifacts: bentuk harus berupa skalar string atau impor path lokal: ditemukan sejumlah kunci pada baris tersebut) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: bentuk harus berupa skalar string atau impor path atau identitas pustaka: ditemukan kunci tersebut pada baris tersebut) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: bentuk harus berupa skalar string atau impor path atau identitas pustaka: nilai impor harus berupa skalar string pada baris tersebut)

Ketiga field tersebut dapat melaporkan akhiran mana pun di atas; nilai yang bukan salah satu dari kedua bentuk diakhiri dengan line <line>: <shape> is written where text or a map is expected, yang menyebut apa yang ditulis — paling sering a list.

Cara memperbaiki: buka entitas pada baris yang disebutkan pesan. Tulis isinya di tempat sebagai skalar blok, atau ganti seluruh nilai dengan satu entri $import:. Mapping yang memuat $import: beserta hal lain bukan salah satu dari kedua bentuk — pindahkan kunci tambahan ke dalam file yang diimpor, atau tulis isinya di tempat. $import yang salah eja — paling sering karena $ hilang — dibaca sebagai kunci biasa dan dilaporkan sebagai satu-satunya kunci yang bukan $import.

A reference to a library entry carries whitespace (Referensi ke entri library memuat spasi)

Referensi yang menyebutkan entri di dalam library ditulis sebagai satu token tanpa putus: library, batas bawah :<version> opsional, lalu # dan path entri — BaseWorkloads:1.0.0#/workloads/StatelessService. Tidak ada bagiannya yang menerima spasi. Nama library dan nama entri sama-sama dibatasi pada ejaan pengenal oleh skema library, dan versi adalah versi, sehingga spasi, tab, atau pergantian baris di mana pun dalam referensi tidak termasuk dalam ketiganya.

Penolakan ini mencakup setiap tempat yang merujuk entri library berdasarkan identitas: valuesMapping:, workload:, dan entri artifacts.<name>: yang ditulis sebagai $import:, serta $ref: skema. Path lokal yang ditulis sebagai $import: tidak memuat # dan bukan referensi ke entri library, sehingga path yang mengandung spasi tidak terpengaruh.

Yang membuat hal ini layak ditolak alih-alih dirapikan adalah bahwa bagian awal nilai seperti itu biasanya merupakan referensi tersendiri. Memotong pada spasi akan me-resolve referensi tersebut dan diam-diam membuang sisa yang ditulis penulis — dan kedua bagian build tidak harus membuang jumlah yang sama, sehingga satu bagian dapat mencatat dependensi yang tidak pernah dilihat bagian lainnya. Dengan menolak, nilai tetap bermakna satu hal.

Penolakan dilaporkan pada baris dokumen tempat referensi dibaca:

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (referensi library: referensi ke entri library tidak memuat spasi atau pergantian baris: target $import pada baris)

Referensi dapat mencapai build dari satu tempat lagi: isi entri library yang telah di-resolve oleh build, tempat $import: di akar bidang pada baris pertama menunjuk ke entri library lain. Referensi itu tidak pernah dibaca dari dokumen yang dibuka build, sehingga dilaporkan tanpa baris:

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (referensi library: referensi ke entri library tidak memuat spasi atau pergantian baris)

Cara memperbaiki: buka entitas pada baris yang disebutkan pesan dan rapatkan referensi agar menjadi satu token. Pergantian baris sebelum # adalah penyebab yang umum — referensi yang dipecah ke dua baris agar muat dalam kolom dibaca sebagai satu nilai oleh YAML dan sebagai referensi rusak di sini, jadi tulislah dalam satu baris seberapa pun panjangnya. Penyebab lainnya adalah spasi di akhir sebelum tanda kutip penutup: spasi itu masuk ke dalam batas bawah versi, sehingga menyebutkan versi yang tidak dimiliki artefak terbitan mana pun. Untuk bentuk kedua, referensi berada di dalam library yang disebutkan tepat sebelumnya dalam pesan; perbaiki di tempat library tersebut mendeklarasikan entrinya.

A library entry’s body is not the shape that library holds (Isi entri library tidak berbentuk sesuai yang dimuat library tersebut)

Library menerbitkan isi bernama untuk diimpor entitas lain, dan setiap jenis library memuat satu bentuk. Entri MappingLibrary dan entri WorkloadLibrary masing-masing memuat satu isi template, sehingga nilai entri berupa skalar — dalam praktiknya blok |. Entri ArtifactLibrary memuat sebuah bundel: file-file yang saling terkait di bawah satu nama, sehingga entri tersebut berupa mapping dari nama file keluaran ke isi file itu, dan setiap isi di bawahnya berupa skalar.

Isi disimpan persis seperti ditulis dan tidak di-parse saat library dimuat. Template di dalamnya di-parse di tempat ia diimpor, itulah sebabnya yang diperiksa di sini hanya bentuknya — isi yang sama sekali bukan template dimuat tanpa keluhan dan gagal pada saat sesuatu me-render-nya.

Pesan-pesan yang dikeluarkan, masing-masing menyebut baris dan apa yang ditulis di sana — misalnya a list:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: isi entri harus berupa skalar string: bentuk lain ditulis di tempat yang seharusnya berisi teks) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: isi entri harus berupa skalar string: bentuk lain ditulis di tempat yang seharusnya berisi teks) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: entri harus berupa pemetaan dari nama file ke isi string: bentuk lain ditulis di tempat yang seharusnya berisi map)

dan, untuk bundel yang entrinya berupa mapping tetapi salah satu filenya bukan skalar, dengan menyebutkan file tersebut:

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: entri harus berupa pemetaan dari nama file ke isi string: di file ini, bentuk lain ditulis di tempat yang seharusnya berisi teks)

Build melaporkan hal ini di bawah tag CATALOG_ERROR yang menyebutkan file yang sedang dibacanya, dengan kalimat di atas di bawahnya.

Cara memperbaiki: tulis isi sebagai skalar blok di bawah kuncinya. Isi yang baris pertamanya tampak seperti kunci YAML — yang biasanya terjadi pada template yang menghasilkan YAML — dibaca sebagai mapping bersarang kecuali ada skalar blok, dan itulah penyebab yang umum. Untuk ArtifactLibrary, tulis satu kunci per nama file keluaran dengan setiap isi sebagai skalar bloknya sendiri; bundel yang ditulis sebagai satu isi adalah kesalahan bentuk umum lainnya.

A $instantiate: reference cannot be resolved (Referensi tidak dapat di-resolve)

Sebuah SchemaLibrary dapat mendeklarasikan bentuk yang dapat digunakan ulang di bawah spec.templates, masing-masing dengan $params miliknya sendiri, dan sebuah entri skema kemudian menginstansiasi salah satunya dengan menyebut namanya di bawah $instantiate: dan memberikan parameternya di bawah $args:. Substitusi bersifat literal: skalar $<name> di badan templat diganti dengan nilai argumen. Tidak ada evaluasi ekspresi, tidak ada kondisional dan tidak ada perulangan, dan nilai yang disubstitusi disisipkan apa adanya alih-alih dipindai untuk mencari penanda lebih lanjut.

Tiga kesalahan menolak instansiasi. Nama di bawah $instantiate: bukan nama yang dideklarasikan library tersebut. Parameter yang dideklarasikan templat tanpa default: tidak memiliki entri di bawah $args:. Atau nilai argumen bukan tipe yang dideklarasikan parameternya — dan kunci $args: yang tidak menyebut parameter yang dideklarasikan dilaporkan dengan cara yang sama, alih-alih diabaikan, sehingga nama argumen yang salah eja menjadi penolakan, bukan parameter yang diam-diam memakai nilai default.

Pesan yang dikeluarkan:

schemalibrary: template not found: "<template-name>" not declared in spec.templates (templat tidak ditemukan: tidak dideklarasikan di spec.templates) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (parameter templat tidak ada) schemalibrary: template parameter type mismatch: <what the type check found> (tipe parameter templat tidak cocok) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (tipe parameter templat tidak cocok: argumen tidak dideklarasikan di $params templat)

Cara memperbaiki: untuk templat yang tidak ditemukan, perbaiki namanya menjadi nama yang dideklarasikan library di bawah spec.templates — dan periksa bahwa Anda mengimpor library yang Anda maksud. Untuk parameter yang tidak ada, tambahkan ke $args:, atau beri parameter tersebut default: di templat agar pemanggil dapat menghilangkannya. Untuk ketidakcocokan tipe, ubah argumen ke tipe yang dideklarasikan atau perluas type: parameter tersebut; jika pesan menyebut argumen yang tidak dideklarasikan, perbaiki ejaannya atau hapus argumen itu.

A schema uses a JSON Schema keyword the library does not admit (Skema menggunakan kata kunci JSON Schema yang tidak diterima library)

$dynamicAnchor dan $dynamicRef tidak diterima dalam konten SchemaLibrary. Keduanya menunda penentuan skema yang menjadi tujuan sebuah referensi hingga nilai sedang divalidasi, sehingga makna entri library bergantung pada dari mana entri itu diimpor, bukan pada isinya — dan compiler me-resolve bentuk-bentuk sebuah library sebelum validasi apa pun, sehingga tidak ada apa pun yang dapat menjadi sasaran resolve bagi referensi yang ditunda.

Penolakan diterapkan di tiga titik, yang bersama-sama menutup kedua jalan masuk kata kunci tersebut. Entri skema dipindai saat library dimuat. Badan templat dipindai saat library dimuat, sehingga templat yang memuat kata kunci secara literal gagal pada titik itu, bukan pada build mana pun yang pertama menginstansiasinya. Dan badan hasil substitusi dipindai lagi setelah instansiasi, sehingga memberikan kata kunci sebagai nilai argumen tidak dapat lolos dari dua pemeriksaan pertama.

Pesan yang diemisikan:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (kata kunci JSON Schema terlarang pada baris)

Cara memperbaiki: ganti referensi yang ditunda dengan $ref yang langsung menyebut entri $defs. Jika bentuknya memang bervariasi per penggunaan, nyatakan variasi itu sebagai templat dengan $params dan instansiasi per penggunaan — itulah substitusi yang ditawarkan permukaan ini, dan substitusi itu di-resolve sebelum apa pun divalidasi terhadap hasilnya.

A document nests deeper than the reader will descend (Dokumen bersarang lebih dalam daripada batas yang akan ditelusuri pembaca)

Setiap mapping yang ditulis dibaca ke dalam struktur yang mempertahankan urutan penulisan kuncinya, karena urutan itu sampai ke keluaran yang di-render dan merupakan bagian dari apa yang membuat build identik byte demi byte di setiap eksekusi. Pembaca itu menelusuri jumlah tingkat yang terbatas — seratus — dan menolak masuk lebih dalam, sehingga masukan yang jika tidak dibatasi akan menghabiskan stack milik pembaca itu sendiri dilaporkan sebagai penolakan.

Pesan yang diemisikan:

a document nests too many levels deep: it is read at most 100 levels deep (dokumen bersarang terlalu dalam: dokumen dibaca paling dalam 100 tingkat)

Cara memperbaiki: dokumen yang ditulis manusia bersarang hanya beberapa tingkat, sehingga dokumen yang mencapai seratus tingkat adalah hasil generator, hasil terjemahan mesin, atau tanpa sengaja merujuk dirinya sendiri. Cari nilai yang berkembang menjadi dirinya sendiri — anchor YAML yang merujuk konten tempat ia berada ditolak oleh halt-nya sendiri di atas, tetapi generator yang berulang kali mengeluarkan bentuk yang sama tidak. Jika kedalaman itu memang nyata, angkat cabang yang dalam menjadi entitas tersendiri dan rujuk dengan namanya.

A provider declares a well-known annotation at a scope it does not render (Provider mendeklarasikan anotasi well-known pada cakupan yang tidak di-render-nya)

Sebuah Plugin yang melayani provider menyatakan dua hal tentang dirinya yang harus selaras. Di bawah spec.provider.wellKnownAnnotations ia mencantumkan anotasi yang ditindaklanjutinya, masing-masing dengan cakupan tempat ia membacanya. Di bawah contract.inputKinds ia menyatakan jenis masukan mana saja yang di-render-nya. Kunci yang dideklarasikan pada cakupan yang jenis masukannya tidak diklaim oleh entitas yang sama berarti kedua pernyataan itu saling bertentangan dalam satu file, sehingga entitas tersebut ditolak saat dimuat.

Pemeriksaan ini adalah perbandingan entitas terhadap dirinya sendiri, itulah sebabnya pemeriksaan ini tidak memerlukan biner plugin dan dijalankan di mana pun entitas dibaca — termasuk penelusuran katalog pada mesin yang belum pernah mengambil artefak tersebut.

Dua jenis entri sengaja tidak dibandingkan. Entri bercakupan boundary tidak menyebut jenis masukan, karena di-resolve sekali untuk seluruh boundary, bukan pada jalur render satu node tertentu. Entri yang sama sekali tidak mendeklarasikan cakupan tidak membuat klaim per jalur: entri itu hanya menyatakan bahwa plugin membaca kunci tersebut di suatu tempat.

Yang tidak dibuktikan oleh penolakan ini adalah bahwa deklarasi yang tetap berlaku itu benar. Tidak ada yang dapat membuktikan bahwa plugin yang melayani provider benar-benar membaca kunci yang dikatakannya dibaca; yang dapat dilakukan perbandingan dua field yang ditulis adalah menolak pasangan yang tidak mungkin sama-sama benar. Kunci yang dideklarasikan pada cakupan yang memang di-render provider, tetapi plugin-nya tidak membaca apa pun di sana, lolos di sini.

Pesan yang diemisikan:

provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render (provider mendeklarasikan anotasi well-known pada cakupan, tetapi contract.inputKinds-nya tidak diklaim; deklarasikan kunci hanya pada cakupan yang di-render provider, atau klaim jenis masukan tersebut: wellKnownAnnotations: sebuah kunci dideklarasikan pada cakupan yang tidak di-render oleh kontrak provider)

Cara memperbaiki: pesan menyebut kedua sisinya. Hapus cakupan itu dari daftar scope: anotasi, dengan menyisakan cakupan yang memang di-render provider, atau klaim jenis masukan tersebut di bawah contract.inputKinds jika provider memang me-render-nya.

A compact-form schema uses a keyword the compact form does not know (Skema bentuk ringkas menggunakan kata kunci yang tidak dikenal oleh bentuk ringkas)

Skema yang ditulis dalam bentuk ringkas memuat kunci yang bukan kata kunci bentuk ringkas, bukan salah satu kata kunci JSON Schema yang diteruskan oleh bentuk tersebut, dan bukan pula salah satu dari tiga penanda yang dicadangkan oleh bentuk tersebut — $jsonschema:, $mode:, dan $ref:. Kunci yang tidak dikenal ditolak saat skema dibaca, bukan dibuang, karena batasan yang salah ketik lalu diabaikan sama saja dengan tidak ada batasan sama sekali, dan skema yang tampak diberlakukan tetapi tidak memberlakukan apa pun lebih buruk daripada skema yang gagal.

Penolakan ini terjadi di mana pun skema dikompilasi. Entri sebuah SchemaLibrary dikompilasi saat katalog dimuat; spec.schema milik sebuah Component, valueSchema dan infraSchema per soket miliknya, serta skema yang dideklarasikan oleh sebuah Feature dan sebuah Plugin provider dikompilasi saat katalog dibaca. spec.schema milik Component atau Feature melaporkan kondisi ini sendiri, dengan menyebut entitas dan field-nya; valueSchema atau infraSchema milik soket melaporkannya di dalam “A declared schema contract cannot be read as a schema (Kontrak skema yang dideklarasikan tidak dapat dibaca sebagai skema)” di bawah, dengan kalimat yang dikutip di sini sebagai detailnya.

Kalimat dari kompiler bentuk ringkas sendiri menyebutkan posisi di dalam skema, baris sumber, dan kunci yang tidak dikenalinya:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (kata kunci tidak dikenal)

Kunci yang ditulis di samping $ref: lintas dokumen dilaporkan dengan kondisi yang sama, dengan kalimatnya sendiri, karena hanya tiga kunci saudara yang boleh menyertai referensi semacam itu:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (kunci saudara $ref lintas dokumen tidak diizinkan; yang diizinkan: properties, required, description)

dan jika kunci saudara tersebut meminta untuk membuka kembali bentuk gabungan, kalimatnya memuat cara yang seharusnya digunakan:

compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties (kunci saudara $ref lintas dokumen tidak diizinkan; gunakan $jsonschema: untuk menyematkan skema objek terbuka jika bentuk gabungan harus menerima properti sembarang)

Kondisi yang mencatatnya adalah compactform: unknown keyword, yang merupakan hasil resolusi kode singkatnya.

Cara memperbaiki: perbaiki kunci pada posisi yang disebutkan kalimat tersebut, dengan mengacu pada kosakata kata kunci di compact-form-authoring.md — salah ketik adalah penyebab paling umum. Jika bentuknya memang memerlukan kata kunci JSON Schema yang tidak dimuat bentuk ringkas, tulis fragmen tersebut di bawah $jsonschema:, yang menyematkan JSON Schema apa adanya. Di samping referensi lintas dokumen, pertahankan hanya properties:, required:, dan description:; selebihnya termasuk dalam entri pustaka yang dirujuk referensi tersebut.

A compact-form schema declares a field literally named type (Skema bentuk ringkas mendeklarasikan field yang secara harfiah bernama type)

Bentuk ringkas menentukan makna sebuah mapping dari bentuk isinya: kunci type: menandai daun batasan, kata kunci struktural JSON Schema menandai fragmen yang diteruskan, dan mapping berisi nama biasa menandai objek yang anak-anaknya adalah skema. Skema yang mendeklarasikan field bernama type adalah satu-satunya bentuk yang tidak dapat dibedakan oleh pembacaan tersebut — tampak seperti daun batasan padahal dimaksudkan sebagai objek dengan satu field — sehingga bentuk ini meminta penulis menyatakan yang mana, dengan kunci $mode: yang diatur ke compact atau jsonschema.

Kondisi ini dilaporkan oleh $mode: yang ditulis dengan nilai lain. Penanda tersebut ada untuk menyelesaikan ambiguitas, sehingga nilai yang tidak menyelesaikan apa pun ditolak, bukan ditebak.

Kalimat dari kompiler bentuk ringkas sendiri:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (nilai harus compact atau jsonschema)

Kondisi yang mencatatnya adalah compactform: ambiguous dispatch — $mode required, yang merupakan hasil resolusi kode singkatnya.

Cara memperbaiki: atur $mode: compact jika mapping tersebut adalah objek bentuk ringkas yang kebetulan memiliki field bernama type, atau $mode: jsonschema jika mapping tersebut adalah fragmen JSON Schema yang harus diambil apa adanya. Jika tidak satu pun pembacaan itu yang dimaksud, mengganti nama field akan menghilangkan ambiguitas tanpa memerlukan penanda sama sekali.

A $jsonschema: escape carries content that is not a schema (Escape $jsonschema: memuat konten yang bukan skema)

Kunci $jsonschema: menyematkan fragmen JSON Schema apa adanya, untuk bentuk yang tidak dapat dinyatakan oleh bentuk ringkas. Apa yang disematkannya diambil sebagaimana ditulis dan tidak pernah diterjemahkan, sehingga isinya harus berupa skema: skalar blok yang dapat di-parse sebagai YAML, atau mapping bersarang. Konten yang bukan keduanya ditolak di sini, bukan diteruskan untuk dijadikan acuan validasi, karena di sana kegagalannya akan dilaporkan terhadap konsumen skema, bukan terhadap skemanya.

Empat bentuk dilaporkan dengan kondisi ini, dan kalimatnya menyebutkan bentuk mana yang Anda hadapi. Badan escape tidak dapat di-parse sebagai YAML. Nilai escape bukan skalar blok dan bukan mapping. Kunci properties: memuat sesuatu yang bukan mapping dari nama ke skema. Dan, pada tingkat terluar, dokumen yang diberikan ke kompiler kosong atau memuat node yang tidak memiliki aturan di pembaca.

Kalimat-kalimat dari kompiler bentuk ringkas sendiri:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (konten escape tidak dapat di-parse sebagai YAML) compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (diharapkan string skalar blok atau mapping bersarang) compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (diharapkan mapping dari nama properti ke skema) compactform: unsupported YAML node kind (jenis node YAML tidak didukung)

Kondisi yang mencatatnya adalah compactform: $jsonschema content invalid, yang merupakan hasil resolusi kode singkatnya.

Cara memperbaiki: tulis badan escape sebagai skalar blok di bawah $jsonschema: — badan yang baris pertamanya terbaca sebagai kunci YAML akan terserap ke dalam mapping di sekitarnya, dan itulah penyebab yang umum — lalu periksa bahwa isinya merupakan JSON Schema yang valid dengan sendirinya. Jika fragmen tersebut cukup kecil untuk dinyatakan dalam bentuk ringkas, menghapus escape adalah jawaban yang lebih sederhana.

A compact-form constraint does not apply to the type it was written on (Batasan bentuk ringkas tidak berlaku untuk tipe tempat batasan itu ditulis)

Batasan bentuk ringkas didistribusikan berdasarkan tipe field yang dideklarasikan: min: dan max: menjadi batas numerik pada angka, batas panjang pada string, dan batas jumlah pada array. Jadi, batasan harus berada pada field yang tipenya menerimanya, dan tipenya harus berupa satu nilai agar distribusi tersebut memiliki jawaban.

Empat bentuk dilaporkan dengan kondisi ini. Batasan yang ditulis di tempat type: tidak ada atau menyebutkan union, sehingga tidak ada yang menentukan batas mana yang dimaksud. Batasan yang ditulis pada tipe yang tidak menerima batas jenis itu — objek, atau boolean. type: yang nilainya bukan nama skalar dan bukan urutan nama. Dan valuesType: yang diberi sesuatu selain nama skalar.

Kalimat-kalimat dari kompiler bentuk ringkas sendiri:

compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint (batasan berlaku untuk satu tipe yang dideklarasikan; type: belum terselesaikan — persempit type: menjadi satu nilai atau hapus batasan ini) compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (batasan berlaku untuk integer/number/string/array; tipe yang dideklarasikan adalah) compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind (diharapkan nama tipe skalar atau urutan nama tipe; diperoleh jenis node yang tidak didukung) compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name (diharapkan nama tipe skalar)

Kondisi yang mencatatnya adalah compactform: constraint not valid for declared type, yang merupakan hasil resolusi kode singkatnya.

Cara memperbaiki: kalimat tersebut menyebutkan kedua sisi — batasan dan tipe yang ditemuinya. Persempit type: menjadi satu nama jika berisi union, tambahkan jika tidak ada, atau hapus batasan jika field tersebut memang menerima salah satu dari beberapa tipe. Batas yang harus bervariasi sesuai tipe dinyatakan sebagai sekumpulan alternatif di bawah $jsonschema:, dengan setiap cabang memuat tipe dan batasnya sendiri.

Sebuah $ref: tidak ditulis dalam bentuk yang dapat diresolusi oleh compiler

Sebuah skema mereferensikan bentuk lain dengan $ref:, baik di dalam dokumen yang sama maupun lintas dokumen ke sebuah entri SchemaLibrary. Dua kondisi mencakup dua cara sebuah referensi gagal, dan kalimatnya memberi tahu Anda mana yang Anda alami: referensi tidak ditulis dalam bentuk yang dibaca compiler, atau referensi tersebut sudah benar bentuknya tetapi menyebut target yang tidak ada.

Referensi tidak dapat dibaca. Nilainya kosong, atau bentuk lintas dokumennya bukan <Library>#/schemas/<Entry>, atau versinya dipisahkan dengan @ — yang dilaporkan beserta ejaan yang sudah dikoreksi alih-alih sebagai keluhan umum, karena itulah kesalahan yang paling sering terjadi pada bentuk ini:

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL (diharapkan URL referensi yang tidak kosong) compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> (bentuk $ref lintas dokumen harus berupa nama library, #/schemas/, lalu nama entri) compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written> (pemisah versi $ref lintas dokumen adalah ’:’, bukan ’@’ — gunakan nilai yang sudah dikoreksi)

Kondisi tempat pesan-pesan tersebut dicatat adalah compactform: $ref unresolvable.

Target tidak ada. Referensi terbaca dengan benar, tetapi library atau entri di dalamnya tidak ada — atau sama sekali tidak ada katalog library yang disediakan untuk resolusi:

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> (SchemaLibrary tidak ditemukan dalam katalog) compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> (entri tidak ditemukan dalam SchemaLibrary) compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written> ($ref lintas dokumen tetapi tidak ada katalog SchemaLibrary yang disediakan)

Kondisi tempat pesan-pesan tersebut dicatat adalah compactform: cross-document $ref target not found.

Memisahkan keduanya membuat laporan dapat ditindaklanjuti: yang pertama adalah nilai yang harus ditulis ulang di dokumen yang sedang Anda lihat, dan yang kedua adalah pertanyaan tentang apa yang dapat dilihat oleh build. Referensi yang mengembang ke dirinya sendiri adalah hal ketiga lagi, dan dilaporkan sebagai “A library reference expands into itself (Referensi library mengembang ke dirinya sendiri)” di atas.

Cara memperbaiki: untuk referensi yang tidak dapat dibaca, tulis ulang nilainya — <Library>#/schemas/<Entry> untuk referensi lintas dokumen, #/$defs/<name> untuk referensi di dalam dokumen yang sama — dan gunakan : sebelum batas bawah versi alih-alih @. Untuk target yang tidak ada, pastikan nama entri sesuai dengan library yang menerbitkannya, dan pastikan library tersebut dapat dijangkau dari penutupan dependensi Release: library yang tidak dideklarasikan sebagai dependensi oleh apa pun tidak dimuat, sehingga referensi yang benar ke dalamnya tetap tidak teresolusi ke apa pun.

Ketika library hanya berada di cache artefak. Cache menyimpan apa yang ditaruh di sana oleh sebuah fetch, dan library yang di-cache dihitung sebagai konten katalog hanya jika sebuah entri dalam lockfile Release menjamin digest-nya. Ketika cache menyimpan SchemaLibrary yang tidak di-pin oleh entri lockfile mana pun dan tidak disediakan oleh direktori katalog mana pun, laporan diikuti oleh baris remediation: yang menyebutkan setiap library tersebut dan tindakan yang berhasil untuk perintah yang melaporkannya:

  • aggrega build dan aggrega validate --release membaca lockfile Release, sehingga baris mereka menyebutkan aggrega pull --release <release>, yang me-resolve library dan mencatat entrinya, atau menulis library di bawah direktori katalog.
  • aggrega validate tanpa argumen, dan aggrega validate dengan path entitas baik --release diberikan maupun tidak, membaca library hanya dari direktori katalog dan tidak membaca lockfile, sehingga entri yang tercatat tidak akan mengubah putusannya. Baris mereka menyatakan hal itu, dan menunjuk ke penulisan library di bawah direktori katalog, atau ke aggrega pull --release <release> yang diikuti aggrega validate --release <release>, yang memeriksa Release terhadap library yang di-pin oleh lockfile-nya.

Pull yang tidak menemukan library semacam itu melaporkannya di bawah A reference names no entity the catalog holds (Referensi menyebutkan entitas yang tidak dimuat katalog), dengan barisnya sendiri.

Sebuah $ref: menunjuk library berdasarkan lokasi registry

Sebuah $ref: lintas dokumen menyebut library-nya berdasarkan identitas — nama polos library, lalu # dan path entri — dan tidak pernah berdasarkan registry tempat library itu kebetulan diterbitkan. Registry mana yang digunakan untuk meresolusi sebuah nama ditentukan oleh konfigurasi workspace, dan versi mana yang digunakan adalah jawaban lockfile, sehingga referensi yang membawa host akan mengunci di dalam skema dua hal yang seharusnya diputuskan oleh build, dan akan memindahkan skema antar-workspace sebagai referensi yang rusak.

Jika nilai yang membawa host masih dapat diurai menjadi sebuah library dan sebuah entri, kalimatnya menyertakan ejaan bentuk identitas yang harus digunakan sebagai gantinya:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written> ($ref lintas dokumen membawa host registry; referensikan library berdasarkan identitas)

dan jika tidak, kalimatnya berakhir setelah nilai tersebut:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written> ($ref lintas dokumen membawa host registry; referensikan library berdasarkan identitas)

Kondisi tempat pesan ini dicatat adalah compactform: cross-document $ref carries a registry host; reference the library by identity, yang merupakan hasil resolusi kode singkatnya.

Cara memperbaiki: hapus host dan semua yang ada sebelum nama library, sehingga tersisa <Library>#/schemas/<Entry>. Jika batas bawah versi diinginkan, tulis setelah nama library sebagai :<version>. Aturan yang sama berlaku untuk bidang $import: pada Recipe dan FeatureRecipe, yang dilaporkan secara terpisah di bawah “A library $import: addresses its library by registry location (Sebuah library mengalamatkan library-nya berdasarkan lokasi registry)” di bawah.

Sebuah $import: skema tidak dapat diterapkan

spec.schema milik sebuah Component atau Feature — seluruh bloknya atau salah satu pilarnya — serta valueSchema: atau infraSchema: milik soket usesSchema masing-masing dapat ditulis sebagai $import: yang menyebut sebuah file di samping entitas. Impor diterapkan saat entitas dimuat, sehingga setiap pembaca berikutnya melihat kontrak yang diimpor, bukan penunjuknya. Kondisi ini terjadi ketika sesuatu yang Anda tulis bermasalah: direktif itu sendiri, atau bentuk isi file yang disebutnya.

Kesalahan-kesalahan tersebut merupakan satu kondisi karena masing-masing membuat permukaan yang sama tidak dapat digunakan dan memberi Anda hal yang sama untuk dilakukan — perbaiki direktifnya, atau file yang disebutnya. Diagnostik dibuka dengan kalimat tetap lalu menyebutkan kesalahannya, sehingga kalimat itulah bagian yang dicocokkan dan klausa sesudahnya adalah hal yang perlu ditindaklanjuti:

a schema $import: could not be applied. <surface>: <the clause for this occurrence>

Klausa tersebut menyebut permukaan yang dibacanya — spec.schema, salah satu pilarnya seperti spec.schema.values, atau valueSchema milik sebuah soket — diikuti kesalahan spesifiknya. Kesalahan-kesalahan tersebut, dan artinya masing-masing:

  • $import: must be the only key when a schema is imported from a file. (harus menjadi satu-satunya kunci ketika skema diimpor dari file.) Direktif berbagi mapping dengan konten skema yang ditulis. $import: menggantikan seluruh nilai, sehingga kunci saudara tidak memiliki apa pun untuk digabungkan.
  • $import: value must be a path to a file. (nilainya harus berupa path ke sebuah file.) Nilainya kosong, atau bukan satu string tunggal.
  • $import: takes a file path beside this entity, not a registry location <value>. (menerima path file di samping entitas ini, bukan lokasi registry.) Nilainya menunjuk ke sebuah registry. Registry mana yang digunakan untuk me-resolve sebuah nama adalah konfigurasi workspace, sehingga permukaan skema tidak pernah memuatnya; pesan tersebut menyebutkan bentuk referensi yang harus digunakan sebagai gantinya.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. (menerima path file di samping entitas ini; rujuk entri SchemaLibrary dengan kata kunci ref sebagai gantinya.) Nilainya menunjuk ke sebuah entri library. Entri library dirujuk, bukan diimpor — $ref: adalah kata kunci yang me-resolve-nya.
  • imported schema <value> must be a YAML map of schema content; it is not. (skema yang diimpor harus berupa map YAML berisi konten skema; ternyata bukan.) File ditemukan, dibaca, dan di-parse, dan hasil parse-nya berupa skalar atau sequence, sehingga tidak ada konten skema untuk disubstitusikan.

Bagian kepala memuat kategori dan kode singkat kondisi ini, E0266, yang merupakan identifier untuk dicatat ketika Anda perlu menamai halt ini secara permanen — di gerbang continuous integration, sebuah issue, atau runbook. Sebuah nomor diberikan sekali lalu tetap, sehingga nomor itu tidak berubah betapa pun redaksi di sekitarnya diperbaiki; tabel semua kondisi me-resolve-nya.

Direktif yang tersusun dengan benar dan menyebut file yang tidak dapat dijangkau build dilaporkan di tempat lain, dengan kode yang berbeda. Path yang tidak ter-resolve, file yang tidak ada atau tidak dapat dibaca, dan byte yang tidak dapat di-parse sebagai YAML bukanlah kesalahan dalam apa yang Anda tulis — tidak ada dokumen impor untuk dinilai — sehingga semuanya dilaporkan sebagai kegagalan pemuatan, di bawah “A file cannot be read, or its bytes do not parse (File tidak dapat dibaca, atau byte-nya tidak dapat di-parse)” di atas, yang mendokumentasikan klausa yang dibawa masing-masing. Cocokkan dengan kondisi tersebut, dan catat kodenya, ketika yang Anda tangkap adalah file impor yang hilang atau tidak dapat dibaca.

Path di-resolve terhadap direktori yang memuat file entitas, basis yang sama yang digunakan setiap field lain yang memuat impor. Impor yang kontennya sendiri mendeklarasikan $import: akan diikuti, dan rantai yang kembali ke file yang sedang diproses dilaporkan sebagai “A library reference expands into itself (Referensi library mengembang ke dirinya sendiri)” di atas, bukan di sini. Direktif yang ditulis di dalam file yang dibawa masuk oleh impor dilaporkan pada file tersebut dan baris di dalamnya, karena di sanalah koreksi dilakukan; direktif yang ditulis di entitas dilaporkan pada entitas.

Cara memperbaiki: jadikan $import: satu-satunya kunci dalam mapping-nya, dan berikan path relatif ke file YAML di samping entitas yang tingkat teratasnya berupa map konten skema. Untuk menggunakan bentuk yang diterbitkan sebuah SchemaLibrary, gunakan $ref: <Library>#/schemas/<Entry> sebagai gantinya — entri library dirujuk, bukan diimpor.

A schema block names a key that is not a data pillar (Blok skema menyebut kunci yang bukan pilar data)

Blok spec.schema milik sebuah Component atau Feature memuat pilar data entitas, dan tiga kunci adalah keseluruhan yang diterimanya: values, bentuk yang diisi developer per instans; infra, ukuran fisik yang disediakan operator; dan provides, kunci yang diekspos entitas kepada apa pun yang menggunakannya. Kondisi ini terjadi ketika blok memuat kunci lain di tingkat teratasnya.

Himpunan ini tertutup, bukan terbuka, dengan alasan yang sama konten setiap pilar divalidasi secara tertutup: blok yang mengenumerasi permukaan yang sah menjadikan apa pun di luar permukaan itu sebuah error. Kunci yang tidak dikenali apa pun akan memuat kontrak yang tidak pernah dikompilasi, divalidasi, atau diserahkan kepada konsumen — sehingga apa yang Anda tulis di bawahnya akan tampak terdeklarasi tetapi tidak berpengaruh. Hal itu lebih sulit disadari daripada kontrak yang tidak pernah Anda tulis sama sekali, itulah sebabnya blok tersebut ditolak alih-alih kunci liarnya diabaikan.

Diagnostik dibuka dengan kalimat tetap, lalu menyebutkan entitas, aturan, lokasi kunci itu ditulis, dan apa yang harus ditulis sebagai gantinya:

a schema block declares a key that names no data pillar (<Kind> <name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set. (blok skema mendeklarasikan kunci yang tidak menyebut pilar data apa pun. Ganti nama kunci menjadi salah satu kunci pilar, atau hapus kunci itu beserta kontrak di bawahnya; yang diizinkan: values, infra, provides. Lihat vocabulary/data-pillars.md untuk himpunan pilar kanonis.)

Bagian kepala memuat kategori dan kode singkat kondisi ini, E0267, yang merupakan identifier untuk dicatat ketika Anda perlu menamai halt ini secara permanen — di gerbang continuous integration, sebuah issue, atau runbook. Sebuah nomor diberikan sekali lalu tetap, sehingga nomor itu tidak berubah betapa pun redaksi di sekitarnya diperbaiki; tabel semua kondisi me-resolve-nya.

Dua hal yang ditulis di posisi tersebut bukan kunci dari himpunan ini, dan keduanya tidak dilaporkan di sini. $import: yang menyebut file di samping entitas digantikan oleh konten file itu sebelum blok dibaca, sehingga yang diperiksa kondisi ini adalah tingkat teratas dokumen yang diimpor itu sendiri — kunci liar di dalam file yang diimpor dilaporkan di sini, sedangkan direktifnya sendiri tidak pernah. Dan Component yang mendeklarasikan extends menulis string polos inherited sebagai pengganti blok, yang merupakan skalar tanpa kunci sama sekali.

Cara memperbaiki: kalimat tersebut menyebut kunci yang ditemuinya dan tiga kunci yang diterimanya, sehingga penyebab paling umum — salah eja, atau bentuk tunggal padahal nama pilarnya jamak — terlihat dari diagnostik saja. Jika konten di bawah kunci liar itu termasuk dalam sebuah pilar, pindahkan ke bawah values:, infra: atau provides: sesuai kepemilikannya; data-pillars.md menjelaskan pilar mana memiliki apa. Jika konten itu dimaksudkan sebagai konten skema tersendiri, tempatnya satu tingkat lebih dalam, di dalam sebuah pilar, bukan di sampingnya. Bentuk yang diterbitkan sebuah SchemaLibrary dijangkau dengan $ref: <Library>#/schemas/<Entry> yang ditulis di dalam sebuah pilar, bukan di tingkat blok.

A plugin asks the host to parse a source while a parse is already running for it (Sebuah plugin meminta host mengurai sebuah sumber saat penguraian untuknya sedang berjalan)

Sebuah plugin dapat meminta host mengurai sebuah sumber dan mengembalikan hasilnya, sehingga plugin yang memerlukan dokumen dalam suatu format tidak perlu membawa pembacanya sendiri. Host menjalankan plugin yang menghasilkan penguraian tersebut dan mengembalikan apa yang dihasilkannya. Kondisi ini terjadi ketika plugin yang dijangkau dengan cara itu meminta penguraiannya sendiri: permintaan tersebut akan masuk kembali ke mekanisme yang sama yang sedang menjalankannya, dan host menolak alih-alih turun lebih dalam. Satu tingkat inilah yang ditawarkan mekanisme tersebut, dan penolakan inilah yang membatasinya pada satu tingkat.

Penolakan ini sampai ke plugin, bukan ke build. Host tidak berhenti di sana lalu membatalkan proses; host menjawab panggilan tersebut dengan amplop kegagalan yang membawa kalimat di bawah ini dan sebuah kode yang menamai penolakan tersebut, dan plugin yang meminta menerimanya sebagai jawaban atas permintaannya. Apa yang kemudian dilakukan build bergantung pada apa yang dilakukan plugin tersebut dengan jawaban itu — plugin yang memperlakukannya sebagai fatal mengakhiri build, sedangkan plugin yang melaporkannya lalu melanjutkan tidak. Penolakan itu sendiri tetap sama dalam kedua kasus.

Ini bukan kesalahan salah satu plugin secara khusus: pengaman ini mencakup pasangan plugin mana pun yang dilalui permintaan tersebut, bukan satu pasangan tertentu, sehingga penolakan yang sama ditemui di mana pun mekanisme tersebut dimasuki kembali.

Pesan yang dikeluarkan, sebagaimana diterima plugin:

aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (aggrega_parse_source: masuk kembali producer-consumption ditolak: producer yang dijangkau melalui host tidak boleh mengeluarkan panggilan producer-consumption lebih lanjut)

Cara memperbaiki: tidak ada apa pun dalam berkas Anda sendiri yang menyebabkan ini dan tidak ada perubahan penulisan yang menghilangkannya — ini adalah sifat plugin yang dikonfigurasi untuk build tersebut. Plugin yang meminta penguraian dari dalam sebuah penguraian adalah yang perlu diperbaiki, jadi laporkan kondisi ini kepada penerbitnya dengan mengutip pesannya. Jika plugin tersebut milik Anda, buat plugin itu membaca langsung sumber yang diserahkan kepadanya alih-alih meminta host mengurai sumber lain selagi plugin itu sendiri sedang melayani sebuah penguraian.

The workspace configuration is invalid (Konfigurasi workspace tidak valid)

Sebuah workspace dideskripsikan oleh .aggrega-config.yaml di root-nya: registry tempat workspace memublikasikan dan menarik, lokasi cache artefak, plugin mana yang dipasang pada socket mana, dan sikap penandatanganan setiap registry. Berkas itu dibaca dan diperiksa terhadap skemanya sebelum berkas entitas mana pun dibuka, karena semua yang menyusul dibaca darinya.

Berkas yang tidak ada bukanlah kegagalan. Workspace tanpa berkas konfigurasi mendapatkan nilai bawaan yang terdokumentasi, sehingga penghentian ini tidak pernah menyebut berkas yang tidak ada. Penghentian ini menyebut berkas yang membawa nilai tersebut — atau, untuk pengaturan yang ditimpa oleh variabel lingkungan dan tidak pernah dilihat skema, variabel tersebut.

Pemeriksaan berjalan sebelum dokumen diubah menjadi pengaturan bertipe. Urutan itulah yang memungkinkan pesan menyebut jalur field yang ditolak skema, alih-alih melaporkan ketidakcocokan tipe dari tempat lain yang lebih jauh tanpa field yang dapat ditunjuk.

Bentuk-bentuk berikut dilaporkan di sini selain keberatan skema biasa, masing-masing karena skema saja hanya dapat menyatakan sesuatu yang terlalu umum untuk ditindaklanjuti: kunci workspace: yang ditulis tanpa isi di bawahnya, kunci yang tempatnya di tingkat teratas tetapi ditulis di bawah workspace:, blok cache: yang ditulis dengan nama yang tidak digunakan berkas, host registry yang tidak ditulis sebagaimana host registry ditulis, dan tiga pengaturan yang nilainya diterima skema tetapi tidak dapat digunakan workspace — artifact_cache_dir yang absolut atau yang menyebut root workspace itu sendiri, entri signing.kinds yang menyebut sesuatu yang bukan jenis artefak yang dapat dipublikasikan, dan entri plugins.providers atau providers_append yang uri-nya berupa lokasi registry yang ditulis dengan oci://. Binding provider menyebut plugin-nya berdasarkan identitasnya, provider/<name> dengan :<version> opsional, karena identitas itulah yang dicocokkan dengan binding ketika sebuah kapabilitas di-resolve; lokasi registry menyatakan di mana sebuah plugin dipublikasikan, bukan plugin yang mana, sehingga entri yang ditulis sebagai lokasi registry tidak akan pernah dapat memilih apa pun. Entri yang menyebut fungsi entri dengan function: tanpa uri: juga dilaporkan di sini, jika entri itu adalah entri plugins.linter atau linter_append, atau entri plugins.governance atau governance_append dalam peran putusan, ir-verdict atau render-verdict: lampiran-lampiran tersebut memilih plugin-nya berdasarkan uri, sehingga entri semacam itu tidak melampirkan plugin apa pun dan fungsi yang disebutnya tidak akan pernah dipanggil — lint akan tetap berjalan seolah-olah entri itu tidak ada, dan build baru akan berhenti belakangan, saat tiba waktunya meresolusi plugin yang tidak pernah disebut entri tersebut.

Direktori katalog yang dicantumkan konfigurasi — di bawah workspace.catalog_dirs atau catalog_dirs_append, atau di entri milik sebuah Release sendiri di bawah workspace.releases, di berkas mana pun tempat konfigurasi dibaca — juga dilaporkan di sini jika ia bukan direktori: tidak ada apa pun di path tersebut, atau di sana terdapat berkas atau tautan yang tidak mengarah ke mana pun. Hal ini dinilai saat sebuah katalog akan dibaca melaluinya, sehingga setiap perintah yang membaca katalog menolaknya sebelum membaca atau menulis apa pun, sementara perintah yang tidak membaca katalog tetap berjalan. Melanjutkan pembacaan tanpanya berarti melakukan build terhadap lebih sedikit katalog daripada yang Anda cantumkan, tanpa ada yang menyatakan katalog mana yang hilang. Direktori yang dicantumkan AGGREGA_CATALOG_DIRS tunduk pada aturan yang sama, dan penolakannya menyebut variabel tersebut sebagai ganti berkas.

Host registry — host dari entri registries, atau host yang mengawali default_registry jika nilainya tidak menyebut salah satu entri tersebut lewat name:-nya, yang dalam hal ini mewakili host entri itu — ditulis sebagai host itu sendiri: huruf kecil, mengandung titik, atau localhost, atau satu nama diikuti port, atau alamat IP (IPv6 di dalam kurung siku), masing-masing dengan :port opsional, dan tanpa skema atau kredensial. Host entri registries tidak membawa jalur; default_registry dapat diikuti setelah host-nya dengan / dan jalur repositori — segmen huruf kecil yang digabung dengan /, tanpa tag, digest, atau / di akhir. Nilai yang menyebut host dengan ejaan lain ditolak dengan menyebut ejaan yang harus ditulis — untuk default_registry, seluruh lokasinya, termasuk jalur — agar kebijakan kepercayaan yang disimpan di bawah host itu berlaku padanya; ini termasuk port 443 pada host yang dijangkau melalui HTTPS, karena itu port bawaan host tersebut. Jalur yang bukan jalur repositori ditolak dengan menyebut host yang diikutinya, dan name: entri yang diikuti jalur ditolak dengan menyebut dua ejaan yang seharusnya ditulis, yaitu nama saja atau host entri diikuti jalur, karena nama mewakili host entrinya dan bukan lokasi di bawahnya. Nilai yang sama sekali tidak menyebut host — satu nama tanpa port yang tidak dimiliki entri mana pun, teks yang berisi spasi atau kurung kurawal — ditolak sebagai bukan host, dan untuk default_registry penolakan menyebutkan bahwa nama entri juga dapat digunakan. AGGREGA_DEFAULT_REGISTRY tunduk pada pembacaan yang sama dan ditolak dengan cara yang sama, dengan menyebut variabel tersebut.

Pesan yang dikeluarkan. Keberatan skema menyebut berkas, jalur field, dan apa yang dinyatakan skema:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (konfigurasi workspace tidak valid)

Bentuk perbaikan (fix-it) diawali dengan berkas dan menyatakan satu kalimat tentang bentuk spesifik tersebut sebagai pengganti jalur field dan keberatan skema. artifact_cache_dir yang menyebut root workspace:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir menyebut root workspace itu sendiri; direktori katalog di root workspace akan dilewati sebagai cache sehingga tidak ada yang dimuat — berikan cache subdirektorinya sendiri (misalnya .aggrega/cache): konfigurasi workspace tidak valid)

entri signing.kinds yang tidak dapat digunakan, yang juga menyebut wildcard yang mencakup setiap jenis:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (entri signing.kinds bukan jenis artefak yang dapat ditandatangani; gunakan jenis entitas katalog atau plugin, atau all untuk setiap jenis: konfigurasi workspace tidak valid)

binding provider yang ditulis sebagai lokasi registry, yang menyebut entri, kapabilitas, dan bentuk yang harus ditulis:

<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (entri plugins.providers mengikat kapabilitas ke lokasi registry, yang menyatakan di mana plugin dipublikasikan, bukan plugin yang mana; binding provider menyebut plugin-nya berdasarkan identitasnya — tulis identitas plugin di uri, dengan versi opsional: konfigurasi workspace tidak valid)

lampiran linter atau lampiran tata kelola berperan putusan yang menyebut fungsi entri tetapi tidak menyebut plugin, yang pesannya menyebutkan daftar, entri, dan fungsinya, di sini pada plugins.linter:

<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (entri plugins.linter menyebut fungsi entri tetapi tidak ada URI plugin; lampiran pada daftar ini memilih plugin-nya berdasarkan URI, sehingga entri ini tidak melampirkan plugin apa pun dan fungsi tersebut tidak pernah dipanggil — tambahkan URI dari plugin yang mengekspornya: konfigurasi workspace tidak valid)

host registry yang ditulis dengan ejaan lain, di sini HUB.AGGREGA.AI:

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry tidak ditulis sebagai host registry yang disebutnya; tulis host tersebut — huruf kecil, tanpa skema, jalur, kredensial, atau port bawaan — yang merupakan ejaan tempat kebijakan kepercayaan host itu disimpan: konfigurasi workspace tidak valid)

registry bawaan yang host-nya ditulis dengan ejaan lain sebelum jalur repositorinya, di sini GHCR.io/acme, yang menyebut seluruh lokasi yang harus ditulis:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry tidak ditulis sebagai lokasi registry yang disebutnya; tulis lokasi tersebut — host registry dalam huruf kecil, tanpa skema, kredensial, atau port bawaan, diikuti jalur repositori — yang membuat kebijakan kepercayaan host itu tetap berlaku padanya: konfigurasi workspace tidak valid)

nama entri yang diikuti jalur, di sini local/acme dengan entri bernama local untuk 127.0.0.1:5000:

<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry adalah nama entri registries yang diikuti jalur, padahal nama entri hanya mewakili host entri tersebut; tulis nama itu untuk menggunakan entri, atau host-nya diikuti jalur: konfigurasi workspace tidak valid)

nilai yang tidak menyebut host, yang kalimatnya mencantumkan bentuk-bentuk sebuah host:

<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (registries[].host bukan host registry; tulis nama host huruf kecil yang mengandung titik (registry.example.com), localhost, satu nama diikuti port (registry:5000), atau alamat IP, IPv6 di dalam kurung siku — masing-masing dengan :port opsional dan tidak ada yang lain: konfigurasi workspace tidak valid)

direktori katalog yang dicantumkan tetapi tidak ada apa pun di sana, yang menyebut berkas dan barisnya, daftarnya, entri sebagaimana ditulis, dan path hasil resolusinya — daftar tersebut adalah workspace.catalog_dirs, workspace.catalog_dirs_append, atau daftar milik sebuah entri Release seperti `catalog_dirs` of the `workspace.releases` entry "release.yaml":

<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (direktori yang disebut entri tersebut tidak ada; buat direktori itu, atau hapus entrinya: konfigurasi workspace tidak valid)

dan penanda workspace: yang kosong:

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspace harus berupa mapping; tulis workspace: {} untuk menandai root workspace tanpa direktori katalog: konfigurasi workspace tidak valid)

Dua lainnya menyebut kunci yang ditulis di tempat yang salah — default_registry, offline, auto_pull, dan artifact_cache_dir semuanya berada di tingkat teratas, bukan di bawah workspace:, dan blok cache parse adalah parse_cache:. Masing-masing menyebutkan kunci yang dimaksud dan tempat kunci itu seharusnya berada.

Cara memperbaiki: buka berkas yang disebut pesan dan buka jalur field yang dikutipnya. Jika pesan membawa kalimat perbaikan, kalimat itu langsung menyebut ejaan atau penempatan yang benar dan tidak perlu membaca lebih lanjut. Jika pesan justru membawa keberatan skema, jalur field adalah kunci yang bermasalah dan keberatan tersebut menyatakan apa yang diharapkan skema di sana — halaman entitas tidak mengatur berkas ini, jadi bacalah keberatan tersebut alih-alih mencari kontrak entitas. artifact_cache_dir ditulis relatif terhadap root workspace dan memerlukan subdirektorinya sendiri, agar direktori katalog di root workspace tidak dianggap sebagai cache lalu dilewati. Binding provider yang ditulis sebagai lokasi registry ditulis ulang secara manual menjadi identitas plugin — oci://hub.aggrega.ai/plugin/provider/compose menjadi provider/compose — karena setiap perintah yang membaca berkas tersebut menolaknya sampai hal itu dilakukan, termasuk aggrega plugin remove; aggrega plugin add provider menulis bentuk identitas itu sendiri. Entri linter atau entri tata kelola berperan putusan yang menyebut fungsi tetapi tidak menyebut plugin diberi uri dari plugin yang mengekspor fungsi tersebut; jika tidak ada yang mengekspornya, hapus entri itu — pada daftar linter, linter standar kemudian berjalan seperti saat tidak ada linter yang dikonfigurasi. Direktori katalog tercantum yang bukan direktori dibuat di path yang disebut penolakan, atau entrinya dihapus dari baris yang disebut penolakan; salinan proyek yang diambil tanpa checkout bersebelahan yang dicantumkannya menghapus entri tersebut.

A plugin binding sets a key the socket it attaches to does not read (Binding plugin menetapkan kunci yang tidak dibaca oleh socket tempatnya terpasang)

Socket dalam konfigurasi workspace memasang plugin dengan dua cara yang berbeda, dan kunci yang termasuk dalam satu cara tidak bermakna apa pun pada cara yang lain. Alih-alih menerima kunci tersebut dan diam-diam mengabaikannya, konfigurasi ditolak, sehingga operator mengetahui bahwa pengaturan tersebut tidak berpengaruh, alih-alih bertanya-tanya kemudian mengapa pengaturan itu tidak berdampak.

Kedua ketidakcocokan ini merupakan bayangan cermin satu sama lain.

  • Socket lintas-bidang yang di-bind berdasarkan kapabilitas. Socket governance, linter, dan importer memasang plugin secara langsung melalui uri:. Plugin governance atau linter tidak melayani kapabilitas apa pun, sehingga binding capability: di sana akan dicari terhadap ketiadaan dan tidak cocok dengan apa pun — sebuah pemasangan yang tidak akan pernah dapat diresolusi. Importer memang mengiklankan format yang ditanganinya, tetapi format mana yang diinginkan ditentukan oleh impor, bukan oleh pemasangan: pemasangan importer menamai importernya melalui uri:, dan itulah yang memilihnya di antara importer yang mengiklankan format yang diminta oleh suatu impor.
  • Socket provider yang menetapkan kunci tanpa rujukan. Binding provider menamai sebuah kapabilitas dan plugin yang melayaninya, dan plugin tersebut menjalankan sekumpulan ekspor yang tetap, bukan satu entri yang dapat dipilih, sehingga function: tidak menamai apa pun padanya. with: ditolak karena alasan yang berbeda: konfigurasi render untuk provider ditulis di dalam Recipe, sehingga menaruhnya pada binding workspace menempatkannya di sisi yang salah dari pemisahan antara pengembang dan operator.

Pesan yang dikeluarkan. Kapabilitas pada socket lintas-bidang:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (socket di-bind berdasarkan kapabilitas, tetapi socket lintas-bidang dipasang melalui uri: plugin-nya tidak melayani kapabilitas, sehingga pencarian kapabilitas tidak cocok dengan apa pun; pasanglah melalui uri: socket lintas-bidang di-bind berdasarkan kapabilitas tetapi dipasang melalui uri)

function: yang tidak berpengaruh pada binding provider:

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (binding socket provider untuk kapabilitas menetapkan function:, tetapi provider menjalankan sekumpulan ekspor tetap yang dikunci per fase, bukan satu entri yang dapat dipilih, sehingga function: tidak menamai apa pun di sana; hapuslah: binding socket provider menetapkan field tanpa rujukan pada socket tersebut)

dan with: yang tidak berpengaruh, yang dilaporkan dengan bentuk yang sama dan menyebutkan tempat konfigurasi itu seharusnya berada:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (binding socket provider untuk kapabilitas menetapkan with:, tetapi konfigurasi render provider berada di Recipe, bukan di binding provider workspace; hapuslah: binding socket provider menetapkan field tanpa rujukan pada socket tersebut)

function: yang ditulis di .aggrega-config.yaml tidak mencapai kalimatnya di atas: skema konfigurasi workspace tidak mendeklarasikan kunci semacam itu pada binding provider, sehingga file ditolak lebih dulu, di bawah E0224, dan solusinya sama — hapus kunci tersebut:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: function pada entri plugins.providers: terhadap /$defs/FixedEntryPluginRef: properti tidak terduga “function”: konfigurasi workspace tidak valid)

Cara memperbaiki: perbaikan dilakukan di .aggrega-config.yaml dan setiap pesan menyebutkan suntingan yang tepat. Pada pemasangan governance, linter, atau importer, ganti capability: dengan uri: dari plugin yang ingin Anda pasang. Pada binding provider, hapus kunci yang disebutkan — dan jika kunci itu adalah with:, pindahkan konfigurasi tersebut ke Recipe yang melakukan render melalui provider tersebut, yang merupakan tempat konfigurasi itu dibaca.

A capability is bound to more than one provider plugin (Sebuah kapabilitas di-bind ke lebih dari satu plugin provider)

Sebuah kapabilitas menamai satu cara mengubah workload menjadi artefak, dan tepat satu plugin melayaninya dalam workspace yang telah diresolusi. Dua binding untuk satu kapabilitas tidak memberikan jawaban tentang mana yang melakukan render, dan konfigurasi workspace disusun dari beberapa lapisan — file bersama, file workspace, dan pendamping append yang dapat disumbangkan masing-masing — sehingga binding kedua sering kali disumbangkan oleh lapisan yang penulisnya tidak dapat melihat binding pertama.

Penolakan inilah yang membuat hal tersebut terlihat. Membiarkan satu binding menang secara diam-diam akan membuat keluaran render bergantung pada lapisan mana yang kebetulan dibaca terakhir.

Pesan yang dikeluarkan, yang menyebutkan kapabilitas dan aturannya:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (kapabilitas di-bind ke lebih dari satu plugin provider; pertahankan tepat satu entri plugins.providers per kapabilitas: kapabilitas di-bind ke lebih dari satu plugin provider)

Cara memperbaiki: pertahankan satu entri plugins.providers untuk kapabilitas yang disebutkan pesan dan hapus yang lain. Jika keduanya berasal dari lapisan konfigurasi yang berbeda, lapisan yang Anda kendalikan adalah yang perlu disunting — menghapus entri Anda sendiri berarti mengadopsi entri yang disumbangkan lapisan bersama, dan mempertahankan entri Anda berarti entri lapisan bersama yang harus dihapus. Dua plugin yang memang sama-sama melayani workspace melayani dua kapabilitas yang berbeda, jadi jika keduanya diinginkan, berikan masing-masing kapabilitasnya sendiri alih-alih mem-bind satu kapabilitas dua kali.

An importer is attached by more than one plugins.importer entry (Sebuah importer dipasang oleh lebih dari satu entri plugins.importer)

Entri plugins.importer memasang importer yang dinamai oleh uri-nya: jika importer tersebut mengiklankan format yang diminta suatu impor, entri tersebut menentukan versi importer mana yang dijalankan dan menyerahkan with.sources dan with.settings milik entri kepadanya. Satu entri melakukan hal itu untuk satu importer, sehingga entri kedua yang menamai importer yang sama — identitas yang sama, pada versi yang sama atau versi lain — tidak akan dibaca oleh apa pun, dan with-nya tidak akan mencapai importer mana pun tanpa pemberitahuan. Sebagai gantinya, konfigurasi ditolak saat dimuat, perintah apa pun yang membacanya.

Konfigurasi workspace disusun dari beberapa file — file global, setiap .aggrega-config.yaml dari root proyek hingga direktori tempat perintah dijalankan, pendamping importer_append yang dapat dibawa masing-masing, dan .aggrega-config-append-ci.yaml milik pipeline — sehingga entri kedua sering kali ditulis di file yang berbeda dari entri pertama. Pesan tersebut menyebutkan importer dan kedua entri, yang lebih awal terlebih dahulu, masing-masing berdasarkan kunci dan posisi tempatnya ditulis, file tempatnya ditulis, dan uri-nya sebagaimana ditulis di sana.

Hanya daftar importer yang diperiksa: daftar governance dan linter menerima satu plugin yang dipasang lebih dari sekali, dengan setiap pemasangan membawa with-nya sendiri. Entri yang uri-nya berupa path sistem file tidak menamai importer, sehingga tidak dibandingkan.

Pesan yang diemisikan:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (importer dipasang oleh entri di file dan sekali lagi oleh entri di file; pertahankan tepat satu entri plugins.importer per importer, dengan uri yang menamai versi yang Anda inginkan: importer dipasang oleh lebih dari satu entri plugins.importer)

Cara memperbaiki: pertahankan satu entri untuk importer yang disebutkan pesan — entri yang uri-nya menamai versi yang Anda inginkan, dengan membawa with yang ingin Anda serahkan ke importer tersebut — dan hapus yang lain. Jika keduanya berada di file yang berbeda, file yang Anda kendalikan adalah yang perlu disunting: menghapus entri Anda berarti mengadopsi entri file lain, dan mempertahankan entri Anda berarti entri file lain yang harus dihapus.

A provider binding names a capability containing a colon (Binding provider menamai kapabilitas yang mengandung titik dua)

capability: milik Recipe dibaca sebagai nama kapabilitas hingga titik dua terakhirnya dan pin versi setelahnya — helm:1.0.0 meminta kapabilitas helm pada versi 1.0.0. Entri plugins.providers dicari berdasarkan nama tersebut, sehingga kapabilitas yang dinamai binding tidak pernah mengandung titik dua, dan entri yang kapabilitasnya mengandung titik dua tidak akan pernah dapat dicapai oleh Recipe mana pun. Alih-alih membiarkannya berada di konfigurasi tanpa dibaca, konfigurasi ditolak saat dimuat, perintah apa pun yang membacanya.

Hanya daftar provider yang diperiksa. Daftar importer menggunakan bentuk entri yang sama, tetapi plugin-nya dipasang melalui uri: dan menamai formatnya import:<format>, dengan titik dua sebagai bagian dari nama. uri: milik binding tetap boleh diakhiri dengan :<version>; bagian itu bukan yang dibaca oleh aturan ini.

Pesan yang dikeluarkan, yang menyebutkan kapabilitasnya:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (binding socket provider untuk kapabilitas: referensi kapabilitas milik Recipe dibaca sebagai kapabilitas hingga titik dua terakhirnya dan pin versi setelahnya, sehingga kapabilitas yang dinamai binding tidak mengandung titik dua; bind nama kapabilitasnya saja dan biarkan setiap Recipe mem-pin versi yang dibutuhkannya: binding socket provider menamai kapabilitas yang mengandung titik dua, yang tidak dapat dipilih oleh Recipe mana pun)

Cara memperbaiki: tulis nama kapabilitasnya saja di entri — capability: helm — dan pin versi di tempat yang semestinya: Recipe mem-pin versi provider yang dibutuhkannya di capability: miliknya sendiri, dan binding yang perlu memilih versi tertentu dari plugin-nya menuliskannya pada identitas plugin, uri: provider/helm:1.0.0.

A governance attachment declares no role, or one that is not a known role (Lampiran governance tidak mendeklarasikan peran, atau mendeklarasikan peran yang tidak dikenal)

Lampiran governance membawa sebuah peran, dan peran itulah — bukan jenis yang dideklarasikan oleh plugin itu sendiri — yang menentukan di mana lampiran dijalankan dan apa yang boleh dilakukannya: apakah lampiran menerima atau menolak build, dan apakah lampiran membaca graf atau artefak yang telah dirender. Lampiran didistribusikan dengan membaca peran tersebut, sehingga lampiran yang tidak membawa peran, atau membawa peran yang tidak dikenali siapa pun, tidak akan terpasang ke apa pun dan akan dilewati tanpa pemberitahuan.

Keheningan itulah yang dicegah oleh penolakan ini. Plugin governance yang dikonfigurasi tetapi tidak pernah dikonsultasikan menghasilkan keluaran yang persis sama dengan build yang tidak pernah diatur, dan tidak ada apa pun dalam hasilnya yang menunjukkan mana yang sedang Anda pegang.

Pesan yang dikeluarkan, keduanya menyebutkan lampiran dan mencantumkan peran yang ada. Peran yang tidak ada:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (lampiran governance tidak mendeklarasikan peran; atur ke salah satu peran yang dikenal: lampiran governance tidak mendeklarasikan peran atau mendeklarasikan peran yang tidak dikenal)

dan peran yang tidak dikenali:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (lampiran governance mendeklarasikan peran yang tidak dikenal; gunakan salah satu peran yang dikenal: lampiran governance tidak mendeklarasikan peran atau mendeklarasikan peran yang tidak dikenal)

Cara memperbaiki: atur role: pada lampiran di bawah plugins.governance ke salah satu peran yang dicantumkan pesan. Peran mana yang dipilih adalah keputusan tentang apa yang Anda ingin plugin lakukan, bukan tentang plugin itu sendiri: peran yang menerima atau menolak membaca build dan mengembalikan putusan, sedangkan peran yang mentransformasi adalah instruksi eksplisit untuk mengizinkan plugin mengubah apa yang diberikan kepadanya. Pesan mencantumkan seluruh himpunan peran, sehingga ejaan yang harus digunakan ada di dalam pesan itu sendiri.

A registry alias matches more than one host (Alias registry cocok dengan lebih dari satu host)

Sebuah registry dapat diberi alias pendek dalam konfigurasi workspace agar perintah dan referensi dapat menyebutnya tanpa menuliskan host-nya secara lengkap. Sebuah alias memilih tepat satu host. Kondisi ini dilaporkan ketika sebuah token cocok dengan alias dari dua entri registry: tidak ada jawaban mengenai host mana yang dimaksud, dan memilih salah satunya akan secara diam-diam mengirim artefak ke, atau mengambilnya dari, registry yang tidak disebutkan oleh penulis.

Pesan yang dikeluarkan, menyebutkan alias, berapa banyak entri yang mengklaimnya, dan host mana saja itu:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (alias registry cocok dengan sejumlah host; rujuk registry melalui host atau hapus alias duplikat: alias registry cocok dengan lebih dari satu host)

Cara memperbaiki: buka .aggrega-config.yaml dan berikan alias tersebut kepada salah satu host yang dicantumkan pesan, atau rujuk registry melalui host-nya dan hapus alias dari referensi. Pesan menyebutkan setiap host yang memegang alias tersebut, sehingga entri mana yang perlu diperiksa ada di dalam pesan. Jika entri-entri tersebut berasal dari lapisan konfigurasi yang berbeda, sunting lapisan yang Anda miliki.

The lockfile does not satisfy its schema (Lockfile tidak memenuhi skemanya)

Lockfile sebuah release mencatat hasil resolusi build: untuk setiap entitas, pustaka, dan plugin yang dijangkaunya, versi yang dipilih dan digest dari byte pada versi tersebut. Lockfile dibaca dan diperiksa terhadap skemanya sebelum diubah menjadi pin bertipe, sehingga dokumen yang tidak sesuai ditolak dengan jalur field tempat kegagalannya, alih-alih secara diam-diam menghasilkan pin yang berlubang.

Lockfile ditulis oleh mesin. Lockfile dihasilkan oleh pull yang meresolusi sebuah release, dan di-commit agar build yang sama diresolusi dengan cara yang sama di kemudian hari. Jadi kegagalan skema hampir selalu disebabkan oleh suntingan manual, merge yang meninggalkan dokumen dalam keadaan setengah teresolusi, atau lockfile yang ditulis untuk bentuk berkas yang lebih lama — misalnya lockfile yang entities-nya tidak membawa kind — bukan sesuatu yang ditulis dengan sengaja.

Lockfile yang tidak ada adalah kondisi yang berbeda dan dilaporkan secara berbeda — lockfile wajib ada, sehingga ketiadaannya dilaporkan di tempat build mencarinya, disertai instruksi untuk menjalankan pull yang membuatnya.

Pesan yang dikeluarkan, menyebutkan file, jalur field, dan keberatan dari skema itu sendiri:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: file gagal validasi skema)

Build, dan juga aggrega pull --verify, menambahkan perintah yang menulis ulang lockfile:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: berkas gagal dalam validasi skema; jalankan perintah tersebut untuk menulisnya ulang dari Release)

Dokumen yang sepenuhnya kosong dilaporkan secara terpisah, karena tidak ada field yang dapat disebutkan:

lockfile: <path>: document is empty (dokumen kosong)

Cara memperbaiki: jangan memperbaiki lockfile secara manual. Jalankan ulang pull untuk release tersebut, yang menulis ulang dokumen dari resolusi yang dilakukannya, lalu commit hasilnya — resolusi ulang itulah yang menghasilkan dokumen yang pin-nya sesuai dengan apa yang benar-benar dijangkau release. Jika kegagalan terjadi setelah merge, menyelesaikan konflik dengan melakukan pull ulang, bukan dengan menyunting, adalah cara untuk menghindari dokumen yang dapat di-parse tetapi mem-pin versi yang salah. Jalur field dalam pesan layak dibaca terlebih dahulu: jalur itu memberi tahu Anda apakah kerusakan ada pada satu entri atau pada bentuk dokumen secara keseluruhan.

Saat menyelesaikan katalog

Setelah pemuatan, kompiler menelusuri dua tingkat Manifest (peta tipe, lalu peta nama) untuk memilih Recipe bagi setiap Component, dan menelusuri setiap rantai extends pada Manifests, Components, atau Features. Rantai extends milik Release sendiri diikuti oleh penelusuran yang sama, satu langkah lebih awal: rantai itu diikuti saat Release diselesaikan, sebelum Manifest maupun Aggregate yang dinamainya dicari, sehingga kondisi di bawah ini dilaporkan terhadap Release, bukan terhadap penunjuk saudara yang akan disediakan oleh rantai tersebut.

Cyclic extends chain (Rantai extends siklis)

Sebuah rantai penunjuk extends berputar kembali ke dirinya sendiri. Setiap jenis yang mendeklarasikan extends — Component, Feature, Manifest, dan Release — ditelusuri oleh satu penelusuran rantai yang sama, sehingga sebuah putaran dilaporkan dengan kata-kata yang sama di mana pun putaran itu ditemukan.

Pesan yang dikeluarkan. Pesan dibuka dengan kalimat yang menamai kondisinya, lalu entitas tempat resolusi dimulai dan aturan yang menolaknya, kemudian sisi yang menutup putaran — entitas yang membawa extends: yang bermasalah dan referensi yang dideklarasikannya:

cyclic extends chain (<kind> <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (rantai extends siklis (aturan extends). Entitas tersebut meng-extends referensi yang sudah ada di dalam rantai; hapus extends pada entitas tersebut, atau arahkan ke entitas di luar rantai)

Entitas yang dinamai pertama dan entitas yang dinamai pada sisi tersebut biasanya berbeda, dan justru itulah intinya: sebuah putaran dilaporkan terhadap setiap entitas di dalamnya, sedangkan baris extends: yang perlu diedit adalah yang dinamai oleh sisi tersebut. Ikuti sisinya, bukan judulnya.

Untuk Manifest, <kind> berbunyi Manifest, setiap entitas dinamai dengan metadata.name-nya, dan <reference> adalah nilai extends: persis seperti yang ditulis — path relatif seperti ./base.yaml, atau metadata.name polos dari sebuah Manifest di samping Release. Bentuk mana pun yang Anda tulis tidak mengubah apa yang dilaporkan: tautan Manifest adalah file yang menjadi hasil resolusinya, sehingga dua file Manifest yang kebetulan mendeklarasikan satu metadata.name yang sama adalah dua tautan, dan rantai yang melewati keduanya bukan putaran.

Release dibaca dengan cara yang sama, dan poin identitas file lebih penting di sana karena bentuk yang dilindunginya lazim: <kind> berbunyi Release, <reference> adalah path relatif yang dinamai extends:, dan tautan Release adalah file yang menjadi hasil resolusinya. Dua file Release yang menamai sistem yang di-deploy alih-alih lingkungannya — keduanya metadata.name: shared-release, yang satu meng-extends yang lain — adalah dua tautan, dan rantai yang melewati keduanya bukan putaran.

Sebuah putaran dilaporkan sebagai putaran seberapa pun panjangnya. Penelusuran rantai menerapkan batas kedalamannya hanya pada rantai yang berakhir, sehingga siklus yang mencakup lebih banyak entitas daripada yang diizinkan batas tersebut tetap dilaporkan di sini, bukan sebagai rantai yang terlalu dalam — solusi untuk putaran tidak pernah dengan memperpendeknya.

Cara memperbaiki: buka entitas yang dinamai oleh sisi tersebut, lalu hapus extends:-nya atau arahkan ke entitas yang belum ada di dalam rantai. Jika beberapa tingkat dimaksudkan untuk berbagi konten, menggabungkan konten yang terduplikasi ke dalam satu entitas dasar akan menghilangkan putaran sekaligus duplikasinya.

Recipe implements does not match the mapped component type (Recipe implements tidak cocok dengan tipe komponen yang dipetakan)

Entri pemetaan Manifest menunjuk ke sebuah Recipe yang deklarasi spec.implements:-nya tidak cocok dengan kunci tipe komponen untuk entri pemetaan tersebut. spec.implements adalah jangkar konsistensi, bukan mekanisme dispatch: nilai pemetaan menamai Recipe secara langsung, dan pemeriksaan ini memastikan bahwa Recipe yang dinamai penulis adalah Recipe yang mendeklarasikan tipe yang mereka petakan.

Pemeriksaan ini membaca Manifest yang telah disusun sebelum Recipe apa pun diselesaikan, sehingga yang dilaporkan adalah entri pemetaan yang ditulis penulis, bukan gejala lanjutannya.

Pesan yang diemisikan:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (spec.implements recipe pada entri pemetaan manifest tidak cocok dengan kunci tipe komponen / tipe fitur yang dipetakan (pemetaan manifest, spec.implements recipe, yang diharapkan, atau tipe yang di-extends-nya))

Setiap perintah yang membaca dependensi Release melakukan pemeriksaan ini; yang berbeda adalah apa yang dilakukan masing-masing terhadap hasilnya. aggrega build dan aggrega pull berhenti, karena keduanya menghasilkan sesuatu yang akan Anda gunakan selanjutnya — artefak hasil render dan lockfile. aggrega validate dan aggrega lint melaporkan temuan tersebut bersama setiap diagnostik lain yang ditemukan, lalu keluar dengan kode bukan nol: tugasnya adalah memberi tahu Anda semua yang salah pada workspace, sehingga satu kesalahan tidak memotong laporan. Di editor, temuan diterbitkan sebagai diagnostik di samping yang lain, dan apa pun yang harus dilaporkan dokumen tersebut tidak terpengaruh. Perhatikan di mana temuan muncul: editor menerbitkan temuan pada Manifest tempat pemetaan ditulis, pada kunci entri pemetaan yang disebutkannya, dan bukan pada Aggregate — pada baris pertama Manifest jika teks yang terbuka tidak menuliskan entri tersebut, seperti untuk entri yang diwarisinya melalui extends. Temuan tingkat dependensi Release lainnya, yang tidak menyebut dokumen apa pun di workspace Anda, tetap berada pada Aggregate. Menjalankan aggrega validate melaporkannya dokumen mana pun yang sedang Anda buka.

Entri pemetaan yang menamai Recipe yang tidak dimiliki katalog bukanlah kondisi ini: pemeriksaan tidak memiliki apa pun untuk dibandingkan dan melewati entri tersebut, dan Recipe yang tidak dapat diselesaikan dilaporkan saat recipe diselesaikan.

Entri FeatureRecipe mengikuti bentuk yang sama; pemeriksaan pemetaan features.type mengeluarkan manifest feature mapping ... featurerecipe spec.implements is ... (expected ...), dan cabang fitur mencocokkan pada kunci pemetaan itu sendiri, sehingga tidak menamai alternatif extends.

Kunci components.type juga dinilai per instans setiap kali kunci itu mencapai instans dari versi lain. Kunci yang tidak menyebut tipe persis sebuah instans mencapainya melalui basis tipe tersebut, ketika tidak ada kunci yang menyebut tipe persis itu dan tidak ada kunci lain yang ditulis untuk basis yang sama — sehingga kunci yang ditulis tanpa versi, atau kunci yang menyebut versi lain, dapat mencapainya. Karena itu entri saja tidak dapat menyatakan apakah Recipe-nya cocok, sehingga build menilai Recipe itu lagi untuk setiap instans komponen yang dicapai kunci dengan cara tersebut, dengan tipe instans itu sendiri pada versi yang dikompilasi build menggantikan posisi kunci: versi yang disebut instans, atau, untuk instans yang tidak menyebut versi, versi tertinggi Component tersebut yang dimiliki katalog. Instans yang versinya tidak dipenuhi spec.implements: milik Recipe — secara persis, melalui rentang caret, karena tanpa versi, atau melalui basis yang di-extends oleh tipe instans — memunculkan kondisi ini, yang dilaporkan pada path .spec.components.<instance> instans alih-alih pada file Manifest:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (spec.implements milik recipe pada entri pemetaan Manifest tidak cocok dengan kunci tipe komponen atau tipe fitur yang dipetakan (Manifest; tipe instans dan versi kompilasinya, kunci pemetaan yang mencapainya, recipe yang dipetakan dan spec.implements-nya). petakan tipe ini pada versi ini ke recipe yang mengimplementasikannya, dengan kunci pemetaan yang menyebut versinya)

Nilai compiled as hanya muncul untuk instans yang tipenya tidak menyebut versi; instans yang menyebut versi menampilkan versinya di of type. Kunci yang menyebut versi instans itu sendiri tidak memerlukan penilaian kedua, karena pemeriksaan atas entri sudah menanyakannya, dan entri yang sudah ditolak karena kuncinya dilaporkan sekali, seperti di atas, bukan sekali lagi untuk setiap instans. aggrega build dan aggrega pull berhenti karenanya, dan aggrega validate --release melaporkannya lalu keluar dengan kode bukan nol. aggrega lint menilai entri pemetaan Manifest, bukan instans yang dicapainya, sehingga tidak melaporkannya.

Cara memperbaiki: perbaiki deklarasi spec.implements: pada Recipe agar cocok dengan kunci tipe komponen Manifest, atau ubah entri Manifest agar menunjuk ke Recipe yang spec.implements:-nya cocok dengan kunci tipe komponen. Untuk instans yang dicapai sebuah kunci pada versi lain, tambahkan kunci pemetaan yang menyebut versi instans, dipetakan ke Recipe yang mengimplementasikannya, atau arahkan kunci yang mencapainya ke Recipe semacam itu.

Manifest mapping value is not a shape a recipe reference accepts (Nilai pemetaan Manifest bukan bentuk yang diterima referensi recipe)

Nilai pemetaan Manifest menamai Recipe atau FeatureRecipe dalam bentuk yang tidak dapat diungkapkan oleh tata bahasa referensi. Referensi recipe menerima nama polos, nama dengan versi, nama berkualifikasi kapabilitas, atau nama berkualifikasi kapabilitas dengan versi — paling banyak satu /. Nilai yang membawa lebih dari itu (path bergaya tipe komponen seperti core/helm/eso-aws-fetcher:1.0.0) tidak akan pernah dapat menamai entitas katalog, apa pun isi katalognya.

Bentuknya dinilai saat Manifest disusun, sebelum apa pun dicari — putusan berasal dari penghitungan pemisah dalam sebuah string, sehingga sama sekali tidak memerlukan katalog. Menilainya di sana membuat diagnostiknya jujur: recipe yang dimaksud oleh nilai tersebut sering kali ada dan dinamai dengan benar, dan diberi tahu bahwa recipe itu tidak ada akan membuat Anda mencari hal yang salah. Setiap perintah yang menyelesaikan dependensi Release melaporkannya dengan cara yang sama, sehingga tidak bergantung pada perintah mana yang kebetulan Anda jalankan.

Pesan yang diemisikan:

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (referensi recipe salah bentuk dalam nilai pemetaan Manifest: kunci dipetakan ke sebuah nilai yang membawa sejumlah segmen yang dipisahkan garis miring; referensi recipe menerima nama, nama:versi, kapabilitas/nama, atau kapabilitas/nama:versi; perbaiki nilai pemetaan di Manifest)

Bagian features menghasilkan pesan yang sama terhadap koordinatnya sendiri, dan referensi feature recipe dinamai sebagaimana mestinya.

Nilai yang segmen capability-nya membawa pin versi — compose:1.2.3/svc:1.0.0 — ditolak dengan cara yang sama, sebelum apa pun dicari, sehingga tidak ada yang diambil dari registry. Pin berada pada capability yang dideklarasikan Recipe, tempat pin itu memilih versi plugin mana yang melayani capability tersebut untuk merendernya; referensi menyebut Recipe berdasarkan capability polosnya (compose/svc:1.0.0).

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (referensi recipe salah bentuk dalam nilai pemetaan Manifest: nilai kunci ini membawa pin versi di segmen capability-nya; pin berada pada capability yang dideklarasikan recipe, dan referensi recipe menyebut recipe berdasarkan capability polosnya; perbaiki nilai pemetaan di Manifest)

Cara memperbaiki: perpendek nilai pemetaan ke bentuk yang diterima tata bahasa. Sebuah recipe diidentifikasi oleh metadata.name-nya sendiri — opsional diawali dengan spec.capability-nya dan diakhiri dengan versinya — tidak pernah oleh path tipe komponen yang diimplementasikannya. Kunci pemetaan adalah tipe komponen; nilai pemetaan adalah recipe.

Jangan disamakan dengan nilai berbentuk benar yang menamai recipe yang tidak dimiliki katalog: itu adalah entitas yang memang tidak ada dan tetap dilaporkan sebagai demikian, dengan menamai URI dan entri pemetaan yang mereferensikannya.

Beberapa Recipes mengimplementasikan satu tipe Component

Dua Recipes atau lebih mendeklarasikan tipe Component yang sama di bawah spec.implements: — dua Recipes versi-eksak untuk satu tipe, atau Recipe tanpa versi di samping Recipe yang dipin.

Kondisi ini tidak memunculkan halt sendiri, dan bukan ambiguitas yang harus diselesaikan oleh build. Pemilihan Recipe hanya berdasarkan pemetaan: tidak ada yang membaca spec.implements: lalu memilih di antara kandidat, sehingga berapa pun Recipes yang mengimplementasikan suatu tipe, Recipe yang merender sebuah instans adalah Recipe yang dipetakan oleh Manifest. spec.implements: dibaca sebagai jangkar konsistensi — untuk memastikan Recipe yang dipetakan penulis adalah Recipe yang mendeklarasikan tipe tempat penulis memetakannya — dan sebagai sumber kandidat pin yang disarankan oleh sebuah halt. Ia tidak pernah memilih.

Yang Anda temui adalah halt untuk instans yang tidak dipetakan ke apa pun oleh Manifest, dan halt itu mencantumkan setiap Recipe yang mengimplementasikan tipe tersebut agar Anda dapat mem-pin salah satunya — lihat “No Recipe is mapped for a component or feature instance (Tidak ada Recipe yang dipetakan untuk instans komponen atau fitur)” di bawah. Halt ini dilaporkan dengan cara yang sama baik satu Recipe maupun lima yang mengimplementasikan tipe tersebut, karena itulah tidak ada kondisi ambiguitas terpisah untuk dicari.

Cara memperbaiki: tambahkan pemetaannya. Entri berkunci tipe merutekan setiap instans dari tipe tersebut; entri berkunci nama merutekan satu instans bernama dan dibaca lebih dulu, sehingga entri ini juga merupakan cara memberikan Recipe yang berbeda kepada satu instans dari saudara-saudaranya.

Divergent Release (extends + aggregate pointer) (Release divergen: extends + penunjuk aggregate)

Sebuah Release menggunakan extends: untuk mewarisi dari Release dasar tetapi juga mendeklarasikan penunjuk aggregate: miliknya sendiri. JSON Schema Release menolak bentuk ini pada validasi skema (Layer 1, pemeriksaan envelope) melalui batasan allOf: jika extends: ada, aggregate: dilarang; jika extends: tidak ada, aggregate: dan manifest: keduanya wajib.

Kondisi ini berhenti sebagai pelanggaran envelope biasa, sehingga diagnostiknya mengambil bentuk kelas tersebut — lihat “The document-envelope failure class” di error-translation.md — dan temuannya menunjuk ke kunci yang tidak diizinkan di sini:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (validasi envelope dokumen gagal (Release, di path); baris:kolom: spec.aggregate: nilai cocok dengan bentuk yang tidak diizinkan di sini. perbaiki dokumen agar sesuai dengan skema kind-nya)

Cara memperbaiki: hapus field aggregate: dari Release anak. Pewarisan sengaja memaksa anak untuk men-deploy Developer Intent yang sama dengan induknya; jika Anda perlu men-deploy Aggregate yang berbeda, tulis Release baru tanpa extends:.

A feature attached by both the Aggregate and the Release cannot be merged (Fitur yang dilampirkan oleh Aggregate sekaligus Release tidak dapat digabungkan)

Ketika Manifest lokal melakukan extends terhadap Manifest dasar, kedua tingkat (peta type:, peta name:) digabungkan secara independen. Di dalam setiap tingkat, kunci anak menimpa kunci induk pada tingkat teratas — ini adalah penggantian dangkal, bukan penggabungan mendalam. Entri anak untuk suatu kunci sepenuhnya menggantikan entri induk untuk kunci tersebut.

Ketika nama instans fitur yang sama muncul di sisi Aggregate dan sisi Release dengan state yang bertentangan dan tidak dapat digabungkan (di luar pelapisan infra yang diizinkan), compiler berhenti dan menempatkan diagnostik pada attachment yang tidak dapat direkonsiliasinya. Kedua deklarasi yang bertentangan mengikuti urutan tetap — tipe yang dideklarasikan Aggregate lebih dulu, lalu tipe yang dideklarasikan Release — sehingga Anda dapat mengetahui dokumen mana yang menyatakan apa tanpa membuka keduanya.

Pesan yang diemisikan:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (konflik penggabungan fitur: rekonsiliasikan deklarasi Aggregate dan Release untuk fitur tersebut (tipe yang dideklarasikan Aggregate, tipe yang dideklarasikan Release))

Hal yang sama berlaku untuk attachment yang dibawa oleh sebuah koneksi. Ketika entri koneksi Aggregate dan entri Release untuk koneksi yang sama sama-sama menulis attachment di bawah satu slot dan menyebut Features yang berbeda, build berhenti pada entri Release — tempat tipe kedua ditulis — setelah komposisi diratakan, dengan menyebut kedua tipe, slot, koneksi, socket, dan komponennya:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (konflik penggabungan fitur: rekonsiliasikan deklarasi Aggregate dan Release untuk fitur tersebut (Release, di path, Aggregate menyebut satu tipe, Release menyebut tipe lain, untuk slot, pada koneksi, melalui socket, dari komponen). Hapus tipe dari entri Release agar entri itu mengatur ukuran attachment yang dideklarasikan Aggregate, atau sebut Feature yang sama di kedua dokumen.)

Cara memperbaiki: rekonsiliasikan kedua deklarasi. Deklarasi sisi Aggregate dan sisi Release dari instans fitur yang sama digabungkan per pilar — Aggregate menyumbang values, Release menyumbang infra. Jika kedua sisi menentukan field non-pilar yang sama (seperti type:), nilainya harus sama; perbaiki satu sisi agar sesuai dengan sisi lainnya, atau hapus deklarasi yang berlebihan.

Annotation binding does not resolve against its target Feature (Binding anotasi tidak dapat di-resolve terhadap Feature targetnya)

Field feature: dari binding anotasi Manifest menyebut Feature yang tidak dimuat oleh katalog, atau daftar maps.infra / maps.values binding tersebut mendeklarasikan path bertitik yang sebenarnya tidak dimiliki oleh spec.schema Feature yang disebut. Salah satu kondisi tersebut menghentikan pemuatan workspace — binding akan menyintesis attachment Feature yang merutekan nilai ke path yang tidak dapat di-resolve oleh runtime.

Satu kondisi mencakup tiga cara rute binding gagal di-resolve, dan diagnostiknya menyebut cara mana yang terjadi:

  • Feature tidak ditemukan. Nilai feature: mereferensikan URI Feature yang tidak ada di katalog yang dimuat.
  • Skema Feature tidak dapat di-resolve. Feature yang disebut berhasil dimuat, tetapi spec.schema:-nya tidak dapat di-resolve menjadi representasi JSON Schema 2020-12 — kontennya rusak, atau menyebut referensi lintas dokumen yang tidak dapat diikuti. Varian ini membawa diagnostik kegagalan resolusi itu sendiri di belakangnya, sehingga alasan skema tidak dapat di-resolve dapat dibaca dari halt yang sama.
  • Path binding tidak ada di skema target. Entri maps.infra atau maps.values binding menyebut path bertitik yang tidak dideklarasikan oleh spec.schema.<pillar>.<path> Feature tersebut.

Pesan yang dikeluarkan (varian Feature-tidak-ditemukan):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (binding anotasi tidak dapat di-resolve terhadap Feature targetnya (Manifest, di path, kunci merutekan ke Feature yang tidak dimiliki katalog build ini; perbaiki atau publikasikan Feature yang disebut di bawah feature))

Pesan yang dikeluarkan (varian skema-tidak-dapat-di-resolve):

annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (binding anotasi tidak dapat di-resolve terhadap Feature targetnya (Manifest, binding anotasi merutekan ke Feature yang skema deklarasinya tidak dapat di-resolve))

Varian ini menyebut Feature dan kegagalan resolusinya, dan tidak membawa kunci binding maupun posisi sumber — kesalahannya ada pada spec.schema: milik Feature itu sendiri, yang hanya disebut oleh binding. Temukan binding yang bermasalah dengan mencari URI Feature yang dikutip pesan di mappings.features.annotations.

Pesan yang dikeluarkan (varian path-tidak-ditemukan):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (binding anotasi tidak dapat di-resolve terhadap Feature targetnya (Manifest, di path, kunci merutekan ke Feature, pada pilar dan path yang propertinya tidak dideklarasikan Feature tersebut di bawah schema))

Cara memperbaiki: pastikan URI feature: binding ada di katalog dan cocok dengan URI peka huruf besar-kecil yang di-implements: oleh sebuah Recipe. Jika varian path-tidak-ditemukan muncul pada path yang memang dideklarasikan skema Feature, periksa ejaan path bertitik (peka huruf besar-kecil) dan nama pilar (infra vs values).

A bound annotation value does not conform to the target Feature’s schema (Nilai anotasi yang terikat tidak sesuai dengan skema Feature target)

Anotasi yang Anda tulis merutekan sebuah nilai, melalui binding, ke sebuah path pada Feature target — dan nilai tersebut tidak memenuhi sub-skema yang dideklarasikan Feature pada path itu, atau Feature sama sekali tidak mendeklarasikan properti di sana. Kondisi ini dibaca atas nilai, bukan atas binding, sehingga terpisah dari halt target binding di atas: halt tersebut menolak apa yang dideklarasikan Manifest, sedangkan halt ini menolak apa yang ditulis melaluinya.

Validasi penuh pada path yang ditemukan; soft-skip hanya ketika path tidak dapat ditemukan. Setelah sub-skema subkey yang terikat ditemukan, nilai divalidasi terhadap kumpulan batasan JSON Schema 2020-12 yang lengkap pada path tersebut (tipe, enum, pattern, rentang numerik, bentuk object/array bersarang) — $ref / allOf / oneOf terminal di-resolve terhadap definisi skema dan divalidasi, tidak dilewati. Disiplin soft-skip hanya berlaku untuk navigasi: ketika penelusur menemui jalan keluar ($ref, patternProperties, oneOf/anyOf/allOf, atau additionalProperties yang berisi skema) pada segmen perantara — sebelum mencapai leaf yang terikat — path tidak dapat di-resolve secara statis, sehingga validator melanjutkan tanpa memunculkan error daripada berisiko menghasilkan halt yang keliru; runtime tetap menjadi permukaan validasi untuk binding tersebut.

Pesan yang dikeluarkan (varian kesesuaian nilai):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (subkey anotasi tidak sesuai dengan skema Feature target pada pilar yang dirutekan: nilai subkey anotasi tidak sesuai dengan Feature spec.schema: kegagalan batasan)

Pesan yang dikeluarkan (varian subkey tidak dideklarasikan):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (subkey anotasi tidak sesuai dengan skema Feature target pada pilar yang dirutekan: subkey anotasi tidak dideklarasikan pada Feature spec.schema)

Penghentian ini dimunculkan atas anotasi sebagaimana ditulis, sebelum diekspansi menjadi lampiran Feature, sehingga diagnostik menyebut dokumen dan cakupan tempat nilai ditulis — boundary dan komponen untuk anotasi sisi Release, path komponen untuk anotasi sisi Aggregate — serta kunci anotasi asalnya.

Anotasi yang disuntikkan plugin tata kelola dinilai dengan cara yang sama, dan diagnostik menyatakan siapa yang menulisnya. Plugin yang dilampirkan untuk menyuntikkan anotasi menetapkan nilainya pada komponen Release, sehingga nilai itu diperiksa persis seperti nilai yang ditulis operator di sana — tetapi baris Release yang ditunjuk diagnostik adalah baris yang tidak ditulis siapa pun. Karena itu diagnostik menambahkan plugin mana yang menyuntikkan nilai tersebut dan peran tata kelola tempat plugin itu dilampirkan, dan perbaikannya ada pada keputusan plugin tersebut, bukan pada Release.

Cara memperbaiki: koreksi nilai yang terikat agar memenuhi sub-skema yang dideklarasikan, atau perluas skema properti tersebut jika nilainya sah. Varian subkey tidak dideklarasikan biasanya sudah didahului oleh halt target binding di atas; mencapainya berarti binding mendeklarasikan path tersebut sementara skema Feature tidak memuatnya, jadi koreksi mana pun dari keduanya yang salah. Ketika operator komposisi perantara membuat path tidak dapat di-resolve dan runtime kemudian menolaknya, persempit skema agar properti muncul langsung pada path binding.

An annotation subkey is not routed by its binding (Subkunci anotasi tidak dirutekan oleh binding-nya)

Anotasi yang Anda tulis membawa subkunci di bawah kunci yang diklaim oleh binding anotasi Manifest, dan salah satu subkunci tersebut adalah nama yang tidak dirutekan binding: nama itu tidak tercantum di maps.infra maupun di maps.values. Setiap subkunci dirutekan secara terpisah, ke path Feature yang dideklarasikan binding untuknya, sehingga subkunci yang tidak disebut binding tidak punya tujuan. Mengekspansi anotasi tanpanya akan membuat nilai yang Anda tulis tertinggal dari build tanpa pemberitahuan apa pun, dan penyebab umumnya adalah salah ketik subkunci — sehingga build berhenti, dengan menyebut subkunci tersebut, kunci anotasi tempat subkunci itu ditulis, dan setiap subkunci yang memang dirutekan binding.

Penghentian ini dimunculkan atas anotasi sebagaimana ditulis, sebelum diekspansi menjadi lampiran Feature, seperti dua kondisi di sebelahnya: “A bound annotation value does not conform to the target Feature’s schema (Nilai anotasi yang terikat tidak sesuai dengan skema Feature target)” di atas menolak subkunci yang dirutekan binding ketika Feature menolak nilainya, dan “An annotation routes through a pillar its authoring side may not use (Anotasi dirutekan melalui pilar yang tidak boleh digunakan sisi penulisnya)” di bawah menolak subkunci yang dirutekan melalui pilar yang salah. Kunci yang tidak diklaim binding mana pun bukan kondisi ini: tidak ada yang merutekannya, dan build melewatinya.

Pesan yang dikeluarkan, menyebut dokumen dan tempat anotasi ditulis, subkunci, kunci anotasi, dan subkunci yang dirutekan binding:

annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (subkunci anotasi tidak dirutekan oleh binding anotasi tersebut (Release; subkunci ditulis di bawah anotasi ini, tetapi binding-nya hanya merutekan subkunci yang tercantum))

Anotasi yang ditulis di Aggregate disebut dengan cara yang sama, di tempat anotasi itu ditulis di sana — (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) untuk anotasi yang ditulis pada subsistem. Build melaporkan anotasi sisi Release di bawah tag OPS_ERROR dan anotasi sisi Aggregate di bawah tag DEVELOPER_ERROR, sesuai dokumen yang menulisnya.

Cara memperbaiki: bandingkan subkunci dengan subkunci yang dicantumkan pesan. Jika itu salah ketik, perbaiki menjadi subkunci yang dirutekan binding. Jika nilai itu dimaksudkan untuk mencapai Feature, binding harus merutekannya: tambahkan path ke maps.infra atau maps.values milik binding di Manifest — path yang dideklarasikan skema Feature — atau hapus subkunci dari anotasi.

A bare annotation value does not route to exactly one path of its binding (Nilai anotasi polos tidak dirutekan ke tepat satu path dari binding-nya)

Anotasi yang Anda tulis sebagai nilai polos — feature.aggrega.ai/monitoring: "30s" alih-alih map subkunci — tidak menyebutkan subkunci, sehingga tidak ada apa pun di dalamnya yang menyatakan path Feature mana yang diisinya. Nilai itu ditempatkan pada satu-satunya path yang dideklarasikan binding, dengan menghitung maps.infra dan maps.values bersama-sama. Binding yang mendeklarasikan lebih dari satu path memberi nilai tersebut beberapa tempat tujuan tanpa apa pun untuk memilih di antaranya, sehingga build berhenti alih-alih memilih salah satunya. Penghitungan mencakup kedua daftar, sehingga binding yang merutekan satu path melalui infra dan path lain melalui values menolak nilai polos di dokumen mana pun nilai itu ditulis.

Penghentian dimunculkan atas anotasi sebagaimana ditulis, sebelum anotasi itu diekspansi menjadi lampiran Feature, sama seperti kondisi-kondisi di sampingnya, sehingga diagnostik menyebutkan dokumen dan tempat nilai itu ditulis. Pemeriksaan dilakukan sekali per anotasi yang Anda tulis: nilai yang ditulis pada boundary atau subsistem ditolak di sana, sekali, terlepas dari apakah ada komponen di dalamnya yang mengambilnya. Setiap nilai semacam itu dalam build dilaporkan, bukan hanya yang pertama. Build melaporkan anotasi di sisi Release dengan tag OPS_ERROR dan anotasi di sisi Aggregate dengan tag DEVELOPER_ERROR, mengikuti dokumen yang menulisnya. Kondisinya adalah a scalar annotation value does not route to exactly one path of its binding, yang dicetak oleh aggrega explain untuk kodenya.

Pesan yang dikeluarkan, menyebutkan dokumen dan tempat anotasi ditulis, kunci anotasi, nilainya, dan path yang dirutekan binding:

a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (nilai anotasi skalar tidak dirutekan ke tepat satu path dari binding-nya: kunci ini membawa nilai polos, sedangkan binding-nya merutekan beberapa path)

Nilai kosong tidak menulis apa pun, sehingga nilai itu ditempatkan di mana pun salah satu dari kedua daftar memuat satu path, dan ditolak hanya jika tidak satu pun dari keduanya memuatnya. Binding yang sama sekali tidak mendeklarasikan path ditolak ketika Manifest dimuat, karena skema Manifest mewajibkan satu path, sehingga build tidak mencapai kondisi ini melalui cara itu.

Anotasi yang disuntikkan oleh plugin tata kelola dinilai dengan cara yang sama, dan diagnostiknya menambahkan plugin mana yang menyuntikkan nilai tersebut serta peran tata kelola tempat plugin itu dilampirkan, sebagaimana kondisi-kondisi di sampingnya.

Cara memperbaiki: tulis anotasi sebagai map yang menyebutkan subkunci untuk setiap nilai — feature.aggrega.ai/monitoring: {interval: 30s} — sehingga setiap nilai dirutekan berdasarkan namanya sendiri; atau berikan nilai tunggal tersebut binding tersendiri, di bawah kunci anotasi lain, yang hanya mendeklarasikan path yang diisinya.

An annotation routes through a pillar its authoring side may not use (Anotasi dirutekan melalui pilar yang tidak boleh digunakan oleh sisi penulisnya)

Anotasi dipartisi menurut sisi penulisnya, dan partisi ini sama dengan yang mengatur setiap pilar tertulis lainnya: anotasi sisi Aggregate hanya boleh dirutekan melalui path binding yang menargetkan values, dan anotasi sisi Release hanya melalui path yang menargetkan infra. Pasangan lain mana pun menyebabkan halt.

Partisi inilah yang mencegah pintasan anotasi menjadi cara untuk menulis pilar milik sisi lain. Anotasi developer menyumbangkan values; anotasi operator menyumbangkan ukuran infra. Binding yang mendeklarasikan path di kedua pilar bukanlah error dengan sendirinya — setiap sisi merutekan subset yang diizinkan baginya, dan path milik sisi lain memang tidak dapat dijangkau darinya.

Binding yang mendeklarasikan satu path di kedua daftar pilar adalah kasus yang paling sering mencapai halt ini. Aturan penentu routing mengirim path seperti itu melalui infra, sehingga path tersebut tidak dapat dijangkau dari sisi Aggregate, dan anotasi sisi Aggregate yang dirutekan ke sana akan berhenti di sini. Peringatan yang menyebutkan bentuk binding tersebut sebelum build mencapai halt ini dijelaskan di warnings.md.

Pesan yang diemisikan:

annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (anotasi dirutekan melalui pilar yang tidak boleh digunakan oleh sisi penulisnya: anotasi dirutekan melalui pilar pada path, tetapi anotasi sisi tersebut hanya boleh dirutekan melalui pilar yang diizinkan)

Anotasi yang disuntikkan plugin tata kelola berada pada komponen Release, sehingga merupakan anotasi sisi Release dan partisi yang sama berlaku padanya. Diagnostiknya menambahkan plugin mana yang menyuntikkannya dan peran tata kelola tempat plugin itu dilampirkan, karena kunci Release yang ditunjuknya adalah kunci yang tidak ditulis siapa pun.

Cara memperbaiki: rutekan anotasi dari sisi yang pilarnya menjadi target binding, atau tambahkan binding — di bawah kunci anotasinya sendiri — yang path-nya menargetkan pilar yang diizinkan bagi sisi penulis. Jika satu binding mendeklarasikan path yang sama di kedua daftar pilar, pisahkan menjadi dua binding agar setiap sisi memiliki path yang dapat dijangkaunya. Jika diagnostik menyebut plugin yang menyuntikkan, anotasi itu berasal dari keputusan plugin tersebut: perbaiki plugin itu, atau binding yang digunakannya untuk menyuntikkan.

Authored values or infra do not conform to the declared schema (Values atau infra yang ditulis tidak sesuai dengan skema yang dideklarasikan)

values: atau infra: hasil resolusi dari sebuah instance komponen — atau dari Feature yang dilampirkan — tidak sesuai dengan skema katalog yang dideklarasikan. Build memvalidasi setiap pilar terhadap skema yang dideklarasikannya sebelum rendering, sehingga kunci yang salah ketik, nilai dengan tipe yang salah, angka di luar rentang, atau field wajib yang hilang tertangkap di sumbernya alih-alih menghasilkan manifest yang rusak saat deploy.

Pemeriksaan ini mencakup batasan skema standar: nilai dengan tipe yang salah (string di tempat skema mendeklarasikan integer), nilai di luar rentang yang dideklarasikan atau enum, nilai yang gagal memenuhi pattern yang dideklarasikan, string yang bukan instance valid dari format yang dideklarasikannya — salah satu format bernama — dan field wajib yang tidak diberikan. Kegagalan format menyebutkan keyword dan memuat nilai, format, serta apa yang salah dengannya — seperti yang dicetak aggrega pull dan aggrega validate --release untuk field uri yang diberi ::::, "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:". Pemeriksaan ini memperhitungkan default: field yang diberi default: oleh skema dianggap telah diberikan meskipun dihilangkan, sehingga field wajib yang memiliki default tidak pernah memicu pemeriksaan “hilang”.

Pilar values adalah permukaan penulisan developer. Pilar ini divalidasi secara tertutup — properti yang tidak dideklarasikan skema ditolak sebagai kemungkinan salah ketik. Skema values yang tersusun di dalam dokumennya sendiri ($ref #/$defs lokal atau allOf) di-resolve dan divalidasi terhadap konteks definisi tersebut.

Pilar infra adalah permukaan pengukuran operator, dan pilar ini hanya diperiksa ketika Component mendeklarasikan pilar schema.infra — deklarasi itulah kontrak yang dipilih oleh komponen. Pilar ini divalidasi secara tertutup terhadap deklarasi tersebut dan tidak terhadap hal lain, persis seperti pilar values divalidasi terhadap schema.values: kunci yang tidak dideklarasikan Component ditolak sebagai salah ketik, dan kunci yang dideklarasikannya diberlakukan tipe dan rentangnya. Komponen yang ingin kunci berlapis provider seperti replicas divalidasi mendeklarasikan kunci tersebut di schema.infra miliknya sendiri; kosakata yang diterima sebuah provider dijangkau melalui valuesMapping pada Recipe-nya, bukan dilapiskan ke permukaan infra yang ditulis.

Pemeriksaan ini mengukur ukuran setiap komponen yang ditempatkan Release, dan entri yang sama sekali tidak menulis blok infra: juga diukur: blok yang tidak ada dianggap kosong, sehingga kunci required: yang tidak memiliki default: dilaporkan hilang — kasus yang memang hendak ditangkap oleh kunci seperti itu. Kedua cara menempatkan komponen dihitung. Menyebutkannya di bawah components sebuah boundary menempatkannya, demikian pula merutekan sub-modul yang menyumbangkannya di bawah aggregates; entri routing menempatkan komponen tanpa menyatakan apa pun tentang salah satunya, sehingga komponen yang ditempatkan dengan cara itu dimulai dari blok ukuran kosong dan kunci required: tanpa default pada tipenya dilaporkan hilang. Komponen yang tidak ditempatkan Release melalui kedua rute tersebut sama sekali tidak diukur terhadap kontrak ini. Komponen itu memiliki kesalahan lain, dan build melaporkan kesalahan tersebut sebagai gantinya: komponen yang tidak ditempatkan di boundary mana pun, dengan menyebutkan dua cara untuk menempatkannya.

Kontrak ini mengikat komponen di mana pun komponen itu ditulis: komponen yang disumbangkan sub-modul diukur persis seperti komponen yang dideklarasikan oleh Aggregate milik Release itu sendiri. Seberapa dalam sebuah komponen bersarang tidak mengubah batasan tipe mana yang berlaku.

Lampiran Feature divalidasi dengan cara yang sama, terhadap schema.values / schema.infra yang dideklarasikan oleh Feature yang dilampirkan. Lampiran berbagi satu permukaan, sehingga Feature kredensial — yang berlabel feature.aggrega.ai/kind: secret — diukur terhadap skema yang dideklarasikannya sendiri persis seperti lampiran lainnya. Nilai yang diperiksa adalah hasil gabungan efektif setelah nilai lampiran mengalir melintasi cakupan (komponen, subsistem, batas, dan khusus komponen) — sehingga nilai yang diperkenalkan secara sah pada satu cakupan tetapi ditimpa menjadi nilai yang tidak sah pada cakupan yang lebih spesifik akan terdeteksi pada hasil gabungan, bukan pada fragmennya. Lampiran yang tipenya tidak mendeklarasikan skema tidak divalidasi; infra lampiran divalidasi terhadap schema.infra milik lampiran itu sendiri (lampiran adalah overlay dan tidak membawa gabungan provider).

Temuan pada lampiran dilaporkan di dokumen yang menulis pilar yang gagal, di bawah nama dokumen tersebut, dan dicatat atas nama penulisnya. values miliknya dilaporkan di blok Aggregate yang menulisnya — entri features: milik komponen itu sendiri, .spec.components.<component>.features.<attachment>.values.<field>, lebih didahulukan daripada blok subsistem yang menjangkau komponen tersebut — sebagai kesalahan pengembang. infra miliknya dilaporkan di blok Release yang menulisnya — entri Release untuk komponen tersebut, di bawah batas yang menamainya, lebih didahulukan daripada blok features: milik batas itu sendiri — sebagai kesalahan operator. Pilar yang tidak ditulis oleh dokumen pemiliknya dilaporkan di tempat lampiran itu sendiri ditulis, yaitu tempat type-nya dinamai. Jadi, lampiran yang hanya dibuat oleh Release, yang tidak membawa values, melaporkan field yang diwajibkan oleh values Feature-nya di entri Release dan sebagai kesalahan operator, pada path yang dimiliki Release — entri komponen, atau blok features: milik batas untuk lampiran yang dibuat batas bagi setiap komponen di bawahnya:

[OPS_ERROR E0168] .spec.boundaries.main.components.app.features.check.values.schema
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))

Lampiran yang sama yang ditulis pada komponen di Aggregate melaporkan [DEVELOPER_ERROR E0168] di .spec.components.app.features.check.values.schema, di bawah nama Aggregate tersebut. Editor menampilkan masing-masing pada dokumen yang menulisnya, pada kunci terdalam dari path tersebut yang dimiliki dokumen itu.

Lampiran yang dibawa oleh sebuah koneksi diukur dengan cara yang sama, dan dilaporkan di entri koneksi dari dokumen yang menulis pilar yang gagal, bukan di blok features: milik komponen, yang tidak memuatnya. values miliknya dilaporkan di entri koneksi Aggregate, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> — di dokumen sub-modul itu sendiri, untuk komponen yang disumbangkan sub-modul — dan infra miliknya di entri Release untuk koneksi tersebut, di bawah batas yang menamai komponen tersebut bila Release menamai batas. Lampiran yang hanya dibuat oleh Release dilaporkan di entri Release untuk kedua pilar: lampiran semacam itu tidak membawa values, sehingga Feature yang values-nya mewajibkan sebuah field melaporkannya hilang di sana, pada entri yang ditulis operator.

Konfigurasi koneksi per-edge divalidasi dengan cara yang sama terhadap kontrak per-edge milik socket: values yang ditulis pengembang pada sebuah edge terhadap valueSchema milik socket, dan infra yang ditulis operator pada sebuah edge (dari Release) terhadap infraSchema milik socket. Socket yang tidak mendeklarasikan skema per-edge untuk suatu pilar tidak menerima konfigurasi tervalidasi untuk pilar tersebut (penghilangan = tidak ada kontrak, tidak ada yang diperiksa). Diagnostik menamai edge berdasarkan konsumen, socket, dan alias. Pada komponen yang dideklarasikan oleh Aggregate milik Release itu sendiri, infra operator diukur untuk setiap entri yang ditulis Release untuk salah satu koneksinya — termasuk entri yang tidak membawa infra, yang merupakan cara kunci required: tanpa default dilaporkan hilang — dan dilaporkan di entri tersebut dalam Release, di bawah batas yang menamai komponen tersebut bila Release menamai batas, yaitu tempat operator menyuntingnya; values pengembang dilaporkan di entri koneksi dalam Aggregate.

Leaf yang dideklarasikan sensitive: true disembunyikan kegagalan batasannya. Teks kegagalan mengutip nilai yang bermasalah, dan diagnostik build dibaca oleh siapa pun yang mengamati build, sehingga pada leaf yang dideklarasikan sensitif — atau di mana pun di dalam objek yang dideklarasikan sensitif — <constraint failure> di bawah terbaca <redacted> sebagai gantinya. Hal yang sama berlaku pada posisi yang memuat leaf yang dideklarasikan sensitif di bawahnya, termasuk pilar itu sendiri: $ref yang ditulis di samping kata kunci lain diperiksa secara utuh di tempat ia ditulis, sehingga kegagalan di dalam definisi yang dirujuknya dilaporkan pada posisi tersebut dan jika tidak demikian akan mengutip nilai leaf. Entitas, path field, pilar, dan nama kontrak tetap dinamai, sehingga diagnostik tetap memberi tahu Anda di mana kegagalan terjadi; hanya teks yang akan mereproduksi nilai tersebut yang dihilangkan. Sensitivitas dibaca per pilar, sehingga leaf dengan nama yang sama di values dan infra hanya disembunyikan pada pilar yang mendeklarasikannya.

Pesan yang diemisikan:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya: pilar values tidak sesuai dengan skema Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya: pilar infra tidak sesuai dengan skema Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya: pilar values tidak sesuai dengan skema Feature) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya: pilar values tidak sesuai dengan skema Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya: pilar values tidak sesuai dengan skema Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (pilar yang ditulis tidak sesuai dengan skema yang dideklarasikannya)

Cara memperbaiki: perbaiki nilai yang bermasalah agar memenuhi skema yang dideklarasikan, atau — jika nilai tersebut sah — perluas skema yang mendeklarasikannya (schema.values/schema.infra milik Component, atau milik Feature yang dilampirkan) untuk mendeklarasikannya. Periksa skema yang dideklarasikan sebuah Component dengan aggrega inspect <component-type> untuk melihat tipe, rentang, default, dan field wajib yang tepat yang diharapkan setiap pilar.

A declared schema contract cannot be read as a schema (Kontrak skema yang dideklarasikan tidak dapat dibaca sebagai skema)

Sebuah Component atau Feature mendeklarasikan kontrak skema yang tidak menghasilkan apa pun untuk dijadikan acuan validasi, sehingga konfigurasi yang dicakupnya diukur terhadap ketiadaan. Tiga kontrak dapat membawa kesalahan ini, masing-masing ditulis dalam field-nya sendiri: spec.schema milik entitas itu sendiri, dan dua kontrak per-edge yang dideklarasikan oleh socket dependensi — valueSchema untuk sisi developer dari sebuah koneksi dan infraSchema untuk sisi operator. Entri SchemaLibrary, yang dapat dirujuk oleh kontrak-kontrak tersebut, juga dapat membawa kesalahan ketiga di bawah ini; cara kasus tersebut dilaporkan dijelaskan lebih lanjut di bawah.

Tiga kesalahan mencapai penghentian ini, dan dua di antaranya mudah terlewat karena kontraknya tampak baik. Sebuah kontrak socket mungkin sama sekali gagal dikompilasi ke JSON Schema 2020-12 — kata kunci yang salah ketik adalah penyebab paling umum; spec.schema milik entitas itu sendiri yang tidak dapat dikompilasi justru dilaporkan di bawah kondisi compact form yang ditemui kompilasinya (E0120 untuk kata kunci yang tidak dikenal, E0116 untuk batasan yang tidak diterima oleh tipenya). Atau kontrak mungkin terkompilasi dengan bersih tetapi tetap tidak membangun validator: isinya dapat dibaca sebagai compact form tetapi bukan skema yang dapat dijadikan acuan validasi, misalnya skalar polos di tempat yang seharusnya berisi skema properti (items: nonsense). Atau kontrak mungkin terbentuk dengan baik dalam segala hal lain tetapi menyebut format di luar himpunan yang didukung — format: password, atau salah eja seperti format: emial — yang ditolak alih-alih dibaca sebagai batasan yang tidak memeriksa apa pun, baik ada maupun tidak ada nilai yang mencapai field tersebut; nama yang dapat diambil oleh format tercantum di bawah Format bernama. Ketiganya adalah satu kondisi, karena perbaikannya sama dan melewatkan salah satunya memiliki konsekuensi yang sama.

Tidak mendeklarasikan kontrak dan mendeklarasikan kontrak yang tidak dapat dibaca adalah dua situasi yang berbeda, dan build memperlakukannya secara berbeda. Field yang tidak mendeklarasikan apa pun dilewati: kesesuaian per-pillar dan per-edge bersifat opt-in, sehingga socket yang tidak membatasi pillar mana pun adalah penulisan biasa dan tidak memicu diagnostik. Field yang mendeklarasikan sesuatu yang tidak dapat dibaca ditolak. Melewatkannya akan membiarkan setiap payload yang dicakupnya tidak tervalidasi sementara build melaporkan keberhasilan — sebuah pemeriksaan yang telah berhenti berjalan tanpa ada yang memberi tahu bahwa ia berhenti. Jadi penolakan itulah yang memisahkan keduanya: diam berarti tidak ada yang perlu diperiksa, dan penghentian berarti ada sesuatu dan sesuatu itu tidak dapat dibaca.

Penolakan menyebut entitas yang mendeklarasikan kontrak, bukan dokumen yang menulis konfigurasi, karena di sanalah koreksi dilakukan. Penulis Aggregate yang menerima tipe komponen dengan kontrak yang tidak dapat dibaca tidak memiliki apa pun untuk diubah dalam berkasnya sendiri. Penolakan muncul saat katalog dibaca, ketika entitas yang mendeklarasikan, pillar, field yang ditulis, dan baris sumber semuanya diketahui — sehingga kesalahan yang sama dilaporkan secara identik baik Anda mencapainya dari build, dari aggrega validate, maupun dari alat build yang diekspos oleh aggrega mcp. Kontrak yang dibaca entitas melalui $import: — seluruh spec.schema miliknya, salah satu pillar-nya, atau kontrak sebuah socket — dilaporkan pada berkas yang diimpor: lokasinya menyebutkan berkas tersebut dan baris di dalamnya tempat fragmen ditulis, sementara pesannya tetap menyebutkan entitas dan field yang mendeklarasikan kontrak. Penghentian compact-form yang dialami spec.schema milik entitas itu sendiri dilokasikan dengan cara yang sama.

Entri SchemaLibrary yang menyebut format di luar himpunan yang didukung mencapai penghentian ini saat library-nya dibaca, dan penolakan menyebut library serta entrinya dan menunjuk ke entri tersebut dalam berkas library. aggrega validate atas seluruh katalog membaca setiap library, sehingga perintah ini melaporkan entri tersebut baik ada maupun tidak ada skema yang merujuknya, sedangkan Release yang resolusi dependensinya tidak pernah mencapai library tersebut tidak membacanya. Release yang skemanya memang mencapai entri tersebut melalui $ref: juga ditolak, tetapi penolakannya tidak menyebut format tersebut: aggrega pull melaporkan library sebagai tidak ditemukan di katalog (E0114), dan aggrega validate --release melaporkan target rujukan sebagai tidak ditemukan (E0121). Jalankan aggrega validate atas katalog untuk melihat entri dan nama yang bermasalah.

Pesan membawa kegagalan sebagaimana dilaporkan oleh alat yang menemukannya: untuk kegagalan kompilasi, kunci di dalam kontrak, baris sumber, dan kata kunci yang bermasalah; untuk isi yang tidak membangun validator, posisi yang ditolak oleh validator; untuk nama format di luar himpunan yang didukung, field, kata kunci format, nama sebagaimana ditulis, dan setiap nama yang didukung. $ref: lintas dokumen dalam kontrak socket yang entri SchemaLibrary-nya tidak berada dalam closure yang dimuat mencapai penghentian yang sama ketika aggrega validate memeriksa entitas atau Release; dalam spec.schema milik entitas itu sendiri, hal itu dilaporkan sebagaimana dijelaskan pada “A $ref: is not written in a form the compiler can resolve (Referensi tidak ditulis dalam bentuk yang dapat di-resolve compiler)” di atas. aggrega pull membaca kedua tempat itu untuk library yang dibutuhkan sebuah Release, sehingga library yang tidak ada di katalog menghentikan pull lebih awal, sebagaimana dijelaskan pada “A reference names no entity the catalog holds (Referensi menyebut entitas yang tidak dimuat katalog)” (E0114), dari tempat mana pun di antara keduanya ia direferensikan — dan library yang dimuat katalog disematkan dalam lockfile untuk keduanya.

Batasan yang terbentuk dengan baik di samping batasan yang tidak dapat dibaca tidak diberlakukan. Sebuah kontrak dibaca sebagai satu dokumen, sehingga satu fragmen yang tidak dapat dibaca menonaktifkan setiap batasan yang dideklarasikan bersamanya. Itulah sebabnya penghentian ini lebih berharga daripada batasan yang dikorbankannya: alternatifnya adalah kontrak yang tampak diberlakukan, terbaca sebagai diberlakukan, dan tidak memberlakukan apa pun.

Pesan yang dikeluarkan menyebut entitas beserta versinya dan field yang mendeklarasikan kontrak, lalu pillar yang dibatasi oleh kontrak tersebut, lalu kegagalannya — di sini kontrak socket yang membawa kata kunci salah ketik:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (kontrak skema yang dideklarasikan tidak dapat dikompilasi menjadi skema yang dapat digunakan, sehingga tidak ada yang divalidasi terhadapnya: koreksi kontrak di tempat ia dideklarasikan, atau hapus jika konfigurasi yang dicakupnya tidak memerlukan validasi. Component: valueSchema socket di spec.usesSchema mendeklarasikan skema yang tidak dapat dijadikan dasar validator, sehingga nilai yang dibatasinya tidak akan terukur: compactform pada kunci dan baris yang disebut (kata kunci yang disebut): kata kunci tidak dikenal)

dan nama format di luar himpunan yang didukung dalam pillar values sebuah Component:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (kontrak skema yang dideklarasikan tidak dapat dikompilasi menjadi skema yang dapat digunakan, sehingga tidak ada yang divalidasi terhadapnya: koreksi kontrak di tempat ia dideklarasikan, atau hapus jika konfigurasi yang dicakupnya tidak memerlukan validasi. Component: spec.schema.values mendeklarasikan skema yang tidak dapat dijadikan dasar validator, sehingga nilai yang dibatasinya tidak akan terukur: validator/jsonschema: resolusi skema gagal (di values., kata kunci, format tidak didukung; format yang didukung adalah email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Sebuah Feature disebut sebagai Feature "<name>:<version>", kontrak socket disebut dengan field-nya sendiri, seperti spec.usesSchema.<socket>.infraSchema, dan pillar disebut dengan pillar yang dibatasi oleh kontrak tersebut — values, infra atau provides. aggrega validate yang diberi file milik entitas itu sendiri menyebut entitas tanpa versinya. Entri SchemaLibrary disebut dengan library dan entrinya:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (kontrak skema yang dideklarasikan tidak dapat dikompilasi menjadi skema yang dapat digunakan, sehingga tidak ada yang divalidasi terhadapnya: koreksi kontrak di tempat ia dideklarasikan, atau hapus jika konfigurasi yang dicakupnya tidak memerlukan validasi. SchemaLibrary: skema menyebut format yang tidak dapat diperiksa validator mana pun, sehingga nilai yang dibatasinya tidak akan terukur: validator/jsonschema: resolusi skema gagal (di, kata kunci, format tidak didukung; format yang didukung adalah email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Cara memperbaiki: buka field yang disebut diagnostik dan koreksi fragmen pada kunci dan baris yang dilaporkan — paling sering kata kunci yang salah ketik, diperiksa terhadap kosakata kata kunci dalam vocabulary/compact-form-authoring.md, atau nilai yang ditulis di tempat yang seharusnya berisi skema bersarang. Jika kegagalan menyebut format yang tidak didukung, tulis salah satu format bernama atau hapus format:; field yang membawa materi rahasia mendeklarasikan sensitive: true sebagai gantinya, karena password bukan sebuah format. Untuk entri SchemaLibrary, koreksi dilakukan dalam berkas library yang disebut diagnostik. Jika kegagalan menyebut rujukan lintas dokumen, pastikan entri SchemaLibrary tersebut ada dan library-nya dapat dijangkau dari closure dependensi Release. Jika konfigurasi yang dicakup field tersebut memang tidak memerlukan validasi, hapus field tersebut alih-alih membiarkan kontrak yang tidak dapat dibaca oleh apa pun.

source: pada Recipe berupa string kosong

Sebuah Recipe mendeklarasikan source: "" — string kosong. source: pada Recipe memilih di antara dua mode penulisan: mode sourceless, yaitu tanpa artefak eksternal dan keluaran dihasilkan seluruhnya dari jenis masukan lain milik Recipe, dan mode sourced, yaitu ketika source: menyebut chart, modul, atau file eksternal yang menjadi sumber render. Menghilangkan field ini memilih mode pertama, nilai yang tidak kosong memilih mode kedua, dan string kosong tidak memilih keduanya — sehingga ini merupakan ambiguitas, bukan nilai yang bermakna. source: yang ditulis sebagai null sama dengan menghilangkannya.

Recipe ditolak alih-alih kompiler memilihkan salah satu dari dua pembacaan itu untuk Anda. Cara paling umum menulis source: kosong adalah menghapus URI dan membiarkan kuncinya: mode sourced yang dimaksud, dan menerima string kosong sebagai sourceless akan mengirimkan komponen tanpa artefak tanpa pernah menyebut pembacaan mana yang diambil.

Aturan ini diperiksa saat Recipe dimuat, dengan membaca nilai persis seperti yang Anda tulis, sehingga setiap perintah yang memuat Recipe menyebut kondisi ini sebelum apa pun mencoba menggunakan nilai kosong tersebut. aggrega validate atas file Recipe menolaknya; aggrega pull, sebuah build, aggrega validate --release, dan alat build yang disediakan aggrega mcp melaporkannya untuk Release yang menjangkau Recipe tersebut, sebelum referensi ke Recipe yang karenanya tidak lagi dapat di-resolve. Karena itu, pull menyebut kondisi ini alih-alih melaporkan referensi kosong sebagai referensi yang jenis source-nya tidak dapat ditentukannya. Aturan ini diperiksa sebelum aturan yang membaca apakah source dideklarasikan, sehingga Recipe yang source:-nya kosong diberi tahu tentang source: tersebut, bukan tentang valuesMapping yang tidak memiliki apa pun untuk ditimpakan atau tentang jenis masukan yang hilang.

Pesan yang dikeluarkan, diposisikan pada file Recipe tempat source: kosong ditulis dan pada kunci di dalamnya — .spec.source — bukan pada komponen yang mengikat Recipe itu, karena entri tersebut dipakai bersama oleh setiap komponen yang mengikatnya:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (source recipe berupa string kosong, yang tidak menyebut mode sourceless maupun mode sourced. hilangkan field source untuk mode sourceless, atau sebutkan path atau URI yang tidak kosong untuk mode sourced)

Build mencetak baris tersebut di bawah tag CATALOG_ERROR dengan kode singkat kondisi ini, E0251, dan file Recipe di sampingnya.

Cara memperbaiki: hilangkan field source: sepenuhnya (atau setel ke null) jika Recipe bersifat sourceless, atau berikan path / URI / objek sumber terstruktur yang tidak kosong jika Recipe bersifat sourced.

No Recipe is mapped for a component or feature instance (Tidak ada Recipe yang dipetakan untuk instans komponen atau fitur)

Tipe suatu instans tidak memiliki pemetaan Manifest yang menghasilkan Recipe yang dimuat katalog. Pemilihan Recipe bersifat hanya-pemetaan: compiler tidak pernah memilih Recipe dengan membaca spec.implements: lalu memilih di antara kandidat, sehingga tipe yang tidak dipetakan akan berhenti berapa pun banyaknya Recipes yang mengimplementasikannya. implements memberi masukan bagi pilihan; penulis yang membuatnya; Manifest yang mencatatnya.

Kondisi yang sama mencakup pemetaan yang ada tetapi tidak mengarah ke mana pun — nilai dengan bentuk referensi yang diterima yang menyebut Recipe yang tidak dimuat katalog, termasuk yang ada pada versi berbeda dari yang disematkan nilai tersebut, dan yang nama polosnya ditawarkan oleh dua kapabilitas sekaligus. Tidak satu pun menghasilkan Recipe yang dapat dikatakan telah dipilih penulis. Nilai pemetaan yang bentuknya tidak dapat diungkapkan oleh referensi mana pun dilaporkan secara terpisah, di bawah “Manifest mapping value is not a shape a recipe reference accepts (Nilai pemetaan Manifest bukan bentuk yang diterima referensi recipe)” di atas, sehingga klaim bahwa suatu entitas tidak ada hanya dibuat tentang referensi yang sebenarnya dapat terselesaikan.

Pesan yang dikeluarkan, untuk instans komponen. Ketika pemetaan ada dan menyebut sesuatu yang tidak ada:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names (tidak ada recipe yang terselesaikan untuk instans komponen/fitur: tambahkan pemetaan Manifest eksplisit untuk tipenya. perbaiki nilai pemetaan di Manifest, atau publikasikan recipe yang disebutnya)

Ketika tidak ada pemetaan dan terdapat Recipes yang mengimplementasikan tipe tersebut, Recipes itu dicantumkan sebagai kandidat untuk disematkan:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest (tidak ada recipe yang terselesaikan untuk instans komponen/fitur: tambahkan pemetaan Manifest eksplisit untuk tipenya. sematkan salah satunya di Manifest)

Dan ketika tidak ada yang mengimplementasikan tipe tersebut sama sekali, tidak ada yang dapat dicantumkan:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it (tidak ada recipe yang terselesaikan untuk instans komponen/fitur: tambahkan pemetaan Manifest eksplisit untuk tipenya. tidak ada recipe di katalog yang mengimplementasikan tipe ini; tulis satu, lalu petakan tipe tersebut ke recipe itu)

Dalam workspace yang tidak menyebut direktori katalog apa pun, Recipes yang dicari hanyalah yang disematkan lockfile: milik registry tidak dicantumkan, dan Manifest yang tidak memetakan satu pun untuk tipe tersebut tidak menyematkan satu pun. Di sana, jika tidak ada Recipe tersemat yang mengimplementasikan tipe tersebut, klaim ketiadaan dibuat terhadap sematan, bukan terhadap katalog, dan pesan menyatakannya:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (tidak ada resep yang di-resolve untuk instans komponen/fitur: tambahkan pemetaan eksplisit untuk tipenya di Manifest (Manifest, pada posisi, instans, dan tipe yang ditunjukkan). tidak ada resep yang disematkan lockfile yang mengimplementasikan tipe ini; tanpa direktori katalog, resep yang dicari hanyalah yang disematkan lockfile, bukan milik registry; sematkan di Manifest resep yang diterbitkan registry, atau tulis satu, lalu petakan tipe tersebut ke resep itu)

Tipe yang ditulis Aggregate tanpa versi ditawari Recipes yang mengimplementasikan versi yang dipakai build untuk mengompilasinya — versi tertinggi dari Component tersebut yang dimuat katalog. Instans core/datastore/postgres, dengan katalog memuat Component itu pada 1.0.0, ditawari setiap Recipe yang mendeklarasikan spec.implements: core/datastore/postgres:1.0.0, serta setiap Recipe yang mendeklarasikan tipe tanpa versi atau rentang caret yang menerima 1.0.0. Tipe yang tidak memiliki Component di katalog hanya ditawari Recipes yang mendeklarasikan tipe tanpa versi itu sendiri.

Instans fitur melaporkan kasus-kasus ini dalam bentuknya sendiri, masing-masing setelah kalimat kondisi tersebut. Tipe fitur yang ditulis Aggregate tanpa versi dicocokkan dengan cara yang sama seperti tipe komponen, pada versi yang digunakan build untuk mengompilasinya — versi tertinggi dari Feature tersebut yang dimiliki katalog — dan pesan yang menyebut <type>:<version> menyebut tipe pada versi tersebut, yaitu yang dicari di katalog. Jika Recipe tempat komponen suatu pelekatan dipetakan diketahui, FeatureRecipes dibedakan berdasarkan kapabilitas yang diikat oleh Recipe tersebut: yang terikat ke kapabilitas komponen ditawarkan lebih dahulu, dan FeatureRecipe yang terikat ke kapabilitas lain tetap dirender, sebagai keluarannya sendiri di samping keluaran komponen, bukan di dalamnya, sehingga jika tidak ada yang terikat ke kapabilitas komponen, yang itulah yang ditawarkan sebagai gantinya. Pemetaan yang tidak mengarah ke mana pun berbunyi feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog. Jika ada FeatureRecipes yang mengimplementasikan tipe tersebut untuk kapabilitas komponen, hanya itulah yang dicantumkan: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. Jika hanya mengimplementasikannya untuk kapabilitas lain: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. Jika sama sekali tidak ada yang mengimplementasikan tipe tersebut: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. Dan jika kapabilitasnya tidak diketahui — pemetaan komponen itu sendiri tidak di-resolve ke Recipe mana pun, yang dilaporkan tersendiri, atau pelekatan ditulis pada sebuah batas, yang komponen-komponennya dapat dirender melalui beberapa kapabilitas — setiap implementasi dicantumkan: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. Dalam workspace yang tidak menyebut direktori katalog apa pun, FeatureRecipes yang dicari hanyalah yang disematkan lockfile: milik registry tidak dicantumkan, dan Manifest yang tidak memetakan satu pun untuk tipe tersebut tidak menyematkan satu pun. Di sana klaim ketiadaan dibuat terhadap sematan, bukan terhadap katalog, dan pesan menyatakannya. Jika tidak ada yang mengimplementasikan tipe tersebut: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — dan jika kapabilitasnya tidak diketahui, pesan tidak menyebut kapabilitas apa pun dan diakhiri dengan pin one a registry publishes in the Manifest, or write one, then map the type to it. Jika FeatureRecipes yang tersemat hanya mengimplementasikannya untuk kapabilitas lain, pesan untuk kasus itu berbunyi no feature recipe the lockfile pins implements sebagai pengganti no feature recipe in the catalog implements, dengan klausa yang sama setelah kapabilitas.

Cara memperbaiki: tambahkan pemetaan yang diminta pesan, di bawah spec.mappings.components.type dalam Manifest, dengan kunci berupa tipe komponen dan nilai berupa Recipe. Ketika pesan mencantumkan kandidat, pilih salah satunya — daftar itu persis berisi Recipes yang mendeklarasikan bahwa mereka mengimplementasikan tipe tersebut pada versi yang dihasilkan build. Ketika pesan menyebut Recipe yang tidak ada di katalog, perbaiki nilainya atau tambahkan Recipe itu ke direktori katalog yang dibaca build; versi dalam nilai harus cocok dengan versi yang dimuat katalog. Ketika tidak ada yang mengimplementasikan tipe tersebut, bagian yang hilang adalah Recipe itu sendiri. Ketika pesan menyatakan bahwa resep atau resep fitur yang dicari hanyalah yang disematkan lockfile, workspace tidak membaca direktori katalog apa pun, sehingga registry mungkin tetap menerbitkan Recipe atau FeatureRecipe yang mengimplementasikan tipe tersebut: yang membuat pull mengambil dan menyematkannya adalah pemetaan tipe ke sana di Manifest.

A Manifest name mapping names nothing in the build (Pemetaan name pada Manifest tidak menyebut apa pun dalam build)

Sebuah kunci di bawah spec.mappings.components.name atau spec.mappings.features.name tidak menyebut instans komponen atau lampiran apa pun yang dimuat build. Tingkat name dicocokkan dengan nama persis dari hal yang direalisasikan: kunci components.name dengan nama instans komponen sebagaimana ditulis Aggregate, dan kunci features.name dengan nama lampiran itu sendiri — kunci tempat lampiran itu ditulis di features: sebuah komponen, atau <alias>.<slot> untuk lampiran yang ditulis pada koneksi — tidak pernah dengan nama komponen tempat lampiran itu berada. Kunci yang tidak menyebut apa pun tidak akan pernah dirujuk: setiap instans yang dimaksudkannya akan di-resolve melalui tingkat type, dan build akan selesai tanpa sepatah kata pun tentang entri yang diabaikannya. Karena itu build berhenti sebelum apa pun di-render.

Pesan menyebut Manifest, kunci dan bagian tempat kunci itu ditulis, nama-nama dari jenis tersebut yang benar-benar dimuat build — dipersempit ke tipe yang diimplementasikan Recipe atau FeatureRecipe milik entri, jika tipe itu diketahui dan build memuat salah satunya — dan, jika dapat diketahui, nama yang mungkin Anda maksud: untuk kunci features.name yang merupakan nama komponen, lampiran bertipe itu yang dibawa komponen tersebut; untuk kunci components.name yang merupakan nama lampiran, komponen yang membawanya; dan selain itu, nama yang berjarak satu suntingan.

Pesan yang dikeluarkan, untuk kunci features.name yang ditulis sebagai nama komponen tempat lampiran berada:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (kunci pemetaan name pada Manifest tidak menyebut instans komponen atau lampiran apa pun dalam build ini, sehingga entri tidak mengikat apa pun: kunci di bawah mappings.features.name pada Manifest: tidak ada lampiran dalam build ini yang bernama demikian; kunci features.name menyebut lampiran dengan namanya sendiri — kunci tempat lampiran ditulis di features sebuah komponen, atau alias dan slot untuk lampiran yang ditulis pada koneksi — tidak pernah komponen tempat ia dilampirkan; lampiran bertipe yang disebut dalam build ini tercantum; nama yang disebut adalah komponen, dan kunci features.name menyebut lampiran, bukan komponen tempat ia dilampirkan — apakah yang Anda maksud lampiran yang disebut?)

Dan untuk kunci components.name yang berjarak satu suntingan dari nama sebuah instans:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (kunci pemetaan name pada Manifest tidak menyebut instans komponen atau lampiran apa pun dalam build ini, sehingga entri tidak mengikat apa pun: kunci di bawah mappings.components.name pada Manifest: tidak ada instans komponen dalam build ini yang bernama demikian; kunci components.name menyebut instans komponen persis sebagaimana Aggregate menuliskannya; instans komponen bertipe yang disebut dalam build ini tercantum; apakah yang Anda maksud instans yang disebut?)

Setiap kunci yang tidak menyebut apa pun dilaporkan dalam satu build, sesuai urutan penulisannya di Manifest.

Cara memperbaiki: ganti nama kunci menjadi nama yang disarankan pesan, atau salah satu nama yang dicantumkannya — untuk lampiran, nama tempat lampiran itu ditulis, bukan nama komponennya. Jika entri tersebut tidak lagi diperlukan, hapus; instans bertipe itu kemudian di-resolve melalui tingkat type.

Sebuah Manifest memetakan dua kunci berbeda versi ke satu tipe

Pencarian tipe cocok dengan lebih dari satu kunci pemetaan Manifest. Kunci tipe dicocokkan secara toleran terhadap versi, sehingga core/api-server, core/api-server:1.0.0 dan core/api-server:2.0.0 yang ditulis sebagai kunci pemetaan terpisah semuanya menjawab untuk tipe dasar yang sama — dan pencarian yang mencapai dua di antaranya memiliki dua Recipes untuk dipilih tanpa aturan untuk mengutamakan salah satunya.

Build berhenti alih-alih menyelesaikan kunci mana pun yang kebetulan dibaca lebih dulu. Memilih salah satunya akan membuat keluaran yang di-render bergantung pada urutan penelusuran pemetaan, yang justru dikesampingkan oleh keluaran yang identik per byte.

Pesan yang diemisikan:

manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (manifest memetakan beberapa kunci berbeda versi ke tipe dasar yang sama; pencarian tipe-ke-recipe ambigu: tipe cocok dengan kunci berbeda versi — sematkan versi tipe yang ditulis atau hapus kunci pemetaan duplikat)

Cara memperbaiki: ada dua arah, dan pesan menyebut keduanya. Hapus kunci pemetaan duplikat, dengan mempertahankan kunci yang seharusnya menjawab untuk tipe tersebut — ini tepat ketika kunci tambahan merupakan sisa dari kenaikan versi. Atau sematkan versi di sisi penulisan, sehingga tipe yang dideklarasikan komponen menyebut kunci persis yang Anda maksud, yang tepat ketika beberapa kunci itu disengaja dan komponen yang berbeda memang menginginkan Recipes yang berbeda.

Dua entitas katalog dalam satu direktori berbagi identitas

Dua entitas dengan jenis yang sama, yang dimuat dari direktori katalog yang sama, membawa identitas yang sama. Identitas adalah apa yang dinamai oleh sebuah referensi, sehingga dua file yang mengklaim satu identitas membuat setiap referensi ke identitas tersebut memiliki dua jawaban.

Di dalam satu direktori hal ini menghentikan build; di antara direktori tidak. Identitas yang sama yang ada di dua direktori katalog yang berbeda diselesaikan sebagai bayangan menang-pertama — direktori yang tercantum lebih dahulu menang — dan inilah yang memungkinkan direktori lokal menimpa entitas yang dipublikasikan secara sengaja. Hanya tabrakan di dalam satu direktori yang merupakan kesalahan penulisan tanpa tafsiran yang menjadikannya disengaja.

Aturannya sama untuk setiap jenis yang diindeks: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, dan Aggregate. Penghentian diposisikan pada file kedua, dan menyebutkan jenis serta identitas yang bertabrakan.

Pesan yang diemisikan:

duplicate entity identity within a single catalog directory (Component identity "<identity>") (identitas entitas duplikat dalam satu direktori katalog (identitas Component))

dengan kata milik jenis tersebut sebagai pengganti Component — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity, dan seterusnya.

Cara memperbaiki: ganti nama salah satu dari kedua entitas, atau pindahkan ke direktorinya sendiri. Untuk Recipe atau FeatureRecipe, identitasnya mencakup cakupan provider dan versi, sehingga dua file yang hanya berbeda versi tidak bertabrakan — tabrakan yang sesungguhnya di sana berarti versi yang sama dipublikasikan dua kali. Menyalin file entitas untuk memulai entitas baru dan lupa mengubah metadata.name adalah penyebab yang umum.

Dua tempat dibaca secara keseluruhan, bukan satu file demi satu file: direktori katalog, yang setiap dokumen di bawahnya dapat menjadi jawaban pencarian berdasarkan nama, dan direktori yang memuat sebuah Release, yang Aggregates dan Manifests-nya menjadi dasar penyelesaian Release yang menamainya berdasarkan identitas. Tautan simbolik di antara file-file tersebut dapat mengarah ke mana saja di mesin, sehingga setiap direktori semacam itu memiliki direktori yang harus menjadi batas pembacaannya, dan tautan yang mengarah ke luarnya tidak dibaca. Batas workspace menyatakan aturan yang diterapkan di sini, beserta jalur lain yang dipegangnya.

Direktori mana yang menjadi batas tersebut bergantung pada letak direktori yang dibaca:

  • Workspace, untuk direktori katalog atau direktori Release yang berada di dalamnya. Hal ini berlaku untuk direktori catalog konvensional milik workspace setiap kali tidak ada yang menamainya — ketika direktori itu dibaca hanya karena keberadaannya: direktori itu kemudian menjadi milik workspace sendiri, sehingga catalog yang dirinya sendiri merupakan tautan yang mengarah ke luar workspace tidak dibaca.
  • Direktori yang Anda namai dan terletak di luar workspace, untuk apa yang ada di bawahnya: direktori katalog yang Anda berikan dengan --catalog, atau yang dicantumkan konfigurasi workspace di bawah catalog_dirs — untuk workspace atau untuk satu Release — serta direktori Release yang Anda namai, atau yang dinamai konfigurasi, yang terletak di luar workspace. Direktori itu sendiri digunakan sebagaimana Anda menamainya — direktori yang berupa tautan dibaca di tempat yang ditunjuknya — dan apa yang dibaca di bawahnya tetap berada di dalamnya. Hal ini mencakup direktori catalog konvensional setelah Anda menamainya: jika dicantumkan di bawah catalog_dirs, atau diberikan dengan --catalog, catalog yang berupa tautan yang mengarah ke luar workspace dibaca di tempat yang ditunjuknya, seperti direktori lain yang Anda namai. Menamai tempat yang ditunjuknya sebagai gantinya, dalam ejaan apa pun, atau direktori di atas tempat itu, juga menamainya: direktori yang Anda namai sudah membaca apa yang ada di sana, sehingga tempat itu dibaca sekali, melalui direktori tersebut. Menamai direktori dalam konfigurasi adalah cara workspace membaca entitas yang disimpan di luarnya.

Yang dinilai adalah setiap entri yang darinya pembacaan akan mengambil sesuatu: tautan ke file yang bernama seperti dokumen YAML, dan tautan ke direktori, yang dapat memuat dokumennya sendiri. Tautan yang mengarah ke suatu tempat di dalam direktori yang harus menjadi batas pembacaan dibaca di tempat penelusuran menemuinya. Tautan ke file yang tidak diambil apa pun oleh pembacaan katalog — file catatan, arsip chart — tidak dinilai di sini, dan tautan yang tidak mengarah ke mana pun tidak memiliki apa pun di baliknya untuk dibaca.

Pencarian yang menjadi tumpuan kompilasi berhenti pada tautan semacam itu alih-alih melewatinya. Entitas di balik tautan itu mungkin adalah entitas yang dinamai sebuah referensi, dan melewatinya secara diam-diam akan membuat entitas lain dengan nama yang sama, dari direktori katalog yang lebih belakang, diselesaikan sebagai gantinya. Karena itu aggrega build, aggrega pull, aggrega validate, aggrega inspect di mana pun ia membaca katalog, lint atas satu Release, serta permintaan editor dan asisten yang melakukan build, pratinjau, graf, validasi, atau mendeskripsikan sebuah Release semuanya berhenti sebelum apa pun diselesaikan, dengan menyebutkan tautan tersebut. Lint atas seluruh katalog berhenti dengan cara yang sama: putusannya mewakili setiap dokumen yang dimuat direktori katalog, sehingga lint tidak melaporkan katalog yang bersih selama salah satu dokumennya tidak dapat dibaca. Direktori Release tunduk pada aturan yang sama di mana pun sebuah Release menamai Aggregate atau Manifest-nya berdasarkan identitas, atau sebuah Manifest menamai Manifest yang diperluasnya dengan cara itu, dan pemindaian berhenti pada tautan di antara dokumen di samping Release bahkan jika tautan itu bukan yang dinamai referensi, dengan alasan yang sama seperti duplikat di sana menghentikannya: direktori tidak dapat menjawab untuk sebuah nama selama salah satu dokumennya tidak dapat dibaca. Release yang dinamai untuk operasi — atau Manifest yang Anda periksa secara tersendiri — bukan salah satu dokumen tersebut: ia dibaca di tempat ia dinamai, sehingga Release yang dirinya sendiri merupakan tautan yang mengarah ke luar dibaca di tempat yang ditunjuknya, dan apa yang dinamainya dicari di samping tautan, di direktori tempat Anda menamainya (Release atau Manifest yang dinamai melalui tautan).

Sebaliknya, daftar melewati tautan semacam itu, dan tidak mencantumkan apa pun di baliknya. Indeks entitas editor, pelengkapan otomatisnya, dan kandidat yang ditawarkannya tidak mencantumkan entitas yang diwakili tautan yang mengarah ke luar, dan indeks entitas menyebutkan tautan semacam itu di dalam workspace di antara tautan yang tidak dibacanya.

File konfigurasi workspace dibatasi pada workspace dengan cara yang sama. Setiap .aggrega-config.yaml dari root workspace hingga direktori tempat perintah dijalankan, serta .aggrega-config-append-ci.yaml yang disimpan pipeline di samping salah satunya, adalah konten milik workspace sendiri. File yang berupa tautan yang mengarah ke luar workspace — atau yang dicapai melalui tautan direktori yang mengarah ke luar — tidak dibaca, dan karena setiap perintah, language server editor, dan alat asisten membaca konfigurasi sebelum hal lainnya, masing-masing berhenti di sana, dengan menyebutkan tautan tersebut, alih-alih berjalan dengan konfigurasi yang tersusun dari apa pun yang tersisa. Language server, dan server asisten yang berkomunikasi melalui stream-nya sendiri, tetap dimulai pada workspace semacam itu: daftar Releases dan entitasnya tetap menjawab, dibaca tanpa konfigurasi apa pun, dan menyebutkan file tersebut di antara tautan yang tidak dibacanya, sementara setiap permintaan lain yang ditentukan konfigurasi ditolak dengan kondisi ini, dengan menyebutkan tautan tersebut. Solusi yang disebutkan pesan ini adalah solusi milik konfigurasi: file konfigurasi global adalah satu-satunya konfigurasi yang dibaca dari mana pun ia disimpan, dinamai dengan --config atau AGGREGA_CONFIG.

Lockfile sebuah Release dibatasi dengan cara yang sama, saat dibaca maupun saat ditulis. Lockfile di samping sebuah Release dibaca untuk pin yang menjadi dasar penyelesaian build, pull, validasi, lint, inspeksi, aggrega cache prune, serta permintaan editor dan asisten, dan lockfile dibatasi pada direktori yang membatasi penulisannya: workspace, atau direktori milik Release itu sendiri untuk Release yang dinamai di luarnya. Lockfile yang berupa tautan yang mengarah ke luar tidak dibaca, dan masing-masing operasi tersebut berhenti dengan menyebutkan tautan itu alih-alih menyelesaikan berdasarkan pin yang disimpan di tempat lain di mesin, atau tanpa pin tersebut. Solusi yang disebutkan pesan ini adalah solusi milik lockfile: lockfile memiliki satu tempat, di samping Release, tempat pull menuliskannya.

Berkas yang dibaca di samping sebuah entitas diperlakukan dengan cara yang sama. Dua operasi membaca berkas yang berada di samping dokumen entitas itu sendiri, bukan berkas yang dinamai oleh sebuah referensi. Menyematkan (pin) sebuah entitas, atau menerbitkannya, membaca setiap dokumen YAML lain di direktori entitas tersebut untuk mengetahui apakah ada entitas lain yang berbagi direktori itu. Memuat entitas Plugin yang ditulis di sebuah direktori katalog membaca .wasm hasil build yang diletakkan di sampingnya. Masing-masing dibatasi pada direktori tempat dokumen entitas itu sendiri dibaca — workspace, direktori katalog yang Anda namai di luarnya, atau, untuk entitas yang Anda sematkan atau terbitkan dengan menamai dokumennya di luar workspace, direktori dokumen itu sendiri — dan berkas yang berupa tautan yang mengarah keluar darinya tidak dibaca. aggrega pin, aggrega push dengan atau tanpa --dry-run, pull yang melakukan penyematan, serta penyematan dan penerbitan oleh editor dan asisten berhenti dengan menyebutkan tautan tersebut, karena dokumen yang tidak dibaca bisa jadi entitas yang menghalangi. Build atau pull yang memuat plugin juga berhenti dengan menyebutkan tautan tersebut, alih-alih menjalankan byte yang disimpan di tempat lain pada mesin atau mencari plugin di tempat lain. Solusi yang disebutkan pesan ini adalah solusi khusus untuk berkas di samping entitas: simpan berkas itu sendiri di sana.

Cache artefak workspace diperlakukan dengan cara yang sama, baik saat dibaca maupun saat ditulis. Segala sesuatu yang dibaca dari cache di bawah artifact_cache_dir — entitas, plugin, atau library yang di-cache beserta manifest di sampingnya, arsip sumber beserta metadatanya, input eksternal yang disematkan, bundel tanda tangan, indeks pencarian lokal sebuah registry — dan setiap entri workspace yang didaftar oleh aggrega cache status, aggrega cache prune, dan aggrega cache clear, dibatasi pada direktori yang membatasi penulisan ke cache: direktori cache itu sendiri, baik default .aggrega/cache maupun direktori yang dinamai konfigurasi yang naik keluar dari root workspace. Apa pun di dalamnya yang berupa tautan yang mengarah keluar dari direktori cache — ke tempat lain di dalam workspace maupun ke tempat lain mana pun — tidak dibaca, begitu pula apa pun di balik direktori cache yang ditulis di dalam root workspace yang dirinya sendiri berupa tautan yang mengarah keluar dari workspace: build, pull, validasi, pencarian, ketiga perintah cache, serta permintaan editor dan asisten yang membaca cache berhenti dengan menyebutkan tautan tersebut — termasuk konten yang disimpan cache di bawah digest yang tercatat, karena digest menyatakan apa isi byte tersebut, bukan dari mana byte itu boleh dibaca. Direktori cache yang ditulis di dalam root workspace yang berupa tautan ke tempat lain di dalam workspace dibaca di tempat yang dituju. Pemberitahuan deprecation yang dicetak aggrega inspect, yang tidak memutuskan apa pun, dikecualikan. Prune atau clear yang menjumpai salah satu direktori cache itu sendiri yang berupa tautan yang mengarah keluar dari direktori cache, atau direktori cache yang dirinya sendiri berupa tautan yang mengarah keluar dari workspace, memperlakukannya sebagai penghapusan yang akan terjadi, di bawah “A path the operation writes leads through a link out of the directory it must stay inside (Jalur yang ditulis operasi mengarah melalui tautan keluar dari direktori yang harus menjadi batasnya)”, sebelum mendaftar apa pun. Solusi yang disebutkan pesan ini adalah solusi khusus untuk cache: setelah tautan dihapus, pull mengisi cache kembali, dan cache yang disimpan di tempat lain dinamai dengan artifact_cache_dir, relatif terhadap root workspace, alih-alih dijangkau melalui tautan.

Repositori yang diambil oleh sebuah sumber dibatasi pada checkout-nya sendiri. Ketika sebuah pull — aggrega pull, atau build atau permintaan editor atau asisten yang me-resolve dependensi sebuah Release — mengambil sumber git-repository, pull tersebut melakukan checkout repositori dan mengarsipkan direktori yang dinamai sumber, dan checkout tersebut adalah direktori tersendiri: setiap tautan yang dibawa repositori, termasuk module_subdir itu sendiri, dibatasi padanya. Tautan ke berkas atau direktori di dalam repositori diarsipkan sebagai apa yang ditunjuknya, dengan nama tautan tersebut. Tautan yang mengarah keluar dari repositori — yang dapat menunjuk ke berkas mana pun pada mesin yang menjalankan pull — tidak dibaca: pull berhenti dengan menyebutkan tautan tersebut beserta tujuannya, dan tidak ada yang di-cache. Checkout tersebut adalah direktori sementara yang dihapus begitu pull berhenti, sehingga pesan menyebutkan tautan berdasarkan tempatnya di repositori — chart/secret.txt, sebagai baris pertama baris perintah dan di dalam kalimat — dan direktori yang harus menjadi batasnya sebagai repositori dan revisi yang dinamai sumber: which must stay inside the repository <url> at <ref> (commit <commit>), atau at commit <commit> jika sumber tidak menyebutkan ref atau menyebutkan commit itu sendiri. Tujuan tautan disebutkan sebagai tempat tersebut pada mesin Anda. Solusi yang disebutkan pesan ini adalah solusi khusus untuk repositori: tautan tersebut di-commit di sana, sehingga harus diubah di sana — dibuat menunjuk ke dalam repositori, atau diganti dengan berkas itu sendiri — lalu sumber menyebutkan revisi yang memuat perubahan tersebut. Tautan direktori yang mengarah kembali ke direktori yang sudah sedang dibaca arsip melaluinya juga menghentikan pull, karena pohon yang diwakilinya tidak berujung; penolakan itu adalah galat biasa, bukan kondisi ini.

Overlay yang dibaca oleh pembuatan katalog diperlakukan dengan cara yang sama. aggrega plugin gen-catalog --from-embedded membaca setiap overlay di bawah direktori overlay yang diberikan kepadanya — diketik dengan --overlay, dipilih di editor, atau dinamai oleh asisten — dan membatasi masing-masing pada direktori tempat direktori overlay itu dibaca: workspace, untuk direktori overlay di dalamnya, dan direktori overlay itu sendiri untuk direktori yang dinamai di luar workspace. Direktori overlay digunakan sebagaimana Anda menamainya — direktori yang berupa tautan dibaca di tempat yang ditunjuknya. Overlay di bawahnya yang berupa tautan yang mengarah keluar dari direktori yang membatasinya tidak dibaca, begitu pula tautan direktori yang mengarah keluar darinya, yang mungkin berisi overlay sendiri: pembuatan berhenti dengan menyebutkan tautan tersebut, tanpa menulis apa pun, alih-alih membuat katalog tanpa overlay tersebut. Overlay yang berupa tautan yang mengarah ke tempat lain di dalam direktori yang membatasinya dibaca di tempat yang ditunjuknya; tautan direktori yang mengarah ke dalamnya tidak dimasuki. Solusi yang disebutkan pesan ini adalah solusi khusus untuk overlay: simpan overlay itu sendiri di bawah direktori overlay, atau namai direktori yang berisi setiap overlay sebagai direktori overlay.

Direktori yang Anda impor dibatasi pada dirinya sendiri. aggrega import yang diberi sebuah direktori, alat impor asisten, dan metode aggrega/import sesi menyerahkan kepada importer berkas-berkas direktori yang dipilih oleh pola berkasnya, masing-masing pada tempatnya di direktori, sehingga direktori itulah batas bagi pembacaan tersebut di mana pun letaknya — di dalam workspace maupun di luarnya. Yang dinilai adalah setiap entri yang akan diambil sesuatu oleh impor: tautan ke berkas yang dipilih oleh salah satu pola yang relevan — pola importer yang melayani format yang dinamai, atau, jika format dikenali, pola setiap importer yang dipilih di antaranya oleh impor, termasuk importer inti compiler — dan tautan ke direktori, yang tidak pernah dimasuki. Tautan yang mengarah keluar dari direktori, ke tempat lain di workspace atau ke mana pun, tidak dibaca: impor berhenti dengan menyebutkan tautan tersebut sebelum berkas apa pun di direktori dibuka, tanpa menulis apa pun. Tautan terpilih ke berkas di tempat lain di dalam direktori dibaca di tempat yang ditunjuknya, dengan nama tautan itu sendiri, dan tautan ke berkas yang tidak dipilih pola mana pun tidak dinilai maupun dibaca. Direktori itu sendiri digunakan sebagaimana Anda menamainya — direktori yang berupa tautan dibaca di tempat yang ditunjuknya. Jika dijangkau melalui listener, alat asisten menyebutkan tautan berdasarkan tempatnya di workspace dan tidak menyebutkan tujuannya. Solusi yang disebutkan pesan ini adalah solusi khusus untuk direktori yang diimpor: simpan berkas itu sendiri di direktori alih-alih tautan ke berkas tersebut, atau impor direktori yang dituju tautan.

Pesan yang dikeluarkan. Kalimat kondisi itu sendiri membukanya, lalu jalur yang dicapai pembacaan, direktori yang harus menjadi batasnya, tautan yang dijumpai di sepanjang jalan dan tempat yang dituju tautan tersebut, lalu solusinya:

a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link (file yang dibaca operasi ini mengarah melalui sebuah tautan ke luar direktori yang harus menjadi batasnya. Tidak ada yang dibaca melalui tautan tersebut. Hapus tautan itu, atau buat tautan itu mengarah ke tempat di dalam direktori workspace. Untuk membaca apa yang disimpan di luar, cantumkan direktori yang menyimpannya sebagai direktori katalog dalam konfigurasi workspace, alih-alih menjangkaunya melalui tautan di bawah salah satunya: direktori yang dicantumkan dibaca di tempat yang dituju, bahkan ketika direktori itu sendiri adalah tautan)

Diagnostik ini tidak membawa kategori: yang bermasalah adalah tata letak di disk, bukan dokumen apa pun yang Anda tulis.

Cara memperbaiki: ganti tautan dengan salinan dari apa yang dituju, atau hapus tautan itu; atau, jika entitas memang dimaksudkan tetap berada di luar workspace, cantumkan direktori yang menyimpannya di bawah catalog_dirs dalam konfigurasi workspace, atau berikan dengan --catalog, sehingga direktori tersebut dibaca sebagai direktori katalog tersendiri. Cantumkan direktori yang dituju tautan, bukan direktori tempat tautan itu berada: tautan yang ditemui di bawah sebuah direktori dinilai dengan cara yang sama bagaimanapun direktori itu dibaca, sehingga mencantumkannya tidak mengubah apa pun. Jika tautan itu adalah direktori catalog konvensional milik workspace itu sendiri, mencantumkan catalog — atau direktori yang ditujunya — di bawah catalog_dirs, atau memberikan salah satunya dengan --catalog, sudah cukup, karena direktori yang Anda sebutkan dibaca di tempat yang ditujunya. Jika tautan itu adalah lockfile sebuah Release, hapus tautan itu dan lakukan pull Release tersebut lagi, yang menulis lockfile baru di sampingnya. Manifest tidak memiliki tingkat katalog, sehingga Manifest yang dibaca Release disimpan di samping Release itu sendiri. Jika tautan itu adalah file konfigurasi, ganti dengan salinan yang disimpan di workspace; konfigurasi yang ingin Anda bagikan antar-workspace dibaca dengan menyebutkannya sebagai file konfigurasi global, dengan --config atau AGGREGA_CONFIG, di bawah file milik setiap workspace. Jika tautan berada di samping entitas yang sedang di-pin atau dipublikasikan, ganti dengan file itu sendiri, atau pindahkan dokumen yang merupakan entitas ke direktorinya sendiri; jika tautan itu adalah .wasm di samping entitas Plugin, letakkan .wasm hasil build itu sendiri di sana. Jika tautan itu adalah direktori cache artefak atau sesuatu di dalamnya, hapus tautan itu — pull akan mengisi cache lagi — atau, untuk menyimpan cache di tempat lain, atur artifact_cache_dir ke direktori tersebut, ditulis relatif terhadap root workspace (../shared-cache). Jika tautan di-commit dalam repositori yang diambil oleh sumber git-repository, ubah tautan itu di repositori tersebut — arahkan ke dalam repositori, atau commit file itu sendiri — dan sebutkan revisi yang membawa perubahan itu. Jika tautan adalah overlay di bawah direktori overlay sebuah pembuatan katalog, ganti dengan overlay itu sendiri, atau sebutkan direktori yang menyimpan setiap overlay sebagai direktori overlay. Jika tautan berada di direktori yang Anda impor, simpan file itu sendiri di direktori tersebut alih-alih tautan ke file itu, atau impor direktori yang dituju tautan.

A reference to another file leads out of the directory it must stay inside (Referensi ke file lain mengarah keluar dari direktori yang harus ditempatinya)

Sebuah Release dan sebuah Manifest dapat menyebut file lain melalui path: aggregate: dan manifest: milik Release yang ditulis sebagai ./… atau ../…, extends: miliknya, extends: milik Manifest yang ditulis sebagai path, dan parameters: { $import: … } milik Release. Dokumen di dalam workspace dengan cara itu hanya menjangkau file di dalam workspace. Release yang berada di luar workspace — yang Anda sebut di baris perintah, atau yang disebut oleh konfigurasi workspace — dan Manifest yang Anda sebut tersendiri di baris perintah di luar workspace hanya menjangkau file di dalam direktorinya sendiri: direktori itu adalah root tersendiri, sebagaimana direktori yang Anda sebut di luar workspace, dan setiap Release yang dituju oleh rantai extends:-nya dibatasi pada direktori yang sama. Path yang keluar dari direktori itu sebagaimana tertulis, dan path yang tetap di dalam sebagaimana tertulis tetapi di tengah jalan menemui tautan simbolik yang mengarah keluar, keduanya ditolak, dan tidak ada yang dibaca dari file yang disebutnya. Path yang mengarah ke file yang belum ada di bawah direktori tersebut tidak ditolak di sini; path itu dilaporkan sebagai file yang tidak dapat dibaca. Batas workspace menjelaskan mengapa sebuah referensi dibatasi, demikian pula path yang Anda sebut.

Dari mana sebuah path di-resolve mengikuti aturan yang sama yang diajarkan referensi bahasa untuk setiap kunci: aggregate: dan manifest: milik Release, serta extends: milik Manifest, di samping Release yang disebut oleh perintah atau permintaan — atau, untuk Manifest yang Anda sebut tersendiri, di samping Manifest itu; extends: milik Release dan $import: parameter, di samping Release yang menuliskannya, sehingga setiap mata rantai extends: menyebut induknya di sampingnya sendiri. Diagnostik menyebut direktori tempat path di-resolve.

Nama, alih-alih path, tidak dinilai di sini — aggregate: payments, extends: base-manifest. Nama dicari di antara dokumen di samping Release dan, untuk Aggregate, di direktori katalog, yang dibatasi oleh aturan dalam “A file the operation reads leads through a link out of the directory it must stay inside (File yang dibaca operasi mengarah melalui tautan keluar dari direktori yang harus ditempatinya)” di atas.

Setiap permukaan yang me-resolve apa yang disebut Release berhenti pada kondisi ini, sebelum file dibaca: aggrega pull, aggrega build, aggrega validate, aggrega inspect atas Release atau Manifest, lint atas satu Release, serta permintaan editor dan asisten yang mem-build, mempratinjau, membuat graf, memvalidasi, atau mendeskripsikan Release. Di editor, diagnostik ditempatkan pada kunci di Release yang mengarah ke file tersebut.

Pesan yang dikeluarkan. Kalimat kondisi itu sendiri membukanya, lalu referensi sebagaimana tertulis, dokumen tempat referensi ditulis untuk extends: dan $import: parameter, direktori tempat referensi di-resolve, tempat yang dituju, direktori yang harus ditempatinya, dan tautan jika ada yang membawanya keluar; lalu solusinya. Untuk dokumen di dalam workspace:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (referensi yang dibuat dokumen ke file lain mengarah keluar dari direktori yang harus ditempatinya. Tidak ada yang dibaca dari file itu. Dokumen di dalam workspace hanya menjangkau file di dalam workspace: pindahkan file ke sana — atau, jika tautan membawa referensi keluar, arahkan tautan ke sana — atau buka workspace di direktori yang memuat kedua dokumen. Aggregate yang disimpan di luar direktori itu dijangkau melalui namanya, bukan path, dari direktori katalog yang dicantumkan konfigurasi workspace)

dan untuk Release atau Manifest yang disebut di luar workspace, yang direktorinya sendiri adalah direktori yang harus ditempatinya:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (referensi yang dibuat dokumen ke file lain mengarah keluar dari direktori yang harus ditempatinya. Tidak ada yang dibaca dari file itu. Release atau Manifest yang disebut di luar workspace — di baris perintah, atau oleh konfigurasi workspace — hanya menjangkau file di dalam direktorinya sendiri: pindahkan file ke sana — atau, jika tautan membawa referensi keluar, arahkan tautan ke sana — atau sebut dokumen dari workspace yang memuat kedua dokumen. Aggregate yang disimpan di luar direktori itu dijangkau melalui namanya, bukan path, dari direktori katalog yang dicantumkan konfigurasi workspace)

dengan written in <document> setelah referensi untuk extends: atau $import: parameter, dan the link <link> leads to <place> di akhir jika tautan membawa path keluar. Referensi aggregate: atau manifest: tidak menyebut dokumen: Release yang meng-extend Release lain mungkin mewarisinya dari Release yang lebih atas dalam rantai, dan referensi itu di-resolve di samping Release yang disebut perintah dalam kedua kasus.

Kategori diagnostik ini adalah [OPS_ERROR]: referensi ditulis dalam Release atau Manifest.

Cara memperbaiki: untuk Aggregate yang disimpan di luar workspace, tulis metadata.name-nya alih-alih path, dan cantumkan direktori yang memuatnya di bawah catalog_dirs dalam konfigurasi workspace, atau berikan dengan --catalog — direktori katalog adalah cara workspace menjangkau entitas yang disimpan di luarnya. Manifest, Release yang disebut oleh extends:, dan file parameter dibaca di samping Release dan tidak pernah dicari berdasarkan nama, jadi simpan semuanya di dalam workspace, atau buka workspace di direktori yang memuat Release dan file tersebut. Untuk Release atau Manifest yang Anda sebut dari luar workspace, simpan apa yang disebutnya di direktorinya sendiri, atau build di workspace yang memuat dokumen itu dan apa yang disebutnya. Jika tautan membawa path keluar, ganti tautan dengan salinan dari yang ditujunya, atau arahkan tautan ke dalam direktori.

No catalog version satisfies a version constraint (Tidak ada versi katalog yang memenuhi batasan versi)

Sebuah referensi menyebut entitas yang dimiliki katalog dan mem-pin versi yang tidak dimiliki katalog: versi eksak yang tidak ada, atau rentang caret yang tidak cocok dengan versi mana pun yang tersedia. Kondisi ini berbeda dari kegagalan biasa, ketika namanya sendiri tidak dikenal — di sini entitasnya ada dan hanya versinya yang tidak dapat dipenuhi, itulah sebabnya pesan menyatakan demikian alih-alih melaporkan entitas sebagai hilang dan membuat Anda mencari salah ketik pada nama.

Setiap jenis mencapai kondisi ini melalui satu proses pemilihan yang sama, sehingga pin yang tidak dapat dipenuhi berperilaku sama di mana pun ditulis: salah ketik versi pada pemetaan Recipe di Manifest ditolak persis seperti salah ketik yang sama pada tipe komponen.

Kondisi ini dapat dipulihkan, sehingga editor dapat menampilkannya sebagai diagnostik selagi Anda terus mengetik alih-alih meninggalkan dokumen. Di baris perintah, kondisi ini digabungkan menjadi penghentian.

Pesan yang dikeluarkan, untuk referensi yang dicapai dependensi sebuah Release — tipe komponen, nilai pemetaan Manifest — yang menyebut tempat referensi itu dikumpulkan:

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (tidak ada versi katalog yang memenuhi batasan versi yang direferensikan: entitas yang disebut dan tempat-tempat yang mereferensikannya)

Pesan yang dikeluarkan, untuk pin pada pointer extends::

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (tidak ada versi katalog yang memenuhi batasan versi yang dirujuk)

dengan Feature menggantikan Component jika rantai milik sebuah Feature yang membawa pin.

Cara memperbaiki: ubah pin ke versi yang dimiliki katalog, atau tambahkan versi tersebut ke katalog. aggrega inspect mencantumkan versi-versi yang tersedia untuk sebuah entitas. Rentang caret yang tidak cocok dengan apa pun biasanya berarti semua versi yang tersedia berada di bawah batas bawah yang disebutnya — perlebar rentangnya, atau publikasikan versi yang ditunggu referensi tersebut.

Pin yang tidak berbentuk salah satu bentuk pin adalah kondisi lain, yang dijelaskan dalam “A version pin is none of the forms a pin takes (Pin versi tidak berbentuk salah satu bentuk pin)” di bawah.

A version pin is none of the forms a pin takes (Pin versi bukan salah satu bentuk yang dapat diambil sebuah pin)

Sebuah referensi menamai entitas lain dan dapat mem-pin versi yang diinginkannya setelah titik dua, dalam salah satu dari dua bentuk: pin eksak, yaitu versi semantik seperti 1.0.0 — bentuk yang diambil oleh metadata.version setiap entitas — atau pin caret, ^ diikuti versi seperti ^1.0.0, yang memilih versi tertinggi yang kompatibel dengannya. Pin yang bukan keduanya — caret yang teksnya tidak terbaca sebagai rentang versi, seperti ^garbage, atau pin eksak yang bukan versi semantik, seperti 1.x, 1.0 atau v1.0.0 — sama sekali tidak menamai versi apa pun, sehingga tidak ada katalog yang dapat memuat apa yang dimintanya.

Pin seperti itu dilaporkan sebagai salah bentuk, bukan sebagai entitas atau versi yang tidak dimuat katalog, sehingga diagnostik mengarahkan Anda ke teks yang Anda ketik alih-alih mencari sesuatu yang tidak ada. Kondisinya sama di mana pun pin ditulis: type sebuah komponen atau fitur, extends: milik Component atau Feature, kunci atau nilai pemetaan Manifest, spec.aggregate milik Release, implements: milik Recipe atau FeatureRecipe, versi yang di-pin oleh capability: milik Recipe saat plugin yang melayaninya dipilih, dan plugin: sebuah langkah pipeline.

Kondisi ini dilaporkan di tempat referensi yang gagal di-resolve dilaporkan, sehingga pin yang salah bentuk tidak pernah mengubah referensi mana yang ter-resolve — yang berubah adalah isi pesan kegagalannya. Pin yang bentuknya benar tetapi tidak dipenuhi oleh versi mana pun yang tersedia tetap mendapat kondisi yang dilaporkan permukaan tersebut untuknya: “No catalog version satisfies a version constraint (Tidak ada versi katalog yang memenuhi batasan versi)” di atas, atau kondisi tidak-ditemukan dari permukaan tempat pin itu ditulis.

Hanya teks setelah titik dua terakhir yang merupakan pin, dan hanya jika teks itu tidak memuat /. Karena itu, referensi ke host registry dengan port, seperti localhost:5000/core/api-server, tidak memuat pin — teks setelah titik dua port melanjutkan referensi — dan tidak pernah dilaporkan sebagai pin yang salah bentuk.

Pesan yang dikeluarkan, untuk pin caret pada tipe komponen:

reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (referensi memuat pin versi yang salah bentuk (referensi, pin, teks setelah ^ bukan rentang versi, direferensikan dari). tulis referensi sebagai nama, sebagai nama:versi dengan versi semantik seperti 1.0.0, atau sebagai nama:^versi untuk versi tertinggi yang kompatibel dengannya)

Pin eksak berbunyi an exact pin must be a semantic version sebagai pengganti klausa caret. Nilai setelahnya menyatakan di mana referensi ditulis, dalam kata-kata permukaan yang melaporkannya — referenced from dan lokasi yang ditulis, in the Release's spec.aggregate, atau in the recipe's spec.implements. Jika pemetaan Manifest dinilai terhadap implements: milik Recipe-nya, entri pemetaan dan sisi mana darinya yang memuat pin — in the mapping key atau in the recipe's spec.implements — muncul sebelum referensi, dan extends: milik Component atau Feature menamai entitas yang memperluas serta field sebelumnya.

Cara memperbaiki: tulis ulang pin dalam salah satu dari dua bentuk tersebut, atau hapus pin untuk memilih versi tertinggi yang tersedia. Wildcard seperti 1.x ditulis sebagai pin caret, ^1.0.0; versi dengan awalan v atau dengan kurang dari tiga angka ditulis lengkap, 1.0.0.

Every version a reference could select has been withdrawn (Setiap versi yang dapat dipilih sebuah referensi telah ditarik)

Sebuah referensi ter-resolve ke repositori yang dimuat registry, dan setiap versi yang dapat dipilih oleh penemuan dari repositori itu telah ditandai sebagai ditarik. Tidak ada lagi yang memenuhi syarat untuk dipilih.

Kondisi ini sengaja tidak dilaporkan sebagai entitas yang hilang. Repositorinya ada dan masih memuat versi-versi tersebut; menyebutnya tidak ada berarti menamai masalah yang salah, membuat Anda mencari salah ketik, dan terbaca seperti fallback diam-diam alih-alih penolakan yang sebenarnya. Pesan menamai setiap versi yang ditarik beserta alasan yang dicatat untuknya, sehingga yang disampaikan kepada Anda adalah apa yang dicatat oleh penerbit.

Menamai versi yang ditarik secara langsung bukanlah penghentian ini. Versi eksak sepenuhnya melewati penemuan, sehingga mem-pin versi tersebut adalah cara Anda dengan sengaja tetap menggunakannya; build melaporkan penarikan itu dan terus berjalan.

Pesan yang diemisikan:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (setiap versi terbitan yang dapat dipilih referensi ini telah ditarik: ditarik: (alasan yang dicatat))

Cara memperbaiki: baca alasan yang dicatat, yang biasanya menyebutkan ke mana harus berpindah. Migrasikan ke apa pun yang menggantikan entitas yang ditarik — itulah hasil yang diminta oleh sebuah penarikan. Jika Anda harus tetap memakai yang lama untuk sementara, pin versi eksak di dalam referensi: menamai versi itulah yang menyatakan bahwa Anda menerimanya, dan build kemudian melaporkan penarikan tersebut setiap kali alih-alih menolak.

A plugins.providers binding names a plugin that does not serve the capability (Binding plugins.providers menamai plugin yang tidak melayani kapabilitas tersebut)

Blok plugins.providers milik workspace memilih identitas plugin untuk sebuah kapabilitas, dan tidak ada Plugin perender provider yang melayani kapabilitas itu yang memiliki identitas tersebut. Binding adalah pilihan eksplisit yang tidak dapat dipenuhi katalog, sehingga build berhenti alih-alih diam-diam beralih ke plugin lain — fallback akan merender output Anda melalui plugin yang telah Anda nyatakan untuk tidak digunakan, tanpa memberi tahu apa pun.

Binding memilih berdasarkan identitas koordinat plugin — tipe plugin dan nama plugin, yang juga di-pin oleh lockfile — dan dapat memuat versi di belakangnya.

Binding dinilai terlepas dari apakah sebuah Recipe meminta kapabilitas tersebut. Di luar itu, binding hanya dibaca saat capability: milik Recipe menamainya, sehingga binding yang kapabilitasnya salah eja tidak akan dirujuk oleh apa pun dan tidak dilaporkan oleh apa pun. Karena itu, setiap build dan setiap aggrega validate --release memeriksa setiap binding yang menamai plugin: pull me-resolve binding seperti itu terlepas dari apakah sebuah Recipe menggunakannya, sehingga build memuat plugin tersebut dan mengetahui apa yang dilayaninya, dan kapabilitas yang tidak dilayani plugin itu pasti salah. Pemeriksaan ini membaca binding dalam konfigurasi workspace, bukan lockfile, dan tidak mengubah apa pun tentang plugin mana yang merender sebuah Recipe — hal itu tetap ditentukan lockfile. Binding yang menamai plugin yang tidak dimuat build — plugin registry yang belum diambil oleh pull mana pun — tidak dinilai hingga sebuah pull mengambilnya. Binding yang tidak menamai plugin dinilai secara berbeda, sebagai peringatan: lihat “A provider binding names a capability no plugin the build reads serves (Binding provider menamai kapabilitas yang tidak dilayani plugin mana pun yang dibaca build)” di bawah “Kondisi yang tidak menghentikan build” di bawah.

Pesan yang dikeluarkan, yang menambahkan apa yang benar-benar dilayani plugin yang dinamai, serta ejaan yang berjarak satu suntingan jika kapabilitas binding memang demikian:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (entri plugins.providers menamai plugin yang tidak cocok dengan plugin perender provider mana pun yang melayani kapabilitas tersebut: kapabilitas di-bind ke plugin, tetapi tidak ada plugin perender provider yang melayaninya yang cocok dengan identitas itu; plugin tersebut melayani kapabilitas lain, dan kapabilitas itu berjarak satu suntingan darinya)

Jika plugin yang dinamai binding tidak ada dalam katalog yang dibaca build, pesan berakhir setelah “matches that identity”, karena tidak ada yang dapat disampaikan tentang apa yang dilayaninya.

Cara memperbaiki: periksa terlebih dahulu ejaan binding terhadap koordinat plugin itu sendiri — binding yang menamai kapabilitas padahal seharusnya menamai plugin adalah kekeliruan yang umum. Jika pesan menamai kapabilitas yang berjarak satu suntingan dari yang Anda tulis, capability: milik binding itulah yang salah ketik. Lalu pastikan plugin ada dalam katalog yang dibaca build dan mencantumkan kapabilitas ini di bawah spec.provider.capabilities; plugin yang dulu melayani kapabilitas tersebut dan kini tidak lagi mendeklarasikannya menghasilkan pesan yang persis seperti ini. Menghapus binding adalah perbaikan yang tepat jika hanya satu plugin yang melayani kapabilitas itu, karena binding tersebut kemudian tidak memiliki apa pun untuk dibedakan.

No provider plugin version satisfies a Recipe’s provider pin (Tidak ada versi plugin provider yang memenuhi pin provider sebuah Recipe)

Sebuah Recipe mengikat provider yang versinya di-pin — helm:1.0.0, atau helm:^1.0.0 — dan tidak ada versi Plugin perender provider yang memenuhi pin tersebut. Pin adalah permintaan eksplisit, sehingga build berhenti alih-alih mengabaikannya dan merender melalui versi apa pun yang kebetulan melayani provider tersebut; mengesampingkan pin secara diam-diam akan menghasilkan keluaran yang menurut deklarasi penulisnya sendiri seharusnya tidak ada.

Dua situasi mengarah ke kondisi ini, dan pesannya membedakan keduanya: tidak ada yang melayani kapabilitas itu sama sekali, atau ada yang melayaninya tetapi tidak satu pun versinya memenuhi batasan.

Kondisi ini berbeda dari versi entitas yang tidak dapat dipenuhi di atas. Kondisi tersebut menyangkut entitas katalog yang disebut pada versi yang tidak dimiliki katalog; kondisi ini menyangkut pemilihan plugin yang merender sebuah kapabilitas.

Pesan yang dikeluarkan:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (tidak ada versi plugin perender provider yang memenuhi pin versi provider milik recipe: kapabilitas mem-pin versi tetapi tidak ada plugin perender provider yang melayaninya) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (tidak ada versi plugin perender provider yang memenuhi pin versi provider milik recipe: kapabilitas mem-pin versi tetapi tidak ada versi plugin pelayan yang memenuhinya)

Cara memperbaiki: perluas atau perbaiki pin pada field capability: milik Recipe, atau tambahkan versi plugin yang dimintanya ke katalog. Pin caret mencocokkan versi pada atau di atas batas bawahnya dalam versi mayor yang sama, sehingga pin ^2.0.0 tidak dipenuhi oleh plugin 1.x seberapa pun barunya. Jika pesan menyatakan tidak ada yang melayani kapabilitas tersebut, pin bukanlah masalahnya: plugin tersebut sama sekali tidak ada, dan menghapus pin tidak akan membantu.

No plugin advertises a requested parse or import format (Tidak ada plugin yang mengiklankan format parse atau impor yang diminta)

Sebuah format diminta dan tidak ada plugin yang mengiklankannya. Dua soket yang merutekan berdasarkan format masing-masing memiliki kondisinya sendiri, dan keduanya hanya berbeda dalam pekerjaan yang diminta: plugin parser membaca format sumber asing, dan plugin importer memasukkan konten asing sebagai entitas Aggrega.

Ruang format bersifat terbuka dan sepenuhnya milik plugin. Tidak satu pun soket menyimpan daftar format yang dikenal compiler: plugin mendeklarasikan format yang ditanganinya sebagai kapabilitas, dan format baru dirilis sebagai plugin baru tanpa perubahan pada compiler. Karena itu, penghentian ini melaporkan himpunan yang diiklankan sebagaimana adanya, bukan enumerasi tetap, dan setiap kegagalan pencocokan dilaporkan dengan jelas: permintaan tersebut memiliki pengiklan atau tidak dapat dipenuhi. Tidak ada yang menggantikan plugin yang hilang, dengan satu pengecualian berupa parser yang dibawa compiler, yang dijelaskan di bawah.

Pesan yang dikeluarkan:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (tidak ada plugin parser yang mengiklankan format yang diminta: tidak ada plugin parser yang mengiklankannya) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (tidak ada plugin importer yang mengiklankan format yang diminta: tidak ada plugin importer yang mengiklankannya)

Satu plugin parser yang mengiklankan format tersebut tetapi membawa bentuk versi yang tidak dapat di-resolve diperlakukan sebagai tidak ada pengiklan, bukan sebagai lolos secara diam-diam, dan pesannya menyatakan hal itu:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (tidak ada plugin parser yang mengiklankan format yang diminta: tidak ada versi plugin parser yang ter-resolve untuknya)

Parse beralih ke parser yang dibawa compiler. Build mem-parse setiap berkas yang diserahkannya ke kebijakan render-verdict dalam format yang tidak dibaca secara native oleh kebijakan tersebut, importer membaca sumbernya melalui parser untuk sintaks yang disebutnya, dan impor yang tidak menyebut format mem-parse sumber dalam sintaks yang disebut setiap signature yang berlaku. Untuk setiap sintaks, digunakan parser yang dilayani katalog workspace, dan, jika katalog tidak melayani satu pun, parser yang dibawa compiler sendiri untuk sintaks tersebut — termasuk parser HCL yang dipakai build untuk membaca keluaran Terraform dan parser JSON yang dipakai importer inti compiler untuk membaca, sehingga baik kebijakan atas keluaran Terraform maupun impor melalui importer inti tidak memerlukan parser di katalog. Jika katalog memang melayani parser untuk suatu sintaks, parser milik compiler tidak berperan, dan dua parser dengan nama berbeda di katalog ditolak sebagaimana dijelaskan dalam A parse or import format is advertised by more than one plugin (Format parse atau impor diiklankan oleh lebih dari satu plugin). Jadi, penghentian ini menyebut sintaks yang parsernya tidak dilayani baik oleh katalog maupun compiler.

Cara memperbaiki: pastikan format dieja sebagaimana plugin mengiklankannya — kapabilitas adalah prefiks soket dan nama format, sehingga plugin yang mengiklankan parse:hcl melayani format hcl dan tidak ada yang lain. Lalu pastikan plugin tersebut ada di katalog yang dibaca build. Jika tidak ada plugin untuk format tersebut, plugin itulah bagian yang hilang; compiler tidak dapat membaca format yang tidak diiklankan oleh apa pun.

A parse or import format is advertised by more than one plugin (Format parse atau impor diiklankan oleh lebih dari satu plugin)

Dua plugin berbeda atau lebih mengiklankan format yang sama, dan permintaan tidak dapat dirutekan tanpa menebak plugin mana yang harus digunakan.

Katalog yang memuat keduanya sah dan dimuat tanpa keluhan. Dua penerbit masing-masing dapat merilis parser atau importer untuk satu format, dan menggabungkan katalog mereka adalah hal yang didukung. Ambiguitas ini adalah kondisi pada titik penggunaan: build berhenti ketika format yang diperebutkan benar-benar diminta, sehingga pasangan yang bersaing di luar jangkauan build tidak pernah memblokirnya.

Setiap kandidat disebutkan, secara terurut, sehingga pesannya sama pada setiap eksekusi.

Pesan yang dikeluarkan:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (format diiklankan oleh lebih dari satu plugin parser: format diiklankan oleh beberapa plugin parser) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (format diiklankan oleh lebih dari satu plugin importer: format diiklankan oleh beberapa plugin importer)

Untuk importer, penghentian ini muncul dalam satu bentuk lagi: entri plugins.importer milik workspace melampirkan lebih dari satu importer yang mengiklankan format tersebut, dan importer yang disebutkan kemudian adalah yang dilampirkan.

Importer yang menjadi pilihan sebuah impor adalah importer di katalog workspace dan importer inti compiler, yang mengiklankan formatnya di setiap workspace. Jadi, katalog yang memuat importer sendiri dengan nama lain untuk format yang dilayani importer inti — import:langflow atau import:flowise — mengalami penghentian ini pada impor yang tidak melampirkan keduanya, dan pesannya menyebut importer inti di samping importer milik katalog. Importer yang dimuat katalog dengan nama importer inti itu sendiri bukanlah pengiklan kedua: dalam satu nama, versi tertinggi yang dipilih, dan importer pada versi importer inti itu sendiri, dengan modulnya di sampingnya, dijalankan menggantikannya. Importer tanpa modul di sampingnya bukanlah kandidat jika ada importer bernama sama yang dapat dijalankan yang mengiklankan format tersebut, sebagaimana dijelaskan dalam Mana yang dijalankan di samping importer Anda sendiri.

Cara memperbaiki: untuk importer, pertahankan keduanya di katalog — atau pertahankan milik Anda di samping importer inti — dan lampirkan yang Anda inginkan — entri plugins.importer yang uri-nya menyebutnya berdasarkan identitas dan versinya, uri: importer/<name>:<version>, sebagaimana ditulis oleh aggrega plugin add importer. Importer yang dilampirkan dipilih di antara yang mengiklankan format tersebut, sebagaimana entri plugins.providers memilih di antara plugin yang melayani kapabilitas pada soket provider, yang dijelaskan dalam “A capability is served by more than one provider plugin (Kapabilitas dilayani oleh lebih dari satu plugin provider)” di bawah. Jika importer yang disebutkan adalah yang dilampirkan oleh entri Anda, pertahankan entri untuk yang Anda inginkan dan hapus yang lain. Soket parse tidak memiliki pemilihan semacam itu, sehingga untuk parser, solusinya adalah mempersempit katalog yang dibaca build agar hanya plugin yang Anda inginkan yang ada di dalamnya — mengarahkan --catalog ke direktori yang memuat pilihan Anda adalah cara langsungnya.

Entri plugins.importer mematok versi importer-nya yang tidak dimiliki katalog

Entri plugins.importer melampirkan sebuah importer berdasarkan identitas dan versinya — versi yang persis, uri: importer/<name>:1.2.0, atau sebuah rentang, uri: importer/<name>:^1.2.0 — dan importer tersebut mengiklankan format yang diminta impor, tetapi tidak ada versinya yang menjadi pilihan impor yang memenuhi patokan tersebut — yaitu versi-versi yang dimiliki katalog workspace, dan untuk core importer juga versi milik kompiler sendiri: versi yang persis tidak ada, atau tidak satu pun versinya berada dalam rentang. Versi tersebut adalah pilihan eksplisit, sehingga impor ditolak sebelum importer mana pun dijalankan, alih-alih menjalankan versi lain dari importer tersebut sebagai gantinya.

Hal ini berbeda dari kondisi tidak ada importer yang mengiklankan format, yang dijelaskan di atas: di sini importer tersebut termasuk pilihan impor dan mengiklankan format itu, dan hanya versi yang disebut entri yang tidak ada. Patokan yang tidak berbentuk salah satu bentuk patokan versi, seperti :latest, dilaporkan sebagai malformasi, sebagaimana dijelaskan dalam “A version pin is none of the forms a pin takes (Patokan versi tidak berbentuk salah satu bentuk patokan)”.

Pesan yang dikeluarkan, menyebutkan kapabilitas format dan versi yang dipatok entri:

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it (tidak ada versi plugin importer yang memenuhi patokan versi entri plugins.importer: kapabilitas memat0k versi, tetapi tidak ada versi plugin penyedia yang memenuhinya)

Cara memperbaiki: ubah versi pada uri entri menjadi versi yang dimiliki katalog — untuk core importer, versi milik kompiler sendiri juga termasuk — atau perluas rentangnya, atau tambahkan versi yang disebut entri ke katalog. Rentang caret mencocokkan versi pada atau di atas batas bawahnya dalam major yang sama, sehingga ^2.0.0 tidak terpenuhi oleh importer 1.x betapapun barunya.

Referensi plugin memuat host registry atau path artefak

Referensi Plugin diawali dengan segmen berbentuk host registry — segmen yang berisi titik atau titik dua, seperti nama DNS atau host-dan-port — atau dengan path artefak. Plugin dialamatkan melalui identitas koordinat-nya: tipe plugin, garis miring, namanya, dan secara opsional versi. Proses pull mengikat identitas tersebut ke lokasi fisik dengan menambahkan awalan registry yang dikonfigurasi dan path plugin itu sendiri, sehingga referensi yang sudah memuatnya akan diberi awalan dua kali dan terikat ke lokasi yang tidak dapat diambil.

Referensi ini ditolak di tempat lokasi dibentuk, bukan saat pengambilan, sehingga pesan menyebutkan apa yang Anda tulis alih-alih muncul kemudian sebagai galat tag yang tidak terbaca.

Pesan yang dikeluarkan, dibingkai oleh pull yang sedang membentuk lokasi, dengan solusi pada baris di bawahnya:

catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" (katalog: pull tier-3: referensi plugin wasm harus berupa identitas koordinat plugin, bukan path yang dikualifikasi registry atau path artefak) remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice (solusi: hapus host registry dan path artefak, sisakan koordinatnya saja; pull menambahkan sendiri awalan registry yang dikonfigurasi, sehingga referensi yang sudah memuatnya diberi awalan dua kali)

Cara memperbaiki: hapus semua yang berada sebelum tipe plugin, sisakan koordinatnya saja — provider/helm:1.0.0, bukan hub.example.com/plugin/provider/helm:1.0.0. Registry tempat build melakukan pull adalah konfigurasi workspace, bukan bagian dari identitas, dan itulah yang memungkinkan satu katalog disajikan dari lebih dari satu registry tanpa mengedit entitas di dalamnya.

Referensi plugin atau recipe tidak memuat scope

Referensi Plugin atau Recipe tidak memiliki segmen scope di depannya — tidak ada garis miring sama sekali, atau segmen kosong sebelum garis miring, seperti pada /name. Kedua jenis tersebut diidentifikasi oleh dua bagian, dan bagian pertama itulah yang membedakan dua entitas bernama sama: Plugin melalui tipe plugin dan namanya, Recipe melalui provider dan namanya. Dua socket masing-masing dapat memiliki plugin bernama redact, dan dua provider masing-masing dapat merilis recipe bernama postgres, sehingga scope merupakan bagian dari identitas, bukan hiasan padanya.

Lokasi yang dibangun dari scope kosong memuat segmen path kosong — garis miring ganda — yang tidak dapat di-resolve, sehingga referensi ditolak di tempat lokasi dibentuk alih-alih dibiarkan gagal kemudian sebagai pengambilan yang tidak terbaca.

Kedua solusi tersebut merupakan kebalikan dari kasus plugin terkualifikasi di atas dan kebalikan satu sama lain, itulah sebabnya masing-masing dirumuskan tersendiri: di sini referensi kekurangan satu segmen dan Anda menambahkannya, sedangkan referensi terkualifikasi memuat satu segmen tambahan dan Anda menghapusnya.

Pesan yang dikeluarkan, masing-masing dibingkai oleh pull dan memuat solusinya sendiri di bawahnya:

catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" (katalog: pull tier-3: referensi plugin wasm harus memuat scope pluginType; scope kosong tidak dapat terikat ke lokasi OCI) remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType (solusi: tambahkan segmen pluginType yang hilang, dengan menggunakan pluginType yang dideklarasikan entitas plugin)

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (katalog: pull tier-3: referensi recipe harus memiliki scope provider; provider kosong tidak dapat terikat ke lokasi OCI) remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable) (solusi: tidak ada direktori katalog lokal yang memuat referensi ini, sehingga referensi dicari di registry, tempat segmen provider diwajibkan; jalankan ulang agar direktori yang memuatnya dicari terlebih dahulu; opsi tersebut dapat diulang)

Cara memperbaiki: untuk plugin, tambahkan awalan tipe plugin yang dideklarasikan entitas Plugin di bawah metadata.pluginType. Untuk recipe, tambahkan awalan provider yang dideklarasikan Recipe di bawah spec.capability. Solusi untuk recipe menyebutkan kemungkinan kedua yang patut dibaca: sampainya pencarian ke registry berarti direktori katalog lokal telah dicari terlebih dahulu dan tidak ada yang memuat referensi tersebut, sehingga jika recipe dimaksudkan berasal dari direktori lokal, arahkan build ke direktori tersebut alih-alih menambahkan scope.

The build consumes an artifact its publisher has deprecated (Build menggunakan artefak yang telah dinyatakan usang oleh penerbitnya)

Sebuah referensi yang di-resolve oleh build ini membawa penanda deprecation yang dicatat oleh penerbitnya, dan tingkat keparahan penanda tersebut sama dengan atau melebihi tingkat keparahan yang dikonfigurasi oleh workspace sebagai ambang penghentiannya. Penanda dilampirkan pada artefak yang telah diterbitkan setelah penerbitan, sehingga artefak yang kemarin berhasil di-build dapat membawa penanda hari ini tanpa ada perubahan apa pun dalam berkas Anda sendiri.

Pelaporan dan penghentian adalah dua hal terpisah, dan hanya penghentian yang dapat dikonfigurasi. Setiap penanda yang tercatat dilaporkan, pada setiap tingkat keparahan, dan tidak ada konfigurasi yang dapat membungkamnya. Apakah sebuah penanda juga menghentikan build ditentukan oleh halt_on_deprecated_severity, yang membandingkan tingkat keparahan yang tercatat dengan ambang yang dikonfigurasi dalam urutan warning < error < retracted. Jika tidak ada ambang yang dikonfigurasi, tidak ada yang menghentikan build dan setiap penanda hanya bersifat anjuran. Tingkat keparahan di luar ketiganya, atau ambang di luar ketiganya, tidak pernah terpenuhi: nilai yang salah bentuk tidak dapat menyebabkan penghentian maupun menekannya.

Setiap pemberitahuan dicetak sebelum build berhenti, bukan hanya yang menyebabkan penghentian, sehingga menaikkan ambang tidak pernah membuat Anda kehilangan satu temuan pun — penghentian itu sendiri menyebutkan satu referensi tempat build berhenti. Temuan diurutkan berdasarkan referensi, sehingga lockfile yang sama melaporkan urutan yang sama pada setiap eksekusi dan temuan yang menghentikan build selalu sama.

Dua penyimpanan diperiksa dan keduanya melaporkan dengan cara yang sama: referensi yang di-pin oleh lockfile, dan plugin yang dicatat sebagai tepercaya untuk putusan terima-atau-tolak. Kedua pemeriksaan tidak menjangkau registry — keduanya membaca apa yang sudah tercatat — sehingga build tetap ahead-of-time.

Pesan yang dikeluarkan. Setiap temuan dicetak saat ditelusuri, lalu penghentian mengulangi temuan yang memenuhi ambang dan menyebutkan pengaturan yang menghentikan build:

deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)

deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error" (deprecation: build menggunakan entitas yang usang: ditarik: (dicatat dalam lockfile saat pull, per; jalankan ulang untuk memperbaruinya): halt_on_deprecated_severity adalah)

Penanda pada salah satu dari dua tingkat keparahan anjuran dinyatakan sebagai deprecated (warning) atau deprecated (error) sebagai pengganti retracted. Pembedaan ini dipertahankan karena keduanya berarti hal yang berbeda — tidak dianjurkan tetapi masih dapat dipilih, dibandingkan dikecualikan dari pemilihan — dan melaporkan yang lebih kuat sebagai yang lebih lemah akan mengecilkan apa yang terjadi.

Cara memperbaiki: baca pesan yang tercatat, yang merupakan penjelasan penerbit sendiri tentang ke mana harus berpindah, lalu lakukan migrasi. Jika Anda belum dapat bermigrasi, menaikkan halt_on_deprecated_severity — atau menghapus pengaturannya — mengubah penghentian kembali menjadi anjuran yang tetap Anda lihat; itu adalah penerimaan yang disengaja, bukan solusi sementara, dan pemberitahuan tetap dicetak. Penanda yang dicatat untuk versi yang tidak lagi Anda gunakan akan hilang saat lockfile diperbarui dengan aggrega pull.

A trusted plugin’s recorded digest disagrees with the cached artifact (Digest tercatat milik plugin tepercaya tidak sesuai dengan artefak di cache)

Sebuah plugin yang dilampirkan dalam peran yang menerima atau menolak build memiliki digest yang dicatat sebagai tepercaya untuknya, dan manifest plugin di cache melaporkan digest yang berbeda. Keduanya dibandingkan sebelum berkas eksekusi plugin dibaca, dan ketidaksesuaian menghentikan resolusi di titik itu.

Perbandingan inilah yang menjadikan digest tercatat sebagai otoritas, bukan sekadar pengulangan. Tanpa perbandingan ini, byte plugin hanya diperiksa terhadap pin yang diturunkan dari manifest yang byte-nya kemudian divalidasi oleh pin itu sendiri — konsisten dengan dirinya sendiri secara konstruksi, dan tidak mampu menyadari bahwa seluruh artefak telah diganti. Membandingkan apa yang tercatat dengan apa yang kini dilaporkan manifest itulah yang memberi pemeriksaan tersebut pandangan dari luar.

Hal ini berbeda dari ketidaksesuaian digest konten, yang melaporkan byte hasil resolusi tidak sesuai dengan digest yang diklaim untuknya. Di sini belum ada yang dibaca, dan byte-nya mungkin saja sesuai dengan manifest; yang tidak sesuai adalah artefak mana yang sebenarnya sedang di-resolve. Memisahkan keduanya penting karena cara perbaikannya berlawanan — yang satu adalah artefak yang rusak atau dimanipulasi, yang lain adalah plugin yang berubah secara sah dan identitas barunya belum ditinjau.

Pesan yang diemisikan:

resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports (resolve plugin di cache: digest yang dicatat sebagai tepercaya untuknya adalah, tetapi manifest plugin di cache konten melaporkan; tinjau apa yang berubah dan catat ulang digest tepercaya, atau pulihkan artefak yang tercatat: digest yang dicatat sebagai tepercaya untuk plugin ini tidak sesuai dengan digest yang dilaporkan manifest di cache-nya)

Cara memperbaiki: cari tahu apa yang berubah sebelum Anda mencatat ulang apa pun — ini adalah plugin yang dapat menolak build Anda, dan digest yang tercatat adalah pernyataan bahwa seseorang telah memeriksanya. Jika perubahan itu memang diharapkan, karena Anda sengaja meningkatkan versi plugin, tinjau artefak baru dan catat ulang digest tepercaya untuknya. Jika tidak diharapkan, pulihkan artefak yang disebutkan oleh catatan; ketidaksesuaian ini memberi tahu Anda bahwa identitasnya berpindah tanpa ada yang memutuskannya.

Rantai extends: tidak dapat disusun

Rantai extends: milik sebuah Component, Feature, Manifest, atau Release menyebut induk yang tidak dapat di-resolve, sehingga rantai tersebut tidak dapat diubah menjadi satu entitas yang telah di-resolve.

Kondisi ini berbeda dari siklus, yang memiliki kondisi dan solusinya sendiri — lihat “Cyclic extends chain” di atas; dari rantai yang melampaui batas kedalaman, yang memiliki kondisinya sendiri di bawah; dan dari pin versi yang tidak dapat dipenuhi, ketika induknya ada dan hanya versinya yang tidak ada.

Pesan yang dikeluarkan, yang menyebut entitas yang memuat extends: yang tidak dapat di-resolve dan referensi yang dideklarasikannya:

inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (penggabungan pewarisan gagal (Component, entitas memperluas referensi yang tidak disediakan oleh entitas katalog mana pun). Pastikan referensi extends menyebut entitas yang ada di katalog)

Jika pemeriksaan yang melaporkannya membaca induk dari cache artefak di bawah pin lockfile — pemeriksaan extends pada build dan pada aggrega validate --release, aggrega validate atas seluruh katalog, dan aggrega inspect, serta pemeriksaan yang sama yang dijalankan dari editor dan alat validate milik asisten — saran tersebut berlanjut dengan menyebut pull: “a base published to a registry is fetched by aggrega pull --release <release>” (basis yang dipublikasikan ke registry diambil dengan perintah yang ditunjukkan). Memvalidasi satu file entitas tidak membaca lockfile, sehingga pull tidak akan mengubah apa pun yang dibacanya, dan pesannya berhenti pada katalog.

Feature muncul sebagai ganti Component ketika rantai sebuah Feature yang gagal. Seperti pada loop, entitas yang disebut pertama adalah entitas tempat resolusi dimulai, dan entitas yang disebut dalam edge adalah entitas yang baris extends:-nya perlu dibuka; pada rantai bertingkat banyak, keduanya berbeda.

extends: sebuah Manifest dijawab terhadap tempat yang berbeda, sehingga dijawab dengan saran yang berbeda. Manifest adalah konfigurasi operator yang ditulis di samping Release, bukan konten katalog, dan extends:-nya menyebut file berpath relatif atau metadata.name dari sebuah Manifest di direktori Release itu sendiri — tidak pernah entitas katalog. Karena itu, pesannya diakhiri dengan hasil kegagalan resolusi referensi tersebut dan tempat yang sebaiknya diperiksa:

inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (penggabungan pewarisan gagal (Manifest, entitas memperluas referensi yang tidak dapat di-resolve). Pastikan referensi extends adalah path relatif atau nama sebuah Manifest di direktori Release)

Detail di bagian akhir itu adalah kegagalan yang dilaporkan oleh pencarian itu sendiri — file yang tidak dapat dibaca, atau pemindaian yang tidak mengindeks Manifest dengan nama tersebut — sehingga biasanya detail ini menunjukkan bentuk mana yang dicoba dan mengapa hasilnya kosong.

extends: sebuah Release dijawab terhadap sebuah direktori, dan hanya menerima satu bentuk. Release menyebut induknya sebagai path relatif — ./base-release.yaml, atau ../shared/base-release.yaml. Direktori yang menjadi acuan adalah direktori yang memuat Release yang menulis referensi tersebut, dan setiap tautan di sepanjang rantai dijawab terhadap direktorinya sendiri — sehingga Release di tengah rantai yang disimpan di subdirektori menyebut induk di sampingnya sendiri, di mana pun Release yang disebut oleh perintah berada. Token polos bukan path dan tidak menyebut Release yang akan dicari oleh compiler, sehingga token tersebut dilaporkan di sini alih-alih dicari di tempat yang tidak mungkin ditemukan:

inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (penggabungan pewarisan gagal (Release, entitas memperluas referensi yang tidak dapat di-resolve). Pastikan referensi extends adalah path relatif ke file Release, seperti ./base-release.yaml, yang di-resolve dari direktori yang memuat Release ini)

Cara memperbaiki: untuk Component atau Feature, pastikan nilai extends: menyebut entitas yang ada di katalog, dieja persis seperti metadata.name entitas tersebut — termasuk huruf besar-kecilnya. Basis yang dipublikasikan ke registry dibaca dari cache artefak di bawah pin yang dicatat lockfile Release untuknya, jadi jika basis berada di registry, jalankan aggrega pull --release <release>: pull mengikuti rantai, mengambil basis, dan mem-pin-nya. Untuk Manifest, pastikan file berada di tempat yang ditunjuk oleh path relatif, atau bahwa Manifest dengan metadata.name tersebut berada di direktori Release dan dapat di-parse. Untuk Release, pastikan nilainya diawali ./ atau ../ dan file yang ditunjuknya ada serta dapat di-parse sebagai Release.

Rantai extends: melampaui batas kedalaman

Rantai extends: milik sebuah Component, Feature, Manifest, atau Release berakhir dengan benar tetapi melewati lebih banyak entitas daripada batas sepuluh yang diizinkan.

Kondisi ini memiliki kondisinya sendiri alih-alih berbagi dengan kondisi di atas, karena kedua solusinya tidak memiliki kesamaan: induk yang tidak ada adalah referensi yang perlu dikoreksi, sedangkan rantai yang terlalu dalam adalah bentuk yang perlu diratakan. Batas ini adalah pengaman terhadap kekeliruan penulisan, bukan batas struktural — arsitek biasanya memperluas baseline satu atau dua tingkat, dan rantai sedalam sepuluh biasanya merupakan pohon dasar yang terus tumbuh, bukan desain yang disengaja.

Hanya rantai yang BERAKHIR yang mencapainya. Rantai yang berputar kembali ke dirinya sendiri dilaporkan sebagai loop berapa pun panjangnya, sehingga kondisi ini tidak pernah menggantikan siklus dan sarannya — perpendek rantai — tidak pernah diberikan untuk siklus.

Pesan yang dikeluarkan, yang menyebut batas dan panjang yang dicapai rantai:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (rantai extends melampaui kedalaman maksimum (Component, aturan extends). batasnya 10 dan rantai ini mencapai panjang tersebut; perpendek rantai, atau perluas basis yang lebih dekat ke akarnya)

Feature, Manifest, atau Release muncul sebagai ganti Component ketika salah satu rantai tersebut yang gagal. Batasnya sama, yaitu sepuluh, untuk setiap jenis yang mendeklarasikan extends, dan yang dihitung adalah entitas pada rantai, bukan tautan di antaranya: rantai dengan tepat sepuluh entitas berhasil di-build, dan entitas kesebelas itulah yang dilaporkan. Jadi, entitas yang memperluas basis yang memperluas basis lain — tiga entitas, dua tautan — telah mencapai tiga.

Cara memperbaiki: ciutkan bagian tengah rantai. Rantai sedalam itu biasanya berarti setiap tingkat hanya menambahkan sedikit, dan menggabungkan beberapa tingkat menjadi satu entitas basis adalah perbaikan sekaligus bentuk yang lebih jelas. Jika tingkat-tingkat tersebut memang berbeda, entitas yang lebih jauh di rantai dapat langsung memperluas basis yang lebih dekat ke akar alih-alih mewarisi melalui setiap tingkat di antaranya. Rantai Manifest sedalam itu biasanya merupakan tumpukan overlay per lingkungan — gabungkan tingkat yang tidak pernah divariasikan ke dalam basis yang di-overlay-nya.

Nama asersi dideklarasikan dua kali di sepanjang rantai extends:

Sebuah entitas dan sesuatu yang diperluasnya sama-sama mendeklarasikan asersi dengan nama yang sama, dan keduanya mendeklarasikan aturan yang berbeda. Asersi entitas yang memperluas menambah asersi basisnya; asersi tersebut tidak pernah menggantikannya. Jadi, nama yang dideklarasikan dua kali dengan dua aturan berbeda akan diam-diam menghapus invarian basis, yang merupakan kebalikan dari tujuan memperluas sebuah entitas.

Mendeklarasikan nama yang sama dengan aturan yang identik bukanlah tabrakan dan berhasil di-build. Itulah yang menjaga pemeriksaan tetap idempoten di sepanjang rantai: tanpanya, rantai sedalam tiga akan selalu bertabrakan dengan tingkat tengahnya sendiri.

Urutan adalah bagian dari kontrak, bukan kebetulan. Asersi dievaluasi dalam urutan hasil penggabungan dan asersi pertama yang gagal akan menghentikan proses, sehingga invarian basis diperiksa sebelum invarian turunannya, dan di sepanjang rantai himpunannya terakumulasi dari akar ke bawah.

Pesan yang diemisikan:

assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (nama asersi dideklarasikan dua kali di sepanjang rantai extends (Component, aturan assertions). asersi tersebut sudah dideklarasikan oleh Component basis, dengan aturan yang berbeda; ganti nama asersi entitas yang memperluas; asersi entitas yang memperluas menambah asersi basis dan tidak pernah menggantikannya)

Cara memperbaiki: ganti nama asersi entitas yang memperluas, yang disebut dalam pesan bersama basis yang sudah mendeklarasikannya. Jika Anda bermaksud menggantikan aturan basis, hal itu tidak didukung oleh mekanisme perluasan — persempit asersi basis agar berlaku untuk setiap entitas yang memperluasnya, atau pindahkan aturan ke entitas yang benar-benar membutuhkannya. Jika kedua aturan dimaksudkan sama, buat keduanya identik secara tekstual dan tabrakan akan hilang.

Sebuah Release merutekan komponen-komponen Aggregate-nya dengan salah satu dari dua cara: boundary bernama di bawah boundaries:, atau komponen tingkat atas di bawah components:. Keduanya saling eksklusif, dan satu dokumen yang mendeklarasikan keduanya ditolak saat dibaca. Kondisi ini adalah aturan yang sama di sepanjang rantai extends:: base yang mendeklarasikan boundary bernama dan child yang mendeklarasikan komponen tingkat atas masing-masing terbentuk dengan benar, dan barulah penggabungan keduanya yang membawa kedua pilihan itu ke dalam satu Release yang telah di-resolve.

Tidak ada dokumen yang salah dengan sendirinya, itulah sebabnya pesan menyebutkan kedua dokumen dan kedua kuncinya. Diagnostik yang hanya menyebutkan Release yang dituju build akan mengarahkan Anda ke berkas yang tidak bermasalah.

Rantai yang tautannya sepakat tidak terpengaruh. Setiap tautan yang mendeklarasikan boundary bernama tersusun secara normal, demikian pula setiap tautan yang mendeklarasikan komponen tingkat atas. Campuran keduanyalah yang menghentikannya.

Pesan yang dikeluarkan, yang menyebutkan kedua berkas dan kunci yang dideklarasikan masing-masing:

release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (rantai extends release menyusun boundary bernama sekaligus komponen tingkat atas: deklarasikan satu bentuk routing di sepanjang rantai, jangan keduanya; file Release, file yang mendeklarasikan boundary, dan file yang mendeklarasikan komponen disebutkan)

Cara memperbaiki: pilih bentuk routing yang harus digunakan rantai dan tuliskan secara konsisten di seluruh rantai. Jika base mendeklarasikan boundary bernama, child yang ingin mengonfigurasi komponen menyasarnya di dalam boundary yang memuatnya, bukan di root Release — yang juga memungkinkannya mengubah ukuran satu komponen tanpa menyatakan ulang topologinya. Jika base mendeklarasikan komponen tingkat atas, child yang memerlukan boundary bernama sedang mendeskripsikan bentuk routing yang berbeda dari base-nya, dan lebih baik ditulis sebagai Release tersendiri daripada sebagai child dari Release tersebut.

An external input’s URL uses a scheme that is not allowed (URL input eksternal menggunakan skema yang tidak diizinkan)

URL yang dirujuk oleh sebuah entitas menggunakan skema di luar himpunan yang diizinkan. Tiga skema diizinkan: https; http, tetapi hanya ke host loopback, sehingga teks polos hanya dapat mencapai mesin lokal; dan oci, untuk konten yang ditarik dari registry.

Pesan yang dikeluarkan, untuk URL http non-loopback dan untuk skema lain apa pun:

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (http polos hanya diizinkan untuk host loopback (skema yang diizinkan: https, http ke host loopback, oci): skema URL tidak diizinkan) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (skema tidak diizinkan (skema yang diizinkan: https, http ke host loopback, oci): skema URL tidak diizinkan)

Cara memperbaiki: ubah URL ke https, atau ke oci jika konten dipublikasikan di registry. URL http polos ke host jarak jauh ditolak, bukan diturunkan, sehingga mengarahkannya ke skema yang aman adalah perbaikannya; server pengembangan lokal tetap berfungsi melalui http karena host loopback diizinkan.

A render requests an external input the lockfile does not pin (Render meminta input eksternal yang tidak di-pin oleh lockfile)

Sesuatu yang dibutuhkan build diambil dari URL yang tidak di-pin oleh lockfile. Build me-render closure yang dicatat lockfile-nya dan tidak mengambil apa pun, sehingga tidak ada pengaturan yang memungkinkan proses ini memperoleh URL tersebut: closure yang dibekukan itulah yang membuat build dapat direproduksi, dan diam-diam memperluas himpunan input adalah satu hal yang tidak boleh dilakukannya.

Oleh karena itu, mencapai penghentian ini bersifat informatif, bukan kesalahan konfigurasi. Pin sudah lengkap ketika Release di-resolve, sehingga URL yang tidak di-pin sekarang berarti ada sesuatu yang berubah sejak saat itu — nilai yang mengarahkan referensi mana yang diminta render, chart yang mulai menunjuk ke tempat baru, atau lockfile yang di-resolve terhadap Release yang berbeda.

Pesan yang diemisikan:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (tidak di-pin dalam lockfile; jalankan perintah tersebut untuk mem-pin setiap input eksternal yang dikonsumsi render Release ini, lalu build lagi: pengambilan dinonaktifkan untuk input yang tidak di-pin)

Cara memperbaiki: pin input tersebut. aggrega pull --release <path> me-render Release untuk mengetahui input eksternal mana yang dikonsumsinya, mengambil masing-masing, dan mencatat digest-nya di lockfile di samping pin dependensi — setelah itu setiap build berikutnya menyajikannya dari catatan yang di-pin dan sama sekali tidak memerlukan jaringan. Jika URL tersebut baru karena sesuatu yang Anda tulis mulai menunjuk ke sana, me-resolve Release lagi adalah langkah yang terlewat; jika URL itu tidak terduga, referensi yang memperkenalkannya layak ditemukan sebelum Anda mem-pin-nya.

Fetched bytes do not match a pinned digest (Byte yang diambil tidak cocok dengan digest yang di-pin)

URL yang di-pin diambil lagi — karena salinan tersimpannya hilang — dan yang kembali bukan yang di-pin oleh lockfile. Digest yang tercatat selalu menang: tidak ada yang ditulis ke store, dan tidak ada byte yang dikembalikan.

Pengisian ulang diambil berdasarkan digest yang tercatat, bukan berdasarkan tag URL, sehingga tag yang telah dipindahkan untuk menunjuk ke konten berbeda tidak dapat mengubah apa yang disajikan entri yang di-pin. Oleh karena itu, mencapai penghentian ini berarti konten di balik digest itu sendiri gagal kembali secara utuh.

Pesan yang dikeluarkan, untuk konten yang ditarik dari registry dan untuk konten yang diambil melalui HTTPS:

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (digest manifest hasil pengisian ulang berbeda dari digest yang di-pin: byte yang diambil tidak cocok dengan digest yang di-pin) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (hash byte yang diambil ulang berbeda dari digest yang di-pin: byte yang diambil tidak cocok dengan digest yang di-pin)

Cara memperbaiki: perlakukan ini terlebih dahulu sebagai pertanyaan rantai pasok, bukan lockfile yang perlu diperbarui — pin adalah pernyataan bahwa byte persis inilah yang Anda gunakan untuk build, dan penolakan ini adalah pernyataan tersebut yang ditegakkan. Pastikan sumber masih memublikasikan konten yang dinamai digest, dan periksa apakah ada sesuatu di antara Anda dan sumber yang menulis ulang respons; proxy atau mirror yang menyajikan pengganti adalah penyebab umum. Hanya setelah Anda mengetahui apa yang berubah dan menerimanya, lakukan pin ulang dengan aggrega pull, yang mencatat digest baru.

A stored external input no longer matches its record (Input eksternal yang tersimpan tidak lagi cocok dengan catatannya)

Input yang di-pin dibaca kembali dari store lokal dan tidak cocok dengan catatan yang di-pin untuknya. Pemeriksaan berjalan pada setiap pembacaan, sebelum byte disajikan, sehingga store yang rusak atau dirusak dengan sengaja terlihat pada saat digunakan, bukan diam-diam memasok build.

Apa yang dibandingkan bergantung pada cara input di-pin. Konten yang diambil melalui HTTPS di-pin dengan meng-hash payload, sehingga di-hash ulang pada setiap pembacaan dan kedua digest dilaporkan. Konten yang ditarik dari registry di-pin dengan digest manifest-nya, yang mengikat payload melalui manifest milik registry, bukan dengan meng-hash-nya secara langsung, sehingga salinan tersimpan diperiksa terhadap ukuran yang tercatat — verifikasi digest penuh berlabuh pada saat pengambilan dan pada setiap pengisian ulang yang dialamatkan dengan digest.

Pesan yang dikeluarkan:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (sha256 blob store berbeda dari digest yang di-pin: blob store tidak cocok dengan catatan yang di-pin) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (ukuran blob store berbeda dari yang dinyatakan catatan yang di-pin: blob store tidak cocok dengan catatan yang di-pin)

Cara memperbaiki: hapus blob yang bermasalah dari store dan biarkan proses berikutnya mengisinya ulang dari sumber, yang diverifikasi terhadap digest yang tercatat sebelum apa pun ditulis. Jika pengisian ulang kemudian juga melaporkan ketidakcocokan digest, ketidaksesuaian berada di hulu, bukan lokal, dan entri di atas adalah yang perlu dibaca. Store yang dibagi antarmesin, atau yang dipulihkan dari cadangan yang diambil di tengah penulisan, adalah penyebab lokal yang biasa.

A guard needs a catalog entity the build resolved and cannot see (Guard memerlukan entitas katalog yang di-resolve oleh build tetapi tidak dapat dilihatnya)

Sebuah guard semantik mencari entitas katalog di balik tipe sebuah komponen, dan entitas tersebut tidak ada dalam tampilan yang diberikan kepada guard — padahal resolusi telah me-resolve tipe itu sebagai referensi katalog. Referensi yang benar-benar tidak dapat di-resolve sudah berhenti lebih awal, pada resolusi, sehingga mencapai guard dengan entitas yang hilang berarti himpunan hasil resolusi build dan tampilan guard telah terpisah.

Build berhenti alih-alih melewati guard. Melewatinya akan meniadakan sebuah pemeriksaan tanpa ada yang menyatakan bahwa pemeriksaan itu telah hilang, dan komponen yang menjadi sasaran guard akan lolos tanpa diperiksa sementara build melaporkan keberhasilan.

Tipe yang ditulis sebagai path relatif — diawali ./ atau ../ — tidak dinilai di sini: tipe tidak pernah dibaca sebagai file, sehingga nilai semacam itu sama sekali tidak menyebut entitas katalog dan ditolak lebih awal, saat dependensi Release di-resolve, sebagai referensi yang tidak dimuat katalog mana pun. Hanya referensi katalog berupa token polos yang mencapai penghentian ini.

Di mana pun kondisi ini terpenuhi, kondisi ini dilaporkan dengan kata-kata yang sama, sehingga teksnya menyebut tipe dan kesalahannya, bukan pemeriksaan yang memunculkannya.

Pesan ini juga tidak menyebut dokumen ataupun key di dalamnya, yang disengaja dan merupakan satu-satunya tempat penghentian ini terbaca berbeda dari yang lain. Setiap penghentian lain menunjuk ke file dan field yang akan Anda edit untuk mengatasinya; di sini tidak ada file semacam itu, sehingga sebuah posisi akan mengarahkan Anda ke key yang tidak bersalah. Sebagai gantinya, tipe yang diperselisihkan kedua tampilan dilaporkan, karena itulah yang membuat divergensi dapat direproduksi oleh siapa pun yang menyelidikinya.

Pesan yang diemisikan:

the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (tampilan katalog milik compiler sendiri tidak sepakat (kesalahan internal: build ini me-resolve tipe komponen yang kemudian tidak memiliki entri dalam katalog yang dibacanya. Ini adalah kesalahan pada compiler, bukan pada dokumen yang ditulis, sehingga tidak ada yang perlu diperbaiki pada Aggregate, Release, atau katalog. Harap laporkan, dengan menyebut perintah yang menghasilkan build ini dan tipe yang diperselisihkan tampilan-tampilan tersebut))

Cara memperbaiki: tidak ada yang perlu diubah dalam file Anda sendiri — ini melaporkan inkonsistensi di dalam compiler, bukan kesalahan dalam apa yang Anda tulis, dan layak dilaporkan sebagai cacat dengan tipe yang disebut pesan. Tipe komponen tersebut hampir pasti baik-baik saja.

A reference names no entity the catalog holds (Sebuah referensi tidak menamai entitas apa pun yang dimiliki katalog)

Sebelum build merender apa pun, seluruh himpunan entitas yang menjadi dependensi sebuah Release ditelusuri dan masing-masing di-pin, sehingga lockfile mencatat dengan tepat apa yang akan dibaca build. Referensi yang tidak dapat dijawab katalog menghentikan penelusuran itu: tidak ada yang dapat di-pin untuknya, dan melanjutkan akan menulis lockfile yang kekurangan satu entri yang dibutuhkan build kemudian, tanpa ada yang memberitahukannya.

Penolakan ini menyebutkan referensi tersebut dan tempat ia dikumpulkan, karena satu entitas dijangkau dari banyak tempat dan tempat yang menamainya adalah tempat koreksi dilakukan. Referensi pustaka dilaporkan tersendiri, tanpa jalur pengumpulan — sebuah pustaka dijangkau dari entitas yang melakukan $ref atau $import terhadapnya, dan nama yang gagal itulah keseluruhan kesalahannya.

Pesan yang dikeluarkan, untuk entitas katalog — bagian akhirnya mencantumkan tempat-tempat yang mereferensikannya:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: tidak ada entitas di katalog yang cocok dengan URI ini: entitas (direferensikan dari))

untuk pustaka:

resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: tidak ada entitas di katalog yang cocok dengan URI ini: pustaka)

dan untuk plugin yang terikat ke soket provider, yang dinamai oleh kunci konfigurasi workspace yang membawanya alih-alih oleh dokumen katalog:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: tidak ada entitas di katalog yang cocok dengan URI ini: entitas (direferensikan dari .aggrega-config.yaml.plugins.providers))

Jika sebuah file di bawah direktori katalog mendeklarasikan nama yang diminta referensi dengan jenis yang tidak ada di katalog mana pun — misalnya kind yang salah eja — catatan di bawah kegagalan ini menyebut file itu, jenis yang dideklarasikannya, dan jenis-jenis yang dimuat katalog, serta menghilangkan saran tentang dari mana entitas lokal dibaca, baik pada build yang mengisi lockfile-nya maupun pada build yang membacanya, dan pada setiap antarmuka lain yang melaporkan kegagalan ini; lihat File katalog yang ditolak dan kegagalan yang dijelaskannya.

Cara memperbaiki: baca referensi persis seperti yang dikutip pesan. Nama yang tidak ada, versi yang tidak pernah diterbitkan, dan nama polos yang registry-nya tidak dirujuk oleh workspace semuanya tiba di sini dengan cara yang sama, jadi periksa ketiganya dalam urutan itu: perbaiki ejaannya; pastikan versinya ada; pastikan registry yang menyimpannya telah dikonfigurasi dan dapat dijangkau. Jika entitas tersebut Anda tulis secara lokal, pastikan berkasnya berada di dalam katalog yang ditelusuri build.

Ketika aggrega pull, atau aggrega build --auto-pull, berhenti pada referensi library sementara cache artefak menyimpan SchemaLibrary yang tidak di-pin oleh entri lockfile mana pun dan tidak disediakan oleh direktori katalog mana pun, baris remediation: mengikuti pesan tersebut, dengan menyebutkan setiap library semacam itu. Library yang di-cache dihitung sebagai konten katalog hanya jika entri lockfile menjamin digest-nya, dan pull mencatat entri tersebut dari registry yang menyajikan library itu. Dalam postur offline, pull tidak dapat mengambil library maupun mencatat entri untuknya, sehingga baris tersebut menyarankan untuk menjalankan aggrega pull --release <release> di tempat yang dapat menjangkau registry, atau menulis library di bawah direktori katalog. Dalam keadaan terhubung, tidak ada direktori katalog atau registry yang dibaca pull yang menyajikan library tersebut, sehingga tidak ada entri untuk dicatat, dan baris tersebut menunjuk ke penulisan library di bawah direktori katalog.

A library reference is not written in the identity form (Referensi pustaka tidak ditulis dalam bentuk identitas)

$ref: atau $import: lintas pustaka menamai pustaka berdasarkan identitas, lalu entri di dalamnya: nama polos pustaka, secara opsional : dan batas bawah versi, lalu # dan jalur entri pada permukaan yang dibaca field tersebut. Tidak ada host registry dalam bentuk itu. Registry mana yang dipakai untuk me-resolve sebuah nama adalah konfigurasi workspace, dan versi mana yang dipakai build adalah jawaban lockfile, sehingga referensi yang membawa salah satunya akan menetapkan di dalam dokumen sesuatu yang seharusnya diputuskan oleh build.

Yang ditolak di sini: nilai yang membawa host registry; anchor dalam dokumen yang ditulis di tempat yang mengharapkan referensi lintas pustaka; nama pustaka kosong; dan @ yang ditulis sebagai pemisah versi, yang dilaporkan beserta ejaan yang benar alih-alih sebagai keluhan bentuk umum, karena itulah kesalahan yang paling sering terjadi pada bentuk ini.

Pesan yang diemisikan:

resolve: invalid library reference URI: "<the value as written>" (resolve: URI referensi pustaka tidak valid)

dan jika @ digunakan sebagai pemisah, dengan mengutip apa yang seharusnya tertulis pada nilai tersebut:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: URI referensi pustaka tidak valid: pemisah versi adalah ’:’, bukan ’@’ — gunakan)

Cara memperbaiki: tulis ulang nilai sebagai <Library>#<entry-path>, dengan menambahkan :<version> setelah nama pustaka hanya jika Anda memerlukan batas bawah untuk versi yang boleh dipilih. Hapus host registry apa pun. Jika referensi dimaksudkan menunjuk ke dalam dokumen yang sama, anchor dalam dokumen adalah hal yang berbeda dari referensi pustaka, dan field tempat Anda menuliskannya mengharapkan bentuk pustaka.

Two consumers of one library require incompatible versions (Dua konsumen dari satu pustaka memerlukan versi yang tidak kompatibel)

Beberapa entitas dapat mereferensikan satu pustaka, masing-masing menyebutkan batas bawah versi atau tidak sama sekali, dan versi yang dipilih build adalah batas bawah tertinggi yang disebutkan salah satunya. Itulah yang memungkinkan konsumen yang meminta lebih rendah tetap menerima versi yang memenuhinya, dan itulah sebabnya menambahkan konsumen dengan batas bawah lebih tinggi menaikkan semua pihak alih-alih memecah build ke dua salinan.

Ketentuan ini hanya berlaku selama batas-batas bawah sepakat pada nomor versi terdepan. Dua konsumen yang menyebutkan major berbeda sebenarnya meminta dua pustaka yang kebetulan berbagi nama, dan tidak ada satu pilihan pun yang memenuhi keduanya — jadi alih-alih memilih salah satu dan membiarkan konsumen lain membaca bentuk yang tidak menjadi acuan penulisannya, build berhenti dan menyebutkan ketidaksepakatan tersebut. Konsumen yang tidak menyebutkan batas bawah tidak berperan apa pun di sini: pilihan ditentukan oleh konsumen yang melakukan pin.

Pesan yang dikeluarkan. Konsumen dibandingkan dalam urutan terurut: yang pertama menyebutkan batas bawah menetapkan major, dan pesan mencantumkan setiap konsumen yang dibandingkan, hingga dan termasuk yang pertama yang batas bawahnya menyebutkan major berbeda, beserta versi yang dimintanya — sehingga dokumen yang sama selalu menyebutkan konsumen yang sama:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (resolve: konflik pemilihan versi minimal — persyaratan versi pustaka tidak kompatibel: pustaka memiliki konsumen yang memerlukan major yang tidak kompatibel: menginginkan; menginginkan)

Cara memperbaiki: naikkan batas bawah konsumen yang lebih rendah ke major yang sama, yang merupakan jawaban biasa begitu bentuk yang lebih baru adalah yang diinginkan semua pihak. Jika kedua major memang dibutuhkan sekaligus, keduanya adalah dua pustaka: terbitkan bentuk yang lebih lama dengan namanya sendiri dan arahkan konsumen yang membutuhkannya ke sana, sehingga setiap referensi menamai hal yang menjadi acuan penulisannya.

The chain of module imports is deeper than the pin walk descends (Rantai impor modul lebih dalam daripada yang ditelusuri penelusuran pin)

Pinning menelusuri setiap modul yang diimpor sebuah Aggregate, lalu setiap modul yang diimpor modul-modul tersebut, sehingga seluruh himpunan mencapai lockfile, bukan hanya tingkat pertama. Modul yang sudah tercatat tidak ditelusuri untuk kedua kalinya, dan itulah yang mengakhiri perulangan biasa — Aggregate yang mengimpor modul yang mengimpornya kembali berakhir tanpa keluhan, setelah mencatat masing-masing sekali.

Batas kedalaman sepuluh menjadi pengaman bagi rantai yang tidak dapat dilihat oleh deteksi pengulangan: rantai yang menampilkan identitas baru di setiap tingkat, seperti modul yang diterbitkan ulang dengan versi baru di setiap langkah. Batas ini sama dengan yang diterapkan pembangun graf, sehingga komposisi yang dapat di-pin adalah komposisi yang juga dapat di-build.

Pesan yang diemisikan:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (resolve: kedalaman penyertaan sub-aggregate terlampaui: pada kedalaman)

Cara memperbaiki: perpendek rantainya. Rantai sedalam ini biasanya mencerminkan susunan organisasi alih-alih susunan deployment, jadi carilah tingkat yang tidak menyumbangkan komponen sendiri dan gabungkan ke induknya. Jika setiap tingkat hanya ada untuk menerbitkan ulang tingkat di bawahnya dengan versi baru, versi-versi itulah rantainya: impor langsung modul yang sebenarnya Anda inginkan, pada versi yang Anda inginkan.

Ini adalah batas penelusuran pinning. Pembangun graf menerapkan batasnya sendiri, yang dilaporkan di bawah “Sub-aggregate nesting depth exceeded” (Kedalaman penyarangan sub-aggregate terlampaui), dan keduanya adalah laporan terpisah atas batas yang sama yang tercapai di dua titik — yang pertama saat lockfile sedang diisi, yang kedua saat graf sedang dibangun.

The catalog view a build was given cannot load the bodies pinning needs (Tampilan katalog yang diberikan kepada build tidak dapat memuat isi yang dibutuhkan pinning)

Dua sumbu yang ditelusuri pinning membutuhkan lebih dari sekadar jawaban versi dari katalog: keduanya membutuhkan dokumennya sendiri. Modul yang diimpor sebuah Aggregate harus dibaca untuk menemukan apa yang mereka impor pada gilirannya. Recipes, FeatureRecipes, dan Plugins yang diikat sebuah build harus dibaca untuk menemukan artefak dan pustaka yang mereka namai. Tampilan katalog yang dapat me-resolve versi tetapi tidak dapat mengembalikan isi tersebut membuat kedua sumbu tidak memiliki apa pun untuk dibaca.

Keduanya ditolak di awal alih-alih dilewati, dan alasannya adalah apa yang akan dihasilkan jika dilewati: lockfile yang kekurangan satu kelas entri secara utuh, ditulis tanpa keluhan, yang kemudian direkonstruksi dengan setia oleh build berikutnya dan didapati tidak lengkap. Tidak satu pun pesan membawa nilai sendiri, karena tidak satu pun berkaitan dengan dokumen yang Anda tulis — masing-masing menyatakan sumbu mana yang tidak dapat dihitung:

resolve: catalog lookup cannot load resolved sub-aggregate bodies (resolve: pencarian katalog tidak dapat memuat isi sub-aggregate yang telah di-resolve) resolve: catalog lookup cannot load resolved recipe and plugin bodies (resolve: pencarian katalog tidak dapat memuat isi recipe dan plugin yang telah di-resolve)

Cara memperbaiki: tidak ada apa pun dalam berkas Anda yang menghasilkan salah satunya, dan tidak ada perubahan penulisan yang dapat menghilangkannya — kesalahannya terletak pada cara build dirangkai, bukan pada apa yang diminta untuk di-build. Laporkan dengan menyertakan perintah yang Anda jalankan dan konfigurasi workspace yang digunakannya.

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Plugin annotation-transform menyebut komponen yang tidak diberikan kepadanya, atau menginjeksikan nilai yang tidak diterima anotasi mana pun)

Operator dapat memasang plugin tata kelola dalam peran yang menambahkan anotasi, dan pemasangan itu adalah sebuah deklarasi: operator meminta transformasi tersebut, sehingga apa yang ditambahkan plugin bersifat eksplisit, bukan disisipkan diam-diam. Peran tersebut dibatasi secara sepadan. Plugin diberi koordinat komponen yang dideklarasikan dokumen Anda, dan dapat menambahkan anotasi pada koordinat tersebut, masing-masing membawa nilai yang sebenarnya dapat Anda tulis sendiri pada anotasi itu: string, atau objek berisi subkunci. Bentuk yang dikembalikannya tidak menerima field lain, sehingga yang tersisa untuk diperiksa ketika keluarannya diterapkan adalah apakah setiap injeksi menyebut koordinat yang diberikan kepadanya, dan apakah setiap nilai merupakan nilai yang diterima anotasi.

Injeksi yang menyebut pasangan boundary dan komponen di luar himpunan itu menghentikan build. Plugin yang menjangkau komponen yang tidak pernah diekspos dokumen Anda akan mengonfigurasi infrastruktur yang tidak dideklarasikan siapa pun, dan anotasi yang ditambahkannya diperluas menjadi lampiran Feature persis seperti anotasi yang ditulis, sehingga akibatnya adalah sumber daya yang muncul dari komponen yang tidak diserahkan operator kepadanya.

Injeksi yang nilainya null, list, angka, boolean, atau objek tanpa subkunci juga menghentikan build. Null dan objek kosong dibaca sebagai nilai yang Anda tulis untuk mengeluarkan komponen dari anotasi yang seharusnya diwarisinya, sedangkan peran ini menambahkan anotasi, bukan menghapusnya; bentuk-bentuk lainnya bukan nilai yang diterima anotasi. Seluruh keluaran diperiksa sebelum bagian mana pun diterapkan, sehingga keluaran yang ditolak tidak mengubah apa pun.

Setiap injeksi yang diterima juga membawa anotasi pendamping, aggrega.ai/injected-by, yang menyebut plugin yang membuatnya. Host yang menulis anotasi itu; plugin tidak dapat menyediakannya, sehingga apa yang dikatakannya tentang asal anotasi yang diinjeksikan tidak dapat dibentuk oleh plugin.

Pesan yang dikeluarkan, untuk koordinat yang tidak diberikan kepada plugin dan untuk nilai yang tidak diterima anotasi mana pun:

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (keluaran plugin annotation-transform ditolak: sebuah injeksi menargetkan koordinat komponen yang tidak disediakan host, atau membawa nilai yang bukan string maupun objek berisi subkunci: injeksi menargetkan komponen yang disebut pada boundary yang disebut (anotasi yang disebut)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (keluaran plugin annotation-transform ditolak: sebuah injeksi menargetkan koordinat komponen yang tidak disediakan host, atau membawa nilai yang bukan string maupun objek berisi subkunci: injeksi untuk komponen yang disebut pada boundary yang disebut (anotasi yang disebut) membawa list; nilai anotasi yang diinjeksikan adalah string atau objek berisi subkunci)

Cara memperbaiki: kesalahannya ada pada plugin, bukan pada dokumen Anda — perbaiki plugin agar hanya menginjeksi ke koordinat yang diberikan kepadanya, yang masing-masing tiba dalam masukannya, dan hanya dengan string atau objek berisi subkunci sebagai nilai. Jika komponen dalam pesan adalah komponen yang Anda harapkan terlihat oleh plugin, periksa bahwa Release mendeklarasikannya di dalam sebuah boundary: hanya koordinat komponen yang dideklarasikan yang diserahkan. Menghapus pemasangan dari plugins.governance adalah cara langsung untuk membuka blokir build selama plugin diperbaiki.

A plugin reference is not a Plugin entity (Referensi plugin bukan entitas Plugin)

Plugin dirujuk melalui entitas Plugin-nya, selalu dicakup oleh tipe soket plugin itu sendiri: <pluginType>/<name>, opsional dengan versi, seperti parser/yaml atau parser/yaml:1.0.0. Cakupan ini wajib, bukan salah satu dari beberapa bentuk — name:version tanpa cakupan ditolak, karena dua soket dapat memuat plugin dengan nama yang sama dan cakupanlah yang membuat entitas dapat di-resolve. Biner yang ditunjuk entitas dijangkau melalui entitas, tidak pernah disebut langsung, sehingga entitaslah yang membawa klaim kapabilitas, batas runtime, dan himpunan perintah tercatat yang menjadi dasar pemeriksaan biner saat dimuat. Karena itu, referensi yang tidak menyebut entitas Plugin tidak memiliki apa pun untuk memeriksa biner, dan build berhenti alih-alih memuat byte berdasarkan referensi yang tidak diperiksa.

Dua bentuk dilaporkan di sini, dan keduanya diperiksa pada saat yang berbeda. Referensi yang bentuknya tidak mungkin berupa entitas — path sistem berkas, atau referensi artefak seperti URL oci://, .wasm polos, atau digest @sha256: — ditolak sejak awal pada permukaan yang hanya menerima referensi entitas. Referensi yang tidak menyebut entitas yang dimuat oleh apa pun ditolak setelah pencarian, dan isi pesannya bergantung pada cara penulisannya: URI entitas Plugin — <pluginType>/<name>, opsional berversi — dilaporkan sebagai entitas yang tidak dimuat direktori katalog mana pun, tidak dibawa biner, dan tidak diambil oleh pull mana pun, sedangkan referensi lain diminta menggunakan bentuk itu. Kedua bentuk melaporkan kondisi yang sama, sehingga respons build terhadap keduanya sama.

Pull menolak bentuk kedua sebelum build menemuinya. Setiap Plugin yang disebut pipeline milik Recipe atau FeatureRecipe di-resolve bersama dependensi Release lainnya — dari direktori katalog, salinan di dalam biner compiler, cache konten, atau registry — dan Plugin yang tidak dimuat oleh satu pun dari sumber tersebut menghentikan aggrega pull sebelum menulis lockfile, dengan kondisi ini dan pesan yang sama, dengan menyebut Recipe atau FeatureRecipe yang pipeline-nya menyebutnya.

Tidak setiap permukaan menolak bentuk non-entitas. Permukaan plugin pipeline hanya menerima referensi entitas; permukaan tempat operator memasang plugin secara langsung menerima bentuk apa pun dan meneruskan referensi non-entitas untuk di-resolve sebagai artefak. Jadi referensi yang sama dapat diterima di satu titik pemasangan dan ditolak di titik lain, dan perbedaan itu berasal dari permukaannya, bukan dari referensinya.

Pesan yang dikeluarkan. Path sistem berkas:

plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (referensi plugin bukan entitas Plugin: referensi adalah path sistem berkas, tetapi plugin pipeline harus berupa URI entitas Plugin yang dicakup tipe plugin, opsional berversi)

referensi artefak:

plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (referensi plugin bukan entitas Plugin: referensi adalah referensi artefak, tetapi plugin pipeline harus berupa URI entitas Plugin yang dicakup tipe plugin, opsional berversi)

URI entitas Plugin yang tidak dimuat oleh apa pun:

plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (referensi plugin bukan entitas Plugin: referensi adalah URI entitas Plugin, tetapi tidak ada direktori katalog yang memuat entitas yang disebutnya, biner tidak membawanya, dan tidak ada pull yang mengambilnya ke cache konten; tempatkan entitas Plugin di direktori katalog, atau publikasikan ke registry lalu jalankan pull)

dan referensi lain yang tidak menyebut entitas — tanpa cakupan tipe plugin, dengan lebih dari satu / sebelum versinya, atau membawa host registry:

plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (referensi plugin bukan entitas Plugin: referensi harus berupa URI entitas Plugin yang dicakup tipe plugin, opsional berversi; referensi .wasm polos atau referensi artefak tidak menyebut entitas Plugin)

Cara memperbaiki: tulis referensi sebagai identitas entitas Plugin yang dicakup tipe soket, opsional dengan versinya — <pluginType>/<name> atau <pluginType>/<name>:<version>. Jika Anda menunjuk langsung ke berkas atau artefak, publikasikan atau tulis entitas Plugin untuknya dan rujuk entitas itu — entitas adalah tempat klaim yang diperiksa saat pemuatan berada, sehingga tidak ada bentuk setara yang melewatinya. Jika pesan menyatakan bahwa referensi adalah URI entitas Plugin, bentuknya sudah benar dan yang hilang adalah entitasnya: tempatkan entitas Plugin di direktori katalog yang dicantumkan workspace, dengan .wasm hasil build-nya di sampingnya, atau publikasikan plugin ke registry yang dibaca workspace lalu jalankan aggrega pull, yang mengambilnya ke cache konten — dan periksa bahwa versi yang Anda sebut memang ada.

A cached signature bundle does not match the digest recorded for it (Bundel tanda tangan yang di-cache tidak cocok dengan digest yang tercatat untuknya)

Artefak yang tanda tangannya diverifikasi saat diambil membawa fakta itu ke depan pada entri lockfile-nya — atau, untuk plugin yang dipasang pada peran verdict, pada entrinya di plugins-trust.yaml — sebagai digest tercatat dari materi tanda tangan, yang di-cache bersama artefak. Sebelum apa pun di-render, build membaca ulang materi yang di-cache itu untuk setiap entri yang dibacanya yang mencatat materi tersebut — entitas katalog jenis apa pun, pustaka, plugin — lalu menghitung ulang hash-nya, dan hash itu harus sama dengan yang tercatat. Plugin yang di-pin oleh lockfile, dan plugin yang dipasang pada peran verdict, materinya diperiksa lagi saat byte-nya dimuat, dan pemeriksaan inilah yang menjangkau perintah yang memuat plugin di luar build — antara lain aggrega lint --release dan aggrega validate --release. Bundel yang hilang, tidak dapat dibaca, atau menghasilkan hash yang berbeda berarti materi yang telah ditinjau bukan lagi yang ada di disk sekarang, dan proses berhenti alih-alih menggunakan artefak yang bukti tanda tangannya telah berubah di bawah catatannya.

Pemeriksaan ulang ini hanyalah perbandingan hash, tidak lebih. Pemeriksaan ini tidak memverifikasi ulang tanda tangan apa pun, tidak menghubungi jaringan, dan tidak merujuk materi kepercayaan apa pun, sehingga tetap berlaku dalam build tanpa akses jaringan sama sekali — itulah yang memungkinkan artefak yang pernah diverifikasi sekali tetap terverifikasi pada build offline berikutnya.

Pull berikutnya memperbaikinya. Pull menerapkan pemeriksaan yang sama pada setiap entri yang dilayani oleh content cache, dan jika pemeriksaan menolak suatu entri, pull menanyakan kembali tanda tangan itu ke registry artefak — apa pun yang dinyatakan persyaratan penandatanganan, melalui verifikasi yang sama dengan yang diterima artefak yang diambilnya — mencatat apa yang diverifikasi oleh hal itu pada entri, dan meng-cache bundel yang dirujuknya, menulis ulang salinan cache yang tidak lagi cocok dengan digest-nya. Plugin yang dipasang pada peran verdict diverifikasi lagi pada setiap pull apa pun yang dicatat entrinya, dan bundelnya di-cache dengan cara yang sama. Karena itu, pesan untuk entri yang dilayani content cache menyebutkan pull tersebut. Entri yang dibaca dari direktori katalog, dari salinan di dalam biner kompiler, atau dari samping Release tidak pernah ditanyakan ke registry, sehingga pull membiarkan tanda tangan yang tercatat padanya apa adanya, dan pesannya tidak menyebutkan pull apa pun.

Pesan yang dikeluarkan, yang menyebutkan artefak, berkas cache, dan — untuk entri yang dilayani content cache — pull yang memperbaikinya, berkas tempat pull mencatat tanda tangan, serta Release yang di-pull-nya. Dari pemeriksaan build, tidak dapat dibaca atau tidak ada:

artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefak: bundel tanda tangan yang di-cache tidak dapat dibaca: bundel tanda tangan yang di-cache tidak cocok dengan digest tercatatnya. perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya, dan meng-cache bundel yang dirujuknya)

dan yang bergeser:

artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefak: bundel tanda tangan yang di-cache memiliki digest yang berbeda dari digest tercatat: bundel tanda tangan yang di-cache tidak cocok dengan digest tercatatnya. perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya, dan meng-cache bundel yang dirujuknya)

dan, jika byte plugin dimuat dari content cache, dengan menyebutkan juga asal byte tersebut:

plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin di-resolve dari sumbernya: bundel tanda tangan yang di-cache tidak dapat dibaca: bundel tanda tangan yang di-cache tidak cocok dengan digest tercatatnya. perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya, dan meng-cache bundel yang dirujuknya)

plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin di-resolve dari sumbernya: bundel tanda tangan yang di-cache memiliki digest yang berbeda dari digest tercatat: bundel tanda tangan yang di-cache tidak cocok dengan digest tercatatnya. perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya, dan meng-cache bundel yang dirujuknya)

<file> adalah lockfile milik Release, atau plugins-trust.yaml di direktori Release. Untuk entri yang tidak ditanyakan oleh pull mana pun, pesan berakhir sebelum remediation:.

Pull yang tidak memiliki registry untuk ditanya justru berhenti. Entitas katalog atau pustaka disebutkan tanpa registry dan diikat ke salah satunya melalui default_registry milik workspace. Jika workspace tidak menyebutkan registry apa pun — dulu menyebutkannya saat tanda tangan dicatat, dan kini tidak lagi — tidak ada registry yang dikonfigurasi untuk ditanya kembali tentang entri itu, sehingga pull berhenti dengan kondisi ini alih-alih menulis lockfile yang akan ditolak build berikutnya, dan membiarkan lockfile seperti semula. Pesannya memuat, setelah langkah yang sedang dijalankan pull:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (verifikasi: referensi mencatat tanda tangan yang tidak diterima build, dan tidak ada registry yang dikonfigurasi untuk ditanya kembali: bundel tanda tangan yang di-cache tidak dapat dibaca: bundel tanda tangan yang di-cache tidak cocok dengan digest tercatatnya)

Cara memperbaiki: tidak ada apa pun dalam berkas entitas Anda yang menyebabkan hal ini — cache adalah milik build, bukan milik Anda. Jalankan aggrega pull --release <release>, perintah yang disebutkan pesan: perintah ini memverifikasi ulang tanda tangan artefak dan menulis tanda tangan beserta bundelnya sekaligus, yang memperbaiki bundel yang dihapus atau diubah sejak pull yang meng-cache-nya. Dalam postur offline, pull tersebut berhenti — dengan penolakan offline, karena perbaikan berarti bertanya ke registry, atau, untuk plugin yang dipasang pada peran verdict, sebelum itu, dengan menyebutkan .wasm milik plugin sebagai berkas yang tidak dapat di-resolve, karena pull me-resolve .wasm tersebut dari registry plugin; mengizinkan jaringan untuk satu proses itu akan memperbaikinya. Jika pull berhenti dengan menyatakan tidak ada registry yang dikonfigurasi untuk ditanya tentang entri itu, atur default_registry ke registry asal artefak di-pull, lalu lakukan pull lagi. Jika workspace melewati verifikasi tanda tangan untuk artefak tersebut, pull justru tidak mencatat tanda tangan apa pun pada entri, yang diterima build dengan pengaturan yang sama. Jika tanda tangan yang dilayani registry tidak lolos verifikasi, pull berhenti dengan penolakan dari verifikasi itu sendiri: tanda tangan yang tercatat dan materi yang dilayani penerbit memang tidak sesuai, dan itu adalah persoalan bagi siapa pun yang menerbitkan artefak tersebut. Untuk entri yang pesannya tidak menyebutkan pull — entri yang dibaca dari direktori katalog, dari salinan di dalam biner kompiler, atau dari samping Release — hapus signature dari entrinya: entri semacam itu tidak pernah dikenai persyaratan penandatanganan, sehingga build kemudian dapat berlanjut.

A recorded signature was made for a different artifact (Tanda tangan yang tercatat dibuat untuk artefak yang berbeda)

Sebuah tanda tangan menyatakan untuk artefak mana tanda tangan itu dibuat. Saat pull memverifikasi tanda tangan sebuah artefak, pull mencatat fakta tersebut pada entri lockfile artefak itu — atau, untuk plugin yang dipasang pada peran verdict, pada entrinya di plugins-trust.yaml — dan menyimpan dalam cache tanda tangan yang diverifikasinya. Sebelum apa pun di-render, build membaca, dari tanda tangan dalam cache setiap entri yang dilayani oleh cache konten, untuk artefak mana tanda tangan itu dibuat, dan artefak tersebut harus merupakan artefak yang dibaca oleh build itu sendiri untuk entri tersebut: artefak yang manifest-nya disimpan di samping byte-nya dalam cache konten, bukan apa pun yang dicatat oleh entri. Tanda tangan yang dibuat untuk artefak yang berbeda menghentikan build. Inilah wujud sebuah signature yang disalin dari satu entri ke entri lain: tanda tangan dalam cache yang dirujuknya utuh — masih cocok dengan digest yang dicatat untuknya — dan dibuat untuk artefak entri yang lain.

Pemeriksaan ini tidak bergantung pada persyaratan penandatanganan. Tanda tangan yang tercatat dituntut sesuai dengan apa yang diklaimnya, baik diwajibkan maupun tidak, sama seperti pemeriksaan bahwa tanda tangan dalam cache cocok dengan digest yang tercatat untuknya.

Plugin diperlakukan dengan cara yang sama di mana pun plugin dimuat. Plugin yang di-pin oleh lockfile, dan plugin yang dipasang pada peran verdict, tanda tangan tercatatnya dicocokkan dengan artefak yang menjadi asal pembacaan byte-nya saat byte tersebut dimuat dari cache konten; hal ini menjangkau perintah yang memuat plugin di luar build — antara lain aggrega lint --release dan aggrega validate --release, serta operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp.

Apa yang dibaca pemeriksaan, dan apa yang tidak dapat dibedakannya. Pemeriksaan membaca tanda tangan dalam cache dan manifest di samping artefak, lalu membandingkan hash: pemeriksaan tidak memverifikasi tanda tangan apa pun, tidak menghubungi jaringan, dan tidak merujuk materi kepercayaan, sehingga tetap berlaku dalam build tanpa akses jaringan sama sekali. Pemeriksaan membaca untuk artefak mana sebuah tanda tangan dibuat dalam kedua bentuk yang diterima pull — tanda tangan yang dibuat atas artefak itu sendiri, yaitu yang dibuat oleh penanda tangan milik toolchain, dan pernyataan bertanda tangan yang menyebut artefak tersebut — sehingga tanda tangan yang disalin dari satu entri ke entri lain ditolak dalam kedua bentuk itu. Pembacaan ini sama dengan yang diterapkan pull pada setiap tanda tangan yang diterimanya: pull menolak tanda tangan yang terverifikasi tetapi menurut pembacaan ini tidak dibuat untuk artefak tersebut, atau yang sama sekali tidak dapat dibaca artefaknya, sehingga tidak ada tanda tangan yang dicatat pull yang tidak dapat dibaca oleh pemeriksaan. Entri yang dibaca dari direktori katalog, dari salinan di dalam biner compiler, atau dari samping Release tidak disertai manifest, sehingga tanda tangan tercatatnya hanya dicocokkan dengan digest tercatatnya; demikian pula tanda tangan yang ditempatkan secara manual ke dalam cache dalam bentuk yang bukan salah satu dari kedua bentuk tersebut. Dan karena tidak ada tanda tangan yang diverifikasi, tanda tangan yang ditulis secara manual ke dalam cache, yang dibuat untuk artefak milik entri itu sendiri, tidak dapat dibedakan dari tanda tangan yang diverifikasi oleh pull.

Pull berikutnya memperbaikinya. Pull menerapkan pemeriksaan yang sama pada setiap entri yang dilayani cache konten, dan jika pemeriksaan menolak sebuah entri, pull menanyakan kembali tanda tangannya kepada registry artefak tersebut — apa pun bunyi persyaratan penandatanganan — lalu mencatat hasil verifikasinya pada entri sebagai pengganti tanda tangan yang disalin. Plugin yang dipasang pada peran verdict diverifikasi ulang pada setiap pull, apa pun yang dicatat entrinya. Hanya entri yang dilayani cache konten yang diperiksa untuk artefak mana tanda tangannya dibuat, sehingga setiap penolakan kondisi ini oleh build atau pemuatan plugin menyebut pull tersebut.

Pesan yang dikeluarkan, yang menyebut entri, file yang mencatat tanda tangan, tanda tangan dalam cache, manifest yang dibaca build untuk entri tersebut, dan pull yang memperbaikinya. Dari pemeriksaan build:

artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefak: penandatanganan: tanda tangan yang tercatat dibuat untuk artefak yang berbeda (file mencatatnya, bundle tanda tangan dalam cache, artefak yang dibaca memiliki manifest). perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya dalam file, dan menyimpan dalam cache bundle yang dirujuknya)

dan, jika byte plugin dimuat, juga menyebut asal byte tersebut:

plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin yang di-resolve dari sumber: penandatanganan: tanda tangan yang tercatat dibuat untuk artefak yang berbeda (file mencatatnya, bundle tanda tangan dalam cache, artefak yang dibaca memiliki manifest). perbaikan: jalankan pull untuk memverifikasi ulang tanda tangan artefak di registry-nya, mencatatnya dalam file, dan menyimpan dalam cache bundle yang dirujuknya)

<file> adalah lockfile milik Release, atau plugins-trust.yaml di direktori Release.

Pull yang tidak memiliki registry untuk ditanyai justru berhenti, seperti halnya untuk bundle tanda tangan dalam cache yang tidak lagi cocok dengan digest-nya: jika entitas katalog atau library membawa tanda tangan yang disalin dan workspace tidak lagi menyebut default_registry untuk mengikatnya, pull berhenti dengan kondisi ini dan membiarkan lockfile seperti semula. Pesannya memuat, setelah langkah yang sedang dijalankan pull:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>) (verifikasi: mencatat tanda tangan yang tidak diterima build, dan tidak ada registry yang dikonfigurasi untuk ditanyai kembali: penandatanganan: tanda tangan yang tercatat dibuat untuk artefak yang berbeda (bundle tanda tangan dalam cache, artefak yang dibaca memiliki manifest))

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan hal ini — tanda tangan yang dicatat entri tersebut milik artefak lain. Jalankan aggrega pull --release <release>, perintah yang disebut dalam pesan: perintah ini memverifikasi tanda tangan milik entri itu sendiri di registry-nya dan mencatatnya sebagai pengganti tanda tangan yang disalin, baik untuk entri lockfile maupun untuk plugin yang dipasang pada peran verdict. Memulihkan tanda tangan tercatat milik entri itu sendiri dari version control, jika file tersebut di-commit, juga berhasil. Dalam postur offline, pull berhenti — dengan penolakan offline, karena perbaikan berarti menanyai registry, atau, untuk plugin yang dipasang pada peran verdict, sebelum itu, dengan menyebut .wasm plugin sebagai yang tidak dapat di-resolve, karena pull me-resolve .wasm tersebut dari registry plugin; mengizinkan jaringan untuk satu kali eksekusi itu akan memperbaikinya. Jika pull berhenti dengan menyatakan bahwa tidak ada registry yang dikonfigurasi untuk ditanyai tentang entri tersebut, setel default_registry ke registry asal artefak di-pull, lalu lakukan pull lagi. Jika workspace melewati verifikasi tanda tangan untuk artefak tersebut, pull justru tidak mencatat tanda tangan pada entri, dan hal itu diterima build di bawah pengaturan yang sama.

No verified signature is recorded for an artifact that requires one (Tidak ada tanda tangan terverifikasi yang tercatat untuk artefak yang memerlukannya)

Pull yang mengambil artefak dari registry memverifikasi tanda tangannya terhadap kebijakan kepercayaan registry tersebut dan mencatat fakta terverifikasi itu pada entri lockfile artefak tersebut. Build tidak menjangkau registry mana pun, sehingga build membaca fakta yang tercatat alih-alih memverifikasi ulang — dan sebelum apa pun dirender, build menguji setiap entri yang dibacanya terhadap persyaratan yang diterapkan pull saat mengambil artefak tersebut. Entri yang disajikan oleh cache konten, untuk artefak yang memerlukan tanda tangan, yang tidak mencatat tanda tangan terverifikasi akan menghentikan build: tidak ada apa pun yang dipegang build yang menyatakan bahwa artefak yang akan dijadikan sumber render pernah diverifikasi.

Persyaratannya adalah persyaratan pull, pengaturan demi pengaturan. Tanda tangan diperlukan apabila kebijakan penandatanganan tingkat workspace mencakup jenis artefak tersebut, atau apabila entri registry itu sendiri dalam .aggrega-config.yaml — atau, untuk hub.aggrega.ai tanpa entri sendiri, kebijakan bawaan hub resmi — memerlukannya; artefak yang jenisnya tidak dapat ditentukan dianggap memerlukan tanda tangan di bawah kebijakan yang aktif. Apa yang memungkinkan pull menerima artefak tanpa tanda tangan juga memungkinkan build menerima entrinya: skip_signature_verification di tingkat teratas, sakelar yang sama pada entri registry itu sendiri kecuali untuk jenis yang diwajibkan oleh kebijakan tingkat workspace, dan registry yang ditandai advisory.

Asal sebuah entri dibaca dari build, tidak pernah dari lockfile. Setiap entri yang disajikan oleh cache konten diuji, apa pun yang dicatat entri tersebut, sehingga menghapus digest manifest sebuah entri beserta tanda tangannya tidak membebaskannya. Entri yang dibaca dari direktori katalog, dari salinan di dalam biner kompiler, atau dari samping Release tidak pernah diuji, karena tidak ada tanda tangan registry untuk byte yang tidak berasal dari registry. Entri dari setiap bagian diperiksa dengan cara yang sama — entitas katalog, pustaka, dan artefak plugin — dan setiap entri yang ditolak oleh pemeriksaan disebutkan dalam proses yang sama.

Plugin yang dilampirkan pada peran verdict diuji oleh pemeriksaan yang sama, melalui plugins-trust.yaml. Lampiran plugins.governance dalam peran ir-verdict atau render-verdict, dan setiap lampiran plugins.linter, tidak membentuk byte hasil render apa pun, sehingga tidak memiliki entri lockfile; catatan di samping lockfile yang memuat tanda tangan terverifikasinya. Setiap plugin semacam itu yang dibaca build dari cache konten diuji terhadap persyaratan yang sama, melalui pengaturan yang sama: entri dalam catatan tersebut yang tidak mencatat tanda tangan menghentikan build, demikian pula tidak adanya entri sama sekali untuk plugin tersebut — menghapus catatan tidak membebaskannya. Plugin yang disajikan dari direktori katalog atau dari salinan di dalam biner kompiler tidak diuji. Persyaratan ini berlaku untuk plugin semacam itu di mana pun plugin dimuat untuk sebuah Release, tidak hanya dalam build: aggrega lint --release dan aggrega validate --release, serta operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp, gagal pada kondisi ini ketika memuatnya.

Pesan yang dikeluarkan menyebutkan entri, file yang tidak mencatat tanda tangan untuknya, pengaturan yang mewajibkan tanda tangannya, dan perintah yang mencatatnya dalam file tersebut. Untuk entri lockfile, dengan menyebutkan lockfile:

signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (penandatanganan: tidak ada tanda tangan terverifikasi yang tercatat untuk artefak yang memerlukannya (lockfile tidak mencatat tanda tangan untuknya, diwajibkan oleh pengaturan yang mewajibkannya). perbaikan: jalankan pull untuk memverifikasi tanda tangan artefak di registry-nya dan mencatatnya dalam lockfile)

dan untuk plugin yang dilampirkan pada peran verdict, dengan menyebutkan catatannya:

signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (penandatanganan: tidak ada tanda tangan terverifikasi yang tercatat untuk artefak yang memerlukannya (catatan tidak mencatat tanda tangan untuknya, diwajibkan oleh pengaturan yang mewajibkannya). perbaikan: jalankan pull untuk memverifikasi tanda tangan plugin di registry-nya dan mencatatnya dalam catatan tersebut)

Kedua file disebutkan dengan path-nya di samping Release yang diberikan kepada perintah: <lockfile-path> adalah lockfile Release, dan <record-path> adalah plugins-trust.yaml di direktori Release.

Pengaturan disebutkan dengan kata-kata file konfigurasi itu sendiri: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>", atau the official hub's built-in signature requirement for "hub.aggrega.ai", digabungkan apabila lebih dari satu berlaku.

Cara memperbaiki: jalankan pull yang disebutkan pesan. Untuk entri yang disajikan cache konten yang tidak mencatat tanda tangan padahal tanda tangan diperlukan, pull meminta tanda tangan artefak dari registry-nya, berdasarkan digest manifest yang dicatat entri, persis seperti untuk artefak yang diambilnya, lalu mencatat tanda tangan terverifikasi pada entri — sehingga build berikutnya membacanya. Plugin yang dilampirkan pada peran verdict bagaimanapun ditanyakan pada setiap pull, dan pull mencatat apa yang diverifikasinya pada entri plugin dalam plugins-trust.yaml, dengan membuat entri jika belum ada. Registry yang tidak melampirkan tanda tangan, atau tanda tangan yang tidak diterima konfigurasi kepercayaan, justru menghentikan pull tersebut dengan menyebutkan artefaknya, dan itu adalah persoalan bagi pihak yang menerbitkannya. Dalam mode offline, pull tidak dapat bertanya: untuk entri lockfile, pull menolak sambil menyebutkan cara mengizinkan jaringan untuk satu kali proses, dan untuk plugin yang dilampirkan pada peran verdict, pull berhenti sebelum bertanya, dengan menyebutkan .wasm plugin sebagai yang tidak dapat di-resolve, karena pull me-resolve .wasm tersebut dari registry plugin. Memulihkan tanda tangan tercatat entri dari kontrol versi menyelesaikannya tanpa jaringan, selama cache masih menyimpan materi tanda tangan yang disebutkan catatan tersebut. Apabila artefak memang tidak dimaksudkan untuk ditandatangani, persyaratannya yang perlu diubah, dan pesan menyebutkan pengaturan mana itu — tetapi melonggarkannya berarti artefak registry tersebut juga tidak lagi diperiksa saat pull, jadi lebih baik mempersempit jenis dalam kebijakan tingkat workspace daripada menonaktifkan persyaratan.

A recorded signature is not the one a pull would record (Tanda tangan yang tercatat bukan yang akan dicatat oleh pull)

aggrega pull --verify melaporkan apakah menjalankan aggrega pull sekarang akan mengubah berkas yang di-commit oleh pull, dan tanda tangan yang diverifikasi pull untuk sebuah artefak merupakan bagian dari apa yang ditulisnya: signature pada entri lockfile, dan pada entri plugins-trust.yaml untuk plugin yang dilampirkan pada peran verdict. Kondisi ini adalah apa yang dilaporkan verify untuk setiap tanda tangan tercatat yang akan ditulis berbeda oleh pull biasa — tanda tangan yang akan dicatatnya di tempat yang belum memiliki catatan, yang akan digantinya, atau yang akan dihapusnya. Verify tidak menulis kedua berkas tersebut, dan menyebutkan setiap entri semacam itu, di berkas mana pun, dalam proses yang sama.

Dua jenis entri lockfile dilaporkan tanpa menanyai registry, karena pull menulis ulang entri tersebut apa pun jawaban registry, sehingga entri tersebut juga dilaporkan dalam postur offline: entri yang dilayani content cache yang tidak mencatat tanda tangan padahal konfigurasi kepercayaan mengharuskannya — pull mencatat tanda tangan artefak tersebut, atau berhenti jika tidak dapat memastikannya — dan entri yang tanda tangan tercatatnya dibuat untuk artefak lain, yang akan diganti pull dengan tanda tangan milik artefak itu sendiri.

Setiap entri lain yang akan dicari ulang oleh pull ditanyakan, karena hanya jawaban registry yang menentukan apakah pull akan mengubahnya: entri yang byte-nya diambil oleh verify karena content cache tidak menyimpannya, dan entri yang bundel tanda tangan tersimpannya telah dihapus, tidak dapat dibaca, atau telah diubah. Verify menanyai registry sebagaimana pull melakukannya, melaporkan entri tersebut jika jawabannya mencatat, mengganti, atau menghapus tanda tangannya, dan menyimpan bundel yang diverifikasinya ke cache sebagaimana pull menyimpannya. Dalam postur offline, entri semacam itu tidak ditanyakan dan tidak dilaporkan: verify mencetak satu baris yang menyebutkannya dan menyatakan bahwa tanda tangannya tidak diperiksa.

Untuk catatan kepercayaan plugin, setiap pull memverifikasi tanda tangan setiap plugin yang dilampirkan pada peran verdict di registry-nya, demikian pula verify: entri yang tanda tangannya akan dicatat, diganti, atau dihapus oleh verifikasi tersebut dilaporkan, begitu pula plugin yang tidak memiliki entri dalam catatan padahal build menolaknya karena tidak mencatat tanda tangan, karena pull menulis entri yang membawa tanda tangannya dan build menolak plugin tersebut sampai saat itu. Plugin lain yang belum dimuat dalam catatan adalah penemuan pertama dan tidak dilaporkan. Dalam postur offline, verify tidak menanyai registry mana pun tentang plugin-plugin ini: verify membaca masing-masing dari content cache, sebagaimana build membacanya, dan menguji identitas serta fungsi host-nya sebagaimana verify yang terhubung. Verify melaporkan tanpa bertanya plugin yang ditolak build karena tidak mencatat tanda tangan — entrinya tidak mencatat tanda tangan, atau catatan tidak memiliki entri untuknya — dan plugin yang ditolak build karena tanda tangan yang dicatat entrinya dibuat untuk artefak lain, karena pull menulis ulang entri tersebut apa pun jawaban registry; verify mencetak satu baris yang menyebutkan setiap entri lainnya dan menyatakan bahwa tanda tangannya tidak diperiksa.

Penanda deprecation tidak dibandingkan. Penanda yang dilampirkan pada artefak setelah pull merupakan status registry dan berubah tanpa ada yang berubah di workspace, sehingga verify yang gagal karenanya akan menggagalkan pemeriksaan atas berkas yang tidak disentuh siapa pun — alasan yang sama mengapa penanda yang tercatat hanya memberi peringatan kepada build alih-alih menghentikannya.

Pesan yang dikeluarkan, satu per entri, menyebutkan entri, berkas dan apa yang dicatatnya, apa yang akan dicatat pull sebagai gantinya, serta pull yang memperbarui berkas tersebut. Jika jawaban registry, atau verifikasi catatan itu sendiri, memberikan tanda tangan yang akan dicatat pull:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: tanda tangan yang tercatat bukan yang akan dicatat oleh pull (berkas mencatat tanda tangan, pull akan mencatat tanda tangan lain). remediation: jalankan pull untuk memperbarui berkas)

untuk entri yang tidak mencatat tanda tangan padahal diwajibkan — entri lockfile, atau, dalam postur offline, entri catatan kepercayaan plugin:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: tanda tangan yang tercatat bukan yang akan dicatat oleh pull (berkas tidak mencatat tanda tangan, pull akan meminta registry-nya tanda tangan yang diminta oleh suatu persyaratan dan mencatatnya). remediation: jalankan pull untuk memperbarui berkas)

untuk entri yang tanda tangan tercatatnya dibuat untuk artefak lain — entri lockfile, atau, dalam postur offline, entri catatan kepercayaan plugin:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: tanda tangan yang tercatat bukan yang akan dicatat oleh pull (berkas mencatat tanda tangan yang dibuat untuk artefak lain, pull akan meminta registry-nya tanda tangan milik artefak ini dan mencatatnya). remediation: jalankan pull untuk memperbarui berkas)

dan untuk plugin yang tidak memiliki entri dalam catatan, padahal build menolaknya karena tidak mencatat tanda tangan — bentuk kedua berlaku dalam postur offline, ketika verify tidak menanyai registry mana pun:

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: tanda tangan yang tercatat bukan yang akan dicatat oleh pull (catatan tidak memiliki entri untuknya dan tanda tangan diwajibkan untuknya, pull akan mencatat tanda tangan). remediation: jalankan pull untuk memperbarui catatan)

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: tanda tangan yang tercatat bukan yang akan dicatat oleh pull (catatan tidak memiliki entri untuknya dan tanda tangan diwajibkan untuknya, pull akan meminta registry-nya tanda tangan yang diminta oleh suatu persyaratan dan mencatatnya). remediation: jalankan pull untuk memperbarui catatan)

<signature> menyatakan tanda tangan berdasarkan modenya, penandatangannya, dan digest bundelnya — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, dengan issued by <issuer> setelah penandatangan untuk tanda tangan keyless — atau berupa no signature. <file> adalah lockfile Release, <lockfile-path>, atau plugins-trust.yaml di direktori Release, <record-path>.

Cara memperbaiki: jalankan pull yang disebutkan pesan. Pull menulis ke berkas yang disebutkan tanda tangan yang dinyatakan pesan, dan menyimpan bundelnya ke cache, sehingga verify berikutnya lolos. Jika pesan menyatakan bahwa pull akan menanyai registry, pull mencatat apa yang diverifikasi registry — dan sebaliknya berhenti, dengan menyebutkan artefaknya, jika registry melampirkan tanda tangan yang tidak diterima konfigurasi kepercayaan, atau tidak melampirkan tanda tangan padahal diwajibkan, yang merupakan persoalan bagi siapa pun yang menerbitkannya. Dalam postur offline, pull tersebut berhenti: atas entri lockfile dengan penolakan offline, karena pull harus menanyai registry, dan atas plugin yang dilampirkan pada peran verdict sebelum itu, dengan menyebutkan .wasm plugin tersebut sebagai yang tidak dapat di-resolve, karena pull me-resolve .wasm tersebut dari registry plugin. Mengizinkan jaringan untuk satu proses tersebut memperbarui berkasnya. Jika pesan menyatakan bahwa pull tidak akan mencatat tanda tangan, registry tidak lagi melampirkannya dan tidak ada yang mewajibkannya: pull menghapus tanda tangan entri tersebut, yang diterima build dengan pengaturan yang sama — jika Anda tidak menduga registry berhenti menandatangani artefak tersebut, hal itu juga merupakan persoalan bagi penerbitnya.

.wasm milik plugin tidak ada di mesin ini

.wasm milik plugin dibaca dari salah satu dari empat tempat, dengan urutan ini: plugin yang tertanam di dalam biner compiler, sebuah berkas di samping entitas Plugin milik plugin tersebut di sebuah direktori katalog, sebuah path sistem berkas eksplisit yang disebutkan oleh referensi, dan cache konten workspace yang diisi oleh aggrega pull. Me-resolve sebuah plugin hanya membaca apa yang sudah ada di mesin dan tidak mengambil apa pun, sehingga kondisi ini melaporkan bahwa tidak satu pun dari keempat tempat itu menyimpan byte-nya — bukan bahwa sebuah unduhan gagal. Satu plugin merupakan pengecualian: core importer yang dibutuhkan oleh sebuah impor. Modulnya hanya dibaca dari biner atau cache konten, tidak pernah dari samping sebuah entitas katalog, dan jika keduanya tidak menyimpannya, impor mengambilnya sekali dari registry default workspace; kondisi ini kemudian juga melaporkan bahwa pengambilan tersebut tidak mungkin dilakukan — workspace sedang offline, registry-nya tidak dapat dijangkau atau tidak menyimpan modul tersebut, atau workspace tidak menyebutkan registry default. Modul yang telah diambil tetapi tidak lolos verifikasi ditolak di bawah kondisinya sendiri, yaitu ketidakcocokan digest atau penolakan tanda tangan, dan tidak ada yang disimpan.

Berkas di samping entitas dinamai berdasarkan tipe plugin dan nama entitas, dan penolakan pull di bawah ini memberikan nama tersebut: untuk pipeline-step/patch namanya adalah pipeline-step--patch.wasm, di direktori tempat dokumen entitas berada.

Entitas Plugin yang ditulis di salah satu direktori katalog Anda ditolak ketika pull me-resolve-nya. Pull tidak pernah mengambil .wasm milik entitas semacam itu: pull mencari di keempat tempat di atas, persis di tempat build mencari. Pipeline step, provider, atau plugin yang dilampirkan pada peran verdict sama sekali tidak di-pin, dan build membaca entitasnya dari direktori katalog setiap kali. Plugin yang dilampirkan pada peran transform di-pin, karena byte-nya membentuk output yang dirender: pull mencatat entitasnya beserta digest konten .wasm yang ditemukannya di sana, dan build menolak .wasm yang tidak lagi cocok. Karena itu, pull yang tidak menemukan artefak di satu pun dari keempat tempat tersebut berhenti di situ, sebelum menulis lockfile atau entity.lock apa pun, alih-alih membiarkan build gagal belakangan, pada langkah yang memuat plugin. .wasm yang dibawa oleh biner, atau yang sudah ada di cache konten, memenuhi pull persis seperti memenuhi build, sehingga entitas untuk plugin yang disertakan di dalam compiler tidak memerlukan berkas di sampingnya.

Pesan yang dikeluarkan. Penolakan pull, yang menunjuk ke direktori tempat berkas diharapkan berada, dengan resolusi yang ditanyakannya di bawahnya:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (artefak plugin tidak ditemukan di mesin ini (entitas Plugin ditulis di sebuah direktori katalog, berkas yang diharapkan tidak ada di direktori tersebut). Letakkan .wasm hasil build di samping entitas dengan nama tersebut, atau publikasikan plugin dan rujuk entitas Plugin yang dipublikasikan, bukan yang ada di direktori katalog)

plugin yang dimuat oleh build atau impor tanpa ada sumber yang menyimpan byte-nya — dan plugin yang dilampirkan pada peran verdict yang dibaca oleh aggrega pull --verify dalam postur offline dari cache konten sebagaimana dilakukan build. Jika entitas Plugin milik plugin tersebut berada di folder katalog, pesan menyebut versinya dan tempat modulnya harus diletakkan:

plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (plugin pada versi yang disebut tidak ada di mesin ini; letakkan modulnya, dengan nama file yang disebut, di samping entitas Plugin-nya di direktori yang disebut: artefak plugin tidak ditemukan di mesin ini)

dan selain itu, dengan menyebut setiap tempat modul dicari:

plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (plugin tidak ada di mesin ini: biner tidak membawa modulnya, tidak ada folder katalog yang memuat entitas Plugin-nya, dan cache konten tempat pull mengambil juga tidak memuatnya: artefak plugin tidak ditemukan di mesin ini)

Lint, yang hanya mencari di dalam biner, hanya menyebut tempat pertama di antara tempat-tempat tersebut.

dan hal yang sama untuk referensi yang ditulis sebagai lokasi registry:

plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (plugin tidak dapat di-resolve: URI plugin OCI memerlukan pull sebelumnya (agar byte-nya tersimpan di cache) atau path lokal eksplisit; resolusi plugin tidak mengambil dari registry: artefak plugin tidak ditemukan di mesin ini)

core importer yang tidak dapat dibaca maupun diambil oleh sebuah impor, dengan menyebutkan importer tersebut, versinya, dan alasannya — di sini karena workspace sedang offline — lalu apa yang dapat menempatkan modulnya di mesin:

core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (core importer pada versi tersebut tidak ada di mesin ini, dan workspace sedang offline, sehingga registry-nya tidak ditanya; jalankan impor sekali dengan jaringan tersedia, yang mengambilnya dari registry default workspace, memverifikasinya, dan menyimpannya di cache konten untuk setiap impor berikutnya, atau letakkan modulnya, dengan nama tersebut, di samping entitas Plugin dari importer tersebut pada versi itu di sebuah folder katalog: artefak plugin tidak ditemukan di mesin ini)

Alasan lainnya berbunyi its registry <host> could not be reached (<cause>) (registry-nya tidak dapat dijangkau), its registry <host> holds no <location>:<version> (registry-nya tidak menyimpan lokasi pada versi tersebut) dan the workspace names no default registry to fetch it from (workspace tidak menyebutkan registry default untuk mengambilnya); dua yang terakhir hanya menyebutkan solusi kedua, karena menjalankan dengan jaringan tersedia tidak akan mengubahnya.

Cara memperbaiki: jika entitas tersebut adalah entitas yang Anda tulis, build plugin dan letakkan .wasm-nya di samping entitas dengan nama yang diberikan pesan — atau publikasikan plugin dengan aggrega push dan rujuk entitas yang dipublikasikan sebagai pengganti salinan di katalog, karena baik pull maupun build tidak mengambil .wasm dari entitas di katalog Anda. Jika plugin tersebut adalah plugin yang Anda gunakan dari sebuah registry, jalankan aggrega pull untuk release tersebut, yang akan menyimpannya di cache. Jika Anda mengharapkan compiler membawa plugin itu sendiri, periksa apakah biner yang Anda jalankan memang membawanya: aggrega plugin list menyebutkan plugin yang tertanam. Jika itu adalah core importer, jalankan impor sekali di tempat workspace dapat menjangkau registry default-nya — run tersebut mengambil, memverifikasi, dan menyimpannya di cache, dan setiap impor berikutnya berjalan offline — atau, jika registry tersebut tidak menyimpannya, letakkan modulnya di samping entitas Plugin dari importer tersebut pada versi itu di sebuah folder katalog, dengan nama yang diberikan pesan; entitas tersebut kemudian berjalan menggantikan core importer.

A plugin recorded as a trusted gate is no longer attached (Plugin yang tercatat sebagai gerbang tepercaya tidak lagi terpasang)

Plugin yang mengembalikan putusan terima-atau-tolak atas suatu build dicatat setelah di-resolve, sehingga workspace menyimpan catatan tentang gerbang mana saja yang telah ditinjau. Kondisi ini adalah yang dilaporkan oleh gerbang tercatat yang tidak lagi dipasang oleh apa pun. Alasan kondisi ini menghentikan build alih-alih lolos diam-diam adalah bahwa keluarannya jika tidak demikian tidak dapat dibedakan dari keluaran yang disetujui gerbang: build tanpa gerbang secara diam-diam dan build yang diloloskan gerbang menghasilkan berkas yang sama, dan tidak seorang pun yang meninjau hasilnya dapat mengetahui mana yang sedang dipegangnya.

Ini adalah persoalan yang berbeda dari plugin yang byte-nya telah bergeser. Kondisi itu menolak menjalankan plugin yang bukan plugin yang telah ditinjau — persoalan identitas. Kondisi ini menolak melakukan build ketika gerbang yang telah ditinjau hilang sama sekali — persoalan keberadaan. Karena itu, solusinya pun berbeda: memulihkan artefak, dibandingkan memulihkan pemasangan.

Apa yang dipastikannya, dan apa yang tidak. Menyelaraskan konfigurasi dengan catatan memastikan bahwa setiap gerbang yang tercatat masih terpasang dan bahwa artefak masing-masing adalah artefak yang tercatat. Hal ini tidak memastikan apa pun tentang apakah gerbang yang terpasang benar-benar mengembalikan putusan: pemasangan yang fungsi entrinya menyebut export terdeklarasi yang tidak mengembalikan putusan tetap berjalan, tidak melaporkan apa pun, dan meloloskan build, dan tidak ada perbandingan terhadap catatan yang menyadarinya — plugin yang berjalan persis plugin yang tercatat dan hanya saja tidak menjalankan apa-apa. Dua kasus yang berdekatan memang menghentikan build, dan keduanya disebutkan agar batas ini tidak dibaca lebih luas daripada sebenarnya: fungsi entri yang menyebut export yang tidak dideklarasikan plugin ditolak saat plugin dimuat, dan keluaran yang membawa kunci yang tidak dideklarasikan oleh bentuk putusan ditolak alih-alih dibaca sebagai daftar putusan kosong.

Pesan yang dikeluarkan, menyebutkan catatan, gerbang yang dihapus, dan kedua solusinya:

a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (plugin yang tercatat sebagai tepercaya untuk putusan terima-atau-tolak tidak lagi terpasang pada peran putusan mana pun: catatan mencatat plugin sebagai tepercaya, tetapi tidak ada pemasangan putusan dalam konfigurasi workspace yang menyebutnya; gerbang yang telah ditinjau dan kini tidak ada meninggalkan keluaran yang tidak dapat dibedakan dari keluaran yang disetujui gerbang itu. Pasang kembali plugin pada peran putusan IR atau render, atau sebagai linter; atau, jika memang dimaksudkan untuk dihapus, jalankan upgrade untuk menghapusnya dari catatan — pull biasa membiarkan catatan apa adanya, sehingga hanya upgrade eksplisit yang menghapus entri)

Jika lebih dari satu gerbang dihapus, semuanya disebutkan bersama dalam satu perintah upgrade alih-alih satu perintah untuk masing-masing: upgrade tertarget menerima beberapa target dan membiarkan setiap pin yang tidak disebutkannya, sehingga menyebutkannya bersama lebih singkat sekaligus lebih sempit daripada penyegaran penuh yang diperlukan oleh alternatifnya.

Cara memperbaiki: pesan menawarkan dua solusi karena hanya Anda yang tahu mana yang berlaku. Jika gerbang dihapus karena kesalahan, pasang kembali plugin di bawah plugins.governance pada peran putusan, atau di bawah plugins.linter. Jika memang dimaksudkan untuk dihapus, nyatakan secara eksplisit dengan upgrade tertarget yang dijabarkan pesan, yang menghapus entrinya. Jangan mengedit atau menghapus catatan untuk mengatasi ini — catatan itu adalah rekaman yang di-commit tentang apa yang telah ditinjau, dan pull biasa sengaja membiarkannya, karena menerima penghapusan secara diam-diam justru adalah hal yang hendak dicegah oleh penolakan ini.

A gate recorded as trusted resolves to a different identity (Gerbang yang tercatat sebagai tepercaya di-resolve ke identitas yang berbeda)

Plugin yang mengembalikan putusan terima-atau-tolak atas suatu build dicatat setelah di-resolve, bersama versi dan digest artefak hasil resolusinya. Kondisi ini adalah yang dilaporkan oleh resolusi berikutnya ketika mencapai versi lain atau byte lain untuk gerbang yang sudah ada dalam catatan, sementara run tersebut tidak pernah meminta agar identitas itu diterima.

Satu kondisi mencakup baik versi yang berpindah maupun byte yang berpindah, karena catatan dialamatkan berdasarkan identitas plugin dan membawa versi serta digest sebagai field dari satu entri: membandingkan resolusi dengannya adalah satu perbandingan dengan satu hasil. Publikasi ulang yang tidak mengubah byte dan push ulang pada versi yang sama adalah peristiwa yang sama bagi peninjau — identitasnya bukan lagi identitas yang telah ditinjau.

Ini adalah persoalan yang berbeda dari gerbang tercatat yang tidak lagi dipasang oleh apa pun, yang merupakan persoalan keberadaan, bukan identitas. Ini juga berbeda dari plugin yang byte tersimpannya tidak sesuai dengan digest yang tercatat: kondisi itu menolak menjalankan plugin yang bukan plugin yang telah ditinjau, dan solusinya adalah memulihkan atau mencatat ulang artefak, sedangkan kondisi ini menolak menerima identitas baru tanpa diminta, dan solusinya adalah menyebutkan plugin dalam upgrade. Dua solusi, dua kondisi.

Meminta identitas baru adalah hal yang sudah ditawarkan pull, dan ada dua cara untuk memintanya. Penyegaran penuh me-resolve ulang semuanya, dan upgrade tertarget me-resolve ulang plugin yang disebutkannya; keduanya dibaca sebagai permintaan atas identitas baru, dan catatan diperbarui. Pull lain mana pun mempertahankan identitas yang tercatat dan berhenti, dan itulah tujuan pencatatannya — catatan yang menerima apa pun yang di-resolve berikutnya akan mengikuti resolusi alih-alih mengaturnya. Kemunculan pertama bukanlah ketidaksesuaian: identitas yang belum ada dalam catatan cukup diisikan.

Perbandingan juga berjalan pada pull yang hanya memverifikasi, yang tidak menulis catatan maupun lockfile. Verifikasi yang melewati catatan sambil memeriksa lockfile di sampingnya akan melaporkan kesesuaian yang tidak pernah diperiksanya.

Pesan yang dikeluarkan, menyebutkan plugin, kedua identitas, dan kedua solusinya:

plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (plugin: catatan mencatat suatu versi dengan suatu digest sebagai tepercaya untuknya, tetapi resolusi ini melaporkan versi dengan digest yang lain; tinjau apa yang berubah dan terima dengan upgrade, atau pulihkan identitas yang tercatat: identitas plugin yang tercatat sebagai tepercaya tidak lagi sesuai dengan yang dilaporkan resolusi ini)

Cara memperbaiki: tentukan mana dari kedua identitas yang Anda maksud, karena hanya Anda yang dapat melakukannya. Jika perpindahan itu memang Anda kehendaki — gerbang dipublikasikan ulang dan Anda telah meninjau apa yang berubah — terima dengan upgrade tertarget yang dijabarkan pesan, yang me-resolve ulang plugin tersebut dan menulis ulang entrinya. Jika Anda tidak mengharapkannya, identitas yang tercatat adalah identitas yang telah ditinjau: pulihkan versi atau artefak yang disebutkan catatan, dan selidiki mengapa referensi kini di-resolve ke tempat lain. Jangan mengedit catatan untuk mengatasi ini — catatan itu adalah pernyataan yang di-commit tentang apa yang telah ditinjau, dan pull biasa sengaja membiarkannya, karena menerima gerbang yang berubah secara diam-diam justru adalah hal yang hendak dicegah oleh penolakan ini.

Klaim entitas Plugin tidak sesuai dengan laporan diri plugin itu sendiri

Entitas Plugin menyatakan apa yang ditawarkan oleh plugin yang dirujuknya: ekspor apa saja yang dimilikinya, apa yang dioperasikan oleh masing-masing ekspor dan pada cakupan apa, serta — untuk plugin yang melayani provider — bagaimana perilakunya saat merender. Plugin melaporkan hal yang sama tentang dirinya saat dimuat. Kondisi ini adalah yang dilaporkan oleh ketidaksesuaian di antara keduanya.

Perbandingan dilakukan per ekspor, dengan kunci berupa nama, dan berjalan dalam satu arah: semua yang diklaim entitas harus sesuai, dan plugin boleh menawarkan lebih banyak. Entitas yang menjelaskan sebagian permukaan plugin tidak diwajibkan untuk mencantumkan sisanya, sehingga ekspor yang dideklarasikan plugin tetapi dihilangkan oleh entitas bukanlah ketidaksesuaian. Yang merupakan ketidaksesuaian adalah ekspor yang diklaim tetapi tidak dideklarasikan plugin, atau ekspor yang diklaim yang operates atau scope-nya berbeda dari yang dilaporkan plugin. Selektor bentuk bebas tidak dibandingkan.

Jika entitas juga menulis blok perilaku render, field-fieldnya dibandingkan satu per satu — jenis input, mode perakitan, pasangan pembatas templat artefak, anotasi nama perakitan, klaim instans yang dapat digunakan ulang, klaim penautan lintas batas, klaim entri omit, dan direktori penyarangan — dan field pertama yang tidak sesuai adalah yang disebutkan. Entitas yang tidak menulis blok semacam itu melewati perbandingan tersebut sepenuhnya.

Pemeriksaan yang sama dijalankan saat publikasi, sehingga ketidaksesuaian biasanya muncul sebelum entitas dipublikasikan, bukan saat build memuatnya.

Pesan yang dikeluarkan. Ekspor yang diklaim tetapi tidak dimiliki plugin:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (entitas mengklaim ekspor yang tidak dideklarasikan oleh describe() plugin: wasm: klaim kontrak entitas tidak sesuai dengan describe() plugin)

sebuah field pada ekspor yang diklaim:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (ekspor entitas mendeklarasikan operates, tetapi describe() plugin melaporkan nilai lain: wasm: klaim kontrak entitas tidak sesuai dengan describe() plugin)

dan sebuah field perilaku render, yang dilaporkan dalam bentuk yang sama dengan menyebutkan field yang tidak sesuai:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (entitas mendeklarasikan boundary_assembly, tetapi describe() plugin melaporkan nilai lain: wasm: klaim kontrak entitas tidak sesuai dengan describe() plugin)

Cara memperbaiki: yang perlu dikoreksi adalah klaim entitas Plugin, bukan Aggregate atau Release Anda. Sesuaikan klaim dengan yang dilaporkan plugin — pesan menyebutkan kedua nilai, sehingga arah perubahannya terlihat dalam pesan itu sendiri. Jika entitas tersebut Anda publikasikan, membuat ulang entitas dari binary adalah cara yang andal untuk menyelaraskan keduanya; jika Anda mengonsumsi entitas yang sudah dipublikasikan, pilih versi yang klaimnya sesuai dengan binary yang dirujuknya, dan laporkan ketidaksesuaian tersebut kepada pihak yang memublikasikannya.

Kumpulan perintah yang tercatat pada entitas Plugin tidak sesuai dengan plugin

Plugin yang menyumbangkan perintah terminal memiliki perintah-perintah tersebut tercatat dalam entitas Plugin-nya. Catatan itu ditulis oleh mesin, bukan ditulis oleh penulis: catatan dibaca dari plugin lalu dituliskan, sehingga mencerminkan binary secara persis. Kondisi ini adalah yang dilaporkan oleh catatan yang sudah tidak lagi mencerminkannya — perbedaan pada nama perintah, pada teks bantuan singkatnya, atau pada urutan deklarasi perintah.

Perbandingannya adalah kesamaan penuh, dan hal itu disengaja. Klaim kapabilitas dan ekspor di bagian lain entitas bersifat dikurasi: penulis secara sah dapat menjelaskan sebagian permukaan dan menghilangkan sisanya, sehingga klaim tersebut diperiksa sebagai subset. Catatan perintah tidak dikurasi, sehingga apa pun yang kurang dari kesesuaian persis berarti catatan telah menyimpang dari apa yang sebenarnya ditawarkan plugin, dan daftar perintah yang mendekati tetapi tidak tepat adalah yang dapat salah mengarahkan pemanggilan.

Plugin yang dimuat tanpa entitas tidak diperiksa di sini. Catatan berada pada entitas, sehingga bytes yang dimuat secara langsung tidak membawa catatan dan perbandingan tidak memiliki apa pun untuk dibandingkan.

Pesan yang dikeluarkan, menyebutkan kedua kumpulan dan cara mencatatnya ulang:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (cermin perintah yang tercatat tidak sesuai dengan perintah describe() plugin; jalankan ulang perintah sinkronisasi dan commit hasilnya: wasm: cermin perintah yang tercatat tidak sesuai dengan describe() plugin)

Perbandingan yang sama saat publikasi melaporkan kedua kumpulan tanpa instruksi pencatatan ulang:

plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (cermin perintah yang tercatat tidak sesuai dengan perintah describe() plugin: wasm: cermin perintah yang tercatat tidak sesuai dengan describe() plugin)

Cara memperbaiki: catat ulang kumpulan tersebut dari binary dan commit hasilnya — pesan menyebutkan perintah yang melakukannya. Jangan mengedit catatan secara manual agar sesuai: catatan dimiliki oleh mesin, dan editan manual yang kebetulan sesuai hari ini akan diturunkan ulang dan ditimpa saat catatan berikutnya dibuat. Jika Anda mengonsumsi entitas yang sudah dipublikasikan alih-alih memublikasikannya, entitas tersebut dipublikasikan dengan catatan yang tidak didukung oleh binary-nya sendiri, dan hal itu merupakan urusan pemublikasinya.

Versi yang tercatat pada entitas Plugin tidak sesuai dengan plugin

Plugin melaporkan versi yang dicatat oleh build-nya di dalamnya, dan entitas Plugin-nya juga mencatat sebuah versi; keduanya harus berupa string yang sama. Resep build yang digunakan untuk membangun plugin Aggrega mengambil versi tersebut dari tag yang merilis plugin — tag milik compiler untuk plugin yang dikirimkan bersama compiler, tag milik plugin sendiri untuk plugin yang dikirimkan di luarnya — sehingga build dari commit yang disebut oleh tag melaporkan versi rilis, dan build dari commit lain mana pun melaporkan versi pengembangan seperti 1.0.0-3-g1a2b3c4. Kondisi ini adalah yang dilaporkan oleh pasangan yang telah terpisah, dan diperiksa sebelum bytes apa pun dipublikasikan sehingga pasangan yang menyimpang tidak sampai ke katalog.

Perbandingannya adalah kecocokan string yang persis. Plugin yang dibangun tanpa versi build yang tercatat melaporkan versi kosong, dan nilai kosong itulah yang kemudian harus disamai oleh versi entitas — pemeriksaan tidak memperlakukan “tidak ada versi yang dilaporkan” sebagai “versi apa pun diterima”, karena tujuannya adalah agar versi entitas yang dipublikasikan selalu menyatakan apa yang sebenarnya dilaporkan oleh binary-nya.

Pesan yang diemisikan:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (metadata.version yang tercatat tidak sesuai dengan versi describe() plugin: wasm: metadata.version entitas tidak sesuai dengan describe() plugin)

Saat publikasi, penolakan juga menyebutkan file entitas, .wasm, dan perbaikannya:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (metadata.version dalam file entitas tidak sesuai dengan versi describe() .wasm — tetapkan metadata.version ke rilis yang sedang Anda publikasikan dan bangun plugin dari checkout bersih commit yang disebut oleh tag rilis tersebut, sehingga plugin melaporkan versi itu sendiri; untuk rilis baru, commit entitas bersama sumber yang dirilisnya dan beri tag pada commit tersebut terlebih dahulu: metadata.version yang tercatat tidak sesuai dengan versi describe() plugin: wasm: metadata.version entitas tidak sesuai dengan describe() plugin)

Cara memperbaiki: jadikan metadata.version entitas sebagai rilis yang sedang Anda publikasikan, dan bangun plugin dari checkout bersih commit yang disebut oleh tag rilis tersebut, sehingga plugin melaporkan versi itu sendiri. Untuk rilis baru, commit entitas bersama sumber yang dirilisnya dan beri tag pada commit tersebut terlebih dahulu — tag harus menyebut commit yang sudah memuat entitas. Jangan menyalin versi yang dilaporkan plugin ke dalam entitas: build dari commit lain mana pun melaporkan versi pengembangan, dan menyalinnya akan memublikasikan build tersebut dengan versi yang tidak disebut oleh tag rilis mana pun. Jika plugin sama sekali tidak melaporkan versi, plugin dibangun tanpa versinya tercatat; bangun plugin dengan versinya tercatat.

A plugin was built from a working tree with uncommitted changes (Plugin dibangun dari working tree dengan perubahan yang belum di-commit)

Build sebuah plugin mencatat versinya dari commit tempat plugin itu dibangun, dan build yang dibuat dari working tree dengan perubahan yang belum di-commit membawa tanda -dirty di akhir versi tersebut — 1.0.0-dirty pada sebuah tag, 1.0.0-3-g1a2b3c4-dirty setelahnya. Versi semacam itu adalah versi semantik yang valid, tetapi menunjuk commit yang tidak memuat byte yang dibangun, sehingga tidak ada yang dapat membangun ulang apa yang akan dipublikasikan dari versi tempat ia akan dipublikasikan. Publikasi sebuah Plugin menolak plugin yang versinya sendiri membawa tanda tersebut, sebelum byte apa pun dipublikasikan dan sebelum registry dihubungi; dry run juga menolaknya.

Hanya tanda tersebut yang ditolak. Versi pengembangan yang dibangun dari sebuah commit, seperti 1.0.0-3-g1a2b3c4, menunjuk commit yang memang memuat apa yang dibangun, dan dapat dipublikasikan; demikian pula prerelease seperti 1.0.0-rc.1. Validasi plugin terhadap entitasnya di luar publikasi tidak memunculkan kondisi ini, karena build yang sedang dikembangkan lazimnya dibuat dari tree yang telah diedit.

Pemeriksaan ini membaca versi yang dilaporkan plugin tentang build-nya sendiri, dan dijalankan sebelum perbandingan dengan metadata.version milik entitas — sehingga plugin yang dibangun dengan perubahan yang belum di-commit di bawah entitas yang mencatat versi bersih dilaporkan di sini, bukan sebagai a recorded version that does not match the plugin (versi tercatat yang tidak cocok dengan plugin).

Pesan yang dikeluarkan, menyebutkan plugin, versi yang dilaporkannya, dan cara memperbaikinya:

Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty") (Plugin: .wasm di path tersebut dibangun dari working tree dengan perubahan yang belum di-commit — setel metadata.version di path entitas ke rilis yang Anda publikasikan dan bangun plugin dari checkout bersih atas commit yang ditunjuk tag rilis tersebut, sehingga plugin melaporkan versi itu sendiri; untuk rilis baru, commit entitas bersama source yang dirilisnya dan beri tag pada commit itu terlebih dahulu: plugin dibangun dari working tree dengan perubahan yang belum di-commit, sehingga tidak ada commit yang mereproduksi versi yang dilaporkannya (plugin, versi describe(), yang berakhiran dengan tanda dirty))

Cara memperbaiki: bangun plugin dari checkout bersih atas commit yang ditunjuk tag rilis, sehingga plugin melaporkan versi rilis yang dicatat entitas. Untuk merilis perubahan itu sendiri, setel metadata.version milik entitas ke rilis baru, commit entitas bersama perubahan tersebut, beri tag pada commit itu, dan lakukan build di sana. Hanya melakukan commit perubahan lalu membangun ulang tidak membuka jalan menuju rilis: plugin hasil build ulang melaporkan versi pengembangan, dan menyalinnya ke entitas akan memublikasikan build tersebut di bawah versi yang tidak ditunjuk oleh tag rilis mana pun.

A Plugin entity’s recorded host functions do not match the binary (Fungsi host yang tercatat pada entitas Plugin tidak cocok dengan biner)

Sebuah plugin mendeklarasikan panggilan host mana yang digunakannya, dan himpunan itu dicatat pada entitas Plugin-nya saat plugin dipublikasikan — dibaca dari biner itu sendiri, bukan ditulis oleh penulis. Saat plugin diambil, himpunan tersebut diturunkan kembali dari byte yang kontennya baru saja diverifikasi, lalu dibandingkan dengan catatan. Perbedaan ke arah mana pun menghentikan pengambilan.

Pemeriksaan ini berada di atas pin konten, bukan mengulanginya, dan menangkap dua hal yang tidak ditangkap pin saja: biner yang dipublikasikan melalui sesuatu selain jalur publikasi biasa, yang tidak membawa catatan atau membawa catatan yang tidak menggambarkan byte-nya sendiri; dan kesalahan pada langkah pencatatan itu sendiri. Pin memastikan bahwa byte tersebut adalah byte yang di-pin; pemeriksaan ini memastikan bahwa apa yang dicatat tentang byte tersebut memang benar.

Entitas yang tidak membawa catatan dibandingkan dengan himpunan kosong, yang cocok dengan plugin yang tidak menggunakan satu pun panggilan host — kesesuaian yang sama-sama tidak bermasalah dari arah mana pun, sehingga entitas tanpa catatan tidak ditolak karena tidak memilikinya.

Pesan yang dikeluarkan, menyebutkan plugin, kedua himpunan, dan artefak asal byte tersebut:

plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports (plugin: spec.runtime.hostFunctions yang tercatat tidak cocok dengan himpunan yang diturunkan dari .wasm terverifikasi: wasm: catatan fungsi host tidak cocok dengan import .wasm)

Perbandingan yang sama yang dijalankan saat plugin divalidasi melaporkan kedua himpunan tanpa artefak:

plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports (plugin: catatan fungsi host yang tercatat tidak cocok dengan import .wasm: wasm: catatan fungsi host tidak cocok dengan import .wasm)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini dan tidak ada perubahan penulisan yang menghilangkannya. Publikasikan ulang plugin melalui jalur publikasi biasa, yang menurunkan catatan dari biner dan menulis keduanya bersama-sama. Jika Anda menggunakan plugin yang telah dipublikasikan, entitas dan biner yang ditunjuknya dipublikasikan tidak selaras, jadi laporkan ketidakcocokan tersebut kepada pihak yang memublikasikannya, dengan mengutip kedua himpunan dari pesan — dan jangan mengedit catatan secara manual agar cocok, karena catatan tersebut diturunkan, bukan ditulis, dan penurunan berikutnya akan membuang hasil edit itu.

The lockfile no longer matches what the release resolves to (Lockfile tidak lagi cocok dengan hasil resolusi rilis)

Lockfile sebuah rilis mematok setiap entitas, pustaka, dan plugin yang dijangkau rilis tersebut, masing-masing dengan versi yang dipilih dan sebuah digest, serta mencatat berkas rilis itu sendiri, yaitu rilis tersebut dan setiap rilis yang di-extend-nya, berdasarkan digest kontennya. Digest sebuah entitas mencakup apa yang dibawa oleh publikasinya: dokumennya dan setiap berkas yang disebutkannya di sampingnya, masing-masing berdasarkan path dan byte-nya. Digest sebuah pustaka dan sebuah plugin mencakup byte-nya. Meresolusi rilis kembali menghasilkan himpunan yang sama, lalu keduanya dibandingkan. Kondisi ini melaporkan ketidakcocokan tersebut.

Setiap ketidakcocokan dikumpulkan sebelum satu pun dilaporkan, di seluruh hal yang dipatok lockfile, sehingga satu kali eksekusi memberi Anda gambaran utuh, bukan satu entri demi satu entri.

Bentuk-bentuk ketidakcocokan berikut dilaporkan, dan bentuk-bentuk ini perlu dibedakan karena penanganannya berbeda:

  • Referensi yang tidak dipatok lockfile. Rilis kini menjangkau sesuatu yang tidak memiliki entri di lockfile, yaitu dependensi yang ditambahkan sejak pull yang menulisnya. Entri tersebut menyebutkan di mana rilis memintanya, sehingga Recipe atau FeatureRecipe yang diikat oleh Manifest dilaporkan bersama entri pemetaan yang mengikatnya, dan yang diikat oleh tingkat name menyebutkan instans atau lampiran yang menjadi alasan pemilihannya.
  • Referensi terpatok yang pasangannya berubah. Lockfile mematok satu pasangan versi-dan-digest, sedangkan resolusi menghasilkan pasangan lain. Itu berarti konten vendored yang byte-nya berubah, atau sesuatu di workspace yang berubah: dokumen sebuah entitas atau pustaka diedit, berkas yang disebutkan sebuah entitas (chart di bawah sumbernya, berkas yang diimpornya, entity.lock di sampingnya) diedit, ditambahkan, atau dihapus, atau .wasm di samping entitas sebuah plugin diganti. Entri tersebut menyebutkan entitasnya, bukan berkasnya; aggrega pull --release <release> biasa menyebutkan berkas yang berubah di bawah lock sebuah Recipe atau FeatureRecipe, seperti dijelaskan dalam An entity reads an input the lock beside it records no pin for (Sebuah entitas membaca input yang tidak dipatok oleh lock di sampingnya). Registry yang menyajikan byte lain di bawah versi yang dipatok tidak dilaporkan di sini: pull yang mengambilnya menolaknya, seperti dijelaskan dalam Fetched or cached bytes do not match the digest committed for them (Byte yang diambil atau di-cache tidak cocok dengan digest yang ditetapkan untuknya).
  • Referensi terpatok yang tidak lagi dijangkau rilis. Lockfile masih mematok sesuatu yang tidak lagi menjadi dependensi apa pun dalam rilis.
  • Berkas rilis yang diedit sejak pull. Rilis, atau rilis yang di-extend-nya, tidak lagi memuat byte yang dicatat lockfile untuknya. Segala sesuatu yang diminta rilis (versi sumber mana yang diambil, komponen mana ditempatkan di mana) diresolusi dari isi berkas tersebut, sehingga patokan yang tercatat mungkin tidak lagi menggambarkan apa yang kini dimintanya. Hal ini dilaporkan di sini, sebelum apa pun dirender, alih-alih sebagai kegagalan apa pun yang akan dialami render: versi sumber yang diedit akan muncul belakangan sebagai pengambilan yang tidak menemukan patokan. Lockfile yang sama sekali tidak mencatat berkas rilis melaporkan rilis sebagai tidak tercatat, dan berkas rilis yang tidak lagi di-extend rilis dilaporkan sebagai tidak lagi dibaca.
  • Referensi sumber yang berubah di remote-nya. Sumber yang ditulis pada ref: git dicatat pada commit tempat ref tersebut teresolusi. Setiap pull yang bukan upgrade menanyakan kepada remote ke mana ref kini menunjuk, demikian pula aggrega pull --verify jika jaringan dapat dijangkau; ref yang teresolusi ke commit berbeda dilaporkan di sini alih-alih diadopsi. Hanya keduanya yang melaporkannya: build membaca commit yang tercatat dan tidak bertanya.

Perbandingan dilakukan atas konten, sehingga konten identik yang dijangkau melalui rute berbeda tidak dianggap bergeser: yang harus berbeda agar kondisi ini muncul adalah byte-nya. Untuk berkas rilis, hal itu mencakup perubahan komentar atau spasi, persis seperti untuk Aggregate dan Manifest yang disebutkan rilis. Untuk entitas, yang dibandingkan adalah konten dari apa yang dibawanya, sehingga entitas yang sama yang dibaca dari direktori katalog dan diambil dari registry tidak bergeser, begitu pula checkout yang berkasnya hanya berbeda dalam bit izin, termasuk bit eksekusi, maupun publikasi yang arsipnya dikompresi secara berbeda.

Pesan yang dikeluarkan. Pesan dibuka dengan kalimat kondisi itu sendiri, dan setiap ketidaksesuaian yang dikumpulkan menyusul, masing-masing menyebut sumbunya — dan, untuk entitas, jenisnya, karena entitas diidentifikasi oleh jenis dan URI-nya bersama-sama, sehingga Release yang Aggregate dan Manifest-nya memiliki nama yang sama memiliki dua entri, dan suntingan pada salah satunya dilaporkan terhadap yang disunting:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: kedaluwarsa; tidak lagi cocok dengan hasil resolve Release-nya: entitas, beserta jenisnya, tidak ada di lockfile, dengan lokasi tempat entitas itu dirujuk) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (referensi yang ditunjukkan pada sumbu yang ditunjukkan berubah: versi dan digest di lockfile berbeda dari yang saat ini) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (entitas yang ditunjukkan, dengan jenis yang ditunjukkan, berubah: versi dan digest di lockfile berbeda dari yang saat ini) <axis> "<uri>" no longer used by the release (referensi yang ditunjukkan pada sumbu yang ditunjukkan tidak lagi digunakan oleh rilis) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (dokumen rilis yang ditunjukkan disunting setelah lockfile ditulis: isinya tidak lagi cocok dengan digest yang dicatat, sehingga pin mungkin tidak lagi menggambarkan apa yang dimintanya; me-resolve ulang Release mencatat file yang dibacanya sesuai keadaannya sekarang)

<site> adalah tempat rilis meminta referensi tersebut, ditulis sebagai path ke entri yang menyebutkannya, misalnya manifest.spec.mappings.components.name.db-primary, dengan hingga tiga tempat seperti itu dicantumkan dalam urutan tersortir dan ... setelahnya jika ada lebih banyak. Referensi yang resolusinya tidak mencatat tempat seperti itu dilaporkan tanpa tanda kurung.

Pull yang melaporkan referensi sumber yang berubah menyebutkan artefak sebagaimana ditulis oleh pembuatnya, dengan chart= dan module_subdir= jika sumber menyebutkannya:

source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release>

Build mencetak penanganannya setelah entri-entri tersebut:

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile

Perintah mana yang mengharuskan rilis sesuai dengan lockfile-nya. aggrega build membandingkan sebelum merender dan berhenti. aggrega validate --release, serta setiap pilihan aggrega inspect yang me-resolve rilis — tampilan default, --resolved, --ir-graph, dan --closure — menjalankan perbandingan yang sama segera setelah dependensi rilis di-resolve, dan berhenti dengan pesan serta perbaikan yang sama, tanpa menulis apa pun ke keluaran standar; jadi tidak satu pun meloloskan lockfile yang ditolak build karena telah bergeser. Alat asisten build, validate dengan release, dan describe dengan release menolak dengan ketentuan yang sama. aggrega pull menjalankannya terhadap lockfile yang akan ditulisnya, dan aggrega pull --verify terhadap lockfile yang ada di disk. Perintah yang tidak me-resolve rilis apa pun — aggrega validate tanpa argumen, yang dalam hal ini membaca pin lockfile hanya untuk menemukan induk extends, atau dengan path entitas, serta aggrega inspect --raw atau --output yaml tanpa --ir-graph — tidak terikat pada lockfile, begitu pula rilis yang tidak memiliki lockfile di sampingnya. Server bahasa editor menghentikan build-nya karena hal ini, dan melaporkannya pada permintaan graf sebagai peringatan pada lockfile sambil tetap menggambar grafnya.

Cara memperbaiki: resolusi ulang rilis dan commit lockfile yang ditulis ulang. Untuk semua yang dilaporkan build, aggrega pull --release <release> biasa (perintah yang dicetak build) adalah perbaikan seluruhnya: perintah ini meresolusi rilis sebagaimana keadaannya sekarang, menulis ulang patokan yang berubah dan mempertahankan semua patokan lain, sehingga tidak ada yang bergeser tanpa Anda sentuh. Jika yang berubah adalah berkas di bawah sumber lokal sebuah Recipe atau FeatureRecipe, pull tersebut terlebih dahulu berhenti dengan menyebutkan aggrega pin untuk entitas itu, karena mencatat patokan baru di sampingnya adalah langkah pembuatnya; jalankan perintah itu, atau berikan --pin-sources ke pull, dan pull akan membersihkan pergeserannya. Satu-satunya entri yang tidak dibersihkan pull biasa adalah referensi sumber yang berubah di remote-nya, karena membersihkannya berarti mengadopsi commit yang kini disebutkan referensi tersebut: aggrega pull --upgrade --release <release> melakukannya, dan entri tersebut menyatakannya; jika entity.lock milik Recipe mencatat sumber tersebut, upgrade berhenti dengan cara yang sama sampai commit baru dipatok di sampingnya. Baca entri-entrinya sebelum melakukannya, karena bentuk ketiga adalah yang perlu dicermati: referensi yang tidak lagi dijangkau rilis biasanya adalah dependensi yang sengaja Anda hapus, tetapi jika Anda tidak menghapusnya, ada hal lain yang berubah sehingga referensi itu tidak terjangkau. Pasangan yang berubah pada referensi yang tidak Anda sentuh berarti konten pada versi tersebut bukan konten yang telah ditinjau, dan itu adalah pertanyaan bagi pemasoknya, bukan sesuatu untuk diadopsi tanpa diperiksa.

Pull menjalankan perbandingan yang sama terhadap lockfile yang akan ditulisnya dan tidak menulis lockfile yang ditolak perbandingan tersebut, sehingga lockfile yang baru saja ditulis pull akan lolos untuk build yang diberi input yang sama. Jika kondisi ini muncul lagi tepat setelah pull yang berhasil selesai, kedua eksekusi diberi input yang berbeda: direktori katalog diberikan ke salah satunya saja, atau konfigurasi workspace diedit di antara keduanya. Jalankan pull dan build dengan input yang sama.

An artifact is not at the source the build was told to find it (Artefak tidak berada di sumber tempat build diminta untuk menemukannya)

Referensi katalog menyebutkan sebuah artefak dan sebuah versi. Kondisi ini melaporkan bahwa tidak ada yang sesuai dengan pasangan tersebut — baik di registry tempat referensi tersebut di-resolve, maupun di cache artefak lokal yang dibaca oleh build.

Build membaca cache; build tidak menjangkau keluar dengan sendirinya. Akuisisi adalah langkah terpisah: pull yang me-resolve sebuah release mengambil apa yang dibutuhkan release tersebut dan menuliskannya ke dalam cache, lalu build membaca apa yang ada di sana. Jadi kondisi ini sampai ke build sebagai cache miss, dan sampai ke pull sebagai registry yang tidak memiliki artefak tersebut. Jika build dikonfigurasi untuk mengisi lockfile-nya saat dimulai, akuisisi yang dijalankannya adalah pull yang sama itu.

Pesan yang dikeluarkan. Registry yang tidak memiliki tag tersebut, dan fetch yang me-resolve sebuah manifest yang blob kontennya tidak ada:

oci: "<reference>:<version>": oci: artifact not found at remote source (oci: artefak tidak ditemukan di sumber jarak jauh)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: konten untuk: oci: artefak tidak ditemukan di sumber jarak jauh)

pembacaan cache yang tidak menemukan entri, yaitu bentuk yang ditemui oleh build:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: cache miss untuk: oci: artefak tidak ditemukan di sumber jarak jauh)

dan hal yang sama untuk artefak dalam cache yang manifest-nya tidak ada di sampingnya:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: cache miss manifest untuk: oci: artefak tidak ditemukan di sumber jarak jauh)

Cara memperbaiki: periksa referensi dan versinya terlebih dahulu — versi yang sudah tidak ada dan nama yang salah ketik menghasilkan jawaban yang sama, dan pesan tersebut mengutip keduanya agar dapat dibandingkan dengan katalog. Jika referensinya benar, artefak tersebut belum diakuisisi: jalankan pull untuk release tersebut, yang mengambil apa yang dijangkau release dan mengisi cache. Jika workspace dalam keadaan offline, pull tersebut harus dijalankan dari tempat yang memiliki akses jaringan; build offline hanya membaca apa yang sudah ada di cache, dan inilah yang dilaporkannya jika cache tidak menyimpannya.

The registry will not serve an artifact without credentials it accepts (Registry tidak akan menyajikan artefak tanpa kredensial yang diterimanya)

Registry menjawab, dan menolak: entah tidak ada kredensial yang diberikan, atau kredensial yang diberikan tidak diterima. Ini berbeda dengan registry yang sama sekali tidak dapat dijangkau — di sini percakapan terjadi dan jawabannya adalah tidak.

Empat momen melaporkannya, semuanya saat artefak sedang diakuisisi atau dipublikasikan: me-resolve sebuah referensi, menarik kontennya, mendaftar versi yang dimiliki sebuah repositori, dan memeriksa kredensial pada saat kredensial tersebut disimpan.

Pesan yang dikeluarkan, masing-masing menyebutkan apa yang diminta dan mengutip apa yang dikatakan registry:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: resolve: oci: autentikasi diperlukan atau gagal)

mendaftar versi sebuah repositori, yang menyebutkan statusnya sebagai gantinya:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list: status: oci: autentikasi diperlukan atau gagal)

dan memeriksa kredensial saat kredensial tersebut disimpan:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: verifikasi kredensial untuk: oci: autentikasi diperlukan atau gagal)

Jika kegagalan dimunculkan oleh langkah yang menyediakan remediasi, baris tersebut diakhiri dengan perintah login yang harus dijalankan terhadap host yang diturunkannya:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (remediasi: jalankan aggrega login (atau docker login) untuk host yang disebut sebelum menjalankan ulang aggrega pull —release)

dan, jika sebuah impor sedang mengambil salah satu importer inti compiler, login yang sama sebelum menjalankan impor lagi:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (remediasi: aggrega login (atau docker login) sebelum menjalankan ulang impor)

Repositori chart Helm klasik atau arsip chart, fragmen compose, dan repositori Git yang diambil melalui http atau https juga melaporkan kondisi ini ketika server menolak permintaan sebagai tidak sah, dan remediasinya menyebut entri netrc yang perlu ditambahkan alih-alih login, karena dari file itulah pengambilan tersebut membaca kredensialnya:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (remediasi: tambahkan entri untuk host tersebut (dengan machine, login, dan password) ke file netrc, lalu jalankan perintah lagi)

Cara memperbaiki: ini adalah urusan operator, bukan penulis entitas — tidak ada apa pun dalam Aggregate, Component, atau Recipe yang menyebabkannya. Hub resmi, hub.aggrega.ai, menyajikan apa yang diterbitkannya kepada siapa pun, sehingga membaca darinya tidak memerlukan kredensial, sedangkan menerbitkan ke sana memerlukannya; registry lain mungkin mewajibkan kredensial untuk membaca juga. Login ke host yang disebutkan pesan — atau, untuk sumber yang diambil melalui http atau https, tambahkan entri netrc yang disebutkan remediasi — lalu jalankan akuisisi lagi. Jika Anda sudah login, kredensial di penyimpanan bukan kredensial yang diterima host tersebut untuk repositori itu: login lagi untuk memperbaruinya, dan periksa bahwa akun tersebut memiliki akses baca ke repositori tempat referensi di-resolve, karena repositori privat menjawab persis seperti ini kepada akun yang tidak dapat melihatnya. Jika referensi di-resolve ke host yang tidak Anda harapkan, alias registry atau registry default di .aggrega-config.yaml mengarah ke tempat lain.

The netrc file cannot be read (File netrc tidak dapat dibaca)

Repositori chart Helm klasik atau arsip chart, fragmen compose, dan repositori Git yang diambil melalui http atau https mengambil kredensialnya dari file netrc, yang dibaca saat sumber semacam itu diambil — oleh pull, pin, atau build yang mengisi lockfile-nya. File mana yang dibaca, dan entri mana yang menjawab sebuah permintaan, dijelaskan di Authentication. Kondisi ini melaporkan file netrc yang ada tetapi tidak dapat digunakan: file itu tidak dapat dibaca — misalnya karena merupakan direktori, atau Anda tidak memiliki izin untuk membacanya — atau tidak mengikuti format netrc. Format dibaca secara ketat, karena satu kata yang dibaca di tempat yang salah menggeser setiap kata sesudahnya: kata kunci yang salah eja akan mengubah kata sandi sesudahnya menjadi kata kunci berikutnya, dan permintaan akan dikirim tanpa kredensial, atau dengan kredensial yang salah, sementara file tampak baik-baik saja.

File yang tidak ada bukan kondisi ini: file itu tidak memuat kredensial apa pun, dan permintaan yang membutuhkan kredensial dijawab dengan penolakan server. File yang dapat dibaca pengguna lain di mesin juga bukan kondisi ini: di Linux dan macOS file itu memunculkan satu peringatan yang menyebut file tersebut, dan tetap dibaca.

Pesan menyebut file dan, untuk kesalahan format, barisnya, serta menyatakan apa yang salah semata-mata dalam istilah format — tidak pernah menampilkan kata yang dimuat file, karena kata yang salah tempat bisa jadi adalah kata sandi. Diagnostik ini tidak membawa kategori: file netrc adalah file kredensial milik Anda sendiri, bukan dokumen yang dibaca build.

Pesan yang dikeluarkan untuk kesalahan format, yang berupa salah satu dari: kata yang berada di tempat yang seharusnya kata kunci, kata kunci yang tidak diikuti nilainya, login, password, atau account yang berada sebelum entri machine atau default mana pun, dan kata bertanda kutip yang tidak ditutup pada baris tempat ia dibuka:

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (file netrc tidak dapat dibaca (pada file dan baris yang disebut, sebuah kata berada di tempat yang seharusnya kata kunci (machine, default, login, password, account, atau macdef)). Perbaiki file tersebut, atau atur NETRC ke path file netrc lain untuk dibaca sebagai gantinya)

dan untuk file yang tidak dapat dibaca, dengan mengutip alasannya:

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (file netrc tidak dapat dibaca (file yang disebut dan alasan file itu tidak dapat dibaca). Perbaiki file tersebut, atau atur NETRC ke path file netrc lain untuk dibaca sebagai gantinya)

Cara memperbaiki: buka file yang disebut pesan. Untuk kesalahan format, buka baris yang disebutnya: setiap entri adalah machine <host> — atau default — diikuti login <user> dan password <secret>, dan kata kunci yang salah eja atau dibiarkan tanpa nilai adalah penyebab yang umum. Untuk file yang tidak dapat dibaca, jadikan file itu file yang dapat Anda baca, dan hanya dapat dibaca oleh Anda (chmod 600). Jika file itu bukan file yang Anda maksudkan untuk dibaca, atur NETRC ke path file yang Anda maksud.

The registry could not be reached (Registry tidak dapat dijangkau)

Percakapan dengan registry tidak pernah terjadi: resolusi nama, koneksi, atau handshake aman gagal. Ini adalah padanan dari registry yang menjawab dan menolak — tidak ada yang dipastikan di sini, sehingga keadaan artefak di ujung sana tidak diketahui, bukan diketahui tidak ada.

Ini juga yang dilaporkan oleh kegagalan transport tanpa penyebab yang lebih spesifik saat sumber sebuah Recipe sedang diakuisisi, sehingga ini adalah jawaban umum “ujung sana tidak dapat dijangkau” pada jalur tersebut, bukan klaim tentang lapisan mana yang gagal.

Pesan yang dikeluarkan, menyebutkan sumber yang sedang diakuisisi dan mengutip kegagalan transport yang mendasarinya, beserta remediasi yang dibawa kondisi tersebut:

sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported (sourceresolver: oci: jaringan tidak dapat dijangkau (penyebab: …); remediasi: periksa konektivitas jaringan ke host; proxy perusahaan biasanya memerlukan HTTPS_PROXY diekspor)

Cara memperbaiki: perbaikannya adalah urusan operator dan berada di luar katalog Anda. Periksa bahwa host dalam pesan dapat dijangkau dari tempat perintah dijalankan. Jika lingkungan menjangkau jaringan melalui proxy, proxy tersebut harus diekspor ke lingkungan, seperti yang disebutkan remediasi — proxy yang hanya dikonfigurasi untuk browser atau package manager tidak akan terbaca. Jika host dapat dijangkau secara manual tetapi tidak dari sini, perbedaannya biasanya adalah kredensial di proxy atau sertifikat intersepsi yang tidak diterima oleh handshake. Setelah artefak masuk ke cache, build berikutnya membaca cache dan sama sekali tidak memerlukan jaringan.

A server did not answer in time (Server tidak menjawab tepat waktu)

Sebuah permintaan terus menunggu server yang dituju — sebuah registry, atau server lain mana pun yang dijangkau sebuah perintah, seperti log transparansi tempat sebuah tanda tangan dicatat — lalu ditarik. Sebuah permintaan menunggu paling lama 30 detik hingga server mulai menjawab setelah permintaan terkirim seluruhnya, dan paling lama 30 detik untuk bagian berikutnya dari jawaban yang sudah mulai tiba; jika salah satunya terlampaui, permintaan ditolak di bawah kondisi ini, dengan menyebutkan server dan lama penantiannya. Inilah yang dihasilkan oleh server yang menerima koneksi tetapi tidak pernah menjawab, dan juga oleh alamat yang tidak pernah menerima koneksi, alih-alih perintah yang menunggu tanpa akhir. Penelusuran seluruh daftar repositori sebuah registry justru menunggu di setiap halaman selama penelusuran itu boleh berjalan, dan dibatasi oleh kondisinya sendiri, E0377.

Hanya penantian yang dibatasi. Unduhan atau unggahan yang terus bergerak memakan waktu selama yang diperlukan, karena penantian hanya diukur selama tidak ada yang tiba. Chart Helm yang diambil source: milik sebuah Recipe melalui HTTPS hanya dikenai batas penantian hingga jawabannya mulai, dan berakhirnya batas itu dilaporkan dengan kata-kata pustaka jaringan itu sendiri, bukan di bawah kondisi ini. Permintaan yang memang diulang oleh sebuah perintah saat waktunya habis — pembacaan selama aggrega registry update, penulisan selama publikasi — diulang terlebih dahulu, sehingga penolakan adalah apa yang tersisa setelah percobaan terakhirnya.

Pesan yang dikeluarkan, untuk daftar versi yang tidak dijawab registry:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: mendaftar versi untuk plugin/cli/mo: oci: mendaftar tag: Get: 127.0.0.1:18471 tidak menjawab dalam 30s: egress: server tidak menjawab tepat waktu)

dan untuk jawaban yang berhenti di tengah jalan:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (berhenti menjawab: tidak ada lagi bagian jawabannya yang tiba selama 30s: egress: server tidak menjawab tepat waktu)

Cara memperbaiki: perbaikannya adalah tugas operator dan berada di luar katalog Anda. Periksa bahwa server yang disebut pesan itu aktif dan dapat dijangkau dari tempat perintah dijalankan; registry yang sedang terbebani atau dalam pemeliharaan akan menjawab lagi nanti, dan perintah cukup dijalankan ulang. Jika lingkungan menjangkau jaringan melalui proxy, periksa bahwa proxy meneruskan permintaan alih-alih menahannya. Penantian ini tetap; tidak ada pengaturan yang memperpanjangnya.

A registry’s repository listing did not end in time (Daftar repositori sebuah registry tidak berakhir tepat waktu)

Penelusuran seluruh daftar repositori sebuah registry berjalan selama lima menit tanpa mencapai akhir daftar, lalu dihentikan. Dua perintah menelusuri daftar ini: aggrega plugin add, hanya ketika tidak ada plugin yang memiliki nama persis seperti yang diberikan dan perintah itu mencari plugin yang namanya memuat nama tersebut, dan aggrega registry update, yang mendaftar repositori sebuah registry sebelum membaca masing-masing. Daftar yang terus menyebut repositori baru tanpa akhir, dan daftar yang disajikan registry terlalu lambat untuk selesai, sama-sama berakhir di sini alih-alih menahan perintah; penelusuran tidak menghasilkan repositori sama sekali, sehingga tidak ada yang dipilih dari, atau diindeks dari, daftar yang terpotong. Pesan menyebutkan berapa banyak repositori yang telah disebut daftar itu saat dihentikan.

Pesan yang dikeluarkan, untuk penambahan plugin yang kuerinya merupakan bagian dari sebuah nama:

aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: tidak ada plugin cli bernama “mo”, dan pencarian di setiap repositori untuk nama yang memuatnya tidak selesai; sebutkan nama plugin secara persis, seperti aggrega plugin add cli diikuti nama plugin: penelusuran dihentikan setelah 5m0s, sebelum daftar berakhir (repositori yang disebut sejauh ini: 146): registry: daftar repositori tidak berakhir tepat waktu)

Cara memperbaiki: untuk aggrega plugin add, sebutkan nama plugin secara persis — aggrega plugin add cli moo alih-alih aggrega plugin add cli mo — yang mencari plugin dengan nama itu dalam satu permintaan dan tidak pernah menelusuri daftar. Untuk aggrega registry update, penyebabnya adalah daftar registry: pastikan kepada pengelola registry bahwa daftarnya berakhir, lalu jalankan pembaruan lagi setelah itu terjadi. Batas lima menit ini tetap; tidak ada pengaturan yang memperpanjangnya.

A registry kept asking to slow down (Registry terus meminta untuk memperlambat)

Registry yang terlalu sibuk menjawab 429 Too Many Requests, atau 503 Service Unavailable dengan header Retry-After yang menyatakan berapa lama harus menunggu. Setiap permintaan yang dibuat sebuah perintah ke registry menunggu selama yang diminta registry — sepuluh detik jika tidak disebutkan — lalu diminta lagi; setiap permintaan ke registry itu ikut menunggu, dan lebih sedikit permintaan dikirim kepadanya sekaligus sampai registry menjawab lagi. Registry yang selama lima menit tidak menjawab apa pun selain “perlambat” ditolak dengan kondisi ini, dengan menyebutkan registry tersebut, jawaban terakhirnya, dan sudah berapa lama ia tidak menjawab hal lain, demikian pula permintaan yang batas waktunya sendiri berakhir saat menunggu. aggrega registry update kemudian melaporkan registry itu sebagai tidak terindeks, dan registry itu mempertahankan indeks yang dimilikinya sebelum eksekusi.

Pesan yang dikeluarkan, untuk registry yang meminta memperlambat selama lima menit:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (terus meminta untuk memperlambat: jawaban terakhirnya adalah 429 Too Many Requests, dan tidak menjawab hal lain selama 5m0s: oci: registry terus meminta untuk memperlambat)

dan untuk permintaan yang batas waktunya sendiri mengakhiri penantian:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (terus meminta untuk memperlambat: jawaban terakhirnya adalah 429 Too Many Requests, dan tidak menjawab hal lain hingga waktu permintaan itu sendiri habis: oci: registry terus meminta untuk memperlambat)

Cara memperbaiki: penyebabnya adalah batas laju registry, bukan apa pun yang Anda tulis. Registry yang membatasi seberapa cepat klien boleh mengirim permintaan biasanya membatasi semua yang datang dari alamat yang sama, jadi periksa apakah perintah atau mesin lain di balik alamat itu sedang mengirim permintaan kepadanya pada saat yang sama, lalu jalankan perintah lagi setelah semuanya selesai. Jika registry itu Anda kelola sendiri, periksa batas lajunya. Batas lima menit itu tetap; tidak ada pengaturan yang memperpanjangnya.

Byte yang diambil atau di-cache tidak cocok dengan digest yang ditetapkan untuknya

Setiap artefak membawa manifest yang menetapkan digest kontennya, dan lockfile secara terpisah mem-pin digest manifest tersebut. Kedua komitmen ini diperiksa dengan meng-hash ulang byte yang ada dan membandingkannya. Kondisi ini adalah yang dilaporkan oleh perbandingan yang gagal, dan kondisi ini muncul dengan cara yang sama pada byte yang baru diambil maupun pada byte yang dibaca kembali dari cache.

Dua kondisi, dan kondisi mana yang muncul menunjukkan lapisan mana yang tidak sesuai. Yang satu menyebut konten yang tidak cocok dengan digest yang ditetapkan oleh manifest-nya sendiri. Yang lain menyebut manifest yang di-cache yang tidak cocok dengan digest yang di-pin lockfile untuknya — pemeriksaan yang mencegah manifest yang telah dimanipulasi menjadi otoritas yang dipercaya oleh pemeriksaan konten berikutnya. Pin itulah yang membuat pemeriksaan kedua bermakna: pin berasal dari lockfile, bukan dari penurunan ulang manifest dari byte yang di-cache, sehingga keduanya benar-benar independen.

Selanjutnya, sebuah entitas diukur terhadap barisnya sendiri, di atas apa yang dibawa oleh byte-nya. Setelah byte entitas yang di-cache sesuai dengan manifest-nya, byte tersebut dibandingkan dengan digest yang dicatat lockfile untuk entitas itu, yang mencakup file-file yang dibawa oleh publikasinya — masing-masing berdasarkan path dan byte-nya — bukan byte terkompresinya. Jadi, file yang sama yang dipublikasikan dengan kompresi berbeda tetap sesuai, sedangkan file yang berbeda di bawah versi yang sama tidak, dan ketidaksesuaian dilaporkan di bawah kondisi konten. Pull yang mematuhi pin melakukan perbandingan yang sama terhadap apa yang disajikan registry di bawah versi yang di-pin.

Tidak satu pun dari pemeriksaan ini memerlukan jaringan. Masing-masing adalah perbandingan hash atas byte yang sudah ada, dan inilah yang memungkinkan build yang sepenuhnya offline tetap dapat memastikan bahwa apa yang dibacanya adalah apa yang telah di-pin.

Pesan yang dikeluarkan. Konten terhadap manifest-nya:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch (digest konten tidak cocok)

entitas plugin, yang ditetapkan manifest pada posisi yang berbeda:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch (digest konten tidak cocok)

manifest yang di-cache terhadap digest yang di-pin:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch (digest manifest yang di-cache tidak cocok)

entitas yang di-cache terhadap barisnya, dan registry yang menyajikan konten lain di bawah versi yang di-pin:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch (digest konten tidak cocok)

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin (digest konten tidak cocok: entitas yang di-pin: registry kini menyajikan digest untuk versi yang di-pin, bukan digest yang di-pin; jalankan perintah tersebut untuk memperbarui pin)

Keduanya dibingkai oleh apa pun yang sedang dibaca. Entitas yang di-pin yang tidak dimiliki sumber mana pun pada pin-nya, dengan kondisi manifest jika manifest entri cache tidak sesuai, dan kondisi konten jika sebaliknya:

pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above> (entitas yang di-pin: tidak ada sumber yang memiliki byte yang di-pin; dengan registry yang dapat dijangkau, perintah tersebut mengambil kembali versi yang di-pin)

Entri arsip yang menyebut path yang keluar dari arsip juga dilaporkan di bawah kondisi konten, karena bundle yang mencobanya bukanlah bundle yang telah ditetapkan:

path traversal entry "<name>": oci: content digest mismatch (entri path traversal: digest konten tidak cocok)

Keduanya membawa remediasi yang sama jika langkah yang memunculkannya menyediakan remediasi:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache (remediasi: jalankan perintah tersebut untuk menyegarkan lockfile dan cache)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan hal ini, dan tidak ada perubahan penulisan yang dapat menghilangkannya. Segarkan cache dan lockfile sekaligus dengan aggrega pull --upgrade --release <release>, yang mengambil ulang dari sumber dan menulis ulang keduanya. Jika hal itu menghilangkannya, salinan yang di-cache telah diubah atau terpotong sejak ditulis. Jika ketidakcocokan tetap ada setelah penyegaran, byte yang disajikan penerbit memang berbeda dari yang di-pin — versi yang dipublikasikan ulang, yang merupakan pertanyaan bagi siapa pun yang memublikasikannya, dan pertanyaan yang layak diajukan sebelum mengadopsi digest baru, bukan sesudahnya.

Manifest tidak membawa layer dengan jenis yang diharapkan, atau membawa lebih dari satu

Manifest sebuah artefak mencantumkan layer-layernya, dan layer yang membawa konten dipilih berdasarkan media type-nya, bukan berdasarkan posisinya. Hal inilah yang memungkinkan artefak membundel lebih dari satu layer — misalnya chart dengan layer provenance terpisah di sampingnya — dan kontennya tetap dapat dipilih secara andal.

Dua bentuk tidak menyisakan apa pun untuk dipilih. Tidak adanya layer dengan tipe yang diharapkan berarti manifest menggambarkan sesuatu selain apa yang dibaca dari referensi tersebut. Lebih dari satu berarti pilihan itu tidak memiliki jawaban, dan memilih yang pertama terkadang benar dan terkadang salah tanpa terdeteksi.

Pesan yang dikeluarkan, masing-masing menyebut media type yang diharapkan. Tidak ada:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type (manifest tidak memiliki layer dengan media type konten yang diharapkan)

dan lebih dari satu, yang juga menyebut jumlahnya:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type (manifest memiliki beberapa layer dengan media type konten yang diharapkan)

Cara memperbaiki: perbaikannya adalah tanggung jawab penerbit, bukan Anda — manifest bukanlah sesuatu yang ditulis oleh penulis katalog. Periksa terlebih dahulu bahwa referensi mengarah ke tempat yang Anda maksud: referensi yang mengarah ke jenis artefak yang berbeda menghasilkan bentuk pertama, karena manifest tersebut adalah manifest yang sah untuk sesuatu yang lain. Jika referensinya benar, artefak tersebut dipublikasikan dengan manifest yang tidak menggambarkannya sebagai jenis yang diklaim, jadi kutip media type dari pesan tersebut kepada siapa pun yang memublikasikannya. Publikasi melalui jalur publikasi biasa menghasilkan manifest dengan tepat satu layer konten, sehingga artefak dalam salah satu bentuk tersebut dirakit dengan cara lain.

A published bundle holds no entity, or holds two (Bundel yang diterbitkan tidak memuat entitas, atau memuat dua)

Entitas yang mendeklarasikan berkas di samping dokumennya — chart lokal sebuah Recipe atau lock-nya, skema impor sebuah Component — diterbitkan sebagai .tar.gz yang membundel entitas tersebut bersama berkas-berkas itu. Membacanya kembali berarti menemukan entitas itu lagi di antara berkas-berkas tersebut — dan berkas tempat entitas itu ditulis dapat bernama apa saja, sehingga yang mengidentifikasinya adalah preambul entitas yang dibawanya, bukan namanya. Dokumen di tingkat teratas bundel yang kind:-nya merupakan jenis entitas yang dapat diterbitkan adalah entitas tersebut; fragmen compose, templat chart, atau manifest Kubernetes di sampingnya bukan entitas, demikian pula dokumen entitas yang lebih dalam di dalam pohon source/, yang merupakan konten yang dikirimkan entitas, bukan entitas itu sendiri.

Dua bentuk tidak menyisakan apa pun untuk dipilih, dan keduanya merupakan sifat dari cara artefak tersebut diterbitkan.

Tidak ada dokumen entitas di tingkat teratas bundel. Bundel dikemas tanpa entitas di tingkat teratasnya — dokumennya tertinggal, atau ditempatkan di subdirektori alih-alih di samping berkas yang dibawanya. Pesan mencantumkan apa yang memang ada di tingkat teratas bundel, yang biasanya cukup untuk melihat mana yang terjadi.

Dua dokumen entitas di tingkat teratas bundel. Bundel dikemas dari seluruh direktori tempat dua entitas ditulis — hal yang tidak pernah dilakukan aggrega push, karena setiap entitas hanya membawa berkas yang dideklarasikannya, tetapi dapat dilakukan klien lain. Jika dikemas seperti itu, setiap koordinat terbitan keduanya membawa byte yang sama — sehingga menjawab dengan salah satunya akan menyerahkan entitas yang lain di bawah nama yang diminta, tanpa ada yang di hilir mampu menyadarinya. Tidak ada pilihan aman yang dapat diambil, sehingga tidak ada yang diambil.

Pesan yang dikeluarkan, mencantumkan apa yang ditemukan. Tidak ada, ketika bundel membawa berkas lain:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (akar bundel tidak membawa dokumen entitas di antara berkas-berkas: oci: bundel yang diterbitkan tidak membawa dokumen entitas)

tidak ada, ketika bundel tidak membawa apa pun sama sekali:

bundle root carries no files at all: oci: published bundle carries no entity document (akar bundel tidak membawa berkas sama sekali: oci: bundel yang diterbitkan tidak membawa dokumen entitas)

dan lebih dari satu, yang menyebutkan jumlahnya sekaligus dokumen-dokumen yang bertabrakan:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (akar bundel membawa sejumlah dokumen entitas: oci: bundel yang diterbitkan membawa lebih dari satu dokumen entitas)

Cara memperbaiki: keduanya menjadi urusan penerbit untuk diselesaikan, bukan urusan Anda, dan perbaikannya ada di direktori versi tempat entitas diterbitkan. Berikan setiap entitas direktori versinya sendiri, sehingga direktori itu memuat satu entitas beserta berkas-berkas miliknya — tata letak yang sudah diikuti setiap entitas terbitan, dengan direktori dinamai menurut metadata.version entitas dan terletak di bawah nama entitas itu sendiri. Kemudian terbitkan lagi dengan versi baru: byte yang sudah diterbitkan dibekukan, sehingga penerbitan ulang di atas versi yang ada ditolak, bukan dikoreksi. Jika Anda mengonsumsi alih-alih menerbitkan, kutip pesan tersebut kepada pihak yang menerbitkan artefak; nama-nama berkas di dalamnya mengidentifikasi direktori yang perlu dipisah.

A published artifact cannot be read as an entity (Artefak yang diterbitkan tidak dapat dibaca sebagai entitas)

Membaca entitas dari koordinat tempat entitas itu diterbitkan dimulai dari byte yang disajikan registry di sana — aggrega inspect oci://… membacanya agar dapat Anda lihat, dan pull dependensi membaca byte sebuah arsip dengan cara yang sama untuk menemukan versi yang di-pin-nya. Dua bentuk byte tersebut tidak memuat entitas untuk dibaca.

Arsip yang tidak dapat dibongkar. Entitas yang diterbitkan bersama berkas yang dideklarasikannya diterbitkan sebagai .tar.gz, dan byte-nya diawali seperti itu, tetapi aliran kompresi atau arsip di dalamnya tidak terbentuk dengan baik — paling sering karena terpotong. Byte tersebut tetap cocok dengan digest yang dicatat manifest artefak itu sendiri untuknya, sehingga byte itu persis seperti yang diterbitkan: kerusakan terjadi sebelum atau selama penerbitan, bukan dalam perjalanan kepada Anda.

Dokumen yang bukan entitas. Koordinat membawa satu dokumen, dan dokumen itu tidak dapat di-parse, tidak mendeklarasikan kind:, atau mendeklarasikan jenis yang tidak pernah diterbitkan, seperti Release atau Manifest. Referensi tersebut kemudian menunjuk sesuatu yang diterbitkan di samping katalog, bukan entitas — misalnya artefak data yang diterbitkan dengan aggrega push-artifact.

Pesan yang dikeluarkan. Arsip yang aliran kompresinya tidak terbentuk dengan baik, beserta galat yang menghentikannya:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: membongkar gzip: oci: bundel yang diterbitkan tidak dapat dibongkar)

arsip yang berhenti di tengah sebuah berkas:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (membaca berkas dari bundel yang diterbitkan: oci: bundel yang diterbitkan tidak dapat dibongkar)

dokumen yang mendeklarasikan jenis yang tidak pernah diterbitkan:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (dokumen yang diterbitkan mendeklarasikan jenis yang tidak diterbitkan oleh registry: oci: artefak yang diterbitkan bukan dokumen entitas)

dan byte yang sama sekali bukan dokumen:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (byte yang diterbitkan tidak dapat di-parse sebagai dokumen: oci: artefak yang diterbitkan bukan dokumen entitas)

Cara memperbaiki: arsip yang tidak dapat dibongkar menjadi urusan penerbit untuk diganti. Byte yang sudah diterbitkan dibekukan, sehingga solusinya adalah menerbitkan entitas lagi dengan versi baru; jika Anda mengonsumsinya, kutip pesan tersebut kepada pihak yang menerbitkannya. Dokumen yang bukan entitas hampir selalu berarti referensinya bukan yang Anda maksud: periksa bahwa referensi itu menunjuk koordinat tempat entitas diterbitkan, yaitu referensi yang dicetak aggrega push saat menerbitkannya.

The registry could not answer what is attached to an artifact (Registry tidak dapat menjawab apa yang dilampirkan pada artefak)

Tanda tangan dan lampiran lain menggantung pada artefak alih-alih berada di dalamnya, dan menemukannya merupakan pertanyaan yang diajukan kepada registry. Kondisi ini menyatakan bahwa pertanyaan itu tidak terjawab — registry tidak melayani pencarian tersebut, artefak tempat lampiran menggantung tidak dapat ditemukan, atau permintaannya sendiri gagal.

Hal ini tidak sama dengan jawaban “tidak ada yang dilampirkan”, dan mencampuradukkan keduanya justru hal yang hendak dicegah oleh kondisi ini. Artefak yang memang tidak membawa tanda tangan di-resolve secara normal dan menghasilkan daftar kosong. Kondisi ini menyatakan bahwa daftar itu tidak pernah diperoleh, sehingga tidak ada yang diketahui sama sekali tentang apa yang dilampirkan.

Apakah build berhenti bergantung pada apakah tanda tangan diwajibkan, dan kedua arah tersebut disengaja:

  • Tanda tangan diwajibkan. Build berhenti. Pemeriksaan wajib yang tidak dapat dijalankan belum lulus, dan menerima artefak tersebut akan bertumpu pada pertanyaan yang tidak berhasil diajukan siapa pun.
  • Tanda tangan tidak diwajibkan. Build berlanjut dan menyatakannya secara terbuka, bukan secara diam-diam. Pencarian tidak menghasilkan apa pun untuk diverifikasi, sehingga menolak berarti menolak artefak atas dasar pertanyaan yang tidak terjawab — tetapi diam akan terbaca sebagai pull tanpa tanda tangan yang bersih, padahal bukan.

Pesan yang dikeluarkan. Registry yang tidak melayani pencarian:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: target tidak mendukung penemuan referrer: oci: penemuan referrer tidak dapat diselesaikan)

artefak itu sendiri tidak dapat ditemukan:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: me-resolve subjek: oci: penemuan referrer tidak dapat diselesaikan)

dan pencarian yang gagal:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: mendaftar referrer: oci: penemuan referrer tidak dapat diselesaikan)

Ketika tanda tangan tidak diwajibkan, teks yang sama muncul sebagai pemberitahuan:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (verifikasi tanda tangan tidak dapat dijalankan; registry tidak dapat menjawab pencarian tanda tangan dan tanda tangan tidak diwajibkan; melanjutkan)

Cara memperbaiki: perbaikannya menjadi urusan operator dan terletak pada registry, bukan pada katalog Anda. Jika registry sama sekali tidak melayani pencarian lampiran, registry itu tidak dapat membawa tanda tangan, sehingga cerminkan artefak ke registry yang dapat, atau berhenti mewajibkan tanda tangan dari host tersebut di .aggrega-config.yaml — dan catat mana yang Anda pilih, karena pilihan kedua berarti tanda tangan dari host itu tidak lagi diperiksa. Jika pencarian gagal pada registry yang melayaninya, ini adalah masalah transport atau izin khusus pada endpoint lampiran, dan menjalankan ulang setelah registry dapat dijangkau adalah seluruh solusinya.

An artifact that must be signed carries no signature (Artefak yang wajib ditandatangani tidak memiliki tanda tangan)

Tanda tangan diwajibkan untuk sebuah artefak apabila kebijakan penandatanganan milik workspace itu sendiri mencakup jenisnya, atau registry asalnya dikonfigurasi untuk mewajibkannya. Kondisi ini melaporkan bahwa registry menjawab pencarian lampiran, tidak ada yang terlampir, dan tanda tangan diwajibkan.

Kedua persyaratan tersebut adalah satu sikap yang dibaca pada dua cakupan. Kebijakan tingkat workspace mewajibkan tanda tangan pada jenis yang tercakup, bahkan dari host yang entrinya sendiri tidak mewajibkan apa pun, sehingga host yang tidak mewajibkan apa pun tidak membebaskan artefak yang dicakup oleh kebijakan tingkat workspace.

Jika tidak ada tanda tangan yang diwajibkan, hal ini sama sekali bukan kegagalan. Artefak diverifikasi jika tanda tangan ada dan lolos tanpa pemberitahuan jika tidak ada, sehingga host tanpa sikap yang dikonfigurasi dapat digunakan tanpa prosedur tambahan.

Artefak yang jenisnya tidak dapat ditentukan saat kebijakan tingkat workspace aktif diperlakukan sebagai artefak yang wajib ditandatangani, bukan sebagai artefak yang dibebaskan, sehingga artefak yang tidak dapat diklasifikasikan tidak dapat lolos dari kebijakan yang sedang aktif.

Pesan yang dikeluarkan, dibingkai oleh referensi yang sedang diperiksa:

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (memverifikasi tanda tangan: penandatanganan: tidak ditemukan tanda tangan untuk artefak yang mewajibkannya)

Cara memperbaiki: perbaikan ini menjadi tanggung jawab operator atau penerbit, bukan penulis entitas. Jika Anda mengharapkan artefak tersebut ditandatangani, artefak itu diterbitkan tanpa tanda tangan — sampaikan referensinya kepada siapa pun yang menerbitkannya, karena hanya merekalah yang dapat melampirkan tanda tangan. Jika artefak tersebut memang tidak dimaksudkan untuk ditandatangani, persyaratannya yang perlu diubah: persyaratan itu berasal dari entri registry dalam .aggrega-config.yaml atau dari kebijakan penandatanganan tingkat workspace, dan referensi dalam pesan memberi tahu Anda host mana yang perlu diperiksa. Menonaktifkan persyaratan berarti artefak dari host tersebut tidak lagi diperiksa, jadi lebih baik persempit cakupan kebijakan ke suatu jenis daripada menonaktifkannya sepenuhnya.

A signature does not verify (Tanda tangan tidak lolos verifikasi)

Sebuah tanda tangan ditemukan dan diperiksa, lalu pemeriksaannya gagal. Ini adalah hasil negatif umum dari pemeriksaan tersebut, yang mencakup rantai sertifikat yang tidak berakar pada materi kepercayaan, tanda tangan tanpa catatan transparency log padahal catatan itu diwajibkan, tanda tangan atas artefak yang berbeda dari artefak yang sedang ditangani, bundle yang telah diubah, dan bundle yang diperiksa terhadap kunci yang dipin tetapi tidak lolos verifikasi terhadapnya.

Kondisi ini sengaja dibedakan dari tanda tangan yang penandatangannya tidak dipercaya. Kondisi itu secara struktural benar dan dibuat oleh penandatangan yang salah; kondisi ini sama sekali tidak lolos pemeriksaan. Memisahkan keduanya memungkinkan Anda membedakan “artefak ini bukan yang ditandatangani” dari “artefak ini ditandatangani oleh seseorang yang belum Anda terima”.

Artefak yang menjadi sasaran tanda tangan diperiksa dua kali. Setelah pemeriksaan kriptografis tanda tangan berhasil, toolchain membaca dari tanda tangan itu sendiri untuk artefak mana tanda tangan itu dibuat — pembacaan yang sama yang digunakan setiap build berikutnya terhadap tanda tangan yang tercatat, yang memungkinkan build menolak tanda tangan yang disalin dari satu artefak ke artefak lain tanpa memverifikasi apa pun — dan menolak tanda tangan tersebut jika pembacaan itu tidak menyebut artefak yang sedang ditangani, atau jika tanda tangan berada dalam bentuk yang tidak memungkinkan pembacaan menentukan artefaknya. Kedua bentuk yang diterima oleh pull dibaca: tanda tangan yang dibuat atas artefak itu sendiri, dan pernyataan bertanda tangan yang menyebutnya. Pembacaan mengikuti aturan pemeriksaan kriptografis itu sendiri, sehingga untuk tanda tangan yang diterima pemeriksaan tersebut, keduanya sepakat; penolakan jenis ini berarti keduanya tidak sepakat, dan sebaiknya dilaporkan beserta referensi dan pesannya alih-alih diakali melalui konfigurasi.

Jika entri registry menandai verifikasi sebagai bersifat anjuran (advisory), teks yang sama dilaporkan sebagai pemberitahuan dan proses berlanjut.

Pesan yang dikeluarkan. Dari pemeriksaan itu sendiri, mengutip apa yang dilaporkan verifier:

signing: signature bundle does not verify: <what the verifier reported> (penandatanganan: bundle tanda tangan tidak lolos verifikasi: apa yang dilaporkan verifier)

dan, jika pemeriksaan kriptografis berhasil tetapi pembacaan artefak sasaran tanda tangan tidak sesuai:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (penandatanganan: bundle tanda tangan tidak lolos verifikasi: pemeriksaan kriptografisnya berhasil, tetapi tidak menyebut digest manifest yang disebut sebagai artefak sasarannya)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (penandatanganan: bundle tanda tangan tidak lolos verifikasi: pemeriksaan kriptografisnya berhasil, tetapi bentuknya tidak memungkinkan artefak sasarannya dibaca)

masing-masing dibingkai oleh referensi yang sedang diverifikasi:

verifying the signature of <uri>: <the message above> (memverifikasi tanda tangan)

dan, jika entri registry menjadikan verifikasi bersifat anjuran, sebagai pemberitahuan alih-alih penghentian:

signature verification failed for <uri> (advisory; continuing): <the message above> (verifikasi tanda tangan gagal (anjuran; dilanjutkan))

Cara memperbaiki: tidak ada isi berkas entitas Anda yang menyebabkan hal ini dan tidak ada perubahan penulisan yang dapat mengatasinya. Perlakukan ini sebagai pernyataan tentang artefak, bukan tentang konfigurasi Anda: byte yang sedang ditangani bukan byte yang ditandatangani, atau tanda tangannya bukan tanda tangan yang dapat diperiksa oleh materi kepercayaan yang dikonfigurasi. Ambil ulang artefak terlebih dahulu, karena salinan cache yang terpotong atau berubah gagal dengan cara persis seperti ini dan pengambilan baru akan mengatasinya. Jika masalah tetap ada setelah pengambilan baru, sampaikan referensi dan kata-kata verifier itu sendiri kepada siapa pun yang menerbitkan artefak tersebut. Jangan menggunakan pengaturan anjuran untuk melewatinya — pengaturan itu tetap menjalankan pemeriksaan tetapi menghentikannya dari menghentikan build, yang merupakan pilihan sengaja untuk menerima artefak yang tidak terverifikasi dari host tersebut, bukan cara untuk memperbaikinya.

A signature verifies but its signer is not one the registry trusts (Tanda tangan lolos verifikasi tetapi penandatangannya tidak dipercaya oleh registry)

Tanda tangan lolos pemeriksaan — rantai sertifikat berakar pada materi kepercayaan dan catatan transparansi tersedia — tetapi identitas dalam sertifikat itu tidak cocok dengan satu pun identitas yang dikonfigurasi sebagai dapat diterima untuk registry tersebut. Artefak ditandatangani oleh penandatangan nyata yang belum diterima.

Kedua bagian identitas dibandingkan, yaitu subjek dan penerbit (issuer) yang menjaminnya, dan salah satunya dapat menjadi bagian yang tidak cocok. Pesan menyebut keduanya jika dapat dibaca dari sertifikat, karena penandatangan yang menampilkan subjek yang diharapkan di bawah penerbit yang tidak diterima siapa pun tampak sama dengan subjek yang salah kecuali keduanya ditampilkan.

Pesan yang dikeluarkan. Jika kedua bagian dapat dibaca:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (penandatanganan: identitas tanda tangan tidak dipercaya untuk registry ini: apa yang dilaporkan verifier; penandatangan menampilkan penerbit yang disebut dengan identitas yang disebut, tetapi tidak ada identitas tepercaya yang mengizinkan penerbit itu)

dan jika keduanya tidak dapat dibaca, kembali ke laporan verifier itu sendiri:

signing: signature identity is not trusted for this registry: <what the verifier reported> (penandatanganan: identitas tanda tangan tidak dipercaya untuk registry ini: apa yang dilaporkan verifier)

Cara memperbaiki: ini adalah keputusan operator, dan keputusan ini sungguh-sungguh, bukan formalitas. Bandingkan penerbit dan identitas dalam pesan dengan identitas tepercaya yang dikonfigurasi untuk registry tersebut dalam .aggrega-config.yaml. Jika penandatangan tersebut memang ingin Anda terima, tambahkan — sebuah entri menyebut identitas, atau pola yang cocok dengannya, bersama penerbitnya, dan keduanya harus benar. Jika tidak, artefak ditandatangani oleh seseorang yang belum Anda terima, dan menambahkan identitas tersebut agar build lolos adalah satu-satunya tanggapan yang harus dihindari. Registry yang mengumumkan kebijakan kepercayaannya sendiri dapat dipin kebijakannya saat registry ditambahkan, yang merupakan cara memasukkan identitas yang dimaksud tanpa menyalinnya secara manual.

A keyless trust policy names no acceptable signer (Kebijakan kepercayaan tanpa kunci tidak menyebutkan penanda tangan yang dapat diterima)

Verifikasi tanpa kunci memutuskan apakah suatu artefak diterima dengan mencocokkan identitas dalam sertifikat penandatanganannya terhadap sekumpulan identitas yang dikonfigurasi sebagai dapat diterima. Kumpulan yang kosong ditolak alih-alih diperlakukan sebagai kebijakan: mencocokkan terhadap kekosongan akan menerima setiap penanda tangan atau menolak semuanya, dan keduanya bukan maksud operator yang mengonfigurasi verifikasi.

Pesan yang dikeluarkan, yang merupakan kalimat kondisi itu sendiri:

signing: keyless verification requires at least one trusted identity (penandatanganan: verifikasi tanpa kunci memerlukan setidaknya satu identitas tepercaya)

Cara memperbaiki: konfigurasikan setidaknya satu identitas tepercaya untuk registry di .aggrega-config.yaml. Sebuah entri menyebutkan identitas — sebagai subjek yang persis atau pola yang cocok dengannya — beserta penerbit yang menjaminnya, dan keduanya wajib ada. Jika registry mengiklankan kebijakan kepercayaannya sendiri, menyematkan kebijakan tersebut saat registry ditambahkan akan mengisi kumpulan itu dari apa yang dipublikasikan registry. Jika Anda sama sekali tidak bermaksud memverifikasi tanda tangan dari registry ini, itu adalah pengaturan yang berbeda dari kumpulan identitas kosong, dan menetapkannya secara eksplisit adalah cara untuk menyatakannya.

The pinned trust root cannot be read (Akar kepercayaan yang disematkan tidak dapat dibaca)

Akar kepercayaan yang disematkan di workspace memungkinkan pemeriksaan tanpa kunci melakukan verifikasi tanpa akses jaringan di mana pun pemeriksaan itu berjalan: sebuah berkas yang isinya adalah materi yang menjadi acuan pemeriksaan setiap tanda tangan. Kondisi ini melaporkan bahwa berkas pada jalur yang dikonfigurasi tidak dapat diubah menjadi materi kepercayaan yang dapat digunakan — berkas itu tidak ada, tidak dapat dibaca, atau isinya bukan akar kepercayaan.

Proses berhenti alih-alih beralih ke cadangan. Akar yang disematkan adalah pilihan yang disengaja untuk memeriksa tanda tangan terhadap materi yang Anda kendalikan, sehingga diam-diam mengambil akar lain sebagai gantinya akan mengganti pilihan itu dengan pilihan yang berbeda dan menghasilkan hasil verifikasi yang tidak diminta siapa pun.

Pesan yang dikeluarkan, yang menyebutkan jalur dan mengutip apa yang dilaporkan pembacaan:

signing: cannot load pinned trust root: <path>: <what the read reported> (penandatanganan: tidak dapat memuat akar kepercayaan yang disematkan)

Cara memperbaiki: ini adalah urusan operator. Periksa bahwa jalur yang dikonfigurasi untuk akar kepercayaan ada dan dapat dibaca oleh siapa pun yang menjalankan perintah — jalur yang relatif terhadap direktori kerja yang berbeda, dan berkas yang ada tetapi tidak dapat dibaca, keduanya dilaporkan di sini. Jika berkas ada dan dapat dibaca, isinya bukan akar kepercayaan, jadi gantilah dengan bundel terkini dari sumber tempat Anda memperolehnya alih-alih menyuntingnya. Jika akar yang disematkan tidak dimaksudkan, konfigurasilah yang perlu diubah: hapus sematan tersebut dan verifikasi akan menggunakan materi yang seharusnya diberikan kepadanya.

A pinned verification key is not the key profile the verifier accepts (Kunci verifikasi yang disematkan bukan profil kunci yang diterima verifikator)

Penandatanganan dan verifikasi terhadap kunci yang dipegang menggunakan satu profil kunci, dan kunci jenis lain apa pun ditolak alih-alih dicoba. Ini adalah pernyataan tentang jenis kunci, bukan tentang apakah kunci itu memverifikasi sesuatu.

Dua momen pelaporannya adalah pekerjaan yang berbeda. Yang satu adalah memuat kunci untuk menandatangani, yang terjadi saat artefak dipublikasikan; yang lain adalah memeriksa tanda tangan terhadap kunci yang disematkan untuk suatu registry, yang terjadi saat artefak diverifikasi. Penolakannya sama pada keduanya.

Pesan yang dikeluarkan, masing-masing menyebutkan algoritma kunci yang sebenarnya diberikan — an RSA key atau an Ed25519 key. Kunci verifikasi yang disematkan:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (penandatanganan: jenis kunci yang dipegang tidak didukung: kunci yang disematkan menggunakan algoritma yang disebut, yang diharapkan ECDSA P-256)

dan kunci yang dimuat untuk menandatangani:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (penandatanganan: jenis kunci yang dipegang tidak didukung: kunci yang dipegang menggunakan algoritma yang disebut, yang diharapkan ECDSA P-256)

Cara memperbaiki: berikan kunci dengan profil yang disebutkan pesan. Jika Anda melakukan verifikasi, kuncinya adalah kunci yang disematkan untuk registry di .aggrega-config.yaml dan harus berupa bagian publik dari kunci yang digunakan penerbit untuk menandatangani — ketidakcocokan di sini biasanya berarti berkas yang salah telah disematkan, karena kunci yang jenisnya benar tetapi kuncinya salah justru dilaporkan sebagai tanda tangan yang tidak terverifikasi. Jika Anda menandatangani, buat kunci dengan profil yang disebutkan, atau gunakan jalur tanpa kunci, yang sama sekali tidak memerlukan kunci yang dipegang.

The workspace is offline and the step needs the network (Workspace sedang luring dan langkah ini memerlukan jaringan)

Workspace dapat ditandai luring, dan pengaturan itu adalah penolakan, bukan preferensi: setiap langkah yang akan menjangkau jaringan ditolak di tempat langkah itu dibentuk, sebelum apa pun dihubungi. Penolakan sejak awal inilah yang membuat kegagalan menyatakan “workspace ini luring” alih-alih muncul belakangan sebagai batas waktu habis tanpa penjelasan.

Satu keputusan, dibaca di satu tempat. Langkah yang perlu mengetahui sebelumnya apakah jaringan dapat dijangkau mengajukan pertanyaan yang sama dengan yang diajukan oleh pengambilan itu sendiri, sehingga suatu pemeriksaan dan operasi yang dijaganya tidak dapat sampai pada kesimpulan yang berbeda.

Penolakan ini menjangkau beberapa jenis pekerjaan, semuanya dengan penolakan yang sama: memperoleh artefak dari registry, memperoleh sumber sebuah Recipe melalui jaringan, mengambil input eksternal, memperoleh identitas untuk menandatangani, dan mengambil materi kepercayaan. Build yang membaca cache yang sudah terisi tidak menjangkau satu pun dari semua itu, dan itulah inti pengaturan ini.

Jika seluruh perintah adalah perjalanan pulang-pergi jaringan, penolakan datang paling awal, bukan paling akhir. push, push-artifact dan registry update ada untuk menjangkau registry, sehingga perintah-perintah itu menyatakannya sebelum membaca entitas Anda atau menelusuri repositori Anda, dan menyebutkan mana dari tiga tempat yang menetapkan posisi tersebut — flag yang Anda ketik, variabel lingkungan, atau berkas beserta kunci di dalamnya. --dry-run adalah pengecualian, dan menjadi pengecualian karena apa yang dilakukannya, bukan karena namanya: ia melaporkan apa yang akan dipublikasikannya dan tidak memanggil apa pun, sehingga ia adalah bentuk publikasi yang aman saat luring dan tetap berfungsi.

Pesan yang dikeluarkan, yang memuat remediasinya sendiri dan merupakan kalimat kondisi itu sendiri:

egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache (egress: akses jaringan ditolak karena workspace luring; remediasi: berikan flag untuk mengizinkan jaringan pada satu kali jalan ini, atau hapus kunci tingkat atas dalam berkas konfigurasi (atau AGGREGA_OFFLINE) untuk mengizinkannya mulai sekarang; jika pekerjaannya adalah build yang memerlukan konten yang tidak dimiliki mesin, jalankan perintah pull dari lingkungan yang terhubung terlebih dahulu untuk mengisi cache)

Dibingkai oleh apa pun yang memerlukan jaringan — misalnya, memperoleh sumber sebuah Recipe:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

Menambahkan hub resmi di workspace yang luring tidak ditolak: hub ditambahkan berdasarkan baseline bawaannya, dan pemberitahuan menyatakan bahwa kebijakan kepercayaan hub tidak diminta karena workspace luring.

Cara memperbaiki: pesan menyebutkan tiga cara, dan mana yang berlaku adalah keputusan Anda. Jika posisi itu ditetapkan dan Anda ingin melewatinya untuk satu perintah ini, berikan --offline=false; untuk itulah flag tersebut ada, dan itu satu-satunya jawaban yang tersedia bagi seseorang yang tidak menulis berkas konfigurasi itu sendiri. Jika workspace memang dimaksudkan luring, konten yang hilanglah yang perlu diperbaiki: jalankan pull dari tempat yang memiliki akses jaringan agar cache memuat semua yang dijangkau release, lalu build luring tidak memerlukan apa pun lagi. Jika workspace sama sekali tidak dimaksudkan luring, hapus pengaturan itu di sumbernya — kunci tingkat atas offline di .aggrega-config.yaml, atau variabel lingkungan yang disebutkan pesan, dan variabel inilah yang sering menjebak orang karena tidak ada di berkas mana pun. Perhatikan bahwa workspace luring sama sekali tidak dapat menandatangani dengan jalur tanpa kunci, karena penerbitan sertifikat dan pencatatannya adalah operasi jaringan tanpa bentuk luring.

Saat membangun topologi

Setelah setiap Component memiliki Recipe yang telah di-resolve, compiler menyatukan Components ke dalam graf IR dengan membaca blok uses: milik setiap Component serta merujuk silang target dan lampiran feature.

Target uses yang menggantung

Sebuah edge uses: menyebut komponen target yang tidak ada dalam topologi yang telah di-resolve. Penghentian ini tidak bergantung pada asal — edge Aggregate yang ditulis pengembang dan edge yang dihubungkan oleh Release sama-sama tertangkap. Target yang menggantung merupakan penghentian fatal, bukan pembuangan diam-diam: edge ke target yang tidak ada akan lenyap dan membuat nilai yang diinjeksikan ke konsumen kosong tanpa pemberitahuan pada saat deploy. Ini adalah saudara struktural dari penghentian socket yang tidak dideklarasikan di bawah: ke socket mana pun sebuah koneksi dihubungkan, targetnya harus di-resolve ke komponen yang ada sebelum tipe edge tersebut diperiksa.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu target yang tidak merujuk ke apa pun dan socket tempat koneksi dihubungkan — kemudian apa yang perlu dilakukan:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (Target edge uses tidak ada (dihubungkan ke socket). Arahkan target ke komponen yang dideklarasikan oleh Aggregate, atau deklarasikan komponen dengan nama tersebut.)

Temuan ditempatkan pada entri tertulis yang dibahasnya, di dalam dokumen tempat entri itu ditulis, sehingga koneksi yang digambar oleh blok uses: milik komponen sendiri, koneksi yang diproyeksikan oleh lampiran, dan koneksi yang dihubungkan oleh Release masing-masing dilaporkan pada bloknya sendiri. Setiap koneksi yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya alih-alih berhenti pada yang pertama.

Cara memperbaiki: deklarasikan komponen target yang hilang, atau perbaiki nama target dalam entri uses: agar cocok dengan komponen yang ada.

Dua koneksi dari satu komponen dengan satu alias

Sebuah komponen membaca setiap koneksinya berdasarkan aliasnya — kunci tempat koneksi itu ditulis, atau, untuk koneksi yang ditulis sebagai entri daftar, nama target itu sendiri. Template Recipe membaca koneksi sebuah komponen dengan kunci alias saja, dan sebuah asersi membacanya dengan kunci socket lalu alias, sehingga dua koneksi dari satu komponen dengan satu alias akan berbagi satu slot dalam setidaknya salah satu tampilan tersebut: yang belakangan akan mengambilnya, dan yang lain tidak akan terlihat oleh template atau asersi. Karena itu, satu alias menyebut satu koneksi dari sebuah komponen — apa pun socket tempat masing-masing dihubungkan, apa pun yang menggambarnya (blok uses: milik komponen sendiri, blok uses: milik lampiran pada cakupan mana pun, atau entri per-edge Release), dan apa pun targetnya. Sepasang koneksi seperti itu menghentikan build setelah graf final, sebelum asersi apa pun dijalankan dan sebelum apa pun di-render.

Pasangan ini muncul dari penulisan yang sah pada masing-masing permukaan secara terpisah: entri milik komponen sendiri dan entri lampiran pada satu socket dan alias; daftar yang menyebut satu target dua kali (models: [llama, llama]); satu alias ditulis pada dua socket (models: { local: … } di samping databases: { local: … }); dua lampiran yang menghubungkan satu alias; atau entri Release yang menggambar koneksi pada socket yang dibiarkan tidak terikat oleh Aggregate, dengan alias yang sudah digunakan Aggregate pada socket lain. Dua bentuk serupa tidak pernah mencapai penghentian ini: satu kunci yang ditulis dua kali dalam satu blok entri berkunci membuat dokumen gagal dimuat, dan entri Release pada socket dan alias yang sudah digambar oleh blok lain mengonfigurasi koneksi tersebut — atau, jika menyebut target yang berbeda, berhenti sebagai retarget — alih-alih menggambar koneksi kedua.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu alias dan komponen, lalu socket koneksi ini, targetnya, dan tempat entrinya ditulis, lalu hal yang sama untuk koneksi yang sudah memegang alias tersebut — kemudian apa yang perlu dilakukan:

connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (Alias koneksi sudah digunakan oleh koneksi lain dari komponen yang sama (pada komponen, koneksi ini dihubungkan ke socket, dengan target, ditulis di, pada, koneksi yang sudah memegang alias dihubungkan ke socket, dengan target, ditulis di, pada). Berikan alias tersendiri kepada salah satu dari kedua koneksi: komponen membaca setiap koneksi berdasarkan aliasnya, apa pun socket tempat koneksi itu dihubungkan. Entri daftar mengambil nama targetnya sebagai alias, sehingga target yang terdaftar dua kali didaftarkan sekali, atau ditulis sebagai dua entri berkunci dengan dua alias.)

Jika kedua koneksi ditulis pada satu jalur kunci — daftar yang menyebut satu target dua kali — masing-masing juga disebut berdasarkan posisinya dalam daftar tersebut, list entry "2" di samping list entry "1", yang merupakan satu-satunya pembeda kedua entri itu.

Temuan ditempatkan pada entri milik koneksi yang belakangan — yang digambar kedua, yaitu yang sebenarnya akan mengambil slot alias tersebut — di dalam dokumen tempat entri itu ditulis. Jadi, entri Release, atau lampiran yang ditulis oleh Release, dicatat sebagai kesalahan operasi, dan entri di Aggregate sebagai kesalahan pengembang. Setiap koneksi yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya.

Beberapa bentuk disebut dengan kurang tepat. Nama lampiran yang dideklarasikan pada lebih dari satu cakupan — misalnya pada sebuah komponen dan pada subsistem yang memuatnya — menggambar koneksi dari setiap blok yang mendeklarasikannya, dan build mencatat keduanya hanya dengan nama lampiran. Kedua koneksi kemudian disebut pada salah satu blok yang mendeklarasikannya — blok lampiran milik komponen sendiri, di mana pun nama itu dideklarasikan di sana — dan tidak satu pun membawa posisi daftar. Hal yang sama berlaku di dalam Aggregate yang diimpor, tempat blok-blok yang mendeklarasikan — blok milik komponen dan blok salah satu subsistem milik modul itu sendiri — disebut di dalam dokumen milik modul itu sendiri. Dalam setiap bentuk ini, pasangan tersebut tetap ditolak.

Cara memperbaiki: berikan alias tersendiri kepada salah satu dari kedua koneksi. Untuk daftar yang menyebut satu target dua kali, daftarkan target sekali saja, atau tulis kedua koneksi sebagai entri berkunci dengan dua alias. Untuk satu alias pada dua socket, ganti nama salah satu dari kedua kunci. Lampiran yang menghubungkan socket dengan alias yang sudah digunakan komponen harus memakai kunci yang berbeda dalam blok uses: miliknya sendiri.

uses: socket not declared in the owning entity’s usesSchema (Socket uses tidak dideklarasikan dalam usesSchema entitas pemiliknya)

Sebuah blok uses: menyebut socket yang tidak dideklarasikan oleh entitas pemilik permukaan tersebut dalam usesSchema-nya, pada salah satu dari dua permukaan tempat hanya socket yang dideklarasikan yang boleh disebut: uses: milik lampiran Feature, tempat socket harus dideklarasikan pada Feature yang dilampirkan, dan uses: per-edge milik Release, tempat socket harus dideklarasikan pada Component yang mengonsumsi. Sebuah Release hanya dapat menyambungkan atau mengonfigurasi edge di dalam socket yang sudah dideklarasikan oleh usesSchema Component.

Permukaan lampiran diperiksa pada setiap cakupan tempat lampiran ditulis: pada komponen, pada subsistem — milik Aggregate atau milik modul yang diimpornya — pada boundary Release, dan pada entri komponen Release, termasuk entri untuk komponen yang dikontribusikan oleh modul. Deklarasi milik modul itu sendiri diperiksa setelah komposisi yang mengimpornya dibangun, dan temuan menyebut Aggregate milik modul dan kunci di dalam dokumennya.

Blok uses: milik komponen itu sendiri sengaja tidak termasuk permukaan tersebut, sehingga halt ini tidak terpicu untuknya. Developer memiliki topologi yang dideklarasikan Aggregate dan dapat menyebut socket yang tidak dideklarasikan oleh katalog; diamnya katalog tentang suatu socket berarti koneksi tersebut tidak diantisipasi, bukan bahwa koneksi itu dilarang. Socket semacam itu sah dan edge-nya dibangun — yang hilang adalah selector dan kontrak per-edge yang dibawa oleh socket yang dideklarasikan. Karena itu, salah eja nama socket di sana bukanlah halt melainkan koneksi ad-hoc tersendiri, dan dilaporkan sebagai peringatan yang menyebut kedua ejaan — lihat warnings.md “Uses-socket near-miss lint”.

Pesan yang diemisikan:

unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (socket uses tidak dikenal: sebutkan socket yang dideklarasikan entitas dalam usesSchema-nya — hanya blok uses milik komponen itu sendiri yang boleh menyebut socket yang tidak dideklarasikan katalog; Release, lokasi, tipe komponen, nama socket, dan socket yang dideklarasikan disebutkan)

Cabang lampiran menyebut tipe feature sebagai pengganti tipe komponen; Feature terlampir yang sama sekali tidak mendeklarasikan usesSchema justru melaporkan bahwa deklarasi uses: tidak diizinkan untuknya.

Cara memperbaiki: pada lampiran, perbaiki nama socket menjadi salah satu yang dideklarasikan Feature terlampir, atau deklarasikan socket tersebut dalam usesSchema milik Feature. Pada entri per-edge Release, perbaiki nama socket menjadi salah satu yang dideklarasikan Component yang mengonsumsi — Release tidak dapat memperkenalkan socket yang tidak dideklarasikan Component, dan memindahkan deklarasi ke entitas katalog adalah jalur yang didukung. Jika entitas katalog sama sekali tidak mendeklarasikan usesSchema, entitas itu tidak menerima deklarasi uses: pada permukaan tersebut — hapus blok itu.

A connection carries an attachment under a name its socket declares no slot for (Koneksi membawa lampiran dengan nama yang tidak memiliki slot yang dideklarasikan socket-nya)

Blok features: pada entri koneksi menyebut lampiran yang tidak dideklarasikan oleh slot mana pun pada socket koneksi tersebut. Lampiran yang dibawa koneksi merupakan himpunan tertutup: socket yang menyalurkan koneksi mendeklarasikan, dalam featuresSchema pada entri usesSchema milik Component yang mengonsumsi, setiap slot yang boleh diisi oleh koneksi pada socket itu, dan lampiran dengan nama lain ditolak saat build dimuat. Socket yang tidak mendeklarasikan featuresSchema tidak menerima lampiran pada koneksinya, begitu pula socket yang disebut Aggregate tanpa dideklarasikan oleh Component — socket semacam itu tidak mendeklarasikan slot.

Aturan ini berlaku pada kedua dokumen yang menulis lampiran koneksi: entri koneksi Aggregate di bawah uses: sebuah komponen, dan entri uses: per-edge milik Release. Untuk komponen yang disumbangkan sub-aggregate, nama-nama dari developer diperiksa setelah dokumen sub-aggregate itu sendiri dibaca, dan temuan menyebut file dokumen tersebut serta entri komponen di dalamnya. Nama-nama Release diperiksa setelah komposisi diratakan, untuk setiap komponen yang ditulis oleh Release, dan temuan menyebut entri Release itu sendiri — di dalam boundary tempatnya berada, atau di bawah entri routing yang menjangkau komponen sub-aggregate. Entri Release pada socket yang tidak dideklarasikan Component dilaporkan oleh halt socket tak terdeklarasi di atas, yang mencantumkan socket yang memang ada, bukan oleh halt ini.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu dokumen dan entri, nama lampiran, koneksi, socket, komponen, dan slot yang dideklarasikan socket — lalu apa yang harus dilakukan:

a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (koneksi membawa lampiran dengan nama yang tidak memiliki slot yang dideklarasikan socket-nya (Aggregate, pada, pada koneksi, melalui socket, dari komponen, socket mendeklarasikan slot). Tulis lampiran di bawah salah satu slot yang dideklarasikan socket, atau deklarasikan slot ini dalam featuresSchema socket pada Component.)

Jika nama tersebut berjarak satu suntingan dari slot yang dideklarasikan socket — karakter yang tertukar, hilang, ganda, atau salah, bentuk yang biasa diambil oleh salah ketik — slot itu disebut tepat setelahnya, sehingga ejaan yang kemungkinan dimaksud berada dalam kalimat yang sama:

a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …) (koneksi membawa lampiran dengan nama yang tidak memiliki slot yang dideklarasikan socket-nya (Release, pada, dekat slot yang dideklarasikan, pada koneksi, …))

Tidak ada peringatan terpisah yang dimunculkan untuk nama semacam itu. Pada blok features: milik komponen itu sendiri, nama yang berjarak satu suntingan dari slot yang dideklarasikan adalah sah dan hanya memicu peringatan di bawah “An attachment name is one edit from a declared slot” di bawah; pada koneksi, nama itu ditolak, dan penolakannya sendiri membawa pasangan tersebut.

Jika socket tidak mendeklarasikan slot, daftar tersebut tidak ada dan sarannya berbunyi “The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component.” (Socket tidak mendeklarasikan slot, sehingga tidak ada koneksi yang disalurkan melaluinya yang membawa lampiran: hapus lampiran, atau deklarasikan slot dalam featuresSchema socket pada Component.) Jika Component sama sekali tidak mendeklarasikan socket tersebut, sarannya berbunyi “The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema.” (Tipe komponen tidak mendeklarasikan socket ini, sehingga socket tidak mendeklarasikan slot dan tidak ada koneksi yang disalurkan melaluinya yang membawa lampiran: hapus lampiran, atau deklarasikan socket beserta slotnya dalam usesSchema Component.)

Setiap lampiran yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya.

Cara memperbaiki: tulis lampiran di bawah slot yang dideklarasikan socket; atau, jika koneksi memerlukan slot yang tidak dimiliki socket, deklarasikan slot tersebut dalam featuresSchema socket pada Component. Pada socket yang tidak dideklarasikan Component, deklarasikan socket beserta slotnya dalam usesSchema milik Component, atau hapus lampiran.

Release retargets a developer-declared edge (Release mengubah target edge yang dideklarasikan developer)

Entri uses: per-edge pada Release menyebut target yang berbeda dari target yang telah dihubungkan developer untuk socket dan alias yang sama. Release dapat mengonfigurasi edge yang dideklarasikan developer (menetapkan infra per-edge, dengan menyebut target yang sama atau menghilangkannya) dan dapat menghubungkan edge ke socket yang dideklarasikan tetapi belum terikat, tetapi Release tidak boleh mengubah target edge yang dideklarasikan developer — developer memiliki arsitektur yang mereka tulis.

Kedua target dibandingkan sebagaimana ditulis, bukan sebagaimana keduanya di-resolve. Sebuah target: dapat menyebut alias yang dipublikasikan sub-aggregate alih-alih id komponen, dan alias tersebut di-resolve ke komponen yang dipublikasikan modul untuknya — sehingga entri Release yang mengulang alias yang persis sama dengan yang ditulis developer merupakan konfigurasi dan diterima, sama seperti mengulang id komponen biasa.

Edge tetap mempertahankan target yang diberikan developer, terlepas dari apakah halt ini terpicu atau tidak, dan infra: dari entri Release tidak diterapkan padanya. Pengubahan target yang ditolak tidak pernah diterapkan setengah-setengah.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu target yang dideklarasikan developer, target yang disebut Release, dan socket — kemudian apa yang harus dilakukan:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (edge release mengubah target edge yang dideklarasikan developer (target yang dideklarasikan, target yang disebut Release, dihubungkan ke socket). Hapus target dari entri Release untuk mengonfigurasi koneksi sebagaimana dideklarasikan, atau ubah target di tempat koneksi dideklarasikan.)

Temuan ini diposisikan pada entri tertulis tempat koneksi dideklarasikan, dalam dokumen yang mendeklarasikannya. Setiap entri yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya alih-alih satu per eksekusi.

Cara memperbaiki: hapus target yang berbeda dari entri uses: pada Release untuk mengonfigurasi edge yang sudah ada (hanya infra per-edge), atau, jika koneksi tersebut memang termasuk socket lain, hubungkan melalui socket yang dibiarkan tidak terikat oleh developer. Untuk mengubah target itu sendiri, ubah di Aggregate, tempat topologi ditulis.

Release per-edge configuration has no edge to apply to (Konfigurasi per-edge Release tidak memiliki edge untuk diterapkan)

Entri uses: per-edge pada Release menetapkan infra:, attachment di bawah features:, atau keduanya, tetapi tidak ada edge pada consumer, socket, dan alias yang disebutnya, setelah semua edge dalam build digambar.

Dua hal yang dapat dilakukan entri Release adalah menghubungkan edge dan mengonfigurasi edge, dan mana yang dilakukan ditentukan oleh apakah entri tersebut menyebut target:. Entri dengan target membuat edge yang dikonfigurasinya. Entri tanpa target mengonfigurasi edge yang harus sudah ada — dideklarasikan oleh developer di Aggregate, atau disumbangkan oleh Feature yang dilampirkan. Jadi entri yang tidak menyebut target dan tidak cocok dengan edge yang ada tidak berlaku pada apa pun: blok infra: dan attachment di bawahnya tidak pernah mencapai output apa pun. Build berhenti alih-alih menerima penulisan yang tidak berdampak apa-apa, karena jika tidak, build yang berhasil akan terbaca sebagai konfirmasi bahwa infrastruktur telah diterapkan dan koneksi membawa apa yang ditetapkan entri padanya.

Alias merupakan bagian dari apa yang disebut entri, sehingga entri yang mengonfigurasi alias yang tidak pernah dideklarasikan developer tidak mencapai edge apa pun, bahkan ketika socket terikat di bawah alias lain. Demikian pula entri yang menyebut komponen yang tidak dideklarasikan Aggregate.

Dua kondisi yang berdekatan dilaporkan oleh halt masing-masing alih-alih oleh halt ini, karena masing-masing memiliki lebih banyak hal untuk disampaikan kepada Anda. Socket yang tidak dideklarasikan dalam usesSchema milik Component konsumen dilaporkan sebagai socket yang tidak dideklarasikan, yang dapat mencantumkan socket yang memang ada. target: yang tidak menyebut komponen apa pun dilaporkan sebagai target yang menggantung. Komponen yang dinonaktifkan oleh toggle active: membawa serta edge-nya secara desain, sehingga entri yang tertinggal padanya diterima alih-alih dihentikan.

Setiap entri yang bermasalah dilaporkan. Release dengan beberapa entri yang tidak mencapai edge apa pun berhenti dengan satu halt ini per entri dalam satu build, sesuai urutan deklarasinya dalam dokumen, alih-alih melaporkan yang pertama dan menyisakan sisanya untuk build berikutnya.

Pesan yang dikeluarkan, jika entri menyebut komponen yang ada. Pesan ini membawa path ke entri itu sendiri, sehingga yang disebut adalah baris yang perlu diedit, bukan komponen yang memuatnya:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (konfigurasi per-edge release tidak memiliki edge untuk diterapkan (Release, di, pada socket, di bawah alias). Berikan target pada entri untuk menghubungkan edge, atau hapus entri tersebut: entri tanpa target mengonfigurasi edge yang harus sudah ada.)

Release yang menyebut komponennya di tingkat teratas alih-alih di bawah boundary membawa bentuk yang ditulis penulisnya — .spec.components.<consumer>.uses.<socket>.<alias> — dan komponen yang disebut di dalam entri routing aggregates: disebut melalui entri tersebut, dengan nama lokal yang dimilikinya di sana.

Jika entri menyebut komponen yang tidak dideklarasikan Aggregate, halt berasal dari tahap build yang lebih awal dan berbunyi sebagai berikut, dengan menyebut apa yang ditetapkan entri — infra, features, atau infra and features:

release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (konfigurasi per-edge release tidak memiliki edge untuk diterapkan: edge release menetapkan nilai pada komponen yang bukan komponen dalam topologi)

Cara memperbaiki: tambahkan target: pada entri, yang menghubungkan edge dan menerapkan konfigurasi padanya; koreksi alias menjadi alias yang dideklarasikan Aggregate untuk koneksi tersebut, sehingga entri mengonfigurasi edge yang sudah ada; koreksi nama komponen menjadi nama yang dideklarasikan Aggregate; atau hapus entri jika konfigurasi tersebut tidak lagi diperlukan.

A Release attachment takes the name of a connection’s attachment (Lampiran Release memakai nama lampiran suatu koneksi)

Sebuah Release menulis lampiran dengan nama yang dipakai oleh lampiran pada salah satu koneksi sebuah komponen: alias koneksi, sebuah titik, dan slot yang diisi lampiran tersebut — gpt.credential untuk lampiran yang mengisi slot credential pada koneksi gpt. Lampiran suatu koneksi ditulis pada entri koneksinya — koneksi Aggregate di bawah uses: milik komponen, atau entri uses: per-edge milik Release untuk koneksi yang sama — dan menjadi lampiran komponen konsumen dengan nama gabungan tersebut. Release menulis lampiran pada dua cakupan lain yang kuncinya dapat memuat titik, sehingga nama gabungan itu juga dapat ditulis di sana:

  • Blok features: milik entri komponen itu sendiri, yang melampirkan ke komponen tersebut.
  • Blok features: milik boundary itu sendiri, yang melampirkan ke setiap komponen yang ditempatkan dalam boundary tersebut atau dalam boundary yang bersarang di dalamnya — termasuk komponen-komponen dari sub-aggregate yang dirutekan masuk oleh boundary tanpa menyebutkan namanya. Sebuah kunci di sana menghentikan build jika sama dengan nama gabungan pada komponen mana pun yang dijangkaunya, baik kunci itu menyebut type: maupun tidak.

Build dihentikan alih-alih melebur salah satunya ke dalam lampiran koneksi, karena dengan begitu tidak ada dokumen yang akan memperlihatkan keseluruhan dari apa yang dilakukan build terhadapnya. Slot sebuah socket diisi per koneksi, oleh entri koneksi itu sendiri, dan tidak pernah oleh lampiran yang mengalir ke sana dari cakupan yang lebih luas. Kunci bertitik yang tidak dipakai oleh lampiran koneksi mana pun dari komponen yang dijangkaunya adalah nama lampiran biasa, dan tidak ditolak.

Pemeriksaan ini mencakup lampiran yang ditaruh oleh salah satu dokumen pada koneksi, serta komponen yang disumbangkan oleh sub-aggregate maupun komponen yang dideklarasikan oleh Aggregate.

Pesan yang dikeluarkan, untuk kunci pada entri komponen. Penolakan muncul lebih dahulu, lalu Release dan entri komponen, kunci yang ditulis Release, komponen, koneksi, socket, dan slot — lalu entri koneksi tempat kunci itu harus ditulis:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (lampiran Release memakai nama lampiran yang dibawa salah satu koneksi sebuah komponen (Release, pada, dari komponen, pada koneksi, melalui socket, di slot). Tulislah pada entri koneksi, di bawah, dan hapus dari features entri ini: lampiran yang dibawa sebuah koneksi ditulis pada koneksi tersebut dan tidak di tempat lain.)

Pesan yang dikeluarkan, untuk kunci pada boundary. Pesan ini menyebutkan blok lampiran boundary dan komponen yang koneksinya membawa lampiran tersebut:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (lampiran Release memakai nama lampiran yang dibawa salah satu koneksi sebuah komponen (Release, pada, dari komponen, pada koneksi, melalui socket, di slot). Tulislah pada entri koneksi komponen tersebut, di bawah, dan hapus dari features boundary ini: lampiran yang dibawa sebuah koneksi ditulis pada koneksi tersebut dan tidak di tempat lain.)

Kunci pada boundary yang menjangkau beberapa komponen yang koneksinya membawa nama gabungan tersebut dilaporkan sekali untuk masing-masing komponen, karena setiap koneksi merupakan suntingan terpisah.

Temuan diposisikan pada blok tempat kunci ditulis — entri komponen, atau features: milik boundary — karena kunci itu sendiri memuat titik dan sebuah posisi tidak dapat menunjuk kunci semacam itu; sebagai gantinya, kunci disebutkan dalam pesan. Dalam Release yang menyebutkan boundary, entri komponen terbaca .spec.boundaries.<boundary>.components.<component>, komponen yang disebutkan di dalam entri perutean aggregates: disebutkan melalui entri tersebut, dengan nama lokal yang dibawanya di sana, dan blok boundary bersarang terbaca .spec.boundaries.<outer>.boundaries.<inner>.features.

Cara memperbaiki: pindahkan lampiran ke entri Release untuk koneksi tersebut — uses.<socket>.<alias>.features.<slot> di bawah komponen — dengan hanya menulis infra: di sana untuk mengatur ukuran lampiran yang dideklarasikan Aggregate, atau type: dan infra: untuk lampiran yang hanya dibuat oleh Release; lalu hapus kunci bertitik dari features: milik komponen atau boundary. Kunci tingkat boundary yang ditujukan untuk koneksi beberapa komponen ditulis sekali pada setiap koneksi tersebut.

A Release connection attachment names no Feature type (Lampiran koneksi Release tidak menyebutkan tipe Feature)

Sebuah entri uses: per-edge milik Release menaruh lampiran pada sebuah koneksi, di bawah slot yang tidak dideklarasikan lampirannya oleh Aggregate pada koneksi tersebut, dan tidak menyebutkan type:. Lampiran yang ditulis Release pada sebuah koneksi adalah salah satu dari dua hal. Lampiran itu mengatur ukuran lampiran yang sudah dideklarasikan Aggregate pada koneksi yang sama, dan tidak menyebutkan tipe karena deklarasi Aggregate sudah menyebutkannya; atau lampiran itu hanya dibuat oleh Release, dan dalam hal ini entri Release adalah satu-satunya tempat asal tipe Feature-nya. Tanpa tipe tersebut, tidak ada yang dapat memilih FeatureRecipe untuk lampiran itu.

Pemeriksaan ini mencakup komponen yang disumbangkan oleh sub-aggregate maupun komponen yang dideklarasikan oleh Aggregate. Komponen yang dinonaktifkan oleh toggle active: membawa serta koneksinya, sehingga entri yang tertinggal pada komponen tersebut tidak diperiksa.

Pesan yang dikeluarkan. Penolakan muncul lebih dahulu, lalu Release dan entri koneksi, slot, koneksi, socket, dan komponen — lalu apa yang perlu dilakukan:

a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (lampiran koneksi Release tidak menyebutkan tipe Feature, dan tipe tersebut diperlukan untuk lampiran yang hanya dibuat oleh Release (Release, pada, pada koneksi, melalui socket, dari komponen). Sebutkan Feature yang dilampirkan lampiran ini di bawah tipenya, atau deklarasikan lampiran pada entri koneksi Aggregate dan atur ukurannya di sini.)

Setiap lampiran yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya.

Cara memperbaiki: tambahkan type: yang menyebutkan Feature yang dilampirkan lampiran tersebut; atau, jika lampiran itu semestinya dideklarasikan oleh pengembang, deklarasikan pada entri koneksi Aggregate beserta values:-nya dan pertahankan hanya infra: pada entri Release.

Component identity cannot be stamped on what it emits (Identitas komponen tidak dapat dicapkan pada apa yang dikeluarkannya)

Identitas sebuah komponen bukan hanya kunci di dalam Aggregate Anda — identitas itu adalah nama di dalam kluster. Setiap sumber daya yang dikeluarkan sebuah komponen dicap dengannya, di bawah aggrega.ai/component-id dan app.kubernetes.io/name, dan penyintesis workload menamai apa yang dikeluarkannya berdasarkan identitas itu. Karena itu, identitas harus berupa nama yang diterima target, dan harus berupa nama yang berarti sesuai dengan yang dikatakannya.

Nama yang Anda tulis sampai ke keluarannya persis seperti yang Anda tulis, dan itulah yang membuat nama di dalam Aggregate Anda menjadi nama yang dapat Anda cari di kluster Anda. Hal itu layak dipertahankan, dan itulah sebabnya identitas yang akan ditolak target dilaporkan di sini alih-alih diperbaiki diam-diam menjadi sesuatu yang tidak pernah Anda tulis.

Satu karakter menjadi pengecualian, dan karakter itu tidak dapat Anda tulis: titik yang menggabungkan nama modul dengan nama komponen di dalamnya. Titik dicadangkan dari setiap nama yang Anda tulis justru agar penggabungan itu tidak ambigu, dan titik itu dihapus dari identitas sebelum dicapkan — data-layer.main-db dicapkan sebagai data-layer-zdmain-db. Hal itu tidak mengorbankan nama apa pun yang diketik seseorang, dan itulah yang memungkinkan komponen yang disumbangkan oleh Aggregate yang diimpor dapat dicapkan sama sekali: titik bukan karakter yang diterima nama Service, dan di dalam alamat kluster titik memisahkan sebuah layanan dari namespace-nya, sehingga nama bertitik yang diberikan kepada konsumen sebagai host akan mengarah ke layanan lain alih-alih gagal.

Dua bentuk ditolak.

Identitas yang tidak dapat dibawa oleh alfabet pencapan. Identitas ditulis ke dalam nilai label yang dibawa setiap sumber daya yang dikeluarkan, dan alfabet itu menerima huruf, angka, -, _, dan ., serta mewajibkan nilai diawali dan diakhiri dengan huruf atau angka. Aturan nama yang ditulis mirip dengan ini tetapi tidak sama — aturan itu mengizinkan nama diawali atau diakhiri dengan - atau _ — sehingga _api dan api- sama-sama nama yang dapat Anda tulis, tetapi keduanya tidak dapat dicapkan.

Panjang maksimum nama tidak diperiksa di sini. Hal itu menjadi urusan target tempat komponen di-deploy, dan setiap target menjawabnya secara berbeda: kondisi ini mencakup bentuk-bentuk yang tidak dapat dibawa oleh target mana pun. Nama yang ditolak karena panjangnya dilaporkan oleh penolakan target itu sendiri, yang memuat alasan target tersebut dan panjang yang akan diterimanya.

Identitas yang diawali seperti identitas yang disusun. Sumber daya yang dikeluarkan sebuah Feature tidak dapat dicap dengan nama komponen yang Anda tulis, sehingga Aggrega menyusun identitas untuknya dari bagian-bagian yang memang Anda tulis, di belakang awalan tetap yang menyatakan tempat Feature itu dilampirkan. Jika Feature dilampirkan pada satu komponen, identitas disusun dari komponen itu dan kunci tempat Feature dilampirkan, dan diawali dengan cfr--. Jika Feature dilampirkan pada seluruh boundary, tidak ada nama satu komponen pun yang berlaku, sehingga identitas disusun dari jalur boundary dan nama tempat Feature dilampirkan, dan diawali dengan bfr--. Awalan itulah yang memberi tahu pembaca dari mana di antara keduanya sebuah sumber daya berasal, alih-alih dari sebuah komponen. Karena itu, bfr-- dan cfr-- sama-sama dicadangkan di awal identitas komponen. Komponen bernama bfr--api atau cfr--api akan dicapkan sama persis dengan identitas yang disusun, dan tidak ada apa pun di keluaran yang dapat membedakan keduanya. Hanya awalan lengkap yang dicadangkan: komponen bernama bfr, cfr, bfr-api, atau bfrontend adalah nama biasa dan dapat di-build.

Pemeriksaan ini membaca identitas yang benar-benar dibawa sebuah komponen, yang untuk komponen yang disumbangkan oleh Aggregate yang diimpor adalah identitas berkualifikasi — nama modul, sebuah titik, dan nama komponen itu sendiri. Jadi, dua nama yang masing-masing dapat diterima tetap dapat tergabung menjadi identitas yang tidak dapat diterima: modul bernama bfr--x dan komponen bernama y di dalamnya tergabung menjadi bfr--x.y, yang diawali seperti identitas yang disusun. Penghentian ini menyebut identitas gabungan itu sambil menunjuk ke kunci yang Anda tulis.

Pesan yang dikeluarkan, untuk identitas yang akan ditolak target:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (identitas komponen tidak dapat menjadi nama yang dicapkan pada sumber daya yang dikeluarkannya: ganti nama komponen (Aggregate, di, yang harus))

dan untuk identitas yang diawali seperti identitas yang disusun, dengan <opening> adalah awalan cadangan mana pun yang cocok dengan nama itu:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (identitas komponen tidak dapat menjadi nama yang dicapkan pada sumber daya yang dikeluarkannya: ganti nama komponen (Aggregate, di, yang tidak boleh diawali dengan awalan cadangan))

Cara memperbaiki: ganti nama komponen di setiap tempat yang menyebutnya — Aggregate yang mendeklarasikannya, dan Release yang menempatkan serta mengonfigurasinya. Berikan nama yang diawali dan diakhiri dengan huruf atau angka serta tidak diawali dengan bfr-- maupun cfr--. Mengganti nama komponen mengubah nama yang dibawa sumber dayanya di kluster, jadi pada aplikasi yang sudah di-deploy, perlakukan hal ini seperti penggantian nama sumber daya lainnya.

The target will not accept a name derived from an authored identity (Target tidak akan menerima nama yang diturunkan dari identitas yang ditulis)

Setiap target menurunkan namanya sendiri dari identitas sebuah komponen: penginstal chart menurunkan nama rilis, orkestrator kontainer menurunkan nama layanan. Penghentian ini adalah target tersebut yang menyatakan bahwa ia tidak dapat menggunakan salah satunya.

Aggrega tidak menyimpan aturan penamaan target mana pun. Aggrega tidak tahu seberapa panjang sebuah nama boleh, karakter apa yang diterima sebuah target, atau apa yang diwajibkan tata bahasa target di awal sebuah nama — dan memang sengaja tidak tahu, karena hal-hal tersebut berbeda menurut target, menurut jenis sumber daya tempat nama itu berakhir, dan terkadang menurut satu layanan di dalam satu penyedia. Jadi, sebelum sebuah nama ditetapkan, compiler menanyakan penyedia yang akan merender komponen tersebut, dan penghentian ini melaporkan jawaban penyedia itu. Itulah sebabnya pesan ini memuat istilah target itu sendiri untuk apa yang ditolak (release name, Service name) dan alasan target itu sendiri, alih-alih aturan yang ditulis di dalam compiler.

Mengapa nama ditolak alih-alih dipendekkan. Nama yang Anda tulis adalah nama yang di-deploy untuk workload Anda: memendekkannya akan mengganti nama setiap sumber daya di setiap keluaran yang sudah ada, dan akan melakukannya atas nama Anda tanpa Anda memintanya. Orang yang dapat memilih nama lain adalah orang yang menulis nama ini, sehingga penghentian ini menunjuk ke kunci spec.components yang Anda tulis dan membiarkan nama itu apa adanya. Nama yang disusun oleh Aggrega sendiri — misalnya identitas sebuah Feature yang dilampirkan ke seluruh boundary — justru dipendekkan, karena nama tersebut dirakit dari bagian-bagian yang ditulis di beberapa dokumen dan tidak ada satu penulis pun yang dapat melihat panjang yang dicapainya.

Dua jawaban yang dapat diberikan target, dan keduanya mengarah ke tempat yang berbeda. Jika nama yang lebih pendek akan diterima, penghentian ini menyebutkan panjang yang dapat digunakan, sehingga nama baru cukup dipilih sekali, bukan dua kali. Jika tidak ada panjang yang membantu — sebuah karakter yang ditolak tata bahasa target pada posisi tempat karakter itu berada — tidak ada panjang yang disebutkan, karena pemendekan tidak dapat menjangkaunya. Kasus yang paling umum dari jenis kedua: target yang namanya hanya boleh huruf kecil meng-escape setiap karakter yang tidak diterimanya, dan setiap escape diawali tanda hubung, sehingga nama yang karakter pertamanya di-escape menghasilkan nama yang diawali tanda hubung. Target yang mewajibkan huruf kecil atau digit di posisi itu menolaknya, sependek apa pun sisanya. Target juga dapat memberlakukan aturan yang lebih ketat dari sumber daya yang dinamai berdasarkan nama tersebut pada awal nama: target helm menolak nama yang diawali digit, dilaporkan sebagai Service name, karena Helm menerima nama rilis seperti itu sementara kluster menolak Service Kubernetes yang dinamai berdasarkan nama tersebut.

Bentuk ketiga hanya muncul untuk nama yang disusun: target dapat menyebutkan panjang yang lebih pendek daripada identitas terpendek yang dapat disusun compiler dari bagian-bagian yang diberikan kepadanya, karena identitas yang disusun menyisakan ruang untuk pembeda. Penghentian ini menyatakan hal tersebut dan menyebutkan solusinya — pendekkan bagian-bagian yang ditulis — alih-alih melaporkan penyedia sebagai rusak.

Beberapa nama hanya ada untuk beban kerja yang dirender sebuah komponen. Penyedia ditanya setelah Workload komponen tersebut di-resolve, dan pertanyaannya memuat form milik Workload serta kunci-kunci Service-nya, sehingga target juga dapat menilai nama-nama yang dibangunnya dari keduanya. Pada target helm, hal ini menambahkan dua: sebuah CronJob name, paling banyak 52 karakter dan hanya dinilai untuk Workload scheduled, karena kluster menamai Job setiap eksekusi berdasarkan CronJob dengan akhiran yang ditambahkan; dan setiap Service name, <release name>-<service key>, paling banyak 63 karakter. Nama Service dibangun dari bagian-bagian milik dua penulis — nama komponen Anda dan kunci yang dideklarasikan beban kerja, di Recipe atau di FeatureRecipe — sehingga alasannya menyebut kunci tersebut dan tempat beban kerja mendeklarasikannya, spec.workload.services.<key>, di samping bidang yang Anda tulis. Kunci yang cukup panjang hingga tidak menyisakan ruang bagi nama komponen apa pun tidak menyebutkan panjang yang dapat dipilih, dan alasannya menyatakan bahwa kuncilah yang harus lebih pendek. Nama-nama ini tidak dinilai untuk Feature yang dilampirkan ke seluruh batas: identitasnya ditetapkan sebelum Workload-nya di-resolve, karena tempat keluarannya dirakit dapat bergantung padanya.

Pesan yang dikeluarkan, untuk identitas yang ditulis:

the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (target tidak akan menerima nama yang diturunkan dari identitas komponen ini yang ditulis: ganti nama komponen (komponen, ditulis di, yang tidak dapat digunakan target sebagai, alasan target). pilih nama yang paling banyak terdiri dari karakter yang diterima target)

Cara memperbaiki: ganti nama komponen menjadi nama yang diterima target, di setiap permukaan yang menyebutkannya — Aggregate yang mendeklarasikannya, dan Release yang menempatkan serta mengonfigurasinya. Jika pesan menyebutkan panjang, tetaplah dalam batas itu. Jika tidak, baca alasan target: biasanya berupa karakter yang tidak diterima target, dan paling sering huruf kapital di awal nama — atau, pada target helm, digit di posisi itu. Utamakan huruf kecil dan digit dengan tanda hubung di antara kata; bab penamaan menjelaskan konsekuensi sebuah nama pada setiap jenis target. Jika alasannya menyebut kunci Service, panjangnya juga dapat dipulihkan dengan memendekkan kunci tersebut di tempat beban kerja mendeklarasikannya — dan jika alasannya menyatakan bahwa kunci tidak menyisakan ruang, hanya cara itulah yang berhasil. Mengganti nama komponen mengubah nama yang dibawa sumber dayanya, jadi pada aplikasi yang sudah di-deploy, perlakukan hal itu seperti penggantian nama sumber daya lainnya.

Jika identitas tersebut disusun oleh compiler alih-alih ditulis oleh Anda, penghentian yang sama melaporkan nilai yang disusun dan meminta Anda memendekkan bagian-bagian penyusunnya — nama yang Anda gunakan untuk melampirkan sebuah Feature, dan path boundary tempat Anda melampirkannya.

A provider never accepted a name the compiler composed (Penyedia tidak pernah menerima nama yang disusun compiler)

Penghentian ini melaporkan cacat pada sebuah plugin, bukan pada apa pun yang Anda tulis.

Menetapkan nama yang disusun adalah sebuah pertukaran: compiler mengusulkan identitas, penyedia menerimanya atau menyatakan seberapa pendek nama itu harus, compiler menyusun nama yang lebih pendek, lalu penyedia ditanya lagi. Penolakan kedua adalah hal yang wajar dan diharapkan — pemendekan ke suatu panjang dapat menempatkan karakter di posisi yang tidak diterima tata bahasa target tersebut, dan pernyataan penyedia tentang hal itu adalah cara compiler yang tidak mengetahui tata bahasa target mana pun dan penyedia yang mengetahuinya mencapai kesepakatan.

Yang tidak wajar adalah penyedia yang tidak pernah menerima apa pun: penyedia yang menyebutkan suatu panjang, diberi nama dengan panjang tersebut, lalu menolaknya lagi. Pertukaran ini dibatasi, dan saat batas itu tercapai, build berhenti dan menyebutkan penyedia tersebut alih-alih menggunakan nama yang tidak pernah disetujui penyedia. Nama yang ditetapkan dengan menyerah akan dicap pada sumber daya nyata tanpa ada apa pun di keluaran yang mencatat bahwa kesepakatan tidak tercapai, dan akibatnya akan muncul saat apply, bukan pada build yang menghasilkannya.

Pesan yang diemisikan:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (guest penyedia tidak pernah menerima identitas komponen yang disusun compiler untuknya (guest penyedia, menolak usulan, yang terakhir di antaranya). laporkan cacat tersebut kepada siapa pun yang memelihara plugin penyedia itu)

Cara memperbaiki: laporkan kepada siapa pun yang memelihara plugin penyedia yang disebutkan, dengan mengutip usulan terakhir dari pesan. Tidak ada perubahan penulisan yang dapat mengatasinya: compiler sudah menawarkan setiap panjang yang diminta penyedia. Jika penyedia tersebut Anda pelihara sendiri, pemeriksaan yang perlu dilakukan adalah memastikan bahwa nama yang dipotong ke batas yang dinyatakannya adalah nama yang kemudian diterimanya.

Soket uses: wajib tidak terisi

Sebuah Component mendeklarasikan soket dalam usesSchema-nya yang ditandai required: true, dan tidak ada apa pun dalam build yang menyambungkan koneksi pada soket tersebut untuk salah satu instans Component itu.

Tiga permukaan dapat menyambungkannya, dan penghentian ini hanya terjadi bila ketiganya kosong. Blok uses: milik instans itu sendiri di dalam Aggregate; entri uses: per-edge pada Release yang menyebutkan target:, yang membuat koneksi ke soket yang dideklarasikan tetapi belum terikat; dan himpunan koneksi yang dihasilkan komposisi, yang menjadi penentu bagi komponen yang disumbangkan oleh Aggregate yang diimpor — blok uses: komponen semacam itu berada di dokumen milik Aggregate tersebut, yang baru dibaca setelah komposisi tersusun. Karena permukaan ketiga adalah yang terakhir lengkap, pemeriksaan dijalankan setelah seluruh komposisi ada, bukan saat kedua dokumen yang ditulis sedang dibaca, dan pemeriksaan itu mengajukan pertanyaan yang sama kepada setiap komponen, dokumen mana pun yang mendeklarasikannya.

Dua bentuk yang tampaknya seharusnya mengisi soket ternyata tidak. Entri Release yang tidak menyebutkan target: mengonfigurasi koneksi yang harus sudah ada alih-alih membuatnya, sehingga tidak menyambungkan apa pun (dan, bila membawa infra:, dilaporkan oleh penghentiannya sendiri di atas). Selain itu, uses: pada lampiran Feature menyebutkan soket yang dideklarasikan pada Feature yang dilampirkan, yaitu himpunan soket terpisah pada entitas terpisah, sehingga sebuah lampiran tidak pernah dapat mengisi soket milik Component itu sendiri.

Pesan yang diemisikan:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (socket uses wajib tidak terisi: socket pada lokasi yang disebut dideklarasikan wajib oleh tipe komponen yang disebut)

Temuan ini diposisikan pada entri soket yang harus ditulis oleh penulis, .spec.components.<instance>.uses.<socket>. Nama instans di dalamnya adalah nama yang dibawa komponen dalam dokumen yang mendeklarasikannya, sehingga untuk komponen yang disumbangkan oleh Aggregate yang diimpor, penunjuk lokasi menyebutkan kunci yang terdapat dalam file milik Aggregate tersebut, bukan nama berawalan yang diberikan komposisi.

Setiap soket wajib yang tidak terisi dilaporkan, pada setiap komponen: satu build memberi tahu Anda tentang semuanya, bukan hanya yang pertama.

Cara memperbaiki: tambahkan entri uses: untuk soket wajib tersebut, yang menyambungkannya ke target yang diterima oleh selector: soket; atau sambungkan dari Release dengan entri yang menyebutkan target:. Jika soket tidak lagi perlu diwajibkan, perbarui usesSchema milik Component untuk menetapkan required: false atau hapus deklarasi required.

Kedalaman penyarangan sub-aggregate terlampaui

Rantai impor sub-aggregate melampaui kedalaman penyarangan maksimum compiler. Batas ini mencegah perataan yang tak terkendali pada topologi yang bersarang dalam dan memaksa dekomposisi arsitektural di atas suatu ambang.

Pesan yang diemisikan:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (kedalaman penyarangan sub-aggregate maksimum terlampaui: kedalaman pada awalan)

Cara memperbaiki: susun ulang topologi aggregate untuk mengurangi penyarangan. Kedalaman penyarangan sedalam ini biasanya menunjukkan bahwa bentuk Aggregate mencerminkan hierarki organisasi, bukan topologi deployment — pertimbangkan untuk meratakan kelompok sub-aggregate menjadi subsistem sejajar di dalam satu Aggregate induk.

Feature type mismatch between Aggregate and Release (Ketidakcocokan tipe feature antara Aggregate dan Release)

Aggregate dan Release sama-sama melampirkan feature dengan nama instans yang sama, tetapi masing-masing mendeklarasikan type: yang berbeda, dan lampiran dari Release mencapai komponen dari features: sebuah boundary. Jika Release justru menuliskannya pada entrinya sendiri untuk komponen tersebut, konflik yang sama ditolak lebih awal dan dilaporkan sebagai E0153, di bawah “A feature attached by both the Aggregate and the Release cannot be merged (Feature yang dilampirkan oleh Aggregate dan Release sekaligus tidak dapat digabungkan)” di atas.

Pesan yang diemisikan:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (ketidakcocokan tipe feature antara Aggregate dan Release: node, lampiran, tipe yang ada bertentangan dengan tipe di Release)

Cara memperbaiki: hapus type: dari Release (Release akan mewarisinya dari Aggregate), atau ubah salah satu sisi agar keduanya mendeklarasikan tipe yang sama. Release boleh menghilangkan type: atau mengulang tipe milik Aggregate, tetapi tidak dapat menggantinya dengan tipe yang berbeda.

Extends siklik pada Components atau Features

Rantai extends: milik sebuah Component atau rantai extends: milik sebuah Feature berputar kembali ke dirinya sendiri.

Pesan yang dikeluarkan, dengan Feature sebagai pengganti Component bila rantai Feature yang berputar:

cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (rantai extends siklik: sebuah entitas meng-extend referensi yang sudah ada dalam rantai; hapus extends pada entitas tersebut, atau arahkan ke entitas di luar rantai)

Cara memperbaiki: buka entitas yang disebutkan oleh edge — yang pada rantai tiga atau lebih bukanlah entitas yang disebutkan di awal pesan — lalu hapus atau arahkan ulang extends:-nya.

Komponen yang dimiliki komposisi tidak ditempatkan di boundary mana pun

Sebuah Release menempatkan komponen dalam boundary dengan dua cara, dan salah satunya sudah cukup. Release menyebutkan komponen di bawah components milik sebuah boundary, dialamatkan dengan id yang dibawa komponen setelah seluruh komposisi diratakan. Atau Release mengarahkan modul yang menyumbangkan komponen itu ke dalam boundary di bawah aggregates, yang menempatkan semua komponen yang dimuat modul tersebut sekaligus.

Komponen yang tidak terjangkau oleh keduanya dirender di luar setiap boundary yang dideklarasikan Release. Direktori output-nya, sync wave-nya, anotasinya, dan infra per-komponennya lalu tidak berasal dari mana pun — dan jika tidak dihentikan, build akan berhasil, mengeluarkan artefak, dan tidak mengatakan apa pun bahwa konfigurasi operator tidak pernah diterapkan padanya. Dua komponen yang dipisahkan oleh garis itu juga dirender ke output yang berbeda dan kehilangan urutan yang mereka miliki bila ditempatkan bersama.

Dua bentuk sengaja tidak terkena penghentian ini. Release yang mendeklarasikan components tingkat atas alih-alih boundary bernama menempatkan semua yang disebutkannya: normalisasi Release semacam itu memberinya boundary sendiri yang memuat tepat komponen-komponen tersebut. Selain itu, komponen yang seluruh modulnya tidak ditempatkan Release di mana pun dilaporkan satu kali terhadap modul tersebut, di bawah entri berikut — satu kesalahan, satu solusi, satu kunci untuk disunting — alih-alih satu kali per komponen yang deklarasinya sendiri sudah benar.

Pesan yang dikeluarkan. Nilai di akhir adalah id yang dibawa komponen setelah komposisi diratakan, yang untuk komponen yang disumbangkan modul berupa nama modul tersebut, sebuah titik, dan nama komponen itu sendiri:

component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (komponen tidak ditempatkan di boundary mana pun: sebutkan di bawah components milik sebuah boundary, atau tempatkan sub-modul yang menyumbangkannya di bawah aggregates)

Cara memperbaiki: sebutkan komponen di bawah components milik sebuah boundary, menggunakan tepat id yang dikutip pesan — untuk komponen yang disumbangkan modul, itu adalah id berawalan, bukan nama yang ditulis di dalam file milik modul itu sendiri. Atau, bila seluruh modul termasuk dalam satu boundary, arahkan modul ke sana di bawah aggregates dan biarkan semua komponen yang dimuatnya ditempatkan sekaligus.

Komponen sebuah sub-modul tidak ditempatkan di boundary mana pun

Bentuk skala modul dari aturan di atas: sebuah modul yang dibawa masuk oleh komposisi telah menyumbangkan komponen, dan tidak ada boundary yang memuat satu pun di antaranya. Hal ini dilaporkan satu kali untuk modul tersebut, bukan satu kali per komponen, karena satu modul yang tidak ditempatkan di mana pun adalah satu kesalahan penulisan dengan satu perbaikan pada satu kunci — dan melaporkannya per komponen akan menyebut komponen-komponen yang deklarasinya sendiri sepenuhnya benar.

Aturan ini membaca penempatan, bukan cara penulisan, sehingga modul yang komponennya masing-masing disebut satu per satu di bawah components sebuah boundary dianggap telah ditempatkan dan lolos: menolaknya karena tidak ada entri perutean akan menolak bentuk penulisan yang diizinkan oleh bahasa. Modul yang hanya ditempatkan sebagian juga lolos — komponen mana yang memiliki entrinya sendiri adalah pertanyaan bagi aturan komponen, dan komponen yang terlewat dilaporkan di sana, masing-masing pada kuncinya sendiri.

Modul yang tidak menyumbangkan komponen apa pun tidak memicunya: tidak ada yang perlu ditempatkan. Begitu pula modul yang dihapus oleh toggle active: bernilai false, yang memang tidak pernah dikomposisikan sama sekali.

Pesan yang dikeluarkan, diposisikan pada entri aggregates yang mendeklarasikan modul tersebut, dengan nama lokal yang ditulis oleh dokumen pengimpor:

sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (sub-modul tidak ditempatkan di boundary mana pun: rutekan ke sebuah boundary di bawah aggregates, atau sebut komponennya di sana di bawah components)

Cara memperbaiki: tambahkan entri aggregates untuk modul tersebut di bawah boundary tempatnya berada, yang akan menempatkan setiap komponen yang disumbangkannya. Atau, jika komponennya termasuk dalam boundary yang berbeda-beda, sebut masing-masing di bawah boundary tempatnya berada, menggunakan id berprefiks yang dimilikinya setelah diratakan.

Sebuah boundary menyebut komponen yang tidak dimuat oleh komposisi

Pasangan kelebihan-penyebutan dari dua aturan di atas, dan merupakan pertanyaan tersendiri, bukan cabang dari salah satunya: kedua aturan itu menanyakan tentang sebuah komponen apakah ada yang menempatkannya, sedangkan aturan ini menanyakan tentang entri yang ditulis Release apakah ada yang sesuai dengannya. Keduanya tidak saling menyiratkan. Sebuah Release dapat menyebut komponen yang tidak ada sementara setiap komponen yang ada ditempatkan dengan benar, dan dapat membiarkan komponen nyata tidak ditempatkan sementara setiap entri yang ditulisnya terselesaikan.

Entri yang tidak menyebut apa pun tidak mengonfigurasi apa pun: directory, subDirectory, syncWave, anotasi, dan infra per komponennya ditulis untuk komponen yang tidak ada, sehingga tidak ada yang dirender di bawahnya dan build akan tetap berhasil dengan konfigurasi operator yang diam-diam tidak berpengaruh.

Sebuah boundary menyebut komponen dengan dua cara dan keduanya diperiksa. Di bawah components, entri merujuk komponen dengan id yang dimilikinya setelah komposisi diratakan — sehingga komponen yang disumbangkan modul ditulis dengan prefiks modul tersebut di depan namanya sendiri. Di dalam entri perutean aggregates, entri merujuk komponen dengan nama lokal yang dimilikinya di dalam modul tersebut, yang terselesaikan ke id yang sama. Pesan mengutip id yang dirujuk oleh entri, yang pada sumbu perutean bukan nama yang ditulis file: file memuat separuh lokal dan modul melengkapi sisanya.

Subsistem tidak menyumbangkan apa pun pada id komponen, sehingga komponen yang dideklarasikan di dalam subsistem dirujuk dengan nama polosnya. Entri yang ditulis seolah-olah subsistem merupakan bagian dari id tidak merujuk apa pun dan memicu halt ini.

Komponen yang dimatikan oleh toggle active: bernilai false tidak memicunya. Mematikan komponen adalah tindakan penulisan, dan Release yang mengonfigurasinya tidak diharapkan ditulis ulang dalam suntingan yang sama — menolak entri tersebut akan membuat toggle tidak dapat digunakan selama ada Release yang menyebut komponen itu.

Pesan yang diemisikan:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (boundary menyebut komponen yang tidak dimuat oleh komposisi: perbaiki namanya, atau hapus entrinya)

Cara memperbaiki: bandingkan id yang dikutip pesan dengan komponen yang benar-benar dimuat oleh komposisi. Prefiks modul yang hilang dan nama subsistem yang ditulis ke dalam id adalah dua penyebab umum; hapus subsistemnya, tambahkan prefiks modul, atau perbaiki ejaannya. Jika entri tersebut merupakan sisa dari komponen yang telah dihapus atau diganti namanya, hapus entri itu.

Edge uses menargetkan komponen yang dihapus oleh toggle active:

Saudara dari halt target-menggantung di atas, dilaporkan terpisah agar penulis diberi tahu mengapa target tidak ada. Target tidak absen karena tidak pernah dideklarasikan — target itu dideklarasikan, dan sengaja dihapus dari build ini karena toggle active:-nya terselesaikan menjadi false, sehingga edge-nya ikut terhapus. Komponen yang bertahan masih bergantung padanya, dan membiarkan edge itu lenyap akan membuat nilai yang diinjeksikan ke konsumen tersebut diam-diam kosong saat deploy.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu target yang dihapus toggle dan socket tempat koneksi dihubungkan — kemudian apa yang harus dilakukan:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (target edge uses dipangkas karena toggle active-nya terselesaikan menjadi false, dihubungkan ke socket. Pertahankan toggle active target bernilai true, atau hapus ketergantungan padanya.)

Temuan diposisikan pada entri tertulis yang dibahasnya, pada path yang sama dengan yang disebut halt target-menggantung di atas, dan setiap koneksi yang bermasalah dilaporkan, bukan hanya yang pertama.

Cara memperbaiki: tentukan mana dari keduanya yang termasuk dalam lingkungan ini. Aktifkan kembali target — jika toggle-nya membaca parameter, artinya parameter tersebut harus disediakan untuk Release ini. Atau letakkan konsumen di balik toggle yang sama, sehingga keduanya keluar bersamaan dan tidak ada edge yang tersisa menunjuk ke ketiadaan. Atau, jika konsumen memang tidak lagi membutuhkannya, hapus edge dari blok uses: konsumen.

A uses target names a module’s component the module does not export (Target uses menyebut komponen modul yang tidak diekspor modul tersebut)

Sebuah modul memublikasikan antarmukanya di bawah exportedComponents:, dan dokumen yang mengimpor modul tersebut hanya mencapai komponen modul melalui nama-nama itu: nama modul, sebuah titik, dan salah satu aliasnya. Target uses: yang mencapai komponen di dalam modul dengan cara lain apa pun — dengan nama komponen di dalam modul, atau dengan path yang melewati modul menuju modul yang bersarang di dalamnya — menghentikan build, karena koneksi tersebut akan terikat pada sesuatu yang tidak dipublikasikan oleh penulis modul dan bebas diganti namanya atau dihapus. Blok uses: milik komponen itu sendiri, blok milik lampiran, dan koneksi yang dihubungkan Release sama-sama tunduk pada aturan ini. Modul mana yang dimasuki sebuah koneksi dibaca dari tempat konsumennya berada, sehingga koneksi antara dua komponen dari satu modul — termasuk ketika Release menghubungkan keduanya satu sama lain — tidak melintasi antarmuka apa pun dan tidak ditolak. Target yang tidak sesuai dengan komponen mana pun justru dilaporkan oleh penghentian target menggantung, sehingga satu nama yang salah ketik dilaporkan sekali.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu target sebagaimana ditulis, modul yang dimasukinya beserta alias yang diekspor modul itu, dan socket — lalu apa yang perlu dilakukan:

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (target edge uses menyebut komponen yang tidak diekspor modulnya (target, modul beserta alias yang diekspornya, dan socket tempat koneksi dihubungkan disebutkan). Sebut komponen melalui salah satu alias yang diekspor modul, atau cantumkan di bawah exportedComponents milik modul.)

Modul yang tidak mengekspor apa pun disebut mengekspor "nothing". Temuan diposisikan pada entri yang ditulis dalam dokumen yang menggambar koneksi tersebut.

Cara memperbaiki: sebut komponen melalui alias yang diekspor modul — finance-db-subsystem.primary_db, bukan finance-db-subsystem.internal-pg-primary — atau, jika Anda yang menulis modul dan bermaksud memublikasikan komponen tersebut, cantumkan di bawah exportedComponents milik modul, dengan namanya sendiri jika itu nama yang seharusnya digunakan pengimpor.

Toggle active: tidak terselesaikan menjadi true atau false

Toggle active: mencapai graph builder dalam keadaan sudah terselesaikan menjadi literal — boolean yang ditulis langsung, atau referensi parameter yang telah disubstitusi dengan nilai Release sebelum dokumen dibaca. Toggle itu kemudian dibaca secara ketat: literal yang bukan boolean menghentikan build alih-alih menggunakan nilai default apa pun. Aturannya sama untuk toggle komponen maupun toggle modul.

Literal kosong adalah kasus yang patut disebut, karena itulah yang dihasilkan parameter yang tidak terpenuhi. Toggle yang membaca {{ .parameters.<key> }} terselesaikan menjadi kosong selama parameter tersebut tidak memiliki nilai, dan membaca kekosongan sebagai “ada” akan men-deploy entitas yang justru disembunyikan penulis di balik parameter itu. Hanya toggle yang tidak ditulis sama sekali yang default-nya ada, dan itu dibaca dari ketiadaan toggle, bukan dari nilainya — itulah sebabnya menulis active: tanpa apa pun setelahnya tidak sama dengan menghilangkan kuncinya.

Pesan yang diemisikan:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (toggle active tidak terselesaikan menjadi boolean)

dan, jika terselesaikan menjadi kosong sama sekali, disertai saran yang menyebut penyebab umumnya:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (toggle active tidak terselesaikan menjadi boolean. toggle yang membaca parameter terselesaikan menjadi kosong hingga parameter tersebut dipenuhi)

Cara memperbaiki: tulis true atau false. Jika toggle membaca parameter, sediakan parameter itu di Release, atau berikan default: di tempat parameter itu dideklarasikan dalam Aggregate sehingga setiap lingkungan memiliki jawaban. Agar entitas selalu ada tanpa syarat, hapus kunci active: alih-alih membiarkannya kosong.

Modul yang diimpor komposisi tidak dapat dimuat, atau mengimpor dirinya sendiri

Sebuah Aggregate menyusun Aggregates lain dengan menyebutkannya di bawah aggregates:, dan masing-masing dimuat serta ditelusuri secara bergiliran sehingga komponennya bergabung ke dalam graf. Dua hal menghentikan penelusuran itu di sini.

Modul sama sekali tidak dapat dimuat — referensinya tidak mengarah ke apa pun yang dapat dikembalikan katalog, atau dokumen di baliknya tidak dapat dibaca. Alasan yang diberikan pemuat disertakan di bawah penghentian alih-alih dilebur ke dalamnya, sehingga apa yang gagal dilaporkan dengan kata-kata pemuat itu sendiri.

Atau modul menyebutkan tipe yang sudah ada di rantai yang sedang ditelusuri. Mengekspansinya akan mereproduksi rantai yang memuatnya, tanpa akhir. Hal ini dilaporkan pada titik referensi menutup lingkaran, dengan menyebutkan tipe tersebut dan letaknya dalam komposisi.

Pesan yang dikeluarkan, untuk referensi melingkar:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (pemuatan sub-aggregate gagal (referensi sub-aggregate melingkar, di))

dan untuk kegagalan pemuatan, ketika penghentian hanya berisi kalimat itu, diposisikan pada path modul, dengan alasan dari pemuat sendiri di bawahnya:

sub-aggregate load failed (pemuatan sub-aggregate gagal)

Cara memperbaiki: untuk kegagalan pemuatan, baca alasan di bawah penghentian — nama atau versi yang tidak dapat dijawab katalog adalah kasus yang umum, dan koreksinya dilakukan pada entri aggregates: yang menyebutkannya. Untuk referensi melingkar, putuskan lingkarannya: path dalam pesan adalah tempat rantai menutup, dan salah satu modul di sepanjangnya harus berhenti mengimpor modul yang mengimpornya. Jika dua modul memang saling membutuhkan komponen satu sama lain, bagian bersama itu sebaiknya ditempatkan di modul ketiga yang diimpor keduanya.

Dua instans diratakan menjadi satu pengenal

Menyusun sebuah Aggregate meratakan setiap komponen ke dalam satu himpunan, dan komponen yang disumbangkan sebuah modul membawa nama modul itu, sebuah titik, dan namanya sendiri. Himpunan tersebut menolak menampung dua entri di bawah satu pengenal: entri kedua akan menggantikan yang pertama, dan salah satu dari kedua komponen akan hilang dari keluaran tanpa pemberitahuan apa pun.

Penghentian ini muncul saat komponen sebuah modul digabungkan, dan permukaan penulisan tidak menyediakan nama yang dapat menghasilkannya. Setiap komponen yang disumbangkan sebuah modul membawa nama modul itu di depan namanya sendiri; nama instans ditulis dari huruf, angka, - dan _, sehingga tidak dapat memuat titik yang menggabungkan keduanya, dan dua pengenal yang dibangun dari nama modul berbeda tidak dapat bertemu. Dua modul yang diimpor dengan satu nama merupakan satu kunci duplikat, dan dokumen ditolak saat dimuat. Jadi, ini menjadi pengaman bagi komposisi yang dirakit oleh sesuatu selain jalur penulisan biasa, dan bila Anda menjumpainya, hal itu layak dilaporkan alih-alih diakali.

Dua komponen dari satu Aggregate yang mencapai satu pengenal adalah penghentian yang berbeda, dan penulisan biasa dapat menghasilkannya — lihat Two subsystems declare a component under one name (Dua subsistem mendeklarasikan komponen dengan satu nama) di bawah.

Pesan yang diemisikan:

flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (tabrakan ID node yang diratakan: ganti nama salah satu instans yang bertabrakan agar ID ratanya berbeda (id, path, bertabrakan dengan entri yang ada dari))

Cara memperbaiki: ganti nama salah satu dari dua instans yang disebutkan pesan, di dokumen yang mendeklarasikannya dan di setiap entri Release yang mengalamatkannya.

Dua subsistem mendeklarasikan komponen dengan satu nama

Subsistem mengelompokkan komponen sebuah Aggregate untuk pembaca dan untuk apa yang diturunkan kepadanya; subsistem tidak mengualifikasi nama yang digunakan komponen. Komponen yang dideklarasikan di bawah subsystems.frontend dialamatkan sebagai api, bukan sebagai frontend.api, dan komponen yang disumbangkan sebuah modul membawa nama modul itu, bukan nama subsistemnya. Jadi, dua subsistem dari satu Aggregate masing-masing dapat mendeklarasikan komponen bernama api, dan keduanya lalu menjawab pengenal yang sama.

Dokumennya terbentuk dengan baik — keduanya adalah kunci terpisah di blok terpisah, itulah sebabnya tidak ada yang menolaknya lebih awal — tetapi hanya satu komponen yang dapat membawa sebuah pengenal. Build berhenti alih-alih mempertahankan yang terakhir dibaca dan merender seolah-olah hanya satu komponen yang dideklarasikan.

Nama yang sama dua kali di dalam satu subsistem adalah kesalahan yang berbeda: itu adalah dua entri di bawah satu kunci, dan dokumen ditolak saat dibaca.

Pesan yang diemisikan:

components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (komponen di subsistem berbeda mengambil identitas yang sama: ganti nama salah satunya, karena subsistem tidak menyumbang apa pun pada identitas komponen)

Cara memperbaiki: ganti nama salah satu dari dua komponen tersebut, di dokumen yang mendeklarasikannya dan di setiap entri Release yang mengalamatkannya. Jika keduanya memang komponen yang sama yang diinginkan di dua tempat, deklarasikan sekali dan buat dependensi padanya dari subsistem lain. Mengganti nama subsistem tidak membantu: subsistem bukan bagian dari nama.

Alias komponen yang dipublikasikan ulang menunjuk kembali ke dirinya sendiri

Sebuah modul memublikasikan sebagian dirinya dengan mengekspor komponen di bawah alias, dan Aggregate yang mengimpornya dapat memublikasikan ulang salah satu alias itu dengan namanya sendiri. Penyelesaian alias semacam itu mengikuti rantai publikasi ulang hingga komponen yang pada akhirnya dirujuk, sehingga edge yang menunjuk ke nama publik mencapai komponen yang nyata.

Rantai yang mengunjungi ulang sebuah alias sebelum mencapai komponen tidak pernah berakhir. Penelusuran berhenti alih-alih mengikutinya tanpa henti, dan menyebutkan rantai yang ditelusurinya sehingga tautan yang menutup lingkaran terlihat.

Tidak ada yang dapat Anda tulis yang menghasilkan rantai semacam itu. Pohon impor bersifat asiklik, dan setiap tautan menyebutkan sesuatu yang bersarang lebih dalam daripada tautan sebelumnya, sehingga rantai yang dirakit dari impor selalu menurun dan berakhir. Oleh karena itu, ini menjadi pengaman bagi tabel alias yang dirakit oleh sesuatu selain jalur penulisan biasa, bukan bentuk yang dapat dideklarasikan sebuah Aggregate.

Pesan yang diemisikan:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (alias komponen yang diekspor ulang membentuk siklus (rantai alias))

Cara memperbaiki: tidak ada apa pun dalam berkas Anda yang menghasilkannya, dan tidak ada perubahan penulisan yang menghilangkannya. Laporkan dengan perintah yang Anda jalankan dan rantai alias yang disebutkan pesan, yaitu detail yang menunjukkan tempat lingkaran menutup.

An Aggregate reached graph building without being normalised (Sebuah Aggregate mencapai pembangunan graf tanpa dinormalisasi)

Aggregate yang ditulis dengan komponen di tingkat teratasnya dan Aggregate yang ditulis dengan subsistem bernama menjadi bentuk yang sama saat dibaca: komponen tingkat teratas dilipat ke dalam subsistem yang disediakan kompiler, dan tingkat teratas dikosongkan. Pelipatan itulah yang memungkinkan semua tahap selanjutnya mengajukan satu pertanyaan pada satu bentuk.

Aggregate yang tiba di pembangunan graf dengan keduanya terisi tidak dihasilkan oleh pembacaan itu. Kedua bentuk saling eksklusif di tempat keduanya ditulis — dokumen yang mendeklarasikan keduanya ditolak saat dimuat — dan pelipatan itulah yang menjadikannya satu bentuk setelahnya, sehingga tidak ada yang dapat ditulis seorang penulis yang mencapai kondisi ini. Ini menjadi pengaman bagi Aggregate yang dirakit oleh sesuatu selain jalur pemuatan biasa, dan bila Anda menjumpainya, hal itu layak dilaporkan alih-alih diakali.

Pesannya dimulai dengan:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (aggregate mencapai topologi tanpa dinormalisasi (komponen root yang tidak kosong bersama subsistem default yang disintesis))

dan dilanjutkan dengan jalur konstruksi yang diharapkan kompiler, yang merupakan catatan bagi siapa pun yang men-debug build, bukan instruksi penulisan.

Cara memperbaiki: tidak ada apa pun dalam berkas Anda yang menghasilkannya, dan tidak ada perubahan penulisan yang menghilangkannya. Laporkan dengan perintah yang Anda jalankan.

A label-transform plugin’s patch reaches outside node labels (Patch dari plugin label-transform menjangkau di luar label node)

Plugin tata kelola yang dipasang dalam peran label-transform diberi proyeksi graf — satu entri per node, membawa label node tersebut dan nilai yang dideklarasikan instansnya, dengan setiap nilai yang dideklarasikan sensitif oleh Component-nya disembunyikan — dan mengembalikan patch terhadap label node. Host menerapkan patch tersebut hanya pada label lalu memeriksa bahwa yang dikembalikan masih tampilan label itu: node yang sama, masing-masing hanya membawa label, dan setiap nilai label berupa string.

Apa pun selain itu ditolak dan build berhenti. Menambahkan atau menghapus node, atau mengubah field node selain labelnya, justru merupakan kemunculan diam-diam infrastruktur yang tidak dideklarasikan siapa pun — jadi alih-alih menyerap perubahan yang tidak dicakup oleh peran tersebut, build menyebutkan aturan pembatasan mana yang dilanggar patch. Label adalah seluruh permukaan peran ini, dan operator yang memasang plugin tersebut mendeklarasikan sebatas itu dan tidak lebih.

Pesan yang dikeluarkan. Patch ditolak sebelum diterapkan:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (patch mutator ditolak: patch tidak dapat didekode sebagai dokumen JSON Patch) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (patch mutator ditolak: patch tidak dapat diterapkan pada permukaan label node)

atau hasil penerapannya bukan tampilan yang diserahkan host:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (patch mutator ditolak: ukuran himpunan node yang dimutasi berubah; mutator tidak boleh menambah atau menghapus node) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (patch mutator ditolak: himpunan node yang dimutasi memunculkan node baru; mutator tidak boleh menambah node) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (patch mutator ditolak: node mendapat field di luar labels; mutator hanya boleh menyentuh label) mutator patch rejected: node "<node>" lost its "labels" field (patch mutator ditolak: node kehilangan field labels-nya) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (patch mutator ditolak: node membawa nilai label bukan string setelah di-patch)

Cara memperbaiki: kesalahannya ada pada plugin, bukan pada dokumen Anda. Perbaiki plugin tersebut agar setiap operasi yang dikembalikannya menyasar entri di bawah labels suatu node, dan hanya menetapkan nilai string — nilai label numerik atau boolean adalah kasus yang umum, karena permukaan ini hanya menerima string. Menghapus pemasangan dari plugins.governance adalah cara langsung untuk membuka blokir build selagi plugin diperbaiki.

Penghilangan yang disengaja: topologi tidak diwajibkan asiklik

Aggrega mengizinkan siklus dalam topologi: ia tidak mensyaratkan graf dependensi berupa Directed Acyclic Graph (graf asiklik berarah). Arsitektur agen-ke-agen, pola callback, dan pasangan autentikasi timbal balik semuanya menghasilkan edge siklik, dan compiler menerimanya. Urutan pada saat deploy merupakan urusan renderer (melalui syncWave per boundary atau yang setara), bukan urusan graf IR.

Saat memeriksa kontrak inject

Compiler menelusuri setiap blok inject: — baik self-inject (sebuah Component yang melakukan inject ke dirinya sendiri) maupun uses-inject (penyambungan lintas Component) — dan memvalidasi kontrak pengiriman terhadap skema provides: milik Component target, partisi label milik Feature, dan himpunan kunci pengiriman yang dideklarasikan. Kunci from: pada blok yang ditulis oleh komponen milik Aggregate itu sendiri diperiksa segera setelah katalog di-resolve, sehingga kegagalannya mengacu pada baris yang Anda tulis; kunci semacam itu pada blok komponen yang dikontribusikan oleh modul diperiksa setelah komposisi yang mengimpor modul tersebut dibangun, dan kegagalannya mengacu pada baris di dokumen milik modul itu sendiri; kunci from: pada koneksi yang dikontribusikan oleh Feature yang terpasang diperiksa setelah setiap permukaan yang dapat membuat koneksi telah berkontribusi, yaitu titik paling awal ketika koneksi semacam itu ada untuk diperiksa.

Inject from key is not in the target’s provides (Kunci from pada inject tidak ada dalam provides milik target)

Sebuah entri inject: mereferensikan kunci from: yang tidak diterbitkan oleh sumber yang dibacanya: skema provides: milik Component target untuk blok milik komponen itu sendiri atau untuk sebuah koneksi, dan FeatureRecipe milik Feature yang dilampirkan untuk blok inject: milik Feature yang dilampirkan itu sendiri.

Pemeriksaan ini berlaku di mana pun koneksi ditulis. Sebuah koneksi uses: mencapai topologi yang dibangun dari lebih dari satu permukaan penulisan — blok uses: milik Component itu sendiri, dan blok uses: dari Feature yang dipasang padanya, baik pemasangan itu ditulis pada komponen, pada subsistem, pada batas Release, maupun pada entri komponen dari batas Release — dan kunci yang salah eja yang sama ditolak pada setiap permukaan tersebut. Diagnostik menunjuk ke blok yang penulisnya menulis kunci itu: entri uses: milik pemasangan itu sendiri, di lokasi tempat pemasangan itu dideklarasikan, bukan di blok uses: milik komponen konsumen, yang untuk koneksi hasil kontribusi sama sekali tidak berisi apa pun.

Tempat referensi di-resolve bergantung pada tempat referensi itu berada. from: self-inject di tingkat Component di-resolve terhadap provides: milik Component yang sama. from: pada koneksi uses: di-resolve terhadap provides: milik komponen yang dituju koneksi tersebut — dan ketika dua permukaan menulis satu soket dan satu alias, setiap koneksi di-resolve terhadap target yang disebutkannya sendiri, dalam build yang sama yang menolak pasangan tersebut karena berbagi alias. Component yang tidak mendeklarasikan provides: menolak setiap referensi from: yang ditujukan kepadanya.

Blok inject: milik Feature yang dilampirkan itu sendiri. Di sana, sebuah from: diselesaikan terhadap kunci yang diterbitkan FeatureRecipe milik Feature tersebut dalam provides: miliknya, sebagaimana dievaluasi untuk komponen tempat Feature itu dilampirkan, dan diperiksa saat komponen tersebut dirender. Kunci yang tidak diterbitkan FeatureRecipe tidak akan memasukkan apa pun ke lingkungan, file, atau argumen komponen, sehingga build justru dihentikan — kecuali FeatureRecipe sendiri membaca entri Feature yang dilampirkan, di .inject, dalam templat yang dievaluasinya terhadap konteks render milik Feature yang dilampirkan itu sendiri — konteks yang membawa .inject: pemetaan nilainya, beban kerjanya, artefaknya, daftar pengecualiannya, atau with: maupun when: dari sebuah langkah pipeline, yang ditulis inline atau diimpor. locals:, provides:, source:, dan assertions: miliknya tidak membawa .inject, dan injectMapping: miliknya dievaluasi terhadap konteks komponen, sehingga pembacaan di salah satunya tidak dihitung. FeatureRecipe seperti itu menerima setiap entri sebagaimana ditulis dan mengirimkannya dengan caranya sendiri, sehingga entrinya tidak ditolak, dan kunci yang tidak diterbitkannya tidak mengirimkan apa pun melalui pengiriman milik komponen itu sendiri dan menjadi bagian FeatureRecipe untuk digunakan. Apakah sebuah FeatureRecipe membaca .inject ditentukan dari jalur yang disebut oleh templatnya: templat yang meneruskan seluruh konteksnya (toJson .) atau menjangkau entri melalui fungsi seperti index . "inject" tidak dihitung sebagai membaca entri tersebut, dan entrinya yang menyebut kunci yang tidak diterbitkan ditolak. Feature yang dilampirkan pada sebuah batas, yang FeatureRecipe miliknya dirender sekali untuk batas tersebut, diperiksa terhadap satu evaluasi itu; jika tidak ada batas yang memuat komponen tersebut yang menghasilkan evaluasi itu, tidak ada acuan untuk memeriksa kuncinya dan kunci tersebut tidak ditolak. from: yang menyebut kunci yang diterbitkan mengirimkan seperti sebelumnya. Temuan ini diposisikan pada entri milik Feature yang dilampirkan itu sendiri, dalam dokumen yang menulisnya — misalnya .spec.components.<component>.features.<attachment> dalam Aggregate — dan entri yang kunci pengirimannya juga sudah dipegang oleh sumber inject lain dilaporkan pula di bawah “An attachment delivers a key another inject source already claimed (Sebuah lampiran mengirimkan kunci yang sudah diklaim oleh sumber inject lain)”, karena masing-masing memerlukan perbaikannya sendiri.

Pada blok inject: milik komponen itu sendiri, entri value: membawa literal dan tidak di-resolve terhadap apa pun, sehingga literal yang kebetulan terbaca seperti kunci provides tidak ditolak di sana; pada koneksi, entri value: ditolak, sebagaimana dijelaskan pada “An inject: entry on a connection carries a literal (Entri inject pada koneksi membawa literal)” di bawah. Hanya from: yang menyebutkan kunci.

Permukaan uses: per-edge milik Release itu sendiri membawa target dan infra dan tidak membawa inject:, sehingga koneksi yang disambungkan di sana tidak menentukan pengiriman dan tidak memiliki kunci from: untuk diperiksa.

Pesan yang dikeluarkan, untuk from: yang dibaca pada blok inject: milik Component itu sendiri. Penolakan muncul lebih dulu, lalu kunci yang bermasalah, tipe komponen yang menjadi acuan resolve, dan kunci-kunci yang dideklarasikan tipe tersebut dalam urutan terurut — alternatif yang dapat dipilih:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (kunci inject tidak valid: from-key harus menyebutkan kunci provides yang diterbitkan oleh sumbernya)

Untuk from: yang dibaca pada koneksi uses:, penolakan yang sama muncul di depan, dan mekanisme serta kunci pengiriman tempat entri itu ditulis muncul sebelum kunci yang bermasalah:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (kunci inject tidak valid: from-key harus menyebutkan kunci provides yang diterbitkan oleh sumbernya)

Untuk from: yang dibaca pada blok inject: milik Feature yang dilampirkan itu sendiri, kunci yang bermasalah muncul pertama, lalu in: dan mekanisme entri, FeatureRecipe yang menjadi acuan penyelesaiannya, dan setiap kunci yang diterbitkan FeatureRecipe tersebut, dalam urutan terurut:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (kunci inject tidak valid: from-key harus menyebutkan kunci provides yang diterbitkan oleh sumbernya)

Ketika target sama sekali tidak mendeklarasikan kunci provides:, tidak ada alternatif untuk dicantumkan, sehingga pesan berakhir setelah tipe komponen — atau, pada blok Feature yang dilampirkan, setelah FeatureRecipe.

Cara memperbaiki: ubah kunci from: agar cocok dengan salah satu kunci yang dideklarasikan yang tercantum dalam pesan, atau perluas skema provides: milik Component target untuk mendeklarasikan kunci yang Anda perlukan. Pada blok Feature yang dilampirkan, ubah kunci from: menjadi kunci yang diterbitkan FeatureRecipe, atau — jika FeatureRecipe tersebut milik Anda — terbitkan kunci itu dalam provides: miliknya, atau buat FeatureRecipe membaca entri itu sendiri di .inject jika FeatureRecipe mengirimkan nilainya dengan caranya sendiri.

Required feature not attached (Fitur wajib tidak terpasang)

Component mendeklarasikan mandat kehadiran — anotasi features.aggrega.ai/requiredType.<label> — yang menyebutkan tipe Feature yang tidak ada di antara pemasangan yang akhirnya dimiliki instans komponen ini, dengan menghitung setiap cakupan: blok tingkat komponen dan tingkat subsistem milik Aggregate, blok tingkat batas dan tingkat komponen milik Release, serta ekspansi berbasis anotasi.

Pesan yang diemisikan:

missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (fitur wajib tidak ada: pasang Feature dengan tipe yang diwajibkan pada komponen, diwajibkan oleh tipe komponen, di bawah label persyaratan)

Ketiga nilai tersebut adalah tipe Feature yang dituntut mandat — yang sudah disebutkan oleh kalimat di atas, sehingga ditampilkan tanpa keterangan — lalu tipe komponen yang mendeklarasikan mandat dan label yang dibawa mandat, masing-masing diberi keterangan agar pembaca dapat membedakan dua referensi entitas. Komponen yang menuntut dua tipe berbeda melaporkan dua pesan yang berbeda, dan dua komponen yang mendeklarasikan mandat dari tipe yang berbeda diberi tahu tipe mana yang membuat setiap tuntutan. Laporan diposisikan pada kunci komponen itu sendiri di bawah components:, dan komponen yang ditulis di dalam subsistem diposisikan terlebih dahulu di bawah kunci subsistem tersebut.

Nama tempat pemasangan ditulis tidak berpengaruh di sini: mandat hanya menanyakan apakah ada pemasangan dengan tipe yang disebutkan. Mengikat sebuah slot memenuhinya, demikian pula pemasangan dengan nama lain apa pun.

Cara memperbaiki: pasang Feature dengan tipe yang diwajibkan pada komponen di Aggregate atau Release, atau pada cakupan yang lebih luas yang diwarisi komponen. Jika Component tidak lagi perlu mewajibkannya, hapus anotasi mandat dari deklarasi katalognya.

Malformed attachment requirement (Persyaratan pemasangan tidak valid)

Deklarasi mandat kehadiran tidak dapat dievaluasi. Nilai anotasi adalah string opak, sehingga tidak ada yang memvalidasi bentuknya sebelum compiler membacanya: nilai yang bukan URI tipe Feature, atau kunci yang menyebutkan keluarga mandat tanpa label setelah prefiksnya, dilaporkan sebagai deklarasi yang rusak, bukan sebagai persyaratan yang tidak terpenuhi — salah ketik tidak boleh terbaca sebagai persyaratan yang terpenuhi.

Pesan yang dikeluarkan:

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (persyaratan pemasangan tidak valid, dideklarasikan oleh tipe komponen, yang tidak dapat dievaluasi karena nilainya harus berupa URI tipe Feature dengan bentuk segmen kebab huruf kecil. Perbaiki anotasi tersebut pada entitas katalog tipe komponen.)

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (persyaratan pemasangan tidak valid, dideklarasikan oleh tipe komponen, yang tidak dapat dievaluasi karena kuncinya memerlukan label yang menyebutkan persyaratan. Perbaiki anotasi tersebut pada entitas katalog tipe komponen.)

Pesan diawali dengan kunci anotasi — deklarasi yang menjadi pokok penghentian — dan setelahnya menyebutkan tipe komponen yang deklarasinya rusak, sehingga pesan menyebutkan entitas yang perlu diperbaiki meskipun laporan diposisikan pada instans komponen yang menggunakan tipe tersebut: instans adalah tempat Anda melihatnya, dan entitas katalog adalah tempat perbaikannya.

Penghentian ini dimunculkan segera setelah komposisi dirakit, yaitu lebih awal daripada setiap pemeriksaan yang membaca graf yang sudah selesai. Karena itu, build yang membawa mandat rusak melaporkannya sendiri: pemeriksaan yang akan berjalan kemudian tidak tercapai, karena pemeriksaan tersebut bernalar tentang isi deklarasi, sedangkan deklarasi tidak dapat dibaca. Perbaiki deklarasi tersebut dan lakukan build ulang untuk melihat sisanya.

Cara memperbaiki: perbaiki entitas katalog Component. Perbaikannya ada di katalog, bukan di Aggregate — itulah sebabnya penghentian ini berbeda dari “Required feature not attached (Fitur wajib tidak terpasang)”, yang mengharuskan dokumen Anda sendiri diubah.

Slot lampiran wajib tidak terikat

Sebuah entitas katalog mendeklarasikan slot lampiran dengan required: true dalam featuresSchema-nya, dan tidak ada yang mengikat nama slot tersebut pada sebuah instans entitas itu. Pemeriksaan dijalankan terhadap lampiran yang dimiliki instans setelah semua cakupan digabungkan — blok features: tingkat komponen dan tingkat subsistem milik Aggregate, blok tingkat batas dan tingkat komponen milik Release, serta lampiran yang dihasilkan oleh ekspansi berbasis anotasi — sehingga kredensial yang dilampirkan sekali pada cakupan yang diwarisi instans mengikat slot tersebut persis seperti pengisian yang ditulis pada instans itu sendiri.

Pesan yang diemisikan:

required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (slot lampiran wajib tidak terisi, dideklarasikan wajib oleh tipe komponen. Lampirkan sebuah Feature pada nama tersebut, di Aggregate atau di Release, pada komponen atau pada cakupan di atasnya.)

Kedua nilai tersebut adalah nama slot itu sendiri dan tipe komponen yang mendeklarasikannya, sehingga satu instans yang membiarkan dua slot tidak terikat melaporkan dua pesan yang berbeda. Laporan ditempatkan pada kunci slot di bawah blok features: milik komponen dalam Aggregate; karena kunci itulah yang justru tidak ada, editor menempatkannya pada kunci terdekat yang memang ada — blok features: jika komponen menuliskannya, dan komponen itu sendiri jika tidak. Tidak ada yang menulis attachment yang hilang tersebut, sehingga tidak ada penulis dokumen yang ditunjuk olehnya: laporan tetap berada pada komponen dan dicatat sebagai kesalahan pengembang, dan perbaikannya menyebut kedua dokumen, karena salah satu dari keduanya dapat mengisi slot tersebut — Aggregate pada komponen atau pada subsistem yang memuatnya, Release pada entrinya untuk komponen tersebut atau pada boundary yang memuatnya.

Slot yang dideklarasikan sebuah soket — dalam featuresSchema milik entri usesSchema — diwajibkan bagi setiap koneksi yang dihubungkan melalui soket tersebut, bukan bagi komponen: setiap koneksi mengisinya sendiri, pada entrinya sendiri di Aggregate atau di Release, dan tidak ada cakupan di atasnya yang menjangkaunya. Jadi soket dengan dua koneksi, yang salah satunya mengisi slot, hanya melaporkan koneksi lainnya, dengan menyebutnya:

required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (slot lampiran wajib tidak terisi, dideklarasikan wajib oleh soket, dari tipe komponen, dibiarkan tidak terisi oleh koneksi. Lampirkan sebuah Feature di bawah slot tersebut dalam fitur koneksi ini, pada entrinya di Aggregate atau di Release.)

Laporan tersebut diposisikan pada entri koneksi dalam dokumen yang membuat koneksi tersebut — entri uses: milik Aggregate, atau entri per-edge milik Release untuk koneksi yang dihubungkan oleh Release. Koneksi yang dibuat oleh Feature yang dilampirkan dihubungkan ke soket yang dideklarasikan Feature tersebut, bukan soket milik komponen, sehingga slot soket komponen bukan miliknya untuk diisi.

Cara memperbaiki: lampirkan sebuah Feature di bawah nama slot, di Aggregate atau di Release — pada komponen, atau pada cakupan lebih luas yang dimiliki bersama oleh setiap konsumen slot; untuk slot soket, pada koneksi yang disebut laporan. Lampiran dengan nama lain tidak mengikat slot: slot adalah titik pengikatan bernama, sehingga namanya adalah pengikatannya. Jika slot tidak lagi perlu diwajibkan, perbarui featuresSchema entitas katalog — milik komponen itu sendiri, atau milik soket — untuk menghapus deklarasi required.

Dua Features yang dideklarasikan berkonflik mencapai satu komponen

interoperability.conflictsWith sebuah Feature menyebut Features yang tidak dapat dilampirkan bersamanya, dan satu komponen akhirnya memuat Feature tersebut dan salah satu yang disebutnya. Pemeriksaan dijalankan terhadap lampiran yang dimiliki komponen setelah semua cakupan digabungkan — blok features: tingkat komponen dan tingkat subsistem milik Aggregate, blok tingkat batas milik Release (setiap batas tempat komponen berada, termasuk yang bersarang) dan entri tingkat komponen, serta lampiran yang dihasilkan oleh ekspansi berbasis anotasi. Jadi sepasang Features berhenti ketika keduanya ditulis pada komponen, ketika salah satunya berada pada batas atau subsistem yang memuatnya, atau ketika salah satunya berada pada batas luar dan yang lain pada batas yang bersarang di dalamnya. Dua Features yang dilampirkan pada batas bersaudara yang tidak berbagi komponen tidak pernah bertemu, dan batas yang tidak memuat komponen tidak menjangkau apa pun, sehingga keduanya tidak berhenti.

Satu deklarasi sudah cukup: penghentian terjadi ketika daftar salah satu Feature menyebut yang lain. Nama dibandingkan dengan versi apa pun dihapus, di kedua sisi, sehingga sebuah entri cocok dengan setiap versi Feature yang disebutnya. Kompiler membandingkan nama yang dideklarasikan penulis Feature dengan Features yang dimuat komponen dan tidak menafsirkan apa pun lebih jauh dari keduanya.

Pesan yang diemisikan:

a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (sebuah Feature mencapai komponen bersama Feature yang dideklarasikannya berkonflik, dilampirkan di Release pada batas, berkonflik dengan, dilampirkan di Aggregate pada komponen, pada komponen. Lampirkan hanya salah satu dari keduanya di tempat mereka bertemu: hapus satu lampiran, atau pindahkan ke cakupan yang tidak memuat komponen ini.)

Nilai pertama adalah Feature yang daftarnya menyebut yang lain — yang disebut oleh kalimat di atas — dan setiap tempat ia dilampirkan mengikutinya; kemudian Feature yang berkonflik dengannya, dan setiap tempat Feature itu dilampirkan; dan terakhir komponen tempat keduanya bertemu. Setiap tempat dituliskan dengan kata-kata dokumen yang akan Anda buka untuk mengubahnya: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (path batas bersarang menggabungkan tingkatannya dengan /), attached in the Release on the entry for component diikuti in boundary, atau attached by annotation-driven expansion of anotasi tersebut, diikuti declared at tempat anotasi itu ditulis. Lampiran yang ditulis pada sebuah koneksi dituliskan sebagai entri koneksi tersebut, karena entri itulah, bukan blok milik komponen, tempat lampiran disunting: attached in the Aggregate on the connection diikuti through socket dan of component, atau attached in the Release on the connection diikuti through socket, of the entry for component dan in boundary. Feature yang dilampirkan di dua tempat mencantumkan keduanya. Laporan diposisikan pada kunci komponen itu sendiri di bawah components:, dan pasangan yang bertemu pada beberapa komponen dilaporkan sekali untuk masing-masing komponen, dalam urutan Aggregate mendeklarasikan komponen-komponen tersebut.

Cara memperbaiki: lampirkan hanya salah satu dari keduanya di tempat mereka bertemu — hapus salah satu lampiran, atau pindahkan salah satunya ke cakupan yang tidak memuat komponen ini, seperti batas bersaudara. Jika lampiran berasal dari ekspansi berbasis anotasi, anotasinyalah yang perlu diubah, bukan blok tempat ia diekspansikan. Jika kedua Features sebenarnya boleh digabungkan, deklarasinyalah yang salah: hapus Feature lainnya dari daftar conflictsWith pada entitas katalog Feature yang mendeklarasikannya.

Attachment does not conform to its declared slot shape (Attachment tidak sesuai dengan bentuk slot yang dideklarasikannya)

Sebuah attachment mengikat slot yang dideklarasikan, tetapi tidak cocok dengan bentuk yang dideklarasikan slot tersebut. Kasus yang umum adalah pengiriman: allowlist inject sebuah slot menyebutkan mekanisme yang dapat digunakan sebuah pengisi untuk mengirimkan materialnya, dan allowlist yang kosong bersifat blackbox — Recipe mengirimkan material secara internal dan sebuah pengisi sama sekali tidak dapat menentukan pengiriman. Blok inject: {} yang kosong tidak menentukan pengiriman apa pun, sehingga sesuai dengan bentuk setiap slot, termasuk slot dengan allowlist kosong, dan mendapat putusan yang sama di mana pun attachment ditulis: pada komponen yang dideklarasikan Aggregate, pada komponen yang dikontribusikan modul yang diimpor, atau pada cakupan yang lebih luas. Attachment dengan nama yang tidak dideklarasikan oleh slot mana pun merupakan attachment bebas dan tidak membawa batasan slot.

Pesan yang dikeluarkan, ketika lampiran menetapkan pengiriman yang tidak diterima slot-nya — slot terlebih dahulu, lalu mekanismenya, lalu setiap mekanisme yang diterima allowlist inject slot tersebut, dalam urutan yang dideklarasikan slot (tidak ada yang menyusul untuk allowlist kosong):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (lampiran tidak sesuai dengan bentuk slot yang dideklarasikannya)

Komponen yang dikontribusikan oleh modul yang diimpor diperiksa setelah komposisi yang mengimpornya dibangun, dan dilaporkan dalam bentuk kedua. Bentuk ini menyebutkan Aggregate milik modul dan kunci di dalam dokumen modul yang tidak dideklarasikan slot — mekanisme di bawah blok inject: milik lampiran, atau blok inject: itu sendiri bila blok itu menyebut mekanisme apa pun pada slot yang allowlist-nya kosong:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (attachment tidak sesuai dengan bentuk slot yang dideklarasikannya: kunci ini bukan bagian dari deklarasi slot)

dengan <remedy> bergantung pada kuncinya:

  • remove it, untuk blok inject: yang menyebut suatu mekanisme pada slot yang allowlist-nya kosong;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, untuk mekanisme yang dapat disebutkan allowlist slot — env, file, atau arg;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, untuk mekanisme lain apa pun, yang tidak dapat dideklarasikan oleh slot mana pun.

Attachment yang dideklarasikan pada cakupan yang lebih luas — di seluruh subsistem, menurun ke setiap komponen di bawahnya — dikenai bentuk yang sama, dan diperiksa terhadap slot pada setiap komponen yang dijangkaunya. Oleh karena itu, attachment yang sama dapat sesuai bentuk untuk satu komponen dan tidak sesuai untuk komponen lain, sehingga bentuk pesan ini menyebutkan komponen dan slot yang gagal dipenuhinya, serta menunjukkan lokasi attachment pada cakupan tempat attachment tersebut dideklarasikan, bukan pada kunci di dalam blok pengirimannya:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (attachment tidak sesuai dengan bentuk slot yang dideklarasikannya: attachment ini dideklarasikan pada cakupan yang menjangkau sebuah komponen yang slot attachment-nya tidak menerima pengiriman yang dibawanya — pindahkan attachment ke bawah, ke komponen yang dapat menerimanya)

Attachment yang dibawa oleh sebuah koneksi tidak pernah mencapai penghentian ini. Bentuknya tertutup di tempat attachment tersebut ditulis: pada entri koneksi Aggregate, attachment menerima type, description, dan values, dan pada entri koneksi Release menerima type, description, dan infra, sehingga attachment sama sekali tidak dapat menentukan pengiriman — inject: yang ditulis di sana ditolak saat dokumen dimuat, dengan menyebutkan kuncinya — dan entri Workload yang mengirimkannya dikenai allowlist inject milik slot soket sebagai gantinya. Tidak ada cakupan yang menjangkau slot sebuah soket, sehingga bentuk pesan untuk seluruh cakupan di atas tidak memiliki padanan pada koneksi.

Cara memperbaiki: bentuk-bentuk pesan ini memerlukan dua perubahan yang berbeda, dan field path memberi tahu Anda mana yang Anda hadapi. Jika field path menyebutkan attachment pada sebuah komponen, atau kunci di dalamnya, pengirimannyalah kesalahannya: hapus pengiriman tersebut, atau pindahkan entri-entrinya ke bawah mekanisme yang disebutkan allowlist inject slot. Jika material tersebut memang dimaksudkan untuk mencapai workload melalui mekanisme yang tidak dicantumkan slot, allowlist di featuresSchema entitas katalog dapat diperluas — tetapi hanya dengan env, file, atau arg, mekanisme yang dapat dideklarasikan slot; Component yang menyebutkan mekanisme lain di sana gagal validasi ketika dimuat, sehingga untuk mekanisme lain apa pun, menghapusnya adalah satu-satunya perbaikan. Jika field path menyebutkan attachment pada sebuah cakupan, attachment tersebut terbentuk dengan benar dan penempatannyalah kesalahannya: pindahkan attachment ke bawah, ke komponen yang slot-nya menerima pengiriman tersebut, dan biarkan di luar jangkauannya komponen yang mencadangkan pengiriman untuk Recipe mereka.

Duplicate delivery key across inject sources (Kunci pengiriman duplikat di antara sumber inject)

Kunci pengiriman yang sama (misalnya, nama variabel env yang sama) diklaim dua kali di antara sumber inject yang ditulis pengembang untuk satu komponen — pada tingkat Component dan di bawah entri uses[], oleh dua entri uses[] pada komponen yang sama, atau di bawah dua mekanisme pengiriman dari blok inject: milik Component itu sendiri. Pengiriman tidak dapat berasal dari dua tempat sekaligus, sehingga kunci yang diklaim dua kali merupakan kontradiksi, bukan soal mana yang menang.

Build memeriksa hal ini di empat tempat, karena masing-masing melihat kumpulan sumber yang ditulis dan koneksi dependensi yang berbeda serta mengajukan pertanyaan yang berbeda terhadapnya, dan masing-masing melaporkan dalam bentuknya sendiri.

Yang pertama membaca koneksi yang Anda tulis di Aggregate, dan melaporkan saat berkas Anda di-resolve. Pesan ini menyebutkan mekanisme pengiriman, kunci, lalu socket dan alias dari koneksi pertama menurut urutan penulisan yang juga mengklaimnya:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (kunci pengiriman duplikat di antara sumber inject)

Yang kedua membaca blok tertulis yang sama dan mengajukan pertanyaan yang berbeda: apakah komponen mengklaim satu kunci di bawah dua mekanisme pengirimannya sendiri, tanpa melibatkan koneksi sama sekali. Laporan dibuat sekali per mekanisme yang mengklaim kunci tersebut, diposisikan pada entri mekanisme itu sendiri, dan menyebutkan mekanisme yang dilaporkan, kunci, lalu setiap mekanisme lain yang mengklaimnya, menurut urutan penulisan:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (kunci pengiriman duplikat di antara sumber inject)

Tidak ada mekanisme yang menjadi pelanggar dan kedua laporan menjadi tanggung jawab Anda untuk diubah: ganti nama kunci di bawah salah satunya, atau hapus salah satu dari dua pengiriman tersebut. Mekanisme mana yang boleh digunakan oleh sebuah komponen merupakan pertanyaan terpisah, yang dijawab oleh allowlist spec.inject-nya — lihat “Self-inject mechanism not in the component’s allowlist (Mekanisme self-inject tidak ada dalam allowlist komponen)” di bawah.

Komponen yang dikontribusikan oleh modul juga menemui dua bentuk pertama ini, yang dibaca dari dokumen milik modul itu sendiri setelah komposisi yang mengimpornya dibangun; keduanya kemudian menyebut Aggregate milik modul dan kunci di dalam dokumennya.

Yang ketiga membaca koneksi yang dimuat oleh topologi yang telah selesai, termasuk koneksi yang disumbangkan oleh lampiran Feature atas nama Anda. Pemeriksaan ini berjalan sebelum apa pun di-render, dan menyebutkan kunci pengiriman yang Anda tulis beserta socket dependensi yang juga mengirimkannya:

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (kunci pengiriman duplikat di antara self-inject dan uses-inject)

Satu kunci tertulis yang dikirim melalui dua socket dependensi dilaporkan sekali per socket, sehingga satu build memberi tahu Anda tentang semuanya, bukan hanya yang tercapai lebih dulu.

Yang keempat membaca topologi selesai yang sama dan mengajukan pertanyaan yang berbeda: apakah dua koneksi dependensi milik sebuah komponen mengirimkan satu kunci di antara keduanya, sementara komponen itu sendiri tidak mengklaim apa pun. Laporan dibuat sekali pada setiap koneksi, diposisikan pada entri pengiriman koneksi itu sendiri, dan menyebutkan path entri diikuti oleh setiap socket yang mengirimkan kunci tersebut:

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (kunci pengiriman duplikat di antara sumber inject)

Socket yang disebutkan dua kali menandakan bahwa kedua koneksi berada pada satu socket dengan alias yang berbeda — dalam hal itu posisilah satu-satunya yang membedakan keduanya, jadi bacalah field path dari masing-masing kedua laporan, bukan nama socket-nya.

Tidak ada koneksi yang menjadi pelanggar dan keduanya menjadi tanggung jawab Anda untuk diubah: ganti nama salah satu kunci, atau hapus salah satu dari dua pengiriman tersebut.

Jika kunci berupa path, field path menyebutkan blok mekanisme sebagai gantinya. Isi sebuah kunci pengiriman adalah urusan mekanisme itu sendiri, dan mekanisme file mengirim ke sebuah mount path — sehingga kunci semacam itu mengandung titik, sementara field path memisahkan langkah-langkahnya sendiri dengan titik. Field path berhenti pada langkah terakhir yang dapat disebutkannya tanpa ambiguitas, alih-alih menuliskan langkah yang akan terbaca sebagai penelusuran kunci yang tidak ada dalam dokumen Anda, sehingga untuk kunci seperti /etc/app/config.yaml field path terbaca .spec.components.<component>.inject.<mechanism> dan berhenti di sana. Pesan tetap menyebutkan kuncinya dalam kedua kasus, dan itulah yang membuat laporan tetap dapat ditindaklanjuti — tetapi letak kunci dalam pesan berbeda di antara keempat bentuk di atas, jadi bacalah field path untuk bloknya, lalu ambil kunci dari bentuk mana pun yang Anda miliki: jika detail diawali dengan mekanisme pengiriman, kuncinya adalah nilai berkutip tepat setelahnya; jika detail diawali dengan kunci itu sendiri, kuncinya adalah nilai berkutip pertama; dan jika detail diawali dengan path entri pengiriman itu sendiri, kuncinya adalah langkah terakhir path tersebut.

Cara memperbaiki: ganti nama salah satu kunci yang bertentangan, atau hapus deklarasi duplikatnya. Perhatikan bahwa injectMapping milik FeatureRecipe yang menulis ulang kunci yang dikirim oleh blok inject: milik komponen itu sendiri atau oleh salah satu blok inject: koneksinya merupakan intersepsi yang disengaja dan tidak ditandai di sini maupun di tempat lain.

Kunci yang diklaim oleh Feature yang dilampirkan pada komponen bertemu dengan ruang bersama yang sama dari permukaan penulisan ketiga dari tiga permukaannya, dan dilaporkan di bawah “An attachment delivers a key another inject source already claimed (Sebuah lampiran mengirimkan kunci yang sudah diklaim sumber inject lain)” di bawah; kunci yang dikirim oleh dua Features yang dilampirkan, dengan yang belakangan mengirimkannya melalui injectMapping milik FeatureRecipe-nya, dilaporkan di bawah “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features yang dilampirkan mengirimkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)”.

Self-inject on a component without an allowlist (Self-inject pada komponen tanpa allowlist)

Pengembang menulis blok inject: tingkat komponen, tetapi entitas katalog Component tidak mendeklarasikan spec.inject. Components tanpa allowlist spec.inject adalah tipe Black-Box — tipe ini tidak menerima injeksi yang ditulis pengembang.

Pesan yang diemisikan:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject pada komponen tanpa allowlist spec.inject)

Laporan diposisikan pada blok inject: itu sendiri, yang merupakan elemen yang harus dihapus.

Cara memperbaiki: hapus blok inject: dari instans Component ini, atau beralihlah ke tipe Component White-Box yang deklarasi katalognya menyertakan spec.inject.

Self-inject mechanism not in the component’s allowlist (Mekanisme self-inject tidak ada dalam allowlist komponen)

Pengembang menulis blok inject: tingkat komponen menggunakan mekanisme (misalnya, env atau bentuk file-mount tertentu) yang tidak tercantum dalam allowlist spec.inject milik Component.

Pesan yang diemisikan:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (self-inject pada komponen tanpa allowlist spec.inject)

Mekanisme yang diizinkan oleh tipe tersebut mengikuti mekanisme yang didiktekan, sehingga pesan memuat apa yang ditulis sekaligus apa yang diizinkan tipe tersebut. Tipe yang sama sekali tidak mendeklarasikan allowlist melaporkan mekanisme yang didiktekan tanpa apa pun setelahnya.

Aturan ini dan aturan di atas sama-sama berlaku untuk komponen yang dikontribusikan oleh modul, setelah komposisi yang mengimpor modul tersebut dibangun; laporan kemudian menyebut Aggregate milik modul dan kunci di dalam dokumennya.

Cara memperbaiki: beralihlah ke mekanisme yang ada dalam allowlist, atau, jika Component seharusnya mendukung mekanisme yang Anda butuhkan, perluas allowlist spec.inject di katalognya.

uses edge dictates delivery on a socket that allowlists none (Edge menentukan pengiriman pada soket yang tidak mengizinkan mekanisme apa pun)

Blok inject: pada edge uses: terhubung ke socket yang entri usesSchema-nya tidak mendeklarasikan allowlist inject:, atau mendeklarasikan allowlist kosong. Socket semacam itu adalah koneksi Black-Box: entitas yang mendeklarasikannya menangani nilai dependensi secara internal, sehingga konsumen menerima apa pun yang dihasilkan oleh Recipe produsen dan tidak memilih bentuk pengiriman. Kunci inject: yang tidak ada dan inject: [] adalah deklarasi yang sama.

Socket dibaca pada entitas mana pun yang mendeklarasikannya: edge yang ditulis pada lampiran Feature di-resolve terhadap usesSchema milik Feature yang dilampirkan, dan setiap edge lainnya terhadap milik Component yang mengonsumsi.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu mekanisme yang ditentukan oleh edge, socket, dan entitas yang deklarasinya dibaca — kemudian apa yang harus dilakukan:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (Inject pada edge uses menentukan mekanisme pengiriman yang tidak diizinkan socket. Socket tidak mendeklarasikan allowlist pengiriman, sehingga tidak mengizinkan penentuan apa pun — entitas yang mendeklarasikannya mengirimkan sendiri nilai dependensi. Hapus blok inject dari koneksi ini dan baca nilai dari provides koneksi di Recipe yang mengonsumsi, atau deklarasikan mekanisme yang diizinkan socket di entri usesSchema-nya.)

Temuan ini diposisikan pada entri tertulis yang dibahasnya, di dokumen tempat entri itu ditulis: .spec.components.<consumer>.uses.<socket>.<alias> untuk edge yang dibuat oleh blok uses: milik komponen itu sendiri, dan .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> untuk edge yang dibuat oleh lampiran — berakar pada blok yang mendeklarasikan lampiran tersebut, yang dapat berupa blok subsistem atau boundary, bukan milik komponen itu sendiri. Jika socket dideklarasikan pada Feature yang dilampirkan, pesan menyebut tipe feature sebagai pengganti tipe komponen. Setiap edge yang bermasalah dilaporkan sebagai temuan tersendiri, sehingga satu build menyebut semuanya.

Cara memperbaiki: hapus blok inject: dari edge dan baca nilai dependensi dari .context.uses.<alias>.provides.<name> di Recipe yang mengonsumsi; atau, jika koneksi dimaksudkan transparan, deklarasikan mekanisme pengiriman yang diizinkan socket di allowlist inject: pada entri usesSchema-nya.

Socket yang sama sekali tidak pernah dideklarasikan oleh entitas yang mendeklarasikan merupakan kasus berbeda dan tidak ditolak di sini: socket ad-hoc tidak membawa allowlist, sehingga tidak ada batas yang dapat dilanggar oleh edge.

uses edge dictates a delivery mechanism outside the socket’s allowlist (Edge menentukan mekanisme pengiriman di luar allowlist soket)

Blok inject: pada edge uses: menyebut mekanisme pengiriman yang tidak tercantum dalam allowlist inject: socket. Allowlist adalah pernyataan entitas yang mendeklarasikan tentang bentuk pengiriman mana yang benar-benar dapat dibaca entrypoint-nya untuk nilai dependensi, sehingga mekanisme di luarnya akan mengirimkan nilai yang tidak dikonsumsi apa pun.

Setiap mekanisme yang disebut blok diperiksa, dan setiap mekanisme di luar allowlist dilaporkan, sehingga satu build menyebut semuanya, bukan satu per eksekusi.

Pesan yang dikeluarkan. Penolakan muncul lebih dulu, lalu mekanisme yang ditolak, socket, apa yang diizinkan socket tersebut, dan entitas yang deklarasinya dibaca:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (Inject pada edge uses menentukan mekanisme pengiriman yang tidak diizinkan socket. Tentukan salah satu mekanisme yang diizinkan socket, atau perluas allowlist inject socket tersebut di entri usesSchema entitas yang mendeklarasikannya.)

Temuan ini diposisikan pada entri tertulis yang dibahasnya, pada path yang sama dengan yang disebut penolakan di atas. Jika socket dideklarasikan pada Feature yang dilampirkan, pesan menyebut tipe feature sebagai pengganti tipe komponen.

Cara memperbaiki: beralihlah ke salah satu mekanisme dalam allowlist, atau, jika entitas seharusnya mendukung mekanisme yang Anda perlukan, perluas allowlist inject: socket tersebut di entri usesSchema katalognya.

An inject: entry carries both a literal and a source key (Entri memuat sekaligus literal dan kunci sumber)

Entri inject: mengirimkan salah satu dari dua hal: literal, ditulis di bawah value: — pada blok milik komponen itu sendiri, satu-satunya tempat literal dikirimkan — atau kunci yang dibaca dari komponen yang dituju koneksi, ditulis di bawah from:. Entri yang membawa keduanya menyatakan dua hal sekaligus dan tidak menyediakan aturan untuk memilih di antaranya, sehingga entri tersebut ditolak alih-alih membiarkan salah satunya menang secara diam-diam.

Skema penulisan hanya menerima tepat satu dari pasangan tersebut, sehingga dokumen yang dibaca dari berkas ditolak saat dimuat. Pemeriksaan ini berdiri di belakang pemeriksaan tersebut: pemeriksaan ini membaca setiap blok inject: yang dibawa Aggregate dan Release selama kedua dokumen tersebut diresolusi, sehingga dokumen yang dibangun melalui jalur selain berkas tetap ditolak sebelum apa pun dibangun darinya, alih-alih salah satu field dipilih secara diam-diam. Pemeriksaan ini mencakup blok yang sama dengan pemeriksaan bentuk di bawah.

Setiap mekanisme pengiriman yang memuat entri bermasalah dilaporkan sebagai temuan tersendiri, diposisikan pada mekanisme tersebut di dokumen yang menuliskannya — .spec.components.<component>.inject.env untuk blok milik komponen itu sendiri — dan semua temuan dalam build dilaporkan sekaligus. Temuan menyebutkan mekanisme lalu in: dari setiap entri bermasalah dalam daftar mekanisme tersebut.

Pesan yang diemisikan:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (entri inject membawa literal sekaligus kunci sumber; skema mengharuskan tepat satu)

Cara memperbaiki: buka setiap entri yang disebut pesan dan hapus salah satu dari keduanya yang tidak diperlukannya. Pertahankan from: jika nilai harus berasal dari komponen yang dituju koneksi — field ini menyebut kunci yang dideklarasikan oleh provides: komponen tersebut. Pertahankan value: jika nilai berupa literal yang disediakan oleh sisi ini, pada blok milik komponen itu sendiri; pada koneksi dan pada blok milik Feature yang dilampirkan itu sendiri, literal ditolak, jadi di sana pertahankan from:.

An inject: entry on a connection carries a literal (Entri injeksi pada koneksi membawa literal)

Koneksi mengirimkan ke komponen konsumen apa yang diterbitkan oleh komponen yang ditujunya: setiap entri dalam blok inject: koneksi menyebut salah satu kunci provides: komponen tersebut di bawah from:. Literal yang ditulis di bawah value: tidak menyebut apa pun yang diterbitkan target, sehingga tidak memiliki tempat pada koneksi, dan entri tersebut ditolak alih-alih dibuang. Literal yang dikirimkan komponen kepada dirinya sendiri termasuk dalam blok inject: milik komponen itu sendiri, tempat value: diterima.

Setiap koneksi diperiksa, dokumen mana pun yang menggambarnya: koneksi pada blok uses: milik komponen itu sendiri, koneksi yang digambar oleh Feature terlampir di Aggregate, dan koneksi yang digambar oleh lampiran yang ditulis di Release. Koneksi tersebut ditolak sebelum apa pun dirender, sehingga aggrega validate --release melaporkannya sebagaimana aggrega build.

Setiap entri bermasalah dilaporkan sebagai temuan tersendiri, diposisikan pada entri koneksi di dokumen yang menggambarnya — .spec.components.<component>.uses.<socket>.<alias> untuk koneksi milik komponen itu sendiri, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> untuk koneksi yang digambar lampiran, dan, di Release, jalur yang sama di bawah entri lampiran, seperti .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias> — dan semua temuan dalam build dilaporkan sekaligus. Temuan di Aggregate dicatat di bawah DEVELOPER_ERROR, temuan di Release di bawah OPS_ERROR. Temuan menyebutkan mekanisme dan in: dari entri tersebut.

Pesan yang diemisikan:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (entri inject pada koneksi membawa literal; koneksi mengirimkan kunci yang diterbitkan target, masing-masing disebut dengan kunci sumber)

Cara memperbaiki: jika nilai tersebut diterbitkan target, ganti value: dengan from: yang menyebut kunci provides: tersebut. Jika nilai tersebut adalah literal yang dibutuhkan komponen konsumen, pindahkan entri ke blok inject: milik komponen itu sendiri, yang mekanismenya diatur oleh allowlist spec.inject tipe Component-nya.

An inject: entry on an attached Feature carries a literal (Entri injeksi pada Feature yang dilampirkan membawa literal)

Blok inject: yang ditulis pada Feature yang dilampirkan mengirimkan ke komponen apa yang diterbitkan oleh FeatureRecipe lampiran tersebut: setiap entri menyebut salah satu kunci yang diterbitkan oleh provides: milik FeatureRecipe, di bawah from:. Literal yang ditulis di bawah value: tidak menyebut apa pun yang diterbitkan lampiran, sehingga tidak ada yang akan mencapai komponen di bawah in: entri tersebut; entri itu ditolak alih-alih dibangun lalu dibuang. Literal yang dibutuhkan komponen termasuk dalam blok inject: milik komponen itu sendiri, tempat value: diterima dan dikirimkan.

Setiap lampiran yang padanya sebuah Aggregate menulis blok inject: diperiksa: lampiran dalam blok features: milik komponen itu sendiri dan lampiran dalam blok features: milik subsistem, yang menjangkau setiap komponen yang dimuat subsistem tersebut — dalam Aggregate yang disebut oleh Release dan dalam setiap modul yang diimpor Aggregate tersebut di bawah aggregates:, pada kedalaman berapa pun. Koneksi yang digambar oleh sebuah lampiran membawa blok inject: miliknya sendiri, dan literal di sana termasuk penolakan koneksi di atas. Lampiran Release tidak menulis blok inject: miliknya sendiri. Entri tersebut ditolak sebelum apa pun dirender, sehingga aggrega validate --release melaporkannya sebagaimana aggrega build.

Setiap entri yang bermasalah dilaporkan sebagai temuan tersendiri, dicatat sebagai DEVELOPER_ERROR terhadap Aggregate yang dokumennya menulis blok tersebut — dokumen milik modul itu sendiri untuk lampiran yang ditulis dalam sebuah modul — dan diposisikan pada mekanisme pengiriman di dalam blok lampiran dalam dokumen tersebut: .spec.components.<component>.features.<attachment>.inject.<mechanism>, atau .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> untuk lampiran subsistem. Semua entri dalam satu dokumen dilaporkan sekaligus; entri dalam modul yang diimpor dilaporkan setelah Aggregate yang mengimpornya lolos pemeriksaan. Temuan ini menyebut mekanisme dan in: entri. Entri yang membawa value: sekaligus from: dilaporkan sekali saja, di bawah “An inject: entry carries both a literal and a source key (Entri injeksi membawa literal sekaligus kunci sumber)” di atas.

Pesan yang diemisikan:

inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>") (entri inject pada lampiran membawa literal; lampiran mengirimkan kunci yang diterbitkan FeatureRecipe miliknya, masing-masing disebut sebagai kunci sumber, dan literal termasuk dalam blok inject milik komponen itu sendiri)

Cara memperbaiki: jika nilainya adalah nilai yang diterbitkan FeatureRecipe milik lampiran, ganti value: dengan from: yang menyebut kunci provides: tersebut. Jika nilainya berupa literal yang dibutuhkan komponen, pindahkan entri ke blok inject: milik komponen itu sendiri, yang mekanismenya diatur oleh allowlist spec.inject dari tipe Component miliknya:

components:
api:
type: core/api
inject:
env:
- in: LITERAL_NAME
value: a-literal # the literal, delivered by the component's own block
features:
token:
type: core/token
inject:
env:
- in: TOKEN_NAME
from: name # a key the attachment's FeatureRecipe publishes

An inject: delivery is not a list of entries (Pengiriman injeksi bukan daftar entri)

Setiap mekanisme pengiriman dalam blok inject: — env, file, arg, atau mekanisme yang dinamai di sampingnya — adalah daftar entri, masing-masing membawa in: dan tepat satu dari from: atau value:. Mekanisme yang memuat hal lain, seperti pemetaan nama ke kunci, tidak mengirimkan apa pun yang dapat dibaca compiler, sehingga ditolak alih-alih dibuang. Mekanisme yang ditulis tanpa nilai sama sekali tidak mengirimkan apa pun dan tidak ditolak.

Skema penulisan hanya menerima daftar, sehingga dokumen yang dibaca dari berkas ditolak saat dimuat, sebagai dokumen yang tidak cocok dengan skema jenisnya. Pemeriksaan ini berdiri di belakang pemeriksaan tersebut: pemeriksaan ini membaca setiap blok inject: yang dibawa Aggregate dan Release selama kedua dokumen tersebut diresolusi, sehingga dokumen yang dibangun melalui jalur selain berkas tetap ditolak sebelum apa pun dibangun darinya, alih-alih pengirimannya lenyap. Pemeriksaan ini mencakup setiap blok yang dibawa kedua dokumen: di Aggregate, blok milik komponen itu sendiri, blok lampiran, dan blok pada koneksi yang digambar salah satunya; di Release, blok pada koneksi yang digambar lampirannya.

Setiap mekanisme bermasalah dilaporkan sebagai temuan tersendiri, diposisikan pada mekanisme tersebut di dokumen yang menuliskannya dan menyebutkan mekanisme tersebut, dan semua temuan dalam build dilaporkan sekaligus. Temuan Aggregate dilaporkan sebelum temuan Release.

Pesan yang diemisikan:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (pengiriman inject: bentuknya harus berupa daftar entri, masing-masing dengan lokasi tujuan dan tepat satu dari kunci sumber atau literal)

Posisinya adalah jalur kunci yang ditulis penulis. Di Aggregate, .spec.components.<component>.inject.<mechanism> untuk blok milik komponen itu sendiri, .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> untuk blok pada salah satu koneksinya, dan .spec.components.<component>.features.<attachment>… untuk blok lampiran, dengan .subsystems.<name> untuk setiap subsistem tempat komponen atau lampiran dideklarasikan. Di Release, blok pada koneksi yang digambar lampiran, melalui lampiran tersebut — .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> untuk lampiran yang dipasang di seluruh boundary, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… untuk lampiran pada komponen, dengan .boundaries.<name> untuk setiap boundary bersarang dan .aggregates.<module> untuk setiap entri perutean yang menjadi jalur penyebutan komponen.

Cara memperbaiki: tulis setiap mekanisme yang disebut pesan sebagai daftar. Entri DB_URL: host di bawah env: menjadi - in: DB_URL dengan from: host jika host menyebut kunci provides: — milik komponen yang terhubung pada koneksi, milik komponen itu sendiri pada bloknya sendiri — atau, pada blok milik komponen itu sendiri, dengan value: host jika itu literal yang disediakan oleh sisi ini.

The Feature filling an attachment slot does not satisfy the slot’s selector (Feature yang mengisi slot lampiran tidak memenuhi selector slot tersebut)

Sebuah Component mendeklarasikan titik pengikatan bernama untuk Features yang diharapkannya, dan sebuah slot dapat mendeklarasikan selector: yang membatasi label dari apa pun yang mengisinya. Sebuah lampiran mengikat slot dengan membawa nama slot tersebut; ketika itu terjadi, label Feature yang dinamainya dicocokkan dengan batasan itu, dan pengisian yang tidak memenuhinya menghentikan build. Slot yang tidak mendeklarasikan batasan menerima pengisian apa pun.

Apakah sebuah slot boleh dibiarkan tidak terikat sama sekali adalah pertanyaan lain dengan solusi yang lain pula, dan dilaporkan oleh penghentiannya sendiri di atas: penghentian ini mengandaikan adanya pengisian dan menanyakan apakah pengisian itu dapat diterima, sehingga slot yang tidak terikat bukan urusannya.

Dua hasil dilaporkan di bawah kondisi yang satu ini, dan pesan membedakannya melalui isi nilai terakhirnya. Pengisian yang tidak memenuhi batasan menyebutkan Feature yang labelnya tidak cocok. Batasan yang sama sekali tidak dapat dibaca justru menyebutkan alasannya — ekspresi yang tidak dapat dievaluasi oleh pencocok label — yang merupakan kesalahan pada deklarasi slot itu sendiri, bukan pada apa yang dilampirkan padanya.

Pesan yang dikeluarkan, ketika label pengisian tidak memenuhi batasan:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (selector slot lampiran tidak terpenuhi: tidak dipenuhi oleh label Feature yang mengisinya. Tambahkan label yang diwajibkan selector slot ke label Feature, atau isi slot dengan Feature yang sudah membawanya.)

dan ketika batasan itu sendiri tidak dapat dievaluasi:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (selector slot lampiran tidak terpenuhi: selector tidak dapat dievaluasi. Perbaiki selector pada deklarasi slot di entitas katalog komponen.)

Temuan ini diposisikan pada kunci pengisian di dokumen yang menulis pengisian tersebut, dan dicatat atas nama penulis dokumen itu: blok features: komponen di Aggregate adalah kesalahan developer, sedangkan pengisian yang hanya dibuat oleh Release — pada entrinya untuk komponen tersebut, atau pada boundary yang memuatnya — adalah kesalahan operator, yang dilaporkan pada path milik Release itu sendiri:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

Pengisian yang sama yang ditulis pada komponen di Aggregate melaporkan [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity.

Slot yang dideklarasikan oleh sebuah socket — di dalam featuresSchema pada entri usesSchema — mengharuskan pengisian setiap koneksi memenuhi selector:-nya dengan cara yang sama. Lampiran yang dibawa sebuah koneksi di slot tersebut dicocokkan dengan batasan, dan pengisian yang tidak diterimanya menghentikan build, dengan menyebutkan socket dan koneksi beserta slotnya:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (selector slot lampiran tidak terpenuhi: diisi pada koneksi, tidak dipenuhi oleh label Feature yang mengisinya. Tambahkan label yang diwajibkan selector slot ke label Feature, atau isi slot dengan Feature yang sudah membawanya.)

Temuan ini diposisikan pada kunci lampiran di bawah features: milik koneksi tersebut, di dokumen yang menulis pengisian: entri koneksi di Aggregate, atau entri per-edge di Release untuk pengisian yang hanya dibuat oleh Release.

Selector slot yang tidak dapat dibaca tata bahasanya juga ditolak sebelum apa pun mengisi slot tersebut. aggrega validate, atas seluruh katalog atau atas satu Component atau Feature, membaca setiap selector slot yang dideklarasikan dokumen entitas itu sendiri — slot milik Component itu sendiri, slot yang dideklarasikan socket-nya, dan slot milik Feature — dan menolak selector yang tidak dapat dibaca tata bahasanya di bawah kondisi yang sama ini, baik ada maupun tidak ada yang mengisi slot tersebut. Pesannya adalah bentuk “tidak dapat dievaluasi” di atas; slot yang dideklarasikan socket menambahkan socket tersebut:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (selector slot attachment tidak terpenuhi, dideklarasikan pada slot dari sebuah socket, dan tidak dapat dievaluasi. Perbaiki selector pada deklarasi slot di featuresSchema milik socket pada entitas katalog komponen.)

Pada slot milik Feature, perbaikannya justru menyebut entitas katalog Feature tersebut. Belum ada yang mengisi slot, sehingga kesalahannya ada pada entitas katalog: kesalahan ini dicatat sebagai CATALOG_ERROR dan menyebut file entitas tersebut.

Cara memperbaiki: untuk pengisian yang tidak memenuhi batasan, lampirkan Feature yang labelnya memenuhinya — selector dalam pesan menyebutkan label mana yang diminta — atau perluas selector: slot di Component yang mendeklarasikannya. Jika pesan menyatakan bahwa batasan tidak dapat dievaluasi, ekspresi selector-lah yang salah: perbaiki di deklarasi slot pada Component, atau pada socket.

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)

Permukaan lampiran milik sebuah Component bersifat terbuka: lampiran dengan nama yang tidak dideklarasikan oleh slot mana pun adalah lampiran bebas, dan sah. Satu bentuk pada permukaan itu menghentikan build, karena itulah bentuk yang diambil oleh pengisian yang dimaksudkan untuk sebuah slot ketika ditulis dengan nama yang salah. Build berhenti ketika semua hal berikut berlaku untuk satu lampiran:

  • lampiran ditulis pada komponen itu sendiri — pada blok features: milik komponen di Aggregate, atau pada entri Release untuk komponen tersebut;
  • namanya bukan slot yang dideklarasikan oleh tipe komponen;
  • label Feature-nya memenuhi selector: dari slot yang dideklarasikan oleh tipe tersebut;
  • tidak ada yang mengikat slot itu pada komponen setelah semua cakupan digabungkan.

Jika dibiarkan, lampiran seperti itu menjadi lampiran bebas sementara slot yang dimaksudkan untuknya tetap kosong — dan slot opsional yang dibiarkan kosong lolos build tanpa masalah dan tidak mengirimkan apa pun. Aturan ini berlaku untuk setiap Feature, tidak hanya untuk kredensial.

Segala hal lain pada permukaan tersebut tetap bebas. Lampiran yang Feature-nya tidak cocok dengan slot yang dideklarasikan mana pun tetap lolos build; begitu pula lampiran tambahan di samping slot yang sudah diikat oleh sesuatu, selama tidak ada slot lain yang cocok dengannya yang dibiarkan kosong. Lampiran yang diwarisi komponen dari subsystem atau boundary Release tidak pernah dinilai, sehingga bentuk bersama — satu kredensial yang dilampirkan sekali pada cakupan tempat beberapa komponen berada, tanpa ada komponen yang mengisi slot — lolos build. Slot yang tidak mendeklarasikan selector: tidak menyatakan apa pun tentang Feature yang dimaksudkan untuknya, sehingga tidak ada lampiran yang dinilai terhadapnya dengan cara ini. Lampiran yang dibawa sebuah koneksi juga tidak dinilai di sini: slot milik socket adalah himpunan tertutup, dan nama lain apa pun pada koneksi menghentikan build di bawah “A connection carries an attachment under a name its socket declares no slot for (Koneksi membawa lampiran dengan nama yang tidak dideklarasikan sebagai slot oleh socket-nya)”.

Pesan yang dikeluarkan. Kalimat kondisi muncul lebih dulu, lalu nama yang digunakan untuk menulis lampiran, komponen, Feature yang dilampirkannya, dan slot kosong yang cocok dengannya — lalu apa yang harus dilakukan:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (lampiran yang ditulis dengan nama yang tidak dideklarasikan slot mana pun cocok dengan slot yang dibiarkan kosong oleh komponennya: melampirkan Feature yang cocok dengan slot kosong. Lampirkan dengan nama slot tersebut untuk mengisinya.)

Jika Feature cocok dengan lebih dari satu slot kosong, pesan menyebutkan masing-masing, sesuai urutan deklarasinya oleh tipe komponen, dan menyerahkan pilihannya kepada Anda:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (lampiran yang ditulis dengan nama yang tidak dideklarasikan slot mana pun cocok dengan slot yang dibiarkan kosong oleh komponennya: melampirkan Feature yang cocok dengan beberapa slot kosong. Lampirkan dengan nama slot yang dimaksudkan untuk diisinya.)

Temuan ini diposisikan pada kunci lampiran di dokumen yang menulisnya, dan dicatat atas nama penulis dokumen itu. Lampiran pada blok features: milik komponen di Aggregate dilaporkan di .spec.components.<component>.features.<attachment> sebagai kesalahan developer; lampiran yang hanya ditulis oleh Release, pada entrinya untuk komponen tersebut, dilaporkan di sana — di bawah boundary yang menyebutkan komponen itu, .spec.boundaries.<boundary>.components.<component>.features.<attachment> — sebagai kesalahan operator:

[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.

Slot kosong itu sendiri merupakan temuan terpisah jika slot tersebut wajib, dilaporkan pada komponen di Aggregate di bawah “Required attachment slot not bound (Slot lampiran wajib tidak terikat)”.

Perbedaan dengan peringatan near-miss. Peringatan di bawah “An attachment name is one edit from a declared slot (Nama lampiran berjarak satu suntingan dari slot yang dideklarasikan)” berkaitan dengan cara sebuah nama dieja: nama yang berjarak satu suntingan dari slot yang selector:-nya tidak dipenuhi oleh Feature lampiran, yang lolos build dan melaporkan peringatan. Penghentian ini berkaitan dengan slot yang cocok dengan Feature, apa pun namanya: nama boleh apa saja, dan slot yang cocok dengannya harus dibiarkan kosong. Jika sebuah nama berjarak satu suntingan dari slot dan Feature-nya memang cocok dengan slot itu, tidak ada peringatan yang dimunculkan, dan jika slot dibiarkan kosong, penghentian ini adalah satu-satunya temuan yang dilaporkan.

Cara memperbaiki: lampirkan dengan nama slot, sehingga lampiran mengisi slot tersebut — pesan menyebutkan slotnya, atau setiap kandidat jika ada beberapa. Jika lampiran itu memang lampiran terpisah, isi juga slotnya, karena lampiran tambahan bersifat bebas setelah setiap slot yang cocok dengannya terikat; atau, jika lampiran dimaksudkan untuk menjangkau beberapa komponen, lampirkan pada subsystem atau boundary Release tempat komponen-komponen itu berada. Jika Feature tersebut tidak boleh mengisi slot itu, persempit selector: slot di Component yang mendeklarasikannya.

An attachment delivers a key another inject source already claimed (Sebuah lampiran mengirimkan kunci yang sudah diklaim oleh sumber inject lain)

Tiga permukaan penulisan mengirimkan nilai ke dalam pipa injeksi satu komponen melalui blok inject:: blok inject: milik komponen itu sendiri, blok inject: pada entri-entri blok dependensinya, dan blok pada setiap Feature yang dilampirkan padanya. Ketiganya berbagi satu ruang berkunci per mekanisme pengiriman, sehingga kunci yang diklaim oleh dua di antaranya bersifat ambigu mengenai nilai mana yang tiba, dan build berhenti alih-alih membiarkan satu permukaan diam-diam menggeser yang lain. Feature yang dilampirkan juga dapat mengirimkan nilai dengan cara kedua, melalui injectMapping milik FeatureRecipe-nya; jalur tersebut bertemu dengan ruang yang sama setelah setiap blok selesai mengirimkan, dan dilaporkan di bawah “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features terlampir mengirimkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)” di bawah.

Kondisi ini adalah sisi blok lampiran dari ruang tersebut. Kondisi ini dilaporkan ketika blok inject: milik sebuah lampiran mengklaim kunci yang sudah dipegang oleh pengiriman sebelumnya — entri di atas pada “Duplicate delivery key across inject sources (Kunci pengiriman duplikat antar sumber inject)” adalah aturan yang sama yang dibaca dari sisi yang ditulis pengembang, dan di antara keduanya klaim setiap blok tercakup.

Urutan menentukan siapa yang bertabrakan. Klaim pertama atas sebuah kunci adalah klaim yang memegangnya, dan klaim-klaim berikutnya adalah yang dilaporkan — sehingga lampiran yang kuncinya sudah diambil akan diberi tahu, sedangkan lampiran yang mengklaim lebih dulu tidak diberi tahu tentang klaim berikutnya yang tidak menggeser apa pun. Klaim yang sama sekali tidak mengirimkan apa pun membiarkan kunci tetap bebas dan tidak terlibat dalam hal ini.

Temuan ini diposisikan pada entri lampiran itu sendiri di dalam blok komponen, yang merupakan posisi untuk diedit; pesan menyebutkan kunci dan mekanisme yang ruang berkuncinya memuat kunci tersebut. Setiap kunci yang bertabrakan dilaporkan tersendiri, sehingga lampiran yang menduplikasi dua kunci akan memberi tahu Anda tentang keduanya.

Pesan yang diemisikan:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (kunci pengiriman duplikat antara attachment-inject dan sumber inject lain)

Cara memperbaiki: tidak ada sisi yang menjadi pelanggar dan keduanya dapat Anda ubah. Ganti nama kunci pada sisi mana pun yang Anda kendalikan — paling sering entri inject: milik komponen itu sendiri, karena pemetaan Feature ditulis dalam dokumen katalog — atau hapus salah satu dari kedua pengiriman. Jika lampiran memang dimaksudkan untuk menyediakan nilai tersebut, hapus klaim yang ditulis pengembang, bukan klaim lampiran. Perhatikan bahwa injectMapping FeatureRecipe milik sebuah Feature yang menulis sebuah kunci adalah jalur yang berbeda dan tidak dilaporkan di sini: menulis ulang kunci yang dikirimkan oleh blok inject: milik komponen itu sendiri atau oleh salah satu koneksinya adalah intersepsi dan sama sekali tidak dilaporkan, dan menulis kunci yang dikirimkan oleh Feature terlampir lain dilaporkan di bawah entri berikutnya.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features terlampir mengirimkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)

Feature yang dilampirkan mengirimkan nilai ke dalam pipa injeksi komponennya melalui dua jalur: blok inject: yang ditulis pada lampiran, dan injectMapping milik FeatureRecipe-nya, yang keluarannya menyebutkan kunci pengiriman — sering kali dari nilai yang dibawa lampiran, seperti variabel lingkungan yang dipilih untuk sebuah kredensial. Ketika dua Features terlampir tiba pada satu kunci di bawah satu mekanisme pengiriman, dan yang belakangan dari keduanya tiba di sana melalui pemetaannya, build berhenti. Jika dibiarkan berjalan, komponen akan membaca nilai mana pun yang kebetulan ditulis terakhir, sehingga satu kredensial dapat disajikan menggantikan kredensial lain tanpa ada apa pun dalam keluaran yang menunjukkannya.

Kondisi ini mencakup setiap Feature yang dilampirkan, di mana pun dilampirkan: blok features: milik komponen itu sendiri, subsistem, batas Release atau entri komponen, ekspansi anotasi, dan entri features: sebuah koneksi. Pengiriman yang lebih awal dari keduanya dapat berupa pemetaan Feature lain atau blok inject: miliknya — build melaporkan kedua pasangan tersebut di bawah satu kondisi ini.

Urutan menentukan siapa yang bertabrakan. Setiap blok inject: mengirimkan nilai sebelum pemetaan mana pun dirender, dan pemetaan dirender dalam satu urutan tetap — urutan yang ditempuh pemetaan inject saat menelusuri Features yang dilampirkan pada sebuah komponen, yang dijelaskan dalam pipeline kompilasi — sehingga pengiriman pertama atas sebuah kunci adalah yang memegangnya, dan Feature yang belakangan adalah yang dilaporkan. Keberadaan saja yang menentukan: nilai tidak dibandingkan, sehingga dua Features yang mengirimkan nilai yang sama di bawah satu kunci tetap dilaporkan. Kunci yang sama sekali tidak dibawa oleh keluaran pemetaan bukanlah pengiriman; kunci yang dibawanya dengan nilai kosong adalah pengiriman, karena nilai kosong menggantikan apa pun yang ada di sana. Satu kunci di bawah dua mekanisme pengiriman yang berbeda adalah dua kunci, bukan tabrakan.

Yang tidak dilaporkan. injectMapping milik FeatureRecipe yang menulis ulang kunci yang dikirimkan oleh blok inject: milik komponen itu sendiri atau oleh blok inject: salah satu koneksinya adalah intersepsi — Feature perutean yang mengualifikasi host, guard yang mengalihkan upstream — dan nilai pemetaan menggantikan satu entri tersebut. Pemetaan sebuah Feature yang menulis ulang kunci yang dikirimkan oleh blok inject: miliknya sendiri adalah Feature tersebut yang mentransformasikan pengirimannya sendiri, dan juga tidak dilaporkan.

Temuan ini diposisikan pada entri Feature yang belakangan — di dalam blok features: komponen, atau, untuk Feature yang dibawa sebuah koneksi, pada entrinya di bawah koneksi tersebut dalam dokumen yang menulisnya, seperti .spec.components.<component>.uses.<socket>.<alias>.features.<slot> dalam Aggregate. Pesan menyebutkan kunci, mekanisme pengiriman, dan kedua Features berdasarkan nama yang dibawanya pada komponen; Feature yang dibawa sebuah koneksi dinamai dengan alias koneksi dan slot yang diisinya, digabungkan dengan titik. Setiap kunci yang bertabrakan dilaporkan tersendiri.

Pesan yang diemisikan:

duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (kunci pengiriman duplikat di antara dua lampiran: FeatureRecipe sebuah lampiran menulis kunci pengiriman yang sudah dikirim oleh lampiran lain. Berikan salah satu dari kedua lampiran kunci tersendiri, atau lampirkan satu lampiran lebih sedikit: kunci yang dipakai lampiran ini untuk mengirim dipilih oleh FeatureRecipe-nya, yang dapat membaca values dan infra milik lampiran itu sendiri, dan kunci lampiran lainnya dipilih dengan cara yang sama atau oleh blok inject miliknya sendiri jika ia mengirim melalui blok tersebut. Release menetapkan infra sebuah lampiran dan tidak pernah values-nya, jadi jika sebuah kunci dipilih oleh suatu nilai, lampirkan lampiran itu di Aggregate bersama nilainya, dan tetap berikan sisanya dari Release.)

Cara memperbaiki: berikan salah satu dari kedua Features kunci tersendiri — untuk Feature kredensial, biasanya itu adalah kunci yang disebutkan oleh nilai-nilainya — atau hapus salah satu dari kedua lampiran. Jika keduanya dimaksudkan untuk menyediakan satu variabel, tentukan mana yang harus dibaca komponen dan lampirkan hanya yang itu. Dua kredensial yang dilampirkan Release sendiri sama-sama tiba di bawah kunci yang disebutkan Feature-nya secara default, karena Release tidak dapat menulis values sebuah lampiran: lampirkan salah satunya di Aggregate dengan nilai yang menyebutkan kuncinya, dan berikan asalnya dari Release pada entri yang sama.

Komponen mendeklarasikan mekanisme inject yang tidak dipetakan sama sekali oleh Feature terlampir

Daftar izin spec.inject milik Component dapat menyebut mekanisme pengiriman di luar mekanisme standar — mekanisme yang dipahami oleh perangkat internal komponen itu sendiri, sehingga apa pun yang mengirim ke dalamnya harus menghasilkan nilai untuknya. Ketika Feature dilampirkan ke komponen semacam itu, injectMapping milik FeatureRecipe-lah yang menyatakan di bawah mekanisme mana setiap nilai yang dihasilkannya dikirim. Mekanisme yang dideklarasikan komponen tetapi tidak dihasilkan kuncinya oleh pemetaan adalah pengiriman yang secara diam-diam tidak akan pernah terjadi, sehingga build berhenti.

Pemetaan yang tidak menyatakan apa pun tentang mekanisme bukanlah pemetaan yang menyatakan tidak ada mekanisme. FeatureRecipe yang pemetaannya dirender sebagai kamus datar berisi pengiriman sama sekali tidak membuat klaim tentang mekanisme — itulah penulisan biasa untuk Feature yang menghasilkan pengiriman variabel lingkungan — begitu pula lampiran yang mengikat FeatureRecipe tanpa pemetaan untuk dievaluasi. Keduanya tidak dilaporkan di sini; kondisi ini hanya menyangkut pemetaan yang menyebut mekanisme dan melewatkan salah satu yang dideklarasikan komponen.

Setiap mekanisme yang tidak terpetakan adalah temuan tersendiri, sehingga komponen yang mendeklarasikan dua mekanisme yang tidak dipetakan sama sekali oleh suatu lampiran akan memberi tahu Anda tentang keduanya. Temuan diposisikan pada entri lampiran di berkas Anda sendiri, dan juga menyebut FeatureRecipe-nya — karena itulah dokumen tempat pemetaan ditulis, dan dokumen itu berada di tempat lain sama sekali.

Pesan yang diemisikan:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (mekanisme inject kustom tidak memiliki kunci yang cocok dalam keluaran injectMapping; tambahkan kunci mekanisme tersebut ke injectMapping milik Recipe)

Cara memperbaiki: pesan menyebut kedua sisinya. Tambahkan kunci mekanisme ke injectMapping milik FeatureRecipe agar Feature menghasilkan nilai untuknya, atau hapus mekanisme tersebut dari daftar izin spec.inject milik Component jika tidak ada yang diharapkan mengirim di bawahnya. Jika FeatureRecipe tersebut milik katalog orang lain, melampirkan Feature yang pemetaannya mencakup mekanisme itu adalah jawaban ketiga.

An attached Feature’s injectMapping output cannot be read (Output injectMapping dari Feature yang dipasang tidak dapat dibaca)

injectMapping milik sebuah FeatureRecipe adalah templat, dan apa yang dihasilkannya dibaca sebagai YAML: kamus yang dikunci berdasarkan mekanisme pengiriman — env, file, arg, atau mekanisme milik komponen itu sendiri — atau kamus datar berisi pengiriman environment. Bila output tidak terbaca sebagai salah satunya, tidak satu pun kuncinya dapat dikirim, sehingga build berhenti alih-alih merender komponen seolah-olah Feature yang dipasang tidak mengirim apa pun. Kredensial adalah kasus yang paling penting: tanpa penghentian ini, komponen yang mengharapkan kata sandi yang tidak pernah diterimanya dapat berjalan tanpa kata sandi itu, dan tidak ada apa pun dalam output yang menyatakannya.

Penyebab yang biasa adalah nilai yang ditulis templat apa adanya di antara tanda kutip. Tanda kutip ganda di dalamnya mengakhiri skalar berkutip terlalu dini, dan garis miring terbalik memulai escape yang mungkin tidak dikenal YAML, sehingga pemetaan yang dirender dengan benar untuk sebagian besar nilai menjadi rusak untuk nilai yang memuat karakter semacam itu — sering kali kata sandi. Output yang kosong, atau yang di-parse sebagai kamus yang tidak mengirim apa pun, bukanlah kondisi ini: output itu tidak mengirim apa pun, dan memang itulah yang dinyatakannya.

Bingkai di atas pesan menyebutkan komponen yang sedang dirender, lalu attachment berdasarkan nama yang dibawanya pada komponen dan FeatureRecipe tempat pemetaan ditulis, sebagai feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Di bawah pesan terdapat alasan output tidak dapat dibaca — baris dan apa yang ditemukan YAML di sana, seperti yaml: line 2: found unknown escape character. Bila templat membaca nilai yang dideklarasikan sensitif oleh penulis dan alasannya bergantung pada isi nilai tersebut, alasan itu ditahan dan sebuah kalimat yang menyatakan hal itu menggantikannya, sehingga penghentian ini tidak pernah mengutip nilai yang merusak output. Build melaporkan penghentian ini di bawah tag CATALOG_ERROR, karena pemetaan ditulis oleh penulis FeatureRecipe.

Pesan yang diemisikan:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (Output injectMapping FeatureRecipe tidak dapat dibaca sebagai kamus pengiriman)

Cara memperbaiki: dalam injectMapping milik FeatureRecipe, tulis setiap nilai melalui toJson — {{ .values.key }}: {{ .values.origin | toJson }} — yang menuliskannya sebagai string JSON yang dibaca kembali oleh YAML secara persis, apa pun karakter yang dimuatnya. Bila FeatureRecipe tersebut milik katalog orang lain, nilainya juga dapat diubah agar tidak memuat tanda kutip ganda atau garis miring terbalik sampai pemetaan diperbaiki.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Output injectMapping dari Feature yang dipasang menulis pengiriman di bawah kunci yang tidak dikirim oleh apa pun)

Output injectMapping milik sebuah FeatureRecipe digabungkan ke dalam pipa injeksi komponen berdasarkan kunci tingkat atasnya. env, file, dan arg dikirim sebagai mekanisme tersebut, dan kunci lain mana pun dikirim sebagai mekanisme tersendiri dengan nama itu, yang dibaca Recipe komponen di .context.inject.<name>. Tampilan all berbeda: tampilan ini dibangun dari mekanisme-mekanisme setelah penggabungan, tidak pernah digabungkan dari sebuah output, sehingga nilai yang ditulis pemetaan di bawah all: tidak sampai ke mana pun. Output tetap terbaca dengan bersih, sehingga tanpa penghentian ini, build yang membaca nilai-nilai tersebut secara opsional berhasil tanpa nilai-nilai itu — kredensial yang ditulis di sana tidak pernah sampai ke komponen, dan tidak ada apa pun dalam build yang menyebutkan pemetaan yang menghilangkannya.

Kondisi ini berlaku di mana pun all: memuat setidaknya satu entri, sendirian atau di samping mekanisme lain; mekanisme lain dalam output yang sama bukanlah masalahnya, dan all: yang ditulis kosong tidak kehilangan apa pun dan tidak dilaporkan. Kamus datar yang kebetulan memuat kunci bernama all dengan satu nilai adalah pengiriman environment bernama all, bukan kondisi ini.

Temuan ini diposisikan pada entri attachment di file Anda sendiri, dan menyebutkan kunci serta FeatureRecipe tempat pemetaan ditulis — karena itulah dokumen yang harus diubah, dan dokumen itu berada di tempat lain sama sekali — bersama dengan kunci-kunci yang boleh dimuat sebuah output. Setiap kunci semacam itu merupakan temuan tersendiri. Build melaporkannya di bawah tag CATALOG_ERROR.

Pesan yang diemisikan:

FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (Output injectMapping FeatureRecipe menulis kunci yang tidak dibaca oleh mekanisme pengiriman mana pun milik host)

Cara memperbaiki: dalam injectMapping milik FeatureRecipe, pindahkan entri dari bawah all: ke mekanisme tempat komponen membacanya — biasanya env:, atau nama mekanisme yang dibaca Recipe komponen. Bila FeatureRecipe tersebut milik katalog orang lain, pasang Feature yang pemetaannya mengirimkan nilai tersebut sebagai gantinya.

Saat merender keluaran

Setelah setiap kontrak divalidasi, kompiler mengevaluasi templat Go pada nilai Component, blok injectMapping FeatureRecipe, serta sumber Recipe dan FeatureRecipe, lalu menyerahkan hasilnya ke perender.

Templat provides: mereferensikan root yang tidak mandiri

Templat provides: sebuah Recipe mereferensikan root di luar himpunan mandiri. Blok provides dievaluasi pada tahap evaluasi provides, sebelum pipa inject dihidrasi dan sebelum edge lintas node ditelusuri, sehingga blok ini hanya boleh mereferensikan data milik node-nya sendiri: .context.instance_id, .context.rendered_name jika provider node tersebut melaporkannya, .values, .infra, .locals node yang telah di-resolve, dan string statis. Pemeriksaan ini berupa allowlist positif, sehingga root lain apa pun akan menghentikan build — .context.inject dan .context.uses (lintas node), .context.annotations.*, .context.labels, .context.metadata, dan .metadata.* (data yang terkait penempatan atau deployment yang tidak diekspos oleh permukaan provides), serta .attachment_name (tahap provides pada Recipe dasar tidak me-resolve attachment apa pun). Mereferensikan salah satunya akan menghentikan build secara eksplisit alih-alih diam-diam merender nilai kosong.

.locals termasuk dalam permukaan ini: locals sebuah node di-resolve di bagian awal tahap yang sama, sebelum provides-nya, sehingga templat provides dapat membacanya dan menerima nilai yang telah di-resolve.

Pesan yang diemisikan:

provides block references a root outside the self-contained set ("<expression>") (blok provides mereferensikan root di luar himpunan mandiri)

Penghentian ini diposisikan pada Recipe yang mendeklarasikan entri tersebut dan pada kunci yang ditulis di dalamnya — .spec.provides.<name> — sehingga yang disebut adalah blok yang perlu diedit, bukan komponen yang mengikat Recipe tersebut. Setiap entri yang menjangkau ke luar permukaan dilaporkan dalam build yang sama; jika lebih dari satu, temuan-temuan tersebut dikelompokkan di bawah provides entries that reach outside the data they are evaluated against.

Cara memperbaiki: ubah templat agar hanya mengambil data dari pilar milik Recipe itu sendiri. Jika nilainya bergantung pada keluaran node lain, ketergantungan tersebut seharusnya berada di blok uses[].inject milik pemanggil, bukan di provides milik target. Jika nilainya dihitung, letakkan ekspresinya dalam entri locals: dan baca dari provides — ekspresi tersebut kemudian berada di satu tempat. Jika Anda bermaksud mengambil namespace deployment (atau data penempatan lain) untuk membangun host lintas namespace, publikasikan host polos di sini dan kualifikasikan di sisi konsumen dengan fitur routing — provides milik produsen tidak boleh bergantung pada tempat ia di-deploy.

provides: milik FeatureRecipe mengikuti aturan locals yang sama: locals: miliknya di-resolve sebelum provides:-nya, sehingga entri provides FeatureRecipe juga dapat membaca .locals.

Entri locals: mereferensikan entri sejajar yang didefinisikan kemudian dalam blok yang sama

Blok locals: di-resolve sesuai urutan penulisan entrinya, dan sebuah entri hanya membaca entri sejajar yang didefinisikan di atasnya. Referensi langsung .locals.<key> ke entri yang didefinisikan kemudian dalam blok akan menghentikan build: kompiler tidak pernah mengurutkan atau menyusun ulang blok agar referensi tersebut dapat di-resolve, karena keluaran yang dihasilkan kemudian akan mengikuti inferensi alih-alih apa yang ditulis. Tanpa penghentian ini, referensi tersebut akan di-resolve melalui kebijakan kunci-hilang menjadi string kosong, sehingga hostname atau nama secret turunan akan diam-diam kehilangan segmen yang menjadi dasarnya.

Kedua resolusi blok locals: menentukan kesalahan ini, dan salah satunya adalah pinning. Sebuah blok di-resolve untuk dua tujuan berbeda: agar templat milik Recipe itu sendiri dapat membacanya saat artefak dirender, dan agar koordinat source: terstruktur dapat di-resolve dan artefak yang disebutnya di-pin. Kesalahan ini ditentukan dari urutan kunci yang dideklarasikan dan teks yang ditulis, yang sudah mencakup semua yang dibutuhkan, sehingga kedua resolusi menjangkaunya dan melaporkan kondisi yang sama — aggrega pull, serta build yang mengisi lockfile, menolak blok tersebut persis seperti saat render. Ada dua konsekuensi yang perlu diketahui saat menulis. Seluruh blok dibaca saat koordinat di-resolve, sehingga entri yang urutannya salah akan menghentikan build bahkan ketika setiap field source: bersifat literal dan tidak membaca local apa pun. Selain itu, Recipe yang source:-nya berupa string biasa, atau yang tidak mendeklarasikan source: sama sekali, tidak me-resolve koordinat apa pun, sehingga pada Recipe tersebut kesalahan ini dilaporkan saat keluaran dirender.

Pesan yang dikeluarkan, untuk entri dalam blok locals: milik Recipe komponen. Pesan diposisikan pada kunci yang ditulis di dalam Recipe, dan setiap entri yang bermasalah dilaporkan dalam satu build; jika lebih dari satu, temuan-temuan tersebut dikelompokkan di bawah locals entries that read a sibling they cannot:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (entri locals mereferensikan entri sejajar yang didefinisikan kemudian dalam blok yang sama (kunci yang disebutnya, yang telah di-resolve pada titik ini, dijangkau melalui komponen). definisikan kunci yang direferensikan di atas kunci tersebut dalam blok locals)

Referensi diri adalah kondisi yang sama — kuncinya dideklarasikan tetapi belum di-resolve — dan tidak ada penyusunan ulang yang dapat memperbaikinya, sehingga pesan menyatakan hal itu sebagai pengganti instruksi untuk memindahkan entri:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (entri locals mereferensikan entri sejajar yang didefinisikan kemudian dalam blok yang sama (kunci yang disebutnya, yang telah di-resolve pada titik ini, dijangkau melalui komponen). entri locals tidak dapat membaca dirinya sendiri; hitung nilainya langsung dari .values dan .infra)

Satu Recipe diikat oleh banyak komponen, sehingga satu kesalahan dalam blok bersama dilaporkan sekali untuk setiap komponen yang mengikatnya — dan reached through the component adalah yang membedakan temuan-temuan tersebut. Temuan-temuan itu berbagi posisi, karena semuanya menyangkut entri tertulis yang sama dalam dokumen yang sama; posisi menunjukkan tempat untuk mengedit, dan nama komponen menunjukkan komponen Anda yang diwakili oleh setiap temuan. Temuan-temuan tersebut tidak digabungkan menjadi satu, karena penggabungan akan menyatakan ada yang salah tanpa menyebutkan komponen mana yang terdampak, padahal bagian itulah yang perlu Anda tindak lanjuti.

Kesalahan yang sama dalam blok locals: yang dideklarasikan oleh recipe sebuah Feature dilaporkan dengan cara yang sama: diposisikan pada kunci yang ditulis di dalam recipe tersebut, disebut dengan nama komponen tempat attachment berada, dan dikelompokkan dengan entri sejajar lain yang memiliki kesalahan yang sama. Jika recipe tersebut dipasang di lebih dari satu tempat, kesalahan dilaporkan sekali untuk masing-masing — setiap attachment mengikat blok tersebut secara independen, sehingga masing-masing merupakan kejadian tersendiri, bukan pengulangan dari satu kejadian.

Jika bentuk tersebut melaporkan referensi diri, klausa posisinya menyebut entri yang mereferensikan itu sendiri alih-alih entri yang didefinisikan kemudian, karena di situlah kunci tersebut berada.

Cara memperbaiki: pindahkan entri yang direferensikan ke atas entri yang membacanya. Menyusun ulang blok locals: merupakan perubahan perilaku di mana pun satu entri membaca entri lain, sehingga perbaikannya adalah persis penyusunan ulang yang disebutkan oleh pesan. Referensi diri — entri yang menyebut kuncinya sendiri — tidak dapat diperbaiki dengan penyusunan ulang; sebagai gantinya, hitung nilainya langsung dari .values dan .infra, sebagaimana dinyatakan pesan sebagai pengganti instruksi untuk memindahkan entri.

Kunci locals: tidak ada

Sebuah templat membaca .locals.<key> untuk kunci yang sama sekali tidak dideklarasikan oleh blok locals: — salah ketik, atau kunci yang telah diganti namanya atau dihapus. Setiap permukaan yang membaca pilar ini memunculkan penghentian ini: entri locals:, templat provides:, templat source: milik Recipe, dan resolusi koordinat source: terstruktur, yang membaca seluruh blok untuk menyematkan artefak yang dinamai koordinat tersebut. Pilar locals adalah peta berkunci yang terbuka, sehingga kunci yang tidak dikenal di bawahnya lolos pemeriksaan root dan jika tidak dihentikan akan teresolusi menjadi string kosong; penghentian inilah yang mencegah nilai kosong tersebut mencapai artefak yang dihasilkan.

Pesan yang dihasilkan, jika referensi yang bermasalah berada dalam templat provides::

template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (templat mereferensikan kunci yang tidak dideklarasikan oleh blok locals (Recipe provides[] mereferensikan , blok locals tidak mendeklarasikan , blok tersebut mendeklarasikan ). perbaiki nama kuncinya)

Pesan yang dihasilkan, jika referensi berada dalam entri locals: itu sendiri. Pesan ini memuat komponen yang melaluinya blok tersebut diikat, dengan alasan yang dinyatakan pada penghentian urutan di atas — satu blok bersama dilaporkan sekali untuk setiap komponen yang mengikatnya, dan inilah yang membedakan temuan-temuan tersebut:

template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (templat mereferensikan kunci yang tidak dideklarasikan oleh blok locals (kunci yang hilang adalah , blok mendeklarasikan , dicapai melalui komponen ). perbaiki nama kuncinya)

Cara memperbaiki: perbaiki nama kunci menjadi salah satu yang dideklarasikan blok; pesan mencantumkannya. Penghentian ini berbeda dari penghentian urutan di atas karena solusinya berbeda — tidak ada penyusunan ulang yang dapat membuat kunci yang tidak ada menjadi teresolusi.

Pemeriksaan membaca jalur yang menjadi hasil resolusi sebuah referensi, bukan ketikannya, sehingga alias untuk blok tersebut diikuti: kunci yang dicapai melalui titik yang diikat ulang oleh badan with .locals, atau melalui variabel yang diikat ke .locals, diperiksa dengan ketentuan yang persis sama dengan penulisan langsung dan dihentikan dengan cara yang sama, demikian pula kunci yang dibaca dari blok dalam tanda kurung — {{ (.locals).nope }} atau {{ ($.locals).nope }} — karena tanda kurung menghasilkan blok itu sendiri dan tidak lebih. Satu penulisan lolos dari pemeriksaan: kunci yang dicapai melalui pemanggilan yang hasilnya tidak dapat dinamai oleh teks templat — {{ index .locals "nope" }}, atau {{ (default dict .locals).nope }} — karena apa yang dihasilkan pemanggilan semacam itu ditentukan saat templat dijalankan, bukan oleh apa yang ditulis. Kunci yang tidak ada yang dibaca sebagai field dari hasil pemanggilan semacam itu — bentuk (default dict .locals).nope — tidak menghentikan build, dan merender teks placeholder mesin templat, <no value>. Kunci yang tidak ada yang dicapai melalui index menghentikan build, tetapi sebagai “A template indexes a map with a key the map does not hold (Templat mengindeks peta dengan kunci yang tidak dimiliki peta tersebut)” di bawah, bukan sebagai pemeriksaan ini: index berhenti pada setiap kunci peta yang tidak dimiliki peta tersebut. Oleh karena itu, index tetap menjadi cara untuk mencapai kunci yang namanya sendiri dihitung, dan nama terhitung yang tidak dideklarasikan blok tetap dilaporkan berdasarkan kuncinya.

Template references a root the render context does not define (Template mereferensikan root yang tidak didefinisikan oleh konteks render)

Sebuah template mereferensikan root tingkat atas — segmen path pertama setelah titik di awal — yang tidak didefinisikan oleh konteks render-nya: salah ketik seperti {{ .valeus.port }}, atau root yang tidak ada pada permukaan yang sedang ditulis. Pemeriksaan ini adalah allowlist positif atas nama root, dan himpunan yang diterima diturunkan dari bentuk konteks render itu sendiri alih-alih disimpan sebagai daftar terpisah di sampingnya, sehingga himpunan yang ditolak build dan himpunan yang benar-benar disediakan konteks tidak dapat saling menyimpang. Diagnostik menyebutkan referensi yang bermasalah dan mencantumkan root yang didefinisikan oleh konteks tersebut.

Halt ini terpicu dengan cara yang sama baik referensi ditulis polos maupun dibungkus dalam fallback default, if, with, atau range, dan bentuk terbungkuslah yang paling penting: pembungkus dapat menyediakan fallback untuk key yang tidak ada di bawah root yang terdefinisi, tetapi tidak pernah untuk root yang tidak ada, sehingga tanpa halt ini bentuk terbungkus akan diselesaikan diam-diam menjadi nilai kosong dan membiarkan build selesai dengan sukses. Key yang tidak ada di bawah root yang terdefinisi tidak tersentuh dan tetap mengikuti kebijakan missingkey=zero untuk template nilai yang dijelaskan dalam “Missing template key — asymmetric policy (Kunci templat hilang — kebijakan asimetris)” di bawah, sehingga idiom key opsional seperti {{ .values.optional_field | default "fallback" }} tetap berfungsi.

Halt yang sama mencakup key yang salah ketik satu tingkat di bawahnya, di bawah pilar yang bentuknya dideklarasikan. Beberapa pilar memiliki himpunan key yang didefinisikan compiler: .context, .metadata, .inject, .workload dan .boundary pada konteks render Recipe dan FeatureRecipe, serta .manifest pada path template. Referensi ke key yang tidak didefinisikan oleh salah satu pilar tersebut — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — berhenti persis seperti root yang salah, dan diagnostik mencantumkan key yang didefinisikan pilar tersebut. Pada template milik lampiran Feature itu sendiri, .inject mendefinisikan satu key tambahan untuk setiap mekanisme pengiriman yang disebutkan oleh blok inject: milik lampiran itu, di samping env, file, arg dan all: lampiran yang menulis mekanisme vault_ref: dibaca di {{ .inject.vault_ref.VAULT_PATH }}, dan diagnostik mencantumkan .inject.vault_ref di antara key yang didefinisikan .inject. Mekanisme yang tidak disebutkan oleh lampiran tetap berhenti bahkan di dalam if atau with, karena referensi diperiksa sebelum template dijalankan. Untuk membaca mekanisme yang mungkin tidak disebutkan oleh lampiran, lindungi referensinya: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Pasangan yang dilindungi ini berhasil di-build baik lampiran menyebutkan mekanisme tersebut maupun tidak, dan baik ia menulis blok inject: maupun tidak sama sekali — saat itu .inject tidak berisi apa pun, sehingga with melewati badannya, sedangkan hasKey yang langsung diterapkan pada .inject akan berhenti pada nilai yang bukan map. Di dalam pelindung, index tetap berhenti pada key yang tidak dimiliki oleh mekanisme yang disebutkan. Pilar lainnya bersifat terbuka, karena isinya adalah data berkunci, bukan himpunan yang dideklarasikan compiler — di antaranya .values, .infra, .locals, .provides, .features dan .steps pada konteks render, serta .parameters dan .parent_boundary pada path template. Pilar terbuka menerima key apa pun. Key yang tidak ada di bawah pilar terbuka bukanlah halt ini — ia mengikuti kebijakan missing-key permukaan tersebut yang dijelaskan dalam “Missing template key — asymmetric policy (Kunci templat hilang — kebijakan asimetris)” di bawah, sehingga {{ .values.optional_field | default "fallback" }} dan setiap idiom key opsional lainnya tetap berfungsi.

Pilar mana yang dideklarasikan dan mana yang terbuka adalah sifat dari permukaan, bukan sesuatu yang dapat dipengaruhi template: compiler membacanya dari bentuk konteks render yang akan disediakannya. Itulah yang memungkinkan halt salah ketik dan key opsional dirender pada template yang sama.

Sebuah permukaan juga dapat mempersempit key yang sebenarnya didefinisikan pilarnya, dan laporan semacam itu bukanlah salah ketik. Jika sebuah key membawa jawaban yang tidak bermakna — atau milik node lain — pada satu permukaan tertentu, permukaan tersebut menolak referensi itu alih-alih menyelesaikannya ke hal yang salah, dan diagnostik mencantumkan key yang memang didefinisikannya. Ada dua kasus yang perlu diketahui, keduanya {{ .context.rendered_name }}. Pada template milik attachment Feature itu sendiri, key tersebut membawa nama komponen host sebagaimana dilaporkan oleh provider milik host itu sendiri, sehingga key ini ditolak pada attachment dari host yang provider-nya tidak melaporkan nama — host yang hanya menempatkan sebuah set artefak, atau host yang merender melalui provider yang tidak menurunkan nama semacam itu — dan diterima pada setiap host lainnya. {{ .context.instance_id }} diterima pada permukaan tersebut dan menyebut komponen host yang sedang diselesaikan oleh attachment, yang menjadi dasar penamaan resource milik host itu sendiri pada host semacam itu. Dalam entri locals: sebuah Recipe, key tersebut ditolak apa pun yang dilaporkan provider node: sebuah local berbagi konteksnya dengan template source: milik Recipe, dan apakah node menyediakan source adalah salah satu hal yang menentukan nama tersebut, sehingga nama itu tidak ditawarkan di sana. Diagnostik mencantumkan .context.instance_id sebagai satu-satunya key yang didefinisikan .context di sana; bacalah nama yang dirender dalam entri provides: atau template inline sebagai gantinya. Lihat ../templates/rendered-resource-names.md untuk mengetahui apa yang disebut oleh masing-masing dari kedua key tersebut dan di mana masing-masing dapat dibaca.

Pesan yang dikeluarkan ketika root itu sendiri tidak didefinisikan:

template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (template mereferensikan root yang tidak didefinisikan oleh konteks render (template mereferensikan, konteks render mendefinisikan))

Dan ketika root-nya benar tetapi key di bawah pilar yang dideklarasikan tidak:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (template mereferensikan root yang tidak didefinisikan oleh konteks render (template mereferensikan, pilar mendefinisikan))

Cara memperbaiki: perbaiki referensi menjadi salah satu yang dicantumkan diagnostik — sebagian besar laporan adalah salah ketik dari .values, .infra, atau .context, atau dari key di bawah .context atau .metadata. Menghapus pembungkus fallback tidak akan menghilangkan halt, dan menambahkannya tidak pernah menekannya; pembungkus hanya menyembunyikan referensi mana yang salah. Jika data tersebut memang milik node lain, data itu mencapai template ini melalui pipa inject — sambungkan dengan entri uses[].inject pada konsumen dan bacalah dari .context.inject — bukan melalui root tersendiri.

Pemeriksaan ini mencakup setiap permukaan template yang dievaluasi renderer, masing-masing terhadap himpunan referensi yang didefinisikan permukaannya sendiri: valuesMapping, injectMapping, workload Recipe dan FeatureRecipe, isi artifacts:, entri provides: dan locals:, source:, isi when: dan with: pada langkah pipeline, assertions:, template self-inject value: tingkat komponen dalam sebuah Aggregate, serta path template boundary Release (directory: / subDirectory:). Dua dari permukaan tersebut menyebut sebagian penolakan dengan diagnostiknya sendiri, karena kesalahan yang digambarkannya lebih spesifik daripada “referensi ini tidak ada”: path template yang meraih variabel yang tidak diberikan kepadanya dicakup oleh “Path-template references a variable outside the allowlist” di bawah, dan FeatureRecipe lingkup boundary yang meraih pilar per komponen dicakup oleh “FeatureRecipe template references a field outside its scope’s allowlist”. Semua hal lain yang ditolak kedua permukaan tersebut — termasuk key yang salah ketik di bawah pilar yang memang diterimanya — melaporkan halt ini, sehingga tidak ada diagnostik yang memberi tahu Anda bahwa referensi Anda adalah sesuatu yang bukan sebenarnya.

Template artifacts: membaca pilar yang tidak dideklarasikan oleh Recipe

Template dari sebuah entri artifacts: membaca .workload, atau kunci di bawahnya, dalam Recipe yang tidak mendeklarasikan workload:; atau membaca .source, atau kunci di bawahnya, dalam Recipe yang tidak mendeklarasikan source:. Kedua pilar tersebut selalu ada pada konteks render artifacts — keduanya adalah root yang didefinisikan oleh permukaan tersebut — sehingga referensinya terbentuk dengan benar, dan penghentian ini berkaitan dengan deklarasi yang tidak ada, bukan dengan referensi yang salah. Recipe yang merender Deployment dari workload yang disintesisnya dan Recipe yang merender chart dari sebuah source memiliki bentuk yang berbeda, dan isi artifacts: yang ditulis untuk salah satunya menjangkau pilar yang tidak pernah diisi oleh yang lain.

Pemeriksaan dijalankan sebelum entri dievaluasi, dan urutan inilah yang membuat laporannya berguna. Pilar yang tidak ada tiba di template sebagai nilai kosong, sehingga jika diserahkan pada evaluasi, build akan menyisipkan kekosongan ke dalam file yang dihasilkan atau gagal dengan pesan apa pun yang diberikan mesin template tentang membaca kunci dari sesuatu yang kosong — dan tidak satu pun dari keduanya menyebutkan pilar atau deklarasi yang hilang. Dengan menolak terlebih dahulu, penghentian ini dapat menyebutkan ekspresi persis yang menjangkau pilar tersebut, dikutip sebagaimana Anda menulisnya.

source: yang dideklarasikan tetapi dirender menjadi string kosong dibaca sebagai tidak ada source sama sekali, karena yang dibaca oleh pemeriksaan adalah source setelah templatenya sendiri dievaluasi. Itulah nilai yang sama yang kemudian dirender oleh provider, sehingga Recipe yang source:-nya terselesaikan menjadi kosong juga tidak memiliki source untuk ditawarkan kepada isi artifacts:.

Pesan yang dikeluarkan, dalam satu bentuk di mana pun entri artifacts: ditulis. Yang berbeda bukanlah kalimatnya, melainkan keterangan sesudahnya, yang menyebutkan dokumen mana yang memuat entri tersebut.

Setiap referensi yang bermasalah dalam template disebutkan, sehingga isi yang menjangkau dua pilar yang tidak ada memberi tahu Anda tentang keduanya, bukan hanya tentang yang muncul lebih dulu. Setiap referensi dilaporkan pada dokumen yang mendeklarasikan entri tersebut, dikutip sebagaimana Anda menulisnya dan diberi keterangan output tempatnya berada:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (template artifact mereferensikan pilar yang tidak dideklarasikan oleh Recipe (ekspresi, artifact))

Ekspresi tersebut menyebutkan pilar pada segmen pertamanya, dan itulah yang memberi tahu Anda deklarasi mana yang hilang: .source.chart menjangkau source:, .workload.containers menjangkau workload:.

Entri yang dideklarasikan oleh Recipe milik komponen itu sendiri dilaporkan terhadap blok artifacts: dari Recipe tersebut.

Entri yang dideklarasikan oleh FeatureRecipe — yang dilampirkan ke komponen sebagai fitur, atau dideklarasikan pada boundary — diperiksa terhadap pilar yang dideklarasikan oleh FeatureRecipe itu, bukan pilar milik komponen host, dilaporkan terhadap blok artifacts: milik FeatureRecipe, dan membawa satu keterangan tambahan yang menyebutkan lampiran yang mengikatnya:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (template artifact mereferensikan pilar yang tidak dideklarasikan oleh Recipe (ekspresi, artifact, lampiran))

Keterangan lampiran menyampaikan apa yang tidak dapat dikatakan oleh posisi saja: sebuah komponen dapat membawa beberapa lampiran, dan lampiran yang dideklarasikan pada boundary menjangkau setiap komponen yang dimuat boundary tersebut. Kalimatnya sendiri menyebutkan Recipe pada kedua jalur; posisi dan keterangan lampiran bersama-samalah yang menyebutkan dokumen mana yang perlu dibuka.

Jika satu template menyebutkan beberapa referensi, masing-masing mendapat laporannya sendiri di bawah satu baris yang menyebutkan entri yang mereka miliki bersama, dan baris tersebut juga menyebutkan dokumennya:

artifact <output-name> references pillars its Recipe does not declare (artifact mereferensikan pilar yang tidak dideklarasikan oleh Recipe-nya)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (artifact mereferensikan pilar yang tidak dideklarasikan oleh FeatureRecipe yang diikat oleh lampiran)

Setiap laporan ini membawa kondisi penghentian yang sama, dokumen mana pun yang dibahasnya, sehingga apa pun yang mencocokkan kondisi alih-alih teks tidak melihat perbedaan di antara laporan-laporan tersebut.

Cara memperbaiki: deklarasikan pilar yang dibaca template, atau berhenti membacanya. Mendeklarasikannya adalah perbaikan yang tepat jika isi artifacts: memang sesuai dengan bentuk Recipe tersebut — tambahkan workload: yang diharapkan oleh referensi container, port, atau volume dalam template, atau source: yang path chart atau modulnya diinterpolasi oleh template. Menghapus referensi adalah perbaikan yang tepat jika isi tersebut ditulis untuk Recipe lain dan menggunakan ulang fragmen yang tidak berlaku di sini; jika nilainya memang berasal dari tempat lain, publikasikan melalui provides: milik node penghasil dan baca dari pipa inject, alih-alih menjangkau pilar yang tidak diisi oleh Recipe ini. Melindungi referensi dengan pembungkus fallback tidak menghilangkan penghentian — yang hilang adalah pilarnya, bukan kunci di bawahnya — begitu pula memindahkan referensi ke entri lain dalam Recipe yang sama, karena setiap entri dalam satu blok artifacts: dievaluasi terhadap pilar yang sama.

Penghentian ini berbeda dari “Template references a root the render context does not define (Template mereferensikan root yang tidak didefinisikan oleh konteks render)” di atas, dan keduanya perlu dibedakan karena solusinya berbeda. Yang itu terpicu oleh root yang sama sekali tidak didefinisikan oleh permukaan, atau oleh kunci yang salah ketik di bawah pilar yang bentuknya tetap — {{ .workload.containres }} pada Recipe yang memang mendeklarasikan workload. Yang ini terpicu oleh referensi yang dieja dengan benar ke pilar yang memang tidak ada.

Template membaca nama hasil render yang tidak dilaporkan oleh provider node

Sebuah template membaca {{ .context.rendered_name }} — nama yang diberikan provider terikat kepada output yang dirender untuk node tersebut, dari sumber yang disediakan penulis atau dari workload yang disintesisnya — pada node yang provider-nya tidak melaporkan nama semacam itu. Referensinya berbentuk benar dan kuncinya didefinisikan oleh konteks render; yang tidak ada adalah jawaban untuk node ini.

Penolakan ini ada karena alternatifnya lebih buruk daripada penghentian. Nama tersebut sampai ke template sebagai string biasa, sehingga node yang tidak memilikinya akan merender referensi itu menjadi kosong dan menghasilkan alamat yang kurang satu segmen — .svc.cluster.local padahal yang dimaksud adalah nama host — dengan kode keluar nol, tanpa apa pun dalam build yang dapat dibaca. Artefak itu dapat di-deploy, dan apa yang dinamainya tidak ada. Dengan menolak sebelum apa pun dievaluasi, kesalahan dilaporkan pada template yang ditulis penulis.

Apakah provider sebuah node melaporkan nama semacam itu ditentukan oleh pengikatan Recipe, sebelum evaluasi apa pun, sehingga tidak ada yang ditebak di sini.

Ada dua laporan, dan yang Anda terima bergantung pada node, bukan pada tempat Anda menulis referensinya. Node yang tidak menyediakan sumber sendiri, di bawah provider yang tidak melaporkan nama untuknya, memiliki sumber daya yang dinamai menurut identitasnya, sehingga ada nilai yang benar dan laporan menyebutkannya. Node yang menyediakan sumber, di bawah provider yang tidak menurunkan nama untuknya, tidak memiliki pengganti — dan menawarkan identitas di sana akan mengarahkan Anda ke nilai yang tidak menamai satu pun sumber daya node tersebut, sehingga laporan menyatakan hal itu.

Pesan yang dihasilkan, jika node tidak menyediakan sumber sendiri:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (template membaca nama yang diberikan target kepada sumber daya yang direndernya untuk node, dan provider node ini tidak melaporkan nama semacam itu; template yang sesuai membaca nilai yang disediakan oleh provider node itu sendiri (provider). sebagai gantinya, bacalah instance_id: node ini tidak menyediakan sumber sendiri, sehingga sumber dayanya dinamai menurut identitas node)

Dan jika node menyediakan sumber, di bawah provider yang tidak menurunkan nama semacam itu:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (template membaca nama yang diberikan target kepada sumber daya yang direndernya untuk node, dan provider node ini tidak melaporkan nama semacam itu; template yang sesuai membaca nilai yang disediakan oleh provider node itu sendiri (provider). tulislah nilai yang tidak bergantung pada nama yang diturunkan target ini: target ini tidak melaporkan nama untuk output yang direndernya dari sumber yang disediakan, sehingga tidak ada hal semacam itu untuk dibaca di sini)

Jika referensi berada dalam template selain entri provides:, laporan juga menyebutkan field tempat referensi itu ditulis — field "valuesMapping", field "artifacts[probe.tf.json]" — karena kunci entri artifacts: adalah nama file output dan memuat karakter yang digunakan posisi untuk memisahkan segmennya sendiri, sehingga posisi berhenti pada blok yang memuat entri tersebut.

Template yang dicakup: setiap template yang ditulis inline oleh Recipe — entri provides:, valuesMapping:, isi workload:, setiap entri artifacts:, serta with: dan when: pada setiap langkah pipeline. Satu permukaan template berada di luar cakupan: entri valuesMapping:, workload:, atau artifacts: yang disediakan melalui $import: — baik impor tersebut menyebut file lokal maupun entri pustaka — tidak memuat teks dalam Recipe hingga render menyelesaikannya, sehingga referensi di dalam isi semacam itu dirender sebagai nilai kosong alih-alih menghentikan build.

Cara memperbaiki: bacalah kunci yang disebutkan laporan. Jika output node Anda adalah sesuatu yang dibangun untuknya di bawah provider yang tidak melaporkan nama — workload yang disintesis, kumpulan artefak yang ditempatkan — {{ .context.instance_id }} adalah nama yang benar-benar dimiliki sumber daya tersebut, dan itu adalah nilai yang tepat, bukan nilai cadangan. Jika node Anda menyediakan chart atau modul sendiri dan laporan tidak menawarkan pengganti, nama yang Anda cari bukanlah nama yang diturunkan provider tersebut: publikasikan sesuatu yang tidak bergantung padanya, atau namai sumber daya dalam sumber yang Anda sediakan dan baca kembali nama itu dari nilai yang Anda tetapkan. ../templates/rendered-resource-names.md menjelaskan provider mana yang melaporkan nama dan, untuk masing-masing provider lainnya, mengapa tidak ada nama untuk dilaporkan.

Template membaca fakta render pemanggilnya tanpa mendeklarasikannya

Sebuah template dalam FeatureRecipe yang dilampirkan ke sebuah komponen membaca render_facts di bawah .context.used_by — apa yang dilaporkan komponen-komponen yang terhubung ke host lampiran tentang render mereka sendiri — dan FeatureRecipe tersebut tidak menetapkan readsCallerRenderFacts: true.

Kunci inilah yang menentukan kapan lampiran dirender. Tanpanya, lampiran dirender tepat setelah komponen tempatnya dilampirkan, dan komponen penghubung yang datang belakangan dalam urutan build belum dirender pada saat itu, sehingga apa yang dihasilkannya tidak mungkin ada untuk dibaca. Dengan menolak template sebelum apa pun dirender, deklarasi yang hilang dilaporkan pada field yang Anda tulis, alih-alih menghasilkan build yang template-nya membaca output sebagian pemanggilnya tetapi tidak yang lain.

Pesan yang diemisikan:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (template membaca fakta render pemanggilnya, tetapi FeatureRecipe tidak menetapkan readsCallerRenderFacts)

Referensi dikutip relatif terhadap koneksi tempat referensi itu dibaca — .render_facts, atau .render_facts.<name> — karena template membaca pemanggil satu koneksi demi satu, di dalam {{ range .context.used_by }} atau dari satu koneksi yang dipilihnya. Field menyebutkan blok tempat template ditulis: valuesMapping, workload, atau artifacts[<output-name>]. with: atau when: pada langkah pipeline yang membaca fakta yang sama dilaporkan oleh entri berikutnya, apa pun yang ditetapkan FeatureRecipe, karena menetapkan kunci tersebut tidak akan memungkinkan langkah membacanya. Jika beberapa field membaca fakta tersebut, masing-masing mendapat laporan tersendiri di bawah sebuah baris yang menyebutkan apa yang mereka miliki bersama:

attachment templates reading their callers’ render facts without declaring it (template lampiran yang membaca fakta render pemanggilnya tanpa mendeklarasikannya)

Cara memperbaiki: tetapkan readsCallerRenderFacts: true dalam spec milik FeatureRecipe. Hal itu membuat lampirannya dirender setelah setiap komponen selesai dirender dan tidak mengubah apa pun lainnya tentang apa yang dirender — lihat halaman entitas FeatureRecipe. Kunci itulah kontraknya, dan penghentian ini hanya membantu Anda menemukan template yang jelas membutuhkannya: pemeriksaan membaca template sebagaimana ditulis, sehingga referensi yang dibangun saat template berjalan, atau yang ditulis dalam konten yang diimpor dari file atau pustaka, tidak menghentikan build — tetap tetapkan kunci tersebut pada FeatureRecipe semacam itu. Template yang membaca field bernama render_facts dari daftar lain di samping .context.used_by juga menghentikan build, begitu pula template yang membaca fakta milik host-nya sendiri sebagai .render_facts di dalam {{ with .context }} di sampingnya — tulis fakta milik host sendiri secara lengkap sebagai .context.render_facts, yang tidak pernah dianggap sebagai milik pemanggil; menetapkan kunci tersebut menyelesaikan keduanya tanpa biaya selain render yang lebih belakangan.

FeatureRecipe yang dirender sekali untuk sebuah boundary (executionScope: boundary) tidak diperiksa di sini: template yang menghasilkan sumber dayanya tidak memiliki .context untuk dibaca, dan referensi ke sana ditolak sebagai field di luar daftar izin cakupannya.

Langkah pipeline membaca render facts pemanggilnya

with: atau when: milik sebuah langkah pipeline, dalam FeatureRecipe yang dilampirkan ke sebuah komponen, membaca render_facts di bawah .context.used_by — apa yang dilaporkan oleh komponen-komponen yang terhubung ke host lampiran tentang render mereka sendiri.

Langkah pipeline tidak pernah melihat koneksi tersebut. Sebuah langkah dapat menulis ulang dokumen milik komponen host itu sendiri, dan output milik sebuah komponen tetap sama siapa pun yang terhubung kepadanya, sehingga template sebuah langkah dievaluasi tanpa .context.used_by — untuk setiap FeatureRecipe, baik yang menetapkan readsCallerRenderFacts: true maupun tidak. Kunci tersebut menentukan kapan lampiran di-render, bukan apa yang dilihat sebuah langkah. Karena itu, langkah yang membaca facts pemanggilnya tidak akan membaca apa pun, dan build berhenti sebelum apa pun di-render alih-alih me-render pembacaan itu sebagai nilai kosong.

Pesan yang diemisikan:

pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>) (langkah pipeline membaca render facts pemanggilnya, tetapi langkah pipeline tidak membaca komponen yang terhubung ke host-nya; langkah tersebut hanya membaca render facts milik host itu sendiri)

Referensi dikutip relatif terhadap koneksi tempat referensi itu dibaca — .render_facts, atau .render_facts.<name> — seperti pada entri di atas, dan field menyebut langkah berdasarkan id-nya: pipeline[<step>].with atau pipeline[<step>].when. Jika beberapa langkah membaca facts tersebut, masing-masing mendapat laporan tersendiri di bawah sebuah baris yang menyebut kesamaan mereka:

pipeline steps reading their callers’ render facts (langkah-langkah pipeline yang membaca render facts pemanggilnya)

Cara memperbaiki: dalam sebuah langkah, bacalah render facts milik host itu sendiri di .context.render_facts, ditulis lengkap — facts tersebut berasal dari render host itu sendiri, sehingga membacanya tidak membuat apa pun bergantung pada siapa yang terhubung kepadanya. Sebagai gantinya, bacalah facts pemanggil dalam template yang menghasilkan resource milik lampiran itu sendiri — valuesMapping:, workload: atau artifacts: miliknya — dengan readsCallerRenderFacts: true ditetapkan, seperti dijelaskan halaman entitas FeatureRecipe. Menetapkan kunci itu saja tidak menghilangkan penghentian ini. Pemeriksaan membaca template sebagaimana ditulis, dengan batasan yang dijelaskan entri di atas: referensi yang dibangun saat template berjalan, atau yang ditulis dalam konten yang diimpor dari file atau library, tidak menghentikan build, dan langkah yang membaca field bernama render_facts dari list lain di samping .context.used_by, atau facts milik host-nya sendiri sebagai .render_facts di dalam {{ with .context }} di sampingnya, juga menghentikan build.

FeatureRecipe yang di-render sekali untuk sebuah boundary (executionScope: boundary) tidak diperiksa di sini, dengan alasan yang diberikan entri di atas.

Template membaca render facts targetnya tanpa mendeklarasikannya

Sebuah template dalam FeatureRecipe yang dilampirkan ke sebuah komponen membaca render_facts di bawah .context.uses — apa yang dilaporkan oleh komponen-komponen yang di-wire dari host lampiran tentang render mereka sendiri — dan FeatureRecipe tersebut tidak menetapkan readsTargetRenderFacts: true.

Kunci ini menentukan dua hal. Kunci ini membuat lampiran di-render setelah setiap komponen selesai di-render: tanpanya, lampiran di-render tepat setelah komponen tempat lampiran itu dipasang, dan target yang datang belakangan dalam urutan build belum di-render pada saat itu. Kunci ini juga yang menempatkan facts setiap target pada koneksi yang dibaca lampiran: tanpanya, tidak ada entri .context.uses yang membawa .render_facts sama sekali. Menolak template sebelum apa pun di-render akan melaporkan deklarasi yang hilang pada field yang Anda tulis, alih-alih menghasilkan build yang template-nya tidak membaca apa pun di tempat yang seharusnya berisi facts sebuah target.

Pesan yang diemisikan:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (template membaca render facts dari komponen yang di-wire dari host-nya, tetapi FeatureRecipe tidak menetapkan readsTargetRenderFacts)

Referensi adalah yang ditulis template: di bawah alias satu koneksi secara lengkap — .context.uses.<alias>.render_facts, atau .context.uses.<alias>.render_facts.<name> — atau, jika template membaca koneksi satu per satu, di dalam {{ range .context.uses }}, {{ with .context.uses.<alias> }} atau dari satu koneksi yang dipilihnya, relatif terhadap koneksi itu: .render_facts, atau .render_facts.<name>. Field menyebut blok tempat template ditulis: valuesMapping, workload atau artifacts[<output-name>]. with: atau when: milik sebuah langkah pipeline yang membaca facts yang sama dilaporkan oleh entri berikutnya, apa pun yang ditetapkan FeatureRecipe. Jika beberapa field membaca facts tersebut, masing-masing mendapat laporan tersendiri di bawah sebuah baris yang menyebut kesamaan mereka:

attachment templates reading the render facts of the components their host is wired to, without declaring it (template lampiran yang membaca render facts dari komponen yang di-wire dari host-nya, tanpa mendeklarasikannya)

Cara memperbaiki: tetapkan readsTargetRenderFacts: true dalam spec milik FeatureRecipe — readsCallerRenderFacts: true tidak menghilangkan penghentian ini, karena kunci itu menempatkan facts pada komponen yang terhubung ke host, bukan pada komponen yang di-wire dari host. Kunci tersebut me-render lampirannya setelah setiap komponen selesai di-render dan menempatkan facts setiap target pada koneksinya, dan tidak mengubah hal lain tentang apa yang di-render — lihat halaman entitas FeatureRecipe. Kunci itulah kontraknya, dan penghentian ini hanya membantu Anda menemukan template yang jelas terlihat membutuhkannya: pemeriksaan membaca template sebagaimana ditulis, sehingga referensi yang dibangun saat template berjalan, atau yang ditulis dalam konten yang diimpor dari file atau library, tidak menghentikan build — tetap tetapkan kunci itu pada FeatureRecipe semacam itu. Template yang membaca .context.uses sama sekali dan juga membaca field bernama render_facts dari nilai lain — termasuk facts pemanggil di dalam {{ range .context.used_by }} — juga menghentikan build; tetapkan kunci itu, dan juga readsCallerRenderFacts jika template membaca facts pemanggilnya.

FeatureRecipe yang di-render sekali untuk sebuah boundary (executionScope: boundary) tidak diperiksa di sini, dengan alasan yang diberikan entri tentang pemanggil di atas.

Langkah pipeline membaca render facts targetnya

with: atau when: milik sebuah langkah pipeline, dalam FeatureRecipe yang dilampirkan ke sebuah komponen, membaca render_facts di bawah .context.uses — apa yang dilaporkan oleh komponen-komponen yang di-wire dari host lampiran tentang render mereka sendiri.

Sebuah langkah membaca koneksi yang dibuat host-nya, sebagaimana Recipe milik host itu sendiri membacanya, dan tidak pernah membaca render facts target koneksi tersebut — untuk setiap FeatureRecipe, baik yang menetapkan readsTargetRenderFacts: true maupun tidak. Sebuah langkah dapat menulis ulang dokumen milik komponen host itu sendiri, dan render host itu sendiri membaca apa yang dipublikasikan targetnya, bukan apa yang mereka emit, sehingga template sebuah langkah dievaluasi tanpa facts tersebut. Karena itu, langkah yang membacanya tidak akan membaca apa pun, dan build berhenti sebelum apa pun di-render alih-alih me-render pembacaan itu sebagai nilai kosong.

Pesan yang diemisikan:

pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>) (langkah pipeline membaca render facts dari komponen yang di-wire dari host-nya, tetapi langkah pipeline hanya membaca render facts milik host itu sendiri)

Referensi dikutip seperti pada entri di atas, dan field menyebut langkah berdasarkan id-nya: pipeline[<step>].with atau pipeline[<step>].when. Jika beberapa langkah membaca facts tersebut, masing-masing mendapat laporan tersendiri di bawah sebuah baris yang menyebut kesamaan mereka:

pipeline steps reading the render facts of the components their host is wired to (langkah-langkah pipeline yang membaca render facts dari komponen yang di-wire dari host-nya)

Cara memperbaiki: dalam sebuah langkah, bacalah render facts milik host itu sendiri di .context.render_facts, ditulis lengkap. Sebagai gantinya, bacalah facts target dalam template yang menghasilkan resource milik lampiran itu sendiri — valuesMapping:, workload: atau artifacts: miliknya — dengan readsTargetRenderFacts: true ditetapkan, seperti dijelaskan halaman entitas FeatureRecipe. Menetapkan kunci itu saja tidak menghilangkan penghentian ini. Pemeriksaan membaca template sebagaimana ditulis, dengan batasan yang dijelaskan entri di atas.

FeatureRecipe yang di-render sekali untuk sebuah boundary (executionScope: boundary) tidak diperiksa di sini, dengan alasan yang diberikan entri tentang pemanggil di atas.

Cross-node type safety violation via selector: (Pelanggaran keamanan tipe lintas node)

Satu penghentian mencakup dua ekspresi label yang ditulis oleh penulis katalog untuk membatasi apa yang boleh dihubungkan atau dilampirkan, karena keduanya gagal dengan cara yang sama: sekumpulan label yang tidak memenuhi ekspresi yang dideklarasikan oleh sebuah entitas katalog.

Sebuah edge uses: yang targetnya tidak memenuhi selector: soketnya. Sebuah soket usesSchema mendeklarasikan field selector: yang mengecualikan Component target yang terpasang di ujung lain edge tersebut. Selector adalah cara penulis katalog menyatakan “soket ini hanya menerima target yang labelnya cocok dengan ekspresi ini”; edge yang lolos pencarian nama soket tetapi gagal memenuhi ekspresi selector merupakan pelanggaran keamanan tipe.

Pesan yang diemisikan:

selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (pelanggaran selector: ekspresi yang dideklarasikan pada socket tidak dipenuhi oleh label target. Tambahkan label yang diwajibkan selector ke tipe komponen target, atau hubungkan socket ke komponen yang sudah memiliki label tersebut.)

Sebuah lampiran yang komponennya tidak memenuhi appliesTo: milik Feature. Sebuah Feature mendeklarasikan komponen mana yang dapat dilampirinya, pada appliesTo: dan pada appliesToAnyOf:. Persyaratan dalam ekspresi tunggal berlaku bersama-sama, sedangkan alternatif-alternatifnya berlaku secara alternatif, dengan satu saja di antaranya sudah cukup; kedua permukaan harus terpenuhi, dan permukaan yang dihilangkan oleh Feature dipenuhi oleh apa pun. Lampiran yang komponennya membawa label yang tidak diterima oleh deklarasi Feature merupakan kelas pelanggaran yang sama dengan kasus edge di atas.

Pesan yang diemisikan:

selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (pelanggaran selector: ekspresi yang dideklarasikan oleh Feature tidak dipenuhi oleh label komponen. Tambahkan label yang diwajibkan appliesTo milik Feature ke tipe komponen ini, atau lampirkan Feature yang syarat penerapannya sudah dipenuhi komponen tersebut.)

Salah satu ekspresi juga dapat ditulis dalam bentuk yang sama sekali tidak dapat dibaca oleh tata bahasa label. Hal itu dilaporkan sebagai penghentian yang sama, dengan nilai terakhirnya berupa alasan ekspresi tidak dapat dibaca, bukan sekumpulan label yang tidak memenuhinya — dan itulah yang membedakan ekspresi yang tidak dapat dievaluasi dari ekspresi yang telah dievaluasi dan bernilai salah:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (pelanggaran selector: ekspresi yang dideklarasikan oleh Feature tidak dapat dievaluasi. Perbaiki selector appliesTo pada entitas katalog Feature tersebut.)

Selector socket yang tidak dapat dibaca tata bahasanya juga ditolak sebelum apa pun menghubungkan socket tersebut. aggrega validate, atas seluruh katalog atau atas satu Component atau Feature, membaca setiap selector socket yang dideklarasikan dokumen entitas itu sendiri, dan menolak selector yang tidak dapat dibaca tata bahasanya di bawah kondisi yang sama ini, baik ada maupun tidak ada edge yang dihubungkan melalui socket tersebut:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (pelanggaran selector, dideklarasikan pada sebuah socket, dan tidak dapat dievaluasi. Perbaiki selector pada deklarasi socket di usesSchema milik tipe komponen.)

Pada socket milik Feature, perbaikannya justru menyebut usesSchema milik Feature tersebut. Belum ada yang menghubungkan socket, sehingga kesalahannya ada pada entitas katalog: kesalahan ini dicatat sebagai CATALOG_ERROR dan menyebut file entitas tersebut.

Penghentian ini membawa kunci penulisan yang menjadi pokoknya — entri soket uses:, atau entri features: yang menamai lampiran — beserta file yang mendeklarasikannya, sehingga posisi yang dilaporkannya adalah entri yang Anda sunting, bukan awal dokumen. Component yang ditulis di dalam sebuah subsistem diposisikan pada subsistem tempat ia ditulis, tingkat demi tingkat. Lampiran diposisikan pada entri features: yang menulisnya, di dokumen yang menulisnya, dan dicatat atas nama penulis dokumen tersebut: blok komponen itu sendiri atau blok subsistem di Aggregate, sebagai kesalahan pengembang; dan, untuk lampiran yang hanya dibuat oleh Release, entrinya untuk komponen tersebut atau blok features: dari boundary yang memuat komponen tersebut, sebagai kesalahan operator. Jika kedua dokumen menulis lampiran tersebut, lampiran diposisikan di tempat type-nya dinamai, yang selalu dilakukan oleh Aggregate. Lampiran yang ditulis pada sebuah koneksi diposisikan pada kuncinya di bawah features: koneksi tersebut, di dokumen yang menulisnya — entri koneksi di Aggregate, atau entri per-edge di Release untuk lampiran yang hanya dibuat oleh Release. Feature yang hanya dilampirkan oleh Release ke komponen yang tidak diterima oleh deklarasinya terbaca:

[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.

dan lampiran yang sama yang ditulis pada komponen di Aggregate terbaca [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics. Lampiran yang dihasilkan oleh ekspansi berbasis anotasi tidak ditulis oleh entri features: mana pun, sehingga diposisikan pada kunci features: milik komponen itu sendiri di dokumen yang mendeklarasikan komponen tersebut, sebagai kesalahan pengembang.

Cara memperbaiki pelanggaran edge: arahkan edge uses: ke Component yang labelnya memenuhi selector, atau sesuaikan ekspresi selector di entitas katalog agar menerima kelas target yang dimaksud. Periksa metadata.labels milik Component target dengan aggrega inspect untuk memastikan label mana yang dibawanya.

Cara memperbaiki pelanggaran lampiran: lampirkan Feature ke komponen yang labelnya diterima oleh deklarasinya, atau perluas appliesTo: milik Feature — dengan menambahkan alternatif di bawah appliesToAnyOf: jika Feature memang melayani lebih dari satu kelas komponen. Jika komponen dimaksudkan untuk memenuhi syarat tetapi tidak, bagian yang hilang biasanya berupa label: periksa dengan aggrega inspect dan tambahkan apa yang diminta ekspresi pada metadata.labels milik Component.

Unknown provider (Penyedia tidak dikenal)

Sebuah Recipe mendeklarasikan capability: <name> dengan <name> yang tidak menamai penyedia mana pun yang dilayani compiler. Compiler tidak dapat meneruskan rendering ke penyedia yang tidak pernah dikenalnya.

Pesan yang diemisikan:

unknown provider: <provider-name> (penyedia tidak dikenal)

Cara memperbaiki: pastikan nama penyedia dieja dengan benar — cloudformation, compose, helm, helm-chart, dan terraform adalah nama-nama yang dilayani plugin penyedia bawaan. Jika yang Anda maksud adalah penyedia enterprise kustom, pastikan Plugin perenderan penyedia yang melayani nama tersebut (pluginType: provider dengan nama itu di spec.provider.capabilities-nya) ada di workspace katalog yang menjadi sasaran build.

A capability is served by more than one provider plugin (Sebuah kapabilitas dilayani oleh lebih dari satu plugin penyedia)

Sebuah build mencapai suatu kapabilitas — atau sebuah pull me-resolve-nya — yang dilayani oleh lebih dari satu Plugin perenderan penyedia (pluginType: provider, masing-masing mencantumkan kapabilitas tersebut di spec.provider.capabilities-nya), dan workspace belum memilih mana yang merendernya. Alih-alih memilih penyedia secara sembarang, build berhenti dan menamai kedua kandidat. Katalog yang membawa dua plugin untuk kapabilitas yang sama adalah sah — dua penerbit masing-masing dapat merilis plugin untuk helm atau compose, dan katalog menerima keduanya. Ambiguitas baru muncul pada titik penggunaan: penghentian terjadi saat build atau pull benar-benar mencapai kapabilitas yang dipersengketakan, bukan saat pemuatan.

Pesan yang dikeluarkan. Aturan yang menghentikan build muncul lebih dulu, dan rinciannya — kapabilitas mana, kandidat mana, dan binding yang perlu ditulis — mengikutinya:

capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (kapabilitas dilayani oleh lebih dari satu plugin penyedia; tambahkan entri plugins.providers untuk memilih salah satunya: kapabilitas dilayani oleh lebih dari satu plugin penyedia; tambahkan entri plugins.providers yang memilih salah satunya)

Cara memperbaiki: tambahkan entri plugins.providers di konfigurasi workspace dengan kunci berupa kapabilitas tersebut, yang nilainya memilih identitas plugin yang merendernya. Pertahankan kedua plugin di katalog terfederasi; binding tersebut memberi tahu workspace ini plugin mana yang menjadi tujuan penerusan untuk kapabilitas yang dipersengketakan.

The plugin serving a provider cannot assemble what that provider combines (Plugin yang melayani provider tidak dapat merakit apa yang digabungkan oleh provider tersebut)

Sebuah provider menyatakan apa yang terjadi pada keluaran per node dari sebuah grup dispatch: keluaran setiap node ditulis langsung di jalur dispatch, fragmen-fragmennya dilebur menjadi satu dokumen, atau setiap node ditempatkan pada posisinya sendiri di dalam satu struktur pembungkus. Jika sebuah provider menyatakan bahwa keluarannya digabungkan — file compose yang digabung, chart payung — plugin yang melayaninya harus menyediakan ekspor yang melakukan penggabungan tersebut. Penghentian ini terjadi jika hal itu tidak dipenuhi: plugin mengiklankan rendering per node (render_node) tanpa assemble_boundary yang sesuai, sehingga node-node dalam grup dapat dirender tetapi keluarannya tidak dapat digabungkan.

Kedua sisi ketidaksesuaian itu milik plugin. Apa yang terjadi pada keluaran sebuah grup dispatch merupakan bagian dari apa yang dilaporkan plugin tentang dirinya saat dimuat, dan ekspor yang akan melakukan penggabungan adalah salah satu entri di bawah spec.exports milik entitas Plugin, yang diperiksa silang terhadap laporan yang sama — sehingga penghentian ini menyebut plugin yang mengklaim perakitan yang tidak disediakan oleh permukaan ekspornya.

Build dihentikan alih-alih melewati perakitan. Melewatinya akan menulis fragmen setiap node di jalur tempat satu artefak diharapkan dan melaporkan keberhasilan, dan tidak ada tahap selanjutnya yang dapat membedakan fragmen-fragmen tersebut dari keluaran per node datar yang memang dihasilkan oleh provider yang tidak mengklaim perakitan — sehingga artefak yang hilang baru akan muncul di tempat keluaran diterapkan, bukan pada saat build.

Grup dispatch yang tidak memiliki jalur dispatch dilewati. Keluaran yang ditulis tanpa jalur adalah keluaran per node, sehingga tidak ada yang dirakit di sana untuk diatur oleh klaim tentang penggabungan.

Pesan yang dikeluarkan — satu temuan per grup dispatch yang bermasalah, menyebut provider dan jalur tempat grup tersebut dirakit:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (provider yang diharapkan merakit grup dispatch-nya tidak menyediakan perakit boundary)

Jika lebih dari satu grup dispatch bermasalah, temuan-temuan tersebut muncul bersama di bawah laporan dispatch groups whose provider offers no boundary assembler (grup dispatch yang provider-nya tidak menyediakan perakit boundary).

Cara memperbaiki: layani kapabilitas tersebut dengan plugin yang mengiklankan render_node sekaligus assemble_boundary — lihat ../entities/plugin.md untuk permukaan penulisan spec.exports, dan ../schema/plugins/wasm-provider.md untuk apa yang diterima ekspor perakitan. Jika Anda menulis plugin tersebut, menyelaraskan kedua sisi adalah tanggung jawab Anda: tambahkan ekspor perakitan, atau laporkan tanpa klaim perakitan dan biarkan keluaran setiap node ditulis di jalur dispatch tanpa digabung. Jika Anda menggunakan plugin yang dipublikasikan, pilih versi yang menyediakan kedua ekspor, atau pilih plugin yang provider-nya tidak mengklaim perakitan untuk kapabilitas tersebut.

A boundary-level Feature’s output reaches no assembled file (Keluaran Feature tingkat boundary tidak mencapai berkas rakitan mana pun)

Feature yang dilampirkan di bawah features: sebuah boundary yang FeatureRecipe-nya mendeklarasikan executionScope: boundary dirender sekali untuk seluruh boundary, dan keluarannya masuk ke direktori hasil evaluasi directory: dan subDirectory: milik boundary itu sendiri untuknya. Penyedia yang menggabungkan keluarannya ke dalam satu dokumen — compose ke dalam satu docker-compose.yaml; cloudformation ke dalam satu stack — menulis kontribusi Feature semacam itu hanya sebagai bagian dari berkas yang dirakitnya di sana dari komponen-komponen boundary. Berkas itu hanya ada jika keluaran setidaknya satu komponen mendarat di direktori yang sama di bawah penyedia yang sama.

Berkas itu tidak ada jika komponen-komponen boundary mendarat di tempat lain: ketika komponen berada di boundary bersarang yang subDirectory:-nya mengirimnya ke tempat lain — misalnya "{{ .component_id }}", agar setiap komponen mendapatkan berkasnya sendiri — atau di bawah direktori yang tidak dibagi dengan keluaran Feature. Tidak ada yang dirakit di direktori Feature, sehingga keluarannya tidak akan ditulis ke mana pun — untuk compose bridge, layanan gateway yang tidak dimuat berkas mana pun — dan build akan melaporkan keberhasilan. Sebagai gantinya, build berhenti.

Feature yang penyedianya menulis setiap kontribusi sebagai berkas tersendiri — helm, helm-chart, dan terraform — tidak terpengaruh: berkas-berkas tersebut ditulis terlepas dari ada atau tidaknya sesuatu yang dirakit di sampingnya.

Pesan yang dikeluarkan — satu temuan per Feature yang bermasalah, diposisikan pada entrinya di bawah features: boundary, menyebutkan boundary, Feature, jalur dispatch tujuan perutean keluarannya, dan penyedianya:

boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (keluaran Feature tingkat boundary dirutekan ke jalur dispatch yang tidak merakit apa pun; lampirkan Feature pada boundary yang jalur keluarannya juga menerima komponennya, atau berikan komponen boundary direktori tujuan perutean keluaran Feature)

Compose bridge yang dilampirkan pada boundary induk bridge, yang satu-satunya boundary anaknya menempatkan setiap komponen di bawah subDirectory: "{{ .component_id }}", mencetak:

[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to

Jika lebih dari satu Feature bermasalah, temuan-temuan tersebut tiba bersama di bawah laporan boundary-level Features whose output is routed to a dispatch path nothing assembles.

Cara memperbaiki: jadikan direktori Feature sebagai direktori tempat komponen-komponen boundary-nya juga mendarat. Lampirkan Feature pada boundary yang jalur keluarannya sendiri menerima komponen-komponen tersebut, atau berikan komponen-komponen itu direktori tujuan perutean keluaran Feature — untuk boundary anak, directory: "{{ .parent_boundary.directory }}" tanpa subDirectory: sendiri, sehingga mereka berbagi berkas induk. Pesan menyebutkan direktori tujuan perutean keluaran Feature, dan itulah direktori yang perlu dibagi.

Path-template references a variable outside the allowlist (Templat jalur mereferensikan variabel di luar daftar yang diizinkan)

Templat directory: atau subDirectory: mereferensikan nama variabel yang tidak termasuk dalam daftar variabel templat jalur yang diizinkan — misalnya, salah ketik seperti {{ .parmaeters.region }}, atau field yang ada dalam konteks rendering Recipe tetapi tidak diekspos ke templat jalur (seperti .context.inject atau .values). Penghentian yang sama berlaku untuk {{ .component_id }} dalam templat directory:: variabel tersebut ada, dan templat subDirectory: dapat membacanya, tetapi directory: milik sebuah boundary dievaluasi sekali untuk seluruh boundary, bukan sekali per komponen, sehingga variabel per komponen di sana akan membuat jalur yang dihasilkan bergantung pada komponen mana yang kebetulan dievaluasi lebih dahulu.

Templat jalur divalidasi saat parsing, sebelum pekerjaan rendering apa pun dimulai, terhadap variabel yang didefinisikan oleh konteks templat jalur dikurangi variabel yang ditolak oleh permukaan tertentu. Kompiler juga mengevaluasi templat jalur dengan semantik missingkey=error, sehingga referensi yang diizinkan tetapi tidak terdefinisi saat evaluasi menghasilkan error eksplisit, alih-alih diam-diam merender string kosong ke dalam jalur direktori.

Penghentian ini menyangkut variabel. Kunci yang salah ketik di bawah variabel yang diizinkan — {{ .manifest.recipe_nmae }} — justru melaporkan “Template references a root the render context does not define” (Templat mereferensikan root yang tidak didefinisikan oleh konteks render) di atas, dengan menyebut kunci-kunci yang didefinisikan oleh .manifest, karena variabelnya sendiri diterima dan hanya kuncinya yang salah.

Pesan yang diemisikan:

path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (templat jalur mereferensikan field yang tidak ada dalam daftar terdokumentasi yang diizinkan)

Cara memperbaiki: perbaiki nama field menjadi salah satu yang ada dalam daftar templat jalur yang diizinkan, atau hapus referensinya. Daftar yang diizinkan untuk directory: adalah {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }}, dan {{ .parent_boundary.* }}; subDirectory: menambahkan {{ .component_id }}. Permukaan lain (Recipe valuesMapping, FeatureRecipe injectMapping, dan sebagainya) menggunakan bentuk konteks yang berbeda; referensi ke .context.*, .values, .infra, atau .locals sengaja tidak diekspos ke templat jalur karena pembuatan jalur adalah urusan struktural, bukan urusan rendering nilai.

Path collision: two contributors emit at incompatible paths (Tabrakan jalur: dua kontributor menghasilkan keluaran di jalur yang tidak kompatibel)

Dua boundary yang deklarasi jalurnya dievaluasi menjadi jalur perakitan yang sama dirutekan melalui provider yang berbeda. Keduanya dirakit di sana, dan masing-masing menulis file yang tidak diketahui oleh yang lain, sehingga yang satu diam-diam menggantikan yang lain di disk — dan build yang menghasilkan keluaran yang tergantikan tampak seolah-olah berhasil.

subDirectory: bawaan memberi setiap provider sub-jalurnya sendiri, sehingga dua provider hanya mencapai satu jalur jika deklarasinya ditulis agar dievaluasi sama: misalnya, dua boundary yang berbagi directory: dan sama-sama menetapkan subDirectory: ke literal yang sama.

Pesan yang dikeluarkan. Satu temuan dilaporkan per boundary yang berkontribusi, sehingga setiap boundary yang keluarannya mencapai jalur tersebut disebut tersendiri, alih-alih digabung ke dalam daftar di satu pesan. Kesalahannya adalah dua provider bertemu di satu jalur, sehingga selalu ada setidaknya dua temuan, dan temuan-temuan tersebut muncul bersama di bawah laporan yang menyatakan kesamaannya:

assembly paths reached by more than one provider (jalur perakitan yang dicapai oleh lebih dari satu provider)

Setiap temuan menyebut jalurnya, boundary yang keluarannya mencapai jalur tersebut, dan provider yang dilalui boundary tersebut:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (jalur dispatch menghasilkan keluaran dari beberapa provider)

Build yang boundary api-net dan db-net-nya sama-sama mendeklarasikan directory: ./dist/shared dan subDirectory: merged, yang satu dirutekan melalui helm dan yang lain melalui compose, mencetak:

[OPS_ERROR E0048]
assembly paths reached by more than one provider
caused by (2):
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "db-net", provider "compose")
---
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "api-net", provider "helm")

Laporan memuat kode singkat, dan setiap temuan di bawahnya hanya memuat kategorinya, yang merupakan bentuk yang digunakan setiap laporan kegagalan terkumpul — lihat error-translation.md untuk tata bahasa tersebut.

Cara memperbaiki: berikan setiap boundary directory: yang berbeda (sehingga dirakit ke jalur terpisah), atau biarkan subDirectory: pada nilai bawaannya sehingga keluaran setiap provider ditulis di sub-jalurnya sendiri. Pola compose-bridge sengaja meleburkan dua sub-boundary ke dalam satu jalur perakitan; pola tersebut mengharuskan kedua boundary menargetkan provider yang sama dan membawa anotasi hasil resolusi kaskade yang kompatibel.

Direktori keluaran sebuah boundary bukan direktori di bawah root keluaran

directory: dan subDirectory: sebuah boundary dievaluasi dan digabungkan menjadi direktori tempat keluarannya ditulis, dan path tersebut dibersihkan satu kali: out/a, out//a, ./out/a, dan out/a/ adalah satu direktori. Jika path yang telah dibersihkan bukan direktori di bawah root keluaran, build berhenti sebelum apa pun ditulis. Yang dimaksud adalah path yang naik keluar dari root keluaran (.., ../escape, a/../..), path absolut (/srv/out), atau path yang sama sekali tidak menamai direktori: nilai kosong, atau nilai yang setelah dibersihkan menjadi root keluaran itu sendiri, seperti directory: "." dengan sub-direktori dinonaktifkan.

Path diperiksa sebagaimana hasil evaluasinya, sehingga yang dinilai adalah hasil template, bukan teks yang ditulis. Pesan tersebut menyebutkan field asal kesalahan — directory: jika direktori itu sendiri sudah keluar dari root keluaran atau jika tidak ada sub-direktori yang digabungkan padanya, subDirectory: dalam kasus lain — beserta nilai hasil evaluasi field tersebut dan path yang dihasilkannya.

Pesan yang diemisikan:

boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (direktori keluaran boundary tidak menamai direktori di bawah root keluaran. Tulis direktori di bawah root keluaran, seperti “deploy/prod” — tanpa “/” di awal, tanpa “..” yang naik di atasnya, dan bukan root keluaran itu sendiri)

Jika sub-direktori yang bermasalah, nilai ketiga berbunyi subDirectory: "<value>".

Cara memperbaiki: tulis field yang disebutkan pesan sebagai direktori di bawah root keluaran. Direktori yang dimaksudkan berada di samping root keluaran seharusnya ditempatkan di dalamnya. Untuk menulis keluaran boundary langsung di directory:-nya, tetapkan subDirectory: "." — direktori itu sendiri tetap harus menamai direktorinya sendiri.

Feature tingkat boundary bernama . atau ..

Provider yang memberi setiap kontributor direktorinya sendiri — terraform, di bawah modules/, dan helm-chart, di bawah charts/ — menempatkan Feature yang dilampirkan pada boundary dalam direktori yang dinamai menurut instance saja, di samping komponen-komponen boundary. Kunci features: sebuah boundary menerima . dan .., padahal keduanya bukan nama direktori: . akan menempatkan file Feature di direktori yang memuat semua kontributor, dan .. di direktori di atasnya, sehingga file akan berada di luar posisi yang diberikan provider kepada Feature. Sebagai gantinya, build berhenti. Nama lain tidak terpengaruh, termasuk nama bertitik seperti audit.v2.

Pesan yang diemisikan:

boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (nama instance Feature tingkat boundary bukan nama direktori. Ganti nama instance Feature di bawah features boundary menjadi nama biasa, seperti “audit”)

Cara memperbaiki: ganti nama instance di bawah features: boundary menjadi nama biasa.

Instance-ID collision across boundaries assembling to the same path (Tabrakan ID instance antar-boundary yang dirakit ke path yang sama)

Dua boundary yang dirakit ke tuple per-(path, provider) yang sama menyumbangkan komponen dengan ID instance yang identik. Rakitan gabungan tidak dapat membedakan kedua fragmen komponen tersebut — satu chart Helm tidak dapat memuat dua Deployment bernama web-server, dan satu file docker-compose tidak dapat memuat dua service bernama api.

Pesan yang diemisikan:

multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (beberapa kontributor berbagi ID instance pada dispatch path yang sama: dispatch path provider sudah memuat node (boundary kontributor: ); ID instance komponen harus unik dalam satu grup rakitan)

Cara memperbaiki: ganti nama salah satu komponen yang bertabrakan di dalam Aggregate, atau pisahkan kedua boundary ke path directory: yang berbeda agar setiap instance komponen berada di rakitannya sendiri.

Two contributors write the same output path (Dua kontributor menulis path keluaran yang sama)

Dua kontributor pada satu rakitan menghasilkan file pada path keluaran yang sama. Hal ini berbeda dari tabrakan ID instance di atas: komponen-komponennya bernama berbeda dan rakitan dapat membedakannya — yang mendarat di satu path adalah file yang mereka hasilkan. Hal ini paling sering terjadi jika provider menulis keluaran setiap kontributor berdampingan alih-alih di bawah posisi per komponen, sehingga dua komponen yang Recipes-nya menghasilkan nama file yang sama (misalnya dua entri artifacts: yang sama-sama bernama main.tf) bertemu di satu path. Keluaran assembler itu sendiri juga dapat bertabrakan dengan file kontributor dengan cara yang sama.

Apakah dua kontributor yang menghasilkan satu nama file bertabrakan bergantung pada tempat provider mereka menempatkannya. Provider yang menempatkan setiap kontributor di bawah posisinya sendiri dalam rakitan menjaga dua file bernama sama tetap terpisah; provider yang menulis kontributor berdampingan tidak. Perbandingan dilakukan pada path akhir tempat file akan ditulis, bukan pada nama yang dihasilkan kontributor, sehingga kasus bersarang tidak dilaporkan.

Build berhenti alih-alih menulis salah satu dari kedua file dan membuang yang lain. Tidak ada penyelesaian diam-diam yang benar: mengganti nama atau menambahkan akhiran pada salah satu file akan menciptakan nama yang tidak ditulis siapa pun, dan menggabungkan isinya akan menciptakan dokumen yang tidak ditulis siapa pun. Setiap path yang bertabrakan dilaporkan, dan setiap kontributor yang menulisnya disebutkan, sehingga satu build memberi Anda gambaran utuh alih-alih satu tabrakan setiap kali.

Pesan yang dikeluarkan. Satu temuan dilaporkan per path yang bertabrakan — satu kali, berapa pun banyaknya boundary yang memasok rakitan tempat tabrakan itu terjadi — sehingga build yang kontributornya bertemu di dua path memberi tahu Anda tentang keduanya dan tidak ada tabrakan yang dilaporkan dua kali:

assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (tabrakan keluaran rakitan: dua kontributor menulis path keluaran yang sama)

Setiap kontributor disebut menurut jenisnya, yang menunjukkan tempat namanya ditulis: component <name> untuk instance komponen, feature <name> untuk feature yang dilampirkan pada boundary, dan the <provider> assembly untuk keluaran gabungan rakitan itu sendiri. Kontributor dicantumkan menurut urutan nama, sehingga kalimatnya sama pada setiap build dengan masukan yang sama.

File yang disumbangkan Recipe ke keluaran bersama boundary juga dikenai aturan ini. Blok boundary: sebuah Recipe menulis file-filenya di samping keluaran rakitan provider itu sendiri, satu kali per nama file. Beberapa komponen yang mendeklarasikan satu nama dengan byte identik merupakan satu file dan tidak pernah bertabrakan; mendeklarasikannya dengan byte berbeda menyebabkan tabrakan di sini, dengan menyebutkan file tersebut dan setiap komponen yang mendeklarasikannya, demikian pula nama yang ditulis oleh rakitan provider itu sendiri — misalnya aggrega.modules.tf untuk terraform, yang menyebut the terraform assembly di antara para kontributor. File yang dideklarasikan identik oleh beberapa komponen dan bertemu dengan file rakitan itu sendiri disebut bersama semua komponen tersebut, sebagai component <name-1> and component <name-2>.

Boundary yang memasok rakitan juga disebutkan, dan semuanya dicantumkan alih-alih hanya satu yang ditunjuk. Boundary yang deklarasi directory:-nya dievaluasi sama dirakit sebagai satu, dan tidak ada apa pun pada tabrakan yang menunjukkan di boundary mana kontributor yang bertemu itu dideklarasikan — sehingga temuan memberi Anda setiap boundary yang deklarasinya dapat memisahkan mereka dan tidak menyatakan satu pun di antaranya sebagai penyebab kesalahan. Temuan dilaporkan terhadap dokumen Release secara keseluruhan dengan alasan yang sama: menyebut satu boundary di dalamnya akan mengarahkan Anda ke dokumen yang mungkin sama sekali tidak berkontribusi pada path tersebut.

Jika lebih dari satu path bertabrakan, temuan-temuan tersebut muncul bersama di bawah laporan yang menyatakan kesamaannya:

assembled output paths written by more than one contributor (path keluaran rakitan yang ditulis oleh lebih dari satu kontributor)

Cara memperbaiki: ganti nama file yang dihasilkan di Recipe mana pun yang Anda kendalikan — kunci artifacts:, kunci blok boundary:, atau nama file yang diturunkan oleh terjemahan Workload — agar keduanya tidak lagi bertemu. Jika dua Recipes mendeklarasikan satu file bersama dan memaksudkan konfigurasi yang sama, samakan deklarasinya byte demi byte. Jika kedua kontributor memang termasuk keluaran yang terpisah, beri boundary mereka path directory: yang berbeda agar masing-masing dirakit sendiri.

The same name is derived more than once inside the output (Nama yang sama diturunkan lebih dari sekali di dalam keluaran)

Satu assembly berakhir dengan nama yang sama dipakai dua kali untuk sesuatu di dalam file yang dihasilkannya, di tempat yang hanya muat untuk satu. Hal ini terjadi dengan dua cara: dua kontributor menurunkan nama yang sama, atau output milik satu kontributor sendiri memuat nama itu dua kali. Ini berbeda dari dua tabrakan di atas: bila melibatkan dua kontributor, komponennya bernama berbeda dan file-filenya berada di path yang berbeda, sehingga tidak ada yang salah pada bentuk assembly — yang bermasalah adalah nama di dalam konten, misalnya pengenal yang dipakai target untuk merujuk satu resource, atau nama tempat satu output dipublikasikan agar dirujuk oleh yang lain.

Nama mana yang dibandingkan bergantung pada apa yang dilakukan provider terhadap output sebuah assembly. Bila provider menggabungkan output itu menjadi satu dokumen — satu template stack, satu file compose — nama-nama di dalam dokumen tersebut dibandingkan satu sama lain, dan kontributor yang outputnya ditulis sebagai file-file terpisah miliknya sendiri berada di luarnya. Nama-namanya tidak bertemu dengan nama milik siapa pun, sehingga tidak ada yang menghentikan build di antara keduanya, dan tidak ada yang dapat Anda ganti namanya untuk mengubah hal itu. Bila provider justru menulis output setiap kontributor sebagai file-file miliknya sendiri — hasil render chart, sekumpulan manifest — setiap kontributor dalam assembly dibandingkan dengan setiap kontributor lain, karena nama dalam output semacam itu bersifat unik di seluruh apa pun yang membaca file-file tersebut sebagai satu himpunan, bukan di dalam satu file saja.

Resource milik sebuah FeatureRecipe mengikuti jalur yang sama dengan resource komponen host-nya, karena sebuah attachment berkontribusi pada assembly tempat host-nya berada. Jadi bila provider menggabungkan, nama-nama milik attachment dibandingkan dengan nama milik komponen host-nya dan dengan nama milik setiap attachment lain, persis seperti nama dua komponen dibandingkan: semuanya berakhir di dalam satu dokumen itu, dan salah satu dari dua nama yang sama menggeser yang lain di sana. Bila provider tidak menggabungkan, resource attachment ditulis di bawah direktori yang dinamai menurut komponen tempat attachment itu dipasang, dan nama-namanya tetap dibandingkan dengan setiap kontributor dalam assembly — di situlah identitas resource yang harus unik di seluruh cluster tertangkap. Dengan demikian perbandingannya sama pada keduanya, dan yang berbeda hanyalah di mana nama yang akan tergeser itu berakhir.

Satu sisi dari penghentian ini tidak terpengaruh oleh semua hal di atas: output milik satu kontributor yang memuat sebuah nama dua kali. Itu adalah nama yang dipakai dua kali di dalam output yang ditulis oleh satu kontributor, sehingga build dihentikan di mana pun output itu ditulis, dan dua hal yang perlu dipisahkan selalu berada di dalamnya.

Sebagian besar nama semacam itu adalah milik provider, diturunkan dari instance komponen dan resource-nya, sehingga dua komponen dapat sampai pada satu nama kapan pun bagian-bagian asal penurunannya sama — dan satu komponen dapat sampai pada satu nama dua kali dengan cara yang sama, bila dua resource miliknya dibangun dari bagian-bagian yang sama. Karena nama itu berada di dalam byte file itu sendiri, assembly tidak dapat melihatnya: provider melaporkan nama-nama yang diturunkannya, dan build membandingkannya.

Satu jenis nama adalah milik build sendiri, bukan milik provider, dan dilaporkan dengan cara yang sama: identitas yang dilabelkan pada setiap resource yang dihasilkan sebuah FeatureRecipe, yang sampai ke output Anda sebagai label aggrega.ai/component-id. Nama ini dilaporkan dengan jenis nama component-id, sehingga Anda dapat menemukan string yang sama di output yang Anda hasilkan sendiri. Bila sebuah FeatureRecipe menyintesis resource-nya, identitas itu juga menjadi dasar penamaan resource tersebut; bila FeatureRecipe me-render chart atau fragmen yang disediakan pembuatnya, nama-nama di dalam hasil render itu tetap milik komponen host dan hanya label yang membawa identitas tersebut.

Untuk feature yang dipasang pada sebuah komponen, identitas ini disusun dari komponen tempat feature itu dipasang dan key yang Anda tulis di bawah features:, di belakang awalan tetap. Komponen host menjadi bagian dari nilai karena satu nama feature yang dipasang pada beberapa komponen menghasilkan sekumpulan resource terpisah pada masing-masing komponen, dan setiap kumpulan memerlukan identitasnya sendiri.

Untuk feature yang dipasang pada sebuah boundary, identitas ini disusun dari nama feature dan setiap segmen path boundary, di belakang awalannya sendiri. Kedua tempat itu menyusun, bukan mengganti: karakter yang ditolak oleh alfabet label dituliskan secara eksplisit alih-alih diganti, dan bagian-bagiannya digabungkan dengan rangkaian karakter yang tidak dapat dimuat oleh bagian tertulis mana pun, sehingga dua attachment yang dapat Anda bedakan selalu menghasilkan dua identitas. Satu-satunya sisa masalah adalah panjang: identitas tersusun yang terlalu panjang untuk nilai label dipendekkan di sekitar digest dari keseluruhannya, dan secara prinsip dua identitas yang dipendekkan dapat bertemu. Penghentian ini melaporkan pertemuan semacam itu antara dua kontributor yang namanya dibandingkan, dan dua attachment pada satu komponen adalah dua kontributor semacam itu di mana pun provider host-nya merakit keduanya bersama. Lihat ../providers/well-known-annotations.md untuk cara masing-masing dibangun.

Render Kubernetes melaporkan jenis namanya sendiri: nama yang dibawa setiap resource hasil render-nya di metadata.name. Nama semacam itu harus unik di dalam kind-nya — dan, untuk kind yang disimpan cluster di dalam namespace, di dalam namespace-nya — bukan di seluruh output, sehingga jenis nama menyatakan cakupan mana yang berlaku. Jenis nama ini diawali dengan resource-names lalu memuat kind resource dan namespace tempat resource itu berada, yaitu namespace yang dinyatakan resource itu sendiri atau, bila resource tidak menyatakannya, namespace yang dianotasikan pada boundary. Jadi resource-names:Service--default adalah nama-nama Service yang berada di default. Kind yang disimpan API Kubernetes di luar semua namespace — ClusterRole, StorageClass, CustomResourceDefinition — serta kind kustom yang dideklarasikan oleh sebuah CustomResourceDefinition dalam render yang sama dengan cakupan Cluster, hanya memuat kind-nya saja, apa pun namespace yang ditulis dokumennya: resource-names:ClusterRole adalah nama-nama setiap ClusterRole yang dimuat output. Apa pun di luar huruf dan angka dituliskan secara eksplisit alih-alih diganti, dan kedua bagian digabungkan dengan rangkaian karakter yang tidak dapat dimuat oleh bagian tertulis mana pun, sehingga dua pasangan yang berbeda tidak pernah menghasilkan satu jenis nama, dan sebuah kind saja tidak pernah menghasilkan jenis nama dari sebuah kind dan namespace. Sebuah Service dan sebuah Deployment boleh berbagi nama, dan dua namespace menyimpan satu nama dari kind ber-namespace secara terpisah, sehingga keduanya tidak menghentikan build. Nama itu sendiri dilaporkan persis seperti yang ditulis chart Anda, sehingga itulah string yang perlu dicari di template Anda.

Jadi dua kontributor pada satu output yang masing-masing menulis satu objek tingkat cluster dengan satu nama akan menghentikan build meskipun Release menempatkan keduanya di dua namespace, karena menerapkan keduanya menulis objek yang sama itu dua kali; dan satu chart yang menulis objek semacam itu di bawah dua namespace berbeda, yang dihasilkan render sebagai dua file, menghentikan build sebagai satu kontributor yang memuat nama itu dua kali. Kind yang tidak diklasifikasikan oleh apa pun dalam render — kind kustom yang CustomResourceDefinition-nya tidak dihasilkan render, atau dokumen yang tidak menyebutkan apiVersion — dibandingkan di dalam namespace-nya, seperti kind ber-namespace, karena tidak ada apa pun dalam render yang menyatakan bahwa cluster menyimpannya di luar namespace; dua kontributor yang menulis satu objek semacam itu di dua namespace karenanya tidak bertemu.

Nama dibandingkan di antara kontributor pada satu output, dan tidak pernah antara dua output. Dua boundary merupakan dua output bila masing-masing memiliki direktori sendiri — yang dinyatakannya, atau yang diberikan kepada setiap boundary yang tidak menyatakan directory: — dan tidak ada apa pun dalam build yang menyatakan apakah dua output diterapkan ke satu cluster atau ke dua cluster: CustomResourceDefinition milik satu operator yang dikirim ke masing-masing dari dua cluster adalah nama yang sama dalam dua output, dan itu benar. Jadi dua boundary yang masing-masing menulis satu objek tingkat cluster dengan satu nama tetap berhasil di-build meskipun keduanya diterapkan ke satu cluster; bila memang demikian, hasilkan objek itu dari salah satunya saja.

Susunan yang paling sering mencapai penghentian ini adalah dua Features yang dilampirkan pada satu komponen, masing-masing mengirimkan chart yang disediakan pembuatnya. Kedua chart dirender terhadap nama rilis yang sama — milik komponen host, sehingga melampirkan sebuah chart tidak mengganti nama sumber daya yang sudah dideklarasikan dan di-deploy oleh pembuatnya — dan menamai sumber daya berdasarkan nama rilis termasuk hal yang paling umum dilakukan sebuah chart. Tidak ada yang salah pada bentuk keluaran: kedua sumber daya itu hanya membawa satu nama. Jika provider komponen menulis dokumen terpisah, setiap lampiran menulis di bawah direktorinya sendiri dan menerapkan keduanya menyisakan mana pun yang diterapkan terakhir; jika provider melipat kelompoknya ke dalam satu dokumen, kedua lampiran berkontribusi pada dokumen itu dan salah satu dari kedua nama menggantikan yang lain di dalamnya. Ganti nama sumber daya dalam chart yang Anda kendalikan, atau berikan nama yang membawa sesuatu yang membedakan kedua lampiran — dan lampiranlah yang harus sampai ke templat, karena kedua chart dirender terhadap nama rilis host, sehingga mengganti nama lampiran saja tidak mengubah apa pun. Teruskan .attachment_name ke dalam chart melalui valuesMapping: milik FeatureRecipe, dan tetapkan pada nilai chart mana pun yang menjadi dasar pembentukan nama sumber dayanya.

Susunan kedua mencapai penghentian yang sama dengan satu Feature, bukan dua: sebuah chart yang templatnya menulis nama sumber daya sebagai literal, dilampirkan pada dua komponen. Setiap host merendernya dengan nama rilisnya sendiri, sehingga literal itu satu-satunya alasan kedua salinan membawa satu nama — namai sumber daya berdasarkan .Release.Name dan host kembali masuk ke dalamnya, yang memang sudah dilakukan oleh chart yang membentuk nama sumber dayanya dari identitas rilisnya.

Susunan ketiga memiliki bentuk yang sama satu permukaan penulisan lebih dalam: sebuah FeatureRecipe yang mengirimkan sumber dayanya melalui artifacts: alih-alih melalui chart, dilampirkan dengan satu nama pada dua komponen, yang badannya menulis nama sumber daya sebagai literal. Keluaran setiap lampiran ditempatkan di bawah direktori yang menamai host-nya, sehingga path yang dihasilkan berbeda dan tidak ada yang salah pada bentuk keluaran — tetapi kedua badan membawa nama yang sama, dan menerapkan keduanya menyisakan mana pun yang diterapkan terakhir. Nama dalam badan artifacts dibandingkan persis seperti nama yang dirender sebuah chart: keduanya mendeskripsikan sumber daya yang sama dalam kluster yang sama, sehingga asal nama tidak berpengaruh pada apa yang terjadi saat keduanya diterapkan. Pembacaan itu bergantung pada kedua nama dibaca bersama, yang terjadi jika provider menulis keluaran setiap kontributor sebagai berkas yang dibaca target sebagai satu himpunan. Jika provider justru menggabungkan keluaran sebuah perakitan ke dalam satu dokumen, berkas setiap lampiran berada di luar dokumen itu dan nama di dalam salah satunya tercakup pada berkas tersebut, sehingga dua lampiran seperti itu tidak pernah bertemu dan build berlanjut.

Tidak setiap nama dilaporkan, sehingga build yang tidak berhenti belum memastikan bahwa setiap nama yang pada akhirnya akan dibawa keluarannya telah dibandingkan. Sumber daya yang penamaannya diserahkan kepada kluster — yang mendeklarasikan generateName alih-alih name — belum membawa nama, sehingga tidak ada yang dilaporkan. Dan nama yang ditulis ke dalam bidang lain untuk dibaca controller kemudian bukanlah nama sumber daya, sehingga tidak ada yang membandingkannya. Kedua batas ini adalah sifat dari pembacaan dokumen yang dihasilkan, sehingga keduanya berlaku pada badan artifacts persis seperti pada templat chart yang dirender.

Badan artifacts: adalah templat, sehingga nama di dalamnya yang harus berbeda per host disusun, bukan ditulis sebagai literal. .context.rendered_name adalah nama yang diberikan provider komponen host itu sendiri — di bawah helm, nama rilisnya, dieja dengan karakter yang diizinkan untuk nama Kubernetes — dan .attachment_name adalah kunci tempat Anda melampirkannya, sehingga {{ .context.rendered_name }}-{{ .attachment_name }} memberi sumber daya nama tersendiri pada setiap host dan di bawah setiap lampiran. Pada host yang provider-nya tidak melaporkan nama seperti itu, susunlah dari .context.instance_id, identitas host, sebagai gantinya. Satu badan yang ditulis sampai ke setiap host tempat ia dilampirkan dengan membawa nama apa pun yang ada di dalamnya, dan sebuah literal sama di semuanya — jadi berikan bentuk itu pada nama yang harus unik dalam kluster.

Makna sebuah nama sama sekali tidak ditafsirkan — dua nama yang dilaporkan entah teksnya sama atau tidak — itulah sebabnya laporan yang sama mencakup setiap jenis nama, siapa pun yang menurunkannya.

Sebuah nama dapat muncul di lebih dari satu laporan untuk satu komponen, karena setiap bagian komponen dilaporkan saat dirender. Itu adalah satu sumber daya yang dinamai di setiap laporan tempatnya berada, bukan nama yang digunakan dua kali, dan tidak menghentikan build. Yang menghentikan adalah satu laporan yang membawa satu nama dua kali, karena laporan itu mendeskripsikan keluaran tempat nama tersebut benar-benar digunakan dua kali.

Pembacaan itu bergantung pada apa yang dihitung sebagai satu kontributor, dan untuk jenis component-id jawabannya adalah lampiran, bukan komponen atau boundary tempatnya berada. Sebuah lampiran diidentifikasi oleh kedua koordinat yang Anda tulis untuknya — komponen tempatnya dilampirkan beserta kunci di bawah features:, atau path boundary beserta nama pada boundary itu — sehingga dua lampiran pada satu komponen adalah dua kontributor, persis seperti dua lampiran pada komponen berbeda, dan satu nama feature yang ditulis pada dua boundary adalah dua kontributor meskipun namanya sama di masing-masing. Menjadi dua kontributor itulah yang membuat identitas mereka dapat dibandingkan dalam setiap susunan tersebut; apakah dua di antaranya dibandingkan sama sekali mengikuti aturan yang sama dengan setiap nama lain di sini, sehingga jika provider menggabungkan, lampiran yang keluarannya ditulis sebagai berkas terpisah miliknya sendiri berada di luar dokumen gabungan dan hanya dibandingkan dengan dirinya sendiri. Karena itu dua lampiran yang mencapai satu identitas menghentikan build di mana pun keluaran mereka dapat saling menjangkau, dan setiap temuan menyebut kedua koordinatnya agar Anda dapat mengetahui dua hal mana yang harus dipisahkan. Karena kedua koordinat merupakan bagian dari nilai yang disusun, dua lampiran yang dapat Anda bedakan mencapai dua identitas pada panjang berapa pun yang muat — sehingga susunan yang mencapai penghentian ini adalah susunan tempat nilai yang terlalu panjang untuk targetnya dipendekkan dan dua nilai yang dipendekkan bertemu. Jika dua identitas yang dipendekkan bertemu dan keluaran mereka tidak dapat saling menjangkau — dua lampiran pada satu komponen, di bawah provider yang menggabungkan, masing-masing ditulis sebagai berkas terpisah miliknya sendiri — tidak ada yang membandingkannya, dan kedua himpunan sumber daya membawa satu aggrega.ai/component-id di antara mereka.

Satu susunan layak dinyatakan secara eksplisit karena tampak seharusnya berhenti padahal tidak: melampirkan sebuah feature dengan nama yang sama pada dua komponen sepenuhnya didukung, dan tidak memerlukan penggantian nama. Komponen merupakan bagian dari nilai yang disusun, sehingga metrics pada api dan metrics pada web mencapai dua identitas dan sumber daya setiap komponen mendapatkan identitasnya sendiri — yang penting karena cascade yang secara desain mencetak satu nama lampiran di banyak komponen tidak menyisakan nama lain bagi pembuat untuk ditulis. Setiap cara FeatureRecipe mengirimkan sumber daya menempatkan identitasnya pada apa yang dihasilkannya, termasuk cara yang hanya melakukan vendoring sebuah sumber dan merendernya apa adanya, sehingga setiap cara itu dibandingkan; feature yang FeatureRecipe-nya tidak menghasilkan apa pun tidak memiliki apa pun untuk dibandingkan.

Build berhenti alih-alih mempertahankan satu dan membuang yang lain. Tidak ada penyelesaian diam-diam yang benar: mempertahankan yang pertama akan membuang sumber daya yang Anda deklarasikan sepenuhnya dari keluaran dan membiarkan build melaporkan keberhasilan, dan apa pun yang mereferensikan sumber daya yang dibuang akan diam-diam terselesaikan ke sumber daya yang tersisa. Setiap nama yang bertabrakan dilaporkan, masing-masing dengan jenis namanya dan dengan setiap kontributor yang menurunkannya disebutkan — sehingga satu build memberi Anda gambaran utuh, bukan satu tabrakan pada satu waktu. Kontributor yang keluarannya sendiri membawa nama itu dua kali disebut sebagai telah menurunkan nama tersebut lebih dari sekali, yang memberi tahu Anda bahwa dua hal yang harus dipisahkan berada di dalam satu komponen itu, bukan di antara dua komponen.

Pesan yang dikeluarkan. Satu temuan dilaporkan per kontributor per nama yang bertabrakan, sehingga setiap kontributor yang menurunkan nama tersebut disebut tersendiri, bukan digabungkan ke dalam daftar di dalam satu pesan. Jika dua kontributor menurunkan nama tersebut, terdapat setidaknya dua temuan, dan keduanya tiba bersama di bawah laporan yang menyatakan kesamaannya:

dispatch groups whose contributors derive one name more than once in one key space (grup dispatch yang kontributornya menurunkan satu nama lebih dari sekali dalam satu ruang kunci)

Setiap temuan menyebutkan nama tersebut, jenis namanya, kontributor yang menurunkannya, serta provider dan path dari rakitan tempat output mereka digabungkan:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (tabrakan nama turunan: satu nama diturunkan lebih dari sekali dalam satu ruang kunci (ruang kunci, diturunkan oleh komponen, provider, path dispatch))

Kontributor disebut sesuai jenisnya, yang menunjukkan di mana namanya ditulis: derived by component untuk instans komponen, dan derived by feature untuk fitur yang dilampirkan pada sebuah boundary.

Jika nama kontributor itu sendiri tidak mengidentifikasinya, koordinat kedua menyusul, dan koordinat mana yang dipakai bergantung pada jenisnya. Fitur yang dilampirkan pada sebuah boundary membawa path boundary tersebut, karena satu nama fitur dapat ditulis di lebih dari satu boundary:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (tabrakan nama turunan: satu nama diturunkan lebih dari sekali dalam satu ruang kunci (ruang kunci, diturunkan oleh fitur, dilampirkan pada boundary, provider, path dispatch))

Sebuah komponen membawa kunci lampiran yang render-nya menurunkan nama tersebut, karena sebuah komponen membawa satu lampiran per kunci yang Anda tulis:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (tabrakan nama turunan: satu nama diturunkan lebih dari sekali dalam satu ruang kunci (ruang kunci, diturunkan oleh komponen, membawa lampiran, provider, path dispatch))

Rendering milik komponen itu sendiri — nama yang diturunkan provider-nya untuk komponen itu sendiri, bukan untuk salah satu lampirannya — tidak membawa koordinat kedua, sehingga temuan berakhir pada nama komponen.

Jika output milik satu kontributor membawa nama tersebut dua kali, kontributor itu adalah satu-satunya temuan, sehingga temuan tiba sendiri tanpa laporan di atasnya — dan kontributor itu disebut telah menurunkan nama tersebut lebih dari sekali, bukan telah bertemu kontributor lain:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (tabrakan nama turunan: satu nama diturunkan lebih dari sekali dalam satu ruang kunci (ruang kunci, diturunkan lebih dari sekali oleh komponen, provider, path dispatch))

Koordinat kedua mengikuti kontributor di sini dengan ketentuan yang sama seperti di atas, sehingga pengulangan di dalam output milik satu lampiran menyebut lampiran tersebut, bukan hanya komponen yang membawanya.

Cara memperbaiki: jika dua kontributor disebut, ganti nama salah satunya di Aggregate, sehingga nama yang diturunkan darinya tidak lagi sama dengan milik yang lain. Jika jenis namanya component-id, setiap temuan sudah menyebut hal yang perlu diganti namanya: carrying attachment "…" adalah kunci di bawah blok features: komponen tersebut, dan feature "…" attached at boundary "…" adalah nama di bawah blok features: boundary tersebut. Jika kedua temuan hanya berbeda pada boundary yang disebutnya, kedua lampiran membawa satu nama di dua boundary — ganti nama salah satunya, atau berikan kedua boundary path directory: yang berbeda agar output-nya tidak lagi digabungkan. Jika kedua nama adalah nama yang disusun oleh build, keduanya hanya mungkin bertemu setelah dipendekkan agar sesuai dengan target, jadi pendekkan sendiri bagian-bagian penyusunnya alih-alih menyerahkannya kepada build. Jika kedua nama diturunkan dari sesuatu yang Anda tetapkan secara eksplisit — nilai yang diberikan Recipe kepada provider, atau anotasi yang dibaca provider — ubahlah hal itu pada mana pun dari keduanya yang Anda kendalikan. Jika kedua kontributor memang termasuk output yang terpisah, berikan boundary-nya path directory: yang berbeda agar masing-masing dirakit sendiri dan kedua nama tidak pernah bertemu. Jika satu kontributor disebut telah menurunkan nama tersebut lebih dari sekali, kedua hal yang bertabrakan berada di dalam satu komponen itu: temukan dua resource yang dihasilkan Recipe-nya yang namanya sama, lalu ubah dasar penamaan salah satunya — kunci tempat ia dideklarasikan, atau nilai yang menyusunnya — agar provider menurunkan nama yang berbeda untuk masing-masing. Jika jenis namanya adalah jenis cakupan kluster tersendiri, seperti resource-names:ClusterRole, dokumen-dokumen yang disebut mendeskripsikan satu objek dalam kluster di namespace mana pun dokumen itu ditempatkan: keluarkan objek itu dari satu kontributor saja — melalui nilai yang ditawarkan chart-nya, seperti sakelar untuk memasang definisinya — atau, jika keduanya dimaksudkan sebagai dua objek, berikan salah satunya nama tersendiri di chart atau body yang Anda kendalikan; satu kontributor yang disebut dua kali untuknya menulisnya di bawah dua namespace, dan salah satu dari kedua dokumen itulah yang perlu dihapus.

An authored export name is one the build derives for a cross-stack reference (Nama ekspor yang ditulis adalah nama yang diturunkan build untuk referensi lintas stack)

Blok Outputs: dari Recipe cloudformation adalah CloudFormation yang ditulis oleh penulis, dan sebuah entri di dalamnya dapat membawa Export: miliknya sendiri dengan sebuah Name:; nama tersebut mencapai stack yang dirakit persis seperti yang ditulis. Secara terpisah, ketika sebuah edge uses melintas dari satu batas ke batas lain, provider memublikasikan nilai yang dikonsumsi sebagai Output stack dengan sebuah Export di bawah nama yang diturunkannya dari release, batas, komponen, dan kunci yang disediakan. Penghentian ini terjadi ketika keduanya bertemu: nama yang Anda tulis adalah nama yang dihasilkan oleh penurunan untuk build yang sama, sehingga stack akan mendeklarasikan satu nama ekspor dua kali dari dua tempat, padahal nama ekspor harus unik.

Hanya kebetulan tersebut yang menghentikan build. Mendeklarasikan nama ekspor pada entri Outputs didukung, dan nama yang tidak cocok dengan nama turunan mana pun dipublikasikan bersama nama-nama turunan tanpa komentar — pada setiap entri kecuali output stack tempat referensi lintas stack memublikasikan ekspornya sendiri, untuk kunci yang dikonsumsinya. Export: di sana menghentikan build kecuali membawa persis nama turunan; kasus tersebut adalah The output a cross-stack reference publishes on already carries an Export (Output tempat referensi lintas stack memublikasikan sudah membawa Export).

Penghentian ini memberikan nama ekspor turunan beserta empat bagian yang membentuknya, sehingga Anda dapat melihat referensi lintas batas mana yang menghasilkannya, dan menyebutkan output stack tempat deklarasi Anda berada — ditandai sebagai nama yang dirakit provider, bukan nama yang ditulis sebuah Recipe, karena provider membangun nama tersebut dengan mengodekan komponen dan entri ke dalam huruf dan angka yang diizinkan oleh logical ID, sehingga nama itu bukan string yang ditulis untuk keduanya. Nama ekspor adalah bagian yang perlu dicari. Entri Anda mengejanya persis seperti yang dilakukan penghentian ini, itulah yang membuat keduanya bertabrakan, sehingga nama itu adalah satu-satunya string yang muncul baik dalam pesan maupun dalam berkas Anda sendiri.

Perbandingan ini dibatasi pada satu stack: nama-nama ekspor yang dideklarasikan stack tersebut, terhadap nama-nama yang diturunkan untuk referensi lintas batas yang memublikasikan ke dalamnya. Dua stack tidak dibandingkan satu sama lain, dan nama ekspor yang ditulis sebagai intrinsic CloudFormation di-resolve pada saat deploy, sehingga tidak ada nama untuk dibandingkan. Benturan sebuah nama dengan ekspor yang sudah di-deploy ke dalam akun dan region adalah sifat dari deployment, yang tidak diamati oleh build.

Pesan yang dikeluarkan. Kondisi menyebutkan jenis kegagalan dan kalimat provider sendiri menyatakan apa yang terjadi; laporan di sekitarnya juga menyebutkan edge uses yang sedang dihubungkan:

two things a plugin produced occupy one name in its output (dua hal yang dihasilkan sebuah plugin menempati satu nama dalam output-nya) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (nama ekspor yang diturunkan tautan lintas batas sudah dideklarasikan oleh entri Outputs lain dalam stack yang sama: tautan menurunkan nama ekspor untuk kunci provides dari komponen dalam batas dari Release, dan entri Outputs lain dari stack yang sama sudah mendeklarasikan nama ekspor yang sama — deklarasi tersebut berada di bawah output stack, nama yang dirakit provider ini, bukan nama yang ditulis sebuah Recipe; setiap entri Outputs yang membayangi mengeja nama ekspornya persis seperti penghentian ini, sehingga mencari nama tersebut di Recipes Anda akan menemukan entrinya — ganti nama ekspor yang dideklarasikan entri tersebut, atau hapus blok Export entri tersebut dan biarkan tautan memublikasikan ekspornya)

Cara memperbaiki: cari di Recipes Anda nama ekspor yang disebutkan penghentian ini — entri Outputs yang mendeklarasikannya mengejanya secara identik — lalu ganti nama ekspor tersebut agar tidak lagi cocok, atau hapus blok Export: entri tersebut dan biarkan penghubungan lintas stack memublikasikan ekspornya sendiri. Menghapusnya biasanya merupakan langkah yang tepat jika entri tersebut ada untuk mengekspor nilai yang sama yang dikonsumsi edge: provider tetap memublikasikan Export untuk nilai itu, sehingga ekspor yang ditulis tidak menambahkan apa pun. Pertahankan Export: yang ditulis dan ganti namanya jika entri tersebut mengekspor nilai untuk konsumen lain yang mengimpornya dengan nama yang Anda pilih.

The output a cross-stack reference publishes on already carries an Export (Output tempat referensi lintas stack memublikasikan sudah membawa Export)

Ketika sebuah edge uses melintas dari satu batas ke batas lain, provider memublikasikan Export nilai yang dikonsumsi pada output stack yang dirakitnya untuk komponen penghasil dan kunci yang disediakan — output yang sama yang dicapai Recipe cloudformation ketika blok Outputs:-nya menulis entri di bawah kunci tersebut. Export: yang sudah ada pada output itu hanya dipertahankan jika Name:-nya persis nama yang diturunkan provider: itulah ekspor yang sudah dipublikasikan oleh referensi lintas stack sebelumnya ke nilai yang sama, sehingga setiap konsumen mengimpor satu nama. Export: lain apa pun di sana menghentikan build, karena menulis ekspor provider akan menimpa apa yang Anda tulis, dan mempertahankan milik Anda akan membuat setiap konsumen mengimpor nama yang tidak pernah dipublikasikan referensi tersebut.

Penghentian ini terjadi pada empat bentuk Export: pada output tersebut:

  • Name: yang merupakan string berbeda;
  • Name: yang ditulis sebagai intrinsic CloudFormation, yang di-resolve pada saat deploy, sehingga provider tidak dapat membaca apa yang dieja olehnya;
  • blok Export: yang tidak menyebutkan apa pun;
  • Export: yang ditulis sebagai nilai biasa, bukan sebagai blok.

Nama ekspor yang Anda deklarasikan pada entri Outputs lain mana pun dibandingkan secara terpisah, di bawah An authored export name is one the build derives for a cross-stack reference (Nama ekspor yang ditulis adalah nama yang diturunkan build untuk referensi lintas stack).

Pesan yang dikeluarkan. Kondisi menyebutkan jenis kegagalan dan kalimat provider sendiri menyatakan apa yang terjadi; laporan di sekitarnya juga menyebutkan edge uses yang sedang dihubungkan:

two things a plugin produced occupy one name in its output (dua hal yang dihasilkan sebuah plugin menempati satu nama dalam output-nya) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (output stack tempat tautan lintas batas memublikasikan ekspornya sudah membawa Export yang tidak ditulis tautan tersebut: tautan menurunkan nama ekspor untuk kunci provides dari komponen dalam batas dari Release, dan output stack yang dirakit provider ini untuk kunci dan komponen tersebut; hapus blok Export entri tersebut dan biarkan tautan memublikasikan ekspor yang diimpor setiap konsumen)

<what-it-found> adalah salah satu dari berikut, sesuai urutan bentuk di atas:

already declares the export name <name> (sudah mendeklarasikan nama ekspor) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (sudah mendeklarasikan nama ekspor yang bukan string — diberikan sebagai intrinsic, yang di-resolve pada saat deploy, sehingga provider ini tidak dapat membaca apa yang dieja olehnya) already carries an Export block declaring no export name (sudah membawa blok Export yang tidak mendeklarasikan nama ekspor) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (sudah membawa Export yang bukan blok, padahal CloudFormation mengharapkan blok yang membawa Name)

Cara memperbaiki: dalam Recipe dari komponen yang disebutkan penghentian ini, temukan entri Outputs yang ditulis di bawah kunci yang disediakan yang disebutkannya, dan hapus blok Export: entri tersebut — penghubungan lintas stack kemudian memublikasikan ekspor yang diimpor setiap konsumen. Jika Anda juga memerlukan nilai tersebut diekspor dengan nama Anda sendiri, untuk konsumen di luar build ini, tulis Export: tersebut pada entri Outputs di bawah kunci yang berbeda: nama ekspor di sana didukung, selama bukan nama yang diturunkan build.

Chart-name mismatch on a merged helm-chart umbrella (Ketidakcocokan nama chart pada umbrella helm-chart yang digabungkan)

Dua boundary atau lebih berkontribusi ke jalur assembly provider helm-chart yang sama, tetapi anotasi aggrega.ai/chart-name efektif mereka (yang di-resolve melalui kaskade anotasi boundary) tidak sama. Sebuah umbrella chart Helm memiliki tepat satu nama chart; renderer tidak dapat memilih salah satu kandidat yang saling bertentangan.

Pesan yang dikeluarkan. Satu temuan dilaporkan untuk setiap boundary yang berkontribusi, masing-masing membawa nilai hasil resolve boundary tersebut, sehingga nama-nama yang berbeda muncul satu per temuan, bukan sebagai satu kumpulan yang dicetak. Laporan yang menaungi temuan-temuan tersebut menyatakan kesamaan mereka:

merged dispatch groups whose boundaries disagree on the assembly name (grup dispatch tergabung yang boundary-nya tidak sepakat mengenai nama assembly)

Setiap temuan menyebutkan nilai hasil resolve boundary tersebut, anotasi tempat nilai itu dibaca, boundary-nya, provider-nya, dan jalur tempat semuanya digabungkan:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (assembly jalur tergabung memiliki nilai anotasi nama assembly yang saling bertentangan)

Cara memperbaiki: deklarasikan anotasi aggrega.ai/chart-name yang sama pada setiap boundary yang berkontribusi (mekanisme kaskade membuat hal ini DRY ketika para kontributor berbagi boundary induk — cukup deklarasikan sekali pada induknya), atau pisahkan boundary-boundary tersebut ke jalur directory: yang berbeda sehingga masing-masing mendapatkan umbrella chart sendiri.

FeatureRecipe template references a field outside its scope’s allowlist (Templat FeatureRecipe mereferensikan field di luar allowlist cakupannya)

Sebuah FeatureRecipe dengan executionScope: boundary mereferensikan field yang hanya berlaku per komponen seperti .context.instance_id, .context.inject, atau .context.uses — field yang tidak memiliki nilai bermakna pada cakupan boundary — dalam template yang berjalan sekali untuk boundary: locals:, provides:, valuesMapping:, artifacts: miliknya, atau with: maupun when: sebuah langkah pipeline. Kondisi sebaliknya juga berlaku: FeatureRecipe bercakupan komponen (bawaan) yang mereferensikan field .boundary.* gagal pada validator yang sama. Validasi dijalankan saat parsing terhadap allowlist field cakupan yang bersangkutan sebelum pekerjaan rendering apa pun dimulai. injectMapping milik FeatureRecipe bercakupan boundary tidak diperiksa di sini: ia berjalan sekali untuk setiap komponen yang dijangkau lampiran, dalam konteks komponen tersebut, sehingga ia membaca .context.*, dan referensi ke .boundary di dalamnya dilaporkan oleh “Template references a root the render context does not define (Template mereferensikan root yang tidak didefinisikan oleh konteks render)” di atas.

Pesan yang diemisikan:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (templat FeatureRecipe dengan executionScope: boundary mereferensikan field yang hanya berlaku per komponen)

FeatureRecipe bercakupan boundary yang valuesMapping-nya membaca .context.instance_id mencetak:

[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")

Cara memperbaiki: tulis ulang template dengan bidang yang tersedia di cakupan tersebut, atau ubah executionScope milik FeatureRecipe. FeatureRecipes cakupan boundary mereferensikan .boundary.path, .boundary.boundary_name, .boundary.components, koleksi .boundary.*_uses_edges, .boundary.labels, .boundary.annotations, dan .boundary.feature_attachments. FeatureRecipes cakupan Component mereferensikan .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Kedua cakupan sama-sama memiliki .values, .infra, .locals, .provides, .steps, dan .metadata. Parameter Release bukan pilar tersendiri pada permukaan ini — parameter tersebut mencapai template FeatureRecipe melalui entri values atau infra yang mereferensikannya.

Self-inject value template references cross-node data (Templat nilai self-inject mereferensikan data lintas node)

Templat value: pada inject: tingkat komponen mengambil data dari .context.inject atau .context.uses. Pipa inject adalah hal yang sedang dibangun oleh tahap ini — templat di dalam nilai self-inject milik komponen itu sendiri tidak dapat membaca darinya.

Penyebabnya adalah .context pada permukaan ini: ia memuat instance_id, labels dan annotations, dan tidak ada yang lain. Karena itu, .context.inject dan .context.uses adalah kunci yang tidak didefinisikan oleh context permukaan ini, dan referensinya terhenti sebagai “Template references a root the render context does not define (Templat mereferensikan root yang tidak didefinisikan oleh konteks render)” di atas, saat parsing, sebelum apa pun di-render. Diagnostiknya menyebutkan mekanisme dan kunci pengiriman tempat templat itu berada, serta mencantumkan kunci-kunci yang memang didefinisikan oleh .context di sini — sehingga laporan yang sama mencakup upaya nyata untuk menjangkau data lintas node maupun salah ketik biasa seperti {{ .context.nmae }}, yang merupakan kesalahan yang lebih umum dan jika tidak demikian akan di-render sebagai kosong.

Pesan yang dikeluarkan — detail tingkat referensi; laporan yang menaunginya juga menyebutkan node, mekanisme, dan kunci pengirimannya:

template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (templat mereferensikan root yang tidak didefinisikan oleh konteks render)

Setiap frame dalam laporan berada di domain developer, karena blok inject: tingkat komponen ditulis di dalam Aggregate.

Cara memperbaiki: pindahkan penghubungan lintas komponen ke entri uses[].inject — di sanalah konteks lintas node tersedia. Batasi templat value: self-inject tingkat komponen hanya pada values dan infra milik komponen itu sendiri, .context.instance_id / .context.labels / .context.annotations miliknya, serta .metadata.

Kunci templat yang hilang — kebijakan asimetris

Penanganan kunci yang hilang bergantung pada permukaan templat. Jika hasil render kosong berakhir di tempat yang terbatas — sebuah field manifest yang dapat dibaca kembali oleh penulis — kekosongan itu ditoleransi dan pembacaan tersebut tidak merender apa pun. Jika hasil render kosong justru akan menghasilkan struktur yang salah atau putusan yang salah, permukaan tersebut menolak referensi itu alih-alih meresolusikannya menjadi kosong.

  • Interpolasi parameter dalam sebuah Aggregate — referensi {{ .parameters.<key> }} yang dibawa oleh teks Aggregate itu sendiri — adalah permukaan paling awal di antara permukaan-permukaan ini: interpolasi berjalan atas dokumen mentah sebelum katalog diresolusikan, sehingga kebijakannya berlaku pada teks yang belum dilihat oleh permukaan lain mana pun. Referensi ke parameter yang tidak pernah diisi oleh Release dirender sebagai kosong, dan pipe default atau penjaga if atas pembacaan seperti itu berperilaku persis seperti atas parameter yang tidak diisi. Referensi yang diiterasi oleh templat tetap diiterasi sebagai kosong, sesuai yang diinginkan saat melakukan range atas daftar opsional — kecuali jika teks juga mencetaknya, yang menghentikan build seperti dijelaskan dalam “A template reads and iterates a path that holds nothing (Templat membaca dan mengiterasi path yang tidak berisi apa pun)” di bawah. Referensi yang induknya tidak ada — .parameters.db.host padahal tidak ada parameter db yang diisi — tetap menghentikan build, karena tidak ada yang dapat ditelusuri ke dalamnya dan menyediakan induk akan menukar penghentian dengan artefak yang salah secara diam-diam. Satu batas perlu dinyatakan sebagai batas, bukan sebagai kebijakan: referensi yang berjangkar pada root yang tidak didefinisikan oleh permukaan ini dibiarkan apa adanya alih-alih dirender sebagai kosong, sehingga referensi itu bertahan dalam dokumen hasil interpolasi sebagai teks placeholder milik mesin templat, <no value>. Tidak ada apa pun di permukaan ini yang berhenti karenanya, jadi jangkarkan setiap referensi parameter pada .parameters, dan baca <no value> yang tersesat sebagai root yang salah eja.
  • Templat path (directory: / subDirectory: pada boundary Release) dievaluasi dengan missingkey=error. Referensi ke variabel yang tidak disediakan oleh permukaan ini menghentikan build pada saat parse — lihat “Path-template references a variable outside the allowlist (Templat path mereferensikan variabel di luar allowlist)” di atas — demikian pula kunci yang salah ketik di bawah .manifest, yang kuncinya dideklarasikan. Referensi yang diizinkan tetapi tidak terdefinisi pada saat evaluasi, seperti kunci .parameters yang tidak disediakan oleh Release, menghasilkan error eksplisit alih-alih secara diam-diam merender string kosong ke dalam path direktori.
  • assertions (pada Component, Feature, Recipe, atau FeatureRecipe) dievaluasi dengan missingkey=error. Referensi ke kunci yang tidak terdefinisi menghentikan build dengan diagnostik no-such-key yang menyebutkan entitas, instance, dan asersinya. Keketatan inilah yang membuat asersi dapat dipercaya: predikat yang referensinya dirender sebagai nilai kosong akan dibandingkan dengan kekosongan dan lolos, sehingga satu salah ketik saja akan secara diam-diam mematikan aturan yang hendak ditegakkan oleh asersi tersebut. Karena referensi polos berhenti sebelum fallback apa pun dapat berjalan, default biasa tidak menyediakan fallback untuk field opsional di permukaan ini — lindungi referensi dengan hasKey, atau gunakan helper optional, yang melakukan pemeriksaan keberadaan secara langsung. Membaca kunci melalui index juga tidak menyediakannya: index berhenti pada kunci map yang tidak dimiliki map tersebut, dengan menyebutkan kuncinya.
  • Templat nilai (valuesMapping Recipe, entri locals: dan provides:, badan artifacts:, badan Workload, injectMapping dan pipeline.with FeatureRecipe, serta templat value: self-inject tingkat komponen) dievaluasi dengan missingkey=zero, sehingga referensi ke kunci yang tidak terdefinisi tidak menghentikan build — pembacaan itu tidak merender apa pun, dan kekosongan itulah yang sampai ke artefak. Yang tetap menghentikan build di permukaan ini adalah referensi yang menelusuri melalui kontainer yang tidak pernah disediakan penulis — .values.tls.ca padahal tidak ada tls yang ditulis — karena tidak ada yang dapat ditelusuri ke dalamnya. Hanya kunci terakhir dari referensi yang semua kontainernya ada yang dirender sebagai kosong. Field tingkat atas yang didefinisikan konteks tetapi tidak berisi apa pun — .workload pada Recipe yang tidak menyintesis apa pun, .features pada komponen tanpa attachment — dirender sebagai kosong dengan cara yang sama bila dibaca secara utuh. Satu referensi tetaplah satu referensi bagaimanapun penulisannya: .values.list, $.values.list, dan (.values).list menamai kunci yang sama, sehingga melakukan range atasnya dalam satu penulisan berarti melakukan range atasnya dalam semua penulisan, dan kunci yang dibaca dari pilar dalam tanda kurung dirender, atau menghentikan build, persis seperti penulisan langsung. Kunci yang diiterasi oleh templat tetap diiterasi sebagai kosong bila tidak diset, dan kunci yang dicetak sekaligus diiterasi oleh templat menghentikan build bila tidak diset — lihat “A template reads and iterates a path that holds nothing (Templat membaca dan mengiterasi path yang tidak berisi apa pun)” di bawah. Penjagaan berfungsi seperti yang diharapkan: {{ .values.optional_field | default "fallback" }} memang menyediakan fallback, karena nilai yang tidak diset dihitung sebagai kosong bagi default dan falsy bagi if. Penulis yang memerlukan pembeda absen-vs-nol — membedakan “kunci tidak ada” dari “kunci ada dan kosong” — menggunakan helper optional yang didokumentasikan di templates/sprig-functions.md, dan membaca suatu kunci dengan satu cara per templat: kunci yang juga dibaca oleh templat yang sama sebagai .values.<key> dihitung sebagai ada, sehingga optional melaporkan nilai kosongnya alih-alih fallback. Yang tidak dicakup oleh kebijakan ini adalah pembacaan melalui index: mengindeks map dengan kunci yang tidak dimilikinya menghentikan build dengan menyebutkan kunci tersebut, di sini sama seperti di setiap permukaan — lihat “A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)” di bawah.
  • Koordinat source: — field bertemplat dari blok source: terstruktur pada Recipe atau FeatureRecipe (version, ref, chart, module_subdir) — dievaluasi dengan missingkey=error. Referensi ke kunci yang tidak disediakan oleh apa pun menghentikan build dengan menyebutkan field source-nya, alih-alih diresolusikan menjadi kosong: version atau ref yang kosong akan mem-pin artefak yang berbeda dari yang disebutkan penulis, dan pin itulah yang direproduksi oleh setiap build berikutnya. Permukaan ini juga merupakan tempat himpunan fungsi yang tersedia berbeda, dan tempat referensi locals: yang ditolak oleh urutan penulisan blok itu sendiri menghentikan build sebelum apa pun dievaluasi — lihat di bawah.
  • Kontrak parameter bertipe menangkap kasus parameter wajib yang hilang dan pelanggaran kontrak pada lapisan kontrak parameter, sebelum interpolasi berjalan — lihat “Parameter type mismatch / contract violation (Ketidakcocokan tipe parameter / pelanggaran kontrak)” di atas.

Himpunan helper sama di seluruh templat nilai, templat path, dan asersi: fungsi-fungsi Sprig ditambah milik Aggrega sendiri (optional dan capitalizedWords). fail milik Sprig termasuk di antaranya, sehingga templat nilai dapat menghentikan build dengan pesannya sendiri, seperti yang dijelaskan “A value template failed while it ran (Templat nilai gagal saat berjalan)” di bawah; asersi adalah permukaan yang ditulis untuk itu, karena menghentikan build adalah seluruh tujuannya. Di antara ketiganya, yang berbeda adalah kebijakan kunci yang hilang — optional juga tersedia di templat path, tempat helper ini membaca kunci dari .parameters tanpa kebijakan ketat terpicu lebih dahulu. Resolusi koordinat source: berbeda pada himpunan fungsinya sendiri, dan memiliki subbagian tersendiri di bawah. Interpolasi parameter dalam sebuah Aggregate hanya menawarkan fungsi-fungsi Sprig, sehingga tidak satu pun helper Aggrega tersedia di sana. Satu fungsi terbaca dengan cara yang sama di setiap permukaan ini, termasuk koordinat dan interpolasi: index, yang berhenti dengan menyebutkan kuncinya ketika map yang dibacanya tidak memiliki kunci tersebut.

Pesan yang dicetak oleh kegagalan templat path dikutip di bawah entri yang mendokumentasikan kondisi tersebut, “Path-template references a variable outside the allowlist (Templat path mereferensikan variabel di luar allowlist)” di atas, sehingga pesan itu ditulis sekali saja alih-alih diulang di sini.

Cara memperbaiki: untuk kegagalan templat path, perbaiki nama field menjadi salah satu yang ada dalam allowlist yang didokumentasikan di path-template-variables.md. Untuk kegagalan asersi, perbaiki referensinya — sebagian besar laporan berupa kunci yang salah eja — atau, jika field tersebut memang opsional, lindungi dengan hasKey atau gunakan helper optional; membungkus referensi polos dalam default tidak akan menghilangkan penghentian, karena referensi diresolusikan sebelum fallback berjalan, dan membacanya melalui index juga tidak, karena index berhenti pada kunci yang tidak dimiliki map. Untuk kegagalan templat nilai yang hasil render kosongnya tidak diinginkan, gunakan helper optional atau sediakan kunci yang hilang sebagai deklarasi parameters.* bertipe pada Aggregate dengan nilai Release, sebagai entri provides: dari Component hulu yang dihubungkan melalui uses[].inject, atau sebagai entri locals: pada entitas yang sama.

Resolving a source: coordinate registers a narrower function set (Resolusi koordinat mendaftarkan himpunan fungsi yang lebih sempit)

Blok source: terstruktur di-resolve agar artefak yang dinamainya dapat di-pin, dan resolusi tersebut mendaftarkan helper milik Aggrega sendiri dan tidak ada yang lain — optional dan capitalizedWords tersedia, dan index berhenti pada kunci map yang tidak dimiliki map tersebut, persis seperti saat Recipe dirender; fungsi-fungsi Sprig tidak tersedia. Dari semua permukaan tempat Recipe atau FeatureRecipe menulis template, inilah satu-satunya yang himpunan fungsinya berbeda, sehingga ekspresi yang dirender dengan benar di bagian lain dari Recipe yang sama dapat ditolak di sini. Himpunan yang lebih sempit ini disengaja: apa yang di-pin ditentukan oleh values dan infra yang diberikan penulis, sedangkan fungsi-fungsi Sprig mencakup fungsi yang membaca jam, lingkungan, sumber acak, atau jaringan.

Memanggil fungsi Sprig dalam field source:, atau dalam entri locals: yang dibaca field tersebut, menghentikan build pada waktu parse. Diagnostiknya diawali dengan E0111 dan menyebutkan entri tersebut, field source: yang membacanya, fungsi yang tidak dapat di-resolve, serta helper yang memang didaftarkan permukaan ini:

resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads (resolve: parse template pada .spec.locals., dibaca oleh .spec.source.: resolve: kesalahan parse source-template (penyebab: template: .spec.locals.:1: fungsi tidak didefinisikan); field source, dan setiap entri locals yang dibacanya, dievaluasi saat source di-resolve hanya dengan helper milik Aggrega sendiri (optional, capitalizedWords, dan index), bukan fungsi Sprig yang ditambahkan saat render; tulis nilai tanpa fungsi tersebut, atau pindahkan nilai ke entri locals yang tidak dibaca field source mana pun)

Field source: yang memanggil fungsi itu sendiri dilaporkan dengan cara yang sama, hanya dengan menyebutkan field tersebut.

Jangkauannya adalah entri-entri yang dibaca koordinat. Resolusi koordinat mengevaluasi setiap entri locals: yang dibaca field source:, dan setiap entri yang pada gilirannya dibaca entri tersebut — dan tidak ada yang lain. Entri yang tidak dijangkau field source: mana pun tidak dievaluasi, di-parse, atau diperiksa saat source di-resolve, sehingga local yang dibutuhkan render — yang melakukan aritmetika dengan fungsi-fungsi Sprig, atau menamai resource berdasarkan .context.instance_id — tidak berpengaruh pada pinning artefak; entri itu dievaluasi, dan setiap kesalahan di dalamnya dilaporkan, saat Recipe dirender. Entri mana yang dibaca sebuah field ditentukan dari teksnya, sehingga field yang membaca .locals dengan cara yang tidak menyebut satu entri pun — {{ index .locals "version" }}, seluruh blok yang diberikan ke optional atau diikat ke variabel — membuat semua entri dievaluasi, dan diagnostik untuk entri yang dijangkau dengan cara itu menyatakannya: sebagai ganti read by <field> tertulis evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated.

Dua bentuk berada di luar permukaan ini, dan mengetahui bentuk mana yang dipakai sebuah Recipe menjelaskan mengapa ekspresi yang sama diterima di satu Recipe dan ditolak di Recipe lain:

  • source: yang ditulis sebagai string biasa — URI atau path lokal, bukan mapping — diambil apa adanya, sehingga tidak memiliki field untuk dievaluasi dan blok locals: sama sekali tidak di-resolve di sini.
  • Entitas yang tidak mendeklarasikan source: tidak me-resolve koordinat apa pun, sehingga blok locals:-nya hanya di-resolve untuk rendering entitas itu sendiri, tempat himpunan fungsi lengkap berlaku.

Kontrak urutan referensi sama di sini untuk setiap entri yang dibaca koordinat. Resolusi koordinat menolak referensi yang sama dengan yang ditolak render pada setiap entri yang dievaluasinya: entri yang membaca sibling yang dideklarasikan blok di bawahnya, dan template apa pun yang membaca kunci yang tidak dideklarasikan blok. Keduanya melaporkan kondisi yang didokumentasikan di atas pada “locals: entry references a sibling defined later in the same block (Entri locals mereferensikan sibling yang didefinisikan belakangan dalam blok yang sama)” dan “locals: key does not exist (Kunci locals tidak ada)” — kondisi yang sama, dengan solusi yang sama, resolusi mana pun yang mencapainya lebih dulu — dan laporan tersebut menyebutkan field source: yang untuknya entri itu dievaluasi. Kesalahan pada entri yang tidak dibaca field source: mana pun ditolak saat Recipe dirender, dengan kondisi yang sama.

Yang memang dilewati permukaan ini adalah entri yang benar-benar tidak dapat di-resolve oleh koordinat: entri yang membaca data yang hanya ada selama artefak dirender, dengan .context.instance_id sebagai kasus yang dimaksud. Entri seperti itu dilewati, sehingga Recipe yang koordinatnya menjangkau entri tersebut pada cabang yang tidak diambilnya tetap di-pin. Jika koordinat itu sendiri membutuhkan entri tersebut, resolusi berhenti dengan menyebutkan field source: — laporan kunci hilang yang dijelaskan untuk permukaan ini di atas, diawali dengan E0110 — dan mengutip, di samping kunci yang tidak dapat dibacanya, alasan entri tersebut tidak memiliki nilai di sini:

resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context") (resolve: evaluasi template pada .spec.source.: resolve: kegagalan evaluasi source-template pada waktu lock (penyebab: template: … map tidak memiliki entri untuk kunci); template membaca .spec.locals., yang tidak dapat dievaluasi di sini (penyebab: template: … map tidak memiliki entri untuk kunci))

Baik field source: maupun entri locals: yang dibacanya tidak boleh membaca .provides. Blok locals: mengisi blok provides: dan tidak pernah sebaliknya, sehingga template pada permukaan ini yang membaca .provides ditolak sebagai referensi terbalik, alih-alih di-resolve menjadi kosong. Penolakan ini bukan ketiadaan pada waktu lock yang akan dipenuhi fase berikutnya — tidak ada urutan yang membuat referensi itu valid — sehingga dilaporkan dengan cara yang sama di mana pun koordinat di-resolve. Diagnostiknya diawali dengan E0112; diagnostik ini menyebutkan field, atau entri beserta field yang membacanya, menyatakan apa yang salah dengan referensi tersebut, dan memberikan permukaan yang boleh dibaca ekspresi sebagai gantinya:

source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference) (template source-version pada .spec.source. mereferensikan provides, yang merupakan referensi terbalik yang tidak valid (locals mengisi provides, tidak pernah sebaliknya) — refaktor agar hanya membaca values dan infra (serta locals atas keduanya): resolve: source-template mereferensikan .provides (referensi terbalik yang tidak valid))

Tempat penghentian muncul: saat lockfile sedang diisi atau diperbarui — aggrega pull, atau build yang mengisinya (--auto-pull, --upgrade, atau pengaturan workspace auto_pull). Setiap kegagalan dilaporkan sebagai satu diagnostik, diawali dengan kode dari apa yang salah — E0111 untuk template yang tidak dapat di-parse, E0112 untuk referensi .provides, E0110 untuk template yang berhasil di-parse tetapi tidak dapat dievaluasi — baik di terminal maupun di editor yang terhubung ke aggrega serve. Kunci yang hilang pada field source:, berbeda dengan fungsi yang tidak tersedia, dilaporkan pada waktu eksekusi, bukan waktu parse, dengan menyebutkan field dan kunci yang tidak dapat dibacanya.

Cara memperbaiki: optional didaftarkan pada permukaan ini dan pada setiap value template, path template, dan assertion, sehingga menjadikannya pilihan yang portabel — {{ optional .values "chart_version" "25.0.8" }} sebagai ganti {{ default "25.0.8" .values.chart_version }}. Pahami perbedaan semantiknya sebelum menggantinya: optional berlaku saat kunci tidak ada, sedangkan default berlaku saat nilai kosong, sehingga kunci yang ditulis sebagai string kosong atau nol mempertahankan nilai yang ditulis di bawah optional dan diganti di bawah default. Jika ekspresi benar-benar membutuhkan fungsi Sprig — mengubah bentuk string alih-alih memberikan fallback — jauhkan dari apa yang dibaca koordinat: letakkan dalam entri locals: yang tidak dibaca field source: mana pun, atau pada permukaan yang mengonsumsinya (valuesMapping, badan Workload, entri artifacts:).

A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)

Sebuah templat membaca map melalui index — {{ index .values "replicas" }}, atau {{ index .context.inject.env $apiKeyVar }} dengan nama kunci yang dihitung oleh templat — dan map tersebut tidak memiliki kunci yang diminta. index berhenti di sana dan menyebutkan kuncinya, pada setiap permukaan yang mengevaluasi templat: templat nilai, entri locals: dan provides:, templat path, asersi, koordinat source: terstruktur, interpolasi parameter dalam Aggregate beserta predikat validate: parameternya, serta predikat x-aggrega-when: dan x-aggrega-validate: dari sebuah skema.

Ini adalah sifat index semata, dan kebijakan kunci-hilang dari permukaan mana pun tidak mengubahnya. Pembacaan titik atas kunci yang tidak diatur di bawah pilar terbuka tetap tidak merender apa pun pada templat nilai, seperti yang dijelaskan “Missing template key — asymmetric policy (Kunci templat hilang — kebijakan asimetris)” di atas, dan templat yang menguji apakah penulis menyediakan kunci semacam itu tidak terpengaruh. Yang berhenti adalah meminta index sebuah kunci yang tidak dimiliki map. index adalah cara templat menjangkau kunci yang namanya ia hitung — misalnya kredensial yang dibaca dengan nama variabel yang dipilih Recipe konsumen — dan tanpa penghentian ini, pembacaan itu akan memasukkan teks placeholder mesin templat <no value> ke dalam artefak sementara build berhasil: sebuah server dijalankan dengan teks itu sebagai kuncinya. Setiap jawaban lain yang diberikan index adalah milik mesin templat sendiri: posisi dalam list atau string, posisi di luar rentang, kunci yang dimiliki map — termasuk kunci yang nilainya null, yang mencetak <no value>.

Pesan yang dikeluarkan, sebagai baris terakhir laporan — frame di atasnya menyebutkan node dan field tempat templat berada, dan pada templat nilai Recipe atau FeatureRecipe, bagian kepala membawa kode kondisi ini:

template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (templat mengindeks map dengan kunci yang tidak dimiliki map tersebut. Baca kunci yang mungkin tidak ada melalui fungsi yang mengujinya terlebih dahulu, seperti optional, get, atau hasKey)

Pada permukaan yang melaporkan kegagalan templat di bawah kondisinya sendiri — entri provides: (“A provides: template could not be evaluated (Templat provides tidak dapat dievaluasi)”), interpolasi parameter (“A {{ .parameters.* }} reference cannot be interpolated (Referensi tidak dapat diinterpolasi)”), predikat skema (“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Predikat tidak dapat dievaluasi)”), koordinat source: (“Resolving a source: coordinate registers a narrower function set (Resolusi koordinat source mendaftarkan set fungsi yang lebih sempit)”) — bagian kepala membawa kode kondisi tersebut dan baris di atas adalah alasan yang dibawanya, termasuk kuncinya.

Cara memperbaiki: tentukan apakah kunci tersebut memang boleh tidak ada.

  • Boleh. Bacalah melalui fungsi yang mengujinya terlebih dahulu: {{ optional .values "replicas" 1 }} mengembalikan nilai cadangan saat kunci tidak ada, dan nilainya, apa pun itu, saat kunci ada; get dari Sprig mengembalikan string kosong untuk kunci yang tidak ada; hasKey menguji tanpa membaca. optional terdaftar di setiap permukaan kecuali interpolasi parameter dan predikat parameter atau skema, yang menyediakan get dan hasKey dari Sprig; koordinat source: mendaftarkan optional dan bukan Sprig.
  • Tidak boleh. Sediakan kuncinya. Kunci yang disebutkan pesan adalah kunci yang diminta templat, sehingga penyebab yang umum adalah kunci yang dipublikasikan dengan nama lain — kredensial yang key-nya bukan nama variabel yang dibaca Recipe — kunci yang salah eja di templat atau di nilai yang ditulis, dan koneksi yang akan mengirimkan kunci tersebut tetapi tidak tersambung.

A template reads and iterates a path that holds nothing (Templat membaca dan mengiterasi jalur yang tidak berisi apa pun)

Sebuah templat mencetak suatu jalur apa adanya dan juga melakukan iterasi atas jalur yang sama — misalnya "user": "{{ .values.user }}" dan "users": "{{ range .values.user }}…{{ end }}" dalam satu valuesMapping — sementara data tidak berisi apa pun di sana: kuncinya tidak ditetapkan, berisi null, atau merupakan bidang tingkat atas yang didefinisikan konteks tetapi tidak berisi apa pun, seperti .workload pada Recipe yang tidak menyintesis workload apa pun. Build berhenti sebelum templat berjalan dan menyebutkan jalur tersebut, pada setiap permukaan yang merender nilai yang tidak ditetapkan sebagai kosong: templat nilai yang dicantumkan oleh “Missing template key — asymmetric policy (Kunci templat hilang — kebijakan asimetris)” di atas, dan interpolasi parameter dalam Aggregate.

Setiap pembacaan secara terpisah memiliki jawaban. Nilai tidak ditetapkan yang dicetak tidak merender apa pun, dan yang diiterasi tidak mengiterasi apa pun. Jalur yang dibaca dengan kedua cara tidak dapat memiliki keduanya: merendernya sebagai kosong akan membuat range gagal pada teks, dan membiarkannya tidak ditetapkan akan mencetak teks placeholder mesin templat <no value> ke dalam artefak sementara build berhasil. Jadi tidak ada jawaban yang diberikan dan sebagai gantinya build berhenti.

Apa yang dihitung sebagai mencetak jalur dibatasi dengan sempit, dan garisnya ditarik di tempat templat pasti mencetaknya:

  • Jalur dicetak ketika suatu aksi hanya terdiri dari jalur tersebut dan tidak ada yang lain — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }}, atau variabel yang terikat ke jalur, {{ $u }} setelah {{ $u := .values.user }} — pada titik yang dicapai templat setiap kali berjalan.
  • Jalur tidak dicetak ketika pembacaan berada di dalam badan if, with, atau range, atau di cabang else, karena apakah pembacaan itu berjalan bergantung pada suatu kondisi, dan kondisi itu mungkin justru merupakan pengujian yang mencegahnya bertemu dengan kekosongan — sehingga {{ if .values.user }}{{ .values.user }}{{ end }} di samping range .values.user dirender seperti biasanya. Jalur juga tidak dicetak ketika pembacaan tersebut merupakan pengujian milik guard itu sendiri, penugasan variabel, atau argumen untuk suatu fungsi — {{ .values.user | quote }}, {{ toYaml .values.user }} — yang keluarannya adalah jawaban fungsi, bukan placeholder.

Pencetakan jalur yang tidak berisi apa pun di dalam badan yang memang berjalan tetap menulis <no value>, yang tidak dijangkau oleh pemeriksaan ini. Satu penulisan jalur adalah jalur yang sama dengan setiap penulisan lainnya, sehingga pencetakan dalam satu penulisan dan range dalam penulisan lain dinilai bersama, dan pesan mengutip penulisan yang ditulis templat lebih dahulu. Jalur yang berisi nilai dicetak dan diiterasi seperti biasanya, dan jalur yang induknya tidak berisi apa pun diserahkan kepada penghentian yang sudah dimunculkan saat turun melalui kekosongan.

Pesan yang dikeluarkan, sebagai baris terakhir laporan — frame di atasnya menyebutkan node dan templat, dan bagian kepala membawa kode kondisi ini:

template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (Templat membaca jalur sebagai nilai dan mengiterasinya, dan data tidak berisi apa pun di jalur tersebut. Berikan nilai di jalur tersebut, lindungi pembacaan yang dicetak dengan if atau with atas jalur tersebut, atau baca jalur itu dengan satu cara saja)

Interpolasi parameter dalam Aggregate juga melaporkan baris yang sama di bawah kode kondisi ini. Entri provides: melaporkan kegagalan templat di bawah “A provides: template could not be evaluated (Templat tidak dapat dievaluasi)”, sehingga di sana bagian kepala membawa kode kondisi tersebut dan baris di atas adalah alasan yang dibawanya, termasuk jalurnya.

Cara memperbaiki: tentukan mana dari kedua pembacaan yang dimaksud templat.

  • Jalur harus ada. Berikan jalur tersebut — di values: milik Aggregate, infra: milik Release, atau parameter yang diisi oleh Release — atau deklarasikan sebagai wajib dalam skema yang mengaturnya, sehingga ketidakhadirannya dilaporkan di tempat jalur itu ditulis.
  • Jalur boleh tidak ada. Lindungi pembacaan yang dicetak: {{ with .values.user }}{{ . }}{{ end }} atau {{ if .values.user }}{{ .values.user }}{{ end }} tidak mencetak apa pun ketika jalur tidak ditetapkan, dan range di sampingnya tetap mengiterasi sebagai kosong.
  • Satu pembacaan sudah cukup. Baca jalur dengan satu cara — range yang juga menulis apa yang dibutuhkannya, atau pencetakan melalui fungsi seperti toYaml atau join yang menjawab sendiri untuk nilai yang tidak ditetapkan.

A value template failed while it ran (Templat nilai gagal saat berjalan)

Templat nilai milik Recipe atau FeatureRecipe — salah satu templat yang dicantumkan “Missing template key — asymmetric policy (Kunci templat hilang — kebijakan asimetris)” di atas, termasuk badan Workload, badan artifacts:, atau entri locals: — telah di-parse, mulai berjalan, dan berhenti sebelum menghasilkan teksnya. Yang menghentikannya adalah alasan mesin templat itu sendiri, yang dibawa halt di bawahnya: referensi yang turun melalui kontainer yang tidak disediakan apa pun, seperti {{ .values.tls.ca }} padahal tidak ada tls yang ditulis; perbandingan antara nilai dari dua tipe, seperti {{ if eq .context.instance_id 1 }}, yang membandingkan teks dengan angka dan berhenti dengan cannot compare text with a number; atau pemanggilan fail milik Sprig, yang dapat dilakukan templat nilai untuk menolak masukan dengan pesannya sendiri.

Empat kegagalan pada templat-templat ini dilaporkan di bawah kondisinya masing-masing. Entri provides: dilaporkan di bawah “A provides: template could not be evaluated (Templat tidak dapat dievaluasi)” di bawah, dengan kalimat ini dan alasan mesin di dalam pesannya. Pembacaan index atas kunci yang tidak dimiliki map dilaporkan di bawah “A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map)” di atas. Templat yang mencetak dan mengiterasi satu jalur yang tidak berisi apa pun ditolak sebelum berjalan, di bawah “A template reads and iterates a path that holds nothing (Templat membaca dan mengiterasi jalur yang tidak berisi apa pun)” di atas. Dan templat yang tidak dapat di-parse berhenti sebelum berjalan, sehingga bukan kondisi ini.

Pesan yang dikeluarkan — bingkai di atasnya menyebutkan instans komponen dan templatnya, seperti recipe "<recipe>" workload template atau Recipe "<recipe>" locals["<key>"], dan baris milik mesin templat sendiri mengikuti di bawahnya:

a value template failed while it ran (templat nilai gagal saat berjalan)

Baris mesin berbunyi template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> — untuk pemanggilan fail, error calling fail: <the message the template wrote>. Build melaporkan halt tersebut dengan tag CATALOG_ERROR, karena templat ditulis oleh penulis Recipe atau FeatureRecipe. aggrega pull menjumpai kegagalan yang sama ketika merender Release untuk menemukan masukan eksternal yang dibacanya: perintah ini melaporkan kegagalan, tetap menulis pin dependensi lockfile, dan menyatakan bahwa pin masukan eksternal mungkin tidak lengkap; build berhenti karenanya.

Cara memperbaiki: baca alasan mesin di akhir laporan — alasan itu menyebutkan templat, baris dan kolom, serta ekspresi tempatnya berhenti. Untuk kontainer yang tidak disediakan apa pun, sediakan kontainer tersebut, atau lindungi pembacaan agar tidak pernah turun ke sesuatu yang tidak ada: {{ with .values.tls }}{{ .ca }}{{ end }}, atau helper optional. Untuk dua tipe yang dibandingkan, bandingkan yang sejenis — angka dengan angka yang ditulis tanpa tanda kutip, teks dengan teks yang ditulis dalam tanda kutip — atau ubah satu sisi menjadi teks dengan toString. Untuk pemanggilan fail, pesannya milik penulis templat, dan pesan itu menyatakan apa yang dibutuhkan Recipe: berikan itu, atau petakan komponen ke Recipe yang menerima apa yang Anda tulis.

A governance plugin rejected the build (Plugin tata kelola menolak build)

Seorang operator dapat memasang plugin tata kelola dalam peran verdict, atas graf yang dibangun compiler atau atas artefak yang dirender. Plugin semacam itu membaca dan mengembalikan verdict. Host tidak memiliki jalur untuk menerapkan perubahan yang dikembalikan darinya, sehingga peran verdict dapat menolak build dan tidak dapat menulis ulang build agar patuh — penolakan adalah satu-satunya yang dapat dilakukannya, dan apa yang perlu diubah diserahkan kepada siapa pun yang membacanya.

Hanya verdict halt yang menghentikan build. Verdict warn dan info dilaporkan dan build tetap berjalan. Setiap verdict halt yang dikembalikan plugin dilaporkan, sesuai urutan plugin mengeluarkannya, sehingga satu kali eksekusi memberi tahu Anda semuanya.

Pesan yang dicetak build adalah milik plugin itu sendiri, ditampilkan persis seperti saat dikembalikan dan hanya dibingkai oleh plugin yang mengembalikannya — sehingga seberapa spesifik dan seberapa dapat ditindaklanjuti pesan itu ditentukan oleh plugin, bukan oleh compiler. Detail opsional apa pun yang dibawa verdict menyusul dalam tanda kurung siku, masing-masing bagian diberi nama: kode, pengenal aturan, klasifikasi, referensi sumber, lokasi, saran. Kondisi tempat ia dicatat adalah policy violation, yang merupakan hasil resolusi kode pendek di kepala diagnostik.

Penolakan ini diatribusikan ke lampiran tata kelola, bukan ke salah satu dokumen Anda, sehingga tidak membawa posisi file: tidak ada kunci yang menghasilkannya, dan jawabannya adalah memenuhi kebijakan atau meninjau ulang lampiran tersebut.

Pesan yang diemisikan:

policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (plugin kebijakan menolak build)

Bagian dalam tanda kurung siku hanya ada jika verdict membawa detail, dan setiap bagian di dalamnya hanya ada jika plugin mengaturnya.

Cara memperbaiki: baca pesan plugin dan sarannya jika disediakan. Jika temuannya benar, ubah hal yang dikeberatkannya. Jika kebijakan tersebut tidak seharusnya berlaku untuk Release ini, itu adalah pertanyaan tentang lampirannya: lampiran tata kelola dikonfigurasi di bawah plugins.governance dalam konfigurasi workspace, dan plugin mana yang berjalan dalam peran mana adalah keputusan operator, bukan sesuatu yang dapat ditimpa oleh dokumen.

A governance attachment’s settings do not match the plugin’s declared schema (Pengaturan lampiran tata kelola tidak cocok dengan skema yang dideklarasikan plugin)

Plugin tata kelola dapat mendeklarasikan skema untuk pengaturan yang diteruskan lampirannya. Pengaturan yang ditulis di bawah with.settings lampiran diperiksa terhadap skema tersebut sebelum plugin dijalankan, sehingga lampiran yang salah konfigurasi dilaporkan sebagai kesalahan konfigurasi sebagaimana adanya, alih-alih sampai ke plugin sebagai input berbentuk salah dan kembali sebagai apa pun yang ditafsirkan plugin darinya.

Urutan itulah inti pemeriksaan ini. Urutan itu juga membuatnya jelas berbeda dari penolakan: plugin belum berjalan, tidak ada verdict yang dicapai, dan tidak ada apa pun tentang build yang dinilai. Plugin yang tidak mendeklarasikan skema pengaturan menerima pengaturan apa pun, sehingga lampiran terhadap plugin semacam itu tidak pernah menemui kondisi ini.

Pemeriksaan ini mencakup setiap peran tata kelola. Lampiran yang ditulis pada ir-verdict, render-verdict, label-transform, atau annotation-transform diperiksa pengaturannya terhadap skema sebelum plugin dijalankan — with.settings adalah kunci yang sama pada setiap peran, dan setiap peran membacanya terhadap skema terlebih dahulu. Peran transformasi berjalan di tempat build menerapkannya, yang pada build yang melakukan pull terlebih dahulu berarti selama pull tersebut, sehingga pesan di sana dibuka dengan langkah yang menjalankannya, seperti dalam auto-pull: label-transform:.

Pesan yang dikeluarkan — peran tempat lampiran ditulis dan plugin yang disebutkannya, lalu kalimat tetap, lalu apa yang ditemukan pemeriksaan skema:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (pengaturan lampiran kebijakan tidak memenuhi skema pengaturan yang dideklarasikan plugin)

Klausa awal berbunyi render-verdict untuk lampiran yang ditulis pada peran tersebut. Apa yang ditemukan pemeriksaan skema adalah laporan validator skema itu sendiri dan dapat lebih dari satu baris.

Cara memperbaiki: perbaiki pengaturan di bawah with.settings lampiran tersebut dalam plugins.governance. Detail di tengah pesan menyebutkan kunci yang salah dan apa yang diharapkan skema di sana; referensi plugin itu sendiri mendokumentasikan pengaturan yang dideklarasikannya.

A pipeline step failed (Sebuah langkah pipeline gagal)

Sebuah FeatureRecipe dapat mendeklarasikan pipeline: serangkaian langkah, yang masing-masing menjalankan sebuah ekspor plugin atas dokumen yang telah diemisikan node, sehingga sebuah Feature dapat membentuk keluaran yang dihasilkan oleh Recipe milik komponen itu sendiri. Ini adalah kondisi yang dilaporkan sebuah langkah ketika gagal karena alasan apa pun selain patch yang menyasar sesuatu yang tidak ada dalam himpunan dokumen, yang memiliki laporannya sendiri di bawah.

Yang gagal dinamai menurut id langkah dan indeksnya, dan klausa berikutnya menyebutkan bagian mana yang gagal: perenderan masukan with langkah tersebut, pemanggilan itu sendiri, keluaran yang tidak dapat dibaca host, galat yang dikembalikan plugin, diagnostik bertingkat galat yang diemisikan plugin, patch yang ditolak mesin patch, atau patch yang menyebut scope yang tidak dimiliki penelusuran.

Langkah yang gagal dibatalkan seluruhnya. Dokumen dikembalikan ke keadaan sebelum langkah berjalan, dan keluaran langkah itu sendiri dibuang bersamanya, sehingga when atau with pada langkah berikutnya tidak dapat membaca hasil parsial. Langkah yang dideklarasikan optional: true kemudian dilaporkan sebagai peringatan dan penelusuran berlanjut; langkah yang tidak opsional menghentikan build. Yang tidak ditoleransi oleh optional: adalah pelanggaran kontrak yang dideklarasikan — lihat entri di bawah.

Pesan yang dikeluarkan:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> (langkah pipeline gagal: langkah (indeks) with: apa yang tidak dapat dilakukan perenderan) pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> (langkah pipeline gagal: langkah (indeks) pemanggilan: apa yang tidak dapat dilakukan pemanggilan) pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> (langkah pipeline gagal: langkah (indeks) diagnostik galat: pesan plugin) pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> (langkah pipeline gagal: scope, kunci: apa yang ditolak mesin patch) pipeline step failed: unknown patch scope "<scope>" (langkah pipeline gagal: scope patch tidak dikenal)

Cara memperbaiki: baca id langkah, lalu klausa setelah indeks — klausa itu menunjukkan bagian langkah mana yang perlu diperiksa. Kegagalan with adalah templat dalam blok with: milik langkah itu sendiri, dan menjadi tanggung jawab Anda untuk memperbaikinya. Diagnostik galat adalah kata-kata plugin itu sendiri tentang masukan Anda. Patch yang ditolak dan scope yang tidak dikenal adalah keluaran plugin terhadap apa yang diemisikan node, dan menjadi tanggung jawab penulis plugin. Jika sebuah langkah memang boleh gagal — pengayaan opsional, bukan transformasi wajib — deklarasikan optional: true, dengan mengingat bahwa ini menoleransi kegagalan, bukan kontrak yang rusak.

A pipeline step’s typed input or output does not satisfy its declared contract (Masukan atau keluaran bertipe sebuah langkah pipeline tidak memenuhi kontrak yang dideklarasikannya)

Sebuah ekspor plugin dapat mendeklarasikan skema untuk masukan yang diterimanya dan untuk keluaran yang dikembalikannya. Keduanya diperiksa: nilai with yang dirender sebelum pemanggilan, dan keluaran yang dikembalikan setelahnya. Diagnostik yang tingkat keparahannya tidak dideklarasikan oleh kontrak bersama ditolak atas dasar yang sama.

Ini menghentikan build bahkan untuk langkah yang dideklarasikan optional: true, dan perbedaan inilah seluruh alasan kondisi ini terpisah dari kegagalan langkah. Opsional menoleransi langkah yang tidak dapat menjalankan tugasnya — pemanggilan yang gagal, plugin yang berkeberatan. Opsional tidak menoleransi keluaran yang tidak dapat dirutekan host, atau masukan yang sejak awal tidak berbentuk seperti yang dinyatakan ekspor: kontrak yang dideklarasikan adalah komitmen, dan build yang diam-diam melewati langkah yang kontraknya rusak akan melaporkan keberhasilan atas sebuah Feature yang tidak melakukan apa pun.

Pesan yang dikeluarkan:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (masukan with langkah pipeline tidak memenuhi kontrak masukan yang dideklarasikan: temuan pemeriksaan skema: pelanggaran kontrak I/O bertipe langkah pipeline) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (langkah pipeline mengembalikan keluaran yang tidak memenuhi kontrak keluaran yang dideklarasikan: temuan pemeriksaan skema: pelanggaran kontrak I/O bertipe langkah pipeline)

dan untuk tingkat keparahan diagnostik yang tidak dideklarasikan kontrak, yang muncul di dalam bingkai kegagalan langkah:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (langkah pipeline gagal: langkah (indeks): tingkat keparahan yang tidak dapat dirutekan host: pelanggaran kontrak I/O bertipe langkah pipeline)

Jika templat with langkah membaca nilai yang dideklarasikan sensitif, pelanggaran masukan tidak menyebutkan nilai apa pun. Temuan pemeriksaan skema diganti dengan setiap posisi yang gagal dan kata kunci yang menolaknya, diakhiri dengan pemberitahuan yang menyebutkan alasannya — at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive) — sehingga bidang yang perlu diperbaiki tetap disebutkan. Lihat vocabulary/compact-form-authoring.md “Apa yang dikatakan penolakan tentang nilai yang dideklarasikan”.

Cara memperbaiki: untuk pelanggaran masukan, perbaiki blok with: langkah tersebut sesuai skema yang dideklarasikan ekspornya — detailnya menyebutkan bidang dan apa yang diharapkan. Pelanggaran keluaran dan tingkat keparahan yang tidak dideklarasikan menjadi tanggung jawab plugin untuk diperbaiki; deklarasi langkah bukanlah yang salah, sehingga menandainya opsional tidak akan menghilangkan keduanya.

A pipeline patch addresses a document the set does not hold, or one with no tree to address (Patch pipeline menyasar dokumen yang tidak ada dalam himpunan, atau dokumen tanpa pohon untuk disasar)

Sebuah langkah pipeline menyasar dokumen melalui scope dan kunci, dan dua bentuk alamat ditolak.

Himpunan tidak memuatnya. Langkah mem-patch pasangan scope dan kunci yang tidak termasuk dalam dokumen yang diserahkan kepadanya. Tidak ada yang akan diedit, sehingga alih-alih menerapkan patch pada ketiadaan dan melaporkan keberhasilan, penelusuran berhenti:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (patch pipeline menyasar dokumen yang tidak ada dalam himpunan: scope, kunci)

Dokumen itu tidak memiliki pohon untuk disasar. Beberapa unit tidak memiliki struktur yang dapat ditunjuk oleh patch — badan biner, teks bebas, wilayah yang tidak dapat ditelusuri provider dengan aman. Unit seperti itu tetap diserahkan kepada langkah, ditandai dengan tipe media dan byte-nya, sehingga dapat dipilih dan diemisikan utuh; yang tidak dapat dilakukan padanya adalah patch, karena tidak ada apa pun yang dapat menjadi acuan resolusi path. Patch terhadap unit seperti itu berhenti alih-alih dilewati diam-diam:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (patch pipeline menyasar unit buram (tidak terstruktur): scope, kunci)

Apa yang dianggap terstruktur adalah pembacaan provider itu sendiri atas unit tersebut, bukan uji yang tetap, sehingga konten yang sama dapat disasar di bawah satu provider dan buram di bawah provider lain.

Keduanya adalah penolakan penelusuran itu sendiri, dan build melaporkannya terhadap node yang pipeline-nya membuat patch, sehingga pesan di atas muncul di bawah penghentian yang menyebut node tersebut. Penghentian itu adalah bentuk penghenti build dari dua kesalahan penyasaran yang sama, yang didokumentasikan di bawah “A pipeline step addresses documents the node does not have (Sebuah langkah pipeline menyasar dokumen yang tidak dimiliki node)” di bawah — yang juga mencakup alamat ketiga yang membuat langkah tidak mencapai apa pun, yaitu permintaan dokumen dari komponen host di situs yang tidak berhadapan dengan komponen mana pun.

Cara memperbaiki: keduanya menjadi tanggung jawab penulis plugin, bukan Anda. Sebuah langkah menerima himpunan dokumen yang sedang diprosesnya dan dapat membaca kunci apa saja yang ada di dalamnya, sehingga target yang tidak ada berarti langkah menyasar dokumen yang tidak diemisikan node ini — patch dokumen yang ada, atau emisikan dahulu dokumen yang dimaksud lalu patch dokumen itu di langkah berikutnya. Untuk unit buram, ganti patch dengan emisi seluruh unit: badan yang buram diganti, bukan diedit.

A patch’s test operation did not match the document (Operasi pengujian pada patch tidak cocok dengan dokumen)

Sebuah patch dapat membawa operasi test, yang menegaskan apa yang ada pada suatu path sebelum operasi-operasi sesudahnya diterapkan. Engine menolak seluruh patch apabila penegasan tersebut tidak terpenuhi, dan hal inilah yang membuat patch bersyarat benar-benar bersyarat, bukan optimistis: plugin yang menguji sebelum mengedit menyatakan bahwa ia tidak akan menyentuh dokumen yang tidak dikenalinya.

Dua bentuk dilaporkan di bawah kondisi ini. Tidak ada apa pun sama sekali pada path tersebut, dan hal ini disebutkan oleh pesannya. Atau ada nilai tetapi bukan nilai yang ditegaskan, yang dilaporkan sebagai penolakan saja — baik nilai yang ditegaskan maupun nilai yang ditemukan tidak dikutip.

Pesan yang dikeluarkan:

jsonpatch: test operation failed: no value at path (jsonpatch: operasi pengujian gagal: tidak ada nilai pada path) jsonpatch: test operation failed (jsonpatch: operasi pengujian gagal)

Apabila patch dibawa oleh output sebuah langkah pipeline, penolakan muncul di bawah kegagalan langkah tersebut, dengan menyebutkan langkahnya. Apabila patch dibawa oleh plugin label-transform, penolakan muncul di bawah penolakan label-patch.

Cara memperbaiki: kesalahan ini berasal dari plugin, bukan dari dokumen Anda. Pengujian yang mengharapkan nilai yang tidak dimiliki dokumen biasanya berarti plugin dijalankan terhadap bentuk yang tidak menjadi sasaran penulisannya — output provider lain, atau dokumen yang sudah diubah oleh langkah sebelumnya dalam pipeline yang sama. Apabila patch tersebut menjadi tanggung jawab Anda untuk diperbaiki, longgarkan pengujian sesuai dengan apa yang benar-benar dibawa dokumen, atau gunakan gerbang when pada langkah untuk melewati kasus tersebut alih-alih mengujinya di dalam patch.

A workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)

Sebuah workload: mendeklarasikan form: — bentuk dari hal yang dijalankan, dinyatakan dalam istilah yang dipahami setiap target, bukan dalam kosakata satu target tertentu. Beberapa field hanya masuk akal pada satu bentuk, dan bentuk yang dideklarasikan tanpa field yang dibutuhkannya tidak memiliki sesuatu yang koheren untuk dirender. Kedua arah diperiksa sebelum target mana pun menerjemahkan workload, sehingga ketidaksesuaian dilaporkan sekali terhadap apa yang Anda tulis, bukan sekali per target dengan kata-kata apa pun yang dimiliki setiap target untuknya.

Lima pasangan ditegakkan, dan masing-masing melaporkan kalimatnya sendiri yang menyebutkan kedua bagian serta apa yang harus ditulis:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (workload mendeklarasikan volume persistentTemplate tetapi bukan form: stateful; deklarasikan form: stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (workload adalah form: reference tetapi tidak mendeklarasikan endpoint; atur endpoint ke host eksternal atau URL yang dituju referensi) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (workload mendeklarasikan endpoint tetapi bukan form: reference; deklarasikan form: reference atau hapus endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (workload adalah form: scheduled tetapi tidak mendeklarasikan schedule; atur schedule ke ekspresi cron 5 field atau makro @ (mis. @daily)) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (workload mendeklarasikan schedule tetapi bukan form: scheduled; deklarasikan form: scheduled atau hapus schedule)

Masing-masing diposisikan pada instance komponen yang workload-nya sedang dibaca, dan dilaporkan sebagai kesalahan terjemahan, karena ketidaksesuaian terjadi antara dua field dari satu blok yang ditulis.

Kondisi tempat semuanya dicatat, yang menjadi tujuan resolusi kode pendeknya, adalah persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule dan schedule requires form: scheduled.

Satu pasangan hanya berlaku satu arah. Workload form: stateful tanpa template klaim per replika adalah hal biasa dan tidak memicu apa pun — aturannya adalah bahwa template klaim membutuhkan identitas per replika yang stabil yang hanya diberikan oleh bentuk tersebut, bukan bahwa bentuk tersebut membutuhkan template klaim. Dua pasangan lainnya berlaku dua arah, karena endpoint dan schedule masing-masing memiliki tepat satu bentuk tempat keduanya bermakna.

Kedua pasangan endpoint juga ada dalam skema Workload, sehingga workload yang melanggar salah satunya ditolak pada tahap skema, di bawah E0214, sebelum kalimatnya di atas tercapai. endpoint: pada bentuk apa pun selain reference — termasuk form: yang dihilangkan, karena dibaca sebagai stateless — ditolak sebagai

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (validasi workload gagal pada tahap skema: nilai endpoint cocok dengan bentuk yang tidak diizinkan di sini)

dan form: reference tanpa endpoint: justru berakhir dengan .endpoint: missing required property: endpoint. Perbaikannya adalah yang diberikan kalimat pasangan tersebut.

Cara memperbaiki: setiap kalimat menyebutkan kedua field dan memberikan kedua jawaban. Tambahkan field yang dibutuhkan bentuk tersebut, atau ubah bentuk ke bentuk tempat field itu berada, atau hapus field yang tertinggal akibat suntingan — menghapus nilai schedule: tetapi membiarkan kuncinya adalah bentuk yang paling sering memicu kondisi ini.

A workload schedule: is not an expression the check accepts (Schedule workload bukan ekspresi yang diterima pemeriksaan)

Workload form: scheduled membawa schedule: yang menyatakan kapan ia dijalankan, dan nilainya diperiksa strukturnya sebelum target mana pun membacanya. Dua penulisan diterima: salah satu dari lima makro @hourly, @daily, @weekly, @monthly dan @yearly, atau ekspresi crontab lima field yang field-nya hanya menggunakan digit dan karakter *, ,, - dan /.

Apa yang dibaca dan tidak dibaca oleh pemeriksaan. Pemeriksaan menghitung field dan melihat karakter di dalamnya. Pemeriksaan tidak mengevaluasi rentang, aritmetika langkah, atau penamaan hari dalam minggu, sehingga ekspresi lima field yang angkanya di luar rentang lolos di sini dan menjadi tanggung jawab target untuk menolaknya. Ekspresi enam field yang membawa field detik di depan ditolak: lima field adalah yang diterima oleh permukaan ini, dan target yang menginginkan detik menerimanya dengan cara lain.

Pesan yang diemisikan:

workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly (schedule workload bukan ekspresi cron yang valid; gunakan ekspresi crontab 5 field (mis. “0 0 * * *”) atau salah satu dari @hourly, @daily, @weekly, @monthly, @yearly)

Kondisi tempat ini dicatat adalah schedule is not a valid cron expression, yang menjadi tujuan resolusi kode pendeknya.

Cara memperbaiki: hitung field-nya terlebih dahulu — schedule dengan empat atau enam field adalah penyebab paling umum, dan spasi nyasar di dalam satu field memecahnya menjadi dua. Ganti nama hari atau bulan dengan angkanya, dan gunakan makro apabila ada makro yang menyatakan maksud Anda.

A workload suspend: is set on a form other than scheduled (Field penangguhan workload diatur pada bentuk selain terjadwal)

suspend: true menahan jadwal berulang workload form: scheduled: sumber daya terjadwal tetap dirender, dan tidak ada eksekusi yang dimulai dari jadwalnya sampai dilanjutkan kembali. Tidak ada bentuk lain yang membawa jadwal, sehingga pada bentuk lain mana pun tidak ada yang dapat ditahan oleh field tersebut, dan build berhenti alih-alih merender workload yang diam-diam mengabaikannya. Pemeriksaan berjalan bersama pasangan bentuk lainnya, sebelum target mana pun menerjemahkan workload, dan form: yang dihilangkan di sini juga dibaca sebagai stateless.

Pesan yang diemisikan:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (workload mendeklarasikan suspend tetapi bukan form: scheduled; deklarasikan form: scheduled dengan jadwal atau hapus suspend)

Temuan ini diposisikan pada instans komponen yang workload-nya sedang dibaca, dan dilaporkan sebagai kesalahan penerjemahan. Kondisi tempat temuan ini dicatat adalah suspend requires form: scheduled, yang merupakan hasil resolusi kode pendeknya.

Aturan ini hanya berlaku satu arah, dan hanya untuk true. Workload form: scheduled tanpa suspend: adalah hal biasa dan berjalan sesuai jadwalnya, dan suspend: false, nilai bawaan, tidak memicu apa pun pada bentuk mana pun.

Cara memperbaiki: jika workload dimaksudkan hanya berjalan ketika seseorang memulainya, jadikan workload tersebut form: scheduled dengan schedule: dan pertahankan suspend: true; jika tidak, pertahankan bentuk sebagaimana ditulis dan hapus suspend:, yang tidak dibaca bentuk lain mana pun.

$import: pustaka tidak ditulis dalam bentuk nama polos

Tiga bidang pada Recipe dan FeatureRecipe dapat mengambil isinya dari pustaka alih-alih menuliskannya di tempat: entri artifacts.<name>:, valuesMapping:, dan workload:. Masing-masing menulis $import: dengan nama polos pustaka, lalu #, lalu path entri pada permukaan yang dibaca bidang tersebut — berturut-turut #/artifacts/, #/mappings/, dan #/workloads/. Nilai yang tidak berbentuk demikian tidak menamai apa pun yang dapat diselesaikan oleh build, dan ditolak saat bidang tersebut diselesaikan.

Ketiga bidang tersebut sengaja dibuat saling mencerminkan, sehingga kesalahannya terbaca sama pada ketiganya dan hanya permukaannya yang berubah:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (artifacts $import: bukan referensi artifact-library bernama polos) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (valuesMapping $import: bukan referensi mapping-library bernama polos) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (workload $import: bukan referensi workload-library bernama polos)

Versi yang ditulis dengan @ dilaporkan beserta ejaan yang harus digunakan sebagai gantinya, alih-alih berlanjut ke keluhan bahwa pustaka tidak ditemukan, karena itulah kesalahan yang paling sering terjadi pada bentuk ini:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (artifacts $import: bukan referensi artifact-library bernama polos: pemisah versi adalah ’:’, bukan ’@’ — gunakan nilai yang dikoreksi)

Satu bentuk lagi dilaporkan di sini, dan itu bukan kesalahan ejaan. Isi file milik bundle ArtifactLibrary tidak boleh berupa $import: dari bundle lain: satu slot file tidak dapat diperluas menjadi banyak file, sehingga impor bersarang ditolak alih-alih diselesaikan menjadi sesuatu yang tidak ditulis oleh penulisnya. Sebagai gantinya, gabungkan bundle-bundle tersebut di titik tempat bundle itu dikonsumsi.

Entri artifacts: yang ditulis oleh Recipe milik suatu komponen ditentukan sebelum apa pun dirender, sehingga laporan ditempatkan pada blok artifacts: dalam Recipe tersebut dan menyebutkan referensinya, bundle-nya, file yang isinya memuat impor bersarang, serta entri tempat impor itu ditulis. Setiap file bundle dengan bentuk tersebut dilaporkan dalam satu build; jika ada lebih dari satu, temuan dikelompokkan di bawah artifacts entries whose library import the compiler cannot resolve:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them (artifacts $import: bukan referensi artifact-library bernama polos. isi file bundle tidak dapat mengimpor bundle lain — gabungkan keduanya di entri artifacts yang mengonsumsinya)

Entri artifacts: yang ditulis oleh FeatureRecipe melaporkan kondisi yang sama saat bundle diselesaikan, dengan menyebutkan file pertama yang berbentuk demikian:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site) (artifacts $import: bukan referensi artifact-library bernama polos: isi file bundle berupa $import: akar bidang; impor pustaka bersarang di dalam file bundle tidak didukung; gabungkan di lokasi konsumsi)

valuesMapping: yang ditulis oleh Recipe milik suatu komponen ditentukan sebelum apa pun dirender, sehingga laporan ditempatkan pada kunci valuesMapping: dalam Recipe tersebut dan memuat ejaan yang harus digunakan:

valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/ (valuesMapping $import: bukan referensi mapping-library bernama polos. sebutkan pustaka dan entri di kedua sisi fragmen)

valuesMapping: yang ditulis oleh FeatureRecipe dilaporkan saat referensinya diselesaikan, dalam bentuk yang dimuat daftar di atas.

workload: yang ditulis oleh Recipe milik suatu komponen ditentukan sebelum apa pun dirender, sehingga laporan ditempatkan pada kunci workload: dalam Recipe tersebut dan memuat ejaan yang harus digunakan:

workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/ (workload $import: bukan referensi workload-library bernama polos. sebutkan pustaka dan entri di kedua sisi fragmen)

workload: yang ditulis oleh FeatureRecipe dilaporkan saat referensinya diselesaikan, dalam bentuk yang dimuat daftar di atas.

Cara memperbaiki: tulis ulang nilainya sebagai <Library>#<entry-path>, dengan menambahkan :<version> setelah nama pustaka hanya jika Anda memerlukan batas bawah untuk versi yang dapat dipilih. Pastikan fragmen sesuai dengan bidangnya — path entri #/mappings/… pada workload: menamai permukaan yang tidak dibaca bidang tersebut, dan dilaporkan di sini alih-alih sebagai entri yang hilang. Bentuk identitas yang sama berlaku untuk $ref: pada skema, yang penolakannya didokumentasikan di bawah “A $ref: is not written in a form the compiler can resolve (Sebuah referensi tidak ditulis dalam bentuk yang dapat diselesaikan oleh compiler)” di atas.

$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog

Sebuah $import: ditulis dengan benar, tetapi yang ditunjuknya tidak ada. Enam kondisi mencakup dua bagian referensi pada tiga jenis pustaka, dan kondisi yang Anda terima menunjukkan bagian mana yang perlu diperiksa: pustaka itu sendiri tidak ada dalam apa yang dapat dilihat build, atau pustaka itu ada tetapi tidak menerbitkan entri tersebut.

Himpunan tempat referensi diresolusi adalah katalog milik workspace ditambah pustaka yang dipin oleh lockfile dan dimuat saat build berjalan. Jadi, pustaka yang tidak dideklarasikan sebagai dependensi oleh apa pun dalam closure dependensi Release tidak berada dalam himpunan itu, sebenar apa pun referensi ke dalamnya ditulis.

Pustakanya tidak ada:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (impor artifact-library mereferensikan ArtifactLibrary yang tidak ada dalam katalog: ArtifactLibrary (bundle)) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (impor mapping-library mereferensikan MappingLibrary yang tidak ada dalam katalog: MappingLibrary (entri)) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (impor workload-library mereferensikan WorkloadLibrary yang tidak ada dalam katalog: WorkloadLibrary (entri))

Entrinya tidak ada:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (impor artifact-library mereferensikan bundle yang tidak ada dalam ArtifactLibrary: bundle dalam ArtifactLibrary) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (impor mapping-library mereferensikan entri yang tidak ada dalam MappingLibrary: entri dalam MappingLibrary) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (impor workload-library mereferensikan entri yang tidak ada dalam WorkloadLibrary: entri dalam WorkloadLibrary)

Entri artifacts: yang ditulis oleh Recipe milik komponen itu sendiri melaporkan bundle yang hilang dalam bentuknya sendiri. Entri itu diputuskan sebelum apa pun dirender, sehingga laporan ditempatkan pada blok artifacts: di Recipe tersebut dan menyebutkan entri tempat impor ditulis beserta kedua bagian referensi:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (impor artifact-library mereferensikan bundle yang tidak ada dalam ArtifactLibrary (ArtifactLibrary, entri artifacts))

valuesMapping: yang ditulis oleh Recipe milik komponen itu sendiri melaporkan entri yang hilang dalam bentuknya sendiri, dengan alasan yang sama: ia juga diputuskan sebelum apa pun dirender, sehingga laporan ditempatkan pada kunci valuesMapping: di Recipe tersebut dan menyebutkan kedua bagian referensi:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (impor mapping-library mereferensikan entri yang tidak ada dalam MappingLibrary (MappingLibrary))

workload: yang ditulis oleh Recipe milik komponen itu sendiri melaporkan entri yang hilang dalam bentuknya sendiri, dengan alasan yang sama: ia juga diputuskan sebelum apa pun dirender, sehingga laporan ditempatkan pada kunci workload: di Recipe tersebut dan menyebutkan kedua bagian referensi:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (impor workload-library mereferensikan entri yang tidak ada dalam WorkloadLibrary (WorkloadLibrary))

Entri artifacts: yang ditulis oleh FeatureRecipe, valuesMapping: atau workload: yang ditulis oleh FeatureRecipe, dan setiap referensi ke pustaka yang tidak dapat dilihat build, dilaporkan saat referensi diresolusi, dalam bentuk yang dimuat kedua daftar di atas.

Masing-masing menyebutkan pustaka dan entri sekaligus, bagian mana pun yang gagal, sehingga satu laporan cukup untuk membedakan pustaka yang hilang dari entri yang hilang tanpa membuka apa pun.

Cara memperbaiki: untuk entri yang hilang, periksa namanya terhadap apa yang diterbitkan pustaka — nama entri adalah kunci dalam map milik pustaka itu sendiri, dan peka huruf besar-kecil. Untuk pustaka yang hilang, referensinya biasanya benar dan closure-lah yang kurang: deklarasikan dependensi pada pustaka itu agar dimuat, dan perbarui lockfile agar pustaka itu dipin. Pustaka yang dapat dijangkau di satu workspace tetapi tidak di workspace lain adalah kesalahan yang sama dilihat dari sisi lain.

$import: pustaka menunjuk pustakanya berdasarkan lokasi registry

$import: pustaka menamai pustakanya berdasarkan identitas, tidak pernah berdasarkan registry tempat pustaka itu kebetulan diterbitkan. Registry mana yang dipakai untuk meresolusi sebuah nama adalah konfigurasi workspace, dan versi mana yang dipakai adalah jawaban lockfile, sehingga referensi yang memuat host menetapkan dalam dokumen katalog dua hal yang seharusnya diputuskan build — dan dokumen itu lalu berhenti berfungsi di workspace mana pun yang dikonfigurasi secara berbeda.

Kasus di mana referensi semacam itu masih dapat mencapai penghentian ini lebih sempit daripada kelihatannya. Kolom $import: milik Recipe dan FeatureRecipe sendiri sudah ditolak lebih awal oleh skemanya, yang tidak menerima awalan registry pada ketiga posisi mana pun. Yang tersisa adalah referensi yang tidak dijelaskan skema mana pun: referensi yang dibaca dari isi entri pustaka itu sendiri, yang tidak ditulis oleh entitas yang memakainya dan tidak dapat dilihatnya sampai isi itu diresolusi.

Pesan yang dikeluarkan, dari permukaan valuesMapping: dan workload:, tempat resolver hanya melaporkan nilainya:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" ($import: pustaka memuat host registry; referensikan pustaka berdasarkan identitas nama polos)

Entri artifacts: tidak mencapai penghentian ini, dan alasannya perlu diketahui jika Anda mencarinya di sana. Referensinya sendiri ditolak bersama bagian dokumen lainnya, seperti setiap posisi lain; dan tidak seperti dua permukaan lainnya, file bundle yang isinya sendiri berupa impor ditolak alih-alih diikuti — sehingga tidak ada isi yang dapat menjadi asal referensi yang memuat host.

Cara memperbaiki: hapus host dan semua yang ada sebelum nama pustaka, sehingga tersisa <Library>#<entry-path>. Jika nilai yang bermasalah berada di dalam pustaka yang Anda pakai, bukan yang Anda terbitkan, perbaikannya menjadi tanggung jawab pembuat pustaka itu; sampai perbaikan tersebut tersedia, mengimpor entri lain atau menulis isinya langsung di tempat akan memulihkan build.

Dua output artefak dari satu Recipe memuat nama file yang sama

Blok artifacts: milik Recipe menamai satu output per kunci, dan bundle yang diimpor pada sebuah kunci menyumbangkan file-filenya di bawah kunci itu. Dua output yang tiba pada satu nama file berarti yang satu menimpa yang lain, sehingga build berhenti alih-alih memilih mana yang dipertahankan.

Ini adalah penjaga residu, dan menyatakannya demikian adalah bagian dari hakikatnya. Sebuah output dinamai berdasarkan kunci tempat ia ditulis, kunci mapping bersifat unik dalam satu dokumen, dan permukaan penulisan membatasi sebuah kunci pada satu nama file — sehingga dua entri yang ditulis tidak dapat bertabrakan, dan sebuah kunci juga tidak dapat menuliskan nama bersarang yang dihasilkan bundle milik kunci lain. Yang masih dicakup penjaga ini adalah konten yang mencapai proyeksi tanpa melewati penolakan kunci duplikat milik dokumen yang ditulis: state yang dirakit saat build berjalan alih-alih dibaca dari file. Karena itu, tabrakan yang dilaporkan di sini menunjuk pada cara build dirakit, bukan pada baris yang dapat Anda lihat.

Kondisi ini dimunculkan per Recipe atas output milik Recipe itu sendiri, yang membedakannya dari dua kontributor berbeda yang mendarat pada satu path dalam sebuah perakitan — itu adalah “Two contributors write the same output path (Dua kontributor menulis path output yang sama)” di atas, dengan penyelesaian yang berbeda.

Pesan yang diemisikan:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (tabrakan nama file output artifacts: dua output artefak memuat nama file yang sama (Recipe, output artefak dikeluarkan lebih dari sekali))

Cara memperbaiki: buka Recipe yang disebutkan pesan dan periksa kunci artifacts:-nya terhadap file yang disumbangkan oleh bundle mana pun yang diimpornya. Jika kunci-kuncinya memang berbeda dan tabrakan tetap terjadi, tidak ada yang salah dalam dokumen, dan laporan ini layak disampaikan kepada siapa pun yang memelihara build.

An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Berkas bundle ArtifactLibrary tidak menamai berkasnya sendiri di bawah kunci tempat ia diimpor)

Entri artifacts: yang mengimpor sebuah bundle diperluas menjadi satu output per berkas dalam bundle tersebut, masing-masing bersarang di bawah kunci tempat impor itu ditulis. Jadi kunci tersebut menamai sebuah direktori, dan setiap berkas yang disumbangkan bundle berada di bawahnya, dengan nama sendiri. Nama berkas yang naik keluar dari direktori itu, menamai lokasi absolut, atau tidak menamai apa pun tidak memenuhi hal ini, dan build berhenti alih-alih menempatkan berkas di tempat yang tidak pernah dipilih oleh Recipe yang mengonsumsinya.

Tidak menamai apa pun mencakup setiap nama yang bukan satu-satunya ejaan satu berkas di bawah kunci. . dan ./, serta nama yang kembali runtuh ke kunci seperti x/.., menamai kunci itu sendiri, sehingga berkas akan ditulis di tempat direktori kunci berada. Nama dengan / di akhir atau ganda, atau dengan bagian . atau .. — x/, a//b, ./a, a/./b, a/../b — adalah ejaan kedua dari berkas yang dapat dibawa oleh nama lain: a//b di samping a/b adalah dua nama untuk satu berkas, dan yang satu akan ditimpa oleh yang lain tanpa tabrakan yang dilaporkan. Nama kosong juga ditolak.

Yang dicegahnya adalah penataan ulang diam-diam, bukan penulisan di luar direktori output. Tempat berkas ditulis dijaga lagi, sehingga nama yang naik cukup jauh tetap ditolak di sana. Nama yang lolos dari penjagaan itu adalah nama yang naik tepat satu tingkat: ia mendarat kembali di dalam direktori output, pada posisi yang tidak dipilih siapa pun. Hal itu lebih buruk daripada penulisan yang ditolak, karena setiap penjagaan tabrakan pada jalur ini membaca nama sebagaimana ia disusun, bukan sebagaimana ia di-resolve — sehingga dua berkas seperti itu dapat di-resolve ke satu output tanpa ada yang melaporkan tabrakan, dan mana yang bertahan tidak ditentukan oleh apa pun yang ditulis siapa pun.

Tata letak bersarang yang ditulis secara biasa di dalam kunci tidak tersentuh. Sebuah bundle bebas membawa subdirektorinya sendiri, seperti rbac/role.yaml, dan menyarangkannya di bawah kunci konsumsi adalah tujuan kunci tersebut. Nama yang sekadar mengandung titik di dalam suatu bagian, seperti ..config atau role.v1.yaml, adalah nama biasa.

Recipe yang mengonsumsi dan bundle yang dipublikasikan biasanya ditulis oleh penulis yang berbeda, sehingga pesan menamai kedua sisi bersama dengan perbaikannya.

Entri artifacts: yang ditulis oleh Recipe milik komponen itu sendiri ditentukan sebelum apa pun di-render, sehingga laporan diposisikan pada blok artifacts: di Recipe tersebut dan menamai berkasnya terlebih dahulu, lalu pustaka asalnya dan entri tempat ia dikonsumsi. Setiap berkas bundle yang namanya ditolak dilaporkan dalam satu build; jika lebih dari satu, temuan dikelompokkan di bawah artifacts entries whose library import the compiler cannot resolve:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (nama berkas bundle artifact-library tidak menamai berkasnya sendiri di bawah kunci artifacts tempat output-nya bersarang. ganti nama berkas di dalam bundle ArtifactLibrary menjadi nama berkas biasa di bawah kunci artifacts tempat ia dikonsumsi, seperti “config.yaml” atau “rbac/role.yaml” — tanpa bagian “.” atau “..”, dan tanpa “/” di awal, di akhir, atau ganda)

Entri artifacts: yang ditulis oleh FeatureRecipe melaporkan kondisi yang sama saat bundle di-resolve, dengan menamai recipe tempat ia ditulis dan berkas pertama yang demikian:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (nama berkas bundle artifact-library tidak menamai berkasnya sendiri di bawah kunci artifacts tempat output-nya bersarang. ganti nama berkas di dalam bundle ArtifactLibrary menjadi nama berkas biasa di bawah kunci artifacts tempat ia dikonsumsi, seperti “config.yaml” atau “rbac/role.yaml” — tanpa bagian “.” atau “..”, dan tanpa “/” di awal, di akhir, atau ganda)

Cara memperbaiki: ganti nama berkas di dalam ArtifactLibrary menjadi nama berkas biasa di bawah kunci. Jika pustaka itu bukan milik Anda, mengimpor bundle lain atau menulis entri di tempat akan memulihkan build selagi koreksi dilakukan di hulu. Berkas yang dimaksudkan mendarat di tempat lain sama sekali adalah entri artifacts: kedua pada kunci tempat ia seharusnya berada, bukan nama yang berjalan ke sana.

An imported artifact no longer matches the digest recorded beside its Recipe (Artefak yang diimpor tidak lagi cocok dengan digest yang dicatat di samping Recipe-nya)

Entri artifacts: yang mengimpor berkas lokal kontennya di-pin saat Recipe di-pin — oleh aggrega pin, atau oleh pull atau push yang diminta menjalankan langkah yang sama: digest dari byte berkas dicatat dalam entity.lock di samping Recipe. Entri dari boundary.artifacts: milik Recipe di-pin dan dibandingkan dengan cara yang sama, dicatat di bawah boundary/<key>, yaitu nama yang diberikan pesan kepadanya. Setiap build membaca ulang berkas, menghitung digest-nya lagi, dan menolak ketidakcocokan — sehingga berkas yang diedit setelah di-pin tidak pernah di-render seolah-olah telah diperiksa. aggrega pull --verify melakukan perbandingan yang sama dan melaporkan ketidakcocokan dengan pesan yang sama.

Yang dibandingkan adalah konten entri, bukan hasil render-nya. Isi artefak adalah templat, dan mengevaluasinya menyubstitusikan nilai yang berbeda per instans komponen, sehingga digest atas output akan tidak cocok untuk setiap instans yang nilainya berbeda. Konten yang dicatat adalah teks yang sama untuk setiap instans yang mengikat Recipe, dan itulah yang membuat satu digest yang dicatat menjadi pembanding yang tepat.

Recipe yang belum pernah di-pin tidak memiliki pin di sampingnya, dan build tidak membandingkannya. Ketiadaan pin bukan ketidakcocokan bagi build; artinya tidak ada yang perlu dibandingkan. Pull atas Recipe seperti itu justru berhenti, sebagaimana dijelaskan dalam An entity reads an input the lock beside it records no pin for (Entitas membaca input yang tidak memiliki pin dalam lock di sampingnya). Lockfile yang ditulis sebelum berkas diedit melapor lebih dahulu, karena baris entitas juga mencakup berkas yang diimpor, sebagaimana diuraikan dalam A local source no longer matches the pins recorded beside its Recipe (Sumber lokal tidak lagi cocok dengan pin yang dicatat di samping Recipe-nya), dan bagian yang sama menyebutkan kapan perbandingan ini yang ditemui build.

Tiga permukaan menjalankan pemeriksaan yang sama atas dokumen yang berbeda — Recipe milik komponen itu sendiri, Feature yang dilampirkan ke komponen, dan Feature yang dilampirkan ke boundary — sehingga konten FeatureRecipe diukur terhadap digest yang dicatat di samping FeatureRecipe, bukan di samping Recipe komponen induknya. Pada kedua permukaan lampiran, pesan juga menamai lampirannya, dan itulah yang menunjukkan dokumen mana yang perlu dibuka.

Pesan yang dikeluarkan:

imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (konten artefak yang diimpor tidak cocok dengan digest yang dicatat untuknya dalam entity.lock. Jika berkas sengaja diubah, jalankan aggrega pin pada entitas yang mengimpornya untuk mencatat digest barunya; jika tidak, pulihkan berkasnya) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (konten artefak yang diimpor tidak cocok dengan digest yang dicatat untuknya dalam entity.lock. Jika berkas sengaja diubah, jalankan aggrega pin pada entitas yang mengimpornya untuk mencatat digest barunya; jika tidak, pulihkan berkasnya)

Cara memperbaiki: ada dua jawaban, dan mana yang tepat bergantung pada apakah editan itu disengaja. Jika disengaja, jalankan aggrega pin pada Recipe agar pin diambil kembali dari byte berkas saat ini, lalu commit entity.lock yang ditulis ulangnya. Jika tidak, pulihkan berkasnya — digest yang dicatat adalah catatan byte yang di-pin, dan build yang me-render berkas yang berubah akan mengirimkan konten yang tidak diverifikasi apa pun.

A local source no longer matches the pins recorded beside its Recipe (Sumber lokal tidak lagi cocok dengan pin yang dicatat di samping Recipe-nya)

Recipe atau FeatureRecipe yang source:-nya menyebut direktori atau file di sampingnya akan memiliki sumber tersebut yang di-pin saat entitas di-pin — oleh aggrega pin, atau oleh pull atau push yang diminta menjalankan langkah yang sama. entity.lock di samping entitas mencatat satu digest per file yang disumbangkan sumber ke apa yang dibawa oleh publikasi entitas, dengan kunci berupa path file tersebut. Setelah lock mencatatnya, setiap build membandingkan sumber sebagaimana adanya dengan pin tersebut sebelum provider membacanya, dan menolak ketidaksesuaian — sehingga chart atau modul yang diedit setelah di-pin tidak pernah dirender seolah-olah telah diperiksa. aggrega pull --verify melakukan perbandingan yang sama dan melaporkan ketidaksesuaian dengan pesan yang sama. Build menyebut instans komponen yang sumbernya sedang di-resolve, beserta dokumen Recipe di bawahnya.

Sumber dibandingkan sebagai satu kumpulan file. File yang kontennya berubah, file yang ditambahkan ke sumber, dan file yang dihapus darinya masing-masing mengubah apa yang dirender entitas, sehingga masing-masing dilaporkan, beserta digest yang dimiliki file saat ini dan digest yang dicatat untuknya. File di samping entitas yang tidak disumbangkan oleh sumber — catatan atau README di sebelah Recipe — tidak dibandingkan. Sumber yang ditulis sebagai templat, seperti ./charts/{{ .values.flavour }}, menyumbangkan setiap file di direktori entitas, karena direktori mana yang disebutnya ditentukan oleh setiap Release; untuk bentuk tersebut, perubahan pada file mana pun di direktori itu dilaporkan.

Recipe yang lock-nya tidak mencatat pin untuk sumbernya tidak memiliki apa pun untuk dibandingkan oleh build. Build tidak menolaknya; pull atau push yang tidak melakukan pin akan menolaknya, seperti yang dijelaskan An entity reads an input the lock beside it records no pin for (Entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya). Pin yang masih dicatat lock untuk sumber lokal yang tidak lagi dideklarasikan Recipe tidak mem-pin apa pun yang dibacanya, sehingga pin tersebut tidak dibandingkan dengan apa pun. Recipe yang di-resolve oleh pull dari registry dicakup oleh digest yang dicatat lockfile untuk apa yang dibawa publikasinya.

Lockfile yang ditulis sebelum perubahan melapor lebih dahulu. Lockfile mencatat entitas berdasarkan apa yang dibawanya, dan file sumber termasuk di dalamnya, sehingga build atau aggrega pull --verify yang memegang lockfile yang ditulis sebelum suatu file berubah akan berhenti sebelum perbandingan ini berjalan, dengan The lockfile no longer matches what the release resolves to (Lockfile tidak lagi cocok dengan hasil resolve release) yang menyebut entitas dan kedua digest. aggrega pull biasa menyebut file yang berubah, dengan An entity reads an input the lock beside it records no pin for (Entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya). Hal yang sama berlaku untuk file yang diimpor. Jika lockfile tidak memiliki entri milik entitas itu sendiri, perbandingan inilah yang ditemui build dan pull yang memverifikasi: Recipe atau FeatureRecipe yang disebut Manifest dengan referensi yang juga merupakan nama Component atau Feature yang dijangkau Release dicatat di bawah referensi tersebut sebagai Component atau Feature, sehingga tidak ada apa pun di lockfile yang berubah ketika file Recipe berubah.

Pesan yang dikeluarkan:

the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (file sumber lokal entitas tidak cocok dengan pin yang dicatat untuknya di entity.lock (digest file adalah … dan pin yang dicatatnya adalah …). Jika sumber diubah dengan sengaja, jalankan aggrega pin pada entitas untuk mencatat ulang file-nya; jika tidak, pulihkan file tersebut) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (file sumber lokal entitas tidak cocok dengan pin yang dicatat untuknya di entity.lock (digest file adalah … dan tidak ada pin yang dicatat untuknya). Jika sumber diubah dengan sengaja, jalankan aggrega pin pada entitas untuk mencatat ulang file-nya; jika tidak, pulihkan file tersebut) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (file sumber lokal entitas tidak cocok dengan pin yang dicatat untuknya di entity.lock (file tidak lagi ada di sumber dan pin yang dicatatnya adalah …). Jika sumber diubah dengan sengaja, jalankan aggrega pin pada entitas untuk mencatat ulang file-nya; jika tidak, pulihkan file tersebut)

Cara memperbaiki: seperti untuk file yang diimpor, ada dua jawaban, dan mana yang tepat bergantung pada apakah perubahan itu disengaja. Jika disengaja, jalankan aggrega pin pada Recipe agar file sumbernya di-pin ulang, lalu commit entity.lock yang ditulis ulangnya. Jika tidak disengaja, pulihkan file yang disebut pesan tersebut.

Setiap file yang dibawa publikasi entitas dibaca dari direktori entitas itu sendiri, dan tautan simbolis di sana ditolak alih-alih diikuti. Mengikutinya akan memublikasikan byte yang ditunjuknya dengan nama tautan itu sendiri — dari mana pun ia menunjuk, termasuk di luar direktori entitas — ke dalam artefak yang kemudian di-digest dan, jika penandatanganan berlaku, ditandatangani. Melewatinya justru akan memublikasikan artefak yang kontennya diam-diam berbeda dari direktori Anda. Karena itu setiap bentuk tautan ditolak dengan cara yang sama: tautan ke file, tautan ke direktori, tautan yang tidak menunjuk ke mana pun, tautan yang menunjuk ke dirinya sendiri, dan dua tautan yang saling menunjuk.

Penolakan dilakukan di mana pun file entitas dibaca: oleh aggrega pin, oleh publikasi sebelum mengemas apa pun (termasuk dry run), oleh pull dan pull yang memverifikasi yang mencocokkan entity.lock dengan file entitas, oleh build yang membandingkan sumber lokal dengan pin-nya, dan oleh render yang membaca direktori sumber lokal sebelum provider menerima bagian apa pun darinya. Pesan menyebut tautan berdasarkan path-nya di samping dokumen entitas, dan diagnostik diposisikan pada tautan itu sendiri.

Tautan yang dikecualikan oleh aturan ignore Anda bukanlah file yang dibawa entitas, sehingga tautan itu dilewati seperti file lain yang dikecualikan aturan tersebut, dan tidak pernah diikuti. Aturan tersebut adalah aturan yang dicatat di entity.lock saat entitas di-pin, sehingga baris yang Anda tambahkan ke .aggregaignore berlaku saat Anda mem-pin ulang entitas.

Pesan yang diemisikan:

a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (tautan simbolis berada di antara file yang dibawa entitas. remediasi: ganti tautan dengan salinan dari apa yang ditunjuknya, ditempatkan di dalam direktori entitas itu sendiri. Tautan yang ditemukan di dalam direktori sumber dapat dikecualikan dengan sebuah baris di .aggregaignore di samping entitas, yang berlaku saat entitas di-pin ulang. Tautan ditolak alih-alih diikuti karena byte yang ditunjuknya akan terbawa dengan nama tautan, dari mana pun ia menunjuk)

Cara memperbaiki: jika entitas memerlukan apa yang ditunjuk tautan, ganti tautan dengan salinannya di dalam direktori entitas, lalu pin ulang entitas. Jika tautan ada untuk kemudahan Anda sendiri dan entitas tidak membacanya, tambahkan path-nya ke .aggregaignore di samping dokumen entitas lalu pin ulang. File mana yang dikirim bersama entitas menjelaskan aturan yang menentukan apa yang dibawa entitas.

An entity reads an input the lock beside it records no pin for (Sebuah entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya)

Sebuah Recipe atau FeatureRecipe dapat bergantung pada byte di luar dokumennya sendiri: source: jarak jauh yang koordinatnya ditulis lengkap, file yang diimpor oleh entri artifacts dengan $import, dan file dari source: yang menyebut direktori atau file di sampingnya. Pin untuk masing-masing dicatat dalam entity.lock di samping entitas, dan pencatatannya adalah langkah penulis entitas, yaitu aggrega pin. Jadi sebuah pull tidak mencatat pin tersebut dengan sendirinya: atas entitas di salah satu direktori katalog Anda yang dibangun oleh Release, pull membandingkan apa yang akan dicatat langkah itu dengan isi lock, dan berhenti ketika lock tidak memiliki sebuah pin — atau memiliki pin yang tidak lagi cocok dengan input — alih-alih menulis ke direktori penulis tanpa diminta. Build yang mengisi lockfile-nya sendiri adalah sebuah pull dan berhenti dengan cara yang sama.

Sebuah push berhenti pada perbandingan yang sama, atas satu entitas yang akan dipublikasikannya. Sebelum bundle dibangun, dan sebelum registry mana pun dihubungi, push membandingkan apa yang akan dicatat langkah itu untuk entitas dengan lock di sampingnya, dan menolak dengan cara yang sama — termasuk dry run — kecuali push diminta menjalankan langkah itu sendiri. Saran di akhir pesan berbeda di antara keduanya, karena setiap perintah memiliki caranya sendiri untuk mencatat pin; apa yang dilaporkannya tidak berbeda.

Sumber lokal dicocokkan dengan pin-nya sebagai satu himpunan file. Jika lock tidak mencatat satu pun, setiap file yang dikontribusikan sumber dilaporkan di sini sebagai hilang. Jika lock mencatatnya, file yang ditambahkan sejak pin dilaporkan sebagai hilang, dan file yang diubah atau dihapus sebagai pin yang tidak lagi cocok dengan input, dan sebuah build melaporkan perubahan yang sama sebagai A local source no longer matches the pins recorded beside its Recipe (Sumber lokal tidak lagi cocok dengan pin yang dicatat di samping Recipe-nya). Pin yang masih dicatat lock untuk sumber lokal yang tidak lagi dideklarasikan Recipe — source:-nya dihapus, atau kini menyebut artefak jarak jauh — tidak mem-pin apa pun yang dibaca Recipe, sehingga tidak menghentikan pull, push, pull verifikasi, maupun build; aggrega pin berikutnya membuangnya.

Pesan menyebut setiap input yang hilang, menurut kelasnya. Masing-masing adalah remote source, disebut dengan url-nya dan versi hasil resolusinya, imported file, disebut dengan kunci artifacts yang menggunakannya, atau local source file, disebut dengan path-nya di samping entitas — sehingga Anda tahu apakah yang perlu di-pin adalah sumber atau file. Setiap entitas semacam itu dalam Release dilaporkan dalam satu kali jalan.

Entitas yang diresolusi dari registry tidak pernah dicocokkan dengan ini oleh pull, karena publikasinya sudah dicocokkan. Entitas itu berada di cache konten, bukan di direktori yang Anda tulis, sehingga pull tidak membaca maupun menulis lock di sampingnya, dan sumbernya dicocokkan dengan lockfile Release. Entitas yang dipublikasikan dengan aggrega push ditolak saat publikasi kecuali lock-nya mencatat setiap pin yang akan dicatat langkah itu untuknya saat itu, dan lock tersebut ikut di dalam bundle yang dipublikasikan.

Pesan yang dikeluarkan, dari pull dan dari push:

an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (input yang dibaca entitas tidak memiliki pin yang dicatat di entity.lock di sampingnya (Recipe, sumber jarak jauh: tidak ada pin yang dicatat, file yang diimpor: pin yang dicatat tidak lagi cocok). perbaikan: jalankan aggrega pin dan commit entity.lock yang ditulisnya di samping entitas; agar setiap pull di workspace ini mencatat pin sendiri, atur opsi tersebut di konfigurasi workspace) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (input yang dibaca entitas tidak memiliki pin yang dicatat di entity.lock di sampingnya (Recipe, sumber jarak jauh: tidak ada pin yang dicatat). perbaikan: jalankan aggrega pin dan commit entity.lock yang ditulisnya di samping entitas; agar publikasi ini mencatat pin sendiri, jalankan ulang dengan opsi tersebut; agar setiap publikasi di workspace ini mencatatnya, atur opsi tersebut di konfigurasi workspace)

Klausa tengah pada pesan publikasi menyebut apa yang diterima oleh antarmuka tempat Anda memublikasikan: --pin-sources di terminal, field pinSources pada daemon, dan argumen pin_sources untuk alat asisten.

Cara memperbaiki: jika entitas itu milik Anda, jalankan aggrega pin padanya dan commit entity.lock yang ditulisnya, lalu lakukan pull atau push lagi — atau push dengan --pin-sources, yang menjalankan langkah itu sebelum bundle dibangun. Jika entitas itu milik orang lain — katalog yang Anda gunakan dari direktorinya sendiri — penerbitnya belum mem-pin-nya; atur pin_sources_at_pull: true di konfigurasi workspace Anda agar setiap pull mencatat pin sendiri, atau berikan --pin-sources pada satu pull. aggrega pin menjelaskan langkah tersebut secara lengkap.

A provides: template could not be evaluated (Templat provides tidak dapat dievaluasi)

Entri provides: adalah templat yang menghasilkan nilai yang dibaca komponen lain melalui koneksi dependensi. Kondisi ini adalah yang dilaporkan oleh entri yang tidak dapat dievaluasi: templat yang tidak dapat di-parse, fungsi yang dipanggilnya tetapi tidak didaftarkan oleh antarmuka ini, referensi yang menelusuri sesuatu yang tidak disediakan oleh konteks render, atau pembacaan index atas kunci yang tidak ada di map.

Kondisi ini berbeda dari dua penolakan yang berjalan sebelum evaluasi pada blok yang sama — referensi ke root di luar himpunan mandiri, dan referensi yang ditolak oleh urutan penulisan blok itu sendiri — keduanya didokumentasikan di atas. Keduanya menyebut ekspresi yang perlu diubah; kondisi ini membawa apa pun yang dilaporkan oleh evaluasi itu sendiri, itulah sebabnya entri disebut di sampingnya.

Pesan yang dikeluarkan, menyebut instans komponen, entri di dalam blok, dan apa yang dilaporkan evaluasi:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (evaluasi templat provides gagal (node, provides[], apa yang dilaporkan evaluasi))

Bagian kepala membawa kode kondisi ini, E0056, apa pun yang dilaporkan evaluasi. Jika evaluasi berhenti pada kondisi penghentiannya sendiri — yang paling umum adalah pembacaan index atas kunci yang tidak dimiliki map — kondisi itu dilaporkan di bawah kondisi ini, bukan menggantikannya: di bawah caused by (2):, kalimat kondisi ini muncul lebih dulu dan laporan evaluasi itu sendiri kedua, termasuk kalimatnya. Jadi, pembaca yang mencocokkan kode mengaitkan setiap entri provides: yang gagal dengan E0056, dan membaca apa yang membuat evaluasi gagal dari kondisi di bawahnya, yang kalimatnya merujuk ke kodenya sendiri di tabel semua kondisi — E0327 untuk kunci yang tidak ada.

Cara memperbaiki: buka blok provides: milik Recipe pada kunci yang disebut pesan dan baca alasan yang dilaporkan — biasanya menyebut posisi parse atau sebuah fungsi. Penanganan kunci yang hilang pada antarmuka ini merender kunci akhir yang tidak ada sebagai kosong alih-alih gagal, sehingga kegagalan di sini adalah kesalahan struktural: templat yang tidak dapat di-parse, referensi yang menelusuri wadah yang tidak pernah disediakan, atau pembacaan index atas kunci yang tidak ada di map, yang disebut oleh alasan yang dilaporkan. Jika nilainya memang opsional, bacalah melalui helper optional alih-alih menelusuri sesuatu yang mungkin tidak ada.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Recipe atau FeatureRecipe tidak menerbitkan kunci yang dideklarasikan kontraknya)

Sebuah Component dan sebuah Feature masing-masing mendeklarasikan, di bawah schema.provides, kunci-kunci yang akan diterbitkan oleh apa pun yang mengikatnya — kontrak keluaran yang menjadi acuan konsumen saat menulis koneksinya. Recipe yang terikat pada sebuah Component dan FeatureRecipe yang terikat pada sebuah Feature harus menghasilkan setiap kunci yang disebutkan kontrak tersebut. Yang tidak melakukannya ditolak, karena kunci yang hilang itu sebaliknya tidak akan mengirimkan apa pun: referensi konsumen akan tiba sebagai variabel yang tidak diatur, argumen kosong, atau berkas yang tidak ada, tanpa penjelasan apa pun mengenai sebabnya.

Kontraknya adalah keberadaan kunci, dan tidak lebih. Setiap kunci yang dideklarasikan harus muncul; kunci tambahan diperbolehkan. Nilai-nilainya sendiri tidak pernah diperiksa — nilai tersebut adalah penunjuk buram yang dialirkan sebagai string, sehingga tipe yang dideklarasikan kontrak tetap menjadi pernyataan kepada konsumen, bukan pemeriksaan yang dilakukan build.

Setiap kekurangan dilaporkan. Recipe yang kekurangan tiga kunci memunculkan tiga temuan, masing-masing diposisikan pada entrinya sendiri di blok provides: Recipe tersebut, sehingga ketiganya dapat diperbaiki dari satu build. Pesan tersebut menyebutkan kunci yang hilang, tipe yang kontraknya mendeklarasikan kunci itu, dan instans tempat Recipe diikat — yang terakhir inilah yang membedakan dua temuan ketika satu Recipe melayani beberapa instans dari satu tipe.

Pesan yang diemisikan:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (Recipe atau FeatureRecipe tidak menerbitkan kunci provides yang dideklarasikan kontrak schema.provides milik entitas abstraknya; dideklarasikan oleh tipe komponen, terikat pada instans komponen)

Pemasangan Feature-dan-FeatureRecipe melaporkan kondisi yang sama melalui resolusi lampirannya sendiri, dengan menyebutkan pasangan dan kuncinya:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (Recipe atau FeatureRecipe tidak menerbitkan kunci provides yang dideklarasikan kontrak schema.provides milik entitas abstraknya; FeatureRecipe tidak menerbitkan kunci provides yang dideklarasikan kontrak schema.provides milik Feature)

Di sana kondisi ini melaporkan kunci hilang pertama dalam urutan tersortir lalu berhenti, sehingga pemasangan tersebut menyebutkan satu kunci per build, sementara pemasangan Component menyebutkan semuanya. Kunci-kunci ditelusuri dalam urutan tersortir pada kedua kasus, dan itulah yang membuat keduanya sama di setiap eksekusi.

Cara memperbaiki: tambahkan kunci yang hilang ke blok provides: milik Recipe atau FeatureRecipe, atau hapus kunci tersebut dari schema.provides milik Component atau Feature jika memang tidak ada yang diharapkan menerbitkannya. Kunci yang templatnya dirender menjadi kosong tetap diterbitkan, dengan string kosong sebagai nilainya, sehingga entri yang ada dan kosong memenuhi kontrak dan tidak dilaporkan di sini. Jika nilai kosong harus menghentikan build, tolak nilai itu dalam sebuah asersi: asersi sebuah Recipe membaca nilai provides: yang telah diresolusi.

An assertion stopped the build (Sebuah asersi menghentikan build)

Sebuah Component, Feature, Recipe, atau FeatureRecipe dapat membawa assertions: — templat bernama yang tujuannya menolak suatu masukan, bukan menghasilkan teks. Asersi memanggil fail, dan memanggilnya itulah yang menghentikan build; argumennya adalah pesan yang ditulis penulisnya untuk siapa pun yang menjumpainya.

Asersi dievaluasi pada dua titik, sehingga suatu aturan membaca keadaan yang menjadi pokoknya: asersi pada Component atau Feature dijalankan setelah katalog diresolusi dan sebelum apa pun dirender, sedangkan asersi pada Recipe atau FeatureRecipe dijalankan setelah pengikatan ditetapkan dan sebelum pengikatan itu dirender.

Referensi ke kunci yang tidak disediakan oleh apa pun juga dilaporkan di sini. Permukaan ini mengevaluasi dengan penanganan kunci hilang yang ketat, justru agar predikat yang referensinya dirender kosong tidak dapat dibandingkan dengan kekosongan lalu lolos diam-diam — satu salah ketik saja sebaliknya akan mematikan aturan yang hendak ditegakkan asersi tersebut. Inilah sebabnya default biasa tidak menyediakan nilai cadangan pada permukaan ini: referensi telanjang menghentikan evaluasi sebelum nilai cadangan dapat dijalankan. Lindungi referensi dengan hasKey, atau gunakan helper optional; membacanya melalui index juga menghentikan build, dengan menyebutkan kuncinya, sebagaimana dijelaskan dalam “A template indexes a map with a key the map does not hold (Sebuah templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)”.

Pesan yang dikeluarkan, menyebutkan jenis dan tipe entitas, instans, dan asersinya, lalu membawa pesan yang ditulis asersi itu sendiri:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (galat saat memanggil fail: asersi gagal)

dan untuk kunci yang tidak disediakan apa pun, kalimat mesin templat setelah kalimat kondisi itu sendiri:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (asersi gagal: saat templat dijalankan, map tidak memiliki entri untuk kunci tersebut)

dan jika yang gagal adalah evaluasinya, bukan predikatnya:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (instans, asersi: asersi, penguraian)

Nilai yang dideklarasikan sensitif tidak muncul dalam pesan. Jika asersi membaca nilai seperti itu dan memanggil fail dengan kalimatnya yang ditulis utuh sebagai satu string bertanda kutip — fail "…", tanpa apa pun yang di-pipe ke dalamnya dan tanpa apa pun yang disusun — pesan tersebut memuat kalimat itu sebagaimana tertulis, apa pun isi nilainya, karena kalimat itu tidak mengutip apa pun yang dibaca asersi. Jika pesannya mengutip nilai tersebut, pesan menampilkan <redacted> di tempat nilai itu. Jika pesan disusun dengan cara lain apa pun dan apa yang dilakukan asersi bergantung pada isi nilai tersebut, pesan setelah ekspresi yang gagal diganti dengan failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds; penghentian dan kodenya tidak berubah. Apa yang dianggap dideklarasikan, dan penolakan mana yang berada di luar ketentuan ini, dijelaskan di vocabulary/compact-form-authoring.md “Apa yang dikatakan penolakan tentang nilai yang dideklarasikan”.

Jika diperiksa secara tersendiri, sebuah entitas melaporkan asersi yang gagal sebagai peringatan. aggrega validate yang diberi berkas sebuah Recipe, pemeriksaan editor atas berkas itu melalui aggrega serve, dan alat validate dari aggrega mcp yang diberi sebuah entity membangun Recipe di sekitar placeholder dan nilai bawaan skema, bukan nilai yang diatur oleh sebuah Release, sehingga tidak dapat membedakan asersi yang menunggu sebuah Release dari asersi yang rusak. Di sana, asersi yang memanggil fail — milik Recipe itu sendiri, atau yang dideklarasikan oleh Component yang diimplementasikannya — dilaporkan sebagai peringatan yang membawa pesan di atas, ditutup dengan kalimat A Release must satisfy this assertion before a build of it can pass., dan pemeriksaan lolos. Referensi ke kunci yang tidak disediakan oleh apa pun dan asersi yang tidak dapat diurai bukanlah asersi yang gagal: masing-masing adalah kesalahan dalam teks asersi itu sendiri, dan pemeriksaan tersebut menilainya seperti menilai kesalahan lainnya. Sebuah build selalu memiliki Release, dan berhenti pada asersi sebagaimana dijelaskan di sini; lihat asersi yang gagal adalah peringatan.

Cara memperbaiki: pesan setelah titik dua terakhir adalah milik penulis asersi, dan pesan itulah yang menyatakan apa yang harus diubah — asersi ditulis sedemikian rupa sehingga menjumpainya memberi tahu Anda jawabannya. Jika yang dilaporkan adalah kunci yang hilang alih-alih kalimat penulis, asersi itu sendirilah yang bermasalah: perbaiki referensinya, atau lindungi seperti dijelaskan di atas. Jika aturan tersebut seharusnya tidak berlaku untuk Release ini, itu adalah pertanyaan tentang entitas yang membawa asersi, bukan tentang berkas Anda sendiri.

Langkah pipeline menunjuk dokumen yang tidak dimiliki node

Langkah pipeline menunjuk sebuah dokumen melalui cakupan dan kunci. Tiga kondisi mencakup cara-cara sebuah alamat tidak mencapai apa pun, dan masing-masing menghentikan build alih-alih membiarkan langkah melaporkan keberhasilan atas suntingan yang tidak pernah terjadi.

Node tidak mengeluarkannya. Sebuah patch menyebut pasangan cakupan dan kunci yang tidak termasuk dokumen yang dihasilkan node ini:

node "<instance>": pipeline PATCH targets a document the node did not emit (PATCH pipeline menargetkan dokumen yang tidak dikeluarkan node)

Tidak ada host untuk dituju. Sebuah langkah menjangkau dokumen komponen host di situs yang tidak berhadapan dengan host mana pun — pipeline milik komponen itu sendiri, yang satu-satunya cakupannya adalah keluarannya sendiri, atau Feature yang dilampirkan ke batas, bukan ke satu komponen. Cakupan host kosong di mana pun pipeline semacam itu berjalan, sehingga alamat ke dalamnya tidak menunjuk apa pun:

node "<instance>": pipeline /host operation from a step with no host component (operasi /host pipeline dari langkah tanpa komponen host)

Dokumen tidak memiliki pohon untuk dituju. Beberapa unit tidak memiliki struktur yang dapat ditunjuk oleh path — badan biner, teks bebas, wilayah yang tidak dapat ditelusuri target dengan aman. Unit semacam itu tetap diserahkan ke langkah agar dapat dipilih dan dikeluarkan secara utuh; yang tidak dapat dilakukan padanya adalah patch:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (target PATCH pipeline bukan YAML/JSON terstruktur yang dapat diurai) pipeline PATCH target is not parseable structured YAML/JSON (target PATCH pipeline bukan YAML/JSON terstruktur yang dapat diurai) (node "<instance>", dokumen "<key>")

Masing-masing datang bersama penjelasan penelusuran itu sendiri tentang alamat di bawahnya, dan masing-masing diposisikan pada instans komponen yang pipeline-nya membuatnya.

Dua dari ketiganya juga dilaporkan sebelum penelusuran apa pun. Ada atau tidaknya dokumen host di suatu situs ditentukan oleh tempat pipeline ditulis, sehingga langkah yang menyatakan bekerja pada dokumen host di situs yang tidak memilikinya disebutkan begitu build mengetahui apa yang dinyatakan setiap plugin, tanpa menunggu node dirender — dan Feature yang dilampirkan ke batas disebutkan bersama langkah tersebut:

pipeline /host operation from a step with no host component (operasi /host pipeline dari langkah tanpa komponen host) pipeline /host operation from a step with no host component (operasi /host pipeline dari langkah tanpa komponen host) ("<attachment>")

Kedua pembacaan itu adalah pembagian satu kondisi, bukan temuan yang sama dua kali: apa yang dapat diputuskan oleh deklarasi diputuskan dari deklarasi, dan apa yang hanya dapat dilihat saat eksekusi tetap pada eksekusi — langkah yang menyatakan cakupannya sendiri masih dapat mengembalikan operasi terhadap cakupan lain.

Ketiganya adalah bentuk penghenti build dari penolakan pengalamatan yang dilaporkan oleh penelusuran pipeline itu sendiri, yang didokumentasikan di bawah “A pipeline patch addresses a document the set does not hold, or one with no tree to address (Patch pipeline menunjuk dokumen yang tidak ada dalam himpunan, atau dokumen tanpa pohon untuk dituju)” di atas.

Cara memperbaiki: ketiganya merupakan urusan penulis langkah, bukan Anda. Untuk target yang tidak ada, patch dokumen yang memang dikeluarkan node, atau keluarkan dokumen yang Anda maksud di langkah sebelumnya lalu patch di langkah berikutnya — sebuah langkah dapat membaca kunci mana yang diserahkan kepadanya. Untuk host yang tidak ada, pindahkan langkah ke situs yang berhadapan dengan komponen host, tujukan ke dokumen situs itu sendiri, atau hapus langkahnya. Untuk unit tanpa pohon, ganti patch dengan emit seluruh unit: badan yang opak diganti, bukan disunting.

Patch pipeline menunjuk keluaran yang belum dirakit

Beberapa provider melipat keluaran per node dari sebuah grup dispatch menjadi satu dokumen — file compose gabungan, chart payung. Sebelum penggabungan itu terjadi, tidak ada dokumen yang terpisah, hanya fragmen, sehingga patch yang menunjuk salah satunya tidak memiliki apa pun untuk dituju. Karena itu, pipeline terhadap komponen semacam itu ditunda secara utuh dan diputar ulang setelah penggabungan menghasilkan dokumen, yang merupakan jalur biasa dan tidak memerlukan apa pun dari penulis.

Kondisi ini yang sampai ke build ketika sebuah patch tetap tiba pada fragmen. Kasus yang disebutnya adalah keluaran Feature terlampir itu sendiri. Bila provider komponen melipat grupnya, seluruh pipeline lampiran ditahan sampai penggabungan menghasilkan dokumen — dan yang diserahkan kepada pemutaran ulang itu hanyalah dokumen komponen. Langkah terhadap keluaran Feature itu sendiri hanya ditawarkan selama komponen dirender, yaitu sebelum penggabungan apa pun terjadi, sehingga tidak ada yang dapat dituju. Hal itu berlaku bagaimana pun keluaran Feature itu disalurkan: baik bergabung dalam penggabungan maupun ditulis sebagai dokumen tersendiri, cakupannya sendiri tidak pernah menjadi cakupan yang dibawa pemutaran ulang.

Emit tidak pernah terpengaruh. Emit menambahkan dokumen alih-alih menyunting dokumen, dan berjalan per node untuk setiap provider, sehingga sepenuhnya berada di luar kondisi ini.

Kondisi ini dilaporkan sebelum penelusuran apa pun, dari apa yang dinyatakan plugin dan provider, dan sekali lagi sebagai batas bawah selama node dirender. Pesan yang dikeluarkan:

pipeline PATCH targets an assembler provider’s pre-assembly fragments (PATCH pipeline menargetkan fragmen pra-perakitan milik provider perakit) ("<attachment>") pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (PATCH pipeline menargetkan fragmen pra-perakitan milik provider perakit (dokumen cakupan dirender oleh provider perakit). fase pasca-perakitan menjalankan ulang PATCH ini setelah dokumen terpisah)

Cara memperbaiki: tujukan ke dokumen komponen alih-alih dokumen Feature itu sendiri, yaitu bentuk yang diputar ulang setelah penggabungan; atau tempatkan komponen pada provider yang tidak melipat grup dispatch-nya; atau hapus langkahnya. Mana dari ketiganya yang tepat bergantung pada apa yang hendak diubah oleh langkah itu, dan pesan menyebutkan cakupan yang dituju agar Anda dapat mengetahuinya. Mengubah capability: milik FeatureRecipe itu sendiri tidak termasuk di dalamnya: hal itu tidak mengubah cakupan mana yang diserahkan kepada pemutaran ulang setelah penggabungan, dan itulah inti kondisi ini.

Plugin langkah pipeline tidak mengklaim provider yang merender apa yang ditujunya

Plugin yang digunakan oleh langkah pipeline dapat menyatakan provider yang telah diujinya. Daftar itu adalah klaim eksplisit, bukan “apa pun yang serupa” secara implisit: menjalankan plugin terhadap provider yang tidak disebutkannya berisiko menerapkan patch yang ditulis untuk bentuk keluaran lain, sehingga build berhenti alih-alih mencobanya.

Provider yang dicocokkan dengan sebuah langkah adalah provider yang merender dokumen yang dituju langkah itu — provider milik komponen untuk langkah terhadap dokumen komponen, dan provider milik Feature untuk langkah terhadap dokumen Feature. Pada Feature yang dilampirkan ke komponen, keduanya muncul, dan keduanya adalah dua nilai berbeda dari dua dokumen berbeda.

Daftar klaim yang kosong atau tidak ada tidak cocok dengan apa pun, sehingga setiap langkah yang menggunakan plugin semacam itu dilaporkan di sini. Plugin yang tidak dapat ditanyai oleh build adalah kasus lain dan tidak dilaporkan di sini: laporan diri yang tidak dapat diperoleh adalah ketiadaan klaim, bukan klaim kosong, dan langkah semacam itu berhenti dengan kegagalan resolusi, pemuatan, atau laporan diri itu sendiri, yang merupakan hal yang perlu diperbaiki.

Kondisi ini dilaporkan setelah build mengetahui apa yang dideklarasikan setiap plugin tentang dirinya sendiri, sebelum eksekusi yang akan memanggil langkah tersebut, dan sekali per langkah yang ditulis, bukan sekali per build — sehingga seorang penulis melihat setiap langkah bermasalah dari sebuah pipeline dalam satu build. Nama-nama Provider dicocokkan secara persis.

Pesan yang dikeluarkan, yang pertama dari pipeline milik komponen dan yang kedua dari pipeline Feature, yang juga menyebutkan lampirannya:

pipeline plugin is not compatible with the rendering provider (plugin pipeline tidak kompatibel dengan provider yang merender) ("<provider>") pipeline plugin is not compatible with the rendering provider (plugin pipeline tidak kompatibel dengan provider yang merender) ("<attachment>", "<provider>")

Cara memperbaiki: temuan diposisikan pada langkah yang ditulis, dan provider yang disebutkannya adalah acuan yang harus diselaraskan dengan deklarasi. Bila plugin itu milik Anda, tambahkan provider tersebut ke kompatibilitas yang dinyatakannya setelah Anda mengujinya. Bila bukan, pilih versi plugin yang mengklaim provider tersebut, render cakupan itu melalui provider yang memang diklaim plugin, atau hapus langkahnya.

A provider refused a node’s input (Sebuah provider menolak input sebuah node)

Sebuah provider dapat memeriksa input yang diserahkan kepadanya untuk sebuah komponen sebelum merendernya, dan melaporkan apa yang ditemukannya. Temuan dengan tingkat keparahan halt menghentikan build; temuan dengan tingkat keparahan peringatan dan informasi ditampilkan bersama output build dan tidak mengubah apa pun pada byte yang dihasilkan.

Ini adalah pembacaan provider itu sendiri atas input Anda, bukan pembacaan compiler, sehingga apa yang ditolaknya dan seberapa spesifik ia menyampaikannya ditentukan oleh provider. Compiler menyebutkan komponen dan provider, serta meneruskan pesan provider sebagaimana dikembalikan; jika sebuah provider melaporkan beberapa pesan, pesan-pesan itu tiba bersama dipisahkan oleh titik koma, sehingga satu build memberi tahu Anda semuanya.

Perutean yang sama digunakan baik input tersebut milik Recipe komponen itu sendiri maupun milik Feature yang dilampirkan, sehingga pemeriksaan provider terbaca identik pada keduanya.

Pesan yang diemisikan:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (provider menolak input node: node, provider: pesan-pesan provider)

Cara memperbaiki: baca pesan-pesan provider — pesan itu menyebutkan apa dalam input yang telah di-resolve yang tidak dapat diterimanya. Input disusun dari nilai-nilai Recipe dan konfigurasi komponen itu sendiri, sehingga koreksinya biasanya ada di salah satunya; halaman referensi provider itu sendiri menjelaskan apa yang diperlukannya. Jika provider menolak sesuatu yang tidak dapat Anda ubah dari sebuah dokumen, hal itu perlu ditanyakan kepada siapa pun yang menulis Recipe atau plugin tersebut.

A provider rendered the same input twice and produced different output (Sebuah provider merender input yang sama dua kali dan menghasilkan output yang berbeda)

Dengan input yang identik, sebuah build menghasilkan output yang identik — itulah kontrak yang menjadi acuan alat peninjauan dan perkakas deployment saat membaca hasil build. Mode build opsional memeriksanya secara langsung: setiap komponen dirender dua kali dari input yang sama dan byte yang dihasilkan dibandingkan. Provider yang dua hasil rendernya tidak sama membawa state di antara keduanya, atau dengan cara lain bukan merupakan fungsi dari inputnya, dan build dihentikan.

Build biasa merender setiap komponen satu kali, sehingga kondisi ini hanya pernah dijumpai dalam mode pemeriksaan. Tidak ada yang berubah pada build normal karena mode ini tersedia.

Yang dibandingkan adalah output mentah yang dihasilkan provider — byte yang sama yang menjadi sumber pemotongan artefak hasil render — sehingga perbedaan di mana pun dalam apa yang dihasilkannya akan tertangkap, bukan hanya perbedaan yang bertahan hingga file akhir.

Pesan yang diemisikan:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (merender node: node (provider): dua render dari input identik menghasilkan output berbeda: render provider tidak deterministik)

Cara memperbaiki: pertama, temukan apa yang berbeda di antara dua build dari komponen yang disebutkan pesan — build komponen itu dua kali dan bandingkan output-nya. Jika perbedaannya adalah nilai yang dibuat ulang oleh chart yang Anda gunakan sebagai sumber pada setiap render — kata sandi acak, kunci yang dihasilkan, stempel waktu dalam Secret atau ConfigMap — kesalahannya ada pada output chart tersebut, bukan pada provider, dan Anda dapat mengatasinya sendiri dengan salah satu dari dua cara. Berikan nilai tersebut, melalui pengaturan apa pun yang ditawarkan chart untuknya, dari valuesMapping: milik Recipe, sehingga chart berhenti menghasilkannya. Atau, jika dokumen yang dihasilkan adalah dokumen yang tidak boleh dikirim oleh Release — misalnya Secret yang disediakan operator secara terpisah — keluarkan dokumen itu dari build dengan entri omits: pada Recipe; lihat Recipe → Field omits:. Selain itu, kesalahannya ada pada provider, bukan pada dokumen Anda, dan tidak ada yang dapat Anda tulis untuk mengatasinya. Laporkan kepada siapa pun yang menerbitkan plugin yang melayani provider tersebut, dengan menyebutkan komponen yang diidentifikasi pesan — penyebab umumnya adalah stempel waktu, nilai acak, atau urutan yang mengikuti iterasi map alih-alih urutan yang ditulis penulis. Sampai hal itu diperbaiki, mode build biasa tidak terpengaruh, dan menyematkan plugin ke versi yang lolos adalah jawaban praktisnya.

An omits entry left out nothing the source rendered (Sebuah entri omits tidak mengeluarkan apa pun yang dirender sumber)

Setiap entri dalam daftar omits: milik Recipe atau FeatureRecipe yang berlaku untuk sebuah build — dengan when: yang tidak ada, kosong, atau bernilai true — harus mengeluarkan setidaknya satu hal yang dirender sumber dari output: dokumen yang dirender sebuah chart, service, volume, atau config yang dideklarasikan file compose, atau resource yang dideklarasikan template CloudFormation. Provider yang merender sumber mencocokkan setiap entri dengan apa yang direndernya dan melaporkan berapa banyak unit yang dikeluarkan masing-masing entri; entri yang tidak mengeluarkan apa pun menghentikan build.

Entri yang tidak cocok dengan apa pun adalah pernyataan tentang sumber yang tidak lagi benar. Penyebab umumnya adalah peningkatan versi sumber yang mengganti nama atau menghapus apa yang disebutkan entri — dan dokumen atau service yang diganti namanya kemudian ada di output dengan nama barunya, yang justru ingin dicegah oleh entri tersebut — dan penyebab lainnya adalah kesalahan pada entri itu sendiri. Mengabaikannya berarti mengirimkan apa yang seharusnya dikeluarkan oleh entri, sehingga build dihentikan dan entri tersebut disebutkan.

Pesan menyebutkan node, provider, dokumen yang mendeklarasikan entri, dan posisi entri dalam daftar omits: dokumen tersebut, dihitung dari 0, serta kind, nama, dan namespace hasil resolve entri, dengan namespace hanya jika entri menyebutkannya. Untuk FeatureRecipe yang dilampirkan ke sebuah komponen, node-nya adalah komponen tersebut; untuk yang dilampirkan ke sebuah boundary, baris di atas pesan menyebutkan lampiran dan boundary-nya. Jika beberapa entri tidak cocok dengan apa pun, entri pertama sesuai urutan penulisan Anda yang disebutkan, sehingga entri yang sama disebutkan pada setiap eksekusi. Field yang templatenya membaca nilai yang dideklarasikan sensitif ditampilkan sebagai <redacted>, bukan sebagai hasil resolve-nya. Entri yang dibuang oleh when:-nya tidak pernah diserahkan ke provider dan tidak pernah diperiksa.

Pesan yang dihasilkan. Kategori sampai kepada Anda dalam kepala bertanda kurung siku:

an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (sebuah entri omits tidak mengeluarkan apa pun yang dirender sumber. perbaiki entri agar menyebutkan sesuatu yang dirender sumber, atau hapus; peningkatan versi sumber yang mengganti nama atau menghapusnya adalah penyebab umumnya)

Kepala tersebut memuat kode singkat kondisi ini, E0334.

Cara memperbaiki: bandingkan entri dengan apa yang dirender sumber sekarang — lakukan build dengan entri dihapus dan baca apa yang dirender komponen — lalu perbaiki kind, nama, atau namespace entri, atau hapus entri jika yang disebutkannya sudah tidak ada. Untuk chart, entri menyebutkan dokumen berdasarkan kind, metadata.name milik dokumen itu sendiri dan, jika entri menyebutkan namespace, namespace tempat dokumen berada; untuk file compose, entri menyebutkan service, volume, atau config berdasarkan kuncinya; untuk template CloudFormation, entri menyebutkan resource berdasarkan Type dan ID logisnya, di template sumber mana pun. Lihat Recipe → Field omits:.

A provider’s omitted counts do not match the omits entries it was handed (Jumlah yang dihilangkan oleh provider tidak cocok dengan entri omits yang diserahkan kepadanya)

Provider yang menyatakan bahwa ia menghilangkan unit yang dirender melaporkan, untuk setiap entri omits: yang diserahkan kepadanya, berapa banyak unit yang cocok dengan entri tersebut — satu hitungan per entri, dalam urutan entri diserahkan. Laporan yang tidak ada, memuat terlalu sedikit atau terlalu banyak hitungan, atau memuat hitungan di bawah nol tidak memberi cara untuk mengetahui apakah suatu entri menghilangkan sesuatu sama sekali, sehingga build berhenti. Tidak ada yang Anda tulis yang menyebabkan hal ini: kondisi ini melaporkan provider yang output kembaliannya tidak memenuhi kontrak yang dinyatakannya.

Pesan yang dikeluarkan. Pesan menyebutkan node dan provider, lalu berapa banyak entri yang diserahkan dan apa yang dikembalikan — baik berapa banyak hitungan, maupun hitungan di bawah nol beserta entri yang menjadi asalnya:

a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (jumlah yang dihilangkan oleh provider tidak cocok dengan entri omits yang diserahkan kepadanya: node, provider, diserahkan entri omits, dikembalikan hitungan yang dihilangkan)

Bagian kepala memuat kode singkat kondisi ini, E0336.

Cara memperbaiki: laporkan kepada penerbit plugin yang melayani provider tersebut, dengan menyebutkan komponen yang diidentifikasi pesan. Kewajiban provider dijelaskan dalam kontrak plugin di bagian Menghilangkan unit yang dirender.

Assembled output still carries a cross-boundary placeholder (Output yang dirakit masih memuat placeholder lintas batas)

Ketika koneksi dependensi melintas di antara dua output yang dirakit, nilai yang dibawanya tidak dapat diketahui saat sisi konsumen dirender — nilai itu dipublikasikan oleh sisi lain dan diselesaikan setelah keduanya dirakit. Karena itu build menuliskan placeholder ke dalam input komponen konsumen, dan provider menggantinya dengan bentuk referensi silangnya sendiri setelah rakitan tersedia.

Kondisi ini adalah laporan dari placeholder yang lolos dari penggantian tersebut. Lolos berarti resolusi tidak pernah mencapainya: nilai berakhir di tempat yang tidak dapat dijangkau provider — paling sering disisipkan ke dalam string yang lebih panjang alih-alih berdiri sebagai nilai utuh — atau suatu perlintasan ditandai tanpa ada apa pun di sisi lain untuk menyelesaikannya. Placeholder tidak pernah merupakan output yang valid, sehingga build berhenti alih-alih mengirimkan file yang memuatnya.

Pesan menyebutkan provider yang menulis file dan path tempat file berada: path hanya unik dalam satu rakitan, sehingga keduanya bersama-samalah yang mengidentifikasi satu file. Setiap file yang bermasalah dilaporkan, bukan hanya yang pertama, dan masing-masing dilaporkan sekali berapa pun banyaknya boundary yang memasok rakitan tempatnya berada. Kondisi ini dilaporkan terhadap dokumen Release secara keseluruhan, bukan terhadap boundary di dalamnya — kesalahannya ada pada cara suatu nilai mencapai file, bukan pada deklarasi boundary, sehingga tidak ada deklarasi boundary yang perlu diubah.

Pesan yang diemisikan:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (output yang dirakit masih menyimpan placeholder tautan lintas batas yang belum diselesaikan)

Cara memperbaiki: penyebab paling umum adalah nilai yang diinterpolasi sisi konsumen ke dalam string yang lebih panjang. Referensi silang harus berdiri sebagai keseluruhan nilai tempat ia diinjeksikan, jadi ubah pemetaan Recipe agar mengirimkannya secara utuh dan susun di sekitarnya dengan kosakata target itu sendiri. Jika nilai sudah utuh dan placeholder tetap lolos, kesalahannya ada di sisi resolusi provider dan menjadi urusan penerbit plugin tersebut.

Template dapat membaca nilai produsen langsung dari koneksi, di .context.uses.<alias>.provides — atau, dalam FeatureRecipe berlingkup boundary, dari koneksi boundary di bawah .boundary. Jika koneksi menghubungkan dua komponen yang dirender ke output yang berbeda dan provider menyambungkannya dengan referensinya sendiri, masing-masing nilai tersebut sampai ke template sebagai placeholder yang diganti provider setelah kedua output dirakit: dengan referensi lintas stack, atau dengan nilai itu sendiri. Jadi template hanya boleh menyalin nilai seperti itu — menuliskannya utuh, di dalam string yang lebih panjang, atau melalui fungsi yang membiarkannya apa adanya, seperti quote.

Perbandingan, percabangan, panjang, atau fungsi yang mengubah nilai — eq, if, len, upper, trimPrefix — akan diputuskan berdasarkan placeholder, bukan nilainya, tanpa pemberitahuan. Build memeriksa hal itu dengan mengevaluasi template dua kali, sekali atas placeholder dan sekali atas nilai sebenarnya, dan berhenti jika keduanya berbeda setelah setiap placeholder ditulis kembali. Ini berlaku untuk setiap template yang membaca koneksi seperti itu: template milik Recipe sendiri, injectMapping: dari FeatureRecipe yang dilampirkan, dan template FeatureRecipe berlingkup boundary.

Pesan menyebutkan template — field dan Recipe pemiliknya — dan, untuk setiap nilai provides yang menjadi penentu perbedaan, komponen konsumen, alias dan socket koneksi, serta komponen produsen. Nilai yang hanya disalin oleh template tidak disebutkan.

Pesan yang diemisikan:

a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (template melakukan lebih dari sekadar menyalin nilai yang dibacanya dari tautan lintas boundary: pesan menyebutkan template, kunci provides, komponen konsumen yang membacanya dari koneksinya pada socket, dan komponen produsen. Salin nilai apa adanya, utuh atau di dalam string yang lebih panjang, karena provider menuliskan di tempatnya apa yang menjadi nilai itu di output lain, dan sebagai gantinya bercabanglah berdasarkan nilai milik komponen itu sendiri)

Cara memperbaiki: salin nilai yang disebutkan pesan alih-alih menguji atau mengubahnya, dan dasarkan keputusan pada nilai yang ditulis sendiri oleh komponen konsumen — salah satu kunci values atau infra miliknya — bukan pada apa yang dibaca koneksinya. Provider CloudFormation menjelaskan menjadi apa nilai yang disalin di stack lain.

A provider named a directory for a contributor that is not one directory (Provider menyebutkan direktori untuk kontributor yang bukan satu direktori)

Provider yang menempatkan setiap kontributor di posisinya sendiri di dalam satu output yang melingkupi menyatakan direktori tempat posisi-posisi itu berada, dan build menyusun identitas setiap komponen ke dalamnya. Nilainya harus menyebutkan tepat satu direktori: nilai yang memuat pemisah path, atau menyebutkan direktori saat ini atau direktori induk, akan menempatkan file komponen di tempat selain di bawah posisinya sendiri — entah di luar rakitan sama sekali atau tersusun ulang secara diam-diam di dalamnya.

Build berhenti alih-alih menyusun path semacam itu. Pesan menyebutkan provider yang menyatakan nilai tersebut dan nilainya sendiri, sehingga jelas provider mana yang perlu diubah dan apa yang dinyatakannya.

Provider yang tidak menyatakan direktori semacam itu tidak terpengaruh. Setiap kontributor kemudian berada langsung di direktori deployment dengan namanya sendiri, sehingga tidak menyebutkan direktori yang melingkupi adalah jawaban yang sah, bukan kelalaian.

Pesan yang diemisikan:

provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (provider menyebutkan direktori untuk subdirektori milik setiap kontributor yang bukan satu nama direktori: provider menyatakan nest_segment; nilainya harus menyebutkan satu direktori, tanpa pemisah path dan tidak menyebutkan direktori saat ini maupun direktori induk)

Cara memperbaiki: tidak ada dokumen katalog yang menghasilkan nilai ini, sehingga tidak ada yang perlu dikoreksi dalam file Anda sendiri — nilai ini berasal dari plugin yang melayani provider. Laporkan kepada penerbit plugin tersebut, dengan mengutip nilai yang disebutkan pesan. Jika plugin itu milik Anda, nyatakan satu nama direktori, atau jangan nyatakan sama sekali dan biarkan setiap kontributor berada di direktori deployment.

A boundary-scope Feature is attached only to a component (Feature dengan cakupan boundary hanya dilampirkan ke komponen)

FeatureRecipe dapat menyatakan bahwa ia dibangkitkan sekali untuk sebuah boundary alih-alih sekali untuk setiap komponen — satu sumber daya bersama untuk semua yang dimuat boundary, bukan satu per komponen. Karena itu boundary adalah tempat lampiran semacam itu harus ditulis: lampiran dengan nama tersebut yang hanya ditulis pada komponen tidak menyebutkan cakupan bagi recipe untuk dibangkitkan, sehingga tidak ada yang menentukan di boundary mana ia akan dijalankan, nilai mana yang akan dibacanya, atau ke mana output-nya akan ditulis.

Menuliskannya juga pada komponen adalah hal biasa dan tidak dilaporkan. Lampiran yang dideklarasikan di boundary menjangkau setiap komponen yang dimuat boundary itu, termasuk yang berada di cakupan bersarang di dalamnya, sehingga membawanya adalah bentuk yang normal. Yang diperiksa adalah apakah cakupan komponen itu sendiri atau cakupan yang melingkupinya mendeklarasikan nama tersebut — pencarian bergerak keluar dari tempat komponen berada dan berhenti pada cakupan pertama yang mendeklarasikannya. Komponen yang menyatakan ulang pada dirinya lampiran yang sudah dideklarasikan cakupan yang melingkupinya dirender persis sama dengan bentuk yang hanya di cakupan, dan diterima dengan alasan yang sama.

Komponen yang tidak ditempatkan di cakupan mana pun tidak memiliki apa pun untuk ditelusuri, sehingga lampiran dengan cakupan boundary padanya dilaporkan di sini — yang merupakan pembacaan yang jujur, karena tidak ada cakupan tempat recipe semacam itu dapat dibangkitkan.

Pesan yang dikeluarkan, menyebutkan lampiran dan cakupan tempat komponen berada:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (lampiran mengikat FeatureRecipe dengan executionScope: boundary dan tidak ada boundary yang memuat komponen yang mendeklarasikannya; pada komponen di boundary)

dan untuk komponen yang tidak berada di cakupan mana pun, yang tidak menyumbangkan nilai semacam itu:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (lampiran mengikat FeatureRecipe dengan executionScope: boundary dan tidak ada boundary yang memuat komponen yang mendeklarasikannya)

Cara memperbaiki: deklarasikan lampiran di bawah features: pada boundary yang seharusnya menjadi tempat pembangkitannya — cakupan tempat komponen berada, atau cakupan yang melingkupinya — bukan hanya pada komponen. Jika yang Anda maksud adalah pembangkitan per komponen, lampirkan Feature yang FeatureRecipe-nya tidak mendeklarasikan cakupan boundary.

The sandbox refused a plugin (Sandbox menolak sebuah plugin)

Setiap plugin melaporkan apa dirinya dan apa yang dibutuhkannya sebelum diizinkan melakukan pekerjaan apa pun, dan sandbox membaca laporan itu terhadap apa yang siap diberikannya. Kondisi ini mencakup seluruh kelas laporan yang tidak akan diterima sandbox, dan kalimatnya menyebutkan bagian mana yang ditolak: versi antarmuka plugin yang tidak dipahami host, jenis plugin yang tidak dikenal kosakatanya oleh host, plugin yang meminta akses jaringan keluar atau akses sistem berkas, plugin yang menyebut panggilan host di luar himpunan yang ditawarkan host atau mengimpor dari namespace di luar himpunan yang diterimanya, ekspor yang hilang atau salah bentuk, field yang membawa nilai di luar himpunan tertutupnya, atau laporan diri yang sama sekali tidak dapat dibaca.

Penolakan terjadi sebelum plugin berjalan, dan plugin yang ditolak dimatikan sebelum kegagalan diteruskan, sehingga tidak ada yang dimintanya yang diberikan, bahkan sesaat.

Sebagian hal yang tidak boleh dimiliki plugin tidak diperiksa di sini karena memang tidak pernah diberikan. Host memberi guest jam yang dibekukan, tanpa sistem berkas, tanpa environment, dan tanpa tempat bagi keluarannya sendiri, sehingga guest yang mencoba menjangkau salah satunya gagal saat mencoba, bukan ditolak di awal. Yang dicakup kondisi ini adalah laporan yang dibuat plugin tentang dirinya sendiri, yang diperiksa sebelum plugin dimulai.

Pesan yang dikeluarkan. Kalimat kondisi menutup setiap pesan, dan bagian sebelumnya menyebutkan plugin serta bagian laporannya yang ditolak. Versi antarmuka yang tidak dipahami host:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (plugin mendeklarasikan abi_version; host memahami versi lain: wasm: plugin ditolak oleh sandbox)

jenis plugin yang tidak dikenal kosakatanya oleh host:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (plugin mendeklarasikan plugin_type yang tidak dikenal: wasm: plugin ditolak oleh sandbox)

laporan diri yang tidak dapat dibaca:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: keluaran describe() plugin bukan JSON yang valid: wasm: plugin ditolak oleh sandbox)

plugin yang tidak memiliki ekspor yang diwajibkan jenisnya, disebut dari registri yang sama tempat jenis itu sendiri dibaca:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (plugin tidak mendeklarasikan ekspor tersebut: wasm: plugin ditolak oleh sandbox)

field yang tertutup pada himpunan tetap, tetapi membawa nilai lain — bentuk yang sama mencakup mode assembly, serta field operates dan scope per ekspor:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (ekspor plugin mendeklarasikan scope yang tidak dikenal (seharusnya own, host, atau kosong): wasm: plugin ditolak oleh sandbox)

kapabilitas berpasangan yang dideklarasikan tanpa kedua ekspornya, atau ekspornya tanpa klaim tersebut:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (plugin mendeklarasikan kapabilitas penautan lintas batas tetapi tidak mengekspor link_publish dan link_resolve sekaligus: wasm: plugin ditolak oleh sandbox)

nama kapabilitas yang tidak akan pernah dapat dipilih sebuah Recipe — provider yang melayani nama berisi titik dua, atau langkah pipeline yang kompatibel dengannya — karena capability: sebuah Recipe dibaca sebagai nama hingga titik dua terakhirnya dan pin versi setelahnya. parse:<format> milik parser dan import:<format> milik importer tidak ditolak: titik dua merupakan bagian dari nama tersebut, dan keduanya dicari berdasarkan format, bukan melalui Recipe. Penolakan yang sama menghentikan pembuatan entitas plugin semacam itu untuk publikasi:

plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (plugin melayani kapabilitas yang namanya berisi titik dua; referensi kapabilitas sebuah Recipe dibaca sebagai kapabilitas hingga titik dua terakhirnya dan pin versi setelahnya, sehingga tidak ada Recipe yang dapat menyebut nama tersebut: laporkan nama kapabilitas tanpa titik dua: wasm: plugin ditolak oleh sandbox)

dan panggilan host yang diklaim plugin terhadap panggilan yang benar-benar digunakan binernya, yang diperiksa ke dua arah sehingga plugin tidak dapat mengiklankan permukaan yang tidak digunakannya maupun menyembunyikan permukaan yang digunakannya:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (plugin mendeklarasikan fungsi host di describe() yang tidak diimpor oleh wasm-nya: wasm: plugin ditolak oleh sandbox) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (plugin mengimpor fungsi host yang tidak dideklarasikan oleh describe()-nya: wasm: plugin ditolak oleh sandbox)

Cara memperbaiki: tidak ada apa pun dalam berkas entitas Anda yang menyebabkan hal ini dan tidak ada perubahan penulisan yang dapat menghilangkannya — laporan yang ditolak adalah milik plugin itu sendiri. Jika Anda menggunakan plugin yang dipublikasikan, laporkan pesan tersebut kepada pihak yang memublikasikannya dan sementara itu pilih versi yang diterima host. Jika plugin itu milik Anda, pesan menyebutkan field dan kedua nilainya, sehingga koreksinya adalah yang ditunjuk kalimat tersebut: gunakan versi antarmuka yang dipahami host, deklarasikan jenis yang dikenalnya, jaga setiap field tetap di dalam himpunan tertutupnya, deklarasikan ekspor yang diwajibkan jenis Anda, dan deklarasikan tepat panggilan host yang digunakan biner Anda — tidak lebih, dan tidak kurang.

A plugin is not the kind of plugin the socket expects (Plugin bukan jenis plugin yang diharapkan socket)

Setiap titik pemasangan menyatakan jenis plugin yang menjadi tujuan dispatch-nya, dan setiap plugin melaporkan jenisnya sendiri. Kondisi ini adalah yang dilaporkan oleh ketidaksesuaian antara keduanya: plugin yang melayani provider dipasang di tempat yang mengharapkan linter, parser dipasang di tempat yang mengharapkan importer, plugin yang bukan perintah terminal dijalankan sebagai perintah terminal. Pemeriksaan terjadi saat plugin dimuat, sehingga plugin dengan jenis yang salah tidak pernah mencapai pekerjaan yang akan diminta darinya.

Alasan build berhenti alih-alih tetap mencoba adalah bahwa jenis-jenis tersebut tidak berbagi antarmuka. Plugin dengan jenis lain akan dipanggil melalui ekspor yang tidak dimilikinya, dan apa yang dikembalikan akan dibaca terhadap bentuk yang tidak pernah dihasilkannya.

Membaca laporan diri plugin tanpa menegaskan jenis tidak terpengaruh. Permukaan yang hanya ingin mengetahui apa yang dikatakan plugin tentang dirinya — menampilkan apa yang dikonfigurasi, membuat entitas untuknya — tidak menyatakan harapan apa pun, dan pemeriksaan ini dilewati di sana.

Pesan yang dikeluarkan, menyebutkan plugin dan kedua jenis, dengan jenis yang diharapkan diberikan dalam kata-kata sekaligus dalam nilai deklarasinya:

wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: plugin: diharapkan plugin dengan jenis tertentu, tetapi describe()-nya melaporkan jenis plugin lain: wasm: jenis plugin yang dideklarasikan tidak cocok dengan describe() plugin)

Cara memperbaiki: pasang plugin dengan jenis yang diterima titik pemasangan tersebut — pesan menyebutkan jenis yang diharapkan. Jika plugin itu memang yang Anda maksud, pemasangannya berada di tempat yang salah: pindahkan ke permukaan tempat jenisnya berada. Jika Anda menulis plugin tersebut dan plugin itu seharusnya berjenis yang diharapkan, plugin itu melaporkan jenis yang salah tentang dirinya, dan itu merupakan koreksi di dalam plugin, bukan di konfigurasi yang memasangnya.

A plugin failed while it was running (Sebuah plugin gagal saat sedang berjalan)

Plugin yang diminta melakukan sesuatu tidak kembali dengan hasil. Tiga kondisi mencakup hal ini, dan yang membedakannya hanyalah cara kegagalan itu diteruskan — plugin yang crash, plugin yang menghentikan eksekusinya sendiri, dan plugin yang berjalan sampai akhir lalu melaporkan bahwa ia tidak dapat melakukan apa yang diminta. Ketiganya sengaja dijadikan satu taksonomi, sehingga sebuah build memperlakukan setiap cara kegagalan plugin secara sama.

Plugin yang crash. Sebagian besar kesalahan di dalam plugin — instruksi unreachable, pembagian dengan nol, pembacaan di luar memorinya — diubah menjadi kegagalan biasa saat keluar dan tidak pernah mencapai kondisi ini. Kondisi ini adalah jaring pengaman di balik jalur tersebut, untuk crash yang lolos darinya.

Plugin yang menghentikan eksekusinya sendiri. Plugin yang meminta untuk keluar sedang melakukan sesuatu yang tidak berguna dalam model plugin: plugin mengembalikan hasilnya melalui panggilan yang ditujukan kepadanya, bukan dengan keluar. Eksekusinya sendiri berhenti; proses build tidak terpengaruh.

Plugin yang melaporkan kegagalan. Amplop hasil yang dikembalikan plugin memiliki tempat baginya untuk menyatakan bahwa ia tidak dapat menyelesaikan tugas, dan pesan yang menyatakan demikian diteruskan sebagai kegagalan alih-alih dibaca sebagai hasil.

Pesan yang dikeluarkan, masing-masing menyebut plugin atau export dan membawa apa pun yang diberikan oleh kegagalan tersebut. Crash membawa nilai yang dipulihkan:

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: guest plugin panik dalam: wasm: guest plugin panik selama panggilan)

plugin yang berhenti sendiri membawa kode yang digunakannya untuk berhenti:

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: panggilan plugin ke memanggil proc_exit: wasm: plugin memanggil proc_exit)

dan kegagalan yang dilaporkan membawa pesan plugin itu sendiri:

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (panggilan: wasm: guest plugin melaporkan galat)

Cara memperbaiki: tidak ada apa pun dalam berkas entitas Anda yang menyebabkan ketiganya, dan tidak ada perubahan penulisan yang menghilangkannya — masing-masing adalah kesalahan di dalam plugin. Laporkan pesan tersebut kepada penerbitnya, sebutkan export yang diidentifikasinya, dan pin plugin ke versi yang berfungsi selama perbaikan dilakukan. Jika plugin itu milik Anda: kembalikan kegagalan pada amplop hasil alih-alih crash atau keluar, sehingga build mendapatkan pesan yang dapat ditampilkannya; dan jika kegagalan yang dilaporkan adalah jawaban plugin yang memang disengaja, pesannya adalah apa yang akan dilihat pembaca, sehingga ada baiknya pesan itu menyatakan bagian mana dari input yang tidak dapat diterimanya.

A plugin returned something that is not the shape the socket reads (Sebuah plugin mengembalikan sesuatu yang bukan bentuk yang dibaca socket)

Setiap titik pemasangan membaca hasil yang diterimanya terhadap bentuk yang diharapkannya, dan menolak apa pun selain itu — field yang tidak dideklarasikan oleh bentuk tersebut, field yang nilainya bukan tipe yang dideklarasikan untuknya, atau byte yang sama sekali bukan hasil yang terbentuk dengan baik.

Titik pemasangan menolak alih-alih membaca apa yang bisa dibaca, dan alasannya adalah bahwa membaca apa yang bisa dibaca akan terjadi secara diam-diam. Export yang dipanggil sebuah pemasangan dapat dipilih per pemasangan, sehingga sebuah pemasangan dapat menyebut export yang hasilnya berbentuk sama sekali berbeda. Melewati bagian yang tidak cocok menghasilkan hasil kosong — dan hasil kosong itu sendiri adalah jawaban yang sah: tidak ada putusan yang dikembalikan, tidak ada temuan yang diajukan. Keduanya lalu tidak dapat dibedakan, dan build akan berlanjut persis seolah-olah plugin telah menyetujuinya.

Pesan yang dikeluarkan, menyebut export asal hasil tersebut dan membawa alasan pembacaan gagal — bersama-sama keduanya mengidentifikasi export yang seharusnya disebut oleh pemasangan:

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (panggilan: wasm: guest plugin mengembalikan output yang bukan bentuk yang dibaca socket)

Cara memperbaiki: periksa fungsi entri yang disebut pemasangan terhadap export yang dideklarasikan plugin — pemasangan yang diarahkan ke export yang salah adalah penyebab umum, dan alasan dalam pesan menyebut field yang tidak semestinya ada. Jika export-nya sudah benar, plugin mengembalikan bentuk yang tidak dibaca oleh titik pemasangan, yang merupakan perbaikan di dalam plugin; laporkan kepada penerbitnya, dengan mengutip export dan alasannya.

A plugin returned a diagnostic at a severity that is not declared (Sebuah plugin mengembalikan diagnostik dengan tingkat keparahan yang tidak dideklarasikan)

Plugin dapat mengembalikan observasi bersama hasilnya, dan masing-masing membawa tingkat keparahan dari himpunan tertutup: satu yang menghentikan build dan menyebut apa yang harus diperbaiki, satu yang ditampilkan di samping build yang tetap selesai, dan satu yang mencatat observasi tanpa mengubah apa pun. Tingkat keparahan di luar himpunan itu tidak memiliki rute di host, dan build berhenti.

Host menolak alih-alih memilih rute, dan kedua alternatifnya lebih buruk. Melewatkan observasi yang tidak dapat dirutekan akan memperlakukannya sebagai tidak perlu ditindaklanjuti — yang, ketika plugin sedang memutuskan apakah akan menerima build, terbaca sebagai persetujuan: keberatan yang diajukan plugin akan meloloskan build tanpa pernah ditampilkan. Memperlakukannya sebagai tingkat keparahan yang menghentikan akan menolak build berdasarkan nilai yang tidak dipilih siapa pun. Keduanya terjadi diam-diam, sehingga host menyatakan bahwa nilainya salah dan pluginlah yang diperbaiki.

Pemeriksaan dijalankan sekali, di tempat hasil dibaca, alih-alih di setiap tempat observasi kemudian ditampilkan — yang juga merupakan satu-satunya titik ketika identitas plugin masih tersedia, karena observasi yang sudah digabungkan ke dalam laporan tidak lagi mengetahui plugin mana yang mengajukannya.

Pesan yang dikeluarkan, menyebut plugin, export, observasi mana yang bermasalah, nilainya, dan nilai-nilai yang dideklarasikan:

plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (panggilan plugin: wasm: guest plugin mengembalikan diagnostik yang tingkat keparahannya tidak dideklarasikan kontrak: diagnostik memiliki tingkat keparahan; tingkat keparahan yang dideklarasikan adalah, dan)

Cara memperbaiki: tidak ada apa pun dalam berkas entitas Anda yang menyebabkan ini — nilainya berasal dari plugin. Laporkan kepada penerbit plugin, dengan mengutip nilai yang disebut pesan. Jika plugin itu milik Anda, keluarkan salah satu dari tiga tingkat keparahan yang dideklarasikan; pesan menyebutkannya, dan indeks memberi tahu Anda observasi mana yang perlu diperiksa.

A provider returned two output files under one path (Sebuah provider mengembalikan dua berkas output di bawah satu path)

Provider mengembalikan output-nya sebagai daftar berkas, masing-masing menyebut path tempat berkas itu ditulis. Host mengumpulkannya dengan kunci path dan menulis byte setiap berkas apa adanya, tanpa menjalankan serializer sendiri. Dua berkas yang menyebut path yang sama membuat kumpulan itu memiliki dua nilai untuk satu kunci.

Host menolak alih-alih memilih salah satunya, karena kedua pilihan tidak dapat dibedakan satu sama lain sesudahnya. Mempertahankan yang terakhir membuang berkas yang diminta provider untuk ditulis; mempertahankan yang pertama membuang berkas yang belakangan. Bagaimanapun, output di disk terbentuk dengan baik dan kurang satu berkas, tanpa ada yang mencatat bahwa sebuah berkas dibuang — dan path yang bertahan adalah path yang memang akan bertahan, sehingga tidak ada apa pun pada hasil yang menunjukkan terjadinya tabrakan. Mana dari keduanya yang dimaksud adalah pertanyaan yang hanya dapat dijawab oleh provider.

Kondisi ini diajukan di mana pun provider mengembalikan berkas: saat merender satu node, dan saat merakit output sebuah dispatch group menjadi satu artefak. Kondisi dan perbaikannya sama pada keduanya, sehingga keduanya melaporkannya.

Pesan yang dikeluarkan, menyebut path yang dikembalikan dua kali serta node atau dispatch path yang menjadi tujuan pengembaliannya:

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (guest provider mengembalikan dua berkas output di bawah satu path; guest yang sesuai mengembalikan setiap path output paling banyak sekali)

Cara memperbaiki: tidak ada apa pun dalam berkas entitas Anda yang menyebabkan ini — path-nya berasal dari provider. Laporkan kepada penerbitnya, dengan mengutip path yang disebut pesan. Jika provider itu milik Anda, kembalikan setiap path output paling banyak sekali: bangun daftar path terhadap sebuah set sehingga berkas kedua pada satu path tertangkap di tempat ia dihasilkan, dan berikan path yang berbeda untuk berkas kedua jika keduanya memang diperlukan.

A provider reported a render fact whose value is not a list (Sebuah provider melaporkan fakta render yang nilainya bukan daftar)

Sebuah provider dapat melaporkan fakta tentang output yang dirender di samping file-filenya — masing-masing berupa nama dan nilai, dalam kosakata provider tersebut yang terdokumentasi — dan Features yang dilampirkan pada sebuah komponen membacanya dari templatnya. Nilai setiap fakta adalah daftar, bahkan ketika hanya berisi satu entri: satu nama dapat dilaporkan oleh lebih dari satu render sebuah komponen, yaitu panggilan provider-nya sendiri dan render Features yang dilampirkan padanya, dan daftar-daftar itu digabungkan menjadi satu di bawah nama tersebut untuk templat yang membacanya. Sebuah provider tidak dapat mengetahui saat merender apakah laporannya akan menjadi satu-satunya di bawah suatu nama, sehingga nilai berupa objek, string, angka, boolean, atau null ditolak di tempat provider menyerahkannya, untuk setiap render, baik ada maupun tidak ada templat yang membaca fakta tersebut.

Pesan yang dikeluarkan, menyebutkan fakta, node tempat fakta itu dilaporkan, provider yang melaporkannya, dan jenis nilainya:

provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (guest provider melaporkan fakta render yang nilainya bukan daftar; guest yang sesuai melaporkan nilai setiap fakta render sebagai array JSON, bahkan dengan satu entri)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini — nilainya berasal dari provider. Laporkan kepada pihak yang menerbitkannya, dengan mengutip fakta yang disebutkan pesan. Jika provider tersebut milik Anda, laporkan nilai fakta itu sebagai array JSON — satu objek menjadi daftar yang berisi objek tersebut — dan dokumentasikan sebagai daftar dalam fakta yang dilaporkan provider Anda; lihat Melaporkan fakta tentang apa yang dikeluarkan guest.

Ketika sebuah koneksi melintas di antara dua grup dispatch, provider di masing-masing sisi diminta untuk mengkabelkannya: ujung yang dikonsumsi menerbitkan identitas, ujung yang mengonsumsi melakukan resolusi terhadapnya, dan masing-masing dapat mengembalikan pengkabelan struktural untuk diterapkan pada output grupnya sendiri. Setiap bagian pengkabelan menyebutkan file output tempat ia diterapkan. Tahap berikutnya memotong file tersebut, menerapkan operasinya, dan merakitnya kembali dengan setia hingga tingkat byte.

Nama yang tidak cocok dengan file mana pun yang dikeluarkan tidak menyisakan apa pun untuk dipotong oleh tahap itu, dan tahap itu menolak alih-alih melewatkan pengkabelan. Operasi yang dibawanya adalah yang meresolusi koneksi, sehingga membuangnya akan meninggalkan output rakitan yang mereferensikan endpoint yang tidak dikabelkan oleh apa pun — yang gagal saat deploy, jauh dari provider penyebabnya, dan tampak seperti kesalahan pada koneksi alih-alih pada pengkabelan.

File yang dapat disebutkan oleh sebuah bagian pengkabelan adalah file yang dikembalikan oleh render grup itu sendiri. File-file tersebut diserahkan kepada provider dalam panggilan yang sama, sehingga provider tidak pernah perlu menebak nama: ia memilih satu dari himpunan yang diberikan kepadanya.

Pesan yang dikeluarkan, menyebutkan file yang diminta oleh pengkabelan dan endpoint tempat pengkabelan itu dikembalikan:

link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>") (patch tautan menyebutkan file output yang tidak dikeluarkan grup dispatch; patch tautan yang sesuai menyebutkan file yang dikembalikan oleh render grup itu sendiri)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini — namanya berasal dari provider. Laporkan kepada pihak yang menerbitkannya, dengan mengutip file yang disebutkan pesan. Jika provider tersebut milik Anda, ambil nama file dari file rakitan yang diserahkan panggilan kepada Anda alih-alih dari nama yang dibangun secara terpisah — path yang disusun secara manual menjadi usang begitu render yang menghasilkannya berubah, dan beginilah wujudnya.

A pipeline step’s file emission carries no file (Emisi file sebuah langkah pipeline tidak membawa file)

Sebuah langkah pipeline dapat mengeluarkan dokumen baru di samping dokumen yang di-patch-nya. Setiap emisi mendeklarasikan jenisnya, dan emisi berjenis file membawa file yang ditulisnya: path, dan kontennya.

Di sini jenisnya benar dan filenya tidak ada, sehingga langkah tersebut mendeklarasikan niat yang tidak dilaksanakan oleh balasannya. Itulah perbedaan antara kondisi ini dan penghentian jenis-tak-terdefinisi di bawah: host tahu persis apa yang harus dilakukan dengan emisi emit_file tetapi tidak memiliki apa pun untuk dikenai tindakan itu.

Host menolak alih-alih tidak mengeluarkan apa pun, karena emisi yang diam-diam tidak menyumbangkan file akan tidak terlihat. Langkah yang mengeluarkan dokumen sering kali menjadi seluruh alasan langkah itu ada dalam pipeline, dan outputnya adalah file yang sebelumnya tidak ada — sehingga build yang melewatinya akan menghasilkan output yang kehilangan sebuah dokumen, sementara langkah tersebut melaporkan bahwa ia telah berjalan.

Pesan yang dikeluarkan, menyebutkan node dan emisi mana dari langkah tersebut yang bermasalah:

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (efek samping emit_file tidak membawa file; efek samping emit_file yang sesuai membawa file beserta path dan kontennya)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini — balasannya berasal dari plugin. Laporkan kepada pihak yang menerbitkannya, dengan mengutip indeks yang disebutkan pesan. Jika plugin tersebut milik Anda, isi anggota file pada setiap emisi emit_file, dengan path dan kontennya sekaligus; indeks tersebut menunjukkan emisi mana dari balasan langkah itu yang perlu diperiksa.

A pipeline step declares an emission kind the contract does not define (Sebuah langkah pipeline mendeklarasikan jenis emisi yang tidak didefinisikan kontrak)

Setiap emisi yang dikembalikan sebuah langkah pipeline mendeklarasikan jenisnya, dan kontrak mendefinisikan dua: satu menulis file, satu menyumbangkan dokumen custom resource. Jenis tersebut berupa string terbuka pada jalur komunikasi, yang memungkinkan jenis baru ditambahkan kemudian tanpa merusak plugin yang sudah ada.

Keterbukaan itulah tepatnya alasan jenis yang tidak terdefinisi ditolak alih-alih dilewatkan. Nilai yang tidak didefinisikan host tidak dapat dibedakan, dari bentuknya saja, dari nilai yang akan didefinisikan oleh versi berikutnya — sehingga host yang melewatinya akan diam-diam membuang apa pun yang dimaksud langkah tersebut, pada setiap build, sementara langkah itu melaporkan keberhasilan. Penolakan menjaga titik ekstensi tetap terbuka tanpa menjadikannya lubang: jenis yang tidak didefinisikan build ini dilaporkan sebagai tidak terdefinisi, dengan mengutip nilai yang dikirim langkah tersebut, alih-alih diterima lalu diabaikan.

Pesan yang dikeluarkan, menyebutkan node, emisi mana yang bermasalah, dan jenis yang dideklarasikannya:

side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (efek samping mendeklarasikan jenis yang tidak didefinisikan kontrak plugin; efek samping yang sesuai mendeklarasikan emit_file atau emit_crd)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini — nilainya berasal dari plugin. Laporkan kepada pihak yang menerbitkannya, dengan mengutip jenis yang disebutkan pesan. Jika plugin tersebut milik Anda, deklarasikan salah satu jenis yang dicantumkan pesan; salah eja pada jenis yang terdefinisi adalah penyebab umumnya, dan nilai yang dikutip kembali adalah yang Anda kirim.

Penyusunan ulang sebuah provider diberi unit yang tidak pernah dihasilkan oleh pemotongannya sendiri

Provider yang bentuk keluarannya tidak dapat dialamatkan secara langsung dapat memotongnya sendiri: provider tersebut membagi file keluaran menjadi unit-unit yang dapat dialamatkan, masing-masing di bawah sebuah token, lalu mengembalikannya. Langkah pipeline kemudian mengalamatkan sebuah unit melalui token tersebut, dan penyusunan ulang menyambungkan kembali unit-unit yang telah diedit ke dalam file secara setia byte demi byte. Kedua bagian itu adalah satu kontrak — token yang dipakai untuk memotong sebuah file adalah token yang diselesaikan oleh penyusunan ulangnya.

Ketika penyusunan ulang diberi token yang tidak dihasilkan oleh pemotongan file yang sama, tidak ada rentang byte tempat konten yang diedit dapat dikembalikan. Penyusunan ulang menolak alih-alih membuang unit tersebut, karena unit yang dibuang menghasilkan file yang tersusun dengan benar tetapi kehilangan suntingan yang diminta dari sebuah langkah: tidak ada yang gagal, tidak ada yang rusak, dan suntingan itu begitu saja tidak ada.

Kedua bagian itu hanya dapat tidak sepakat jika keduanya terpisah — sebuah codec yang memotong sendiri dan meminjam penyusunan ulang struktural standar untuk sisanya. Memotong dengan satu set token dan menyusun ulang terhadap set lain kemudian menghasilkan tepat kondisi ini. Codec yang memiliki kedua bagian tidak dapat mencapainya: penyusunan ulangnya sendiri bertanggung jawab atas tokennya sendiri.

Pesan yang dikeluarkan, menyebutkan token yang tidak terselesaikan ke apa pun dan file yang menjadi acuannya:

reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (reassemble menyebutkan token unit yang di-patch yang tidak dihasilkan oleh pemotongan; codec yang sesuai memotong dan menyusun ulang file dengan token yang sama (token, file))

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan hal ini. Jika provider tersebut milik Anda, pastikan token yang dihasilkan satu bagian adalah token yang diselesaikan bagian lainnya: turunkan token sekali lalu bawa, alih-alih menurunkannya secara terpisah di tiap sisi, dan jika pemotongan menulis ulang file sebelum membaginya, lakukan penyusunan ulang terhadap bentuk tertulis ulang yang sama. Jika provider tersebut bukan milik Anda, laporkan kepada penerbitnya, dengan mengutip token yang disebutkan pesan.

Sebuah workload mendeklarasikan bentuk yang tidak dapat diekspresikan compose

Provider compose merender layanan yang berjalan lama. Workload yang mendeklarasikan bahwa ia berjalan satu salinan per mesin, berjalan sesuai jadwal, atau berjalan sekali lalu selesai tidak memiliki padanan mesin tunggal yang bersih, sehingga render berhenti alih-alih mengeluarkan layanan biasa — yang akan memulainya, menjaganya tetap berjalan, dan salah merepresentasikan apa yang diminta.

Pesan yang dikeluarkan. Kondisinya menyebutkan jenis kegagalan — provider yang tidak memiliki ekspresi untuk sesuatu yang dideklarasikan build — dan kalimat milik provider sendiri menyebutkan bentuk yang diberikan kepadanya:

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: bentuk workload tidak memiliki pemetaan compose; compose hanya mendukung stateless dan stateful: compose tidak dapat mengekspresikan bentuk workload ini)

Cara memperbaiki: jika target memang lingkungan compose mesin tunggal, ekspresikan pekerjaan tersebut sebagai layanan yang berjalan lama — bentuk stateless dan stateful adalah dua bentuk yang dirender compose. Jika bentuk itu memang yang Anda maksud, render boundary tersebut melalui provider yang targetnya memiliki padanan: salinan per mesin, eksekusi terjadwal, dan job yang berjalan hingga selesai semuanya memiliki ekspresi langsung di tempat lain, dan pilihan provider adalah milik boundary, bukan milik workload.

Sebuah kontainer mendeklarasikan field yang tidak memiliki primitif di compose

Dua field kontainer tidak memiliki padanan di compose, dan keduanya menghentikan render alih-alih dibuang.

Hook yang berjalan saat kontainer dimulai atau akan berhenti. compose tidak memiliki apa pun yang menjalankannya, dan hook yang diam-diam tidak dijalankan adalah kejutan kebenaran yang muncul saat runtime, bukan saat build.

Lingkungan massal yang diambil dari objek bernama. compose dapat membaca variabel dari file, tetapi referensi ke objek bukanlah file — menafsirkan ulang yang satu sebagai yang lain akan mengubah apa yang diberikan kepada kontainer tanpa memberitahukannya.

Keduanya diperiksa untuk kontainer biasa dan untuk kontainer yang berjalan sebelum kontainer utama, sehingga field yang sama berhenti di mana pun ia dideklarasikan dan pesan menyebutkan dari kontainer mana field itu berasal.

Pesan yang dikeluarkan. Keduanya melaporkan kondisi yang sama — provider yang tidak memiliki ekspresi untuk sesuatu yang dideklarasikan build — dan kalimat milik provider sendiri yang menyebutkan field mana:

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: node, kontainer: compose: node mendeklarasikan lifecycle hook kontainer; compose tidak memiliki primitif lifecycle-hook: compose tidak memiliki primitif lifecycle-hook; kontainer mendeklarasikan lifecycle hook)

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: node, kontainer: compose: node mendeklarasikan envFrom kontainer; compose tidak memiliki primitif env-from-object: compose tidak memiliki primitif env-from-object; kontainer mendeklarasikan envFrom)

Cara memperbaiki: untuk target compose, hapus field tersebut dan kerjakan tugasnya dengan cara lain — pekerjaan saat start-up ditempatkan di kontainer yang berjalan sebelum kontainer utama, dan pekerjaan saat shutdown di penanganan sinyal milik kontainer itu sendiri; lingkungan massal dapat dituliskan sebagai variabel eksplisit, atau disediakan dari file yang dapat dibaca target compose. Jika field itu memang yang Anda maksud, render boundary tersebut melalui provider yang targetnya memiliki primitif tersebut.

Entri omits menyebutkan kind atau namespace yang tidak dimiliki file compose

Entri omits: pada Recipe atau FeatureRecipe yang bersumber dari file compose menghilangkan satu unit tingkat atas dari file tersebut, dan file compose memiliki tepat tiga kind yang dapat disebutkan oleh entri — service, volume, dan config, masing-masing dikunci di bawah services:, volumes:, atau configs: — dan tidak memiliki namespace. Entri yang menyebutkan kind lain, di antaranya Secret dari dokumen chart atau network dari compose, atau yang membawa namespace, tidak menyebutkan apa pun yang dapat dihilangkan dari file, sehingga render berhenti alih-alih memperlakukan entri itu sebagai entri yang tidak cocok dengan apa pun. Kind dibandingkan secara persis, sehingga Service ditolak ketika yang dimaksud adalah service. Setiap entri diperiksa sebelum apa pun dihilangkan, dan entri pertama yang bermasalah, menurut urutan penulisan entri, adalah yang disebutkan.

Pesan yang dikeluarkan. Keduanya melaporkan kondisi untuk konstruksi yang tidak memiliki ekspresi di provider, dan kalimat milik provider sendiri menyebutkan entri serta kind yang diterimanya. Field yang templatnya membaca nilai yang dideklarasikan sensitif ditampilkan sebagai <redacted>:

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: entri omits (name) menyebutkan kind; compose menghilangkan service, volume, atau config, masing-masing disebut dengan kuncinya di bawah services:, volumes:, atau configs:, dan tidak ada kind lain)

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: entri omits (kind, name) menyebutkan namespace, dan file compose tidak memiliki namespace; compose menghilangkan service, volume, atau config, masing-masing disebut dengan kuncinya di bawah services:, volumes:, atau configs:, dan tidak ada kind lain; hapus namespace dari entri)

Cara memperbaiki: sebutkan unit sebagaimana file compose menyebutkannya — kind: service, volume, atau config, dan name: berupa kuncinya di bawah bagian tersebut — lalu hapus namespace:. Lihat compose → Mode bersumber.

An omits entry names a namespace a CloudFormation template does not have (Entri omits menyebut namespace yang tidak dimiliki templat CloudFormation)

Entri omits: pada Recipe atau FeatureRecipe yang bersumber dari templat CloudFormation menghilangkan satu resource, yang disebut dengan Type-nya sebagai kind entri dan ID logisnya sebagai name entri. Templat tidak memiliki namespace, sehingga entri yang membawa namespace tidak menyebut apa pun yang dapat dihilangkan dari templat, dan render berhenti alih-alih memperlakukan entri tersebut sebagai entri yang tidak cocok dengan apa pun. Setiap entri diperiksa sebelum apa pun dihilangkan, dan entri pertama yang membawa namespace, menurut urutan penulisan entri, adalah yang disebut.

Pesan yang dikeluarkan. Pesan ini melaporkan kondisi untuk konstruksi yang tidak dapat diekspresikan oleh provider, dan kalimat provider itu sendiri menyebut entri tersebut serta apa yang dihilangkan oleh provider ini. Field yang templatnya membaca nilai yang dideklarasikan sensitif ditampilkan sebagai <redacted>:

a plugin has no expression for a construct this build declares (plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry (cloudformation-provider: entri omits menyebut namespace, dan templat CloudFormation tidak memiliki namespace: cloudformation menghilangkan resource yang disebut dengan Type-nya sebagai kind entri dan ID logisnya di bawah Resources sebagai name entri; hapus namespace dari entri)

Cara memperbaiki: hapus namespace: dari entri, yang menyebut resource hanya dengan Type dan ID logisnya. Lihat cloudformation → Menghilangkan resource dari templat bersumber.

A published port declares a transport compose cannot spell (Port yang dipublikasikan mendeklarasikan transport yang tidak dapat dituliskan compose)

Port compose yang dipublikasikan membawa transport-nya sebagai sufiks pada entri, dan sufiks itu memiliki dua ejaan. Port yang mendeklarasikan transport lain sama sekali tidak memiliki ejaan compose.

Render berhenti alih-alih membuang sufiks, karena port yang dipublikasikan yang diam-diam kembali ke transport default akan aktif membawa lalu lintas yang tidak dapat dijangkau kliennya — yang justru merupakan kegagalan yang hendak dicegah dengan mendeklarasikan transport, muncul kembali pada saat penerjemahan.

Port yang tidak mendeklarasikan transport tidak terpengaruh. Port tersebut dipublikasikan tanpa sufiks, persis seperti port yang tidak pernah membawa transport.

Pesan yang dikeluarkan. Kondisinya menyebut jenis kegagalan — nilai yang tidak memiliki representasi dalam apa yang dikeluarkan provider — dan kalimat provider itu sendiri menyusul:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (compose: node, penerapan port service: compose memublikasikan transport port sebagai sufiks tcp atau udp; port ini mendeklarasikan transport yang tidak dapat diekspresikan compose)

Cara memperbaiki: untuk target compose, deklarasikan transport port sebagai salah satu dari dua yang dapat dituliskan compose, atau biarkan tidak dideklarasikan dan biarkan entri dipublikasikan tanpa sufiks. Jika transport tersebut memang yang Anda maksud, render boundary tersebut melalui provider yang targetnya dapat mengekspresikannya.

A resources quantity cannot be converted to a compose value (Kuantitas resources tidak dapat dikonversi menjadi nilai compose)

Kuantitas prosesor dan memori sebuah container, serta jumlah nvidia.com/gpu-nya, ditulis dalam notasi yang digunakan Kubernetes untuk resource, dan compose membawanya dalam satuannya sendiri — jumlah GPU menjadi jumlah reservasi perangkat NVIDIA — sehingga masing-masing dibaca sebagai kuantitas dan dikonversi dari nilainya. Dua hal menghentikan proses itu, dan pesan menyebut mana yang ditemui: nilai yang sama sekali bukan kuantitas, dan kuantitas yang tidak memiliki bentuk persis dalam compose — jumlah negatif, jumlah memori yang bukan bilangan bulat byte, jumlah prosesor yang lebih halus dari sembilan angka desimal sebuah core, jumlah GPU yang bukan bilangan bulat perangkat, atau jumlah yang melampaui batas terbesar yang dapat ditampung compose. Container yang request dan limit nvidia.com/gpu-nya meminta jumlah berbeda juga berhenti, karena compose mencadangkan satu jumlah untuk sebuah service. Render berhenti alih-alih membulatkan nilai atau mengeluarkan perkiraan, karena limit yang diam-diam bukan limit yang diminta adalah jenis perbedaan yang tidak dicari siapa pun sampai sesuatu dihentikan karena melampauinya.

Pesan yang dikeluarkan. Masing-masing dibuka dengan kondisinya — nilai yang tidak memiliki representasi dalam apa yang dikeluarkan provider — lalu menyebut resource, apakah nilai tersebut request atau limit, path-nya dalam Workload, dan nilainya. Nilai yang bukan kuantitas diikuti oleh apa yang membuatnya bukan kuantitas dan bentuk yang diambil sebuah kuantitas:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value (compose: node, kontainer: compose: nilai pada path tersebut bukan kuantitas; kuantitas adalah angka seperti 2, 0.5 atau 1.5, dengan tanda opsional dan paling banyak satu eksponen bilangan bulat (1e3, 5E-2) atau sufiks satuan (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): kuantitas resources tidak dapat dikonversi menjadi nilai deploy.resources compose)

Kuantitas yang tidak dapat direpresentasikan compose diikuti oleh rentang yang ditampung compose untuk resource tersebut:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: node, kontainer: compose: memori pada path tersebut adalah kuantitas yang tidak dapat direpresentasikan compose secara persis; nilai memori compose adalah bilangan bulat byte dari 0 hingga 9223372036854775807: kuantitas resources tidak dapat dikonversi menjadi nilai deploy.resources compose)

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value (compose: node, kontainer: compose: cpu pada path tersebut adalah kuantitas yang tidak dapat direpresentasikan compose secara persis; nilai cpus compose adalah jumlah core dari 0 hingga 9223372036.854775807 dengan paling banyak sembilan angka desimal: kuantitas resources tidak dapat dikonversi menjadi nilai deploy.resources compose)

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: node, kontainer: compose: nvidia.com/gpu pada path tersebut adalah kuantitas yang tidak dapat direpresentasikan compose secara persis; jumlah perangkat compose adalah bilangan bulat perangkat dari 0 hingga 9223372036854775807: kuantitas resources tidak dapat dikonversi menjadi nilai deploy.resources compose)

Request dan limit GPU yang meminta jumlah berbeda menyebut kedua path dan kedua jumlah:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value (compose: node, kontainer: compose: request nvidia.com/gpu dan limit pada path tersebut meminta jumlah berbeda; compose mencadangkan satu jumlah perangkat untuk sebuah service, jadi tulis jumlah yang sama pada keduanya atau hanya limit: kuantitas resources tidak dapat dikonversi menjadi nilai deploy.resources compose)

Jika templat Workload membaca nilai yang dideklarasikan sensitif oleh penulis, tidak ada pesan yang mengutip nilai yang ditolaknya, dan kedua jumlah tersebut dihilangkan dengan cara yang sama.

Cara memperbaiki: jika nilai tersebut bukan kuantitas, tuliskan dalam bentuk yang dijelaskan di Workload → Kuantitas resource; sufiks tunggal seperti m adalah sisa yang ditinggalkan templat ketika nilai yang diinterpolasinya kosong, sehingga input yang perlu diperbaiki adalah yang dibaca templat. Jika nilai tersebut kuantitas yang tidak dapat direpresentasikan compose, tulis jumlah di dalam rentang yang dinyatakan pesan — memori sebagai bilangan bulat byte dalam satuan apa pun (1536Mi alih-alih 1.5001Gi), waktu prosesor hingga paling banyak sembilan angka desimal sebuah core, dan jumlah GPU sebagai bilangan bulat perangkat (1, bukan 0.5 atau 500m). Jika request dan limit GPU tidak sesuai, tulis jumlah yang sama pada keduanya, atau tulis hanya limit, yang merupakan jumlah yang dijadwalkan Kubernetes untuk Workload yang sama.

Kuantitas sumber daya yang dikeluarkan provider helm bukan kuantitas

Provider helm menyalin setiap kuantitas sumber daya apa adanya ke dalam manifest yang dikeluarkannya — nilai resources.requests dan resources.limits dari setiap container dan init container, termasuk sumber daya tambahan, serta ephemeral.sizeLimit, persistent.size dan persistentTemplate.size dari setiap volume — dan terlebih dahulu memeriksa masing-masing terhadap bentuk kuantitas, pada Workload sebagaimana dievaluasi oleh templat Recipe. Nilai di luar bentuk tersebut menghentikan build di sini, padahal jika tidak, build akan berhasil dengan bersih lalu ditolak oleh klaster saat chart dipasang.

Pesan yang dikeluarkan. Pesan dibuka dengan kondisinya, lalu menyebut node, path field di dalam Workload, nilainya dan apa yang membuatnya bukan kuantitas, serta menyatakan bentuk yang diambil sebuah kuantitas:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: node: bukan kuantitas; kuantitas adalah angka seperti 2, 0.5 atau 1.5, dengan tanda opsional dan paling banyak satu dari eksponen bilangan bulat (1e3, 5E-2) atau sufiks satuan (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei))

Cara memperbaiki: tulis nilainya dalam bentuk yang dijelaskan di Workload → Kuantitas sumber daya. Jika field tersebut ditemplat, nilai yang perlu diperbaiki adalah nilai yang dibaca templat: sufiks tunggal seperti m atau Mi adalah sisa templat ketika nilai yang diinterpolasinya kosong, dan parameter Release mencapai field persis seperti ditulis.

Tipe service yang tidak dapat dirender oleh provider helm

Provider helm merender setiap entri services Workload sebagai Service Kubernetes yang tipenya adalah type entri tersebut. Entri Loopback meminta port-portnya dapat dijangkau dari alamat loopback milik host itu sendiri dan tidak dari tempat lain, dan Service Kubernetes tidak memiliki tipe yang melakukan hal itu: alamat node mana yang didengarkan oleh Service NodePort adalah pengaturan seluruh klaster, bukan satu Service. Karena itu build berhenti pada entri Loopback pertama, dalam urutan deklarasi service, sebelum sumber daya apa pun ditulis.

Build berhenti alih-alih merender entri sebagai tipe lain, karena setiap tipe yang dimiliki Service mengubah apa yang dijangkau port: Service ClusterIP menghilangkan jangkauan publikasi yang diminta entri, dan Service NodePort memublikasikan port pada setiap alamat node yang diizinkan klaster — paparan lebih luas yang justru ingin dihindari oleh entri tersebut.

Pesan yang dikeluarkan. Pesan dibuka dengan kondisinya, lalu menyebut node, path service di dalam Workload, dan tipenya:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: tipe “Loopback” memublikasikan port service hanya pada alamat loopback host, dan Service Kubernetes tidak memiliki tipe yang melakukannya; deklarasikan ClusterIP untuk menjaga port tetap di dalam klaster, atau NodePort atau LoadBalancer untuk memublikasikannya ke luar)

Cara memperbaiki: untuk target helm, deklarasikan tipe yang menyatakan seberapa jauh port harus dapat dijangkau di dalam klaster — ClusterIP untuk menjaganya tetap di dalam, NodePort atau LoadBalancer untuk memublikasikannya. Entri Loopback ditujukan untuk target compose, yang memublikasikan port pada 127.0.0.1; lihat Workload → services.

Versi Kubernetes yang tidak dapat digunakan provider helm untuk merender chart

Provider helm merender chart dari sumber untuk versi Kubernetes yang disebut oleh anotasi aggrega.ai/kubernetes-version pada sebuah komponen atau pada boundary-nya, dan membaca nilainya dengan cara helm template --kube-version membaca flag-nya. Nilai yang akan ditolak oleh flag tersebut — "one.two", "latest", satu angka seperti "1", angka yang ditulis dengan nol di depan seperti "01.20" — tidak memberikan versi untuk dibaca chart sebagai .Capabilities.KubeVersion, sehingga build berhenti sebelum chart dirender.

Build berhenti alih-alih merender chart untuk versi default, karena chart membaca versi untuk memilih versi API, sebuah field, atau seluruh mekanisme, dan chart yang dirender untuk versi selain yang Anda sebutkan mengeluarkan bentuk untuk versi lain itu — bentuk yang mungkin tidak dapat dijalankan oleh klaster tujuan deploy.

Nilai kosong tidak ditolak. Nilai tersebut diperlakukan sebagai tidak diatur, dan chart dirender untuk versi default: versi yang digunakan oleh helm template bawaan dari rilis helm yang sama.

Pesan yang dikeluarkan. Pesan dibuka dengan kondisinya, lalu menyebut node dan boundary tempatnya berada, anotasi, nilainya dan apa yang membuatnya bukan versi, serta menyatakan bentuk yang harus ditulis:

a plugin has no representation for a value it was given (plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: node di boundary: anotasi aggrega.ai/kubernetes-version: bukan versi Kubernetes yang dapat digunakan untuk merender chart; tulis versi klaster tujuan deploy chart, seperti “1.31” atau “v1.31.2”, pada komponen atau pada boundary-nya)

Pesan menyebut node sekaligus boundary-nya karena provider membaca anotasi komponen dan anotasi boundary-nya bersamaan, dengan nilai milik komponen itu sendiri yang diutamakan, sehingga nilainya mungkin ditulis di salah satunya.

Cara memperbaiki: tulis versi klaster tujuan deploy chart — versi mayor dan minor seperti "1.31", atau versi lengkap seperti "v1.31.2" — pada komponen atau pada boundary-nya, atau hapus anotasi untuk merender dengan versi default. Lihat helm → Versi Kubernetes yang digunakan untuk merender chart.

Health probe tidak dapat diubah menjadi healthcheck compose

Health probe yang dideklarasikan menjadi healthcheck compose, dan ada dua hal yang dapat menghentikannya.

Probe yang memeriksa path melalui HTTP, pada container yang tidak memublikasikan port. Pemeriksaan dibangun sebagai permintaan ke sebuah port pada container, sehingga tanpa port yang dideklarasikan tidak ada alamat untuk membangunnya.

Probe yang sama sekali tidak mendeklarasikan cara pemeriksaan — tidak ada path, tidak ada port untuk dihubungi, dan tidak ada perintah untuk dijalankan. Tidak ada yang dapat diubah menjadi pemeriksaan. Kondisi ini adalah pengaman di balik skema, bukan bentuk yang kemungkinan besar akan Anda tulis: probe diperiksa memiliki salah satu dari ketiganya sebelum sampai di sini.

Pesan yang dikeluarkan. Keduanya melaporkan kondisi yang sama — sesuatu yang diperlukan provider yang tidak dapat diresolusinya menjadi tepat satu nilai — dan kalimat provider itu sendiri menyatakan yang mana:

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat meresolusi sesuatu yang diperlukannya menjadi tepat satu nilai) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: node, container: probe http: memerlukan setidaknya satu port container; container tidak mendeklarasikan satu pun)

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat meresolusi sesuatu yang diperlukannya menjadi tepat satu nilai) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: node, container: probe tidak mendeklarasikan bentuk (http/tcp/exec))

Cara memperbaiki: deklarasikan port tujuan pemeriksaan pada container yang sama dengan probe — probe melalui HTTP membaca port container pertama, sehingga port tersebut harus ada agar pemeriksaan dapat dibangun. Jika container memang tidak memublikasikan apa pun, periksa dengan cara lain: probe yang menjalankan perintah tidak memerlukan port. Untuk probe tanpa cara pemeriksaan yang dideklarasikan, berikan salah satu dari ketiganya.

Volume configmap tidak memiliki file di belakangnya

Volume yang memasang konfigurasi dikirimkan melalui mekanisme compose sendiri untuk itu, dirujuk berdasarkan nama, dan entri yang memuat kontennya berasal dari file yang dihasilkan Recipe. Kondisi ini adalah yang dilaporkan oleh referensi tanpa entri yang cocok: file tersebut tidak ada, sehingga mount akan ada tanpa apa pun di belakangnya dan container akan berjalan dengan membaca path kosong.

Pemeriksaan dijalankan atas seluruh output yang telah dirakit, bukan per komponen, dan hal itu disengaja: referensi dan entri yang memuat konten tiba melalui rute yang berbeda dan dapat berasal dari komponen yang berbeda dalam grup yang sama, sehingga output yang dirakit adalah titik pertama di mana keduanya ada. Pemeriksaan per komponen akan menolak referensi yang kontennya disediakan oleh komponen lain dalam grup yang sama.

Setiap referensi yang tidak terselesaikan dilaporkan, bukan hanya yang pertama, dalam urutan yang stabil, sehingga satu build menyebutkan semuanya.

Pesan yang dihasilkan. Kondisi disebutkan terlebih dahulu, lalu setiap service, referensi yang dibuatnya, dan tempat ia dipasang:

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found (compose AssembleBoundary: service merujuk config yang dipasang di path; deklarasikan masing-masing sebagai entri configs: tingkat atas dari input artifacts: milik Recipe: volume configmap memerlukan file yang dihasilkan melalui input artifacts: milik Recipe; tidak ditemukan)

Cara memperbaiki: hasilkan file dari input artifacts: milik Recipe dengan nama yang dirujuk volume — keduanya dicocokkan berdasarkan nama itu, sehingga ketidakcocokan antara apa yang diminta volume dan apa yang dihasilkan Recipe adalah penyebab umumnya. Jika konten dimaksudkan berasal dari tempat lain, volume adalah mekanisme yang salah untuk itu: nilai yang seharusnya berada di environment ditempatkan di sana.

What an omits entry left out is still named by the compose file (Apa yang ditinggalkan entri omits masih disebut oleh file compose)

Entri omits: meninggalkan sebuah service, volume, atau config dari file compose bersumber, dan compose menolak file yang menyebut sesuatu yang tidak dideklarasikannya. Jadi setelah unit-unit dari entri tersebut dihapus, setiap referensi yang masih dibuat sisa file ke salah satunya menghentikan render: service yang disebut oleh depends_on, links, volumes_from, extends, nilai build.additional_contexts, atau mode network, IPC, PID, atau UTS service:; volume yang disebut sebagai sumber entri volumes:; config yang disebut oleh entri configs: — dibaca di setiap service, hook pre_start setiap service, dan setiap job. Daftar lengkapnya, serta nilai-nilai yang hanya terlihat seperti referensi, ada di compose → Mode bersumber.

Pemeriksaan membaca file milik Recipe atau FeatureRecipe yang mendeklarasikan itu sendiri, sehingga render dihentikan bahkan jika kontributor lain untuk file rakitan yang sama mendeklarasikan unit dengan nama yang sama dengan yang ditinggalkan. Setiap referensi dilaporkan, bukan hanya yang pertama — service dalam urutan kunci, lalu job, hook setiap service setelahnya — sehingga satu build menyebutkan semuanya.

Pesan yang dihasilkan. Kondisi disebutkan terlebih dahulu, lalu setiap entri yang merujuk, unit yang disebutnya, dan field tempat referensi itu berada:

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) compose: what an omits entry left out is still named by the file: service "<service>" names <kind> "<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry (compose: apa yang ditinggalkan entri omits masih disebut oleh file: service menyebut unit pada field; compose menolak file yang menyebut service, volume, atau config yang tidak dideklarasikannya: tinggalkan juga apa yang menyebutnya, ubah referensi melalui valuesMapping, atau hapus entri tersebut)

Unit yang nama entrinya dibangun dari nilai yang dideklarasikan sensitif ditampilkan sebagai <redacted>.

Cara memperbaiki: tentukan mana dari keduanya yang Anda maksud. Jika service yang merujuk masih memerlukan unit tersebut, pertahankan unit itu: hapus entrinya. Jika tidak, ubah referensi melalui valuesMapping: milik Recipe — list di sana menggantikan list file dasar, sehingga depends_on: [] mengosongkannya — atau tinggalkan service yang merujuk dengan entrinya sendiri.

What an omits entry left out is still named by a CloudFormation template (Apa yang ditinggalkan entri omits masih disebut oleh template CloudFormation)

Entri omits: meninggalkan sebuah resource dari template CloudFormation bersumber, dan CloudFormation menolak template yang menyebut resource yang tidak dideklarasikannya. Jadi setelah resource dari entri tersebut dihapus, setiap referensi yang masih dibuat template yang tersisa ke salah satunya menghentikan render: Ref, Fn::GetAtt dalam bentuk list atau bentuk string bertitik, DependsOn milik resource, atau variabel dari Fn::Sub — dibaca di mana pun dalam badan setiap resource dan setiap output. Daftar lengkapnya, serta nilai-nilai yang hanya terlihat seperti referensi, ada di cloudformation → Meninggalkan resource dari template bersumber.

Pemeriksaan membaca template milik Recipe atau FeatureRecipe yang mendeklarasikan itu sendiri, secara bersama-sama: referensi ke logical ID yang masih dideklarasikan oleh template lain di antaranya tidak dihentikan, sedangkan referensi ke resource yang ditinggalkan menghentikan render bahkan jika komponen lain mendeklarasikan resource dengan logical ID tersebut. Setiap referensi dilaporkan, bukan hanya yang pertama — template demi template dalam urutan yang dibawa sumber, resource setiap template lalu output-nya dalam urutan kunci — sehingga satu build menyebutkan semuanya.

Pesan yang dihasilkan. Kondisi disebutkan terlebih dahulu, lalu setiap referensi: template tempat ia berada, resource yang disebutnya, bagaimana ia menyebutnya, dan letaknya sebagai path dari root template:

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry (cloudformation-provider: apa yang ditinggalkan entri omits masih disebut oleh template sumber: template menyebut resource (dengan tipe) melalui referensi pada path; CloudFormation menolak template yang menyebut resource yang tidak dideklarasikannya: tinggalkan juga apa yang menyebutnya, atau hapus entri tersebut)

Jika field sebuah entri dibangun dari nilai yang dideklarasikan sensitif, logical ID dan tipe resource-nya ditampilkan sebagai <redacted>, begitu pula setiap langkah path yang mengeja logical ID tersebut.

Cara memperbaiki: tentukan mana dari keduanya yang Anda maksud. Jika resource yang merujuk masih memerlukan resource yang ditinggalkan, pertahankan resource itu: hapus entrinya. Jika tidak, tinggalkan juga resource yang merujuk, dengan entrinya sendiri — nilai yang diikat ke parameter hanya menggantikan referensi ke parameter tersebut, sehingga referensi ke resource tidak dapat diubah olehnya. Output yang menyebut resource tidak dapat ditinggalkan, sehingga resource yang disebut oleh output tetap ada.

A valuesMapping key names no parameter of a sourced CloudFormation template (Kunci valuesMapping tidak menyebut parameter mana pun dari template CloudFormation bersumber)

Template CloudFormation bersumber menerima nilai melalui Parameters yang dideklarasikannya, dan valuesMapping milik Recipe atau FeatureRecipe yang menjadikannya sumber menulis satu kunci per parameter yang diisinya. Kunci yang tidak menyebut parameter yang dideklarasikan template mana pun dari sumber tersebut tidak memiliki tujuan, sehingga render dihentikan alih-alih membuangnya — kegagalan yang akan dilaporkan CloudFormation sendiri untuk parameter yang tidak dikenal, dilaporkan selagi masih dapat Anda perbaiki. Hanya valuesMapping yang mengisi parameter: nilai yang tidak dipetakan tidak pernah dibaca dengan cara ini, sehingga nilai milik komponen atau attachment yang ditulis untuk input lainnya tidak pernah mengalami hal ini.

Pesan yang dihasilkan. Kondisi disebutkan terlebih dahulu, lalu setiap kunci yang tidak menyebut apa pun dan apa yang dideklarasikan setiap template dari sumber tersebut:

a plugin could not resolve something it requires to exactly one value (plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping (cloudformation-provider: valuesMapping milik Recipe atau FeatureRecipe menulis kunci tersebut, dan tidak ada template dari sumber yang mendeklarasikan parameter dengan nama itu: template mendeklarasikan parameter, …; template bersumber hanya menerima nilai melalui parameter yang dideklarasikannya, jadi ganti nama kunci menjadi parameter yang dimaksud, atau hapus dari valuesMapping)

Cara memperbaiki: bandingkan kunci dengan parameter yang dicantumkan pesan — kunci yang salah eja adalah penyebab yang biasa — lalu ganti namanya, atau hapus dari valuesMapping. Lihat cloudformation → Nilai untuk parameter template bersumber.

Another component references a CloudFormation parameter a sourced template’s binding filled (Komponen lain mereferensikan parameter CloudFormation yang telah diisi oleh binding templat bersumber)

Mengisi parameter templat bersumber melalui valuesMapping dari Recipe atau FeatureRecipe milik Feature terlampir yang menyumbernya akan menggantikan setiap referensi ke parameter itu di setiap templat dari sumber tersebut dan menghapus deklarasinya. Konten dari tempat lain dalam stack terakit yang sama — fragmen atau templat bersumber milik komponen lain, atau fragmen dari komponen tempat sebuah Feature dilampirkan — yang masih menyebut parameter itu melalui Ref, variabel Fn::Sub, atau Fn::ValueOf milik sebuah rule kemudian menyebut sesuatu yang tidak lagi dideklarasikan oleh stack, yang ditolak CloudFormation saat stack di-deploy, sehingga perakitan berhenti. Nama yang masih dideklarasikan oleh suatu komponen dalam stack, sebagai parameternya sendiri atau sebagai logical ID sebuah resource, adalah referensi yang diselesaikan oleh stack dan tidak dihentikan.

Pesan yang dikeluarkan. Kondisi ditampilkan terlebih dahulu, lalu setiap referensi: komponen dan templat tempat referensi itu berada, parameternya, dan komponen yang valuesMapping dari Recipe atau FeatureRecipe terlampirnya mengisi parameter itu — Feature yang dilampirkan ke sebuah komponen disebut dengan nama komponen tersebut, dan Feature yang dilampirkan ke sebuah boundary disebut dengan identitas yang dibawa resource-nya sebagai aggrega.ai/component-id, yang disusun dari path boundary dan nama lampiran, seperti bfr--stack--aux:

a plugin could not resolve something it requires to exactly one value (sebuah plugin tidak dapat menyelesaikan sesuatu yang dibutuhkannya menjadi tepat satu nilai) cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (cloudformation-provider: parameter yang diisi oleh binding templat bersumber masih direferensikan dari tempat lain dalam stack terakit: templat komponen mereferensikan parameter yang di-bind oleh valuesMapping dari Recipe atau FeatureRecipe yang me-render untuk komponen; …; mem-bind parameter menghapus deklarasinya dari sumber yang mendeklarasikannya, dan tidak ada lagi templat dalam stack yang mendeklarasikannya, sehingga referensi tersebut tidak menyebut apa pun yang dapat diselesaikan CloudFormation: referensikan apa yang dipublikasikan komponen yang mem-bind, deklarasikan parameter di templat yang mereferensikannya, atau hapus kunci dari valuesMapping)

Cara memperbaiki: jika komponen yang mereferensikan membutuhkan nilai tersebut, minta komponen yang mengisinya memublikasikannya melalui provides lalu referensikan itu; atau deklarasikan parameter di templat yang mereferensikan agar templat itu menerima nilainya sendiri; atau hapus kunci dari valuesMapping, sehingga parameter tetap dideklarasikan dan setiap komponen membaca nilai yang diteruskan saat stack di-deploy. Lihat cloudformation → Nilai untuk parameter templat bersumber.

A value bound to a CloudFormation parameter cannot take the parameter’s type (Nilai yang di-bind ke parameter CloudFormation tidak dapat mengambil tipe parameter tersebut)

Literal yang di-bind ke sebuah parameter dikonversi dengan cara yang sama seperti CloudFormation mengonversi nilai yang sama yang diteruskan untuk Type parameter tersebut saat stack di-deploy. Jika konversi semacam itu tidak ada, render berhenti: nilai yang bukan angka yang di-bind ke Number atau List<Number>, list atau mapping yang di-bind ke parameter yang menerima satu nilai, dan literal apa pun yang di-bind ke parameter AWS::SSM::Parameter::Value<…>, yang nilainya dibaca CloudFormation dari Parameter Store, bukan dari templat. List yang di-bind ke parameter yang disebut templat sebagai variabel Fn::Sub juga menghentikan render, karena sebuah variabel menyubstitusi satu string.

Pesan yang dikeluarkan. Kondisi ditampilkan terlebih dahulu, lalu parameter, templat dan tipenya, serta alasan nilai tersebut tidak cocok; tidak ada nilai yang dikutip:

a plugin has no representation for a value it was given (sebuah plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (cloudformation-provider: parameter dari templat bertipe, dan alasan nilai tidak cocok)

Cara memperbaiki: bind nilai bertipe sesuai parameter — atau, untuk tipe Parameter Store, dynamic reference {{resolve:ssm:…}} atau fungsi intrinsik — atau biarkan parameter tidak di-bind agar menerima nilai yang diteruskan saat stack di-deploy.

A value bound to a CloudFormation parameter is one its constraints refuse (Nilai yang di-bind ke parameter CloudFormation ditolak oleh batasannya)

Literal yang di-bind ke sebuah parameter diperiksa terhadap batasan yang dideklarasikan templat untuknya — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue dan MaxValue — pemeriksaan yang dilakukan CloudFormation terhadap nilai yang diteruskan saat stack di-deploy, dipindahkan ke waktu build sehingga mengisi parameter tidak menghapus pemeriksaan apa pun yang dideklarasikan templat. Fungsi intrinsik dan dynamic reference dibiarkan untuk diperiksa CloudFormation, karena nilainya belum ada sampai stack di-deploy.

Pesan yang dikeluarkan. Kondisi ditampilkan terlebih dahulu, lalu parameter, templatnya, dan batasannya; tidak ada nilai yang dikutip:

a plugin has no representation for a value it was given (sebuah plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (cloudformation-provider: nilai yang di-bind ke parameter dari templat tidak memenuhi batasannya, yang akan ditolak CloudFormation saat stack di-deploy; bind nilai yang diterima parameter)

Cara memperbaiki: bind nilai yang diterima batasan tersebut; deklarasi parameter di templat itu sendiri mencantumkan apa yang diizinkannya.

A secret bound to a CloudFormation parameter would be written into the template (Rahasia yang di-bind ke parameter CloudFormation akan tertulis ke dalam templat)

Nilai yang di-bind ke sebuah parameter ditulis ke dalam templat, tempat siapa pun yang dapat membaca templat stack dapat membacanya. Render berhenti pada literal yang di-bind ke parameter yang dideklarasikan templat sebagai NoEcho, dan, jika valuesMapping dari Recipe atau FeatureRecipe membaca nilai yang dideklarasikan sensitif oleh seorang penulis, pada setiap literal yang di-bind oleh mapping tersebut, karena tidak satu pun keluarannya dapat ditelusuri kembali ke nilai asalnya. Dynamic reference dan fungsi intrinsik ditulis apa adanya — termasuk teks di dalam intrinsik — sehingga nilai sensitif yang disisipkan mapping ke dalam string Fn::Sub sampai ke templat sebagai teks tersebut, dan hanya dynamic reference yang menjaga rahasia itu sendiri tetap di luar templat.

Pesan yang dikeluarkan. Kondisi ditampilkan terlebih dahulu, lalu parameter dan apa yang sebaiknya di-bind sebagai gantinya; tidak ada nilai yang dikutip. Salah satu dari:

a plugin has no representation for a value it was given (sebuah plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: parameter dari templat dideklarasikan NoEcho, dan nilai yang di-bind kepadanya akan ditulis ke dalam templat apa adanya; bind dynamic reference ({{resolve:secretsmanager:…}} atau {{resolve:ssm-secure:…}}) atau fungsi intrinsik sebagai gantinya, atau biarkan parameter tidak di-bind untuk nilai saat deploy)

cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (cloudformation-provider: valuesMapping dari Recipe atau FeatureRecipe membaca nilai yang dideklarasikan sensitif, sehingga literal yang dihasilkannya ditolak, dan mem-bind parameter, … akan menulis literal ke dalam templat apa adanya; …)

Cara memperbaiki: simpan rahasia di Secrets Manager atau sebagai secure string Parameter Store dan bind dynamic reference ke sana — {{resolve:secretsmanager:<secret>}} atau {{resolve:ssm-secure:<name>}} — alih-alih menyisipkannya ke dalam teks intrinsik, atau biarkan parameter tidak di-bind agar menerima nilai yang diteruskan saat stack di-deploy. Lihat cloudformation → Nilai untuk parameter templat bersumber.

Referensi dinamis diikat di tempat yang tidak di-resolve oleh CloudFormation

CloudFormation me-resolve referensi dinamis di properti sebuah resource, tetapi tidak di user data EC2 dan tidak di metadata AWS::CloudFormation::Init, dan CloudFormation menampilkan Outputs sebuah template kepada siapa pun yang membaca stack. Jadi, referensi dinamis yang diikat ke parameter yang direferensikan oleh template mana pun dari sumber tersebut di properti UserData, di metadata tersebut, atau di Outputs-nya menghentikan render alih-alih mencapai tempat yang tidak dapat di-deploy atau terekspos.

Pesan yang dikeluarkan. Kondisi berada di depan, lalu parameter, template, dan tempat template tersebut mereferensikannya; tidak ada nilai yang dikutip:

a plugin has no representation for a value it was given (sebuah plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: nilai yang diikat ke parameter adalah referensi dinamis, dan template mereferensikan parameter tersebut di tempat CloudFormation tidak me-resolve referensi dinamis atau menampilkannya kepada siapa pun yang membaca stack; ikat fungsi intrinsik sebagai gantinya, atau biarkan parameter tidak terikat untuk nilai saat deploy)

Cara memperbaiki: biarkan parameter tidak terikat dan berikan nilainya saat stack di-deploy, atau ikat fungsi intrinsik yang menghasilkan apa yang dibutuhkan template di tempat tersebut.

Sebuah rule membaca parameter CloudFormation yang terikat berdasarkan nama

Fn::ValueOf di Rules sebuah template menyebut parameter berdasarkan ID logisnya alih-alih melalui Ref, dan membaca nilai yang diberikan untuknya saat stack di-deploy. Mengikat parameter menghapus deklarasinya dari setiap template sumber tersebut, yang akan membuat rule — di template mana pun — tidak menyebut apa pun, sehingga render berhenti.

Pesan yang dikeluarkan. Kondisi berada di depan, lalu rule, template-nya, dan parameter:

a plugin has no expression for a construct this build declares (sebuah plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (cloudformation-provider: rule dari template membaca parameter melalui Fn::ValueOf, yang menyebut parameter yang dideklarasikan berdasarkan ID logisnya, dan mengikat parameter menghapus deklarasinya dari sumber; biarkan parameter tidak terikat agar rule dapat membacanya saat deploy)

Cara memperbaiki: hapus key parameter dari valuesMapping, sehingga parameter tetap dideklarasikan dan rule membaca nilai yang diberikan saat stack di-deploy.

Stack CloudFormation yang dirakit tidak dapat membawa sebuah transform

Transform stack yang dirakit dibangun dari milik setiap komponen, dan sebuah transform memproses seluruh template, sehingga transform yang efeknya tidak terbatas pada konten yang ditulis untuknya ditolak alih-alih dibiarkan mengubah cara konten komponen lain di-deploy: AWS::CodeDeployBlueGreen dan AWS::Include selalu, macro yang didefinisikan akun Anda dan AWS::ServiceCatalog di samping komponen lain mana pun, AWS::LanguageExtensions di samping konten serverless komponen lain, dan AWS::Serverless-2016-10-31 jika Globals-nya akan menjangkau resource serverless komponen lain atau salah satu sumber event-nya menyebut resource yang dideklarasikan komponen lain. Tabel lengkapnya ada di cloudformation → Bagian tingkat atas dalam stack yang dirakit.

Pesan yang dikeluarkan. Kondisi berada di depan, lalu setiap komponen dalam stack, transform dan komponen yang mendeklarasikannya, serta alasan transform tersebut tidak dapat dibawa:

a plugin has no expression for a construct this build declares (sebuah plugin tidak memiliki ekspresi untuk konstruksi yang dideklarasikan build ini) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (cloudformation-provider: stack yang dirakit dari komponen … tidak dapat membawa transform yang dideklarasikan oleh komponen)

Cara memperbaiki: tempatkan komponen yang mendeklarasikan transform dalam boundary tersendiri, sehingga stack-nya tidak berisi apa pun yang dapat diubah transform; atau, jika pesan menyebut konten yang dideklarasikan komponen lain, pindahkan konten tersebut ke komponen yang mendeklarasikan transform.

Dua komponen mengurutkan satu pasang transform secara berlawanan

Stack yang dirakit menjalankan transform-nya dalam satu urutan, yang dibangun dari urutan masing-masing komponen dan dari urutan yang didokumentasikan CloudFormation. Jika dua urutan tidak dapat berlaku bersamaan — dua komponen mencantumkan satu pasang transform dengan arah berlawanan, atau sebuah komponen mencantumkan AWS::Serverless-2016-10-31 sebelum AWS::LanguageExtensions, yang didokumentasikan CloudFormation sebaliknya — tidak ada satu urutan yang dapat ditulis, sehingga render berhenti.

Pesan yang dikeluarkan. Kondisi berada di depan, lalu pasangan tersebut dan siapa yang mengurutkannya ke masing-masing arah:

a plugin could not resolve something it requires to exactly one value (sebuah plugin tidak dapat me-resolve sesuatu yang dibutuhkannya menjadi tepat satu nilai) cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (cloudformation-provider: kedua transform diurutkan ke dua arah, dan Transform stack yang dirakit menjalankannya dalam satu urutan; deklarasikan keduanya dalam satu urutan)

Cara memperbaiki: deklarasikan pasangan tersebut dalam satu urutan di setiap komponen yang mencantumkan keduanya, mengikuti urutan CloudFormation sendiri jika CloudFormation mendokumentasikannya.

Dua entri mencapai satu nama output stack

Nama output stack hanya menerima huruf dan angka, sehingga nama tersebut dibangun dari apa yang Anda tulis dengan mengodekan karakter yang tidak diterima alfabet itu alih-alih membuangnya. Karena itu, dua entri yang Anda tulis berbeda tetap berbeda, dan halt ini melaporkan kasus ketika dua di antaranya tetap mencapai satu nama. Render berhenti alih-alih mengeluarkan satu output di tempat dua entri ditulis, yang akan membuang salah satunya tanpa pemberitahuan.

Setiap nama tempat dua entri atau lebih bertemu dilaporkan, dan setiap entri di balik setiap nama disebutkan, dalam urutan yang stabil — sehingga satu build menunjukkan kepada Anda seluruh tabrakan, bukan satu sisinya saja.

Pesan yang dikeluarkan, dimulai dengan kondisi dan dilanjutkan dengan detail provider sendiri:

two things a plugin produced occupy one name in its output (dua hal yang dihasilkan sebuah plugin menempati satu nama dalam output-nya) cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (cloudformation-provider: dua entri yang ditulis penulis mencapai satu nama Output stack; nama Output dibangun dengan mengodekan komponen dan entri ke dalam huruf dan angka yang diterima ID logis, alih-alih membuang yang tidak diterima, sehingga dua entri yang ditulis berbeda tetap berbeda — mengganti nama salah satu ujung meloloskan build)

Cara memperbaiki: ganti nama salah satu entri, atau salah satu komponen, sehingga keduanya tidak lagi mencapai satu nama — pesan menyebut kedua sisi. Nama tersebut membawa tanda baca dan huruf besar-kecil yang Anda tulis, dikodekan alih-alih dibuang, sehingga perbedaan pada keduanya tetap terbawa dan dua entri yang ditulis berbeda diberi nama berbeda.

Fragmen CloudFormation menulis satu key dua kali

Sebuah mapping menyimpan satu nilai per key, sehingga fragmen yang menulis key yang sama dua kali akan menyimpan isi mana pun yang terakhir dan membuang yang lain. Jika mapping tersebut adalah blok yang berisi resource atau output, isi yang dibuang adalah resource atau output yang telah ditulis dan tidak akan ada dalam hasil. Karena itu render berhenti.

Kedua tempat key tersebut ditulis dilaporkan, karena key yang ditulis dua kali biasanya adalah dua suntingan yang dimaksudkan sebagai dua key berbeda — dan penulis membutuhkan keduanya untuk mengetahui mana yang harus diubah.

Pesan yang dikeluarkan, dimulai dengan kondisi dan dilanjutkan dengan detail provider sendiri:

two things a plugin produced occupy one name in its output (dua hal yang dihasilkan sebuah plugin menempati satu nama dalam output-nya) cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (cloudformation-provider: satu key mapping ditulis lebih dari sekali: key ditulis di satu baris dan lagi di baris lain; mapping menyimpan satu nilai per key, sehingga salah satu dari dua isi akan dibuang — hapus salah satu, atau ganti nama salah satu sehingga setiap key ditulis sekali)

Cara memperbaiki: buka fragmen di dua baris yang disebut pesan. Jika kedua isi dimaksudkan sebagai satu hal, hapus yang kini berlebihan; jika dimaksudkan sebagai dua, ganti nama salah satunya sehingga masing-masing memiliki key sendiri. Fragmen adalah template, jadi periksa teks yang di-render, bukan hanya sumbernya, jika key disusun alih-alih ditulis secara literal.

A cross-boundary reference has no consuming stack to be written into (Referensi lintas batas tidak memiliki stack konsumen untuk ditulisi)

Jika suatu koneksi dependensi melintas di antara dua keluaran yang dirakit secara terpisah, sisi konsumen dirender dengan sebuah placeholder dan referensinya dituliskan setelah kedua sisi ada. Kondisi ini terjadi ketika keluaran rakitan sisi konsumen sama sekali tidak memuat templat stack: tidak ada dokumen untuk dituliskan referensinya, sehingga placeholder tidak dapat diganti.

Pesan yang dikeluarkan. Kondisi menyebutkan jenis kegagalan, dan kalimat penyedia sendiri menyebutkan masukan yang mana:

a plugin could not resolve something it requires to exactly one value (sebuah plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) cloudformation-provider: cross-boundary link resolve received no consumer stack template (penyelesaian tautan lintas batas tidak menerima templat stack konsumen)

Cara memperbaiki: tidak ada yang Anda tulis di dalam komponen konsumen yang menyebabkan ini — ini adalah bentuk dari apa yang dirakit oleh batasnya. Periksa apakah sisi konsumen memang dirender oleh penyedia CloudFormation: koneksi yang melintas ke batas yang merakit sesuatu yang lain tidak memiliki stack tempat referensi dapat mendarat, dan koneksi tersebut seharusnya berada di antara dua batas yang dirakit oleh penyedia yang sama. Jika kedua sisi seharusnya CloudFormation, batas konsumen tidak menghasilkan templat stack, dan hal itu perlu ditanyakan kepada siapa pun yang menulis Recipes yang berkontribusi padanya.

A cross-boundary reference was spliced into a longer string (Referensi lintas batas disisipkan ke dalam string yang lebih panjang)

Referensi silang CloudFormation adalah objek, bukan teks, sehingga hanya dapat menggantikan suatu nilai secara utuh. Kondisi ini dilaporkan oleh placeholder yang ditemukan di dalam string yang lebih besar — nilai yang disusun di sekitarnya, alih-alih dikirimkan sebagai keseluruhan dari apa yang diinjeksikan. Tidak ada yang dapat ditukar dengan objek tersebut, sehingga render berhenti alih-alih mengeluarkan referensi dalam bentuk yang tidak dapat dibaca target.

Pesan yang dikeluarkan. Kondisi berada di awal, lalu nilai dan koneksi tempat nilai itu datang:

a plugin has no representation for a value it was given (sebuah plugin tidak memiliki representasi untuk nilai yang diberikan kepadanya) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (nilai tautan lintas batas diinterpolasi ke dalam string yang lebih besar; hanya injeksi skalar utuh yang dapat membawa referensi lintas stack: kunci keluaran pada socket)

Cara memperbaiki: kirimkan nilai secara utuh alih-alih menyusun sesuatu di sekitarnya. Jika sisi konsumen memerlukan nilai di dalam string yang lebih panjang — string koneksi, URL — bangun susunan itu dalam kosakata target sendiri dari referensinya, bukan di templat Recipe sebelum referensinya ada. Pemetaan yang menginjeksikan nilai adalah tempat penyisipan terjadi, jadi baris itulah yang perlu diubah.

Two rendered resources land at one output file (Dua sumber daya yang dirender mendarat di satu berkas keluaran)

Setiap sumber daya yang dirender ditulis ke sebuah berkas yang namanya berasal dari jenis sumber daya itu dan namanya. Dua sumber daya yang sama dalam hal tersebut memiliki nama berkas yang sama, sehingga yang satu akan menempati slot yang lain, dan render berhenti alih-alih mengeluarkan satu berkas padahal dua sumber daya dirender.

Dua sumber daya yang dirender secara identik bukanlah tabrakan. Jika kontennya cocok byte demi byte, menyimpan salah satunya tidak menghilangkan apa pun dan render berlanjut — sehingga templat yang disertakan dua kali dengan hasil yang sama tidak dilaporkan.

Pesan yang dikeluarkan. Kondisi berada di awal, lalu kedua templat yang menghasilkannya dan berkas tempat keduanya bertemu:

two things a plugin produced occupy one name in its output (dua hal yang dihasilkan sebuah plugin menempati satu nama dalam keluarannya) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (node: sumber daya yang dirender dan keduanya menurunkan keluaran dengan konten berbeda: dua sumber daya yang dirender menurunkan nama berkas keluaran yang sama dengan konten berbeda)

Cara memperbaiki: berikan identitas yang berbeda kepada kedua sumber daya — biasanya namanyalah yang berbeda, dan nama berkas mengikutinya. Pesan menyebutkan kedua templat, jadi buka keduanya dan periksa apa yang dihasilkan masing-masing: dua templat yang merender sumber daya yang sama dengan satu nama sering kali berarti salah satunya adalah salinan lama. Jika keduanya diinginkan, keduanya adalah dua sumber daya dan masing-masing memerlukan namanya sendiri.

A synthesized StatefulSet has no single service to govern it (StatefulSet yang disintesis tidak memiliki satu layanan tunggal yang mengaturnya)

Workload yang mendeklarasikan penyimpanan per instans dirender sebagai StatefulSet, dan StatefulSet menyebutkan satu layanan yang mengaturnya — layanan yang memberi setiap instans alamat stabilnya. Layanan itu adalah layanan yang dideklarasikan tanpa alamat klaster sendiri. Dua bentuk menghentikan render: tidak ada yang dideklarasikan, sehingga tidak ada yang dapat disebutkan; dan lebih dari satu, sehingga tidak ada jawaban mana yang mengatur. Keduanya akan menghasilkan StatefulSet yang ditolak target, sehingga render berhenti alih-alih mengeluarkannya.

Pesan yang dikeluarkan. Keduanya melaporkan kondisi yang sama — sesuatu yang diperlukan penyedia yang tidak dapat diselesaikannya menjadi tepat satu nilai — dan kalimat penyedia sendiri menyebutkan bentuk mana dari keduanya yang ditemui. Masing-masing dicetak di bawah bingkai yang menyebutkan node:

a plugin could not resolve something it requires to exactly one value (sebuah plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (StatefulSet yang disintesis memerlukan Service headless yang mengaturnya (deklarasikan layanan dengan type: Headless); tidak ditemukan: StatefulSet yang disintesis tidak memiliki Service headless yang mengaturnya)

a plugin could not resolve something it requires to exactly one value (sebuah plugin tidak dapat menyelesaikan sesuatu yang diperlukannya menjadi tepat satu nilai) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (StatefulSet yang disintesis mendeklarasikan lebih dari satu Service headless; Service yang mengatur ambigu (deklarasikan tepat satu layanan type: Headless): StatefulSet yang disintesis memiliki lebih dari satu Service headless)

Cara memperbaiki: deklarasikan tepat satu layanan bertipe headless pada workload. Jika tidak ada yang dideklarasikan, tambahkan — workload dengan penyimpanan per instans memerlukannya, dan layanan itulah yang memberi setiap instans alamat yang tetap melekat padanya. Jika lebih dari satu dideklarasikan, pertahankan layanan yang seharusnya mengatur dan berikan tipe biasa kepada yang lain, atau hapus; layanan headless kedua biasanya adalah layanan yang sebenarnya tidak perlu headless.

A plugin reported a failure it did not classify (Sebuah plugin melaporkan kegagalan yang tidak diklasifikasikannya)

Plugin yang menghentikan build melaporkan dua hal: kalimatnya sendiri yang menyebutkan apa yang terjadi, dan jenis kegagalan yang disebutkan kalimat itu. Jenis-jenis tersebut adalah himpunan kecil yang dideklarasikan kompiler — konstruksi tanpa ekspresi, masukan yang tidak dapat diselesaikan menjadi satu nilai, dua hal yang dihasilkan menginginkan satu nama, nilai tanpa representasi — dan kondisi ini adalah yang dipilih plugin ketika kegagalannya tidak cocok dengan satu pun dari jenis tersebut.

Ini adalah cadangan, bukan tujuan. Plugin yang menggunakannya padahal salah satu jenis lain cocok memberi tahu Anda lebih sedikit daripada yang diketahuinya, dan susunan katanya menyatakan dengan jelas bahwa plugin menolak mengklasifikasikan, bukan sekadar bahwa ada yang salah — sehingga cadangan yang digunakan berlebihan tetap terbaca, alih-alih tidak dapat dibedakan dari laporan yang benar.

Pesan yang dikeluarkan. Kondisi berada di awal dan kalimat plugin sendiri mengikutinya:

a plugin reported a failure that none of the declared kinds names (sebuah plugin melaporkan kegagalan yang tidak disebutkan oleh satu pun jenis yang dideklarasikan) <the plugin's own sentence>

Cara memperbaiki: baca kalimat plugin sendiri, karena di situlah semua hal yang spesifik untuk build Anda berada. Kondisi itu sendiri hanya memberi tahu Anda bahwa plugin tidak memiliki jenis untuknya. Jika plugin itu milik Anda, pilih jenis yang sebenarnya sesuai dengan kegagalan tersebut; jika bukan, kalimat itulah yang perlu dikutip kepada siapa pun yang menerbitkannya.

A plugin named a condition the socket does not declare (Sebuah plugin menyebut kondisi yang tidak dideklarasikan oleh socket)

Sebuah plugin melaporkan kondisi yang dideklarasikan oleh compiler ini alih-alih menciptakan nomornya sendiri, sehingga pengidentifikasi yang sampai kepada Anda selalu merupakan pengidentifikasi yang dapat dijelaskan oleh aggrega explain. Penghentian ini adalah hasil dari laporan yang menyebut hal lain: nomor yang tidak terdaftar untuk apa pun, nomor yang sudah dipensiunkan, kode pendek yang ejaannya berbeda dari registrasi yang dirujuknya, atau sepasang pengidentifikasi yang menyebut dua kondisi berbeda.

Build berhenti alih-alih diam-diam mengabaikan laporan tersebut. Membuang pengidentifikasi dan membiarkan kondisi kegagalan plugin generik berlaku akan menghasilkan build yang tampak persis seperti build dari plugin yang sama sekali tidak menyebut kondisi, sehingga siapa pun yang harus memperbaikinya tidak akan pernah tahu bahwa ada sesuatu yang perlu diperbaiki. Melaporkan nomor yang diajukan sebagai gantinya akan memberi Anda pengidentifikasi yang tidak merujuk ke apa pun.

Build Anda tetap mendapatkan apa yang menghentikannya. Penghentian ini mengutip nomor yang bermasalah, menyebutkan mengapa nomor itu tidak merujuk ke kondisi mana pun, menyebut kondisi generik yang digunakan plugin ketika tidak memiliki identitas yang lebih baik, dan meneruskan kalimat plugin itu sendiri tanpa perubahan.

Pesan yang diemisikan:

wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence> (wasm: plugin tamu menyebut kondisi yang tidak dideklarasikan oleh socket: tamu menyebut nilai yang diajukan, dan alasan nilai itu tidak merujuk ke kondisi mana pun; sebuah plugin menyebut kondisi yang dideklarasikan oleh compiler ini, dan menggunakan salah satu kondisi generik beserta kodenya ketika tidak ada yang lebih baik: kalimat plugin itu sendiri)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini — laporan plugin itulah yang salah, dan kegagalan yang dilaporkannya memang nyata. Tindak lanjuti kalimat plugin itu sendiri, yang merupakan bagian terakhir dari pesan. Jika plugin tersebut milik Anda, laporkan kondisi yang dideklarasikan oleh compiler ini — salah satu jenis generik yang dicantumkan pesan, jika kegagalan tidak cocok dengan kondisi yang lebih spesifik mana pun; jika plugin tersebut bukan milik Anda, kutip nomor yang bermasalah kepada pihak yang menerbitkannya.

A source artifact is cached without a workspace root to anchor it (Artefak sumber di-cache tanpa root workspace sebagai jangkarnya)

Artefak sumber yang diperoleh disimpan dalam slot di bawah cache artefak workspace, dan path ke slot tersebut dibangun dari root workspace ke luar. Kondisi ini melaporkan root yang tiba dalam keadaan kosong, yang akan membuat path slot menjadi relatif — ter-resolve terhadap direktori mana pun tempat proses kebetulan berada saat byte ditulis, dan menempatkan cache di tempat yang tidak dipilih siapa pun.

Hal ini ditolak alih-alih di-resolve, karena slot yang ditulis di tempat yang salah lebih buruk daripada tidak ada slot: pembacaan berikutnya mencari di tempat yang benar, tidak menemukan apa pun, lalu memperoleh ulang, sehingga yang Anda lihat adalah cache yang tampaknya tidak pernah menyimpan apa pun, tanpa petunjuk lain tentang penyebabnya.

Pesan yang dikeluarkan. Kalimat kondisi itu sendiri membukanya, lalu diikuti oleh apa yang mengidentifikasi artefak:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: workspaceRoot kosong)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini dan tidak ada perubahan penulisan yang menghilangkannya — root workspace disediakan oleh apa pun yang menjalankan build, bukan ditulis dalam katalog. Jalankan build dari dalam workspace, sehingga root ditemukan alih-alih diteruskan sebagai nilai kosong. Jika Anda menjalankan compiler dari perangkat lunak Anda sendiri, teruskan root workspace secara eksplisit; pemanggil yang memang menginginkan cache relatif terhadap direktori saat ini meneruskan satu titik, yang diterima dan menyatakan hal itu secara sengaja.

A value would place a cached file outside the cache (Sebuah nilai akan menempatkan file cache di luar cache)

Entitas yang di-cache dan artefak sumber yang di-cache masing-masing berada dalam slot yang dinamai cache untuknya, dan slot itu disusun dari nilai-nilai: referensi entitas dan versi yang di-resolve-nya, atau jenis sumber, url, chart, module_subdir, versi, dan digest. Setiap nilai menyebut satu posisi dalam tata letak. Kondisi ini melaporkan nilai yang akan memindahkan apa yang ditulis untuknya ke tempat selain posisi yang disebutnya — di samping slot lain, atau sepenuhnya keluar dari cache — dan menolaknya sebelum apa pun ditulis atau dibaca di sana.

Sebagian besar nilai tersebut berasal dari tempat yang tidak dikendalikan cache: body yang dilayani registry, record yang dibaca kembali dari disk, koordinat yang ditulis oleh penulis Recipe atau FeatureRecipe. Versi yang berupa path alih-alih versi, path url atau module_subdir yang naik melewati tempatnya, dan referensi yang ter-resolve menjadi direktori titik masing-masing ditolak di sini. Nilai yang menyebut satu direktori — serta path url atau module_subdir yang tetap berada di atau di bawah tempatnya — tidak diubah.

module_subdir yang naik ditolak sebelum apa pun diambil. Untuk sumber git-repository, nilai yang sama juga menyebut direktori repositori yang diarsipkan oleh pull, dan nilai yang naik melewati repositori akan membuat pull membaca file di samping checkout-nya. Karena itu pull menilai module_subdir sebelum mengambil repositori, dan menolak nilai yang naik dengan kondisi ini, mengutipnya di bawah kuncinya: tidak ada yang diambil, dan tidak ada yang dibaca di samping checkout. Backslash di dalamnya dibaca sebagai pemisah, sebagaimana path Windows membacanya, sehingga ..\shared ditolak di setiap mesin alih-alih dibaca dari samping checkout di satu mesin; pemisah di awal atau akhir nilai dibuang, sehingga /charts/app menyebut charts/app.

Pesan yang dikeluarkan. Kalimat kondisi itu sendiri membukanya, lalu nilai sebagaimana ditulis di bawah kunci tempat nilai itu ditulis, dan solusinya:

a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one (nilai yang menjadi dasar lokasi cache akan menempatkan file cache di luar tempat yang disebutnya dalam cache. Versi, nama, jenis, atau host menyebut satu direktori cache, sehingga tidak memuat garis miring atau backslash dan bukan titik maupun dua titik; path URL atau subdirektori modul boleh menyebut direktori di bawah tempatnya tetapi tidak boleh naik melewatinya. Perbaiki nilai di tempat nilai itu ditulis, atau, jika dilayani registry, minta penerbitnya menerbitkan versi yang memuat nilai yang terbentuk dengan benar)

Cara memperbaiki: jika nilai tersebut Anda tulis sendiri — source.version, url, atau module_subdir sebuah Recipe atau FeatureRecipe — perbaiki agar menyebut satu direktori, atau path yang tetap berada di dalam tempatnya; pesan mengutip nilai dan kunci tempat nilai itu dibaca. Jika dilayani registry, entitas yang diterbitkan memuat versi atau koordinat yang tidak valid, yang tidak dapat diperbaiki oleh perubahan apa pun dari Anda: pesan menyebut apa yang diambil, dan solusinya ada pada pihak yang menerbitkannya.

Beberapa operasi menulis atau menghapus file mereka sendiri, di tempat yang mereka tentukan sendiri, bukan tempat yang Anda sebutkan: direktori keluaran build dan setiap file yang ditulisnya di sana, serta direktori .trace yang diganti oleh build yang dilacak; lockfile sebuah Release, dan catatan kepercayaan plugin di sampingnya, yang ditulis oleh pull; entity.lock di samping sebuah entitas, yang ditulis oleh aggrega pin, dan oleh pull yang mem-pin sumber di samping setiap entitas yang di-pin-nya; .aggrega-config.yaml milik workspace, saat sebuah perintah menulis konfigurasi workspace; cache artefak dan setiap subpohonnya, yang diisi oleh pull dan dikosongkan oleh aggrega cache clear dan aggrega cache prune; bundel tanda tangan yang disimpan pull di cache tersebut untuk setiap artefak yang tanda tangannya telah diverifikasi; draf yang ditulis aggrega import; entitas Plugin yang ditulis aggrega plugin gen-catalog di bawah direktori keluarannya; serta penanda .aggrega/active-release yang ditulis language server editor saat Release default dicatat, dan direktori .aggrega yang memuatnya. Hal yang sama berlaku apa pun antarmuka yang memulai operasi — baris perintah, language server editor, atau tool asisten. Batas workspace menyatakan aturan yang diterapkan di sini, serta jalur yang sengaja menjangkau ke luar workspace.

Setiap tempat tersebut memiliki direktori yang harus menjadi batasnya, dan direktori mana yang berlaku bergantung pada direktori tempat operasi menyusunnya:

  • Workspace, untuk segala sesuatu yang disusun di dalamnya. Ini kasus yang umum, dan berlaku juga untuk direktori yang Anda sebutkan yang berada di dalam workspace. dist dan .trace milik build selalu disusun di sini, di bawah root workspace, dari folder mana pun build dijalankan, demikian pula draf dari import yang tidak menyebutkan direktori keluaran.
  • Direktori yang Anda sebutkan yang berada di luar workspace, untuk segala sesuatu yang disusun di bawahnya: direktori keluaran yang Anda berikan ke aggrega plugin gen-catalog atau aggrega import; direktori Release yang Anda sebutkan, atau yang disebutkan konfigurasi workspace, yang berada di luar workspace, untuk lockfile dan catatan kepercayaan di sampingnya; serta direktori entitas yang Anda sebutkan ke aggrega pin, atau direktori katalog yang Anda sebutkan dengan --catalog atau yang dicantumkan konfigurasi di bawah catalog_dirs, untuk entity.lock di samping setiap entitas di sana. Direktori itu sendiri digunakan sebagaimana Anda menyebutkannya — direktori yang berupa tautan ditulis melaluinya, ke tempat yang ditunjuknya — dan apa yang ditulis di bawahnya tetap berada di dalamnya.
  • Direktori cache artefak itu sendiri, untuk segala sesuatu yang ditulis ke cache di bawahnya dan segala sesuatu yang dihapus aggrega cache clear dan aggrega cache prune di sana — baik .aggrega/cache default maupun artifact_cache_dir yang ditulis konfigurasi dengan naik keluar dari root workspace (../shared-cache). Salah satu direktori milik cache, atau file di dalamnya, yang berupa tautan yang mengarah keluar dari direktori cache akan ditolak bahkan jika mengarah ke tempat lain di dalam workspace, sehingga tidak ada yang ditulis ke cache, dan tidak ada yang dihapus oleh clear atau prune, yang mengenai file di luarnya. Letak direktori cache itu sendiri dinilai lebih dulu: direktori yang ditulis di dalam root workspace diikuti ke mana pun ia mengarah di dalam workspace dan ditolak, karena dibatasi pada workspace, jika mengarah keluar darinya; direktori yang ditulis dengan naik keluar dari root workspace digunakan sebagaimana Anda menyebutkannya, ditulis melaluinya ke tempat yang ditunjuknya jika berupa tautan.

Setiap tempat tersebut diperiksa sebelum apa pun ditulis atau dihapus di sana. Bagian terdalam dari jalur yang sudah ada, dengan setiap tautan simbolik di sepanjang jalan diikuti, harus merupakan direktori yang menjadi batasnya atau berada di bawahnya. Tautan di mana pun di sepanjang jalan yang mengarah ke luar direktori itu — dist yang ditautkan ke direktori di tempat lain, lockfile yang ditautkan ke file di proyek lain, .aggrega/cache yang ditautkan ke direktori yang dipakai bersama pekerjaan lain, direktori di bawah direktori keluaran gen-catalog yang ditautkan ke tempat lain — akan membuat penulisan atau penghapusan terjadi di luar, sehingga operasi berhenti, dan jalur itu dibiarkan persis seperti semula. Hal ini paling penting untuk build: membersihkan dan menulis ulang direktori keluaran yang berupa tautan jika tidak demikian akan menghapus dan menulis ulang direktori di tempat lain pada mesin.

Tautan yang tidak mengarah ke mana pun diperlakukan sebagaimana adanya — bukan sesuatu yang ada — sehingga direktori yang memuatnyalah yang diperiksa. Jika tautan semacam itu berada tepat di ujung jalur yang akan dibuat operasi, file akan dibuat di tempat yang ditunjuk tautan, sehingga tempat yang ditunjuknya juga diperiksa. Tautan yang menunjuk ke suatu tempat di dalam direktori yang menjadi batas jalur diikuti seperti biasa.

Pesan yang dikeluarkan. Kalimat milik kondisi ini membukanya, lalu jalur yang akan ditulis atau dihapus operasi — writing atau removing menyatakan yang mana — direktori yang harus menjadi batasnya, tautan yang ditemui di sepanjang jalan dan tempat yang dituju tautan itu, lalu cara mengatasinya. Build yang dist-nya berupa tautan yang mengarah keluar workspace dihentikan pada hal pertama yang akan disentuhnya, yaitu pembersihan keluaran sebelumnya:

a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (jalur yang ditulis atau dihapus operasi ini melewati tautan keluar dari direktori yang harus menjadi batasnya. tidak ada yang ditulis ke atau dihapus dari jalur itu. Hapus tautan, atau buat agar mengarah ke tempat di dalam workspace, lalu jalankan operasi lagi)

Diagnostik ini tidak membawa kategori: yang bermasalah adalah tata letak di disk, bukan dokumen apa pun yang Anda tulis.

Cara memperbaiki: hapus tautan yang disebutkan pesan dan jalankan operasi lagi, sehingga operasi membuat direktori atau file sungguhan di tempat itu; atau buat tautan mengarah ke suatu tempat di dalam direktori yang disebutkan pesan, tempat tautan itu diikuti. Tidak ada apa pun dalam file entitas Anda yang menyebabkan hal ini dan tidak ada perubahan penulisan yang menghilangkannya.

A name the operation writes holds a part Windows cannot hold (Nama yang ditulis operasi memuat bagian yang tidak dapat ditampung Windows)

Di Windows, beberapa nama tidak sampai ke file sebagaimana ditulis. Nama yang dicadangkan Windows untuk perangkat — CON, PRN, AUX, NUL, CONIN$, CONOUT$, COM0 hingga COM9 dan LPT0 hingga LPT9, serta nama COM dan LPT yang dieja dengan angka superskrip satu, dua, atau tiga — menunjuk perangkat alih-alih file, dalam huruf besar maupun kecil apa pun dan apa pun ekstensi yang mengikutinya, sehingga nul, Aux.yaml, dan com1.txt semuanya adalah perangkat. Selain itu, bagian jalur yang diakhiri titik atau spasi dapat dipangkas oleh Windows alih-alih disimpan sebagaimana ditulis. Menulis nama seperti itu akan menempatkan byte-nya di tempat selain file yang dinamainya.

Karena itu, ketika suatu operasi akan menulis nama yang tidak dipilihnya sendiri di bawah sebuah direktori pada mesin Windows, nama yang memuat bagian seperti itu ditolak sebelum apa pun ditulis: entri arsip yang dibawa artefak sumber atau entitas katalog, ketika cache menata arsip tersebut agar dapat dibaca; file yang dirender build ke direktori keluarannya; draf yang dikembalikan importer ke aggrega import, baik pada dry run maupun pada penulisan; dan dokumen yang ditulis kembali oleh aggrega edit-document, dari permukaan mana pun pengeditan itu diminta. Setiap bagian nama dinilai, dengan garis miring terbalik dibaca sebagai pemisah, sebagaimana Windows membacanya — sehingga aux/x.yaml ditolak karena direktorinya aux, report. karena titik di akhirnya, dan .. \evil.yaml karena bagian pertamanya, dua titik dan sebuah spasi. Sekumpulan nama yang ditolak karena satu nama tidak menulis nama lainnya: arsip tidak ditata, keluaran build tidak dikosongkan atau ditulis, dan tidak ada draf yang sampai ke disk.

Di Linux dan macOS, nama yang sama ditulis sebagaimana dinamai, dan kondisi ini tidak pernah terpicu. Nama yang keluar dari direktori tempat ia ditulis merupakan kesalahan yang berbeda, yang ditolak di setiap platform dengan pesan milik operasi tersebut sebelum kondisi ini diperiksa.

Pesan yang dikeluarkan. Pesan dibuka dengan kalimat kondisi itu sendiri, lalu nama, bagian yang tidak dapat ditampung Windows, dan direktori tempat nama itu akan ditulis, kemudian cara mengatasinya:

a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written; rename that segment where the name is produced

Diagnostik ini tidak membawa kategori: nama tersebut berasal dari apa pun yang menghasilkannya — penerbit arsip, sebuah Recipe atau pustaka, importer, jalur yang dinamai suatu pengeditan — bukan dari satu dokumen yang dijadikan sasaran kesalahan oleh kompiler.

Cara memperbaiki: ganti nama bagian yang disebut pesan di tempat nama itu berasal. Untuk entri arsip, itu adalah artefak sumber atau entitas yang diterbitkan, yang hanya dapat diubah oleh penerbitnya. Untuk file yang dirender, itu adalah nama keluaran yang diberikan sebuah Recipe atau ArtifactLibrary; untuk draf, importer yang menamainya; untuk pengeditan, jalur dokumennya. Tidak ada hal pada mesin Windows yang membuat nama itu dapat digunakan sebagaimana ditulis.

Kondisi yang tidak menghentikan build

Setiap kondisi di atas menghentikan build. Beberapa kondisi membawa kode singkat dan pesan sendiri tanpa pernah menghentikan build, dan kondisi-kondisi tersebut dikatalogkan di sini agar kode yang Anda pegang selalu mengarah ke sesuatu, dari halaman mana pun Anda datang.

Kondisi-kondisi ini terbagi menjadi empat jenis, dan perbedaannya perlu diketahui sebelum Anda mencari perbaikan.

  • Sebuah peringatan. Build melaporkannya lalu tetap berjalan, dan keluaran yang dirender sama saja, baik Anda menindaklanjutinya maupun tidak. Masing-masing dijelaskan lengkap di warnings.md — apa yang memicunya, di bagian kompilasi mana ia dibaca, apa yang dicetaknya, dan apa yang perlu dilakukan — dan entri di bawah menyebutkan bagian mana, alih-alih mengulanginya di sini.
  • Kondisi yang diserap editor. Kondisi ini ditangani oleh integrasi editor itu sendiri dan tidak mencapai keluaran build maupun diagnostik.
  • Pengaman di balik penolakan yang lebih awal. Aturan yang dilindunginya sudah ditegakkan lebih dulu oleh kondisi yang memang menghentikan build, sehingga build menemui kondisi yang lebih awal itu terlebih dahulu.
  • Penolakan pada perintah yang bukan build. Ini adalah penghentian keras dengan solusi nyata — perintah yang menemuinya berakhir, dan tidak ada yang diterbitkan, ditulis, atau diubah — tetapi tidak ada tahap kompilasi yang mencapainya, sehingga tidak ada build yang melaporkannya. Menerbitkan atau menandatangani artefak, menyematkan input entitas, menambahkan registry, mengedit dokumen, mengubah deskripsi sumber asing menjadi draf berkas authoring, dan memeriksa seluruh katalog — untuk kebenaran atau terhadap konvensi penerbitan — adalah tempat kondisi ini ditemui, dan setiap entri menyebutkan perintah mana yang terkait serta siapa yang memegang perbaikannya.

Binding anotasi mendeklarasikan satu path di kedua daftar pilar

Sebuah peringatan. Binding anotasi Manifest menyebut path bertitik yang sama di daftar maps.infra dan daftar maps.values-nya. Mendeklarasikan tumpang tindih ini sah dan compiler tidak mengawasinya: aturan pemecah seri routing secara deterministik mengirim path tersebut melalui infra, sehingga sisi values dari path itu tidak dapat dijangkau dari Aggregate.

Pesannya dimulai dengan:

annotation binding declares one path in both pillar lists (binding anotasi mendeklarasikan satu path di kedua daftar pilar)

Peringatan inilah yang memberi tahu Anda sebelum build menemui penghentian yang dijelaskan di “An annotation routes through a pillar its authoring side may not use” di atas — peringatan ini adalah permukaan awal, sedangkan penghentian itu adalah penegakannya. Lint ini dijelaskan di “Binding-map-overlap lint” dalam warnings.md.

Nama attachment berjarak satu edit dari slot yang dideklarasikan

Sebuah peringatan. Sebuah komponen memasang Feature dengan nama yang bukan salah satu slot yang dideklarasikan tipenya, tetapi berjarak satu edit dari salah satunya — bentuk yang diambil oleh salah ketik nama slot. Attachment dengan nama yang tidak dideklarasikan slot mana pun adalah sah, sehingga tidak ada yang berhenti; yang disebut peringatan ini adalah akibatnya, yaitu attachment tersebut menjadi attachment bebas alih-alih pengisi slot yang Anda maksud, dan slot itu tetap kosong. Pada koneksi, salah ketik yang sama tidak sah dan justru menghentikan build, dengan menyebut slot yang mirip; lihat “A connection carries an attachment under a name its socket declares no slot for”. Jika Feature pada attachment memenuhi selector: slot yang mirip itu, peringatan tidak dimunculkan: pasangan tersebut dinilai oleh penghentian di “An attachment written under another name fits a slot its component leaves empty”, yang melaporkannya ketika slot dibiarkan kosong.

Pesannya dimulai dengan:

attachment name is a near miss for a declared slot (nama attachment nyaris cocok dengan slot yang dideklarasikan)

Dijelaskan di “Attachment-slot near-miss lint” dalam warnings.md, beserta ambang pemasangan dan apa yang sengaja tidak ditangkapnya.

Nama socket uses: berjarak satu edit dari socket yang dideklarasikan

Sebuah peringatan. Blok uses: milik sebuah komponen menyebut socket yang tidak dideklarasikan tipenya, tetapi berjarak satu edit dari salah satunya. Developer memiliki topologi yang dideklarasikan Aggregate dan boleh menyebut socket yang tidak diantisipasi katalog, sehingga nama socket yang tidak dideklarasikan tipenya sah pada permukaan tersebut dan tidak ada yang berhenti. Yang disebut peringatan ini adalah akibatnya: nama yang salah eja itu membentuk koneksi ad-hoc sendiri, tanpa selector dan tanpa kontrak per edge, sementara socket yang Anda maksud tetap tidak tersambung.

Pesannya dimulai dengan:

uses socket name is a near miss for a declared socket (nama socket uses nyaris cocok dengan socket yang dideklarasikan)

Dijelaskan di “Uses-socket near-miss lint” dalam warnings.md. Dua permukaan berdekatan tempat nama socket yang tidak ada di usesSchema entitas pemilik memang menghentikan build dibahas di “uses: socket not declared in the owning entity’s usesSchema (socket tidak dideklarasikan di entitas pemilik)” di atas.

Recipe menerbitkan kunci provides yang tidak dideklarasikan Component-nya

Sebuah peringatan. Recipe yang terikat pada sebuah komponen menerbitkan kunci di bawah provides: yang tidak dideklarasikan tipe komponen tersebut dalam kontrak spec.schema.provides:-nya. Menerbitkan lebih dari yang dideklarasikan Component adalah sah dan tetap sah — kontrak ini mewajibkan subset dan mengizinkan superset. Yang disebut peringatan ini adalah akibat yang tidak terlihat dari sisi mana pun: konsumen yang membaca melintasi edge uses: melihat kontrak target yang dideklarasikan, bukan apa pun yang dikeluarkan Recipe-nya, sehingga kunci yang tidak dideklarasikan tidak dikirimkan dan template konsumen yang membacanya dirender kosong.

Pesannya dimulai dengan:

Recipe publishes a provides key its Component does not declare (Recipe menerbitkan kunci provides yang tidak dideklarasikan Component-nya)

Kasus sebaliknya bukan peringatan: Component yang mendeklarasikan kunci yang tidak diterbitkan Recipe-nya membuat kontrak tidak terpenuhi dan menghentikan build. Dijelaskan di “Undeclared-provides-key lint” dalam warnings.md.

Parameter yang dideklarasikan tidak dibaca oleh apa pun

Sebuah peringatan. Sebuah Aggregate mendeklarasikan entri di bawah spec.parameters: dan tidak ada referensi {{ .parameters.<key> }} dalam teks Aggregate itu sendiri yang membacanya, sehingga apa pun yang diberikan Release untuknya, keluaran yang dirender tetap sama. Compiler tidak mengawasi pengaturan mana yang diekspos penulis, dan parameter boleh saja dideklarasikan lebih dulu sebelum referensi yang akan membacanya, sehingga kondisi ini hanya memberi peringatan alih-alih menghentikan build.

Pesannya dimulai dengan:

declared parameter is read by no reference in the Aggregate (parameter yang dideklarasikan tidak dibaca oleh referensi mana pun dalam Aggregate)

Dijelaskan di “Unread declared-parameter warnings” dalam warnings.md, termasuk mengapa nilai default bukan pengecualian dan referensi mana yang dapat dan tidak dapat dilihat oleh pembacaan tersebut.

Binding provider menyebut kapabilitas yang tidak dilayani plugin mana pun yang dibaca build

Sebuah peringatan. Entri plugins.providers menyebut kapabilitas tanpa plugin, dan tidak satu pun plugin provider yang dibaca build — di direktori katalog, di dalam compiler, atau di antara yang dicatat lockfile — melayani kapabilitas tersebut. Itulah bentuk yang diambil kapabilitas yang salah eja, dan entri seperti itu tidak dibaca oleh apa pun: binding hanya dirujuk ketika sebuah Recipe meminta kapabilitasnya, dan binding yang tidak menyebut plugin tidak memilih apa pun yang tidak akan dipilih oleh resolusi kapabilitas tanpanya.

Kondisi ini memberi peringatan alih-alih menghentikan build karena build tidak dapat memastikannya. Binding ditulis sekali untuk seluruh workspace, sedangkan build dilakukan untuk satu Release, sehingga plugin yang melayani kapabilitas tersebut mungkin hanya dibaca oleh Release lain. Entri yang menyebut plugin dinilai secara berbeda, dan menghentikan build jika jelas salah — lihat “A plugins.providers binding names a plugin that does not serve the capability” di atas.

Pesannya dimulai dengan:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (entri plugins.providers menyebut kapabilitas yang tidak dilayani plugin perender provider mana pun yang dibaca build)

lalu dilanjutkan dengan kapabilitas tersebut, serta kapabilitas yang dilayani yang berjarak satu edit jika ada. Dijelaskan di “Provider-binding unserved-capability warning” dalam warnings.md.

Posisi editor berada di luar dokumen

Kondisi yang diserap oleh editor. Fitur editor yang bergantung pada posisi kursor Anda — go-to-definition, hover, completion — terlebih dahulu menemukan kursor di dalam struktur dokumen yang telah di-parse. Kondisi ini adalah yang dilaporkan langkah tersebut ketika posisi menunjuk ke baris yang tidak dimiliki dokumen, yang terjadi sesaat ketika suatu edit sedang berlangsung dan posisi yang dikirim editor diukur terhadap teks yang sudah dilewati dokumen.

Pesannya berbunyi:

position out of range (posisi di luar jangkauan)

Kondisi ini tidak mencapai build maupun diagnostik apa pun. Setiap fitur yang dapat menjumpainya menjawab tanpa hasil alih-alih memunculkan galat, yang merupakan perilaku yang diminta protokol editor: permintaan yang tidak dapat dijawab tidak mengembalikan apa pun, dan editor bertanya lagi setelah ketukan tombol berikutnya.

Tidak ada yang perlu diperbaiki dalam berkas Anda, dan tidak ada yang muncul dalam build. Fitur yang tetap tidak responsif alih-alih pulih pada edit berikutnya layak dilaporkan sebagai cacat.

Penjaga input milik langkah penggabungan skema

Penjaga yang tidak dicapai oleh build. Ketika suatu Component atau Feature memperluas yang lain dan keduanya mendeklarasikan skema, skema-skema tersebut digabungkan menjadi satu. Pustaka yang melakukan penggabungan menolak input yang tidak dapat digabungkannya secara struktural:

merger: invalid merge input (merger: input penggabungan tidak valid)

Penjaga ini milik langkah penggabungan, yang memang dicapai oleh build setiap kali entitas yang memperluas dan basisnya sama-sama mendeklarasikan skema. Yang dijaganya adalah diberikannya rantai kosong, atau entri rantai yang skemanya tidak ada — dan pemanggil tidak dapat memberikan keduanya: pemanggil menyusun rantai hanya dari skema yang sudah ditemukannya ada, dan hanya menggabungkan ketika rantai itu tidak kosong.

Penjaga ini tetap ada karena merupakan penolakan input yang cacat oleh pustaka yang diekspor. Menghapusnya tidak akan menghapus penghentian yang dapat dicapai build; justru akan mengubah penolakan yang jelas menjadi crash bagi pemanggil di luar compiler yang meneruskan input semacam itu, yang jelas lebih buruk.

Rantai itu sendiri bukan urusan langkah ini. Rantai yang berputar dan rantai yang melampaui batas kedalaman ditolak oleh satu penelusuran extends: sebelum skema apa pun digabungkan — lihat “Cyclic extends chain” dan “An extends: chain runs past the depth bound” di atas.

Kondisi ini dikatalogkan karena dideklarasikan dan memiliki kode sendiri, sehingga kode yang Anda pegang dapat ditelusuri. Tidak ada yang dapat Anda tulis yang menghasilkannya, dan menjumpainya berarti susunan yang dijelaskan di atas tidak lagi berlaku — layak dilaporkan sebagai cacat alih-alih diakali.

Nilai eksplisit menggeser nilai yang diberikan anotasi

Sebuah peringatan. Ekspansi berbasis anotasi mengubah anotasi yang dibawa Aggregate atau Release menjadi lampiran Feature dengan konfigurasinya sendiri. Jika lampiran yang sama juga membawa konfigurasi yang ditulis secara eksplisit — pada komponen, pada cakupan di atasnya, atau di Release — nilai eksplisit menang pada setiap kunci yang dicakup keduanya. Itu adalah aturan yang dimaksudkan dan output yang dihasilkan tidak salah, sehingga build selesai. Yang disebutkan peringatan ini adalah konsekuensinya: kontribusi anotasi pada kunci itu tidak lagi terlihat di mana pun dalam output, dan penulis anotasi mungkin tidak tahu bahwa kontribusinya ditekan.

Peringatan ini melaporkan setiap penggeseran, bukan hanya yang mengubah sesuatu. Penggabungan menimpa nilai yang ditekan, sehingga tidak ada lagi perbandingan yang dapat dibuat dan tidak ada yang dapat menyatakan apakah keduanya sama — catatan bahwa penggeseran terjadi adalah satu-satunya bukti. Peringatan ini dibaca setelah seluruh kaskade lampiran dan ekspansi digabungkan, yang merupakan titik paling awal catatan itu ada.

Pesannya dimulai dengan:

annotation contribution overridden by an explicit value (kontribusi anotasi ditimpa oleh nilai eksplisit)

lalu dilanjutkan dengan anotasi yang digeser, kemudian koordinat kunci yang menggesernya, kemudian tempat anotasi yang digeser ditulis. Posisi di depannya adalah dokumen tempat temuan berada dan kunci di dalamnya:

<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>") (kontribusi anotasi ditimpa oleh nilai eksplisit)

Dua dari nilai tersebut mudah disalahartikan. component hanya disebutkan jika entri yang menggeser memilikinya: entri yang ditulis untuk seluruh cakupan tidak memiliki komponen sendiri, dan menyebutkan komponen yang tidak pernah dimilikinya akan mengarahkan pembaca ke kunci yang tidak ditulis siapa pun. Dan annotation declared at menyebutkan tempat anotasi yang digeser ditulis, yaitu cakupan asal pewarisannya jika anotasi itu tidak ditulis pada komponen yang menggesernya — jadi itu bukan kunci komponen yang diulang dengan keterangan lain.

Apa yang harus dilakukan: tidak ada, jika nilai eksplisit memang yang Anda maksudkan. Peringatan ini ada agar prioritas menjadi pilihan, bukan kejutan. Jika bukan yang Anda maksudkan, ada dua jalan keluar dan keduanya berbeda cakupannya. Hapus entri eksplisit, maka nilai anotasi mengalir ke kunci itu. Atau hapus anotasi dari komponen atau cakupan yang membawanya, maka tidak ada kontribusi sama sekali — yang juga memengaruhi setiap kunci lain yang diberikan anotasi itu. Jika kedua sisi diinginkan tetapi untuk kunci yang berbeda, persempit sisi mana pun yang menjangkau lebih jauh dari yang dimaksudkan sehingga keduanya tidak lagi tumpang tindih.

Koneksi melintas di antara output rakitan dua provider yang berbeda

Jika kedua ujung koneksi dependensi dirakit menjadi output yang berbeda, provider yang menyatakan dukungan penautan lintas batas menyambungkannya secara native — menerbitkan referensi di sisi produsen dan menyelesaikannya di sisi konsumen. Sambungan itu ditulis dalam kosakata milik satu provider, dan suatu provider tidak dapat menyelesaikan referensi yang diterbitkan provider lain. Jadi koneksi yang kedua ujungnya dirender melalui provider yang berbeda tidak disambungkan oleh keduanya.

Kondisi ini memberi peringatan dan tidak menghentikan build. Koneksi tetap membawa nilainya: kontrak injeksi menyalurkan skalar sisi produsen ke sisi konsumen persis seperti di tempat lain, sehingga yang ada adalah koneksi yang berfungsi dan disambungkan dengan cara biasa, bukan koneksi yang rusak. Yang diberitahukan temuan ini adalah bahwa sambungan native yang mungkin Anda harapkan tidak terjadi — dan output tidak berubah, baik Anda menindaklanjutinya maupun tidak.

Satu provider yang menyatakan penautan sudah cukup untuk dilaporkan. Kedua ujung tidak harus menyatakannya: satu pernyataan berarti sambungan native diharapkan dan tidak mungkin, dan penulis yang melampirkan provider itu adalah pihak yang menginginkannya. Mensyaratkan kedua pernyataan tidak akan melaporkan apa pun dalam deployment campuran biasa, saat satu provider menautkan dan yang lain tidak, yang justru merupakan kasus yang ditangani di sini.

Penempatan ujung-ujungnya tidak diperhitungkan. Output rakitan diidentifikasi oleh path dan provider-nya bersama-sama, sehingga dua ujung yang provider-nya berbeda selalu berada di output yang berbeda apa pun penempatannya. Yang dibaca adalah kedua provider dan kedua pernyataannya.

Kondisi ini dilaporkan sekali untuk setiap koneksi semacam itu, diposisikan pada dokumen dan kunci tempat koneksi itu ditulis.

Pesan yang dihasilkan, diawali dengan ujung jauh lalu menyebutkan soket dan provider setiap ujung:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (tautan lintas batas antara titik akhir yang dirender oleh provider berbeda tidak didukung)

Cara memperbaiki: jika nilai skalar yang sudah dibawa koneksi sudah cukup, tidak ada yang perlu dilakukan — ini pemberitahuan, bukan kesalahan. Jika sambungan native diinginkan, kedua ujung harus dirender melalui satu provider: pindahkan satu ujung ke boundary yang dirutekan melalui provider ujung lainnya, atau layani kedua kapabilitas dengan satu provider. Jika keduanya tidak mungkin, bentuk yang membawa nilai itulah yang dimiliki deployment, dan koneksi tetap berfungsi.

Runner plugin baris perintah dibangun tanpa cara untuk menemukan plugin

Plugin yang menyumbangkan perintah terminal dijalankan oleh sebuah komponen yang terlebih dahulu harus mengubah referensi plugin menjadi byte. Kondisi ini melaporkan bahwa komponen tersebut dibangun tanpa bagian yang melakukan pengubahan itu, sehingga tidak ada jalur dari referensi ke sesuatu yang dapat dijalankan.

Kondisi ini menyangkut perintah terminal, bukan build, sehingga tidak ada tahap kompilasi yang mencapainya: kondisi ini dimunculkan saat perintah yang terpasang di-dispatch, dan hasilnya adalah kegagalan perintah tersebut untuk dimulai, bukan penghentian dalam build mana pun.

Tidak ada jalur dalam alat baris perintah yang dirilis yang dapat memunculkannya. Setiap tempat alat tersebut membangun komponen itu menyediakan mekanisme pencarian, sehingga guard ini hanya terpicu ketika sesuatu yang lain membangunnya dan menghilangkan mekanisme pencarian tersebut.

Pesan yang dikeluarkan, yang merupakan kalimat kondisi itu sendiri:

cliplugin: no plugin resolver configured (cliplugin: tidak ada resolver plugin yang dikonfigurasi)

Cara memperbaiki: tidak ada isi berkas entitas Anda yang menyebabkan ini, dan tidak ada yang dapat Anda tulis dalam katalog atau workspace yang menghilangkannya. Jika Anda menjalankan alat baris perintah yang dirilis, kondisi ini tidak dapat Anda capai — perintah terpasang yang tidak mau dimulai sedang melaporkan hal lain, dan pesan yang dicetaknya adalah yang perlu dibaca. Jika Anda menyematkan runner plugin dalam perangkat lunak Anda sendiri, sediakan mekanisme pencarian yang meresolusi referensi plugin menjadi byte-nya saat Anda mengonstruksinya.

Alias registry sudah terikat ke host lain

Penolakan saat menambahkan registry ke workspace, bukan saat build. Alias adalah nama pendek yang memilih satu entri registry, sehingga alias bersifat unik di seluruh entri. Mendaftarkan alias yang sudah dipegang oleh host lain ditolak alih-alih dibiarkan membayangi ikatan yang sudah ada, yang akan secara diam-diam mengubah tujuan setiap referensi yang menggunakan alias tersebut.

Menambahkan ulang host yang sama dengan alias yang sudah dimilikinya bukanlah konflik — hal itu memperbarui entri di tempat, yang memang dilakukan ketika perintah dijalankan ulang untuk mengubah pengaturan lain suatu host.

Pesan yang dikeluarkan, yang menyebutkan alias dan host yang sudah memegangnya:

workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: alias registry sudah digunakan oleh host; pilih alias lain atau alamatkan host tersebut secara langsung: alias registry sudah digunakan oleh host lain)

Cara memperbaiki: perbaikan ini menjadi tanggung jawab operator, di baris perintah. Berikan alias lain untuk registry baru, atau biarkan tanpa alias dan rujuk melalui host-nya. Jika Anda bermaksud memindahkan alias ke host baru, hapus terlebih dahulu alias itu dari entri yang disebutkan pesan di .aggrega-config.yaml — penolakan ini ada agar pemindahan alias merupakan sesuatu yang Anda lakukan dengan sengaja, bukan efek samping dari penambahan registry.

Registry menyajikan dokumen kepercayaan yang tidak dapat dibaca sebagai dokumen tersebut

Penolakan saat menambahkan registry, bukan saat build. Registry dapat memublikasikan identitas penandatanganan yang diharapkannya digunakan untuk menandatangani artefak, sehingga penambahan registry dapat mem-pin identitas tersebut alih-alih membuat operator menyalinnya. Kondisi ini melaporkan registry yang menjawab dengan dokumen yang tidak dapat digunakan sebagai kebijakan kepercayaan.

Ini adalah penolakan keras justru karena endpoint menjawab. Registry yang tidak memublikasikan apa pun adalah hasil biasa dan wajar yang ditoleransi; registry yang memublikasikan sesuatu yang tidak terbaca adalah kesalahan konfigurasi, dan tidak mem-pin apa pun darinya akan membuat registry diam-diam tidak ter-pin padahal tampak seolah-olah sudah.

Tiga bentuk dilaporkan di sini: konten yang sama sekali tidak dapat didekode, termasuk dokumen yang memuat field yang tidak didefinisikan oleh format; entri identitas yang tidak menyebutkan identitas persis maupun pola; dan entri identitas tanpa issuer. Dua yang terakhir ditolak karena entri semacam itu tidak akan pernah cocok dengan tanda tangan, sehingga akan melemahkan pin sambil tampak memperkuatnya.

Pesan yang dikeluarkan. Konten yang tidak dapat didekode:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: konfigurasi kepercayaan yang diiklankan tidak valid)

entri identitas tanpa apa pun untuk dicocokkan:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: konfigurasi kepercayaan yang diiklankan tidak valid: entri identitas harus menetapkan identity atau identity_regexp)

dan entri tanpa issuer:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: konfigurasi kepercayaan yang diiklankan tidak valid: entri identitas harus menetapkan issuer)

Masing-masing dibingkai oleh perintah yang menemuinya:

aggrega registry add: <the message above>

Cara memperbaiki: perbaikan ini menjadi tanggung jawab siapa pun yang mengoperasikan registry, bukan Anda — kutip pesan tersebut kepada mereka, karena pesan itu menyebutkan entri yang tepat dan apa yang kurang darinya. Untuk melanjutkan sementara itu, tambahkan registry tanpa mem-pin kebijakan yang diiklankannya dan sediakan sendiri identitas atau kuncinya; perintah tersebut menerimanya secara langsung, yang juga Anda lakukan untuk registry yang sama sekali tidak memublikasikan kebijakan.

Registry tidak memublikasikan dokumen kepercayaan

Hasil biasa dan wajar, bukan kesalahan, dan tidak menghentikan apa pun. Registry dapat memublikasikan identitas penandatanganan yang diharapkannya, dan sebagian besar tidak melakukannya. Ketika diminta, registry semacam itu menjawab bahwa ia tidak memilikinya, dan penambahan registry tetap berlanjut — hasilnya dilaporkan sebagai pemberitahuan dan identitas di-pin secara manual sebagai gantinya.

Kondisi ini sengaja dibedakan dari registry yang tidak dapat dijangkau. Registry ini menjawab; jawabannya adalah bahwa ia tidak memublikasikan kebijakan. Memisahkan keduanya memungkinkan ketiadaan yang disengaja ditoleransi sementara masalah keterjangkauan tetap terlihat sebagai masalah.

Dilaporkan sebagai pemberitahuan, yang menyebutkan registry, apa jawabannya, dan apa yang perlu dilakukan sebagai gantinya:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Pemberitahuan: tidak memublikasikan kebijakan kepercayaan (HTTP 404); pin kepercayaannya secara manual dengan —identity atau —key)

Kondisi tempat ini dicatat adalah registrytrust: registry advertises no trust config.

Hub resmi adalah pengecualian: hub tersebut membawa baseline bawaan, sehingga ketika hub tidak memublikasikan dokumen, baseline itulah yang di-pin, dan pemberitahuan menyebutkan apa jawaban hub serta bahwa baseline digunakan sebagai gantinya, alih-alih meminta Anda mem-pin identitas.

Cara memperbaiki: tidak ada yang rusak. Jika Anda ingin tanda tangan dari registry ini diperiksa, sediakan identitas atau kunci saat menambahkannya, persis seperti yang dikatakan pemberitahuan — itulah jalur normal untuk registry yang tidak memublikasikan kebijakan. Jika tidak, registry ditambahkan tanpa sikap penandatanganan dan artefak darinya hanya diverifikasi ketika membawa tanda tangan.

Registry ditambahkan secara offline tanpa kebijakan kepercayaan untuk disematkan

Penolakan saat menambahkan registry, bukan saat build. Menambahkan registry adalah satu-satunya saat kepercayaannya disematkan: identitas penandatanganan yang diiklankannya diambil sekali dan setiap pull berikutnya diverifikasi terhadap salinan yang disematkan itu. Ketika workspace offline, pengambilan itu tidak dapat dilakukan, sehingga registry tidak pernah ditanya. Alih-alih menulis entri yang tidak memercayai apa pun — dan yang akan menjadi patokan bagi registry pada setiap pull berikutnya — penambahan registry selain hub resmi ditolak kecuali Anda menyediakan kebijakannya sendiri.

Tiga kasus tidak ditolak. Menyediakan identitas atau kunci akan mendaftarkan persis itu dan tidak melakukan pengambilan sama sekali, sehingga cara kerjanya sama saat offline maupun online. Hub resmi ditambahkan dengan baseline bawaannya, yang dimilikinya baik pengambilan dilakukan maupun tidak. Dan meminta tanpa pengambilan — --fetch-trust=false — mendaftarkan entri dari flag, persis seperti saat online.

Kondisi ini ditemui di mana pun registry ditambahkan: aggrega registry add, aggrega config init --registry <host>, permintaan aggrega/registryAdd dan aggrega/configInit dari aggrega serve, yang pesan galatnya memuat kode singkat di depan kalimat, serta alat pendaftaran dari aggrega mcp, yang menjalankan perintah-perintah tersebut. Penyemaian konfigurasi tidak menerima identitas atau kunci, sehingga saat offline hanya hub yang dapat disemai; tambahkan registry lain dengan aggrega registry add sebagai gantinya.

Pesan yang dikeluarkan, yang merupakan kalimat kondisi itu sendiri:

a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file> (registry selain hub resmi tidak didaftarkan secara offline tanpa kebijakan kepercayaan yang disediakan secara manual, karena kebijakan yang diiklankannya tidak dapat diambil; daftarkan sekali saat online, atau sematkan kepercayaannya secara manual)

dibingkai oleh perintah yang menemuinya dan registry yang disebutkannya:

aggrega registry add: <host>: <the message above>

Cara memperbaiki: daftarkan registry sekali saat workspace online — berikan --offline=false untuk satu kali jalankan itu, atau hapus pengaturan offline — sehingga kebijakan yang diiklankannya diambil dan disematkan; tidak ada yang perlu diulang sesudahnya, karena pull berikutnya diverifikasi terhadap salinan yang disematkan. Jika Anda tidak dapat online, sediakan kebijakannya secara manual: satu atau beberapa entri --identity <identity>=<issuer> untuk registry tanpa kunci, atau --key yang menunjuk ke berkas kunci publiknya untuk registry berkunci, yaitu apa yang akan Anda sematkan dari iklannya.

Tag sudah diterbitkan dengan konten berbeda

Penolakan saat penerbitan, bukan saat build. Byte yang diterbitkan bersifat beku: sebelum apa pun diunggah, versi target dicari dan digest yang ditunjuknya dibandingkan dengan digest yang akan dihasilkan oleh konten yang ada. Versi yang sudah menunjuk ke konten berbeda ditolak.

Menerbitkan ulang konten yang identik byte demi byte bukanlah konflik. Digest-nya cocok, tidak ada yang diunggah, dan perintah melaporkan bahwa versi tersebut sudah diterbitkan — sehingga menjalankan ulang penerbitan yang sebagian berhasil aman dilakukan, dan itu menuntaskan penerbitan: tanggal penerbitan yang masih belum dimiliki versi tersebut, serta tanda tangannya bila push menandatangani, dilampirkan, dan versi yang tidak kekurangan keduanya tidak mendapat apa-apa, sebagaimana dijelaskan dalam Completing a publication an earlier push left partial.

Tidak ada flag yang mengesampingkan ini. Konten yang berubah diterbitkan dengan versi baru, yang memberi konsumen versi untuk dituju secara sengaja, alih-alih versi yang berubah tanpa sepengetahuan mereka.

Pesan yang dikeluarkan, menyebutkan versi, digest yang dimilikinya, dan digest yang ditawarkan. Menerbitkan entitas katalog, yang juga menyebutkan pemeriksaan yang memverifikasi kenaikan versi:

aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (sudah diterbitkan; menolak menimpa — terbitkan versi baru (aggrega lint —pre-publish memverifikasi kenaikannya): oci: tag sudah diterbitkan dengan konten berbeda)

dan menerbitkan artefak data:

aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (sudah diterbitkan; menolak menimpa — terbitkan versi baru: oci: tag sudah diterbitkan dengan konten berbeda)

Cara memperbaiki: naikkan versi dan terbitkan lagi. Untuk entitas katalog, itu berarti metadata.version dan direktori per versi tempat entitas berada, yang berubah bersama-sama. Sebelum melakukannya, periksa bahwa perubahan itu memang Anda maksudkan: dua digest yang berbeda pada versi yang Anda yakini tidak Anda sentuh berarti konten di disk bukanlah konten yang diterbitkan, dan mencari tahu penyebabnya lebih berharga daripada menerbitkan di atasnya. Pemeriksaan pra-penerbitan yang disebutkan dalam pesan membandingkan sebuah versi dengan versi sebelumnya dan merupakan cara untuk memastikan kenaikan versinya benar.

Entitas berbagi direktori dengan entitas lain

Penolakan saat penyematan dan penerbitan, bukan saat build. Setiap jenis entitas memiliki direktorinya sendiri, kecuali tiga yang ditempatkan berdampingan di root workspace: Aggregate, Release, dan Manifest. Entitas yang diterbitkan adalah satu artefak pada satu koordinat untuk setiap versi, dan direktori tempat entitas itu ditulis mencerminkan hal tersebut — langkah pin menulis satu-satunya entity.lock yang dapat ditampung sebuah direktori, dan penerbitan mengemas entitas dari direktorinya. Jadi entitas dari jenis lain apa pun yang memiliki entitas lain di sampingnya ditolak pada kedua saat itu: oleh aggrega pin, oleh pull atau push yang diminta melakukan pin atas nama penulis, dan oleh aggrega push baik melakukan pin maupun tidak. Penolakan terjadi sebelum apa pun diambil, dan tidak ada yang ditulis.

Direktori yang berisi beberapa entitas tetap dapat dimuat, di-lint, divalidasi, dan di-build. Tata letaknya hanya dinilai ketika sesuatu dihasilkan dari direktori itu, yang juga merupakan saat pesan dapat menyebutkan entitas yang menghalangi. Pull yang tidak melakukan pin tidak menulis apa pun di samping entitas dan tidak ditolak.

Yang dihitung sebagai entitas di sampingnya adalah dokumen YAML lain apa pun yang langsung berada di direktori yang sama dan yang kind:-nya adalah jenis entitas. Berkas milik chart, fragmen compose, manifest Kubernetes, atau README bukanlah entitas, dan subdirektori — chart lokal, pohon source/ — tidak berada di samping entitas, apa pun isinya. Hanya jenis dan nama setiap tetangga yang dibaca, sehingga tidak ada yang dideklarasikan tetangga yang dapat mengubah hasilnya.

Nama direktori tidak dinilai. Entitas yang sendirian di direktorinya dapat di-pin dan diterbitkan pada versi yang dideklarasikannya di mana pun direktori itu berada; tata letak <name>/<version>/ yang digunakan katalog pustaka standar adalah konvensi, bukan pemeriksaan.

Pesan yang dikeluarkan, menyebutkan entitas, setiap entitas di sampingnya, dan berkas yang perlu dipindahkan:

the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (entitas berbagi direktori dengan entitas lain, dan entitas dari jenisnya memiliki direktori sendiri (Recipe, di sampingnya: Recipe di berkas). remediasi: berikan setiap entitas direktorinya sendiri — pindahkan berkas ke direktorinya sendiri, bersama berkas apa pun yang hanya dibaca entitas itu; hanya jenis Aggregate, Manifest, dan Release yang boleh berbagi direktori dengan entitas lain)

Cara memperbaiki: pindahkan setiap entitas yang disebutkan pesan ke direktorinya sendiri, dengan membawa berkas yang hanya dibacanya — chart lokal, berkas yang diimpor, dan entity.lock jika berkas itu mencatat pin entitas tersebut — lalu jalankan aggrega pin pada setiap entitas yang membaca sumber jarak jauh atau mengimpor berkas, sehingga setiap lock mencatat entitasnya sendiri. Menata masing-masing sebagai <kind>/<provider-or-publisher>/…/<name>/<version>/ menempatkannya di tempat katalog pustaka standar menyimpan setiap entitas. Direktori katalog ditemukan dengan menelusurinya, sehingga build atas katalog menghasilkan keluaran yang sama setelah pemindahan.

An entity kind has no artifact media type (Sebuah jenis entitas tidak memiliki media type artifact)

Penolakan saat publikasi, bukan saat build. Setiap jenis entitas yang dapat dipublikasikan memiliki media type untuk masing-masing dari dua bentuk artifact-nya — dokumennya saja, atau arsip berisi dokumen dan file yang dideklarasikannya — dan pengemasan entitas mencarinya berdasarkan jenis. Kondisi ini melaporkan jenis yang tidak memiliki entri.

Tidak ada build yang mencapainya. Satu-satunya tempat lain yang menjalankan pencarian yang sama memperlakukan entri yang hilang sebagai “ini bukan library” dan melanjutkan, sehingga kondisi ini tidak pernah muncul di sana.

Pesan yang dikeluarkan: kalimat kondisi itu sendiri, dibingkai oleh perintah dan file yang sedang dikemas:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: bundle: oci: jenis entitas tidak dikenal untuk penentuan media type)

Cara memperbaiki: periksa field kind: pada file yang Anda publikasikan terhadap jenis yang dicetak oleh aggrega push --list-kinds — jenis yang salah eja atau tidak didukung dilaporkan di sini, dan membetulkan field tersebut adalah seluruh solusinya. Jika jenis tersebut tercantum dalam daftar itu, itu adalah kekurangan pada toolchain, bukan pada entitas Anda, dan layak dilaporkan dengan menyertakan jenisnya.

A published archive carries an entry Windows cannot use (Arsip yang dipublikasikan memuat entri yang tidak dapat digunakan Windows)

Sebuah peringatan yang dimunculkan saat entitas dipublikasikan; peringatan ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Entitas yang membawa file di samping dokumennya dipublikasikan sebagai arsip, dan setiap nama yang dimuat arsip — nama file dokumen entitas itu sendiri, lalu setiap file yang dibawanya — dinilai dengan aturan yang diterapkan di Windows oleh halt “A name the operation writes holds a part Windows cannot hold (Nama yang ditulis operasi memuat bagian yang tidak dapat dimuat Windows)” di atas: bagian yang dicadangkan Windows untuk perangkat, dalam huruf besar atau kecil apa pun dan dengan ekstensi apa pun yang mengikutinya, atau bagian yang diakhiri titik atau spasi. Jadi aux/x.yaml memunculkannya karena direktorinya aux, report. karena titik di akhirnya, dan dokumen bernama con.yaml yang mengimpor file skema karena namanya sendiri. Entitas yang tidak membawa apa pun dipublikasikan sebagai dokumennya saja, ditata dengan nama yang dipilih produk, dan Plugin tidak memublikasikan arsip, sehingga keduanya tidak memunculkannya.

Peringatan ini dimunculkan di setiap platform, dan tidak menolak apa pun. Workspace di Windows menolak menata entri semacam itu, di bawah halt tersebut, sehingga tidak dapat menggunakan versi itu; peringatan ini adalah cara penerbit mengetahuinya sebelum seseorang di Windows mengalaminya. Publikasi, atau dry run-nya, berlanjut atau berhenti persis seperti tanpa peringatan ini.

Setiap antarmuka yang memublikasikan entitas memunculkannya, masing-masing dalam bentuknya sendiri. aggrega push, dan --dry-run-nya, mencetak satu baris per entri pada standard error, masing-masing diawali warning: . Tool publish-entity milik asisten menjawab dengan entri-entri tersebut sebagai windows_unusable_entries, dan teks jawabannya juga menyebutkannya. aggrega serve menjawab aggrega/publishEntity dengan entri-entri tersebut sebagai windowsUnusableEntries, dan meneruskan baris peringatan itu sendiri ke permintaan yang meminta untuk dilaporkan. Setiap jawaban menghilangkan field tersebut jika tidak ada entri semacam itu.

Pesannya dimulai dengan:

an entry this publication carries cannot be used on Windows (entri yang dibawa publikasi ini tidak dapat digunakan di Windows)

dan dilanjutkan dengan entri tersebut dan bagian pertamanya yang tidak dapat dimuat Windows, lalu solusinya. Dijelaskan di bawah “A published archive carries an entry Windows cannot use (Arsip yang dipublikasikan memuat entri yang tidak dapat digunakan Windows)” dalam warnings.md.

Cara memperbaiki: ganti nama bagian yang disebutkan pesan, di disk dan di mana pun deklarasi entitas menyebut file tersebut, lalu publikasikan lagi. Jika versi tersebut tidak dimaksudkan untuk digunakan di Windows, tidak ada yang perlu diubah.

Dua identitas katalog dipublikasikan ke satu lokasi repositori

Penolakan saat memeriksa seluruh katalog, bukan saat build. Tujuan publikasi sebuah entitas diturunkan dari identitasnya dan diubah menjadi huruf kecil, sehingga dua identitas yang hanya berbeda dalam huruf besar-kecil berakhir di tempat yang sama. Memublikasikan keduanya akan membuat byte satu entitas ditimpa oleh byte entitas lainnya, dan tidak ada apa pun di kedua entitas yang menunjukkannya.

Pemeriksaan dijalankan atas seluruh katalog sekaligus, karena tabrakan adalah sifat sebuah pasangan, bukan sifat salah satu entitas secara terpisah — tidak ada yang salah dengan sendirinya, dan membaca salah satunya secara terpisah tidak menunjukkan apa-apa.

Pesan yang dikeluarkan. Bingkai pemeriksaan katalog membukanya, lalu kalimat kondisi itu sendiri, lalu setiap kelompok yang bertabrakan, masing-masing menyebutkan lokasi bersama dan identitas yang mencapainya:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (validasi katalog gagal: oci: identitas katalog yang berbeda dipetakan ke lokasi repositori OCI yang sama:)

  • <location> <- <identity>, <identity>

Cara memperbaiki: ganti nama salah satu entitas yang disebutkan pesan, di metadata.name-nya dan di direktori yang mencerminkannya. Entitas mana yang diganti namanya adalah pilihan Anda; pasangan yang hanya berbeda huruf besar-kecil adalah bentuk yang umum, dan memilih satu ejaan serta menggunakannya secara konsisten adalah hal yang mencegah pasangan itu terulang. Mengganti nama adalah perubahan nyata pada identitas entitas, sehingga apa pun yang merujuk ke nama lama harus ikut berpindah — itulah alasan untuk menyelesaikan tabrakan sebelum salah satu nama dipublikasikan, bukan sesudahnya.

Penandatanganan tanpa kunci diminta tanpa layanan yang dibutuhkannya

Penolakan saat menandatangani ketika memublikasikan, bukan saat build. Penandatanganan tanpa kunci tidak memiliki bentuk luring: proses ini memperoleh identitas, meminta penerbitan sertifikat berumur pendek untuknya, mencatat tanda tangan di tempat yang dapat diperiksa kemudian, lalu membuang kuncinya. Setiap langkah tersebut merupakan pertukaran dengan layanan yang sedang berjalan. Kondisi ini melaporkan bahwa identitas yang menjadi titik awal alur tersebut tidak tersedia, sehingga alur ditolak alih-alih dimulai lalu ditinggalkan di tengah jalan.

Dua bentuk melaporkannya: tidak ada yang dikonfigurasi untuk menyediakan identitas sama sekali, dan ada sesuatu yang dikonfigurasi tetapi tidak menghasilkan apa pun.

Workspace luring melaporkannya secara berbeda, di bawah penolakan yang mencakup setiap langkah jaringan, karena penolakan terjadi sebelum identitas pernah diminta.

Pesan yang dikeluarkan. Tidak ada sumber identitas:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (signing: penandatanganan tanpa kunci memerlukan penyedia identitas yang aktif, Fulcio, dan Rekor: sumber token identitas diperlukan)

dan sumber yang tidak menghasilkan apa pun:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (signing: penandatanganan tanpa kunci memerlukan penyedia identitas yang aktif, Fulcio, dan Rekor: token identitas diperlukan)

Cara memperbaiki: perbaikan ada di tangan operator, dalam cara publikasi dijalankan. Dalam pipeline otomatis, identitas berasal dari kredensial pipeline itu sendiri, sehingga hal ini biasanya berarti job tidak diberi izin yang menerbitkannya. Jika dijalankan secara interaktif, identitas berasal dari proses masuk, yang akan diminta oleh perintah. Jika Anda sama sekali tidak menginginkan identitas aktif, tandatangani dengan kunci yang Anda pegang — jalur itu tidak memerlukan satu pun layanan ini, dan itulah yang digunakan dari lingkungan yang tidak dapat menjangkaunya.

Publikasi tanpa tanda tangan menargetkan registry atau kebijakan yang mewajibkan tanda tangan

Penolakan saat memublikasikan, bukan saat build. Jika tanda tangan diwajibkan, konten tanpa tanda tangan tidak dipublikasikan. Pemeriksaan dijalankan sebelum byte apa pun diunggah, sehingga tidak ada bagian yang sampai ke registry.

Dua kondisi, karena kewajiban memiliki dua sumber dan perbaikannya berbeda. Satu adalah sikap registry tujuan itu sendiri, yang berlaku untuk semua yang dipublikasikan di sana. Yang lain adalah kebijakan penandatanganan workspace, yang mencakup sekumpulan jenis artefak di mana pun dipublikasikan. Jika keduanya berlaku, yang dilaporkan adalah milik registry, karena menyebutkan tujuan adalah yang lebih berguna dari keduanya.

Tidak ada flag yang memublikasikan konten tanpa tanda tangan di sini. Menonaktifkan penandatanganan secara eksplisit tidak melonggarkan penolakan — itu hanya mengubah bawaan untuk artefak yang penandatanganannya opsional.

Tanda tangan dibuat sebelum pengunggahan, bukan sesudahnya, sehingga kegagalan penandatanganan juga berakhir di sini dan tidak ada yang dipublikasikan.

Pesan yang dikeluarkan. Kewajiban milik registry itu sendiri:

aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: registry mewajibkan tanda tangan; jalankan ulang dengan menandatangani artefak (tidak ada flag untuk mendorong konten tanpa tanda tangan di sini): signing: registry mewajibkan tanda tangan; menolak mendorong konten tanpa tanda tangan)

milik kebijakan workspace, yang menyebutkan jenis yang membawa artefak ke dalam cakupan:

aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: kebijakan penandatanganan mewajibkan tanda tangan untuk jenis tersebut; jalankan ulang dengan menandatangani artefak (tidak ada flag untuk mendorong konten tanpa tanda tangan di sini): signing: kebijakan penandatanganan mewajibkan tanda tangan untuk jenis artefak ini; menolak mendorong konten tanpa tanda tangan)

dan tanda tangan yang tidak dapat dibuat, yang dilaporkan di bawah kondisi registry dan mengutip kegagalan yang mendasarinya:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: menandatangani: signing: registry mewajibkan tanda tangan; menolak mendorong konten tanpa tanda tangan)

Satu bentuk kegagalan penandatanganan disebutkan secara khusus, karena penolakan umum membuat orang memperoleh ulang kredensial yang tidak dapat membantu:

aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: menandatangani: token identitas tidak membawa klaim email atau subjek yang terverifikasi — alur/klien OIDC tidak mengembalikan identitas bercakupan email (mengekspor ulang atau memperoleh ulang token tidak akan membantu); konfigurasikan penyedia identitas/klien/cakupan agar mengembalikannya: signing: registry mewajibkan tanda tangan; menolak mendorong konten tanpa tanda tangan)

Cara memperbaiki: perbaikan ada di tangan operator. Tandatangani artefak dan publikasikan lagi — baik dengan kunci yang Anda pegang maupun dengan jalur tanpa kunci, mana pun yang disiapkan untuk workspace. Jika Anda tidak menduga tanda tangan diwajibkan, pesan menyebutkan sumber mana yang mewajibkannya: sikap registry itu sendiri ada di entri registry tersebut dalam .aggrega-config.yaml, dan kewajiban berdasarkan jenis ada di kebijakan penandatanganan tingkat workspace. Melonggarkan salah satunya adalah keputusan tentang apa yang bersedia Anda publikasikan tanpa tanda tangan, sehingga mempersempit cakupan kebijakan biasanya lebih baik daripada menonaktifkannya.

Referensi yang ditandatangani bersama memerlukan kredensial penandatanganan yang berbeda

Penolakan saat penandatanganan, bukan saat build. aggrega sign yang diberi beberapa referensi, dan aggrega deprecate --from yang diberi file batch, menandatangani semua yang diberikan kepadanya dengan satu kredensial: satu kunci yang disimpan, atau satu identitas keyless. Kredensial yang diperlukan suatu referensi ditentukan oleh konfigurasi untuk registry-nya — signing.key_path yang berlaku untuk registry tersebut memilih kunci yang dinamainya, dan jika tidak ada yang berlaku, referensi ditandatangani secara keyless. Jika referensi yang disebutkan bersama memerlukan kredensial yang berbeda — sebuah kunci untuk satu registry dan tanpa kunci untuk registry lain, atau dua kunci yang berbeda — tidak ada yang ditandatangani, dan pesan menyebutkan registry di masing-masing sisi.

Pemeriksaan dijalankan sebelum identitas diminta dan sebelum registry mana pun dibaca, sehingga tidak ada yang ditandatangani atau dilampirkan dan tidak ada yang diminta masuk untuk proses yang tidak akan berlanjut. Tanda tangan tidak dapat ditarik kembali dari siapa pun yang telah mengambilnya, itulah sebabnya proses ditolak alih-alih ditandatangani dengan kredensial mana pun yang diperlukan salah satu referensi.

Kunci yang diberikan dengan --key menentukan untuk setiap referensi. Kunci itu berlaku untuk setiap referensi yang disebutkan, apa pun yang dinyatakan konfigurasi untuk setiap registry, sehingga proses seperti itu tidak pernah ditolak di sini.

Kondisi ini ditemui di mana pun sebuah batch ditandatangani: aggrega sign, aggrega deprecate --from, permintaan aggrega/signArtifacts dan aggrega/deprecateArtifact dari aggrega serve, yang pesan galatnya memuat kode singkat sebelum kalimatnya, serta alat sign-artifacts dan deprecate-artifact dari aggrega mcp. Pemanggilan alat yang mencapai server melalui listener tidak pernah menggunakan kunci yang disebutkan konfigurasi, sehingga di sana setiap referensi ditandatangani dengan identitas yang dikirim oleh pemanggilan dan pemanggilan tidak ditolak di sini.

Pesan yang dikeluarkan. Kalimat kondisi itu sendiri membukanya, setiap kredensial menyusul beserta registry yang akan ditandatanganinya, dan perbaikannya ada di akhir:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (aggrega sign: signing: referensi yang disebutkan bersama memerlukan kredensial penandatanganan yang berbeda, sehingga tidak ada yang ditandatangani (registry ditandatangani dengan kunci yang disimpan yang dinamai signing.key_path, registry ditandatangani secara keyless: tidak ada signing.key_path yang berlaku). perbaikan: tandatangani dalam proses terpisah, satu per kredensial: referensi pada registry pertama, lalu referensi pada registry berikutnya; setiap proses menandatangani seperti jika dijalankan sendiri)

dan, jika sebuah registry dalam batch mewajibkan tanda tangan, dengan menyebutkannya di akhir perbaikan:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (aggrega sign: signing: referensi yang disebutkan bersama memerlukan kredensial penandatanganan yang berbeda, sehingga tidak ada yang ditandatangani (registry ditandatangani dengan kunci yang disimpan yang dinamai signing.key_path, registry ditandatangani secara keyless: tidak ada signing.key_path yang berlaku). perbaikan: tandatangani dalam proses terpisah, satu per kredensial: referensi pada registry pertama, lalu referensi pada registry berikutnya; setiap proses menandatangani seperti jika dijalankan sendiri, dan registry tersebut mewajibkan tanda tangan, sehingga penolakan ini menahan penandatanganan yang sebenarnya akan berlanjut, bukan penandatanganan yang tidak dapat dilakukan)

Registry kedua dengan kuncinya sendiri disebutkan sebagai menandatangani “with a different held key” (dengan kunci tersimpan yang berbeda). Path kunci tidak pernah dicetak: pesan menyebutkan pengaturannya, yang merupakan hal yang dapat Anda ubah.

Cara memperbaiki: pisahkan referensi menurut kredensial yang diperlukan registry-nya dan jalankan sekali per kredensial — satu aggrega sign yang menyebutkan referensi pada registry yang ditandatangani dengan kunci, satu lagi yang menyebutkan sisanya; untuk aggrega deprecate --from, satu file batch per kredensial. Setiap proses kemudian menandatangani seperti jika dijalankan sendiri. Untuk menandatangani setiap referensi dengan satu kunci dalam satu proses, berikan kunci tersebut dengan --key.

Tanda tangan terpisah tidak terverifikasi terhadap kunci yang diberikan

Hasil negatif dari pemeriksaan tanda tangan polos atas sebuah payload terhadap kunci publik, sepenuhnya secara offline: payload berbeda dari yang ditandatangani, tanda tangan telah diubah, atau kunci bukan kunci yang menghasilkannya.

Tidak ada bagian dari toolchain yang dirilis yang mencapainya. Pemeriksaan tempat kondisi ini berada tidak memiliki pemanggil di luar pengujiannya sendiri, sehingga tidak ada perintah yang dijalankan pengguna — build, pull, atau publish — yang melaporkannya. Kondisi ini dikatalogkan di sini agar kodenya merujuk ke sesuatu, bukan karena build dapat mencetaknya. Verifikasi yang benar-benar dilakukan pull adalah atas bundel tanda tangan lengkap dan dilaporkan secara terpisah.

Pesan yang dikeluarkan, mengutip apa yang dilaporkan verifier:

signing: signature does not verify: <what the verifier reported> (signing: tanda tangan tidak terverifikasi: apa yang dilaporkan verifier)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini, dan tidak ada yang dapat Anda tulis dalam katalog atau workspace yang menghilangkannya. Jika Anda menjalankan alat command-line yang dirilis, ini bukan kondisi yang dapat Anda capai, dan masalah tanda tangan yang sebenarnya Anda hadapi dilaporkan oleh salah satu kondisi verifikasi bundel di atas. Jika Anda menggunakan paket penandatanganan secara langsung dari perangkat lunak Anda sendiri, payload, tanda tangan, dan kunci harus merupakan tiga hal yang saling terkait — payload yang diserialisasi ulang di antara penandatanganan dan verifikasi adalah penyebab yang umum, karena byte-nya kemudian berbeda meskipun kontennya terbaca sama.

Artefak yang di-resolve bukan bundel dokumentasi

Referensi yang me-resolve ke artefak jenis lain — entitas katalog, plugin — ditolak alih-alih di-cache sebagai dokumentasi, sehingga referensi yang salah arah gagal di tempat ia diarahkan, bukan belakangan sebagai bundel yang tidak dapat dibaca.

Tempat kondisi ini muncul. Bundel dokumentasi diperoleh ke dalam cache yang dipakai bersama oleh setiap proyek di mesin, dari registry yang dikonfigurasi workspace di bawah namespace docs yang dicadangkan: oleh server yang melayani asisten sekali, saat dimulai dan sebelum menjawab apa pun, oleh aggrega explain serta penjelasan kode oleh editor saat pertama kali salah satunya memerlukannya, dan oleh aggrega scaffold --example — dalam setiap kasus hanya jika mesin tidak menyimpan salinan yang diterima oleh pemeriksaan tanda tangan workspace. Inilah pemeriksaan yang dijalankan setiap pengambilan atas apa yang diterima.

Kondisi ini tidak pernah menghentikan sesi. Pengambilan melaporkan hasilnya pada aliran log server dan koneksi tetap berlanjut; yang hilang akibat artefak yang ditolak adalah sumber daya dokumentasi, yang kemudian menjawab not-found untuk sesi tersebut. aggrega scaffold --example tidak memiliki apa pun untuk ditulis tanpa bundel, sehingga di sana kondisi ini menjadi penolakan perintah tersebut, dan tidak ada yang ditulis.

Pesan yang dikeluarkan, menyebutkan referensi dan kedua media type:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (docscache: referensi memiliki media type yang ditemukan, seharusnya media type bundel dokumentasi: docscache: artefak bukan bundel dokumentasi)

Cara memperbaiki: tidak ada apa pun dalam file entitas Anda yang menyebabkan ini, dan tidak ada perubahan penulisan yang menghilangkannya. Referensi yang digunakan pengambilan mengarah ke sesuatu yang bukan bundel dokumentasi — periksa registry yang dikonfigurasi workspace, karena referensi bundel diturunkan darinya, dan referensi yang berbentuk benar dan mengarah ke artefak lain akan berhasil di-resolve dan hanya gagal di sini.

Halaman tidak ada dalam bundel dokumentasi

Sebuah bundel dokumentasi telah di-cache dan isinya diverifikasi, tetapi halaman yang diminta — atau, untuk aggrega scaffold --example, direktori contoh tersebut — tidak ada di dalamnya. Kondisi ini berbeda dari tidak adanya bundel sama sekali: bundelnya ada dan utuh, tetapi entrinya tidak ada di dalamnya.

Kondisi ini tidak mencapai build apa pun. Permukaan yang menyajikan halaman dokumentasi ke editor atau asisten mengubahnya menjadi jawaban not-found biasa untuk sumber daya yang diminta. aggrega scaffold --example tidak menulis apa pun dan melaporkannya sebagai penolakan yang menyebutkan contoh dan bundel tersebut, diikuti petunjuk ke aggrega scaffold --example --list, yang mencetak contoh-contoh yang memang dimuat bundel.

Perlu dibedakan jawaban not-found mana yang Anda terima, meskipun permukaan tersebut menampilkannya dengan cara yang sama. Jawaban ini berarti bundel telah di-cache dan utuh, tetapi halamannya tidak ada di dalamnya. Jawaban yang lain — tidak ada bundel yang boleh dibaca workspace, karena tidak ada yang di-cache atau satu-satunya salinan adalah salinan yang ditolak oleh pemeriksaan tanda tangan workspace — berarti akuisisi tidak selesai, dan aliran log server menyebutkan alasannya.

Pesan yang dikeluarkan, yang menyebutkan halaman dan bundel tempat halaman itu dicari:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (halaman di dalam: docscache: halaman tidak ditemukan dalam bundel dokumentasi)

Cara memperbaiki: tidak ada yang rusak dalam berkas Anda. Halaman yang tidak ada dalam bundel tidak ada karena bundel tersebut lebih lama daripada halaman itu atau path yang diminta bukan path tempat halaman itu dipublikasikan — bundel diakuisisi pada versi yang dilaporkan server sebagai versinya sendiri, sehingga halaman yang ditambahkan setelah versi tersebut tidak ada di dalamnya. Jika halaman itu tidak pernah ada, permintaan tersebut menyebutkan path yang tidak digunakan dokumentasi, dan dokumentasi yang dipublikasikan adalah tempat untuk menemukan path yang digunakan.

Suntingan akan menghasilkan dokumen yang ditolak skemanya

Penolakan pada suntingan dokumen, bukan pada build. Satu suntingan terstruktur — menambahkan komponen, melampirkan Feature, menyambungkan edge, atau menetapkan nilai — disusun dan disisipkan ke dalam dokumen, lalu hasilnya diperiksa terhadap skema untuk jenis dokumen tersebut. Jika pemeriksaan itu berkeberatan, suntingan ditolak dan tidak ada yang ditulis. Kondisi ini milik aggrega edit-document, serta kapabilitas yang sama yang dijangkau oleh editor melalui aggrega serve atau oleh asisten, yang merupakan titik masuk tipis ke satu implementasi.

Jenisnya dibaca dari dokumen, tidak pernah diberikan oleh pemanggil. Pemanggil yang menyebutkan jenisnya bisa menyebutkan jenis yang salah, dan hasilnya kemudian akan diperiksa terhadap skema yang bukan skema dokumen tersebut — yang justru akan meloloskan suntingan yang hendak ditolak oleh pemeriksaan ini.

Berkas dibiarkan persis byte demi byte seperti semula, dan penulisannya atomik, sehingga suntingan yang ditolak tidak dapat dibedakan dari suntingan yang tidak pernah dicoba, dan permintaan yang telah diperbaiki dapat dicoba ulang terhadap dokumen awal Anda.

Subjeknya adalah permintaan yang terbentuk dengan benar. Permintaan tersebut menyebutkan suntingan yang diterapkan kapabilitas ini, dan dokumen yang akan dihasilkannya adalah dokumen yang akan ditolak skema authoring seandainya Anda mengetiknya secara manual — itulah sebabnya tidak ada aturan authoring yang dinyatakan ulang untuknya: meminta Release membawa nilai developer ditolak oleh skema yang sama dengan cara mana pun. Permintaan yang tidak pernah menyasar suatu suntingan — path node yang tidak menjangkau apa pun dalam dokumen, nilai yang ditulis sebagai mapping padahal yang diminta adalah skalar, entri yang sudah ada dengan isi lain — ditolak atas dasarnya sendiri, dan setiap permukaan melaporkannya melalui salurannya sendiri.

Dokumen yang sudah tidak valid sebelumnya juga melaporkannya. Pemeriksaan tetap berjalan meskipun suntingan tidak mengubah apa pun, sehingga suntingan terhadap dokumen yang akan ditolak dibaca oleh produk menyatakan hal itu alih-alih melaporkan keberhasilan.

Pemeriksaan ini sama dengan yang diterapkan pada setiap pembacaan dokumen, sehingga pemeriksaan ini juga menolak Recipe atau FeatureRecipe yang pipeline-nya mendeklarasikan satu id langkah dua kali, aturan yang tidak dapat dinyatakan oleh skema mana pun; keberatan setelah kalimat itu kemudian dibuka dengan kalimat dan saran milik kondisi tersebut, seperti dijelaskan di A pipeline declares one step id twice (Pipeline mendeklarasikan satu id langkah dua kali).

Pesan yang dikeluarkan, yang memuat keberatan skema itu sendiri setelah kalimatnya — jenis dokumen dan berkasnya, lalu posisi, kunci yang bermasalah, dan apa yang dinyatakan skema di sana — dan diakhiri dengan saran:

the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (suntingan ditolak karena dokumen yang dihasilkan tidak akan valid, dan tidak ada yang ditulis: validasi envelope dokumen gagal. Perbaiki dokumen agar sesuai dengan skema jenisnya)

Cara memperbaiki: buka dokumen pada posisi yang dikutip pesan dan baca keberatannya, yang menyebutkan apa yang diinginkan skema pada kunci tersebut. Perubahan yang perlu dilakukan biasanya pada permintaan, bukan pada dokumen — mintalah entri yang diizinkan skema di tempat itu, dan permintaan yang sama akan diterapkan dengan bersih. Jika kuncinya sama sekali tidak boleh dibawa oleh jenis dokumen tersebut, kunci itu termasuk dalam permukaan authoring yang boleh membawanya, dan halaman entitas untuk jenis tersebut menyebutkan field yang dideklarasikannya. Apa yang dapat diterima secara semantik tidak diputuskan pada titik ini — misalnya apakah sebuah socket dependensi dideklarasikan oleh produsennya — sehingga penolakan ini selalu menyangkut bentuk dokumen, tidak pernah menyangkut apa yang boleh dikonsumsi melintasi koneksi.

Kunci anotasi menggunakan prefiks yang dicadangkan platform

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan pada build. Prefiks aggrega.ai/, dan feature.aggrega.ai/ di luar Feature, dimiliki platform: kunci yang ditulis di bawah salah satunya membawa makna yang ditetapkan platform, sehingga entitas milik Anda yang menulis di sana mengklaim namespace yang bukan miliknya.

Kondisi ini memberi saran selama Anda menulis dan menolak di gerbang publikasi, dan kedua pembacaan menyebutkan kondisi yang sama ini. Apa yang ditemukan sama saja; hanya konsekuensinya yang berbeda. Pembagian itu adalah cara sebagian besar aturan konvensi publikasi yang dikatalogkan di sini berperilaku, sehingga hal ini dinyatakan sekali dan dianggap berlaku untuk entri di bawah yang tidak menyatakan lain — dua entri yang membandingkan dengan versi yang sudah dipublikasikan menyatakannya di entri masing-masing, karena keduanya sama sekali tidak dapat dijalankan atas konten lokal.

Pesannya dimulai dengan:

an annotation key on the entity uses a prefix the platform reserves (kunci anotasi pada entitas menggunakan prefiks yang dicadangkan platform)

Cara memperbaiki: pindahkan kunci ke bawah prefiks yang dimiliki organisasi Anda sendiri. Jika sebuah workspace tetap memiliki alasan untuk menulis di bawah prefiks yang dicadangkan, aturan ini termasuk salah satu opsi pengecualian yang dijelaskan di bagian “The discipline rules” dalam aggrega-lint.md.

An entity’s name does not follow the shape its kind expects (Nama entitas tidak mengikuti bentuk yang diharapkan jenisnya)

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan saat build. Setiap jenis entitas memiliki konvensi bentuk nama — jumlah segmen untuk jenis cloud-native, PascalCase untuk jenis pustaka — dan nama yang dideklarasikan entitas ini tidak cocok dengan bentuk yang diharapkan jenisnya.

Pesannya dimulai dengan:

the entity’s name does not follow the documented name shape for its kind (nama entitas tidak mengikuti bentuk nama yang didokumentasikan untuk jenisnya)

Cara memperbaiki: ganti nama entitas sesuai bentuk yang diharapkan jenisnya; konvensi per jenis tercantum di bawah “The discipline rules” dalam aggrega-lint.md, beserta opsi pengecualian untuk katalog yang sengaja menamai entitas dengan caranya sendiri.

A schema uses a dynamic reference that cannot be resolved ahead of time (Skema menggunakan referensi dinamis yang tidak dapat diselesaikan lebih awal)

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan saat build. Sebuah skema yang dibawa entitas menggunakan konstruksi referensi dinamis, yang targetnya dipilih saat dokumen sedang divalidasi alih-alih ditetapkan saat skema ditulis. Di sini referensi diekspansi lebih awal, sehingga tidak ada validasi yang sedang berjalan yang dapat menjadi acuan penyelesaian konstruksi tersebut.

Pesannya dimulai dengan:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (sebuah skema dalam entitas menggunakan konstruksi referensi dinamis yang tidak dapat diikuti oleh penyelesaian referensi lintas dokumen)

Cara memperbaiki: ganti konstruksi dinamis dengan referensi biasa yang menyebut target secara langsung. Jika skema benar-benar memerlukan konstruksi tersebut dan tidak akan direferensikan lintas dokumen, aturan ini memiliki opsi pengecualian yang dijelaskan di bawah “The discipline rules” dalam aggrega-lint.md.

A schema declares an identifier the platform owns (Skema mendeklarasikan pengenal yang dimiliki platform)

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan saat build. Sebuah skema yang dibawa entitas mendeklarasikan pengenalnya sendiri, padahal pengenal kanonis diturunkan dari identitas entitas. Pengenal yang dideklarasikan menggantikan pengenal turunan, sehingga referensi yang ditulis terhadap pengenal kanonis tidak lagi dapat diselesaikan.

Pesannya dimulai dengan:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (sebuah skema dalam entitas mendeklarasikan pengenalnya sendiri, padahal platform memiliki identitas skema tersebut)

Cara memperbaiki: hapus pengenal yang dideklarasikan dan biarkan pengenal diturunkan. Opsi pengecualian, untuk skema yang sengaja dipublikasikan dengan pengenalnya sendiri, dijelaskan di bawah “The discipline rules” dalam aggrega-lint.md.

A Component’s category label and its directory name different categories (Label kategori dan direktori sebuah Component menyebut kategori yang berbeda)

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan saat build. Sebuah Component memiliki label kategori dan disimpan di bawah direktori kategori; konvensinya adalah keduanya menyebut kategori yang sama, sehingga direktori yang dijelajahi pembaca dan label yang dicocokkan selektor tidak dapat berbeda.

Pesannya dimulai dengan:

the entity’s category label does not match the category directory the entity is filed under (label kategori entitas tidak cocok dengan direktori kategori tempat entitas disimpan)

Cara memperbaiki: ubah mana pun dari keduanya yang salah agar sesuai — pindahkan berkas ke direktori yang disebut labelnya, atau perbaiki label ke kategori yang disebut direktorinya. Himpunan tertutup kategori, beserta opsi pengecualiannya, ada di bawah “The discipline rules” dalam aggrega-lint.md.

A schema extension is written directly into schema content (Ekstensi skema ditulis langsung ke dalam konten skema)

Penolakan saat memeriksa entitas terhadap konvensi publikasi, bukan saat build. Sebuah Component atau Feature menulis ekstensi skema Aggrega langsung ke dalam konten skemanya, padahal entitas memiliki permukaan kelas satu untuk mendeklarasikan hal yang sama. Bentuk yang ditulis langsung tetap berfungsi, dan konvensi lebih memilih permukaan yang dideklarasikan karena itulah yang diajarkan halaman entitas dan yang dibaca perkakas.

Inilah satu-satunya aturan dalam kelompok ini yang juga dilaporkan oleh build, sebagai saran yang tidak menghentikan build. Pemeriksaan entitas terhadap konvensi publikasi di gerbang publikasi meningkatkan temuan yang sama menjadi penolakan.

Pesannya dimulai dengan:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (entitas menulis ekstensi skema Aggrega langsung ke dalam konten skema alih-alih mendeklarasikannya di bawah kunci yang disediakan)

Cara memperbaiki: pindahkan ekstensi ke permukaan soket atau lampiran milik entitas itu sendiri, tempat halaman entitas untuk component.md dan feature.md mendeklarasikannya. Opsi pengecualiannya ada di bawah “The discipline rules” dalam aggrega-lint.md.

A Plugin pins neither runtime cap, so the platform’s own apply (Sebuah Plugin tidak menetapkan batas runtime apa pun, sehingga batas bawaan platform yang berlaku)

Saran yang muncul saat entitas diperiksa terhadap konvensi publikasi, baik saat Anda menulis maupun di gerbang publikasi; saran ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Sebuah Plugin mendeklarasikan batas memori dan batas waktu yang diterapkan host saat memuat dan menjalankan plugin. Plugin yang tidak mendeklarasikan keduanya berjalan dengan nilai bawaan platform, yang merupakan hasil yang didukung, bukan kesalahan — jadi yang dilaporkan di sini adalah bahwa nilai bawaan sedang berlaku dan bahwa menetapkannya secara eksplisit dimungkinkan.

Pesannya dimulai dengan:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (entitas Plugin tidak mendeklarasikan batas sumber daya runtime sendiri, sehingga nilai bawaan platform yang berlaku)

Cara memperbaiki: tetapkan batas yang benar-benar diperlukan plugin, atau biarkan nilai bawaan tetap berlaku dengan sengaja. Aturan ini tidak memiliki pengaturan pengecualian, karena yang dilaporkannya adalah fakta tentang entitas, bukan penilaian atasnya: tidak ada yang perlu dilonggarkan. Field-nya dijelaskan di plugin.md.

An attachment slot admits only secret material without saying it handles it (Slot lampiran hanya menerima materi rahasia tanpa menyatakan bahwa ia menanganinya)

Saran yang muncul saat entitas diperiksa terhadap konvensi publikasi, baik saat Anda menulis maupun di gerbang publikasi; saran ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Sebuah slot lampiran dapat menetapkan, melalui selektornya, bahwa hanya Feature yang membawa rahasia yang boleh mengisinya, dan secara terpisah dapat mencatat bahwa apa pun yang mengisinya menangani materi rahasia. Selektor menyatakan isian mana yang dapat diterima; catatan menyatakan penanganannya. Slot yang menetapkan yang pertama dan menghilangkan yang kedua membuat penanganan harus disimpulkan dari selektor alih-alih dibaca dari slot. Setiap slot yang dideklarasikan entitas diperiksa: slot dari blok lampirannya sendiri, dan, pada Component, slot yang dideklarasikan soket dependensi untuk setiap koneksi yang dihubungkan melaluinya — temuan tentang slot sebuah soket menyebut soket tersebut di samping slotnya.

Pesannya dimulai dengan:

an attachment slot admits only secret material and does not declare that it handles it (slot lampiran hanya menerima materi rahasia dan tidak mendeklarasikan bahwa ia menanganinya)

Cara memperbaiki: deklarasikan penanganan pada slot di samping selektor yang menetapkannya. Aturan ini tidak memiliki pengaturan pengecualian, dengan alasan yang sama seperti aturan batas Plugin: ia melaporkan fakta tentang entitas dan menyerahkan keputusan kepada Anda.

A Recipe publishes a provides key its Component does not declare, checked at publication (Sebuah Recipe memublikasikan kunci yang tidak dideklarasikan Component-nya, diperiksa saat publikasi)

Saran yang muncul saat entitas diperiksa terhadap konvensi publikasi, baik saat Anda menulis maupun di gerbang publikasi; saran ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Sebuah Recipe memublikasikan kunci di bawah provides:, dan Component yang diimplementasikan Recipe tersebut tidak mendeklarasikan kunci itu dalam pilar provides skemanya. Konsumen yang menghubungkan melalui koneksi membaca kontrak yang dideklarasikan Component, bukan apa pun yang dikeluarkan Recipe, sehingga kunci tersebut dihasilkan lalu ditolak di tempat sesuatu mencoba mengonsumsinya.

🔴 Dua kondisi menggambarkan hal ini, dan keduanya tidak sama. Saran yang dilaporkan build didokumentasikan di atas dengan judul “A Recipe publishes a provides key its Component does not declare (Sebuah Recipe memublikasikan kunci yang tidak dideklarasikan Component-nya)”; kondisi ini dimunculkan saat entitas diperiksa terhadap konvensi publikasi, dan memiliki kodenya sendiri. Temuannya adalah fakta yang sama yang dijumpai di dua permukaan — baca kode dalam diagnostik untuk mengetahui mana yang Anda hadapi.

Pesannya dimulai dengan:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (Recipe memublikasikan kunci provides yang tidak dideklarasikan Component yang diimplementasikannya, sehingga konsumen yang menghubungkan kunci itu ditolak)

Cara memperbaiki: deklarasikan kunci pada Component, sehingga kontrak yang dibaca konsumen mencakup apa yang dikeluarkan Recipe — atau berhenti memublikasikannya dari Recipe jika memang tidak ada yang dimaksudkan untuk mengonsumsinya. Opsi pengecualiannya ada di bawah “The discipline rules” dalam aggrega-lint.md.

Anotasi metrik sebuah Component dan kunci provides-nya tidak sesuai

Sebuah peringatan yang muncul saat sebuah entitas diperiksa terhadap konvensi publikasi, baik saat Anda menyusun maupun di gerbang publikasi; peringatan ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Sebuah Component dapat menyatakan cara metrik produknya melakukan autentikasi, dalam anotasinya observability.aggrega.ai/metrics-credential — none, target-key atau separate-token — dan dapat mendeklarasikan kunci provides metrics_credential_required, yang dipublikasikan oleh setiap Recipes-nya untuk menyatakan apakah metrik satu instans memerlukan kredensial. Keduanya adalah satu fakta tentang produk yang dilihat dari dua sisi, sehingga Component yang menyatakan bahwa metriknya tidak memerlukan kredensial tidak mendeklarasikan kunci tersebut, dan Component yang menyatakan bahwa metriknya memerlukan kredensial mendeklarasikannya. Kondisi ini melaporkan Component yang keduanya tidak sesuai, dengan menyebutkan Component, nilai anotasi, dan kunci yang berlebih atau hilang.

Pesannya dimulai dengan:

a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential (anotasi sebuah Component yang menyatakan cara metriknya melakukan autentikasi tidak sesuai dengan apakah Component tersebut mendeklarasikan kunci provides yang menyatakan bahwa metrik sebuah instans memerlukan kredensial)

Cara memperbaiki: perbaiki mana pun dari keduanya yang salah — deklarasikan metrics_credential_required dalam pilar provides, dan publikasikan dari setiap Recipe, jika metrik memerlukan kredensial; hapus jika tidak memerlukannya; atau ubah anotasi ke nilai yang menggambarkan produk. Aturan ini tidak memiliki pengaturan opt-out, dengan alasan yang sama seperti aturan batas Plugin; nilai mana yang dibacanya, dan Components mana yang tidak dibacanya, dijelaskan di bawah “The discipline rules” dalam aggrega-lint.md.

Sebuah koneksi dan target yang dicapainya tidak menyebut satu kunci yang sama

Sebuah peringatan yang muncul saat sebuah Release diperiksa terhadap konvensi publikasi; peringatan ini tidak pernah menghentikan apa pun, dan build tidak memunculkannya. Server yang memeriksa kunci menyimpan kunci yang diverifikasinya dalam slot miliknya sendiri, dan pemanggil menyajikan kunci pada koneksi yang digunakannya untuk mencapai server tersebut. Tidak ada ujung yang melihat kunci ujung lainnya, sehingga keduanya merupakan satu kunci hanya karena penulisnya menulis locator yang sama di kedua ujung. Kondisi ini melaporkan koneksi yang targetnya mendeklarasikan slot untuk kunci yang diwajibkannya dari pemanggilnya, tetapi keduanya tidak sesuai: koneksi membawa kredensial dan slot kunci target tidak terisi, slot kunci target terisi dan koneksi tidak membawa kredensial, atau keduanya terisi dan keduanya menulis locator secara berbeda.

Tidak seperti aturan di atasnya, aturan ini membaca seluruh Release, bukan satu entitas, sehingga aturan ini hanya dijumpai saat sebuah Release diperiksa dan tidak pernah di gerbang publikasi, yang memeriksa satu entitas secara tersendiri; di mana pun dilaporkan, aturan ini bersifat saran. Temuan ini menyebutkan komponen, koneksi, target, dan kedua slot, dan tidak pernah mengutip locator mana pun. Sebuah scrape — koneksi pada socket scrape_target — dinilai berdasarkan apa yang dinyatakan targetnya tentang metriknya: tidak dinilai sama sekali jika anotasi observability.aggrega.ai/metrics-credential target menyatakan none, tidak pernah terhadap kunci target jika menyatakan separate-token, dan seperti koneksi lain dalam hal lainnya; koneksi pada socket lain dinilai apa pun yang dinyatakan target.

Pesannya dimulai dengan:

a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one (sebuah koneksi dan target yang dicapainya tidak menyebut satu kunci yang sama: keduanya menulis locator yang berbeda untuknya, atau hanya salah satunya yang menyebut kunci)

Cara memperbaiki: buat kedua ujung membaca satu parameter — credential milik koneksi dan api_key milik target — sehingga kunci yang disajikan pemanggil dan kunci yang diverifikasi server tidak dapat ditulis secara berbeda; atau, jika sebuah koneksi dimaksudkan untuk tidak menyajikan kunci, hapus kredensial darinya. Slot mana yang dibaca, apa yang dibandingkan, dan opt-out-nya dijelaskan di bawah “The discipline rules” dalam aggrega-lint.md.

Perubahan yang dipublikasikan melanggar apa yang diizinkan rubrik evolusi

Sebuah penolakan pada pemeriksaan yang mendahului publikasi, bukan pada build. Versi yang dipublikasikan dibandingkan dengan versi yang telah dipublikasikan sebelumnya, dan perbedaan di antara keduanya diklasifikasikan berdasarkan rubrik yang terdokumentasi. Kondisi ini melaporkan bahwa perbedaan tersebut adalah perbedaan yang ditolak oleh rubrik.

Aturan ini memerlukan pendahulu yang telah dipublikasikan sebagai pembanding, sehingga aturan ini dan pemeriksaan kenaikan versi di bawah adalah dua aturan dalam kelompok ini yang tidak dapat dijalankan hanya atas konten lokal: tanpa registry yang dirujuk, tidak ada yang dapat dibandingkan, dan pemeriksaan dilewati, bukan dinyatakan lulus.

Pesannya dimulai dengan:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (versi yang dipublikasikan mengubah pendahulu yang telah dipublikasikan dengan cara yang ditolak oleh rubrik evolusi yang terdokumentasi)

Cara memperbaiki: baca klasifikasi dalam diagnostik, yang menyebutkan aspek perubahan yang ditolak rubrik, lalu jadikan perubahan tersebut kompatibel atau publikasikan di bawah versi yang mengizinkannya. Rubrik ini dijabarkan di bawah “The version-bump rubric” dalam aggrega-lint.md.

Versi yang ditawarkan merupakan kenaikan yang lebih kecil daripada yang diperlukan perubahan

Sebuah penolakan pada pemeriksaan yang mendahului publikasi, bukan pada build. Perubahan yang dipublikasikan diklasifikasikan berdasarkan rubrik evolusi, dan versi yang ditawarkan untuknya merupakan langkah yang lebih kecil daripada yang diminta klasifikasi tersebut — misalnya penghapusan atau penyempitan yang ditawarkan sebagai patch. Kenaikan berlebih selalu diterima; kenaikan yang kurang-lah yang dihentikan di sini.

Tidak seperti aturan di atasnya, aturan ini diputuskan di sini, bukan oleh plugin konvensi. Kenaikan mana yang ditawarkan hanya diketahui pada saat publikasi, dan tidak ada kompilasi yang berjalan saat itu, sehingga perbandingan antara klasifikasi dan versi yang ditawarkan dilakukan pada saat itu.

Pesannya dimulai dengan:

the version bump being published is smaller than the evolution check’s classification of the change requires (kenaikan versi yang dipublikasikan lebih kecil daripada yang diperlukan oleh klasifikasi perubahan dari pemeriksaan evolusi)

Cara memperbaiki: publikasikan di bawah versi yang diminta klasifikasi; diagnostik menyebutkan versi mana itu. Jika Anda yakin perubahan tersebut lebih kecil daripada klasifikasinya, rubrik di bawah “The version-bump rubric” dalam aggrega-lint.md menjelaskan apa yang menempatkan sebuah perubahan dalam setiap kelas. Publikasi pertama sebuah entitas tidak memiliki pendahulu, sehingga perbandingan dilewati dan dilaporkan sebagai tidak dilakukan, bukan dinyatakan lulus.

Sebuah impor berhenti di tengah penerjemahan sumber

Sebuah penolakan saat mengubah deskripsi sumber asing menjadi berkas penyusunan draf, bukan pada build. Importer melaporkan diagnostik yang cukup serius untuk menghentikan penerjemahan, sehingga hasilnya bersifat parsial: sebagian sumber menjadi berkas penyusunan draf dan sebagian lainnya tidak.

Hasil parsial ini disengaja, bukan puing kegagalan. Kondisi ini menyebutkan hasilnya, bukan penyebabnya — apa yang tidak dapat diterjemahkan dilaporkan dalam diagnostik di sampingnya, satu per konstruksi yang tidak dapat dibawa importer, dengan kata-kata importer sendiri. Kondisi inilah yang memungkinkan pemanggil membedakan “impor berhenti dan menghasilkan sebagian jawaban” dari “impor gagal sepenuhnya”, yang merupakan situasi berbeda dengan langkah selanjutnya yang berbeda.

Pesannya dimulai dengan:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (importer melaporkan diagnostik yang menghentikan impor, sehingga sumber tidak sepenuhnya diubah menjadi berkas penyusunan draf)

Cara memperbaiki: baca diagnostik yang dilaporkan di sampingnya — masing-masing menyebutkan konstruksi dalam sumber yang tidak dapat diterjemahkan importer. Perbaikannya ada pada sumber yang Anda serahkan, atau dengan menyelesaikan draf secara manual: impor menghasilkan titik awal untuk disunting, sehingga konstruksi yang tidak bertahan dalam penerjemahan perlu disusun langsung di sisi Aggrega. aggrega-import.md menjelaskan apa yang dihasilkan perintah tersebut dan di mana ia menulis.

More than one importer recognises the source (Lebih dari satu importer mengenali sumber)

Penolakan saat mengubah deskripsi sumber asing menjadi berkas penulisan draf, bukan pada build. Impor tidak menyebutkan format, sehingga format dikenali dari tanda tangan yang dideklarasikan importer — baik yang ada di katalog workspace maupun importer inti milik compiler, yang masing-masing menyebutkan sintaks yang digunakan untuk membaca sumber, nama berkas yang berlaku baginya, dan path yang wajib atau tidak boleh dimuat oleh pohon hasil parse-nya — dan tanda tangan dari importer yang melayani lebih dari satu format cocok dengan sumber tersebut. Impor tidak memilih di antara keduanya: format suatu sumber adalah pernyataan importer, bukan pernyataan compiler, dan memilih berarti menebak, yang menyerahkan sumber kepada importer yang mungkin bukan peruntukannya.

Ini tidak sama dengan satu format yang diiklankan oleh lebih dari satu importer, yang dijelaskan di bawah “A parse or import format is advertised by more than one plugin (Format parse atau impor diiklankan oleh lebih dari satu plugin)” di atas. Di sana formatnya sudah pasti dan importer yang melayaninya bersaing, sehingga entri plugins.importer memilih di antara mereka; di sini formatnya sendiri yang berbeda, sehingga tidak ada lampiran yang dapat menyelesaikannya, dan menyebutkan format yang menyelesaikannya. Importer yang mengenali suatu sumber mengenalinya sebagai setiap format yang diiklankannya, sehingga importer yang mengiklankan lebih dari satu format, yang salah satu tanda tangannya cocok, juga ditolak di sini.

Pesannya dimulai dengan:

more than one importer recognises the source (lebih dari satu importer mengenali sumber)

Sisa pesan menyebutkan sumber dan setiap format yang dikenali untuknya, sesuai urutan identitas dan versi importer, lalu solusinya:

more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (lebih dari satu importer mengenali sumber (sumber, dikenali sebagai …). Berikan —format untuk menyebutkan format yang digunakan untuk membacanya (misalnya —format atau —format))

Cara memperbaiki: sebutkan formatnya — --format pada aggrega import, atau format pada alat impor asisten dan metode aggrega/import sesi. Jika salah satu importer seharusnya tidak pernah mengenali sumber seperti itu, perubahan dilakukan pada tanda tangan importer tersebut, yang dideklarasikan penulisnya dalam laporan diri describe() dan dicatat oleh entitas Plugin-nya saat dibuat; atau, jika importer itu ada di katalog workspace, keluarkan dari katalog yang dibaca workspace — importer inti selalu termasuk yang dicoba, sehingga sumber yang dikenali oleh salah satunya bersama importer lain diselesaikan dengan menyebutkan format. aggrega-import.md menjelaskan cara suatu format dikenali.

No importer recognises the source (Tidak ada importer yang mengenali sumber)

Penolakan saat mengubah deskripsi sumber asing menjadi berkas penulisan draf, bukan pada build. Impor tidak menyebutkan format, sehingga format dikenali dari tanda tangan yang dideklarasikan importer — baik yang ada di katalog workspace maupun importer inti milik compiler — dan tidak ada tanda tangan format mana pun yang cocok dengan sumber. Impor tidak menebak: menyerahkan sumber kepada importer yang tidak pernah mendeklarasikan bahwa ia membaca bentuk itu berarti membuat draf dari sumber yang mungkin bukan peruntukannya.

Ini adalah pasangan dari “More than one importer recognises the source (Lebih dari satu importer mengenali sumber)” di atas. Di sana beberapa format mengklaim sumber; di sini tidak ada. Pada keduanya, menyebutkan format menyelesaikannya, dan tidak ada yang ditulis sampai format disebutkan.

Pesannya dimulai dengan:

no importer recognises the source (tidak ada importer yang mengenali sumber)

Sisa pesan menyebutkan sumber, lalu solusinya dan setiap format yang diiklankan importer katalog, sesuai urutan pembacaannya:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (tidak ada importer yang mengenali sumber (sumber). Berikan —format untuk menyebutkannya secara eksplisit (misalnya —format atau —format))

Jika tidak ada importer yang mengiklankan format sama sekali, solusinya menyatakan hal itu sebagai pengganti contoh.

Direktori ditawari solusi yang berbeda, karena menyebutkan sembarang format tidak dapat membantunya. Direktori hanya dibaca melalui pola file yang dideklarasikan oleh importer-nya, dan tanda tangan yang tidak mendeklarasikan pola file apa pun tidak berlaku untuk satu pun file dalam direktori — sehingga direktori yang berisi, misalnya, satu ekspor Langflow tidak dikenali oleh tanda tangan mana pun, dan menyebutkan format langflow pada gilirannya akan ditolak berdasarkan An importer that declares no file patterns is handed a directory (Importer yang tidak mendeklarasikan pola file menerima sebuah direktori). Karena itu, penolakan untuk direktori menyebutnya sebagai direktori dan menawarkan untuk mengimpor salah satu file-nya secara tersendiri, atau menyebutkan format yang importer-nya mendeklarasikan pola file — hanya format-format tersebut, yang dibaca dari deklarasi para importer sendiri:

no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (tidak ada importer yang mengenali sumber (direktori). Impor salah satu file direktori secara tersendiri, atau berikan —format yang menyebutkan format yang importer-nya membaca direktori melalui pola file yang dideklarasikannya (misalnya —format atau —format))

Jika tidak ada importer yang mendeklarasikan pola file, penolakan tersebut menawarkan untuk mengimpor salah satu file direktori secara tersendiri dan menyatakan bahwa tidak ada importer dalam katalog yang mendeklarasikan pola file yang digunakan untuk membaca direktori.

Cara memperbaiki: sebutkan formatnya — --format pada aggrega import, atau format pada alat impor asisten dan metode aggrega/import sesi, yang masing-masing merumuskan penolakan sesuai bidang yang diterimanya dan membukanya dengan kode pendek kondisi ini; jawaban sesi juga memuat kedua kode kondisi tersebut dalam datanya. Untuk direktori, impor satu file yang Anda maksud secara tersendiri — tanda tangan yang tidak menyebutkan file apa pun berlaku untuk file yang diimpor secara tersendiri, apa pun namanya — atau sebutkan salah satu format yang dicantumkan penolakan. Jika sumber seharusnya dikenali, perubahan dilakukan pada tanda tangan importer yang melayani formatnya, yang dideklarasikan penulisnya dalam laporan diri describe() dan dicatat oleh entitas Plugin-nya saat dibuat. aggrega-import.md menjelaskan cara suatu format dikenali.

An importer that declares no file patterns is handed a directory (Importer yang tidak mendeklarasikan pola berkas diberi direktori)

Penolakan saat mengubah deskripsi sumber asing menjadi berkas penulisan draf, bukan pada build. Sumber yang disebutkan adalah direktori, dan direktori diserahkan kepada importer-nya tepat sebagai berkas-berkas yang dipilih oleh pola berkas yang dideklarasikan importer — sehingga berkas mana dari suatu direktori yang dibaca importer adalah pernyataan importer itu sendiri. Importer yang melayani format sumber tidak mendeklarasikan pola berkas: ia membaca satu berkas, dan tidak menyatakan apa pun tentang berkas mana dari suatu direktori yang menjadi miliknya.

Tidak ada yang dibuka. Impor berhenti setelah importer di-resolve dan sebelum berkas apa pun dari direktori dibaca, alih-alih menyerahkan setiap berkas dalam direktori kepada importer.

Pesannya dimulai dengan:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (importer yang melayani format sumber tidak mendeklarasikan pola berkas, sehingga ia membaca satu berkas dan tidak dapat membaca direktori)

Sisa pesan menyebutkan format, importer, dan direktori sebagaimana Anda menyebutkannya, lalu solusinya:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (importer yang melayani format sumber tidak mendeklarasikan pola berkas, sehingga ia membaca satu berkas dan tidak dapat membaca direktori (format, importer, direktori). Impor salah satu berkas direktori secara tersendiri; importer membaca direktori setelah ia mendeklarasikan pola berkas yang menamai berkas-berkasnya)

Cara memperbaiki: impor satu berkas format tersebut secara tersendiri. Agar importer dapat membaca direktori formatnya, penulisnya mendeklarasikan pola yang menamai berkas-berkasnya — files dari tanda tangan pengenalan dalam laporan diri describe(), yang dicatat oleh entitas Plugin-nya saat dibuat. aggrega-import.md menjelaskan apa yang dibaca oleh impor direktori.

No file in the directory matches the importer’s file patterns (Tidak ada berkas dalam direktori yang cocok dengan pola berkas importer)

Penolakan saat mengubah deskripsi sumber asing menjadi berkas penulisan draf, bukan pada build. Sumber yang disebutkan adalah direktori, formatnya sudah pasti, dan importer yang melayaninya mendeklarasikan pola berkas — tetapi tidak ada berkas dalam direktori, di kedalaman mana pun, yang cocok dengan salah satunya. Menyerahkan importer tanpa sumber sama sekali akan membuatnya gagal pada sumber kosong, dengan kata-kata tentang konten alih-alih tentang berkas mana yang dibaca, sehingga impor berhenti di sini tanpa ada yang dibaca.

Jika format dikenali alih-alih disebutkan, importer yang tanda tangannya mengenali direktori telah mencocokkan salah satu berkasnya, sehingga kondisi ini hanya terjadi jika importer yang berjalan bukan importer tersebut — importer lain dengan format yang sama yang dipilih oleh entri plugins.importer, atau versi lain darinya.

Pesannya dimulai dengan:

no file in the directory matches the file patterns the importer serving the source’s format declares (tidak ada berkas dalam direktori yang cocok dengan pola berkas yang dideklarasikan importer yang melayani format sumber)

Sisa pesan menyebutkan format, importer, direktori sebagaimana Anda menyebutkannya, dan setiap pola yang dideklarasikan importer, lalu solusinya:

no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (tidak ada berkas dalam direktori yang cocok dengan pola berkas yang dideklarasikan importer yang melayani format sumber (format, importer, direktori, pola berkas). Sebutkan direktori yang memuat berkas yang cocok dengan salah satu pola tersebut, atau format importer yang polanya cocok dengan berkas dalam direktori ini)

Cara memperbaiki: impor direktori yang memuat berkas-berkas format tersebut — pola dicocokkan dengan bagian akhir path berkas di dalam direktori, sehingga berkas di kedalaman mana pun dihitung — atau sebutkan format berkas-berkas dalam direktori itu. aggrega-import.md menjelaskan apa yang dibaca oleh impor direktori.

A file read from the directory and a file named in the importer’s with.sources have the same name (Sebuah file yang dibaca dari direktori dan sebuah file yang disebutkan dalam with.sources milik importer memiliki nama yang sama)

Sebuah penolakan saat mengubah deskripsi sumber asing menjadi draf file authoring, bukan saat build. Sumber yang disebutkan adalah sebuah direktori, dan file-filenya sampai ke importer sebagai sumber bernama, masing-masing dengan path-nya di dalam direktori. Entri plugins.importer yang memasang importer tersebut menyebutkan file-filenya sendiri di bawah with.sources, yang juga sampai ke importer sebagai sumber bernama, masing-masing dengan nama dasarnya — dan satu nama dimiliki oleh keduanya. Nama adalah cara importer membedakan satu sumber dari sumber lain, sehingga menyerahkan keduanya akan membuat salah satunya membayangi yang lain tanpa ada yang menunjukkan yang mana; karena itu impor dihentikan, tanpa ada yang diserahkan.

Pesannya dimulai dengan:

a file read from the directory and a file named in the importer’s with.sources have the same name (sebuah file yang dibaca dari direktori dan sebuah file yang disebutkan dalam with.sources milik importer memiliki nama yang sama)

Sisa pesan menyebutkan nama tersebut dan file with.sources, lalu perbaikannya:

a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources (sebuah file yang dibaca dari direktori dan sebuah file yang disebutkan dalam with.sources milik importer memiliki nama yang sama (nama, file with.sources). Setiap sumber sampai ke importer dengan satu nama, jadi ganti nama salah satu dari kedua file, atau keluarkan file tersebut dari with.sources milik importer)

Cara memperbaiki: ganti nama salah satu dari kedua file, atau keluarkan file tersebut dari with.sources milik entri jika direktori sudah memuatnya. Sebuah file with.sources mempertahankan nama dasarnya, sehingga file bernama sama di tingkat teratas direktori adalah file yang bertabrakan dengannya; file di direktori di bawahnya memuat direktori itu dalam namanya. Importer mana yang mengubah sumber menjadi draf menjelaskan with.sources milik sebuah entri.

An import’s target names a capability no Recipe in the catalog binds to (Target sebuah impor menyebutkan kapabilitas yang tidak diikat oleh Recipe mana pun dalam katalog)

Sebuah penolakan saat mengubah deskripsi sumber asing menjadi draf file authoring, bukan saat build. Impor diberi target — --target pada aggrega import, atau target pada alat impor asisten dan metode aggrega/import milik sesi — agar impor membuat draf Manifest yang memetakan setiap tipe komponen yang didraf ke sebuah Recipe dari provider tersebut. Target adalah kapabilitas provider, yang dicocokkan dengan spec.capability yang diikat oleh setiap Recipe dalam katalog workspace, dan tidak ada Recipe di sana yang mengikat kapabilitas yang diberikan. Manifest yang didraf untuknya tidak akan memetakan apa pun, dan setiap tipe komponen kemudian akan terbaca sebagai tidak ada dalam katalog, padahal yang salah adalah opsinya sendiri — paling sering salah ketik.

Tidak ada yang dijalankan dan tidak ada yang ditulis. Impor berhenti setelah katalog dimuat, sebelum format sumber dikenali dan sebelum importer berjalan, sehingga tidak ada draf yang dihasilkan dan tidak ada file yang ditulis, termasuk pada dry run.

Pesannya dimulai dengan:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (tidak ada Recipe dalam katalog workspace yang mengikat kapabilitas yang disebutkan oleh target impor)

Sisa pesan menyebutkan target persis seperti yang diberikan dan kapabilitas yang memang diikat oleh Recipes dalam katalog, masing-masing sekali dan dalam urutan terurut, lalu perbaikannya:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written (tidak ada Recipe dalam katalog workspace yang mengikat kapabilitas yang disebutkan oleh target impor (target, Recipes dalam katalog mengikat). Sebutkan salah satu kapabilitas tersebut sebagai target, atau hilangkan target sehingga tidak ada Manifest yang didraf; tidak ada yang didraf atau ditulis)

Jika katalog sama sekali tidak memuat Recipe, pesan menyatakannya sebagai pengganti daftar, dan perbaikannya adalah menambahkan sebuah Recipe dari provider tersebut ke katalog.

Cara memperbaiki: sebutkan salah satu kapabilitas yang dicantumkan pesan — misalnya compose atau helm, sebagaimana ditulis oleh spec.capability sebuah Recipe — atau hilangkan target, yang berarti tidak ada Manifest yang didraf. Jika provider yang Anda maksud belum memiliki Recipe dalam katalog, tambahkan Recipes-nya terlebih dahulu ke folder katalog yang dibaca workspace. aggrega-import.md menjelaskan apa yang didraf oleh impor yang diberi target.

Release turunan mewarisi direktori boundary yang ter-resolve ke tempat induknya menulis

Sebuah peringatan. Sebuah Release memperluas Release lain dan mewarisi direktori output sebuah boundary darinya, dan direktori itu tidak memuat variabel template — sehingga ter-resolve ke path yang sama untuk keduanya, dan build turunan menulis ke tempat build induk menulis.

Mewarisi direktori adalah bentuk yang didukung, bukan kesalahan. Direktori adalah template, sehingga induk menulisnya sekali dan turunan yang memenuhi sebuah parameter me-resolve-nya ke tempat lain tanpa ada yang diduplikasi; itulah alasan utama turunan tidak perlu menyatakan ulang topologi boundary induknya. Yang sempit dan nyata adalah kasus sisa yang disebutkan di sini: tanpa variabel di dalamnya, tidak ada yang tersisa untuk di-resolve secara berbeda.

Kondisi ini tidak dapat menghentikan build, dan itu adalah sifat aturannya, bukan kehati-hatian terhadapnya. Menulis ke path ter-resolve yang sama adalah sesuatu yang dapat dimaksudkan secara sah oleh seorang author — turunan yang hanya menukar Recipes perenderan untuk membandingkan output-nya, atau yang hanya mengubah ukuran — sehingga aturan yang menghentikan build berdasarkan inferensi akan menolak input yang sah atas dasar tebakan.

Pesannya dimulai dengan:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to (direktori boundary yang diwarisi tidak memuat variabel template, sehingga ter-resolve ke path tempat Release yang diperluas menulis)

Cara memperbaiki: jika keduanya dimaksudkan untuk menulis ke tempat berbeda, masukkan referensi parameter ke dalam direktori dan biarkan setiap Release memenuhinya. Jika menulis ke satu path memang yang Anda maksud, tidak ada yang perlu diubah — peringatan ini telah memberi tahu Anda apa yang akan terjadi, dan build tetap menghasilkan output-nya.

Menemukan penghentian dari kode pendek yang dicetak build

Bagian kepala dalam kurung siku pada diagnostik yang menghentikan build menyebutkan kategori penyebab kegagalan dan, jika kegagalan tersebut menyebutkan salah satu kondisi yang dikatalogkan di sini, kode pendek kondisi itu — huruf E dan empat digit, seperti pada [CATALOG_ERROR E0209]. Sebuah nomor diberikan sekali lalu tetap, sehingga kode pendek yang Anda tempelkan ke laporan atau pencarian tetap menyebutkan kondisi yang sama seperti saat Anda mencatatnya. Dua pengidentifikasi lain yang dimiliki suatu kondisi, serta kapan masing-masing dari ketiganya digunakan, dijelaskan di sentinels.md.

Baris pesan kondisi itu sendiri diawali dengan kalimat tetap yang menyatakan kondisi tersebut. Semua yang muncul setelah kalimat itu berbeda pada setiap kejadian — dokumen yang bermasalah, kunci yang ditulis, nilai yang salah, dan saran untuk kejadian tersebut — dan entri-entri di atas mengutip bentuk lengkapnya untuk kondisi yang didokumentasikan masing-masing. Kalimat tetap adalah bagian yang selalu sama, sehingga bagian itulah yang dicocokkan.

Tabel di bawah memasangkan keduanya, terbatas pada halaman ini: untuk setiap kondisi yang dikatalogkan di sini, kode pendek yang dicetak build dan kalimat pembuka baris pesannya, dipasangkan dengan entri di atas yang menjelaskan perbaikan penulisannya. Judul entri dikutip persis, sehingga mencari salah satunya di halaman ini akan membawa Anda ke entrinya. Tabel semua kondisi menerjemahkan kode pendek untuk setiap kondisi yang dideklarasikan compiler, termasuk kondisi yang tidak dicakup entri mana pun di sini.

Jika satu entri muncul untuk dua kode pendek, entri tersebut mencakup dua kondisi berbeda dan masing-masing mendaftarkan kalimatnya sendiri; bacalah kalimatnya, bukan judul yang sama, untuk mengetahui kondisi mana yang dilaporkan build.

aggrega explain <code> melakukan pencarian ini untuk Anda di terminal, menerima salah satu kode kondisi dan mencetak kondisi tersebut beserta entri di atas yang mendokumentasikannya. Perintah ini dijelaskan di aggrega explain.

Kode pendekDiawali denganDidokumentasikan di
E0001cliplugin: no plugin resolver configuredRunner plugin baris perintah dibangun tanpa cara untuk menemukan plugin
E0003malformed attachment requirementMalformed attachment requirement (Persyaratan pemasangan tidak valid)
E0004annotation contribution overridden by an explicit valueNilai eksplisit menggeser nilai yang diberikan anotasi
E0005policy violationA governance plugin rejected the build (Plugin tata kelola menolak build)
E0006required attachment slot unfilledSlot lampiran wajib tidak terikat
E0007selector violationCross-node type safety violation via selector: (Pelanggaran keamanan tipe lintas node)
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (Feature yang mengisi slot lampiran tidak memenuhi selector slot tersebut)
E0009pipeline step typed-I/O contract violationA pipeline step’s typed input or output does not satisfy its declared contract (Masukan atau keluaran bertipe sebuah langkah pipeline tidak memenuhi kontrak yang dideklarasikannya)
E0010pipeline step failedA pipeline step failed (Sebuah langkah pipeline gagal)
E0011pipeline patch targets a document not present in the setA pipeline patch addresses a document the set does not hold, or one with no tree to address (Patch pipeline menyasar dokumen yang tidak ada dalam himpunan, atau dokumen tanpa pohon untuk disasar)
E0012pipeline patch targets an opaque (non-structured) unitA pipeline patch addresses a document the set does not hold, or one with no tree to address (Patch pipeline menyasar dokumen yang tidak ada dalam himpunan, atau dokumen tanpa pohon untuk disasar)
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release (Ketidakcocokan tipe feature antara Aggregate dan Release)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key (Entri memuat sekaligus literal dan kunci sumber)
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses edge dictates delivery on a socket that allowlists none (Edge menentukan pengiriman pada socket yang tidak mengizinkan satu pun); uses edge dictates a delivery mechanism outside the socket’s allowlist (Edge menentukan mekanisme pengiriman di luar daftar izin socket)
E0016jsonpatch: test operation failedA patch’s test operation did not match the document (Operasi pengujian pada patch tidak cocok dengan dokumen)
E0017annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeysAn annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Plugin annotation-transform menyebut komponen yang tidak diberikan kepadanya, atau menginjeksikan nilai yang tidak diterima anotasi mana pun)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaA governance attachment’s settings do not match the plugin’s declared schema (Pengaturan lampiran tata kelola tidak cocok dengan skema yang dideklarasikan plugin)
E0019endpoint requires form: referenceA workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)
E0020schedule is not a valid cron expressionA workload schedule: is not an expression the check accepts (Schedule workload bukan ekspresi yang diterima pemeriksaan)
E0021persistentTemplate volume requires form: statefulA workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)
E0022pipeline PATCH target is not parseable structured YAML/JSONLangkah pipeline menunjuk dokumen yang tidak dimiliki node
E0023form: reference requires an endpointA workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)
E0024schedule requires form: scheduledA workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)
E0025form: scheduled requires a scheduleA workload: form and the fields beside it do not agree (Bentuk workload dan field di sampingnya tidak sesuai)
E0026imported artifact content does not match the digest recorded for it in entity.lockAn imported artifact no longer matches the digest recorded beside its Recipe (Artefak yang diimpor tidak lagi cocok dengan digest yang dicatat di samping Recipe-nya)
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)$import: pustaka tidak ditulis dalam bentuk nama polos
E0028artifacts output filename collision: two artifact outputs carry the same filenameDua output artefak dari satu Recipe memuat nama file yang sama
E0029artifact template references a pillar the Recipe does not declareTemplate artifacts: membaca pilar yang tidak dideklarasikan oleh Recipe
E0030artifact-library import references a bundle not present in the ArtifactLibrary$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0031artifact-library import references an ArtifactLibrary not present in the catalog$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path (Dua kontributor menulis path keluaran yang sama)
E0033assertion failedAn assertion stopped the build (Sebuah asersi menghentikan build)
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed (Sebuah lampiran mengirimkan kunci yang sudah diklaim oleh sumber inject lain)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (Plugin yang melayani provider tidak dapat merakit apa yang digabungkan oleh provider tersebut)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella (Ketidakcocokan nama chart pada umbrella helm-chart yang digabungkan)
E0037cross-boundary link between endpoints rendered by different providers is not supportedKoneksi melintas di antara output rakitan dua provider yang berbeda
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output (Nama yang sama diturunkan lebih dari sekali di dalam keluaran)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist (Templat FeatureRecipe mereferensikan field di luar allowlist cakupannya)
E0040library $import: carries a registry host; reference the library by bare-name identity$import: pustaka menunjuk pustakanya berdasarkan lokasi registry
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path (Tabrakan ID instance antar-boundary yang dirakit ke path yang sama)
E0042locals entry references a sibling defined later in the same blockEntri locals: mereferensikan entri sejajar yang didefinisikan kemudian dalam blok yang sama
E0043template references a key the locals block does not declareKunci locals: tidak ada
E0044mapping-library import references an entry not present in the MappingLibrary$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)$import: pustaka tidak ditulis dalam bentuk nama polos
E0046mapping-library import references a MappingLibrary not present in the catalog$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder (Output yang dirakit masih memuat placeholder lintas batas)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths (Tabrakan jalur: dua kontributor menghasilkan keluaran di jalur yang tidak kompatibel)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist (Templat jalur mereferensikan variabel di luar daftar yang diizinkan)
E0050pipeline /host operation from a step with no host componentLangkah pipeline menunjuk dokumen yang tidak dimiliki node
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsPatch pipeline menunjuk keluaran yang belum dirakit
E0052pipeline PATCH targets a document the node did not emitLangkah pipeline menunjuk dokumen yang tidak dimiliki node
E0053pipeline plugin is not compatible with the rendering providerPlugin langkah pipeline tidak mengklaim provider yang merender apa yang ditujunya
E0054provider rejected node inputA provider refused a node’s input (Sebuah provider menolak input sebuah node)
E0055Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declaresA Recipe or FeatureRecipe does not publish a provides key its contract declares (Recipe atau FeatureRecipe tidak menerbitkan kunci yang dideklarasikan kontraknya)
E0056provides template evaluation failedA provides: template could not be evaluated (Templat provides tidak dapat dievaluasi)
E0057provides block references a root outside the self-contained setTemplat provides: mereferensikan root yang tidak mandiri
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (Sebuah provider merender input yang sama dua kali dan menghasilkan output yang berbeda)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources (Kunci pengiriman duplikat di antara sumber inject)
E0060template references a root the render context does not defineTemplate references a root the render context does not define (Template mereferensikan root yang tidak didefinisikan konteks render); Self-inject value template references cross-node data (Template nilai self-inject mereferensikan data lintas node)
E0061unknown providerUnknown provider (Penyedia tidak dikenal)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingKomponen mendeklarasikan mekanisme inject yang tidak dipetakan sama sekali oleh Feature terlampir
E0063workload-library import references an entry not present in the WorkloadLibrary$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)$import: pustaka tidak ditulis dalam bentuk nama polos
E0065workload-library import references a WorkloadLibrary not present in the catalog$import: pustaka menamai pustaka atau entri yang tidak dimiliki katalog
E0066uses edge target does not existTarget uses yang menggantung
E0067active toggle did not resolve to a booleanToggle active: tidak terselesaikan menjadi true atau false
E0068max sub-aggregate nesting depth exceededKedalaman penyarangan sub-aggregate terlampaui
E0069mutator patch rejectedA label-transform plugin’s patch reaches outside node labels (Patch dari plugin label-transform menjangkau di luar label node)
E0070re-exported component alias forms a cycleAlias komponen yang dipublikasikan ulang menunjuk kembali ke dirinya sendiri
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge (Release mengubah target edge yang dideklarasikan developer)
E0072sub-aggregate load failedModul yang diimpor komposisi tidak dapat dimuat, atau mengimpor dirinya sendiri
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differDua instans diratakan menjadi satu pengenal
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to (Konfigurasi per-edge Release tidak memiliki edge untuk diterapkan)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised (Sebuah Aggregate mencapai pembangunan graf tanpa dinormalisasi)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`Komponen sebuah sub-modul tidak ditempatkan di boundary mana pun
E0077uses edge target was pruned because its active toggle resolved to falseEdge uses menargetkan komponen yang dihapus oleh toggle active:
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callA plugin asks the host to parse a source while a parse is already running for it (Sebuah plugin meminta host mengurai sebuah sumber saat penguraian untuknya sedang berjalan)
E0079wasm: recorded command mirror does not match plugin describe()Kumpulan perintah yang tercatat pada entitas Plugin tidak sesuai dengan plugin
E0080wasm: entity contract claim does not match plugin describe()Klaim entitas Plugin tidak sesuai dengan laporan diri plugin itu sendiri
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared (Sebuah plugin mengembalikan diagnostik dengan tingkat keparahan yang tidak dideklarasikan)
E0082wasm: guest plugin reported an errorA plugin failed while it was running (Sebuah plugin gagal saat sedang berjalan)
E0083wasm: guest plugin panicked during callA plugin failed while it was running (Sebuah plugin gagal saat sedang berjalan)
E0084wasm: stamped host-function record does not match .wasm importsA Plugin entity’s recorded host functions do not match the binary (Fungsi host yang tercatat pada entitas Plugin tidak cocok dengan biner)
E0085wasm: plugin rejected by the sandboxThe sandbox refused a plugin (Sandbox menolak sebuah plugin)
E0086wasm: plugin invoked proc_exitA plugin failed while it was running (Sebuah plugin gagal saat sedang berjalan)
E0087wasm: declared plugin type does not match plugin describe()A plugin is not the kind of plugin the socket expects (Plugin bukan jenis plugin yang diharapkan socket)
E0088wasm: entity metadata.version does not match plugin describe()Versi yang tercatat pada entitas Plugin tidak sesuai dengan plugin
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn (Setiap versi yang dapat dipilih sebuah referensi telah ditarik)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin (Format parse atau impor diiklankan oleh lebih dari satu plugin)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one plugin (Format parse atau impor diiklankan oleh lebih dari satu plugin)
E0092capability is served by more than one provider plugin; add a plugins.providers entry to select oneA capability is served by more than one provider plugin (Sebuah kapabilitas dilayani oleh lebih dari satu plugin penyedia)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousSebuah Manifest memetakan dua kunci berbeda versi ke satu tipe
E0094duplicate entity identity within a single catalog directoryDua entitas katalog dalam satu direktori berbagi identitas
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts (Nilai pemetaan Manifest bukan bentuk yang diterima referensi recipe)
E0096manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type keyRecipe implements does not match the mapped component type (Recipe implements tidak cocok dengan tipe komponen yang dipetakan)
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format (Tidak ada plugin yang mengiklankan format parse atau impor yang diminta)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format (Tidak ada plugin yang mengiklankan format parse atau impor yang diminta)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its typeNo Recipe is mapped for a component or feature instance (Tidak ada Recipe yang dipetakan untuk instans komponen atau fitur)
E0100plugins.providers entry names a plugin no provider-rendering plugin serving the capability matchesA plugins.providers binding names a plugin that does not serve the capability (Binding plugins.providers menamai plugin yang tidak melayani kapabilitas tersebut)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin (Tidak ada versi plugin provider yang memenuhi pin provider sebuah Recipe)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathReferensi plugin memuat host registry atau path artefak
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint (Tidak ada versi katalog yang memenuhi batasan versi)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationReferensi plugin atau recipe tidak memuat scope
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationReferensi plugin atau recipe tidak memuat scope
E0106resolve: invalid library reference URIA library reference is not written in the identity form (Referensi pustaka tidak ditulis dalam bentuk identitas)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions (Dua konsumen dari satu pustaka memerlukan versi yang tidak kompatibel)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs (Tampilan katalog yang diberikan kepada build tidak dapat memuat isi yang dibutuhkan pinning)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs (Tampilan katalog yang diberikan kepada build tidak dapat memuat isi yang dibutuhkan pinning)
E0110resolve: source-template evaluation failure at lock timeResolving a source: coordinate registers a narrower function set (Resolusi koordinat mendaftarkan himpunan fungsi yang lebih sempit)
E0111resolve: source-template parse errorResolving a source: coordinate registers a narrower function set (Resolusi koordinat mendaftarkan himpunan fungsi yang lebih sempit)
E0112resolve: source-template references .provides (invalid reverse reference)Resolving a source: coordinate registers a narrower function set (Resolusi koordinat mendaftarkan himpunan fungsi yang lebih sempit)
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (Rantai impor modul lebih dalam daripada yang ditelusuri penelusuran pin)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds (Sebuah referensi tidak menamai entitas apa pun yang dimiliki katalog)
E0115compactform: ambiguous dispatch — $mode requiredA compact-form schema declares a field literally named type (Skema bentuk ringkas mendeklarasikan field yang secara harfiah bernama type)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on (Batasan bentuk ringkas tidak berlaku untuk tipe tempat batasan itu ditulis)
E0117compactform: $jsonschema content invalidA $jsonschema: escape carries content that is not a schema (Escape $jsonschema: memuat konten yang bukan skema)
E0118compactform: cross-document $ref carries a registry host; reference the library by identitySebuah $ref: menunjuk library berdasarkan lokasi registry
E0119compactform: $ref unresolvableSebuah $ref: tidak ditulis dalam bentuk yang dapat diresolusi oleh compiler
E0120compactform: unknown keywordA compact-form schema uses a keyword the compact form does not know (Skema bentuk ringkas menggunakan kata kunci yang tidak dikenal oleh bentuk ringkas)
E0121compactform: cross-document $ref target not foundSebuah $ref: tidak ditulis dalam bentuk yang dapat diresolusi oleh compiler
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated (Build menggunakan artefak yang telah dinyatakan usang oleh penerbitnya)
E0123docscache: artifact is not a documentation bundleArtefak yang di-resolve bukan bundel dokumentasi
E0124docscache: page not found in documentation bundleHalaman tidak ada dalam bundel dokumentasi
E0125egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cacheThe workspace is offline and the step needs the network (Workspace sedang luring dan langkah ini memerlukan jaringan)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (Render meminta input eksternal yang tidak di-pin oleh lockfile)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (Byte yang diambil tidak cocok dengan digest yang di-pin)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (URL input eksternal menggunakan skema yang tidak diizinkan)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (Input eksternal yang tersimpan tidak lagi cocok dengan catatannya)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to (Lockfile tidak lagi cocok dengan hasil resolusi rilis)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema (Lockfile tidak memenuhi skemanya)
E0132oci: manifest has multiple layers of the expected content media typeManifest tidak membawa layer dengan jenis yang diharapkan, atau membawa lebih dari satu
E0133oci: cached manifest digest mismatchByte yang diambil atau di-cache tidak cocok dengan digest yang ditetapkan untuknya
E0135oci: content digest mismatchByte yang diambil atau di-cache tidak cocok dengan digest yang ditetapkan untuknya
E0136oci: network unreachableThe registry could not be reached (Registry tidak dapat dijangkau)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it (Artefak tidak berada di sumber tempat build diminta untuk menemukannya)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts (Registry tidak akan menyajikan artefak tanpa kredensial yang diterimanya)
E0139oci: tag already published with different contentTag sudah diterbitkan dengan konten berbeda
E0140oci: manifest has no layer of the expected content media typeManifest tidak membawa layer dengan jenis yang diharapkan, atau membawa lebih dari satu
E0141oci: distinct catalog identities map to the same OCI repository locationDua identitas katalog dipublikasikan ke satu lokasi repositori
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact (Registry tidak dapat menjawab apa yang dilampirkan pada artefak)
E0143oci: unknown entity kind for mediatype dispatchAn entity kind has no artifact media type (Sebuah jenis entitas tidak memiliki media type artifact)
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it (Bundel tanda tangan yang di-cache tidak cocok dengan digest yang tercatat untuknya)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity (Referensi plugin bukan entitas Plugin)
E0146circular reference expansionSebuah referensi library berekspansi ke dirinya sendiri
E0147registrytrust: advertised trust config is malformedRegistry menyajikan dokumen kepercayaan yang tidak dapat dibaca sebagai dokumen tersebut
E0148registrytrust: registry advertises no trust configRegistry tidak memublikasikan dokumen kepercayaan
E0149attachment name is a near miss for a declared slotNama attachment berjarak satu edit dari slot yang dideklarasikan
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape (Attachment tidak sesuai dengan bentuk slot yang dideklarasikannya)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary (Sebuah komponen ditempatkan di lebih dari satu boundary)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice (Direktori Release mendeklarasikan satu Aggregate atau Manifest dua kali)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged (Fitur yang dilampirkan oleh Aggregate sekaligus Release tidak dapat digabungkan)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (Guard memerlukan entitas katalog yang di-resolve oleh build tetapi tidak dapat dilihatnya)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources (Kunci pengiriman duplikat di antara sumber inject)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides (Kunci from pada inject tidak ada dalam provides milik target)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (Referensi tidak dapat diinterpolasi)
E0160manifest annotation bindings collide on same Feature path+pillarDua binding anotasi Manifest bersaing untuk satu slot perutean
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Binding anotasi Manifest mengklaim prefiks yang dicadangkan)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (Fitur wajib tidak terpasang)
E0163required uses socket not populatedSoket uses: wajib tidak terisi
E0164parameter contract violatedParameter type mismatch / contract violation (Ketidakcocokan tipe parameter / pelanggaran kontrak)
E0165required parameter not suppliedParameter type mismatch / contract violation (Ketidakcocokan tipe parameter / pelanggaran kontrak)
E0167Recipe publishes a provides key its Component does not declareRecipe menerbitkan kunci provides yang tidak dideklarasikan Component-nya
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema (Values atau infra yang ditulis tidak sesuai dengan skema yang dideklarasikan)
E0169self-inject on component without spec.inject allowlistSelf-inject pada komponen tanpa daftar izin; Mekanisme self-inject tidak ada dalam daftar izin komponen
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (Referensi Release tidak di-resolve ke apa pun)
E0171unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declareuses: socket not declared in the owning entity’s usesSchema (Socket uses tidak dideklarasikan dalam usesSchema entitas pemiliknya)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)Sebuah Release mencapai resolusi tanpa melewati jalur pemuatan
E0173declared parameter is read by no reference in the AggregateParameter yang dideklarasikan tidak dibaca oleh apa pun
E0174uses socket name is a near miss for a declared socketNama socket uses: berjarak satu edit dari socket yang dideklarasikan
E0175file load failed: the file could not be read, or its bytes did not parseA file cannot be read, or its bytes do not parse (Sebuah file tidak dapat dibaca, atau byte-nya tidak dapat di-parse)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorPenandatanganan tanpa kunci diminta tanpa layanan yang dibutuhkannya
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature (Artefak yang wajib ditandatangani tidak memiliki tanda tangan)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer (Kebijakan kepercayaan tanpa kunci tidak menyebutkan penanda tangan yang dapat diterima)
E0179signing: signature does not verifyTanda tangan terpisah tidak terverifikasi terhadap kunci yang diberikan
E0180signing: signature bundle does not verifyA signature does not verify (Tanda tangan tidak lolos verifikasi)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentPublikasi tanpa tanda tangan menargetkan registry atau kebijakan yang mewajibkan tanda tangan
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read (Akar kepercayaan yang disematkan tidak dapat dibaca)
E0183signing: registry requires signatures; refusing to push unsigned contentPublikasi tanpa tanda tangan menargetkan registry atau kebijakan yang mewajibkan tanda tangan
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts (Kunci verifikasi yang disematkan bukan profil kunci yang diterima verifikator)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts (Tanda tangan lolos verifikasi tetapi penandatangannya tidak dipercaya oleh registry)
E0186no source adapter serves the source kindsource: milik sebuah Recipe menyebut jenis yang tidak diketahui cara memperolehnya oleh apa pun
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it (Artefak sumber di-cache tanpa root workspace sebagai jangkarnya)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}An inline-or-import field is written in neither shape (Bidang inline-atau-impor tidak ditulis dalam salah satu dari kedua bentuknya)
E0189artifactlibrary: entry must be a mapping of filename to a string bodyA library entry’s body is not the shape that library holds (Isi entri library tidak berbentuk sesuai yang dimuat library tersebut)
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit (Skema menggunakan kata kunci JSON Schema yang tidak diterima library)
E0191mappinglibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (Isi entri library tidak berbentuk sesuai yang dimuat library tersebut)
E0192a document nests too many levels deepA document nests deeper than the reader will descend (Dokumen bersarang lebih dalam daripada batas yang akan ditelusuri pembaca)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (Blok parameter sebuah Release tidak ditulis dalam salah satu dari dua bentuknya)
E0194schemalibrary: template not foundA $instantiate: reference cannot be resolved (Referensi tidak dapat di-resolve)
E0195schemalibrary: template parameter missingA $instantiate: reference cannot be resolved (Referensi tidak dapat di-resolve)
E0196schemalibrary: template parameter type mismatchA $instantiate: reference cannot be resolved (Referensi tidak dapat di-resolve)
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Bidang inline-atau-impor tidak ditulis dalam salah satu dari kedua bentuknya)
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderA provider declares a well-known annotation at a scope it does not render (Provider mendeklarasikan anotasi well-known pada cakupan yang tidak di-render-nya)
E0199workloadlibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (Isi entri library tidak berbentuk sesuai yang dimuat library tersebut)
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Bidang inline-atau-impor tidak ditulis dalam salah satu dari kedua bentuknya)
E0201assertion name declared twice across the extends chainNama asersi dideklarasikan dua kali di sepanjang rantai extends:
E0202cyclic extends chainRantai extends siklik; Extends siklik pada Components atau Features
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (valuesMapping pada FeatureRecipe memerlukan source)
E0205inheritance merge failedRantai extends: tidak dapat disusun
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally (Label komponen yang dipromosikan juga dideklarasikan secara literal)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace (Kunci label output menggunakan namespace yang dicadangkan)
E0209Recipe: valuesMapping requires sourcevaluesMapping memerlukan source
E0210Recipe: at least one input kind requiredAt least one input kind must be present (Setidaknya satu jenis input harus ada)
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds (Tabrakan nama file saat emisi lintas jenis input)
E0212workload attachment slot is not referenceableA Workload references a slot whose fill publishes no locator (Workload merujuk slot yang pengisinya tidak memublikasikan lokator)
E0213workload featuresSchema cross-check failedA Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Lampiran Workload menyebut slot yang tidak dideklarasikan entitas, atau pengiriman yang dilarang slot tersebut)
E0214workload validation failedSebuah Workload tidak memenuhi skema Workload
E0215document envelope validation failedAnchor YAML dialiaskan di dalam kontennya sendiri; Release divergen (extends + penunjuk aggregate)
E0216validator/jsonschema: x-aggrega extension evaluation failedPredikat x-aggrega-when: atau x-aggrega-validate: tidak dapat dievaluasi
E0218validator/jsonschema: schema resolution failedSkema yang dideklarasikan tidak dapat di-resolve
E0220extends chain exceeds maximum depthRantai extends: melampaui batas kedalaman
E0221merger: invalid merge inputPenjaga input milik langkah penggabungan skema
E0222registry alias matches more than one hostA registry alias matches more than one host (Alias registry cocok dengan lebih dari satu host)
E0223a cross-cutting socket is bound by capability but attaches by uriA plugin binding sets a key the socket it attaches to does not read (Binding plugin menetapkan kunci yang tidak dibaca oleh socket tempatnya terpasang)
E0224workspace configuration is invalidThe workspace configuration is invalid (Konfigurasi workspace tidak valid)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin (Sebuah kapabilitas di-bind ke lebih dari satu plugin provider)
E0226registry alias is already used by another hostAlias registry sudah terikat ke host lain
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role (Lampiran governance tidak mendeklarasikan peran, atau mendeklarasikan peran yang tidak dikenal)
E0228a provider socket binding sets a field with no referent on that socketA plugin binding sets a key the socket it attaches to does not read (Binding plugin menetapkan kunci yang tidak dibaca oleh socket tempatnya terpasang)
E0229position out of rangePosisi editor berada di luar dokumen
E0246the digest recorded as trusted for this plugin does not match the digest its cached manifest reportsA trusted plugin’s recorded digest disagrees with the cached artifact (Digest tercatat milik plugin tepercaya tidak sesuai dengan artefak di cache)
E0247a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict roleA plugin recorded as a trusted gate is no longer attached (Plugin yang tercatat sebagai gerbang tepercaya tidak lagi terpasang)
E0248wasm: guest plugin returned an output that is not the shape the socket readsA plugin returned something that is not the shape the socket reads (Sebuah plugin mengembalikan sesuatu yang bukan bentuk yang dibaca socket)
E0250provider named a directory for each contributor's own sub-directory that is not a single directory nameA provider named a directory for a contributor that is not one directory (Provider menyebutkan direktori untuk kontributor yang bukan satu direktori)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modesource: pada Recipe berupa string kosong
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underAn ArtifactLibrary bundle file names no file of its own under the key it was imported at (Berkas bundle ArtifactLibrary tidak menamai berkasnya sendiri di bawah kunci tempat ia diimpor)
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature (Binding anotasi tidak dapat di-resolve terhadap Feature targetnya)
E0254annotation subkey does not conform to the target Feature's schema at the routed pillarA bound annotation value does not conform to the target Feature’s schema (Nilai anotasi yang terikat tidak sesuai dengan skema Feature target)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use (Anotasi dirutekan melalui pilar yang tidak boleh digunakan oleh sisi penulisnya)
E0256annotation binding declares one path in both pillar listsBinding anotasi mendeklarasikan satu path di kedua daftar pilar
E0257declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validationA declared schema contract cannot be read as a schema (Kontrak skema yang dideklarasikan tidak dapat dibaca sebagai skema)
E0259attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares itA boundary-scope Feature is attached only to a component (Feature dengan cakupan boundary hanya dilampirkan ke komponen)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`Komponen yang dimiliki komposisi tidak ditempatkan di boundary mana pun
E0261boundary names a component the composition does not hold: correct the name, or remove the entrySebuah boundary menyebut komponen yang tidak dimuat oleh komposisi
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits (Identitas komponen tidak dapat dicapkan pada apa yang dikeluarkannya)
E0263the target will not accept a name derived from this component's authored identity: rename the componentThe target will not accept a name derived from an authored identity (Target tidak akan menerima nama yang diturunkan dari identitas yang ditulis)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed (Penyedia tidak pernah menerima nama yang disusun compiler)
E0265provider does not support the node's input kindworkload: memerlukan provider yang dapat melakukan sintesis
E0266a schema `$import:` could not be appliedSebuah $import: skema tidak dapat diterapkan
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar (Blok skema menyebut kunci yang bukan pilar data)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensPenyusunan ulang sebuah provider diberi unit yang tidak pernah dihasilkan oleh pemotongannya sendiri
E0269provider guest returned two output files under one path; a conforming guest returns each output path at most onceA provider returned two output files under one path (Sebuah provider mengembalikan dua berkas output di bawah satu path)
E0270link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returnedA provider’s link wiring names an output file that was never emitted (Pengkabelan tautan sebuah provider menyebutkan file output yang tidak pernah dikeluarkan)
E0271emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and contentA pipeline step’s file emission carries no file (Emisi file sebuah langkah pipeline tidak membawa file)
E0272side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crdA pipeline step declares an emission kind the contract does not define (Sebuah langkah pipeline mendeklarasikan jenis emisi yang tidak didefinisikan kontrak)
E0273template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider suppliesTemplate membaca nama hasil render yang tidak dilaporkan oleh provider node
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity (Gerbang yang tercatat sebagai tepercaya di-resolve ke identitas yang berbeda)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenSuntingan akan menghasilkan dokumen yang ditolak skemanya
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects toPerubahan yang dipublikasikan melanggar apa yang diizinkan rubrik evolusi
E0277an annotation key on the entity uses a prefix the platform reservesKunci anotasi menggunakan prefiks yang dicadangkan platform
E0278the entity's name does not follow the documented name shape for its kindAn entity’s name does not follow the shape its kind expects (Nama entitas tidak mengikuti bentuk yang diharapkan jenisnya)
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followA schema uses a dynamic reference that cannot be resolved ahead of time (Skema menggunakan referensi dinamis yang tidak dapat diselesaikan lebih awal)
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityA schema declares an identifier the platform owns (Skema mendeklarasikan pengenal yang dimiliki platform)
E0281the entity's category label does not match the category directory the entity is filed underA Component’s category label and its directory name different categories (Label kategori dan direktori sebuah Component menyebut kategori yang berbeda)
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaA schema extension is written directly into schema content (Ekstensi skema ditulis langsung ke dalam konten skema)
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyA Plugin pins neither runtime cap, so the platform’s own apply (Sebuah Plugin tidak menetapkan batas runtime apa pun, sehingga batas bawaan platform yang berlaku)
E0284an attachment slot admits only secret material and does not declare that it handles itAn attachment slot admits only secret material without saying it handles it (Slot lampiran hanya menerima materi rahasia tanpa menyatakan bahwa ia menanganinya)
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedA Recipe publishes a provides key its Component does not declare, checked at publication (Sebuah Recipe memublikasikan kunci yang tidak dideklarasikan Component-nya, diperiksa saat publikasi)
E0286the version bump being published is smaller than the evolution check's classification of the change requiresVersi yang ditawarkan merupakan kenaikan yang lebih kecil daripada yang diperlukan perubahan
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring filesSebuah impor berhenti di tengah penerjemahan sumber
E0288a plugin has no expression for a construct this build declaresSebuah workload mendeklarasikan bentuk yang tidak dapat diekspresikan oleh compose; Sebuah container mendeklarasikan field yang tidak memiliki primitif di compose; Sebuah entri omits menyebut kind atau namespace yang tidak dimiliki file compose; Sebuah entri omits menyebut namespace yang tidak dimiliki template CloudFormation; Sebuah aturan membaca parameter CloudFormation yang terikat berdasarkan namanya; Stack CloudFormation yang telah dirakit tidak dapat membawa transform
E0289a plugin could not resolve something it requires to exactly one valueSebuah health probe tidak dapat diubah menjadi healthcheck compose; Sebuah volume configmap tidak memiliki file di baliknya; Apa yang dihilangkan oleh entri omits masih disebut oleh file compose; Apa yang dihilangkan oleh entri omits masih disebut oleh template CloudFormation; Sebuah kunci valuesMapping tidak menyebut parameter apa pun dari template CloudFormation yang bersumber; Komponen lain mereferensikan parameter CloudFormation yang telah diisi oleh binding template yang bersumber; Dua komponen mengurutkan sepasang transform secara berlawanan; Sebuah referensi lintas batas tidak memiliki stack konsumen untuk dituliskan; Sebuah StatefulSet hasil sintesis tidak memiliki satu service tunggal yang mengaturnya
E0290two things a plugin produced occupy one name in its outputNama export yang ditulis adalah nama yang diturunkan build untuk referensi lintas stack; Output tempat referensi lintas stack dipublikasikan sudah membawa Export; Dua entri mencapai satu nama output stack; Sebuah fragmen CloudFormation menulis satu kunci dua kali; Dua resource yang dirender berakhir di satu file output
E0291a plugin has no representation for a value it was givenSebuah port yang dipublikasikan mendeklarasikan transport yang tidak dapat dituliskan oleh compose; Sebuah kuantitas resources tidak dapat dikonversi menjadi nilai compose; Kuantitas resource yang dihasilkan provider helm bukan sebuah kuantitas; Tipe service yang tidak dapat dirender oleh provider helm; Versi Kubernetes yang tidak dapat dirender chart-nya oleh provider helm; Nilai yang terikat ke parameter CloudFormation tidak dapat mengambil tipe parameter tersebut; Nilai yang terikat ke parameter CloudFormation ditolak oleh batasannya; Secret yang terikat ke parameter CloudFormation akan dituliskan ke dalam template; Referensi dinamis terikat di tempat yang tidak di-resolve oleh CloudFormation; Sebuah referensi lintas batas disisipkan ke dalam string yang lebih panjang
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify (Sebuah plugin melaporkan kegagalan yang tidak diklasifikasikannya)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare (Sebuah plugin menyebut kondisi yang tidak dideklarasikan oleh socket)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identityDua subsistem mendeklarasikan komponen dengan satu nama
E0295library reference: a reference to a library entry carries no whitespace or line breakA reference to a library entry carries whitespace (Referensi ke entri library memuat spasi)
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothTautan rantai Release tidak sepakat tentang bentuk routing
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toRelease turunan mewarisi direktori boundary yang ter-resolve ke tempat induknya menulis
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two (Bundel yang diterbitkan tidak memuat entitas, atau memuat dua)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two (Bundel yang diterbitkan tidak memuat entitas, atau memuat dua)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity (Artefak yang diterbitkan tidak dapat dibaca sebagai entitas)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity (Artefak yang diterbitkan tidak dapat dibaca sebagai entitas)
E0302an input the entity reads has no pin recorded for it in the entity.lock beside itAn entity reads an input the lock beside it records no pin for (Sebuah entitas membaca input yang tidak dicatat pin-nya oleh lock di sampingnya)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its ownEntitas berbagi direktori dengan entitas lain
E0304a path names content outside the entity's own directoryA path names content outside the entity’s own directory (Sebuah path menunjuk konten di luar direktori milik entitas itu sendiri)
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockA local source no longer matches the pins recorded beside its Recipe (Sumber lokal tidak lagi cocok dengan pin yang dicatat di samping Recipe-nya)
E0306plugin artifact not found on this machine.wasm milik plugin tidak ada di mesin ini
E0307a value a cache location is built from would place cached files outside the place it names in the cacheA value would place a cached file outside the cache (Sebuah nilai akan menempatkan file cache di luar cache)
E0308a Feature reaches a component alongside a Feature it declares a conflict withDua Features yang dideklarasikan berkonflik mencapai satu komponen
E0309a symbolic link sits among the files an entity carriesA symbolic link sits among the files an entity carries (Tautan simbolis berada di antara file yang dibawa entitas)
E0310a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`Registry ditambahkan secara offline tanpa kebijakan kepercayaan untuk disematkan
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes (Pin versi bukan salah satu bentuk yang dapat diambil sebuah pin)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon (Binding provider menamai kapabilitas yang mengandung titik dua)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesBinding provider menyebut kapabilitas yang tidak dilayani plugin mana pun yang dibaca build
E0314plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reportsA plugin was built from a working tree with uncommitted changes (Plugin dibangun dari working tree dengan perubahan yang belum di-commit)
E0315a connection carries an attachment under a name its socket declares no slot forA connection carries an attachment under a name its socket declares no slot for (Koneksi membawa lampiran dengan nama yang tidak memiliki slot yang dideklarasikan socket-nya)
E0316a Release attachment takes the name of an attachment one of a component's connections carriesA Release attachment takes the name of a connection’s attachment (Lampiran Release memakai nama lampiran suatu koneksi)
E0317a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makesA Release connection attachment names no Feature type (Lampiran koneksi Release tidak menyebutkan tipe Feature)
E0318duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already deliveredTwo attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features terlampir mengirimkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)
E0319connection alias is already used by another connection of the same componentDua koneksi dari satu komponen dengan satu alias
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideJalur yang ditulis operasi melewati tautan keluar dari direktori yang harus menjadi batasnya
E0321a file this operation reads leads through a link out of the directory it must stay insideFile yang dibaca operasi mengarah melalui tautan ke luar direktori yang harus menjadi batasnya
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFactsTemplate membaca fakta render pemanggilnya tanpa mendeklarasikannya
E0324a reference a document makes to another file leads out of the directory it must stay insideA reference to another file leads out of the directory it must stay inside (Referensi ke file lain mengarah keluar dari direktori yang harus ditempatinya)
E0325provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entryA provider reported a render fact whose value is not a list (Sebuah provider melaporkan fakta render yang nilainya bukan daftar)
E0326pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render factsLangkah pipeline membaca render facts pemanggilnya
E0327template indexes a map with a key the map does not holdA template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimiliki map tersebut)
E0328attachment written under a name no slot declares fits a slot its component leaves emptyAn 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)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names oneSebuah koneksi dan target yang dicapainya tidak menyebut satu kunci yang sama
E0330signing: the references named together need different signing credentials, so nothing was signedReferensi yang ditandatangani bersama memerlukan kredensial penandatanganan yang berbeda
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one (Tidak ada tanda tangan terverifikasi yang tercatat untuk artefak yang memerlukannya)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact (Tanda tangan yang tercatat dibuat untuk artefak yang berbeda)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record (Tanda tangan yang tercatat bukan yang akan dicatat oleh pull)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (Sebuah entri omits tidak mengeluarkan apa pun yang dirender sumber)
E0335provider does not support omitsThe provider does not support omits (Provider tidak mendukung omits)
E0336a provider's omitted counts do not match the omits entries it was handedA provider’s omitted counts do not match the omits entries it was handed (Jumlah yang dihilangkan oleh provider tidak cocok dengan entri omits yang diserahkan kepadanya)
E0337no importer plugin version satisfies the plugins.importer entry's version pinEntri plugins.importer mematok versi importer-nya yang tidak dimiliki katalog
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (Sebuah importer dipasang oleh lebih dari satu entri plugins.importer)
E0339more than one importer recognises the sourceMore than one importer recognises the source (Lebih dari satu importer mengenali sumber)
E0340a name this operation writes holds a path segment Windows cannot hold as writtenA name the operation writes holds a part Windows cannot hold (Nama yang ditulis operasi memuat bagian yang tidak dapat ditampung Windows)
E0341the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directoryAn importer that declares no file patterns is handed a directory (Importer yang tidak mendeklarasikan pola berkas diberi direktori)
E0342no file in the directory matches the file patterns the importer serving the source's format declaresNo file in the directory matches the importer’s file patterns (Tidak ada berkas dalam direktori yang cocok dengan pola berkas importer)
E0343a file read from the directory and a file named in the importer's `with.sources` have the same nameA file read from the directory and a file named in the importer’s with.sources have the same name (Sebuah file yang dibaca dari direktori dan sebuah file yang disebutkan dalam with.sources milik importer memiliki nama yang sama)
E0344an entry this publication carries cannot be used on WindowsA published archive carries an entry Windows cannot use (Arsip yang dipublikasikan memuat entri yang tidak dapat digunakan Windows)
E0345a container declares one environment variable twiceA container gives one environment variable two values (Sebuah kontainer memberikan dua nilai untuk satu variabel lingkungan)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialAnotasi metrik sebuah Component dan kunci provides-nya tidak sesuai
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsTemplate membaca render facts targetnya tanpa mendeklarasikannya
E0348pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render factsLangkah pipeline membaca render facts targetnya
E0349no Recipe in the workspace's catalog binds to the capability the import's target namesAn import’s target names a capability no Recipe in the catalog binds to (Target sebuah impor menyebutkan kapabilitas yang tidak diikat oleh Recipe mana pun dalam katalog)
E0350no importer recognises the sourceNo importer recognises the source (Tidak ada importer yang mengenali sumber)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (Provider tidak mendukung artefak boundary)
E0352boundary output directory does not name a directory beneath the output rootDirektori keluaran sebuah boundary bukan direktori di bawah root keluaran
E0353boundary-level Feature instance name is not a directory nameFeature tingkat boundary bernama . atau ..
E0354a template does more than copy a value it reads off a cross-boundary linkA template did more than copy a value it read off a cross-boundary link (template melakukan lebih dari sekadar menyalin nilai yang dibacanya dari tautan lintas boundary)
E0355inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`An inject: delivery is not a list of entries (Pengiriman injeksi bukan daftar entri)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled (Field penangguhan workload diatur pada bentuk selain terjadwal)
E0357a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothingA Manifest name mapping names nothing in the build (Pemetaan name pada Manifest tidak menyebut apa pun dalam build)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export (Target uses menyebut komponen modul yang tidak diekspor modul tersebut)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind (Tidak ada adapter sumber yang terdaftar dalam program ini untuk suatu jenis sumber)
E0360the netrc file could not be readThe netrc file cannot be read (File netrc tidak dapat dibaca)
E0361the source URL carries a credentialA source URL carries a credential (URL sumber membawa kredensial)
E0362inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`An inject: entry on a connection carries a literal (Entri injeksi pada koneksi membawa literal)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding (Subkunci anotasi tidak dirutekan oleh binding-nya)
E0364a value template failed while it ranA value template failed while it ran (Templat nilai gagal saat berjalan)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file (Keluaran Feature tingkat boundary tidak mencapai berkas rakitan mana pun)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read (Output injectMapping dari Feature yang dipasang tidak dapat dibaca)
E0367a scalar annotation value does not route to exactly one path of its bindingA bare annotation value does not route to exactly one path of its binding (Nilai anotasi polos tidak dirutekan ke tepat satu path dari binding-nya)
E0368FeatureRecipe injectMapping output writes a key no delivery mechanism of the host readsAn attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Output injectMapping dari Feature yang dipasang menulis pengiriman di bawah kunci yang tidak dikirim oleh apa pun)
E0369template reads a path as a value and iterates it, and the data holds nothing at that pathA template reads and iterates a path that holds nothing (Templat membaca dan mengiterasi jalur yang tidak berisi apa pun)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (Pipeline mendeklarasikan satu id langkah dua kali)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (Dokumen katalog mendeklarasikan jenis yang tidak ada di katalog)
E0372inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject blockAn inject: entry on an attached Feature carries a literal (Entri injeksi pada Feature yang dilampirkan membawa literal)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads (Dokumen mendeklarasikan versi API yang tidak lagi dibaca oleh kompiler ini)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks (Sebuah plugin mendeklarasikan versi ABI plugin yang tidak lagi didukung oleh kompiler ini)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads (Artefak membawa jenis media yang tidak lagi dibaca oleh kompiler ini)
E0376egress: the server did not answer in timeA server did not answer in time (Server tidak menjawab tepat waktu)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (Daftar repositori sebuah registry tidak berakhir tepat waktu)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (Registry terus meminta untuk memperlambat)

Domain linter (tidak fatal)

Compiler sepenuhnya tanpa opini sendiri mengenai eksekusi. Compiler tidak pernah menghentikan build karena pola yang sekadar mencurigakan — nilai yang tidak digunakan, secret yatim, target yang tidak terhubung. Paling banyak, pola seperti itu memunculkan peringatan — peringatan milik build sendiri, untuk sedikit pola yang dikatalogkan di bawah “Kondisi yang tidak menghentikan build” di atas, seperti parameter yang dideklarasikan tetapi tidak dibaca apa pun — dan sisanya termasuk dalam domain linter, tempat perusahaan memilih untuk menggunakan plugin Wasm yang menerapkan konvensi mereka sendiri.

Kredensial yatim

Feature kredensial yang dilampirkan tanpa kontrak pengiriman inject: bukanlah kesalahan kompilasi. Compiler inti mempertahankan deklarasi tersebut dalam graf IR dan tidak menghasilkan peringatan. Plugin linter perusahaan dapat mendeteksi pola ini dan memberikan peringatan; renderer perusahaan juga dapat memilih untuk memasang secret yatim secara implisit berdasarkan konvensi Black-Box mereka sendiri. Karena kedua interpretasi tersebut sah, compiler inti tidak memihak keduanya.